@kosmojs/dev 0.3.0 → 0.4.1

package/pkg/index.js

@@ -1,120 +1,6 @@
-import{join as e,resolve as t}from"node:path";import{styleText as n}from"node:util";import{DEFAULT_APIBASE as r,RequestBodyTargets as i,RequestValidationTargets as a,createRouteResolver as o,createTemplateResolver as s,defaults as c}from"@kosmojs/core";import{createHonoPattern as l,createPathPattern as u,defineGenerator as d,defineGeneratorFactory as f,mergeConfigs as p,nestedRoutesFactory as m,pathResolver as h,pathTokensFactory as g,renderFactory as _,renderToFile as ee,sortRoutes as v,spinnerFactory as te,vitePlugins as y}from"@kosmojs/lib";import{routeRenderHelpers as b}from"@kosmojs/core/generators";import x from"crc/crc32";import ne from"@mdx-js/rollup";import{build as S,createFilter as C}from"vite";import re from"yaml";import{parse as ie}from"path-to-regexp";import ae from"typebox";import oe from"@vitejs/plugin-react";import w from"vite-plugin-solid";import{access as se,constants as ce,cp as T,mkdir as le,rm as E,writeFile as ue}from"node:fs/promises";import{svelte as de}from"@sveltejs/vite-plugin-svelte";import fe from"@vitejs/plugin-vue";var D={type:`module`,private:!0,name:`@kosmojs/fetch-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/fetch-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`},devDependencies:{"path-to-regexp":`^8.4.2`}},O=`import { compile } from "path-to-regexp";
-
-import {
-  type ApiRouteSerialized,
-  stringifySearchParams,
-  type ValidationTarget,
-} from "@kosmojs/core";
-import type { HTTPMethod } from "@kosmojs/core/api";
-import { createHost, type HostOpt, join } from "@kosmojs/core/fetch";
-
-export * from "./transport";
-
-export const fetchHelpers = <ParamsT extends readonly unknown[]>(
-  basePath: string,
-  route: ApiRouteSerialized,
-) => {
-  const toPath = compile(route.pathPattern);
-
-  const maybeNumber = (val: unknown) => {
-    if (val === undefined || val === null) {
-      return val;
-    }
-    const n = Number(val);
-    return Number.isFinite(n) ? n : val;
-  };
-
-  const paramsMapper = (params: ParamsT, opt?: { coerceNumbers?: boolean }) => {
-    return route.params.reduce<Record<string, unknown>>((map, name, i) => {
-      const coerceNumbers = opt?.coerceNumbers
-        ? route.numericProperties.params.includes(name)
-        : false;
-      if (Array.isArray(params[i])) {
-        map[name] = coerceNumbers
-          ? params[i].map((v) => maybeNumber(v))
-          : params[i].map(String);
-      } else if (params[i] !== undefined) {
-        map[name] = coerceNumbers ? maybeNumber(params[i]) : String(params[i]);
-      }
-      return map;
-    }, {});
-  };
-
-  const parametrize = (params: ParamsT) => {
-    try {
-      return toPath(paramsMapper(params) as never);
-    } catch (error) {
-      console.error(\`❗ERROR: Failed building path for \${route.name}\`);
-      throw error;
-    }
-  };
-
-  const base = (params: ParamsT, query?: Record<string, unknown>) => {
-    const path = join("/", parametrize(params));
-    return query ? [path, stringifySearchParams(query)].join("?") : path;
-  };
-
-  const path = (params: ParamsT, query?: Record<string, unknown>) => {
-    return join(basePath, base(params, query));
-  };
-
-  const href = (
-    host: HostOpt,
-    params: ParamsT,
-    query?: Record<string, unknown>,
-  ) => {
-    return createHost(host) + path(params, query);
-  };
-
-  const payloadResolver = <T>(
-    payload: Record<ValidationTarget, T> | undefined,
-    target: ValidationTarget,
-    method: HTTPMethod,
-  ) => {
-    const data = payload?.[target];
-
-    if (target === "query") {
-      return Object.fromEntries(
-        Object.entries({ ...data }).map(([k, v]) => {
-          return [
-            k,
-            route.numericProperties.query[method]?.includes(k)
-              ? Array.isArray(v)
-                ? v.map((v) => maybeNumber(v))
-                : maybeNumber(v)
-              : v,
-          ];
-        }),
-      );
-    }
-
-    if (data instanceof FormData) {
-      return [...data].reduce<
-        Record<string, FormDataEntryValue | Array<FormDataEntryValue>>
-      >((map, [key, val]) => {
-        if (key in map) {
-          map[key] = [map[key]].flat().concat(val);
-        } else {
-          map[key] = val;
-        }
-        return map;
-      }, {}) as T;
-    }
-
-    return data;
-  };
-
-  return {
-    paramsMapper,
-    parametrize,
-    base,
-    path,
-    href,
-    payloadResolver,
-  };
-};
-`,k=`export const transport = undefined;
-`,A=`{{#each routes}}
+import{t as e}from"./assets/pkg-BhfEyKpY.js";import{join as t,resolve as n}from"node:path";import{styleText as r}from"node:util";import{DEFAULT_APIBASE as i,RequestBodyTargets as a,RequestValidationTargets as o,createRouteResolver as s,createTemplateResolver as c,defaults as l}from"@kosmojs/core";import{createH3Pattern as u,createHonoPattern as d,createPathPattern as f,createWatchedApiRouteEntriesFilter as p,createWatchedPageRouteEntriesFilter as m,defineGenerator as h,defineGeneratorFactory as g,mergeConfigs as _,nestedRoutesFactory as v,pathResolver as y,pathTokensFactory as b,renderFactory as x,renderToFile as ee,sortRoutes as S,spinnerFactory as te,vitePlugins as C}from"@kosmojs/lib";import{routeRenderHelpers as w}from"@kosmojs/core/generators";import T from"crc/crc32";import ne from"@mdx-js/rollup";import{build as E,createFilter as re}from"vite";import ie from"yaml";import{parse as ae}from"path-to-regexp";import oe from"typebox";import se from"@vitejs/plugin-react";import D from"vite-plugin-solid";import{access as ce,constants as le,cp as O,mkdir as ue,rm as k,writeFile as de}from"node:fs/promises";import{svelte as fe}from"@sveltejs/vite-plugin-svelte";import pe from"@vitejs/plugin-vue";var A=`export * from "./transport";
+`,j=`export const transport = undefined;
+`,M=`{{#each routes}}
 import {{id}} from "{{ createImport 'libApi' name 'fetch' }}";
 {{/each}}
 
@@ -132,10 +18,10 @@ export default {
 {{/each}}
 {{/each}}
 }
-`,j=`import fetchFactory, { join } from "@kosmojs/core/fetch";
+`,N=`import fetchFactory, { join } from "@kosmojs/core/fetch";
 
 import { base, apiBase, apiRouteMap } from "{{ createImport 'libCore' }}";
-import { transport, fetchHelpers } from "{{ createImport 'lib' '@fetch' }}";
+import { transport } from "{{ createImport 'lib' '@fetch' }}";
 
 import {
   type MaybeWrapped,
@@ -175,10 +61,7 @@ const {
   payloadResolver,
   path,
   href,
-} = fetchHelpers<[{{serializeParamsTupleElements route}}]>(
-  apiBase,
-  apiRouteMap["{{route.name}}"],
-);
+} = apiRouteMap["{{route.name}}"];
 
 const fetchApi = fetchFactory(
   join(base, apiBase),
@@ -235,11 +118,858 @@ export default {
   href,
   validationSchemas,
 };
-`,M=`export type MaybeWrapped<T> = T;
+`,P=`export type MaybeWrapped<T> = T;
 export const unwrap = <T>(data: T) => data;
-`,N=f(e=>{let{createPath:t,createImportHelpers:n}=h(e),{renderToFile:r}=_({helpers:{...n({origin:`lib`}),...b()}}),i=async(e,n)=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]).sort(v);await r(t.lib(`fetch.ts`),A,{routes:i});for(let{kind:e,entry:i}of n)if(e===`apiRoute`){let e=[];for(let t of i.validationDefinitions)if(t.target===`response`)for(let{id:n,body:r,resolvedType:i}of t.variants)r&&e.push({id:n,target:t.target,method:t.method,resolvedType:i});else{let{id:n,resolvedType:r}=t.schema;e.push({id:n,target:t.target,method:t.method,resolvedType:r})}let n=i.methods.map(t=>({method:t,payloadTypes:e.filter(e=>e.method===t&&![`headers`,`cookies`,`response`].includes(e.target)),responseType:e.find(e=>e.target===`response`&&e.method===t)})),a=Object.values(e.reduce((e,{id:t,target:n,method:r,resolvedType:i})=>(n===`response`&&(e[r]||(e[r]={method:r,types:[]}),e[r].types.push({id:t,target:n,method:r,resolvedType:i})),e),{}));await r(t.libApi(i.name,`fetch.ts`),j,{route:i,validationTypes:e,routeMethods:n,responseTypes:a})}};return{async start(){for(let[e,n]of[[`unwrap.ts`,M],[`@fetch/transport.ts`,k],[`@fetch/index.ts`,O]])await r(t.lib(e),n,{})},async watch(e,t){await i(e,t?e.filter(({kind:e,entry:n})=>t.kind===`update`&&e===`apiRoute`&&n.fileFullpath===t.file):e)},async build(e){await i(e,e)},async ssrBuild(){for(let[e,n]of[[`@fetch/transport.ts`,`export { transport } from "${c.libPrefix}/@ssr/fetch";`]])await r(t.lib(e),n,{})}}}),P=d({meta:{name:`Fetch`,slot:`fetch`},dependencies:{"path-to-regexp":D.devDependencies[`path-to-regexp`]},factory:N}),F={type:`module`,private:!0,name:`@kosmojs/hono-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/hono-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@hono/node-server":`^2.1.0`,hono:`^4.13.1`,"path-to-regexp":`^8.4.2`,vite:`^8.2.1`}},I=`import { Hono } from "hono";
+`,F=g(e=>{let{createPath:t,createImportHelpers:n}=y(e),{renderToFile:r}=x({helpers:{...n({origin:`lib`}),...w()}}),i=async(e,n)=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]).sort(S);await r(t.lib(`fetch.ts`),M,{routes:i});for(let{kind:e,entry:i}of n)if(e===`apiRoute`){let e=[];for(let t of i.validationDefinitions)if(t.target===`response`)for(let{id:n,body:r,resolvedType:i}of t.variants)r&&e.push({id:n,target:t.target,method:t.method,resolvedType:i});else{let{id:n,resolvedType:r}=t.schema;e.push({id:n,target:t.target,method:t.method,resolvedType:r})}let n=i.methods.map(t=>({method:t,payloadTypes:e.filter(e=>e.method===t&&![`headers`,`cookies`,`response`].includes(e.target)),responseType:e.find(e=>e.target===`response`&&e.method===t)})),a=Object.values(e.reduce((e,{id:t,target:n,method:r,resolvedType:i})=>(n===`response`&&(e[r]||(e[r]={method:r,types:[]}),e[r].types.push({id:t,target:n,method:r,resolvedType:i})),e),{}));await r(t.libApi(i.name,`fetch.ts`),N,{route:i,validationTypes:e,routeMethods:n,responseTypes:a})}};return{async start(){for(let[e,n]of[[`unwrap.ts`,P],[`@fetch/transport.ts`,j],[`@fetch/index.ts`,A]])await r(t.lib(e),n,{})},async watch(e,t){await i(e,e.filter(p(t,[`create`,`update`])))},async build(e){await i(e,e)},async ssrBuild(){for(let[e,n]of[[`@fetch/transport.ts`,`export { transport } from "${l.libPrefix}/@ssr/fetch";`]])await r(t.lib(e),n,{})}}}),I=h({meta:{name:`Fetch`,slot:`fetch`},factory:F}),L={type:`module`,private:!0,name:`@kosmojs/h3-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/h3-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{h3:`2.0.1-rc.29`,vite:`^8.2.2`}},R=`import { H3, type Middleware } from "h3";
+
+import type { Route, RouteDebugOption } from "@kosmojs/core/api";
+
+export type App = H3;
+
+export type AppOptions = ConstructorParameters<typeof H3>[0] & {
+  debug?: RouteDebugOption;
+};
+
+export function appFactory(
+  routes: Array<Route<Middleware>>,
+  options: AppOptions,
+): App;
+
+export function appFactory(
+  routes: Array<Route<Middleware>>,
+  fn: (a: { app: App }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<Middleware>>,
+  options: AppOptions,
+  fn: (a: { app: App }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<Middleware>>,
+  ...rest: Array<unknown>
+): App {
+  const [options, fn] = typeof rest[0] === "function" ? [{}, rest[0]] : rest;
+
+  const { debug = undefined, ...appOptions } = {
+    ...(options ? { ...options } : {}),
+  };
+
+  const app = new H3(appOptions);
+
+  if (typeof fn === "function") {
+    fn({ app });
+  }
+
+  for (const route of routes) {
+    if (typeof debug === "function") {
+      (debug as Function)(route.debug, route);
+    } else if (debug) {
+      console.log(route.debug[typeof debug === "string" ? debug : "full"]);
+    }
+    for (const method of route.methods) {
+      // last middleware is the handler
+      const handler = route.middleware.at(-1);
+      if (handler) {
+        app.on(method, route.path, handler as never, {
+          middleware: route.middleware.slice(0, -1),
+        });
+      }
+    }
+  }
+
+  return app;
+}
+`,z=`import type { DevSetup } from "@kosmojs/core/api";
+
+export const devSetup = (setup: DevSetup) => setup;
+`,B=`import { type H3Event, HTTPError } from "h3";
+
+import { ValidationError } from "@kosmojs/core/errors";
+
+type ErrorHandler = (
+  error: any,
+  event: H3Event,
+) => Promise<Response> | Response;
+
+export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
+
+export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
+  // H3 wraps errors in its own HTTPError with the original error as \`cause\`
+  return (error, event) => {
+    return handler(
+      error instanceof HTTPError
+        ? error.cause instanceof ValidationError
+          ? error.cause
+          : error
+        : error,
+      event,
+    );
+  };
+};
+`,me=`import { type H3Event, readBody } from "h3";
+
+import {
+  parseCookies,
+  parseSearchParams,
+  type RequestBodyTarget,
+  type RequestMetadataTarget,
+} from "@kosmojs/core";
+
+export const metaparsers: {
+  [T in RequestMetadataTarget]: (event: H3Event) => unknown;
+} = {
+  query(event) {
+    return parseSearchParams(event.url);
+  },
+
+  headers(event) {
+    return Object.fromEntries(event.req.headers);
+  },
+
+  cookies(event) {
+    return parseCookies(Object.fromEntries(event.req.headers));
+  },
+};
+
+export const bodyparsers: {
+  [T in RequestBodyTarget]: (event: H3Event) => Promise<unknown>;
+} = {
+  json(event) {
+    return event.req.json();
+  },
+
+  form(event) {
+    return readBody(event, { type: "formData" });
+  },
+
+  raw(event) {
+    return event.req.text();
+  },
+};
+`,he=`import type { Middleware } from "h3";
+
+import type {
+  RequestBodyTarget,
+  RequestMetadataTarget,
+  RequestValidationTarget,
+  ValidationErrorEntry,
+} from "@kosmojs/core";
+import {
+  type CreateRouteMiddleware,
+  createRoutes,
+  type HTTPMethod,
+  StateKey,
+} from "@kosmojs/core/api";
+import { ValidationError } from "@kosmojs/core/errors";
+
+import {
+  type DefaultContext,
+  type ParameterizedEvent,
+  type ParameterizedMiddleware,
+  use,
+} from "../api";
+import { bodyparsers, metaparsers } from "./parsers";
+import { routeSources } from "./routes";
+
+import globalMiddleware from "{{ createImport 'api' 'use' }}";
+
+/**
+ * Create route-level middleware stack that handles:
+ * 1. Context extension - adds \`event.bodyparser\` (lazy, cached) and \`event.validated\` accessors
+ * 2. Params validation - normalizes and validates URL params (including splat/numeric params)
+ * 3. Request validation - validates query, headers, cookies, and body against schemas
+ * 4. Response validation - validates outgoing response against defined variants
+ *
+ * Middleware are assigned named slots (e.g. "validate:params", "validate:json")
+ * so they can be replaced by user-defined middleware in the stack.
+ *
+ * All validation errors are thrown as \`ValidationError\` instances,
+ * caught and formatted by the global error handler middleware upstream.
+ * */
+export const createRouteMiddleware: CreateRouteMiddleware<
+  ParameterizedMiddleware
+> = ({ name, validationSchemas, normalizeParams, normalizeSearchParams }) => {
+  const validationMiddleware = [
+    /**
+     * Extends H3 event with:
+     *
+     * - \`event.metaparser[target]()\` - lazy, cached meta parsers.
+     *   Each parser (query, headers, cookies) runs at most once per request;
+     *   subsequent calls return the cached result.
+     *
+     * - \`event.bodyparser[target](opts?)\` - lazy, cached body parsers.
+     *   Each parser (json, form, raw) runs at most once per request;
+     *   subsequent calls return the cached result.
+     *   This allows both user middleware/handlers and validators
+     *   to call the same parser without re-consuming the request stream.
+     *
+     * - \`event.validated\` - getter that returns all validated data collected so far
+     *   (params, query, headers, cookies, json etc.) as a plain object.
+     *
+     * Cache is stored on \`event[StateKey]\` (a Symbol-keyed Map) to keep it
+     * hidden from public API surface and serialization.
+     * */
+    use(
+      function useExtendContext(event, next) {
+        if (!event[StateKey]) {
+          // initialize per-request cache with empty params
+          // (later populated by useValidateParams)
+          event[StateKey] = new Map([["params", {}]]);
+
+          Object.defineProperty(event, "metaparser", {
+            value: Object.entries(metaparsers).reduce<{
+              [T in RequestMetadataTarget]?: () => unknown;
+            }>((map, entry) => {
+              const [target, parser] = entry as [
+                RequestMetadataTarget,
+                Function,
+              ];
+              map[target] = () => {
+                if (!event[StateKey].has(target)) {
+                  event[StateKey].set(
+                    target,
+                    target === "query"
+                      ? normalizeSearchParams(
+                          parser(event),
+                          event.req.method as never,
+                        )
+                      : parser(event),
+                  );
+                }
+                return event[StateKey].get(target);
+              };
+              return map;
+            }, {}),
+            enumerable: true,
+          });
+
+          Object.defineProperty(event, "bodyparser", {
+            value: Object.entries(bodyparsers).reduce<{
+              [T in RequestBodyTarget]?: () => Promise<unknown>;
+            }>((map, entry) => {
+              const [target, parser] = entry as [RequestBodyTarget, Function];
+              map[target] = async () => {
+                if (!event[StateKey].has(target)) {
+                  event[StateKey].set(target, await parser(event));
+                }
+                return event[StateKey].get(target);
+              };
+              return map;
+            }, {}),
+            enumerable: true,
+          });
+
+          Object.defineProperty(event, "validated", {
+            get() {
+              return Object.fromEntries(event[StateKey]);
+            },
+            enumerable: true,
+          });
+        }
+        return next();
+      },
+      { slot: "@extendContext" },
+    ) as never,
+
+    /**
+     * Normalize and validate URL params:
+     * - Splat params (e.g. \`/files{/*path}\`) are split into arrays by "/"
+     * - Numeric params are cast to Number (or array of Numbers for splat params)
+     * - Non-splat, non-numeric params pass through as strings
+     *
+     * Validated params are stored in the cache so \`event.validated.params\`
+     * reflects the normalized (and validated) values.
+     * */
+    use(
+      function useValidateParams(event, next) {
+        const normalizedParams = normalizeParams(event.url.pathname);
+        validationSchemas.params?.validate(normalizedParams);
+        event[StateKey].set("params", normalizedParams);
+        return next();
+      },
+      { slot: "validate:params" },
+    ) as never,
+
+    /**
+     * Response validation - runs AFTER the handler (post-\`next()\`).
+     *
+     * Each response schema defines one or more variants, each with:
+     * - expected status code
+     * - optional content-type
+     * - optional body schema
+     *
+     * All variants are checked; if at least one passes, validation succeeds.
+     * If none pass, a ValidationError is thrown with collected errors from all variants.
+     *
+     * Activation rules:
+     * - In dev/test mode: runs unless \`runtimeValidation\` is explicitly \`false\`
+     * - In production: runs only if \`runtimeValidation\` is explicitly \`true\`
+     *
+     * Only attached to HTTP methods that have response schemas defined.
+     * */
+    use(
+      async function useValidateResponse(event, next) {
+        const variants = validationSchemas.response?.[event.req.method] || [];
+
+        if (!Array.isArray(variants) || !variants.length) {
+          return next();
+        }
+
+        // options are same for all variants
+        const { runtimeValidation, customErrors } = variants[0];
+
+        if (KOSMO_PRODUCTION_BUILD) {
+          // skip if undefined or explicitly set to false
+          if (runtimeValidation === undefined || runtimeValidation === false) {
+            return next();
+          }
+        } else {
+          // skip only if explicitly set to false
+          if (runtimeValidation === false) {
+            return next();
+          }
+        }
+
+        // run all downstream middleware (including the route handler)
+        const body = await next();
+
+        /**
+         * H3 builds the actual Response AFTER the middleware chain completes,
+         * so at this point event.res only reflects what handlers set explicitly.
+         * Reconstruct what will be sent instead: a returned Response is authoritative;
+         * otherwise an unset status means 200, and the content type follows H3's
+         * serialization rules for the returned value (string -> text, object -> JSON).
+         * */
+        const rawResponse = body instanceof Response ? body : undefined;
+
+        const response: {
+          status: number;
+          contentType: string | null;
+          body?: unknown;
+        } = {
+          status: rawResponse?.status ?? event.res.status ?? 200,
+          contentType:
+            rawResponse?.headers.get("Content-Type") ??
+            event.res.headers.get("Content-Type") ??
+            (typeof body === "string"
+              ? "text/plain"
+              : body === undefined || body === null
+                ? null
+                : "application/json"),
+        };
+
+        // Validate body only for JSON variants
+        if (variants.some((e) => e.contentType?.includes("json"))) {
+          response.body = rawResponse
+            ? await rawResponse
+                .clone()
+                .json()
+                .catch(() => undefined)
+            : body;
+        }
+
+        /**
+         * Returns an array of validator functions for a single response variant.
+         * Each validator checks one aspect (status, content-type, body)
+         * and returns an error entry or undefined if the check passes.
+         * */
+        const variantValidators: (
+          v: (typeof variants)[number],
+        ) => Array<(i: number) => ValidationErrorEntry | undefined> = (
+          schema,
+        ) => {
+          return [
+            (i) => {
+              return schema.status === response.status
+                ? undefined
+                : {
+                    keyword: "Status",
+                    path: \`Variant #\${i}\`,
+                    message: \`expected: \${schema.status}; actual: \${response.status}\`,
+                  };
+            },
+            (i) => {
+              if (
+                !schema.contentType ||
+                schema.contentType === response.contentType
+              ) {
+                return undefined;
+              }
+              return {
+                keyword: "ContentType",
+                path: \`Variant #\${i}\`,
+                message: \`expected: \${schema.contentType}; actual: \${response.contentType}\`,
+              };
+            },
+            (i) => {
+              if (!schema.check || "body" in response === false) {
+                // no body schema or contentType is not JSON
+                return;
+              }
+              return schema.check(response.body)
+                ? undefined
+                : {
+                    keyword: "Body",
+                    path: \`Variant #\${i}\`,
+                    message: schema.errorMessage(response.body),
+                  };
+            },
+          ];
+        };
+
+        // collect errors across all variants; exit early if any variant passes
+        const errors: Array<ValidationErrorEntry> = [];
+
+        for (const [i, variant] of variants.entries()) {
+          const variantErrors = variantValidators(variant).flatMap(
+            (validator) => {
+              const error = validator(i);
+              return error ? [error] : [];
+            },
+          );
+          if (!variantErrors.length) {
+            // variant fully matched - response is valid
+            return;
+          }
+          errors.push(...variantErrors);
+        }
+
+        const errorMessage = \`The response did not match any of the expected formats\`;
+        const errorSummary = \`\${variants.length} variants checked, none valid\`;
+
+        // no variant passed validation
+        throw new ValidationError([
+          "response",
+          {
+            errors,
+            errorMessage: customErrors?.error || errorMessage,
+            errorSummary,
+            route: name,
+            data: response,
+          },
+        ]);
+      },
+      {
+        slot: "validate:response",
+        on: Object.keys(validationSchemas.response || {}) as Array<HTTPMethod>,
+      },
+    ) as never,
+  ];
+
+  /**
+   * Request validation - dynamically creates one middleware per target
+   * (query, headers, cookies, json, form, multipart, raw).
+   *
+   * Each middleware:
+   * 1. Checks if a schema exists for the current HTTP method
+   * 2. Skips if \`runtimeValidation\` is explicitly disabled
+   * 3. Loads data via the appropriate source (event.query, event.headers, or event.bodyparser)
+   * 4. Validates via \`schema.validate()\` which throws on failure
+   *
+   * Body targets (json, form, raw) go through \`event.bodyparser[target]()\`,
+   * benefiting from the lazy parsing and caching set up by slot:extendContext middleware.
+   *
+   * All request validators are active on any HTTP method that has at least one
+   * schema defined across any target - this is intentionally broad to avoid
+   * silently skipping validation when methods overlap.
+   * */
+  const requestTargets: Record<
+    RequestValidationTarget,
+    (
+      event: ParameterizedEvent<Record<string, string>, DefaultContext>,
+    ) => Promise<unknown>
+  > = {
+    query: async (event) => event.metaparser.query(),
+    headers: async (event) => event.metaparser.headers(),
+    cookies: async (event) => event.metaparser.cookies(),
+    json: async (event) => event.bodyparser.json(),
+    form: async (event) => event.bodyparser.form(),
+    raw: async (event) => event.bodyparser.raw(),
+  };
+
+  const requestEntries = Object.entries(requestTargets) as Array<
+    [RequestValidationTarget, (typeof requestTargets)[RequestValidationTarget]]
+  >;
+
+  for (const [target, loadData] of requestEntries) {
+    validationMiddleware.push(
+      use(
+        async (event, next) => {
+          const schema = {
+            ...validationSchemas[target]?.[event.req.method],
+          };
+          if (schema.validate && schema.runtimeValidation !== false) {
+            schema.validate(await loadData(event as never));
+          }
+          return next();
+        },
+        {
+          slot: \`validate:\${target}\`,
+          // duplicates not an issue here
+          on: requestEntries.flatMap(([target]) => {
+            return Object.keys(
+              validationSchemas[target] || {},
+            ) as Array<HTTPMethod>;
+          }),
+        },
+      ) as never,
+    );
+  }
+
+  return validationMiddleware;
+};
+
+export const routes = createRoutes<ParameterizedMiddleware, Middleware>(
+  routeSources,
+  {
+    globalMiddleware: globalMiddleware as never,
+    createRouteMiddleware,
+  },
+);
+`,ge=`import { join } from "node:path";
+
+import type { RouteSource } from "@kosmojs/core/api";
+
+import { base, apiBase, apiRouteMap, apiRouteMapper } from "{{ createImport 'libCore' }}";
+
+{{#each routes}}
+import {{id}} from "{{ createImport 'api' file }}";
+import { validationSchemas as {{id}}_schemas } from "{{ createImport 'libApi' basename 'schemas' }}";
+{{/each}}
+
+{{#each cascadingMiddleware}}
+import {{id}}, { type UseT as UseT{{id}} } from "{{ createImport 'api' file }}";
+{{/each}}
+
+export type RouteMap = {
+{{#each routes}}
+  "{{name}}": {
+    paramsDefaults: {{paramsDefaults .}},
+    paramsMappings: {{paramsMappings .}},
+    cascadingState: {{cascadingState .}},
+  },
+{{/each}}
+}
+
+export const routeSources: Array<RouteSource<never>> = [
+  {{#each routes}}
+  {
+    {{#if alias}}
+    ...apiRouteMapper(apiBase, { ...{{serializeApiRoute .}}, pathPattern: "{{alias}}" }),
+    path: "{{alias}}",
+    pathPattern: "{{alias}}",
+    {{else}}
+    ...apiRouteMap["{{name}}"],
+    path: join(base, apiBase, "{{path}}"),
+    pathPattern: join(base, apiBase, "{{pathPattern}}"),
+    {{/if}}
+    name: "{{name}}",
+    file: "{{file}}",
+    cascadingMiddleware: [ {{#each cascadingMiddleware}}{{id}}, {{/each}}].flat() as Array<never>,
+    definitionItems: {{id}} as never,
+    validationSchemas: {{id}}_schemas,
+  },
+  {{/each}}
+];
+`,_e=`import { parseArgs, styleText } from "node:util";
+
+import { serve as h3serve } from "h3";
+
+import type { App } from "./app";
+
+type Handles = {
+  port?: number | undefined;
+  onListen?: () => Promise<void>;
+};
+
+const getListenHandles = async (opt?: Handles) => {
+  const { port } = opt
+    ? opt
+    : parseArgs({
+        options: {
+          port: {
+            type: "string",
+            short: "p",
+          },
+        },
+      }).values;
+
+  if (![port].some(Boolean)) {
+    throw new Error("Please provide -p/--port number");
+  }
+
+  const onListen = async () => {
+    console.log(
+      \`\\n  ✨ Server Started \${styleText(["dim"], "[ %s ]")}\`,
+      \`port: \${port}\`,
+    );
+  };
+
+  return {
+    port: Number(port),
+    onListen: opt?.onListen || onListen,
+  };
+};
+
+export const serve = async <T extends App>(app: T, opt?: Handles) => {
+  const { port, onListen } = await getListenHandles(opt);
+
+  const server = h3serve(app, { port });
+  await server.ready().then(onListen);
+
+  return server as never;
+};
+`,ve=`import type { H3Event, H3EventContext } from "h3";
+
+import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
+import {
+  use as createUse,
+  type ExtendContext,
+  type HandlerDefinition,
+  type HTTPMethod,
+  type MiddlewareDefinition,
+  type RouteDefinitionItem,
+  type UseOptions,
+} from "@kosmojs/core/api";
+
+import type { RouteMap } from "./@api/routes";
+
+export interface DefaultContext extends H3EventContext {}
+
+type MaybePromise<T = unknown> = T | Promise<T>;
+
+type Next = () => MaybePromise<unknown | undefined>;
+
+type ExtractBodies<R> = R extends [number, string, infer Body] ? Body : never;
+
+type ValidatedResponseBodies<VDefs extends ValidationDefmap> = [
+  ExtractBodies<VDefs["response"]>,
+] extends [never]
+  ? unknown // No bodies extracted at all - fallback to unknown
+  : ExtractBodies<VDefs["response"]>;
+
+export type ParameterizedEvent<
+  ParamsT,
+  ContextT,
+  VDefs extends ValidationDefmap = {},
+  VOpts extends ValidationOptmap = {},
+> = H3Event & { context: DefaultContext } & ContextT &
+  ExtendContext<ParamsT, VDefs, VOpts>;
+
+export type ParameterizedMiddleware<
+  ParamsT = Record<string, string>,
+  ContextT = Record<string, unknown>,
+> = (
+  event: ParameterizedEvent<ParamsT, ContextT>,
+  next: Next,
+) => MaybePromise<unknown>;
+
+export type RouteHandler<
+  ParamsT,
+  ContextT,
+  VDefs extends ValidationDefmap,
+  VOpts extends ValidationOptmap = {},
+> = (
+  event: ParameterizedEvent<ParamsT, ContextT, VDefs, VOpts>,
+) => MaybePromise<ValidatedResponseBodies<VDefs>>;
+
+export type DefineRouteFactory<ParamsT, ContextT> = (
+  a: {
+    // NOTE: The \`use\` helper intentionally does not accept validation types.
+    // Allowing these type parameters on \`use\` would be misleading,
+    // since middleware operates across multiple request methods with varying types.
+    use: (
+      middleware:
+        | ParameterizedMiddleware<ParamsT, ContextT>
+        | Array<ParameterizedMiddleware<ParamsT, ContextT>>,
+      options?: UseOptions,
+    ) => MiddlewareDefinition<ParameterizedMiddleware<ParamsT, ContextT>>;
+  } & {
+    [M in HTTPMethod]: <
+      VDefs extends ValidationDefmap,
+      VOpts extends ValidationOptmap = {},
+    >(
+      handler:
+        | RouteHandler<ParamsT, ContextT, VDefs, VOpts>
+        | Array<RouteHandler<ParamsT, ContextT, VDefs, VOpts>>,
+    ) => HandlerDefinition<ParameterizedMiddleware<ParamsT, ContextT>>;
+  },
+) => Array<RouteDefinitionItem<ParameterizedMiddleware<ParamsT, ContextT>>>;
+
+type ParamsMap<
+  Mappings extends Array<[string, unknown, boolean]>,
+  Refinements extends Array<unknown>,
+> = {
+  [I in Extract<keyof Mappings, \`\${number}\`> as Mappings[I] extends [
+    infer ParamName extends string,
+    ...Array<unknown>,
+  ]
+    ? ParamName
+    : never]: Mappings[I] extends [string, infer Default, true]
+    ? I extends keyof Refinements
+      ? Refinements[I]
+      : Default
+    : Mappings[I] extends [string, infer Default, false]
+      ? I extends keyof Refinements
+        ? Refinements[I] | undefined
+        : Default | undefined
+      : never;
+};
+
+export const use = <ContextT = DefaultContext>(
+  middleware:
+    | ParameterizedMiddleware<Record<string, string>, ContextT>
+    | Array<ParameterizedMiddleware<Record<string, string>, ContextT>>,
+  options?: UseOptions,
+) => {
+  return createUse<ParameterizedMiddleware<Record<string, string>, ContextT>>(
+    middleware,
+    options,
+  );
+};
+
+export const defineRoute: <
+  R extends keyof RouteMap,
+  ParamsD extends RouteMap[R]["paramsDefaults"] = RouteMap[R]["paramsDefaults"],
+  ContextT extends object = object,
+>(
+  factory: DefineRouteFactory<
+    ParamsMap<RouteMap[R]["paramsMappings"], ParamsD>,
+    ContextT & RouteMap[R]["cascadingState"]
+  >,
+) => Array<
+  RouteDefinitionItem<
+    ParameterizedMiddleware<
+      ParamsMap<RouteMap[R]["paramsMappings"], ParamsD>,
+      ContextT & RouteMap[R]["cascadingState"]
+    >
+  >
+> = (factory) => {
+  const createHandler = <MiddlewareT>(method: HTTPMethod) => {
+    return (middleware: MiddlewareT | Array<MiddlewareT>) => {
+      return {
+        kind: "handler",
+        method,
+        middleware: [middleware].flat(),
+      };
+    };
+  };
+  return factory({
+    HEAD: createHandler("HEAD") as never,
+    OPTIONS: createHandler("OPTIONS") as never,
+    GET: createHandler("GET") as never,
+    POST: createHandler("POST") as never,
+    PUT: createHandler("PUT") as never,
+    PATCH: createHandler("PATCH") as never,
+    DELETE: createHandler("DELETE") as never,
+    // route-specific \`use\`, contains types for current route
+    use: use as never,
+  });
+};
+`,ye=`export * from "./@api/app";
+export { appFactory as default } from "./@api/app";
+export * from "./@api/dev";
+export * from "./@api/errors";
+export * from "./@api/router";
+export * from "./@api/routes";
+export * from "./@api/server";
+`,be=`import { onError } from "h3";
+
+import appFactory, { routes, type App } from "{{ createImport 'lib' 'api:factory' }}";
+import defaultErrorHandler from "./errors";
+
+export default appFactory(routes, ({ app }) => {
+  app.use(onError(defaultErrorHandler));
+}) as App;
+`,xe=`import { toNodeHandler } from "h3/node";
+
+import app from "./app";
+
+import { devSetup } from "{{ createImport 'lib' 'api:factory' }}";
+
+export default devSetup({
+  requestHandler() {
+    return toNodeHandler(app);
+  },
+  teardownHandler() {
+    // close db connections, server sockets etc.
+  },
+});
+
+process.on("unhandledRejection", (reason) => {
+  console.error("💥 UNHANDLED REJECTION");
+  console.error("Reason:", reason);
+  process.exit(1);
+});
+`,Se=`export declare module "{{ createImport 'libApi' }}" {
+  interface DefaultContext {}
+}
+`,Ce=`import { ValidationError } from "@kosmojs/core/errors";
+import { HTTPError } from "h3";
+
+import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
+
+export default errorHandlerFactory(async (error, event) => {
+  const [status, message = "Unknown error occurred"] = Array.isArray(error)
+    ? error
+    : error instanceof HTTPError
+      ? [error.status, error.message]
+      : error instanceof ValidationError
+        ? [400, \`\${error.target}: \${error.errorMessage}\`]
+        : [error.statusCode || 500, error.message];
+
+  const accept = event.req.headers.get("accept");
+
+  return accept?.includes("application/json")
+    ? new Response(JSON.stringify({ error: message }), {
+        status,
+        headers: { "Content-Type": "application/json" },
+      })
+    : new Response(message, {
+        status,
+        headers: { "Content-Type": "text/plain" },
+      });
+});
+`,we=`import { defineRoute } from "{{ createImport 'libApi' }}";
+
+export default defineRoute<"{{route.name}}">(({ GET }) => [
+  GET(async (event) => {
+    return "Automatically generated route";
+  }),
+]);
+`,Te=`import { use } from "{{ createImport 'libApi' }}";
+
+export type UseT = {};
+
+export default [
+  use<UseT>(async (event, next) => {
+    return next();
+  }),
+];
+`,Ee=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+import app from "./app";
+
+await serve(app);
+`,De=`import { use } from "{{ createImport 'libApi' }}";
+
+/**
+ * Define global middleware applied to all routes.
+ * Can be overridden on a per-route basis using the slot key.
+ * */
+export default [
+  use(async function useExample(event, next) {
+    return next();
+  }),
+];
+`,Oe=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,d=c(n?.templates,we),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),d(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),Te,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,path:r.h3Pattern,basename:r.name,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:u(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,ge]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,ve],[`api:factory.ts`,ye],[`@api/app.ts`,R],[`@api/parsers.ts`,me],[`@api/dev.ts`,z],[`@api/errors.ts`,B],[`@api/router.ts`,he],[`@api/server.ts`,_e]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,be],[`dev.ts`,xe],[`errors.ts`,Ce],[`server.ts`,Ee],[`use.ts`,De],[`env.d.ts`,Se]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await f(e.filter(p(t,[`create`]))),await m(e)},async build(e){await f(e),await m(e)}}}),ke=h({meta:{name:`H3`,slot:`backend`},dependencies:{h3:L.devDependencies.h3},factory:Oe}),V={type:`module`,private:!0,name:`@kosmojs/hono-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/hono-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@hono/node-server":`^2.1.1`,hono:`^4.13.3`,vite:`^8.2.2`}},Ae=`import { Hono, type MiddlewareHandler } from "hono";
+import type { Router } from "hono/router";
+import { RegExpRouter } from "hono/router/reg-exp-router";
+import { SmartRouter } from "hono/router/smart-router";
+import { TrieRouter } from "hono/router/trie-router";
 
-import type { AppFactory } from "@kosmojs/core/api";
+import type { Route, RouteDebugOption } from "@kosmojs/core/api";
 
 import type { DefaultBindings, DefaultVariables } from "../api";
 
@@ -250,18 +980,65 @@ export type AppEnv = {
 
 export type App = Hono<AppEnv>;
 
-export type AppOptions = ConstructorParameters<typeof Hono<AppEnv>>[0];
+export type AppOptions = ConstructorParameters<typeof Hono<AppEnv>>[0] & {
+  debug?: RouteDebugOption;
+};
 
-export const appFactory: AppFactory<App, AppOptions> = (factory) => {
-  const createApp = (options?: AppOptions) => {
-    return new Hono({ strict: false, ...options });
+export function appFactory(
+  routes: Array<Route<MiddlewareHandler>>,
+  options: AppOptions,
+): App;
+
+export function appFactory(
+  routes: Array<Route<MiddlewareHandler>>,
+  fn: (a: { app: App; router: Router<never> }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<MiddlewareHandler>>,
+  options: AppOptions,
+  fn: (a: { app: App; router: Router<never> }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<MiddlewareHandler>>,
+  ...rest: Array<unknown>
+): App {
+  const [options, fn] = typeof rest[0] === "function" ? [{}, rest[0]] : rest;
+
+  const router = new SmartRouter({
+    routers: [new RegExpRouter(), new TrieRouter()],
+  }) as Router<never>;
+
+  const { debug = undefined, ...appOptions } = {
+    ...(options ? { ...options } : {}),
   };
-  return factory({ createApp });
-};
-`,L=`import type { DevSetup } from "@kosmojs/core/api";
+
+  const app = new Hono({
+    strict: false,
+    router,
+    ...appOptions,
+  });
+
+  if (typeof fn === "function") {
+    fn({ app, router });
+  }
+
+  for (const route of routes) {
+    if (typeof debug === "function") {
+      (debug as Function)(route.debug, route);
+    } else if (debug) {
+      console.log(route.debug[typeof debug === "string" ? debug : "full"]);
+    }
+    app.on(route.methods, [route.path], ...route.middleware);
+  }
+
+  return app as never;
+}
+`,je=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,R=`import type { Context } from "hono";
+`,Me=`import type { Context } from "hono";
 
 import type { AppEnv } from "./app";
 
@@ -275,7 +1052,7 @@ export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,z=`import type { Context } from "hono";
+`,Ne=`import type { Context } from "hono";
 
 import {
   parseCookies,
@@ -324,12 +1101,7 @@ export const bodyparsers: {
     return ctx.req[as]();
   },
 };
-`,B=`import type { MiddlewareHandler } from "hono";
-import type { Router } from "hono/router";
-import { RegExpRouter } from "hono/router/reg-exp-router";
-import { SmartRouter } from "hono/router/smart-router";
-import { TrieRouter } from "hono/router/trie-router";
-import { match } from "path-to-regexp";
+`,Pe=`import type { MiddlewareHandler } from "hono";
 
 import type {
   RequestBodyTarget,
@@ -341,7 +1113,6 @@ import {
   type CreateRouteMiddleware,
   createRoutes,
   type HTTPMethod,
-  type RouterFactory,
   StateKey,
 } from "@kosmojs/core/api";
 import { ValidationError } from "@kosmojs/core/errors";
@@ -357,7 +1128,6 @@ import { type BodyparserOptions, bodyparsers, metaparsers } from "./parsers";
 import { routeSources } from "./routes";
 
 import globalMiddleware from "{{ createImport 'api' 'use' }}";
-import { apiRouteMap } from "{{ createImport 'libCore' }}";
 
 /**
  * Create route-level middleware stack that handles:
@@ -374,33 +1144,7 @@ import { apiRouteMap } from "{{ createImport 'libCore' }}";
  * */
 export const createRouteMiddleware: CreateRouteMiddleware<
   ParameterizedMiddleware
-> = ({ name, pathPattern, validationSchemas }) => {
-  const route = apiRouteMap[name];
-
-  if (!route) {
-    throw new Error(\`createRouteMiddleware: \${name} route does not exists\`);
-  }
-
-  const { params, numericProperties } = route;
-
-  const pathMatcher = match(pathPattern);
-
-  const matchPath = (path: string) => {
-    try {
-      return pathMatcher(path);
-    } catch (_e) {
-      return undefined;
-    }
-  };
-
-  const maybeNumber = (val: unknown) => {
-    if (val === undefined || val === null) {
-      return val;
-    }
-    const n = Number(val);
-    return Number.isFinite(n) ? n : val;
-  };
-
+> = ({ name, validationSchemas, normalizeParams, normalizeSearchParams }) => {
   const validationMiddleware = [
     /**
      * Extends Hono context with:
@@ -441,15 +1185,9 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                   ctx[StateKey].set(
                     target,
                     target === "query"
-                      ? Object.fromEntries(
-                          Object.entries(parser(ctx)).map(([k, v]) => [
-                            k,
-                            numericProperties.query[ctx.req.method]?.includes(k)
-                              ? Array.isArray(v)
-                                ? v.map((e) => maybeNumber(e))
-                                : maybeNumber(v)
-                              : v,
-                          ]),
+                      ? normalizeSearchParams(
+                          parser(ctx),
+                          ctx.req.method as never,
                         )
                       : parser(ctx),
                   );
@@ -502,23 +1240,7 @@ export const createRouteMiddleware: CreateRouteMiddleware<
      * */
     use(
       function useValidateParams(ctx, next) {
-        const matched = matchPath(ctx.req.path);
-        const normalizedParams = params.reduce(
-          (map: Record<string, unknown>, name) => {
-            const value = matched ? matched.params[name] : undefined;
-            if (Array.isArray(value)) {
-              map[name] = numericProperties.params.includes(name)
-                ? value.map((e) => maybeNumber(e))
-                : value;
-            } else if (value) {
-              map[name] = numericProperties.params.includes(name)
-                ? maybeNumber(value)
-                : value;
-            }
-            return map;
-          },
-          {},
-        );
+        const normalizedParams = normalizeParams(ctx.req.path);
         validationSchemas.params?.validate(normalizedParams);
         ctx[StateKey].set("params", normalizedParams);
         return next();
@@ -746,32 +1468,21 @@ export const routes = createRoutes<ParameterizedMiddleware, MiddlewareHandler>(
     createRouteMiddleware,
   },
 );
-
-export const routerFactory: RouterFactory<Router<never>, never> = (factory) => {
-  const createRouter = () => {
-    return new SmartRouter({
-      routers: [new RegExpRouter(), new TrieRouter()],
-    }) as Router<never>;
-  };
-  return factory({ createRouter });
-};
-`,V=`import { join } from "node:path";
+`,Fe=`import { join } from "node:path";
 
 import type { RouteSource } from "@kosmojs/core/api";
 
-import { base, apiBase } from "{{ createImport 'libCore' }}";
+import { base, apiBase, apiRouteMap, apiRouteMapper } from "{{ createImport 'libCore' }}";
 
 {{#each routes}}
 import {{id}} from "{{ createImport 'api' file }}";
-import { validationSchemas as {{id}}_schemas } from "{{ createImport 'libApi' name 'schemas' }}";
+import { validationSchemas as {{id}}_schemas } from "{{ createImport 'libApi' basename 'schemas' }}";
 {{/each}}
 
 {{#each cascadingMiddleware}}
 import {{id}}, { type UseT as UseT{{id}} } from "{{ createImport 'api' file }}";
 {{/each}}
 
-type Override<A, B> = Omit<A, keyof B> & B;
-
 export type RouteMap = {
 {{#each routes}}
   "{{name}}": {
@@ -785,14 +1496,16 @@ export type RouteMap = {
 export const routeSources: Array<RouteSource<never>> = [
   {{#each routes}}
   {
-    name: "{{name}}",
-    {{#if fullpath}}
-    path: "{{fullpath}}",
-    pathPattern: "{{fullpath}}",
+    {{#if alias}}
+    ...apiRouteMapper(apiBase, { ...{{serializeApiRoute .}}, pathPattern: "{{alias}}" }),
+    path: "{{alias}}",
+    pathPattern: "{{alias}}",
     {{else}}
+    ...apiRouteMap["{{name}}"],
     path: join(base, apiBase, "{{path}}"),
     pathPattern: join(base, apiBase, "{{pathPattern}}"),
     {{/if}}
+    name: "{{name}}",
     file: "{{file}}",
     cascadingMiddleware: [ {{#each cascadingMiddleware}}{{id}}, {{/each}}].flat() as Array<never>,
     definitionItems: {{id}} as never,
@@ -800,52 +1513,48 @@ export const routeSources: Array<RouteSource<never>> = [
   },
   {{/each}}
 ];
-`,pe=`import { chmod, unlink } from "node:fs/promises";
+`,Ie=`import { chmod, unlink } from "node:fs/promises";
 import { parseArgs, styleText } from "node:util";
 
 import { createAdaptorServer } from "@hono/node-server";
 
-import type { ServerFactory } from "@kosmojs/core/api";
-
 import type { App } from "./app";
 
-export const serverFactory: ServerFactory<App> = (factory) => {
-  const { values } = parseArgs({
-    options: {
-      port: {
-        type: "string",
-        short: "p",
-      },
-      sock: {
-        type: "string",
-        short: "s",
-      },
-    },
-  });
-
-  const getListenHandles = async () => {
-    const { port, sock } = { ...values };
+type Handles = {
+  port?: number | undefined;
+  sock?: string | undefined;
+  onListen?: () => Promise<void>;
+};
 
-    if (![port, sock].some(Boolean)) {
-      console.error("Please provide either -p/--port number or -s/--sock path");
-      process.exit(1);
-    }
+const getListenHandles = async (opt?: Handles) => {
+  const { port, sock } = opt
+    ? opt
+    : parseArgs({
+        options: {
+          port: {
+            type: "string",
+            short: "p",
+          },
+          sock: {
+            type: "string",
+            short: "s",
+          },
+        },
+      }).values;
 
-    if (sock) {
-      await unlink(sock).catch((error) => {
-        if (error.code === "ENOENT") {
-          return;
-        }
-        console.error(error.message);
-        process.exit(1);
-      });
-    }
+  if (![port, sock].some(Boolean)) {
+    throw new Error("Please provide either -p/--port number or -s/--sock path");
+  }
 
-    return { port, sock };
-  };
+  if (sock) {
+    await unlink(sock).catch((error) => {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    });
+  }
 
   const onListen = async () => {
-    const { port, sock } = await getListenHandles();
     if (sock) {
       // Make Unix socket world-writable so other processes (e.g. a reverse proxy)
       // can connect without permission issues.
@@ -857,50 +1566,39 @@ export const serverFactory: ServerFactory<App> = (factory) => {
     );
   };
 
-  return factory({
-    async createServer(app) {
-      const { port, sock } = await getListenHandles();
-
-      if (typeof Bun !== "undefined") {
-        const server = Bun.serve(
-          sock
-            ? { unix: sock, fetch: app.fetch }
-            : { port: Number(port), fetch: app.fetch },
-        );
-        await onListen();
-        return server as never;
-      }
-
-      if (typeof Deno !== "undefined") {
-        const server = sock
-          ? Deno.serve({ path: sock, onListen }, app.fetch)
-          : Deno.serve({ port: Number(port), onListen }, app.fetch);
-        return server as never;
-      }
+  return {
+    port: Number(port),
+    sock,
+    onListen: opt?.onListen || onListen,
+  };
+};
 
-      const server = createAdaptorServer(app);
-      server.listen(sock || port, onListen);
+export const serve = async <T extends App>(app: T, opt?: Handles) => {
+  const { port, sock, onListen } = await getListenHandles(opt);
 
-      return server as never;
-    },
-    getListenHandles,
-    onListen,
-  });
-};
+  if (typeof Bun !== "undefined") {
+    const server = Bun.serve(
+      sock
+        ? { unix: sock, fetch: app.fetch }
+        : { port: Number(port), fetch: app.fetch },
+    );
+    await onListen();
+    return server as never;
+  }
 
-process.on("unhandledRejection", (reason) => {
-  console.error("💥 UNHANDLED REJECTION - This is likely caused by:");
-  console.error("   - Middleware not awaiting next()");
-  console.error("   - Middleware not returning next()");
-  console.error("");
-  console.error("Reason:", reason);
-  console.error("");
-  // In development, crash hard
-  if (process.env.NODE_ENV === "development") {
-    process.exit(1);
+  if (typeof Deno !== "undefined") {
+    const server = sock
+      ? Deno.serve({ path: sock, onListen }, app.fetch)
+      : Deno.serve({ port: Number(port), onListen }, app.fetch);
+    return server as never;
   }
-});
-`,me=`import type { Context, Next } from "hono";
+
+  const server = createAdaptorServer(app);
+  server.listen(sock || port, onListen);
+
+  return server as never;
+};
+`,Le=`import type { Context, Next } from "hono";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
 import {
@@ -1083,29 +1781,20 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,he=`export * from "./@api/app";
+`,Re=`export * from "./@api/app";
+export { appFactory as default } from "./@api/app";
 export * from "./@api/dev";
 export * from "./@api/errors";
 export * from "./@api/router";
 export * from "./@api/routes";
 export * from "./@api/server";
-`,ge=`import defaultErrorHandler from "./errors";
-import router from "./router";
-
-import { appFactory, routes } from "{{ createImport 'lib' 'api:factory' }}";
-
-export default appFactory(({ createApp }) => {
-  const app = createApp({ router });
+`,ze=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
+import defaultErrorHandler from "./errors";
 
+export default appFactory(routes, ({ app }) => {
   app.onError(defaultErrorHandler);
-
-  for (const { path, methods, middleware } of routes) {
-    app.on(methods, [path], ...middleware);
-  }
-
-  return app;
-});
-`,_e=`import { getRequestListener } from "@hono/node-server";
+})
+`,Be=`import { getRequestListener } from "@hono/node-server";
 
 import app from "./app";
 
@@ -1119,45 +1808,50 @@ export default devSetup({
     // close db connections, server sockets etc.
   },
 });
-`,ve=`export declare module "{{ createImport 'libApi' }}" {
+
+process.on("unhandledRejection", (reason) => {
+  console.error("💥 UNHANDLED REJECTION");
+  console.error("Reason:", reason);
+  process.exit(1);
+});
+
+`,Ve=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultVariables {}
   interface DefaultBindings {}
 }
-`,ye=`import { accepts } from "hono/accepts";
+`,He=`import { accepts } from "hono/accepts";
 import { HTTPException } from "hono/http-exception";
 
 import { ValidationError, HTTPError } from "@kosmojs/core/errors";
 
 import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
 
-export default errorHandlerFactory(
-  async function defaultErrorHandler(error, ctx) {
-    // Let Hono's HTTPException handle its own response
-    if (error instanceof HTTPException) {
-      return error.getResponse();
-    }
+export default errorHandlerFactory(async (error, ctx) => {
+  // Let Hono's HTTPException handle its own response
+  if (error instanceof HTTPException) {
+    return error.getResponse();
+  }
 
-    const [status, message] = Array.isArray(error)
-      ? error
-      : error instanceof HTTPError
-        ? [error.status, error.message]
-        : error instanceof ValidationError
-          ? [400, \`\${error.target}: \${error.errorMessage}\`]
-          : [error.statusCode || 500, error.message];
-
-    // Respond based on what the client accepts
-    const type = accepts(ctx, {
-      header: "Accept",
-      supports: ["application/json", "text/plain"],
-      default: "text/plain",
-    });
+  const [status, message] = Array.isArray(error)
+    ? error
+    : error instanceof HTTPError
+      ? [error.status, error.message]
+      : error instanceof ValidationError
+        ? [400, \`\${error.target}: \${error.errorMessage}\`]
+        : [error.statusCode || 500, error.message];
+
+  // Respond based on what the client accepts
+  const type = accepts(ctx, {
+    header: "Accept",
+    supports: ["application/json", "text/plain"],
+    default: "text/plain",
+  });
 
-    return type === "application/json"
-      ? ctx.json({ error: message }, status)
-      : ctx.text(message, status);
-  },
-);
-`,be=`import { defineRoute } from "{{ createImport 'libApi' }}";
+  return type === "application/json"
+    ? ctx.json({ error: message }, status)
+    : ctx.text(message, status);
+});
+`,Ue=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (ctx) => {
@@ -1166,7 +1860,7 @@ export default defineRoute<"{{route.name}}">(({ GET }) => [
     return ctx.text("Automatically generated route");
   }),
 ]);
-`,xe=`import { use } from "{{ createImport 'libApi' }}";
+`,We=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -1177,20 +1871,11 @@ export default [
     return next();
   }),
 ];
-`,Se=`import { routerFactory } from "{{ createImport 'lib' 'api:factory' }}";
-
-export default routerFactory(({ createRouter }) => {
-  const router = createRouter();
-  return router;
-});
-`,Ce=`import app from "./app";
-
-import { serverFactory } from "{{ createImport 'lib' 'api:factory' }}";
+`,Ge=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+import app from "./app";
 
-serverFactory(async ({ createServer }) => {
-  await createServer(app);
-});
-`,we=`import { use } from "{{ createImport 'libApi' }}";
+await serve(app);
+`,Ke=`import { use } from "{{ createImport 'libApi' }}";
 
 /**
  * Define global middleware applied to all routes.
@@ -1201,9 +1886,10 @@ export default [
     return next();
   }),
 ];
-`,Te=f((t,n)=>{let{createPath:r,createImportHelpers:i}=h(t),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=_({helpers:{...i({origin:`lib`}),...b(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:c}=_({helpers:i({origin:`src`})}),u=e=>e?.trim().length===0,d=s(n?.templates,be),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await c(r.api(n.file),d(n.name,n),{route:n},{overwrite:u}):t===`apiUse`&&await c(r.api(n.file),xe,{},{overwrite:u})},p=async t=>{let i=t.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=t.flatMap(({kind:t,entry:r})=>{if(t!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((t,n)=>{let r=t[t.length-1];return t.push(r?e(r,n):n),t},[]),o={...r,path:r.honoPattern,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=g(e);return t===r.name?[{...o,name:e,id:`${o.id}_${x(e)}`,fullpath:l(n),pathTokens:n}]:[]})]}).sort(v);for(let[e,t]of[[`@api/routes.ts`,V]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,me],[`api:factory.ts`,he],[`@api/app.ts`,I],[`@api/parsers.ts`,z],[`@api/dev.ts`,L],[`@api/errors.ts`,R],[`@api/router.ts`,B],[`@api/server.ts`,pe]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,ge],[`dev.ts`,_e],[`errors.ts`,ye],[`router.ts`,Se],[`server.ts`,Ce],[`use.ts`,we]])await c(r.api(e),t,{},{overwrite:u});await o(r.api(`env.d.ts`),ve,{},{overwrite:u})},async watch(e,t){(!t||t.kind===`create`)&&await f(e),await p(e)},async build(e){await f(e),await p(e)}}}),Ee=d({meta:{name:`Hono`,slot:`backend`},dependencies:{hono:F.devDependencies.hono,"@hono/node-server":F.devDependencies[`@hono/node-server`],"path-to-regexp":F.devDependencies[`path-to-regexp`]},factory:Te}),H={type:`module`,private:!0,name:`@kosmojs/koa-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`},"./lib":{types:`./pkg/lib.d.ts`,default:`./pkg/lib.js`}},scripts:{build:`wsbuild src/index.ts src/lib.ts`,test:`vitest --root ../.. --project generators/koa-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@koa/router":`^15.7.0`,"@types/formidable":`^3.5.1`,"@types/koa":`^3.0.3`,"@types/koa-compose":`^3.2.9`,formidable:`^3.5.4`,koa:`^3.2.1`,"koa-compose":`^4.1.0`,"light-my-request":`^6.6.0`,"path-to-regexp":`^8.4.2`,"raw-body":`^4.0.0`,vite:`^8.2.1`}},De=`import Koa from "koa";
+`,qe=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,Ue),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),u(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),We,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,path:r.honoPattern,basename:r.name,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:d(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,Fe]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,Le],[`api:factory.ts`,Re],[`@api/app.ts`,Ae],[`@api/parsers.ts`,Ne],[`@api/dev.ts`,je],[`@api/errors.ts`,Me],[`@api/router.ts`,Pe],[`@api/server.ts`,Ie]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,ze],[`dev.ts`,Be],[`errors.ts`,He],[`server.ts`,Ge],[`use.ts`,Ke],[`env.d.ts`,Ve]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await f(e.filter(p(t,[`create`]))),await m(e)},async build(e){await f(e),await m(e)}}}),Je=h({meta:{name:`Hono`,slot:`backend`},dependencies:{hono:V.devDependencies.hono,"@hono/node-server":V.devDependencies[`@hono/node-server`]},factory:qe}),H={type:`module`,private:!0,name:`@kosmojs/koa-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`},"./lib":{types:`./pkg/lib.d.ts`,default:`./pkg/lib.js`}},scripts:{build:`wsbuild src/index.ts src/lib.ts`,test:`vitest --root ../.. --project generators/koa-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@koa/router":`^15.7.0`,"@types/formidable":`^3.5.1`,"@types/koa":`^3.0.3`,"@types/koa-compose":`^3.2.9`,formidable:`^3.5.4`,koa:`^3.2.1`,"koa-compose":`^4.1.0`,"light-my-request":`^6.6.0`,"raw-body":`^4.0.0`,vite:`^8.2.2`}},Ye=`import Router, { type RouterMiddleware } from "@koa/router";
+import Koa from "koa";
 
-import type { AppFactory } from "@kosmojs/core/api";
+import type { Route, RouteDebugOption } from "@kosmojs/core/api";
 
 import type { DefaultContext, DefaultState } from "../api";
 
@@ -1211,27 +1897,75 @@ export type App = Koa<DefaultState, DefaultContext>;
 
 export type AppOptions = ConstructorParameters<
   typeof Koa<DefaultState, DefaultContext>
->[0];
+>[0] & { router?: Router; debug?: RouteDebugOption };
+
+export function appFactory(
+  routes: Array<Route<RouterMiddleware>>,
+  options: AppOptions,
+): App;
+
+export function appFactory(
+  routes: Array<Route<RouterMiddleware>>,
+  fn: (a: { app: App; router: Router<never> }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<RouterMiddleware>>,
+  options: AppOptions,
+  fn: (a: { app: App; router: Router<never> }) => void,
+): App;
+
+export function appFactory(
+  routes: Array<Route<RouterMiddleware>>,
+  ...rest: Array<unknown>
+): App {
+  const [options, fn] = typeof rest[0] === "function" ? [{}, rest[0]] : rest;
 
-export const appFactory: AppFactory<App, AppOptions> = (factory) => {
-  const createApp = (options?: AppOptions) => {
-    return new Koa(options);
+  const {
+    router = new Router(),
+    debug = undefined,
+    ...appOptions
+  } = {
+    ...(options ? { ...options } : {}),
   };
-  return factory({ createApp });
-};
-`,Oe=`import type { DevSetup } from "@kosmojs/core/api";
+
+  for (const route of routes) {
+    if (typeof debug === "function") {
+      (debug as Function)(route.debug, route);
+    } else if (debug) {
+      console.log(route.debug[typeof debug === "string" ? debug : "full"]);
+    }
+    router.register(route.path, route.methods, route.middleware, route);
+  }
+
+  const app = new Koa(appOptions);
+
+  if (typeof fn === "function") {
+    fn({ app, router });
+  }
+
+  return app;
+}
+`,Xe=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,ke=`import type { ParameterizedMiddleware } from "../api";
+`,Ze=`import type {
+  DefaultContext,
+  DefaultState,
+  ParameterizedContext,
+} from "../api";
 
-export type ErrorHandlerFactory = (
-  h: ParameterizedMiddleware,
-) => ParameterizedMiddleware;
+type ErrorHandler = (
+  error: any,
+  ctx: ParameterizedContext<unknown, DefaultState, DefaultContext>,
+) => Promise<void> | void;
+
+export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,Ae=`import zlib from "node:zlib";
+`,Qe=`import zlib from "node:zlib";
 
 import type { RouterContext } from "@koa/router";
 import Formidable, { type Options as FormidableOptions } from "formidable";
@@ -1444,8 +2178,7 @@ export const bodyparsers: {
     return rawParser(stream, rawParserOptions);
   },
 };
-`,je=`import KoaRouter, { type RouterMiddleware } from "@koa/router";
-import { match } from "path-to-regexp";
+`,$e=`import type { RouterMiddleware } from "@koa/router";
 
 import type {
   RequestBodyTarget,
@@ -1457,7 +2190,6 @@ import {
   type CreateRouteMiddleware,
   createRoutes,
   type HTTPMethod,
-  type RouterFactory,
   StateKey,
 } from "@kosmojs/core/api";
 import { ValidationError } from "@kosmojs/core/errors";
@@ -1473,10 +2205,6 @@ import { type BodyparserOptions, bodyparsers, metaparsers } from "./parsers";
 import { routeSources } from "./routes";
 
 import globalMiddleware from "{{ createImport 'api' 'use' }}";
-import { apiRouteMap } from "{{ createImport 'libCore' }}";
-
-export type Router = import("@koa/router").Router<DefaultState, DefaultContext>;
-export type RouterOptions = import("@koa/router").RouterOptions;
 
 /**
  * Create route-level middleware stack that handles:
@@ -1493,33 +2221,7 @@ export type RouterOptions = import("@koa/router").RouterOptions;
  * */
 export const createRouteMiddleware: CreateRouteMiddleware<
   ParameterizedMiddleware
-> = ({ name, pathPattern, validationSchemas }) => {
-  const route = apiRouteMap[name];
-
-  if (!route) {
-    throw new Error(\`createRouteMiddleware: \${name} route does not exists\`);
-  }
-
-  const { params, numericProperties } = route;
-
-  const pathMatcher = match(pathPattern);
-
-  const matchPath = (path: string) => {
-    try {
-      return pathMatcher(path);
-    } catch (e) {
-      return undefined;
-    }
-  };
-
-  const maybeNumber = (val: unknown) => {
-    if (val === undefined || val === null) {
-      return val;
-    }
-    const n = Number(val);
-    return Number.isFinite(n) ? n : val;
-  };
-
+> = ({ name, validationSchemas, normalizeParams, normalizeSearchParams }) => {
   const validationMiddleware = [
     /**
      * Extends Koa context with:
@@ -1560,16 +2262,7 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                   ctx[StateKey].set(
                     target,
                     target === "query"
-                      ? Object.fromEntries(
-                          Object.entries(parser(ctx)).map(([k, v]) => [
-                            k,
-                            numericProperties.query[ctx.method]?.includes(k)
-                              ? Array.isArray(v)
-                                ? v.map((e) => maybeNumber(e))
-                                : maybeNumber(v)
-                              : v,
-                          ]),
-                        )
+                      ? normalizeSearchParams(parser(ctx), ctx.method as never)
                       : parser(ctx),
                   );
                 }
@@ -1621,23 +2314,7 @@ export const createRouteMiddleware: CreateRouteMiddleware<
      * */
     use(
       function useValidateParams(ctx, next) {
-        const matched = matchPath(ctx.path);
-        const normalizedParams = params.reduce(
-          (map: Record<string, unknown>, name) => {
-            const value = matched ? matched.params[name] : undefined;
-            if (Array.isArray(value)) {
-              map[name] = numericProperties.params.includes(name)
-                ? value.map((e) => maybeNumber(e))
-                : value;
-            } else if (value) {
-              map[name] = numericProperties.params.includes(name)
-                ? maybeNumber(value)
-                : value;
-            }
-            return map;
-          },
-          {},
-        );
+        const normalizedParams = normalizeParams(ctx.path);
         validationSchemas.params?.validate(normalizedParams);
         ctx[StateKey].set("params", normalizedParams);
         return next();
@@ -1866,32 +2543,21 @@ export const routes = createRoutes<ParameterizedMiddleware, RouterMiddleware>(
     createRouteMiddleware,
   },
 );
-
-export const routerFactory: RouterFactory<Router, RouterOptions> = (
-  factory,
-) => {
-  const createRouter = (options?: RouterOptions): Router => {
-    return new KoaRouter(options);
-  };
-  return factory({ createRouter });
-};
-`,Me=`import { join } from "node:path";
+`,et=`import { join } from "node:path";
 
 import type { RouteSource } from "@kosmojs/core/api";
 
-import { base, apiBase } from "{{ createImport 'libCore' }}";
+import { base, apiBase, apiRouteMap, apiRouteMapper } from "{{ createImport 'libCore' }}";
 
 {{#each routes}}
 import {{id}} from "{{ createImport 'api' file }}";
-import { validationSchemas as {{id}}_schemas } from "{{ createImport 'libApi' name 'schemas' }}";
+import { validationSchemas as {{id}}_schemas } from "{{ createImport 'libApi' basename 'schemas' }}";
 {{/each}}
 
 {{#each cascadingMiddleware}}
 import {{id}}, { type UseT as UseT{{id}} } from "{{ createImport 'api' file }}";
 {{/each}}
 
-type Override<A, B> = Omit<A, keyof B> & B;
-
 export type RouteMap = {
 {{#each routes}}
   "{{name}}": {
@@ -1905,65 +2571,63 @@ export type RouteMap = {
 export const routeSources: Array<RouteSource<never>> = [
   {{#each routes}}
   {
-    name: "{{name}}",
-    {{#if fullpath}}
-    path: "{{fullpath}}",
-    pathPattern: "{{fullpath}}",
+    {{#if alias}}
+    ...apiRouteMapper(apiBase, { ...{{serializeApiRoute .}}, pathPattern: "{{alias}}" }),
+    path: "{{alias}}",
+    pathPattern: "{{alias}}",
     {{else}}
+    ...apiRouteMap["{{name}}"],
     path: join(base, apiBase, "{{path}}"),
     pathPattern: join(base, apiBase, "{{pathPattern}}"),
     {{/if}}
+    name: "{{name}}",
     file: "{{file}}",
     cascadingMiddleware: [ {{#each cascadingMiddleware}}{{id}}, {{/each}}].flat() as Array<never>,
     definitionItems: {{id}} as never,
     validationSchemas: {{id}}_schemas,
   },
   {{/each}}
-] as const;
-`,Ne=`import { chmod, unlink } from "node:fs/promises";
+];
+`,tt=`import { chmod, unlink } from "node:fs/promises";
 import { parseArgs, styleText } from "node:util";
 
-import type { ServerFactory } from "@kosmojs/core/api";
-
 import type { App } from "./app";
 
-export const serverFactory: ServerFactory<App> = (factory) => {
-  const { values } = parseArgs({
-    options: {
-      port: {
-        type: "string",
-        short: "p",
-      },
-      sock: {
-        type: "string",
-        short: "s",
-      },
-    },
-  });
-
-  const getListenHandles = async () => {
-    const { port, sock } = { ...values };
+type Handles = {
+  port?: number | undefined;
+  sock?: string | undefined;
+  onListen?: () => Promise<void>;
+};
 
-    if (![port, sock].some(Boolean)) {
-      console.error("Please provide either -p/--port number or -s/--sock path");
-      process.exit(1);
-    }
+const getListenHandles = async (opt?: Handles): Promise<Handles> => {
+  const { port, sock } = opt
+    ? opt
+    : parseArgs({
+        options: {
+          port: {
+            type: "string",
+            short: "p",
+          },
+          sock: {
+            type: "string",
+            short: "s",
+          },
+        },
+      }).values;
 
-    if (sock) {
-      await unlink(sock).catch((error) => {
-        if (error.code === "ENOENT") {
-          return;
-        }
-        console.error(error.message);
-        process.exit(1);
-      });
-    }
+  if (![port, sock].some(Boolean)) {
+    throw new Error("Please provide either -p/--port number or -s/--sock path");
+  }
 
-    return { port, sock };
-  };
+  if (sock) {
+    await unlink(sock).catch((error) => {
+      if (error.code !== "ENOENT") {
+        throw error;
+      }
+    });
+  }
 
   const onListen = async () => {
-    const { port, sock } = await getListenHandles();
     if (sock) {
       // Make Unix socket world-writable so other processes (e.g. a reverse proxy)
       // can connect without permission issues.
@@ -1975,30 +2639,19 @@ export const serverFactory: ServerFactory<App> = (factory) => {
     );
   };
 
-  return factory({
-    async createServer(app) {
-      const { port, sock } = await getListenHandles();
-      const server = app.listen(port || sock, onListen);
-      return server as never;
-    },
-    getListenHandles,
-    onListen,
-  });
+  return {
+    port: port ? Number(port) : undefined,
+    sock,
+    onListen: opt?.onListen || onListen,
+  };
 };
 
-process.on("unhandledRejection", (reason) => {
-  console.error("💥 UNHANDLED REJECTION - This is likely caused by:");
-  console.error("   - Middleware not awaiting next()");
-  console.error("   - Middleware not returning next()");
-  console.error("");
-  console.error("Reason:", reason);
-  console.error("");
-  // In development, crash hard
-  if (process.env.NODE_ENV === "development") {
-    process.exit(1);
-  }
-});
-`,Pe=`import type { RouterContext } from "@koa/router";
+export const serve = async <T extends App>(app: T, opt?: Handles) => {
+  const { port, sock, onListen } = await getListenHandles(opt);
+  const server = app.listen(port || sock, onListen);
+  return server as never;
+};
+`,nt=`import type { RouterContext } from "@koa/router";
 import type { Next } from "koa";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
@@ -2160,25 +2813,25 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,Fe=`export * from "./@api/app";
+`,rt=`export * from "./@api/app";
+export { appFactory as default } from "./@api/app";
 export * from "./@api/dev";
 export * from "./@api/errors";
 export * from "./@api/router";
 export * from "./@api/routes";
 export * from "./@api/server";
-`,Ie=`import router from "./router";
+`,it=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
+import defaultErrorHandler from "./errors";
 
-import { appFactory } from "{{ createImport 'lib' 'api:factory' }}";
+export default appFactory(routes, ({ app, router }) => {
 
-export default appFactory(({ createApp }) => {
-  const app = createApp();
+  app.on("error", defaultErrorHandler);
 
   // NOTE: Routes should be added last, after any middleware
   app.use(router.routes());
 
-  return app;
 });
-`,Le=`import app from "./app";
+`,at=`import app from "./app";
 
 import { devSetup } from "{{ createImport 'lib' 'api:factory' }}";
 
@@ -2190,45 +2843,45 @@ export default devSetup({
     // close db connections, server sockets etc.
   },
 });
-`,Re=`export declare module "{{ createImport 'libApi' }}" {
+
+process.on("unhandledRejection", (reason) => {
+  console.error("💥 UNHANDLED REJECTION");
+  console.error("Reason:", reason);
+  process.exit(1);
+});
+`,ot=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultState {}
   interface DefaultContext {}
 }
-`,ze=`import { HTTPError, ValidationError } from "@kosmojs/core/errors";
+`,st=`import { HTTPError, ValidationError } from "@kosmojs/core/errors";
 
 import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
 
-export default errorHandlerFactory(
-  async function defaultErrorHandler(ctx, next) {
-    try {
-      await next();
-    } catch (error: any) {
-      const [status, message] = Array.isArray(error)
-        ? error
-        : error instanceof HTTPError
-          ? [error.status, error.message]
-          : error instanceof ValidationError
-            ? [400, \`\${error.target}: \${error.errorMessage}\`]
-            : [error.statusCode || 500, error.message];
-
-      ctx.status = status;
-
-      if (ctx.accepts("json")) {
-        ctx.body = { error: message };
-      } else {
-        ctx.body = message;
-      }
-    }
-  },
-);
-`,Be=`import { defineRoute } from "{{ createImport 'libApi' }}";
+export default errorHandlerFactory(async (error, ctx) => {
+  const [status, message] = Array.isArray(error)
+    ? error
+    : error instanceof HTTPError
+      ? [error.status, error.message]
+      : error instanceof ValidationError
+        ? [400, \`\${error.target}: \${error.errorMessage}\`]
+        : [error.statusCode || 500, error.message];
+
+  ctx.status = status;
+
+  if (ctx.accepts("json")) {
+    ctx.body = { error: message };
+  } else {
+    ctx.body = message;
+  }
+});
+`,ct=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (ctx) => {
     ctx.body = "Automatically generated route";
   }),
 ]);
-`,Ve=`import { use } from "{{ createImport 'libApi' }}";
+`,lt=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -2239,46 +2892,32 @@ export default [
     return next();
   }),
 ];
-`,He=`import { routerFactory, routes } from "{{ createImport 'lib' 'api:factory' }}";
-
-export default routerFactory(({ createRouter }) => {
-  const router = createRouter();
-
-  for (const { name, path, methods, middleware } of routes) {
-    router.register(path, methods, middleware, { name });
-  }
-
-  return router;
-});
-`,Ue=`import app from "./app";
-
-import { serverFactory } from "{{ createImport 'lib' 'api:factory' }}";
-
-serverFactory(async ({ createServer }) => {
-  await createServer(app);
-});
-`,We=`import defaultErrorHandler from "./errors";
+`,ut=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+import app from "./app";
 
-import { use } from "{{ createImport 'libApi' }}";
+await serve(app);
+`,dt=`import { use } from "{{ createImport 'libApi' }}";
 
+/**
+ * Define global middleware applied to all routes.
+ * Can be overridden on a per-route basis using the slot key.
+ * */
 export default [
-  /**
-   * Define global middleware applied to all routes.
-   * Can be overridden on a per-route basis using the slot key.
-   * */
-  use(defaultErrorHandler, { slot: "errorHandler" }),
+  use(async function useExample(ctx, next) {
+    return next();
+  }),
 ];
-`,Ge=f((t,n)=>{let{createPath:r,createImportHelpers:i}=h(t),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=_({helpers:{...i({origin:`lib`}),...b(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:c}=_({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,d=s(n?.templates,Be),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await c(r.api(n.file),d(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await c(r.api(n.file),Ve,{},{overwrite:l})},p=async t=>{let i=t.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=t.flatMap(({kind:t,entry:r})=>{if(t!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((t,n)=>{let r=t[t.length-1];return t.push(r?e(r,n):n),t},[]),o={...r,path:r.pathPattern,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=g(e);return t===r.name?[{...o,name:e,id:`${o.id}_${x(e)}`,fullpath:u(n),pathTokens:n}]:[]})]}).sort(v);for(let[e,t]of[[`@api/routes.ts`,Me]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,Pe],[`api:factory.ts`,Fe],[`@api/app.ts`,De],[`@api/dev.ts`,Oe],[`@api/errors.ts`,ke],[`@api/parsers.ts`,Ae],[`@api/router.ts`,je],[`@api/server.ts`,Ne]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,Ie],[`dev.ts`,Le],[`errors.ts`,ze],[`router.ts`,He],[`server.ts`,Ue],[`use.ts`,We]])await c(r.api(e),t,{},{overwrite:l});await o(r.api(`env.d.ts`),Re,{},{overwrite:l})},async watch(e,t){(!t||t.kind===`create`)&&await f(e),await p(e)},async build(e){await f(e),await p(e)}}}),Ke=d({meta:{name:`Koa`,slot:`backend`,types:[`@types/koa`]},dependencies:{koa:H.devDependencies.koa,"@koa/router":H.devDependencies[`@koa/router`],"path-to-regexp":H.devDependencies[`path-to-regexp`],formidable:H.devDependencies.formidable,"raw-body":H.devDependencies[`raw-body`]},devDependencies:{"@types/koa":H.devDependencies[`@types/koa`],"@types/formidable":H.devDependencies[`@types/formidable`]},factory:Ge}),U={type:`module`,private:!0,name:`@kosmojs/mdx-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@mdx-js/rollup":`^3.1.1`,vite:`^8.2.1`},devDependencies:{"@mdx-js/mdx":`^3.1.1`,"@mdx-js/preact":`^3.1.1`,"path-to-regexp":`^8.4.2`,preact:`^10.29.8`,"preact-render-to-string":`^6.7.0`,"remark-frontmatter":`^5.0.0`,"remark-mdx-frontmatter":`^5.2.0`}},qe=()=>{let e=[`🎉 Well done! You just created a new MDX page.`,`🚀 Success! A fresh MDX page is ready to roll.`,`🌟 Nice work! Another MDX page added to your site.`,`🧩 All set! A new MDX page has been scaffolded.`,`🔧 Scaffold complete! Your new MDX page is in place.`,`✅ Built! Your MDX page is scaffolded and ready.`,`✨ Fantastic! Your new MDX page is good to go.`,`🎯 Nailed it! A brand new MDX page just landed.`,`💫 Awesome! Another MDX page joins the party.`,`⚡ Lightning fast! A new MDX page created successfully.`];return e[Math.floor(Math.random()*e.length)]},Je=(e,t,n)=>{let{remarkPlugins:r=[],rehypePlugins:i=[]}={...n},a=()=>{let t=[`${c.srcDir}/${e.name}/${c.entryDir}/client.ts`].map(e=>C(e)),n=e=>t.some(t=>t(e));return{name:`kosmo:mdx[hmr]`,enforce:`post`,transform(e,t){if(!(!n(t)||e.includes(`import.meta.hot.accept`)))return{code:[e,`
+`,ft=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,ct),d=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),u(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),lt,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,basename:r.name,path:r.pathPattern,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:f(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,et]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,nt],[`api:factory.ts`,rt],[`@api/app.ts`,Ye],[`@api/dev.ts`,Xe],[`@api/errors.ts`,Ze],[`@api/parsers.ts`,Qe],[`@api/router.ts`,$e],[`@api/server.ts`,tt]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,it],[`dev.ts`,at],[`errors.ts`,st],[`server.ts`,ut],[`use.ts`,dt],[`env.d.ts`,ot]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await d(e.filter(p(t,[`create`]))),await m(e)},async build(e){await d(e),await m(e)}}}),pt=h({meta:{name:`Koa`,slot:`backend`,types:[`@types/koa`]},dependencies:{koa:H.devDependencies.koa,"@koa/router":H.devDependencies[`@koa/router`],formidable:H.devDependencies.formidable,"raw-body":H.devDependencies[`raw-body`]},devDependencies:{"@types/koa":H.devDependencies[`@types/koa`],"@types/formidable":H.devDependencies[`@types/formidable`]},factory:ft}),U={type:`module`,private:!0,name:`@kosmojs/mdx-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@mdx-js/rollup":`^3.1.1`,vite:`^8.2.2`},devDependencies:{"@mdx-js/mdx":`^3.1.1`,"@mdx-js/preact":`^3.1.1`,"path-to-regexp":`^8.4.2`,preact:`^10.29.8`,"preact-render-to-string":`^6.7.0`,"remark-frontmatter":`^5.0.0`,"remark-mdx-frontmatter":`^5.2.0`}},mt=()=>{let e=[`🎉 Well done! You just created a new MDX page.`,`🚀 Success! A fresh MDX page is ready to roll.`,`🌟 Nice work! Another MDX page added to your site.`,`🧩 All set! A new MDX page has been scaffolded.`,`🔧 Scaffold complete! Your new MDX page is in place.`,`✅ Built! Your MDX page is scaffolded and ready.`,`✨ Fantastic! Your new MDX page is good to go.`,`🎯 Nailed it! A brand new MDX page just landed.`,`💫 Awesome! Another MDX page joins the party.`,`⚡ Lightning fast! A new MDX page created successfully.`];return e[Math.floor(Math.random()*e.length)]},ht=(e,t,n)=>{let{remarkPlugins:r=[],rehypePlugins:i=[]}={...n},a=()=>{let t=[`${l.srcDir}/${e.name}/${l.entryDir}/client.ts`].map(e=>re(e)),n=e=>t.some(t=>t(e));return{name:`kosmo:mdx[hmr]`,enforce:`post`,transform(e,t){if(!(!n(t)||e.includes(`import.meta.hot.accept`)))return{code:[e,`
 if (import.meta.hot) {
   import.meta.hot.accept(() => {});
 }
 `].join(`
-`)}}}},o=[ne({jsxImportSource:`preact`,providerImportSource:`@mdx-js/preact`,remarkPlugins:r,rehypePlugins:i})];return t===`serve`&&o.push(a()),o},Ye=`import type { FunctionComponent } from "preact";
+`)}}}},o=[ne({jsxImportSource:`preact`,providerImportSource:`@mdx-js/preact`,remarkPlugins:r,rehypePlugins:i})];return t===`serve`&&o.push(a()),o},gt=`import type { FunctionComponent } from "preact";
 
 export const AppProvider: FunctionComponent = (props) => {
   return props.children;
 };
-`,Xe=`import { render, hydrate as hydrateOrig } from "preact";
+`,_t=`import { render, hydrate as hydrateOrig } from "preact";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -2319,7 +2958,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Ze=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
+`,vt=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
 
 import type {
   RenderToStringWrapper,
@@ -2393,7 +3032,7 @@ export const renderToString: RenderToStringWrapper<
 }
 
 export default serverRenderFactory<false>();
-`,Qe=`declare module "*.mdx" {
+`,yt=`declare module "*.mdx" {
   import type { ComponentType } from "preact";
   export const frontmatter: Record<string, unknown>;
   const component: ComponentType;
@@ -2406,7 +3045,7 @@ declare module "*.md" {
   const component: ComponentType;
   export default component;
 }
-`,$e=`import { MDXProvider } from "@mdx-js/preact";
+`,bt=`import { MDXProvider } from "@mdx-js/preact";
 import { match, pathToRegexp } from "path-to-regexp";
 import { type ComponentType, createContext, h, type VNode } from "preact";
 
@@ -2583,7 +3222,11 @@ export const createRoute = (
   loader: RawRoute["loader"],
   layouts: RawRoute["layouts"],
 ): RawRoute => {
-  const path = \`\${base}/\${pathPattern}\`.replace(/\\/+/g, "/");
+  // strip trailing slash (keeping a sole "/") so the base-joined index route
+  // matches both with and without it - "/docs/" as a pattern rejects "/docs"
+  const path = \`\${base}/\${pathPattern}\`
+    .replace(/\\/+/g, "/")
+    .replace(/(.+)\\/$/, "$1");
 
   const { regexp } = pathToRegexp(path, { sensitive: true });
   const matcher = match<Route["params"]>(path);
@@ -2591,9 +3234,11 @@ export const createRoute = (
   return {
     name,
     regexp,
+    // count segments of the same base-joined path the regexp matches against;
+    // resolve() compares this against the full url pathname's segment count
     pathSegments: name.includes("...")
       ? undefined
-      : name.replace(/^index(\\/?|$)/, "").split("/").length,
+      : path.split("/").filter(Boolean).length,
     extractParams: (path) => {
       const match = matcher(path);
       return match ? match.params : {};
@@ -2602,7 +3247,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,et=`/* @jsxImportSource preact */
+`,xt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2643,7 +3288,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,tt=`/* @jsxImportSource preact */
+`,St=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2695,7 +3340,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,nt=`* {
+`,Ct=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -2830,7 +3475,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,rt=`/* @jsxImportSource preact */
+`,wt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2896,7 +3541,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,it=`export type ParamsMap = {
+`,Tt=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -2905,7 +3550,7 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,at=`import type { ComponentType } from "preact";
+`,Et=`import type { ComponentType } from "preact";
 
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
@@ -2949,7 +3594,7 @@ export default createRouterFactory<
   Promise<RouteComponent>,
   { server: { route: Route } }
 >();
-`,ot=`import { join } from "node:path";
+`,Dt=`import { join } from "node:path";
 
 import { compile } from "path-to-regexp";
 
@@ -2995,7 +3640,7 @@ export default Object.entries(routes)
     return [];
   })
   .map((path) => join(base, path));
-`,st=`import type { PageRoute } from "@kosmojs/core";
+`,Ot=`import type { PageRoute } from "@kosmojs/core";
 
 {{#each pageRoutes}}
 import * as {{id}} from "{{ createImport 'pages' file }}";
@@ -3019,7 +3664,7 @@ const routeMap: Record<
 }
 
 export default routeMap;
-`,ct=`import { useContext } from "preact/hooks";
+`,kt=`import { useContext } from "preact/hooks";
 
 import { RouterContext } from "./mdx";
 
@@ -3065,10 +3710,10 @@ export const useFrontmatter = <
 >(): T => {
   return useRoute().frontmatter as T;
 };
-`,lt=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
+`,At=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 <AppProvider>{props.children}</AppProvider>
-`,ut=`import { h, type JSX } from "preact";
+`,jt=`import { h, type JSX } from "preact";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
 
@@ -3081,11 +3726,11 @@ export default function Link(
   const { to, query, children, ...restProps } = props;
 
   const [key, ...params] = to;
-  const href = pageRouteMap[key]?.base(params as never, query);
+  const href = pageRouteMap[key]?.path(params as never, query);
 
   return h("a", { ...restProps, href }, children);
 }
-`,dt=`/**
+`,Mt=`/**
  * MDX component overrides.
  *
  * Every standard markdown element (headings, links, code blocks, etc.)
@@ -3108,7 +3753,7 @@ export const components = {
 declare global {
   type MDXProvidedComponents = typeof components;
 }
-`,ft=`import renderFactory, {
+`,Nt=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -3135,7 +3780,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,pt=`import renderFactory, {
+`,Pt=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on MDX folders
@@ -3156,7 +3801,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,mt=`<!doctype html>
+`,Ft=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -3168,13 +3813,13 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,ht=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,It=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,gt=`{props.children}
-`,_t=`---
+`,Lt=`{props.children}
+`,Rt=`---
 title: "{{title}}"
 ---
 
@@ -3191,7 +3836,7 @@ export const pathMap = {
   routeName="{{route.name}}"
   pathMap={pathMap}
 />
-`,vt=`---
+`,zt=`---
 title: Welcome to KosmoJS
 description: Content-first development with MDX and Vite
 ---
@@ -3199,7 +3844,7 @@ description: Content-first development with MDX and Vite
 import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}"
 
 <WelcomePage />
-`,yt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Bt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.mdx";
 import { components } from "./components/mdx"
@@ -3215,12 +3860,12 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,bt=f((e,t)=>{let{createPath:n,createImportHelpers:r}=h(e),{renderToFile:i}=_({helpers:{...r({origin:`lib`}),...b(),serializeParams(e){return JSON.stringify(e.params)}}}),{renderToFile:a}=_({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,l=s(t?.templates,_t),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?vt:l(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:qe()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),gt,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(v)}]}return[]}).sort(v);for(let[e,a]of[[`client.ts`,Xe],[`server.ts`,Ze]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,it],[`router.ts`,at],[`ssg:routes.ts`,st]])await i(n.lib(e),t,{pageRoutes:r})};return{config({command:n}){return{oxc:{jsx:{importSource:`preact`}},plugins:Je(e,n,t)}},async start(){for(let[e,t]of[[`env.d.ts`,Qe],[`app.ts`,Ye],[`mdx.ts`,$e],[`use.ts`,ct],[`ssg.ts`,ot],[`pageSamples/styles.module.css`,nt],[`pageSamples/welcome.tsx`,rt],[`pageSamples/page.tsx`,tt],[`pageSamples/404.tsx`,et]])await i(n.lib(e),t,{});for(let[e,t]of[[`pages/404.mdx`,ht],[`components/Link.tsx`,ut],[`components/mdx.ts`,dt],[`app.mdx`,lt],[`router.ts`,yt]])await a(n.src(e),t,{entryDir:c.entryDir},{overwrite:o});await a(n.src(`index.html`),mt,{entryDir:c.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,ft],[`server.ts`,pt]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){(!t||t.kind===`create`)&&await u(e),await d(e)},async build(e){await u(e),await d(e)}}}),xt=d({meta:{name:`MDX`,jsxImportSource:`preact`},dependencies:{"path-to-regexp":U.devDependencies[`path-to-regexp`]},devDependencies:{preact:U.devDependencies.preact,"preact-render-to-string":U.devDependencies[`preact-render-to-string`],"@mdx-js/preact":U.devDependencies[`@mdx-js/preact`],"remark-frontmatter":U.devDependencies[`remark-frontmatter`],"remark-mdx-frontmatter":U.devDependencies[`remark-mdx-frontmatter`]},factory:bt}),St={json:`application/json`,form:[`application/x-www-form-urlencoded`,`multipart/form-data`],raw:void 0},Ct=()=>{let t=e=>[`Buffer`,`ArrayBuffer`,`Blob`].includes(e)?{type:`string`,format:`binary`}:ae.Script(e),n=(e,t,n)=>{let r=n?`${t}_${n.replace(/[^\w.-]/g,`_`)}${x(n)}`:t;return`${e.id}_${r}`},r=(e,t,r,i)=>[`#`,`components`,e,n(t,r,i)].join(`/`),a=e=>e.split(`/`).reduce((e,t)=>e+ +!t.includes(`{`),0),o=t=>{if(t.name===`index`)return[`/`];let{tokens:n}=ie(t.pathPattern),r=e=>e.flatMap(e=>{switch(e.type){case`param`:return[e.name];case`wildcard`:return[e.name];case`group`:return r(e.tokens);default:return[]}}),i=(e,t)=>{if(!e.length)return[t];let[n,...a]=e;switch(n.type){case`text`:return i(a,{path:`${t.path}${n.value}`,params:t.params});case`param`:return i(a,{path:`${t.path}{${n.name}}`,params:[...t.params,n.name]});case`wildcard`:return i(a,{path:`${t.path}{${n.name}*}`,params:[...t.params,n.name]});case`group`:{let e=i(a,t),o=i([...n.tokens,...a],t),s=r(n.tokens),c=o.filter(e=>s.some(t=>e.params.includes(t)));return[...e,...c]}}},o=i(n,{path:``,params:[]}),s=t.params.schema.reduce((e,{name:t},n)=>(e[n]=t,e),{});return o.reduce((t,n)=>{let r=e(`/`,n.path);return t.includes(r)||n.params.every((e,t)=>e===s[t])&&t.push(r),t},[]).sort((e,t)=>a(t)-a(e))},s=(e,t)=>{let n=e.params.resolvedType?.properties?.flatMap(n=>RegExp(`\\{${n.name}\\*?\\}`).test(t)?[{$ref:r(`parameters`,e,e.params.id,n.name)}]:[]);return n?.length?n:void 0},c=(e,t)=>{let n=e.validationDefinitions.find(e=>e.method===t&&e.target===`response`);return Array.isArray(n?.variants)?n.variants.reduce((t,{id:n,status:i,contentType:a,body:o})=>(t[i]=wt(i,a)||{description:`Success`,content:{[a||`application/json`]:{schema:o?{$ref:r(`schemas`,e,n)}:{type:`object`}}}},t),{}):{200:{description:`Success - TODO: Add response schema`,content:{"text/plain":{schema:{type:`string`}}}}}},l=e=>{let{parameters:r,schemas:i}={parameters:{},schemas:{}};for(let r of e.validationDefinitions)if(r.target===`response`)for(let{id:a,resolvedType:o}of r.variants)o?.typeboxSchema&&(i[n(e,a)]=t(o.typeboxSchema));else if(r.target===`query`){let{id:a,resolvedType:o}=r.schema;for(let r of o?.properties||[])if(r?.typeboxSchema){let o=n(e,a,r.name);i[o]=t(r.typeboxSchema)}}else{let{id:a,resolvedType:o}=r.schema;o?.typeboxSchema&&(i[n(e,a)]=t(o.typeboxSchema))}if(e.params.resolvedType)for(let i of e.params.resolvedType.properties||[])i?.typeboxSchema&&(r[n(e,e.params.id,i.name)]={name:i.name,in:`path`,required:!0,schema:t(i.typeboxSchema)});return{parameters:r,schemas:i}},u=e=>{let t={},n=e.validationDefinitions.flatMap(e=>e.target===`response`?[]:e.schema.resolvedType?[e]:[]);for(let a of o(e))for(let o of e.methods){let l={responses:c(e,o)},u=s(e,a);u&&(l.parameters=u);let d=n.find(e=>e.method===o&&e.target===`query`);if(d?.schema)for(let t of d.schema.resolvedType?.properties||[])l.parameters||=[],l.parameters.push({name:t.name,in:`query`,required:!t.optional,schema:{$ref:r(`schemas`,e,d.schema.id,t.name)}});let f=n.filter(e=>e.method===o&&Object.keys(i).includes(e.target));f.length&&(l.requestBody={required:!0,content:f.reduce((t,n)=>{let{contentType:i=St[n.target]}=n;if(i){let a={$ref:r(`schemas`,e,n.schema.id)};for(let e of[i].flat())t[e]={schema:a}}return t},{})}),t[a]||(t[a]={}),t[a][o.toLowerCase()]=l}return t};return{generateComponentId:n,generateComponentPath:r,generatePathVariations:o,generateOpenAPISchema:e=>{let t=new Map;for(let n of e)t.set(n.name,o(n));let{components:n,paths:r}=e.sort(v).flatMap(n=>{let r=t.get(n.name)??[];return r.length>0&&e.some(e=>{if(e.name===n.name)return!1;let i=t.get(e.name)??[],a=new Set(i);return r.every(e=>a.has(e))})?[]:[n]}).reduce((e,t)=>{let n=u(t),{parameters:r,schemas:i}=l(t);return{paths:{...e.paths,...n},components:{parameters:{...e.components.parameters,...r},schemas:{...e.components.schemas,...i}}}},{paths:{},components:{parameters:{},schemas:{}}});return{paths:r,components:n}}}},wt=(e,t)=>{let n={type:`string`,format:`uri`,...t?{enum:[t]}:{}};return{301:{description:`Moved Permanently`,headers:{Location:{description:`New permanent location`,schema:n}}},302:{description:`Found`,headers:{Location:{description:`Temporary location`,schema:n}}},303:{description:`See Other`,headers:{Location:{description:`Location to GET after POST/PUT/DELETE`,schema:n}}},307:{description:`Temporary Redirect`,headers:{Location:{description:`Temporary location (preserves request method)`,schema:n}}},308:{description:`Permanent Redirect`,headers:{Location:{description:`New permanent location (preserves request method)`,schema:n}}}}[e]},Tt=f((e,t)=>{let{outfile:n=``,...r}={...t},{createPath:i}=h(e),{generateOpenAPISchema:a}=Ct(),o=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]),{paths:o,components:s}=a(t),c={...JSON.parse(JSON.stringify(r)),paths:o,components:s},l=/ya?ml/.test(n)?re.stringify(c):JSON.stringify(c,null,2);await ee(i.src(n),l,{})};return{async watch(e){await o(e)},async build(e){await o(e)}}}),Et=d({meta:{name:`OpenAPI`,resolveTypes:!0},factory:Tt}),W={type:`module`,private:!0,name:`@kosmojs/react-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/react-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-react":`^6.0.5`},devDependencies:{"@tanstack/react-query":`^5.101.4`,"@types/react":`^19.2.18`,"@types/react-dom":`^19.2.4`,"path-to-regexp":`^8.4.2`,react:`^19.2.8`,"react-dom":`^19.2.8`,"react-router":`^8.3.0`}},Dt=e=>{let t=e.map(e=>e.orig).join(`/`),r=e=>e.kind===`splat`?`*`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[r(e.parts[0])]:(/\.\w+$/.test(e.orig)||(console.warn(`❗${n([`red`,`bold`],`WARN`)}: React Router v7 only supports dot-suffix mixed segments (e.g. :param.html).`),console.warn(`  ${n([`magenta`],e.orig)} in ${n([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:r(e)).join(``)])).join(`/`)},Ot=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=n=>n.flatMap(({index:n,layout:r,children:i})=>{let{name:a,pathTokens:o}={...n,...r};if(!o)return[];let s=`${a}:layout`,c=Dt(o),l=o.at(-1);return e(l)?n&&r?[{name:s,path:c,component:r.id,children:[{name:a,path:`*`,component:n.id}]}]:n?[{path:c,children:[{name:a,path:`*`,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]:n&&r?[{name:s,path:c,component:r.id,children:[{name:a,index:!0,component:n.id},...t(i)]}]:n?[{path:c,children:[{name:a,index:!0,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]});return t},kt=()=>{let e=[`🎉 Well done! You just created a new React route.`,`🚀 Success! A fresh React route is ready to roll.`,`🌟 Nice work! Another React route added to your app.`,`⚡ Quick and easy! Your new React route is good to go.`,`🥳 Congrats! Your app just leveled up with a new React route.`,`🧩 All set! A new React route has been scaffolded.`,`🔧 Scaffold complete! Your new React route is in place.`,`✨ Fantastic! Your new React route is ready.`,`🎯 Nailed it! A brand new React route just landed.`,`💫 Awesome! Another React route joins the lineup.`];return e[Math.floor(Math.random()*e.length)]},At=`import type { ReactNode } from "react";
+`,Vt=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w(),serializeParams(e){return JSON.stringify(e.params)}}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,Rt),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?zt:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:mt()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),Lt,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(S)}]}return[]}).sort(S);for(let[e,a]of[[`client.ts`,_t],[`server.ts`,vt]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Tt],[`router.ts`,Et],[`ssg:routes.ts`,Ot]])await i(n.lib(e),t,{pageRoutes:r})};return{config({command:n}){return{oxc:{jsx:{importSource:`preact`}},plugins:ht(e,n,t)}},async start(){for(let[e,t]of[[`env.d.ts`,yt],[`app.ts`,gt],[`mdx.ts`,bt],[`use.ts`,kt],[`ssg.ts`,Dt],[`pageSamples/styles.module.css`,Ct],[`pageSamples/welcome.tsx`,wt],[`pageSamples/page.tsx`,St],[`pageSamples/404.tsx`,xt]])await i(n.lib(e),t,{});for(let[e,t]of[[`pages/404.mdx`,It],[`components/Link.tsx`,jt],[`components/mdx.ts`,Mt],[`app.mdx`,At],[`router.ts`,Bt]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),Ft,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Nt],[`server.ts`,Pt]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){await u(e.filter(m(t,[`create`]))),await d(e)},async build(e){await u(e),await d(e)}}}),Ht=h({meta:{name:`MDX`,jsxImportSource:`preact`},dependencies:{"path-to-regexp":U.devDependencies[`path-to-regexp`]},devDependencies:{preact:U.devDependencies.preact,"preact-render-to-string":U.devDependencies[`preact-render-to-string`],"@mdx-js/preact":U.devDependencies[`@mdx-js/preact`],"remark-frontmatter":U.devDependencies[`remark-frontmatter`],"remark-mdx-frontmatter":U.devDependencies[`remark-mdx-frontmatter`]},factory:Vt}),Ut={json:`application/json`,form:[`application/x-www-form-urlencoded`,`multipart/form-data`],raw:void 0},Wt=()=>{let e=e=>[`Buffer`,`ArrayBuffer`,`Blob`].includes(e)?{type:`string`,format:`binary`}:oe.Script(e),n=(e,t,n)=>{let r=n?`${t}_${n.replace(/[^\w.-]/g,`_`)}${T(n)}`:t;return`${e.id}_${r}`},r=(e,t,r,i)=>[`#`,`components`,e,n(t,r,i)].join(`/`),i=e=>e.split(`/`).reduce((e,t)=>e+ +!t.includes(`{`),0),o=e=>{if(e.name===`index`)return[`/`];let{tokens:n}=ae(e.pathPattern),r=e=>e.flatMap(e=>{switch(e.type){case`param`:return[e.name];case`wildcard`:return[e.name];case`group`:return r(e.tokens);default:return[]}}),a=(e,t)=>{if(!e.length)return[t];let[n,...i]=e;switch(n.type){case`text`:return a(i,{path:`${t.path}${n.value}`,params:t.params});case`param`:return a(i,{path:`${t.path}{${n.name}}`,params:[...t.params,n.name]});case`wildcard`:return a(i,{path:`${t.path}{${n.name}*}`,params:[...t.params,n.name]});case`group`:{let e=a(i,t),o=a([...n.tokens,...i],t),s=r(n.tokens),c=o.filter(e=>s.some(t=>e.params.includes(t)));return[...e,...c]}}},o=a(n,{path:``,params:[]}),s=e.params.schema.reduce((e,{name:t},n)=>(e[n]=t,e),{});return o.reduce((e,n)=>{let r=t(`/`,n.path);return e.includes(r)||n.params.every((e,t)=>e===s[t])&&e.push(r),e},[]).sort((e,t)=>i(t)-i(e))},s=(e,t)=>{let n=e.params.resolvedType?.properties?.flatMap(n=>RegExp(`\\{${n.name}\\*?\\}`).test(t)?[{$ref:r(`parameters`,e,e.params.id,n.name)}]:[]);return n?.length?n:void 0},c=(e,t)=>{let n=e.validationDefinitions.find(e=>e.method===t&&e.target===`response`);return Array.isArray(n?.variants)?n.variants.reduce((t,{id:n,status:i,contentType:a,body:o})=>(t[i]=Gt(i,a)||{description:`Success`,content:{[a||`application/json`]:{schema:o?{$ref:r(`schemas`,e,n)}:{type:`object`}}}},t),{}):{200:{description:`Success - TODO: Add response schema`,content:{"text/plain":{schema:{type:`string`}}}}}},l=t=>{let{parameters:r,schemas:i}={parameters:{},schemas:{}};for(let r of t.validationDefinitions)if(r.target===`response`)for(let{id:a,resolvedType:o}of r.variants)o?.typeboxSchema&&(i[n(t,a)]=e(o.typeboxSchema));else if(r.target===`query`){let{id:a,resolvedType:o}=r.schema;for(let r of o?.properties||[])if(r?.typeboxSchema){let o=n(t,a,r.name);i[o]=e(r.typeboxSchema)}}else{let{id:a,resolvedType:o}=r.schema;o?.typeboxSchema&&(i[n(t,a)]=e(o.typeboxSchema))}if(t.params.resolvedType)for(let i of t.params.resolvedType.properties||[])i?.typeboxSchema&&(r[n(t,t.params.id,i.name)]={name:i.name,in:`path`,required:!0,schema:e(i.typeboxSchema)});return{parameters:r,schemas:i}},u=e=>{let t={},n=e.validationDefinitions.flatMap(e=>e.target===`response`?[]:e.schema.resolvedType?[e]:[]);for(let i of o(e))for(let o of e.methods){let l={responses:c(e,o)},u=s(e,i);u&&(l.parameters=u);let d=n.find(e=>e.method===o&&e.target===`query`);if(d?.schema)for(let t of d.schema.resolvedType?.properties||[])l.parameters||=[],l.parameters.push({name:t.name,in:`query`,required:!t.optional,schema:{$ref:r(`schemas`,e,d.schema.id,t.name)}});let f=n.filter(e=>e.method===o&&Object.keys(a).includes(e.target));f.length&&(l.requestBody={required:!0,content:f.reduce((t,n)=>{let{contentType:i=Ut[n.target]}=n;if(i){let a={$ref:r(`schemas`,e,n.schema.id)};for(let e of[i].flat())t[e]={schema:a}}return t},{})}),t[i]||(t[i]={}),t[i][o.toLowerCase()]=l}return t};return{generateComponentId:n,generateComponentPath:r,generatePathVariations:o,generateOpenAPISchema:e=>{let t=new Map;for(let n of e)t.set(n.name,o(n));let{components:n,paths:r}=e.sort(S).flatMap(n=>{let r=t.get(n.name)??[];return r.length>0&&e.some(e=>{if(e.name===n.name)return!1;let i=t.get(e.name)??[],a=new Set(i);return r.every(e=>a.has(e))})?[]:[n]}).reduce((e,t)=>{let n=u(t),{parameters:r,schemas:i}=l(t);return{paths:{...e.paths,...n},components:{parameters:{...e.components.parameters,...r},schemas:{...e.components.schemas,...i}}}},{paths:{},components:{parameters:{},schemas:{}}});return{paths:r,components:n}}}},Gt=(e,t)=>{let n={type:`string`,format:`uri`,...t?{enum:[t]}:{}};return{301:{description:`Moved Permanently`,headers:{Location:{description:`New permanent location`,schema:n}}},302:{description:`Found`,headers:{Location:{description:`Temporary location`,schema:n}}},303:{description:`See Other`,headers:{Location:{description:`Location to GET after POST/PUT/DELETE`,schema:n}}},307:{description:`Temporary Redirect`,headers:{Location:{description:`Temporary location (preserves request method)`,schema:n}}},308:{description:`Permanent Redirect`,headers:{Location:{description:`New permanent location (preserves request method)`,schema:n}}}}[e]},Kt=g((e,t)=>{let{outfile:n=``,...r}={...t},{createPath:i}=y(e),{generateOpenAPISchema:a}=Wt(),o=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]),{paths:o,components:s}=a(t),c={...JSON.parse(JSON.stringify(r)),paths:o,components:s},l=/ya?ml/.test(n)?ie.stringify(c):JSON.stringify(c,null,2);await ee(i.src(n),l,{})};return{async watch(e){await o(e)},async build(e){await o(e)}}}),qt=h({meta:{name:`OpenAPI`,resolveTypes:!0},factory:Kt}),W={type:`module`,private:!0,name:`@kosmojs/react-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/react-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-react":`^6.1.0`},devDependencies:{"@tanstack/react-query":`^5.101.4`,"@types/react":`^19.2.18`,"@types/react-dom":`^19.2.4`,"path-to-regexp":`^8.4.2`,react:`^19.2.8`,"react-dom":`^19.2.8`,"react-router":`^8.3.0`}},Jt=e=>{let t=e.map(e=>e.orig).join(`/`),n=e=>e.kind===`splat`?`*`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[n(e.parts[0])]:(/\.\w+$/.test(e.orig)||(console.warn(`❗${r([`red`,`bold`],`WARN`)}: React Router v7 only supports dot-suffix mixed segments (e.g. :param.html).`),console.warn(`  ${r([`magenta`],e.orig)} in ${r([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},Yt=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=n=>n.flatMap(({index:n,layout:r,children:i})=>{let{name:a,pathTokens:o}={...n,...r};if(!o)return[];let s=`${a}:layout`,c=Jt(o),l=o.at(-1);return e(l)?n&&r?[{name:s,path:c,component:r.id,children:[{name:a,path:`*`,component:n.id}]}]:n?[{path:c,children:[{name:a,path:`*`,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]:n&&r?[{name:s,path:c,component:r.id,children:[{name:a,index:!0,component:n.id},...t(i)]}]:n?[{path:c,children:[{name:a,index:!0,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]});return t},Xt=()=>{let e=[`🎉 Well done! You just created a new React route.`,`🚀 Success! A fresh React route is ready to roll.`,`🌟 Nice work! Another React route added to your app.`,`⚡ Quick and easy! Your new React route is good to go.`,`🥳 Congrats! Your app just leveled up with a new React route.`,`🧩 All set! A new React route has been scaffolded.`,`🔧 Scaffold complete! Your new React route is in place.`,`✨ Fantastic! Your new React route is ready.`,`🎯 Nailed it! A brand new React route just landed.`,`💫 Awesome! Another React route joins the lineup.`];return e[Math.floor(Math.random()*e.length)]},Zt=`import type { ReactNode } from "react";
 
 export const AppProvider = ({ children }: { children: ReactNode }) => {
   return children;
 }
-`,jt=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
+`,Qt=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import type { ReactNode } from "react";
 
 import { getQueryClient } from "./query";
@@ -3239,7 +3884,7 @@ export const AppProvider = ({
     </QueryClientProvider>
   );
 }
-`,Mt=`import { lazy, type JSX } from "react";
+`,$t=`import { lazy, type JSX } from "react";
 
 import {
   createRoot,
@@ -3293,7 +3938,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Nt=`{
+`,en=`{
   {{#if name}}
   id: "{{name}}",
   {{/if}}
@@ -3311,7 +3956,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,Pt=`import type { JSX } from "react";
+`,tn=`import type { JSX } from "react";
 
 import {
   renderToString as renderToStringOrig,
@@ -3377,7 +4022,7 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory();
-`,Ft=`/* @jsxImportSource react */
+`,nn=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3418,7 +4063,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,It=`/* @jsxImportSource react */
+`,rn=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3470,7 +4115,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,Lt=`* {
+`,an=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -3605,7 +4250,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,Rt=`/* @jsxImportSource react */
+`,on=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3671,7 +4316,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,zt=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,sn=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
 
 let client: QueryClient | undefined;
 
@@ -3686,7 +4331,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,Bt=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,cn=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -3709,7 +4354,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,Vt=`export type ComponentLoader = () => Promise<{
+`,ln=`export type ComponentLoader = () => Promise<{
   loader?: (arg: unknown) => Promise<unknown>;
 }>;
 
@@ -3729,7 +4374,7 @@ export const loaderFactory = (opt?: { withPreload?: boolean }) => {
     return opt?.withPreload ? { loader } : {};
   };
 };
-`,Ht=`import type { JSX, ComponentType } from "react";
+`,un=`import type { JSX, ComponentType } from "react";
 
 import {
   type RouteObject,
@@ -3787,7 +4432,7 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteObject, Promise<JSX.Element>>();
-`,Ut=`import { Outlet } from "react-router";
+`,dn=`import { Outlet } from "react-router";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 export default function App() {
@@ -3797,7 +4442,7 @@ export default function App() {
     </AppProvider>
   );
 }
-`,Wt=`import {
+`,fn=`import {
   type LinkProps as RouterLinkProps,
   Link as RouterLink,
 } from "react-router";
@@ -3816,7 +4461,7 @@ export default function Link(
 
   const href = () => {
     const [key, ...params] = to;
-    return pageRouteMap[key]?.base(params as never, query);
+    return pageRouteMap[key]?.path(params as never, query, { prefix: false });
   };
 
   return (
@@ -3825,7 +4470,7 @@ export default function Link(
     </RouterLink>
   );
 }
-`,Gt=`import renderFactory, {
+`,pn=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -3852,7 +4497,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Kt=`import renderFactory, {
+`,mn=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -3879,7 +4524,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,qt=`<!doctype html>
+`,hn=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -3891,17 +4536,17 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,Jt=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,gn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,Yt=`import { Outlet } from "react-router";
+`,_n=`import { Outlet } from "react-router";
 
 export default function Layout() {
   return <Outlet />;
 }
-`,Xt=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
+`,vn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -3914,8 +4559,8 @@ export default function Page() {
     },
   });
 }
-`,Zt=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,Qt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,yn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,bn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -3930,12 +4575,12 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,$t=f((e,t)=>{let{createPath:n,createImportHelpers:r}=h(e),{renderToFile:i}=_({helpers:{...r({origin:`lib`}),...b()},partials:{routePartial:Nt}}),{renderToFile:a}=_({helpers:r({origin:`src`})}),o=Ot(),l=e=>!e?.trim().length,u=s(t?.templates,Xt),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?Zt:u(r.name,r),{route:r,message:kt()},{overwrite:l}):t===`pageLayout`&&await a(n.pages(r.file),Yt,{route:r},{overwrite:l})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(v),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(m(r));for(let[e,t]of[[`client.ts`,Mt],[`server.ts`,Pt]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a});await i(n.lib(`router.tsx`),Ht,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[oe(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,``],[`react.ts`,Vt],[`pageSamples/styles.module.css`,Lt],[`pageSamples/welcome.tsx`,Rt],[`pageSamples/page.tsx`,It],[`pageSamples/404.tsx`,Ft],...t?.tanstack?.query?[[`app.tsx`,jt],[`query.ts`,zt]]:[[`app.tsx`,At],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.tsx`,Jt],[`components/Link.tsx`,Wt],[`app.tsx`,Ut],[`router.ts`,Qt]])await a(n.src(e),t,{entryDir:c.entryDir},{overwrite:l});await a(n.src(`index.html`),qt,{entryDir:c.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Gt],[`server.ts`,Kt]])await a(n.entry(e),t,{},{overwrite:l})},async watch(e,t){(!t||t.kind===`create`)&&await d(e),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?Bt:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),en=d({meta:{name:`React`,jsx:`preserve`,jsxImportSource:`react`},dependencies(e){return{react:W.devDependencies.react,"react-router":W.devDependencies[`react-router`],"path-to-regexp":W.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/react-query":W.devDependencies[`@tanstack/react-query`]}:{}}},devDependencies:{"@types/react":W.devDependencies[`@types/react`],"@types/react-dom":W.devDependencies[`@types/react-dom`],"react-dom":W.devDependencies[`react-dom`]},factory:$t}),G={type:`module`,private:!0,name:`@kosmojs/solid-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/solid-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"vite-plugin-solid":`^2.11.14`},devDependencies:{"@solidjs/router":`^1.0.0`,"@tanstack/solid-query":`^5.101.4`,"path-to-regexp":`^8.4.2`,"solid-js":`^1.9.14`}},tn=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=t=>t?.kind===`param`?t.parts[0]?.kind===`optional`||e(t):!1,n=r=>r.flatMap(({index:r,layout:i,children:a})=>{let{pathTokens:o}={...r,...i},s=K(o.map((e,n)=>e.kind===`param`&&(t(o[n+1])||a.some(e=>e.index?.pathTokens.some(t)))?{...e,parts:[{...e.parts[0],kind:`required`}]}:e)),c=o.at(-1);if(e(c)){let e=K([c]);return r&&i?[{path:s,component:i.id,children:[{path:e,component:r.id}]}]:r?[{path:s,children:[{path:e,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]}return r&&i?[{path:s,component:i.id,children:[{path:`/`,component:r.id},...n(a)]}]:r?[{path:s,children:[{path:`/`,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]});return n},K=e=>{let t=e.map(e=>e.orig).join(`/`),r=e=>e.kind===`splat`?`*${e.name}`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[r(e.parts[0])]:(e.parts.length&&(console.warn(`❗${n([`red`,`bold`],`WARN`)}: At the moment Solid Router does not support mixed path segments.`),console.warn(`  ${n([`magenta`],e.orig)} segment in ${n([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:r(e)).join(``)])).join(`/`)},nn=()=>{let e=[`🎉 Well done! You just created a new Solid route.`,`🚀 Success! A fresh Solid route is ready to roll.`,`🌟 Nice work! Another Solid route added to your app.`,`🧩 All set! A new Solid route has been scaffolded.`,`🔧 Scaffold complete! Your new Solid route is in place.`,`✅ Built! Your Solid route is scaffolded and ready.`,`✨ Fantastic! Your new Solid route is good to go.`,`🎯 Nailed it! A brand new Solid route just landed.`,`💫 Awesome! Another Solid route joins the party.`,`⚡ Lightning fast! A new Solid route created successfully.`];return e[Math.floor(Math.random()*e.length)]},rn=`import type { ParentComponent } from "solid-js";
+`,xn=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()},partials:{routePartial:en}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=Yt(),s=e=>!e?.trim().length,u=c(t?.templates,vn),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?yn:u(r.name,r),{route:r,message:Xt()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),_n,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(v(r));for(let[e,t]of[[`client.ts`,$t],[`server.ts`,tn]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a});await i(n.lib(`router.tsx`),un,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[se(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,``],[`react.ts`,ln],[`pageSamples/styles.module.css`,an],[`pageSamples/welcome.tsx`,on],[`pageSamples/page.tsx`,rn],[`pageSamples/404.tsx`,nn],...t?.tanstack?.query?[[`app.tsx`,Qt],[`query.ts`,sn]]:[[`app.tsx`,Zt],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.tsx`,gn],[`components/Link.tsx`,fn],[`app.tsx`,dn],[`router.ts`,bn]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),hn,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,pn],[`server.ts`,mn]])await a(n.entry(e),t,{},{overwrite:s})},async watch(e,t){await d(e.filter(m(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?cn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Sn=h({meta:{name:`React`,jsx:`preserve`,jsxImportSource:`react`},dependencies(e){return{react:W.devDependencies.react,"react-router":W.devDependencies[`react-router`],"path-to-regexp":W.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/react-query":W.devDependencies[`@tanstack/react-query`]}:{}}},devDependencies:{"@types/react":W.devDependencies[`@types/react`],"@types/react-dom":W.devDependencies[`@types/react-dom`],"react-dom":W.devDependencies[`react-dom`]},factory:xn}),G={type:`module`,private:!0,name:`@kosmojs/solid-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/solid-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"vite-plugin-solid":`^2.11.14`},devDependencies:{"@solidjs/router":`^1.0.0`,"@tanstack/solid-query":`^5.101.4`,"path-to-regexp":`^8.4.2`,"solid-js":`^1.9.15`}},Cn=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=t=>t?.kind===`param`?t.parts[0]?.kind===`optional`||e(t):!1,n=r=>r.flatMap(({index:r,layout:i,children:a})=>{let{pathTokens:o}={...r,...i},s=K(o.map((e,n)=>e.kind===`param`&&(t(o[n+1])||a.some(e=>e.index?.pathTokens.some(t)))?{...e,parts:[{...e.parts[0],kind:`required`}]}:e)),c=o.at(-1);if(e(c)){let e=K([c]);return r&&i?[{path:s,component:i.id,children:[{path:e,component:r.id}]}]:r?[{path:s,children:[{path:e,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]}return r&&i?[{path:s,component:i.id,children:[{path:`/`,component:r.id},...n(a)]}]:r?[{path:s,children:[{path:`/`,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]});return n},K=e=>{let t=e.map(e=>e.orig).join(`/`),n=e=>e.kind===`splat`?`*${e.name}`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[n(e.parts[0])]:(e.parts.length&&(console.warn(`❗${r([`red`,`bold`],`WARN`)}: At the moment Solid Router does not support mixed path segments.`),console.warn(`  ${r([`magenta`],e.orig)} segment in ${r([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},wn=()=>{let e=[`🎉 Well done! You just created a new Solid route.`,`🚀 Success! A fresh Solid route is ready to roll.`,`🌟 Nice work! Another Solid route added to your app.`,`🧩 All set! A new Solid route has been scaffolded.`,`🔧 Scaffold complete! Your new Solid route is in place.`,`✅ Built! Your Solid route is scaffolded and ready.`,`✨ Fantastic! Your new Solid route is good to go.`,`🎯 Nailed it! A brand new Solid route just landed.`,`💫 Awesome! Another Solid route joins the party.`,`⚡ Lightning fast! A new Solid route created successfully.`];return e[Math.floor(Math.random()*e.length)]},Tn=`import type { ParentComponent } from "solid-js";
 
 export const AppProvider: ParentComponent = (props) => {
   return props.children;
 };
-`,an=`import type { ParentComponent } from "solid-js";
+`,En=`import type { ParentComponent } from "solid-js";
 import { type QueryClient, QueryClientProvider } from "@tanstack/solid-query";
 
 import { getQueryClient } from "./query";
@@ -3947,7 +4592,7 @@ export const AppProvider: ParentComponent<{ client?: QueryClient }> = (props) =>
     </QueryClientProvider>
   );
 };
-`,on=`import { lazy, type JSX } from "solid-js";
+`,Dn=`import { lazy, type JSX } from "solid-js";
 import { hydrate as hydrateOrig, render } from "solid-js/web";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
@@ -3992,7 +4637,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,sn=`{
+`,On=`{
   path: "{{path}}",
   {{#if component}}
   component: {{component}}_component,
@@ -4002,7 +4647,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,cn=`import type { JSX } from "solid-js";
+`,kn=`import type { JSX } from "solid-js";
 
 import {
   generateHydrationScript,
@@ -4083,7 +4728,7 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory<true>();
-`,ln=`/* @jsxImportSource solid-js */
+`,An=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4124,7 +4769,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,un=`/* @jsxImportSource solid-js */
+`,jn=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4176,7 +4821,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,dn=`* {
+`,Mn=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -4311,7 +4956,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,fn=`/* @jsxImportSource solid-js */
+`,Nn=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4377,7 +5022,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,pn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,Pn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
 
 let client: QueryClient | undefined;
 
@@ -4392,7 +5037,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,mn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,Fn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -4415,7 +5060,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,hn=`import type { JSX, ParentComponent } from "solid-js";
+`,In=`import type { JSX, ParentComponent } from "solid-js";
 import { Router, type RouteDefinition } from "@solidjs/router";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
@@ -4451,7 +5096,7 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteDefinition, JSX.Element>();
-`,gn=`export type ComponentLoader = () => Promise<{
+`,Ln=`export type ComponentLoader = () => Promise<{
   preload?: () => Promise<unknown>;
 }>;
 
@@ -4466,10 +5111,10 @@ export const loaderFactory = (opt?: { withPreload?: boolean }) => {
     return opt?.withPreload ? { preload } : {};
   };
 };
-`,_n=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
+`,Rn=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
 
 export { unwrap } from "solid-js/store";
-`,vn=`import type { ParentComponent } from "solid-js";
+`,zn=`import type { ParentComponent } from "solid-js";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 const App: ParentComponent = (props) => {
@@ -4477,7 +5122,7 @@ const App: ParentComponent = (props) => {
 };
 
 export default App;
-`,yn=`import { A, type AnchorProps } from "@solidjs/router";
+`,Bn=`import { A, type AnchorProps } from "@solidjs/router";
 import { type JSXElement, splitProps } from "solid-js";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
@@ -4497,12 +5142,12 @@ export default function Link(
 
   const href = () => {
     const [key, ...params] = knownProps.to;
-    return pageRouteMap[key]?.base(params as never, knownProps.query);
+    return pageRouteMap[key]?.path(params as never, knownProps.query, { prefix: false });
   };
 
   return <A {...{ ...restProps, href: href() }}>{knownProps.children}</A>;
 }
-`,bn=`import renderFactory, {
+`,Vn=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -4529,7 +5174,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,xn=`import renderFactory, {
+`,Hn=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -4556,7 +5201,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,Sn=`<!doctype html>
+`,Un=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -4568,19 +5213,19 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,Cn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,Wn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,wn=`import type { ParentComponent } from "solid-js";
+`,Gn=`import type { ParentComponent } from "solid-js";
 
 const Layout: ParentComponent = (props) => {
   return props.children;
 };
 
 export default Layout;
-`,Tn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
+`,Kn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -4593,8 +5238,8 @@ export default function Page() {
     },
   });
 }
-`,En=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,Dn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,qn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,Jn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -4609,12 +5254,12 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,On=f((e,t)=>{let{generators:n=[]}=e.config,{createPath:r,createImportHelpers:i}=h(e),{renderToFile:a}=_({helpers:{...i({origin:`lib`}),...b()},partials:{routePartial:sn}}),{renderToFile:o}=_({helpers:i({origin:`src`})}),l=tn(),u=e=>!e?.trim().length,d=s(t?.templates,Tn),f=async e=>{for(let{kind:t,entry:n}of e)t===`pageRoute`?await o(r.pages(n.file),n.name===`index`?En:d(n.name,n),{route:n,message:nn()},{overwrite:u}):t===`pageLayout`&&await o(r.pages(n.file),wn,{route:n},{overwrite:u})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(v),n=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=l(m(n));for(let[e,t]of[[`client.ts`,on],[`server.ts`,cn]])await a(r.libEntry(e),t,{pageEntries:n,nestedRoutes:i});await a(r.lib(`router.tsx`),hn,{entries:e,indexRoutes:t})};return{config({command:e}){let{templates:r,...i}={...t};return{oxc:{jsx:{importSource:`solid-js`}},plugins:e===`build`?[w({...i,...n.some(e=>e.meta.slot===`ssr`)?{ssr:!0,solid:{...i?.solid,hydratable:!0}}:{}})]:[w({...i,dev:!0,hot:!0})]}},async start(){for(let[e,n]of[[`env.d.ts`,``],[`solid.ts`,gn],[`unwrap.ts`,_n],[`pageSamples/styles.module.css`,dn],[`pageSamples/welcome.tsx`,fn],[`pageSamples/page.tsx`,un],[`pageSamples/404.tsx`,ln],...t?.tanstack?.query?[[`app.tsx`,an],[`query.ts`,pn]]:[[`app.tsx`,rn],[`query.ts`,`/** tanstack query disabled */`]]])await a(r.lib(e),n,{});for(let[e,t]of[[`pages/404.tsx`,Cn],[`components/Link.tsx`,yn],[`app.tsx`,vn],[`router.ts`,Dn]])await o(r.src(e),t,{entryDir:c.entryDir},{overwrite:u});await o(r.src(`index.html`),Sn,{entryDir:c.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,bn],[`server.ts`,xn]])await o(r.entry(e),t,{},{overwrite:u})},async watch(e,t){(!t||t.kind===`create`)&&await f(e),await p(e)},async build(e){await f(e),await p(e)},async ssrBuild(){await a(r.lib(`query.ts`),t?.tanstack?.query?mn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),kn=d({meta:{name:`SolidJS`,jsx:`preserve`,jsxImportSource:`solid-js`},dependencies(e){return{"solid-js":G.devDependencies[`solid-js`],"@solidjs/router":G.devDependencies[`@solidjs/router`],"path-to-regexp":G.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/solid-query":G.devDependencies[`@tanstack/solid-query`]}:{}}},factory:On}),An=f(r=>{let{generators:i=[],refineTypeName:a,...o}={...r.config},{createPath:s}=h(r);return{async postBuild(){let a=s.distDir(`ssg`),c=t(a,`../ssr/server.js`);if(!await se(c,ce.F_OK).then(()=>!0,()=>!1)){console.error(),console.error(n(`red`,`❗Please enable ssrGenerator in ${r.name}/kosmo.config.ts`)),console.error(`  SSG generator can not run without SSR server`),console.error();return}let l=te(`${r.name}: SSG`);l.append(`preparing...`);let{createDisposableServer:u}=await import(c);await T(t(a,`../client/assets`),e(a,`assets`),{recursive:!0}),l.append(`bundling routes...`),await S(p(o,...i.map(({factory:e})=>e(r).config?.({kind:`client`,command:`build`})),{root:s.lib(),appType:`custom`,plugins:[y.tsconfigPaths(r),y.nodePrefix()],resolve:{conditions:[`node`]},build:{ssr:s.lib(`ssg.ts`),target:`esnext`,sourcemap:!1,emptyOutDir:!0,rolldownOptions:{output:{dir:a,entryFileNames:`routes.js`,format:`esm`}}}}));try{let t=await import(e(a,`routes.js`)).then(e=>e.default);u(async n=>{for(let[r,i]of t.entries()){l.append(`[ ${r+1} of ${t.length} ] ${i}`);let o=await jn(n,i);o!==void 0&&(await le(e(a,i),{recursive:!0}),await ue(e(a,e(i,`index.html`)),o,`utf8`))}l.succeed(`done ✨`)})}finally{await E(`${a}/routes.js`)}}}}),jn=async(e,t)=>{try{let n=`http://localhost:${e}${t}`;return await(await fetch(n)).text()}catch(e){console.error(n(`red`,`✗ SSG: Failed generating ${t} route: ${e.message}`));return}},Mn=d({meta:{name:`SSG`,slot:`ssg`},factory:An}),q={type:`module`,private:!0,name:`@kosmojs/ssr-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,vite:`^8.2.1`},devDependencies:{"@hono/node-server":`^2.1.0`,hono:`^4.13.1`,"light-my-request":`^6.6.0`,tinyglobby:`^0.2.17`}},Nn=`{{#if apiGenerator}}
+`,Yn=g((e,t)=>{let{generators:n=[]}=e.config,{createPath:r,createImportHelpers:i}=y(e),{renderToFile:a}=x({helpers:{...i({origin:`lib`}),...w()},partials:{routePartial:On}}),{renderToFile:o}=x({helpers:i({origin:`src`})}),s=Cn(),u=e=>!e?.trim().length,d=c(t?.templates,Kn),f=async e=>{for(let{kind:t,entry:n}of e)t===`pageRoute`?await o(r.pages(n.file),n.name===`index`?qn:d(n.name,n),{route:n,message:wn()},{overwrite:u}):t===`pageLayout`&&await o(r.pages(n.file),Gn,{route:n},{overwrite:u})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),n=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=s(v(n));for(let[e,t]of[[`client.ts`,Dn],[`server.ts`,kn]])await a(r.libEntry(e),t,{pageEntries:n,nestedRoutes:i});await a(r.lib(`router.tsx`),In,{entries:e,indexRoutes:t})};return{config({command:e}){let{templates:r,...i}={...t};return{oxc:{jsx:{importSource:`solid-js`}},plugins:e===`build`?[D({...i,...n.some(e=>e.meta.slot===`ssr`)?{ssr:!0,solid:{...i?.solid,hydratable:!0}}:{}})]:[D({...i,dev:!0,hot:!0})]}},async start(){for(let[e,n]of[[`env.d.ts`,``],[`solid.ts`,Ln],[`unwrap.ts`,Rn],[`pageSamples/styles.module.css`,Mn],[`pageSamples/welcome.tsx`,Nn],[`pageSamples/page.tsx`,jn],[`pageSamples/404.tsx`,An],...t?.tanstack?.query?[[`app.tsx`,En],[`query.ts`,Pn]]:[[`app.tsx`,Tn],[`query.ts`,`/** tanstack query disabled */`]]])await a(r.lib(e),n,{});for(let[e,t]of[[`pages/404.tsx`,Wn],[`components/Link.tsx`,Bn],[`app.tsx`,zn],[`router.ts`,Jn]])await o(r.src(e),t,{entryDir:l.entryDir},{overwrite:u});await o(r.src(`index.html`),Un,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Vn],[`server.ts`,Hn]])await o(r.entry(e),t,{},{overwrite:u})},async watch(e,t){await f(e.filter(m(t,[`create`]))),await p(e)},async build(e){await f(e),await p(e)},async ssrBuild(){await a(r.lib(`query.ts`),t?.tanstack?.query?Fn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Xn=h({meta:{name:`SolidJS`,jsx:`preserve`,jsxImportSource:`solid-js`},dependencies(e){return{"solid-js":G.devDependencies[`solid-js`],"@solidjs/router":G.devDependencies[`@solidjs/router`],"path-to-regexp":G.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/solid-query":G.devDependencies[`@tanstack/solid-query`]}:{}}},factory:Yn}),Zn=g(e=>{let{generators:i=[],refineTypeName:a,...o}={...e.config},{createPath:s}=y(e);return{async postBuild(){let a=s.distDir(`ssg`),c=n(a,`../ssr/server.js`);if(!await ce(c,le.F_OK).then(()=>!0,()=>!1)){console.error(),console.error(r(`red`,`❗Please enable ssrGenerator in ${e.name}/kosmo.config.ts`)),console.error(`  SSG generator can not run without SSR server`),console.error();return}let l=te(`${e.name}: SSG`);l.append(`preparing...`);let{createDisposableServer:u}=await import(c);await O(n(a,`../client/assets`),t(a,`assets`),{recursive:!0}),l.append(`bundling routes...`),await E(_(o,...i.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:s.lib(),appType:`custom`,plugins:[C.tsconfigPaths(e),C.nodePrefix()],resolve:{conditions:[`node`]},build:{ssr:s.lib(`ssg.ts`),target:`esnext`,sourcemap:!1,emptyOutDir:!0,rolldownOptions:{output:{dir:a,entryFileNames:`routes.js`,format:`esm`}}}}));try{let e=await import(t(a,`routes.js`)).then(e=>e.default);u(async n=>{for(let[r,i]of e.entries()){l.append(`[ ${r+1} of ${e.length} ] ${i}`);let o=await Qn(n,i);o!==void 0&&(await ue(t(a,i),{recursive:!0}),await de(t(a,t(i,`index.html`)),o,`utf8`))}l.succeed(`done ✨`)})}finally{await k(`${a}/routes.js`)}}}}),Qn=async(e,t)=>{try{let n=`http://localhost:${e}${t}`;return await(await fetch(n)).text()}catch(e){console.error(r(`red`,`✗ SSG: Failed generating ${t} route: ${e.message}`));return}},$n=h({meta:{name:`SSG`,slot:`ssg`},factory:Zn}),q={type:`module`,private:!0,name:`@kosmojs/ssr-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,vite:`^8.2.2`},devDependencies:{"@hono/node-server":`^2.1.1`,hono:`^4.13.3`,"light-my-request":`^6.6.0`,tinyglobby:`^0.2.17`}},er=`{{#if apiGenerator}}
 export { default as apiApp } from "{{ createImport 'api' 'app' }}";
 {{else}}
 export const apiApp = undefined;
 {{/if}}
-`,Pn=`import { AsyncLocalStorage } from "node:async_hooks";
+`,tr=`import { AsyncLocalStorage } from "node:async_hooks";
 
 import type { FetchApp, NodeApp } from "@kosmojs/core";
 
@@ -4658,7 +5303,7 @@ export const store = new AsyncLocalStorage<RequestContext>();
 export const isFetchApp = (app: FetchApp | NodeApp): app is FetchApp => {
   return typeof (app as FetchApp).fetch === "function";
 };
-`,Fn=`import { type RequestContext, store } from "./base";
+`,nr=`import { type RequestContext, store } from "./base";
 
 import { renderWrapper } from "{{ createImport 'libEntry' 'server' }}";
 
@@ -4680,9 +5325,7 @@ export const withSsrContext = <T>(
 export const errorProvider = () => {
   return store.getStore()?.error;
 };
-`,In=`import { inject } from "light-my-request";
-
-import type { FetchApp, NodeApp } from "@kosmojs/core";
+`,rr=`import type { FetchApp, NodeApp } from "@kosmojs/core";
 import type { Transport } from "@kosmojs/core/fetch";
 
 import {
@@ -4706,6 +5349,8 @@ const createDispatch = (app: FetchApp | NodeApp) => {
   return isFetchApp(app)
     ? app.fetch
     : async (request: Request): Promise<Response> => {
+        const { inject } = await import("light-my-request");
+
         /**
          * Node dispatch: serializes the web Request into light-my-request's
          * injection format and lifts the injected response back into a web Response.
@@ -4824,7 +5469,7 @@ const createTransport = (app: FetchApp | NodeApp): Transport => {
   };
 };
 
-const ssrTransport = apiApp ? createTransport(apiApp) : undefined;
+const ssrTransport = apiApp ? createTransport(apiApp as never) : undefined;
 
 export const transport = ssrTransport
   ? async (input: RequestInfo | URL, init?: RequestInit) => {
@@ -4883,12 +5528,12 @@ const pathnameOf = (input: RequestInfo | URL): string => {
   } catch {}
   return String(input);
 };
-`,Ln=`export const routeMap = [
+`,ir=`export const routeMap = [
 {{#each pageRoutes}}
   { pathPattern: "{{honoPattern}}", renderMode: "{{renderMode}}" },
 {{/each}}
 ];
-`,Rn=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
+`,ar=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
 import {
   createServer,
   type IncomingMessage,
@@ -5304,14 +5949,14 @@ if (isMain) {
     process.exit(1);
   }
 }
-`,zn=`string`,Bn=f((n,r)=>{let{generators:i=[],refineTypeName:a,...s}=n.config,{createPath:c,createImportHelpers:l}=h(n),{renderToFile:u}=_({helpers:{...l({origin:`lib`})}});return{async build(e){let t=r?.renderMode?typeof r.renderMode==`string`?()=>r.renderMode:o(r?.renderMode,`string`):()=>zn,n={renderMode:JSON.stringify(r?.renderMode||null),pageRoutes:e.flatMap(e=>e.kind===`pageRoute`?[{...e.entry,renderMode:t(e.entry.name)}]:[]).sort(v),apiGenerator:i.some(e=>e.meta.slot===`backend`)};for(let[e,t]of[[`ssr.ts`,Rn],[`@ssr/api.ts`,Nn],[`@ssr/__kosmo_ssr_bundle.ts`,Fn],[`@ssr/base.ts`,Pn],[`@ssr/fetch.ts`,In],[`@ssr/routes.ts`,Ln]])await u(c.lib(e),t,n)},async postBuild(){let r=c.distDir(`ssr`),a=[y.tsconfigPaths(n),y.nodePrefix()];for(let e of i)await e.factory(n).ssrBuild?.();await S(p(s,...i.map(({factory:e})=>e(n).config?.({kind:`client`,command:`build`})),{root:c.src(),plugins:a,define:{KOSMO_PRODUCTION_BUILD:`true`},build:{ssr:c.lib(`@ssr/__kosmo_ssr_bundle`),ssrEmitAssets:!0,sourcemap:!0,emptyOutDir:!0,minify:!1,rolldownOptions:{output:{dir:r,entryFileNames:`app.js`,format:`esm`}}}})),await S({root:c.lib(),configFile:!1,appType:`custom`,plugins:a,resolve:{conditions:[`node`]},build:{ssr:c.lib(`ssr.ts`),target:`esnext`,sourcemap:!0,emptyOutDir:!0,rolldownOptions:{output:{dir:e(r,`server`),entryFileNames:`server.js`,format:`esm`}}}}),await T(t(r,`../client`),r,{recursive:!0});for(let e of[`server.js`,`server.js.map`])await T(`${r}/server/${e}`,`${r}/${e}`);await E(`${r}/server`,{recursive:!0,force:!0})}}}),Vn=d({meta:{name:`SSR`,slot:`ssr`},dependencies:{tinyglobby:q.devDependencies.tinyglobby,hono:q.devDependencies.hono,"@hono/node-server":q.devDependencies[`@hono/node-server`],"light-my-request":q.devDependencies[`light-my-request`]},factory:Bn}),J={type:`module`,private:!0,name:`@kosmojs/svelte-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@sveltejs/vite-plugin-svelte":`^7.2.0`,vite:`^8.2.1`},devDependencies:{"@tanstack/svelte-query":`^6.1.38`,"path-to-regexp":`^8.4.2`,svelte:`^5.56.8`}},Hn=()=>{let e=[`🎉 Well done! You just created a new Svelte page.`,`🚀 Success! A fresh Svelte page is ready to roll.`,`🌟 Nice work! Another Svelte page added to your app.`,`🧩 All set! A new Svelte page has been scaffolded.`,`🔧 Scaffold complete! Your new Svelte page is in place.`,`✅ Built! Your Svelte page is scaffolded and ready.`,`✨ Fantastic! Your new Svelte page is good to go.`,`🎯 Nailed it! A brand new Svelte page just landed.`,`💫 Awesome! Another Svelte page joins the party.`,`⚡ Lightning fast! A new Svelte page created successfully.`];return e[Math.floor(Math.random()*e.length)]},Y=`<script lang="ts">
+`,or=`string`,sr=g((e,r)=>{let{generators:i=[],refineTypeName:a,...o}=e.config,{createPath:c,createImportHelpers:l}=y(e),{renderToFile:u}=x({helpers:{...l({origin:`lib`})}});return{async build(e){let t=r?.renderMode?typeof r.renderMode==`string`?()=>r.renderMode:s(r?.renderMode,`string`):()=>or,n={renderMode:JSON.stringify(r?.renderMode||null),pageRoutes:e.flatMap(e=>e.kind===`pageRoute`?[{...e.entry,renderMode:t(e.entry.name)}]:[]).sort(S),apiGenerator:i.some(e=>e.meta.slot===`backend`)};for(let[e,t]of[[`ssr.ts`,ar],[`@ssr/api.ts`,er],[`@ssr/__kosmo_ssr_bundle.ts`,nr],[`@ssr/base.ts`,tr],[`@ssr/fetch.ts`,rr],[`@ssr/routes.ts`,ir]])await u(c.lib(e),t,n)},async postBuild(){let r=c.distDir(`ssr`),a=[C.tsconfigPaths(e),C.nodePrefix()];for(let t of i)await t.factory(e).ssrBuild?.();await E(_(o,...i.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:c.src(),plugins:a,define:{KOSMO_PRODUCTION_BUILD:`true`},build:{ssr:c.lib(`@ssr/__kosmo_ssr_bundle`),ssrEmitAssets:!0,sourcemap:!0,emptyOutDir:!0,minify:!1,rolldownOptions:{output:{dir:r,entryFileNames:`app.js`,format:`esm`}}}})),await E({root:c.lib(),configFile:!1,appType:`custom`,plugins:a,resolve:{conditions:[`node`]},build:{ssr:c.lib(`ssr.ts`),target:`esnext`,sourcemap:!0,emptyOutDir:!0,rolldownOptions:{output:{dir:t(r,`server`),entryFileNames:`server.js`,format:`esm`}}}}),await O(n(r,`../client`),r,{recursive:!0});for(let e of[`server.js`,`server.js.map`])await O(`${r}/server/${e}`,`${r}/${e}`);await k(`${r}/server`,{recursive:!0,force:!0})}}}),cr=h({meta:{name:`SSR`,slot:`ssr`},dependencies:{tinyglobby:q.devDependencies.tinyglobby,hono:q.devDependencies.hono,"@hono/node-server":q.devDependencies[`@hono/node-server`],"light-my-request":q.devDependencies[`light-my-request`]},factory:sr}),J={type:`module`,private:!0,name:`@kosmojs/svelte-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@sveltejs/vite-plugin-svelte":`^7.3.0`,vite:`^8.2.2`},devDependencies:{"@tanstack/svelte-query":`^6.1.38`,"path-to-regexp":`^8.4.2`,svelte:`^5.56.10`}},lr=()=>{let e=[`🎉 Well done! You just created a new Svelte page.`,`🚀 Success! A fresh Svelte page is ready to roll.`,`🌟 Nice work! Another Svelte page added to your app.`,`🧩 All set! A new Svelte page has been scaffolded.`,`🔧 Scaffold complete! Your new Svelte page is in place.`,`✅ Built! Your Svelte page is scaffolded and ready.`,`✨ Fantastic! Your new Svelte page is good to go.`,`🎯 Nailed it! A brand new Svelte page just landed.`,`💫 Awesome! Another Svelte page joins the party.`,`⚡ Lightning fast! A new Svelte page created successfully.`];return e[Math.floor(Math.random()*e.length)]},Y=`<script lang="ts">
   import type { Snippet } from "svelte";
 
   let { children }: { children: Snippet } = $props();
 <\/script>
 
 {@render children()}
-`,Un=`<script lang="ts">
+`,ur=`<script lang="ts">
   import { type QueryClient, QueryClientProvider } from "@tanstack/svelte-query";
   import type { Snippet } from "svelte";
 
@@ -5328,7 +5973,7 @@ if (isMain) {
 <QueryClientProvider client={queryClient}>
   {@render children()}
 </QueryClientProvider>
-`,Wn=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
+`,dr=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -5369,7 +6014,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Gn=`import { render as renderOrig } from "svelte/server";
+`,fr=`import { render as renderOrig } from "svelte/server";
 
 import type {
   RenderToStringWrapper,
@@ -5435,12 +6080,12 @@ export const renderToString: RenderToStringWrapper<
 // svelte/server exposes only render() - no web-stream renderer -
 // so this folder is string-only SSR.
 export default serverRenderFactory<false>();
-`,Kn=`declare module "*.svelte" {
+`,pr=`declare module "*.svelte" {
   import type { Component } from "svelte";
   const component: Component;
   export default component;
 }
-`,qn=`<script lang="ts">
+`,mr=`<script lang="ts">
   /**
    * Folds [app, ...layouts] around the page component.
    *
@@ -5474,7 +6119,7 @@ export default serverRenderFactory<false>();
 {/snippet}
 
 {@render layer(0)}
-`,Jn=`<script lang="ts">
+`,hr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let { headline }: { headline?: string } = $props();
@@ -5506,7 +6151,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Yn=`<script lang="ts">
+`,gr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let {
@@ -5551,7 +6196,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Xn=`* {
+`,_r=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -5686,7 +6331,7 @@ export default serverRenderFactory<false>();
   align-items: center;
   gap: 0.25rem;
 }
-`,Zn=`<script lang="ts">
+`,vr=`<script lang="ts">
   import styles from "./styles.module.css";
 <\/script>
 
@@ -5744,7 +6389,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Qn=`export type ParamsMap = {
+`,yr=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -5753,7 +6398,7 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,$n=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,br=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
 
 let client: QueryClient | undefined;
 
@@ -5768,7 +6413,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,er=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,xr=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -5791,7 +6436,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,tr=`import type { RouterFactoryReturn } from "@kosmojs/core";
+`,Sr=`import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
 
 import Layouts from "./Layouts.svelte";
@@ -5831,7 +6476,7 @@ export default createRouterFactory<
   Promise<RouteComponent>,
   { server: { route: Route } }
 >();
-`,nr=`import { match, pathToRegexp } from "path-to-regexp";
+`,Cr=`import { match, pathToRegexp } from "path-to-regexp";
 import { type Component, createContext } from "svelte";
 
 import { parseSearchParams } from "@kosmojs/core";
@@ -6033,7 +6678,11 @@ export const createRoute = (
   loader: RawRoute["loader"],
   layouts: RawRoute["layouts"],
 ): RawRoute => {
-  const path = \`\${base}/\${pathPattern}\`.replace(/\\/+/g, "/");
+  // strip trailing slash (keeping a sole "/") so the base-joined index route
+  // matches both with and without it - "/docs/" as a pattern rejects "/docs"
+  const path = \`\${base}/\${pathPattern}\`
+    .replace(/\\/+/g, "/")
+    .replace(/(.+)\\/$/, "$1");
 
   const { regexp } = pathToRegexp(path, { sensitive: true });
   const matcher = match<Route["params"]>(path);
@@ -6041,9 +6690,11 @@ export const createRoute = (
   return {
     name,
     regexp,
+    // count segments of the same base-joined path the regexp matches against;
+    // resolve() compares this against the full url pathname's segment count
     pathSegments: name.includes("...")
       ? undefined
-      : name.replace(/^index(\\/?|$)/, "").split("/").length,
+      : path.split("/").filter(Boolean).length,
     extractParams: (path) => {
       const match = matcher(path);
       return match ? match.params : {};
@@ -6052,7 +6703,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,rr=`import { getRouteContext } from "./svelte";
+`,wr=`import { getRouteContext } from "./svelte";
 
 import type { ParamsMap, paramNames } from "{{ createImport 'lib' 'params' }}";
 
@@ -6092,7 +6743,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
   const route = useRoute();
   return route.loaderData?.[key || route.name] as T;
 };
-`,ir=`<script lang="ts">
+`,Tr=`<script lang="ts">
   import { AppProvider } from "{{ createImport 'lib' 'app' }}";
   import type { Snippet } from "svelte";
 
@@ -6102,7 +6753,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 <AppProvider>
   {@render children()}
 </AppProvider>
-`,ar=`<script lang="ts">
+`,Er=`<script lang="ts">
   import type { Snippet } from "svelte";
   import type { HTMLAnchorAttributes } from "svelte/elements";
 
@@ -6121,12 +6772,12 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 
   const href = $derived.by(() => {
     const [key, ...params] = to;
-    return pageRouteMap[key]?.base(params as never, query);
+    return pageRouteMap[key]?.path(params as never, query);
   });
 <\/script>
 
 <a {href} {...rest}>{@render children?.()}</a>
-`,or=`import renderFactory, {
+`,Dr=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -6153,7 +6804,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,sr=`import renderFactory, {
+`,Or=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on Svelte folders
@@ -6174,7 +6825,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,cr=`<!doctype html>
+`,kr=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -6186,19 +6837,19 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,lr=`<script lang="ts">
+`,Ar=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/404.svelte' }}";
 <\/script>
 
 <PageSample />
-`,ur=`<script lang="ts">
+`,jr=`<script lang="ts">
   import type { Snippet } from "svelte";
 
   let { children }: { children: Snippet } = $props();
 <\/script>
 
 {@render children()}
-`,dr=`<script lang="ts">
+`,Mr=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/page.svelte' }}";
 
   const pathMap = {
@@ -6217,7 +6868,7 @@ export default renderFactory(() => {
   routeName={"{{route.name}}"}
   {pathMap}
 />
-`,fr=`<script lang="ts">
+`,Nr=`<script lang="ts">
   import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.svelte' }}";
 <\/script>
 
@@ -6230,7 +6881,7 @@ export default renderFactory(() => {
 </svelte:head>
 
 <WelcomePage />
-`,pr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Pr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.svelte";
 
@@ -6245,7 +6896,7 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,mr=f((e,t)=>{let{createPath:n,createImportHelpers:r}=h(e),{renderToFile:i}=_({helpers:{...r({origin:`lib`}),...b()}}),{renderToFile:a}=_({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,l=s(t?.templates,dr),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?fr:l(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:Hn()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),ur,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(v)}]}return[]}).sort(v);for(let[e,a]of[[`client.ts`,Wn],[`server.ts`,Gn]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Qn],[`router.ts`,tr]])await i(n.lib(e),t,{pageRoutes:r})};return{config(){let{templates:e,...n}={...t};return{plugins:de(n)}},async start(){for(let[e,r]of[[`env.d.ts`,Kn],[`svelte.ts`,nr],[`Layouts.svelte`,qn],[`use.ts`,rr],[`pageSamples/styles.module.css`,Xn],[`pageSamples/welcome.svelte`,Zn],[`pageSamples/page.svelte`,Yn],[`pageSamples/404.svelte`,Jn],...t?.tanstack?.query?[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,Un],[`app/index.ts`,`export { default as AppProvider } from "./app-tsq.svelte";`],[`query.ts`,$n]]:[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,`/** tanstack query disabled */`],[`app/index.ts`,`export { default as AppProvider } from "./app.svelte";`],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.svelte`,lr],[`components/Link.svelte`,ar],[`app.svelte`,ir],[`router.ts`,pr]])await a(n.src(e),t,{entryDir:c.entryDir},{overwrite:o});await a(n.src(`index.html`),cr,{entryDir:c.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,or],[`server.ts`,sr]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){(!t||t.kind===`create`)&&await u(e),await d(e)},async build(e){await u(e),await d(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?er:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),hr=d({meta:{name:`Svelte`},dependencies(e){return{svelte:J.devDependencies.svelte,"path-to-regexp":J.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/svelte-query":J.devDependencies[`@tanstack/svelte-query`]}:{}}},factory:mr}),gr={type:`module`,private:!0,name:`@kosmojs/typebox-generator`,version:`0.3.0`,cacheVersion:`1`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/typebox-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`,semver:`^7.8.5`},devDependencies:{"@kosmojs/core-generator":`workspace:^`,"@kosmojs/koa-generator":`workspace:^`,typebox:`^1.3.11`}},_r=`import Type from "typebox";
+`,Fr=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,Mr),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?Nr:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:lr()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),jr,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(S)}]}return[]}).sort(S);for(let[e,a]of[[`client.ts`,dr],[`server.ts`,fr]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,yr],[`router.ts`,Sr]])await i(n.lib(e),t,{pageRoutes:r})};return{config(){let{templates:e,...n}={...t};return{plugins:fe(n)}},async start(){for(let[e,r]of[[`env.d.ts`,pr],[`svelte.ts`,Cr],[`Layouts.svelte`,mr],[`use.ts`,wr],[`pageSamples/styles.module.css`,_r],[`pageSamples/welcome.svelte`,vr],[`pageSamples/page.svelte`,gr],[`pageSamples/404.svelte`,hr],...t?.tanstack?.query?[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,ur],[`app/index.ts`,`export { default as AppProvider } from "./app-tsq.svelte";`],[`query.ts`,br]]:[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,`/** tanstack query disabled */`],[`app/index.ts`,`export { default as AppProvider } from "./app.svelte";`],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.svelte`,Ar],[`components/Link.svelte`,Er],[`app.svelte`,Tr],[`router.ts`,Pr]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),kr,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Dr],[`server.ts`,Or]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){await u(e.filter(m(t,[`create`]))),await d(e)},async build(e){await u(e),await d(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?xr:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Ir=h({meta:{name:`Svelte`},dependencies(e){return{svelte:J.devDependencies.svelte,"path-to-regexp":J.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/svelte-query":J.devDependencies[`@tanstack/svelte-query`]}:{}}},factory:Fr}),Lr={type:`module`,private:!0,name:`@kosmojs/typebox-generator`,version:`0.3.0`,cacheVersion:`1`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/typebox-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`,semver:`^7.8.5`},devDependencies:{"@kosmojs/core-generator":`workspace:^`,"@kosmojs/koa-generator":`workspace:^`,typebox:`^1.3.16`}},Rr=`import Type from "typebox";
 
 /**
  * Custom types for JavaScript constructs that have no JSON Schema
@@ -6317,7 +6968,7 @@ export default {
   Buffer: TBuffer(),
   ArrayBuffer: TArrayBuffer(),
 };
-`,vr=`import type { TValidationError } from "typebox/error";
+`,zr=`import type { TValidationError } from "typebox/error";
 
 import type { ValidationErrorEntry } from "@kosmojs/core";
 
@@ -7501,7 +8152,7 @@ const format = (fmt: string, ...args: unknown[]): string => {
 
   return str;
 };
-`,yr=`import Type from "typebox";
+`,Br=`import Type from "typebox";
 import { Compile } from "typebox/compile";
 import Value from "typebox/value";
 
@@ -7553,14 +8204,14 @@ export const validationSchemaFactory = (
     },
   };
 };
-`,br=`import { Settings } from "typebox/system";
+`,Vr=`import { Settings } from "typebox/system";
 
 Settings.Set({{settings}});
 
 export { default as customTypes } from "{{customTypesImport}}";
 
 export const validationMessages = {{validationMessages}};
-`,xr=`import type { ValidationSchemas } from "@kosmojs/core";
+`,Hr=`import type { ValidationSchemas } from "@kosmojs/core";
 
 import { validationSchemaFactory } from "{{ createImport 'lib' '@typebox' }}";
 
@@ -7621,14 +8272,14 @@ export const validationSchemas: ValidationSchemas = {
   {{/each}}
   },
 };
-`,Sr={exactOptionalPropertyTypes:!0},Cr=f((e,t)=>{let{createPath:n,createImport:r,createImportHelpers:i}=h(e),{renderToFile:o}=_({helpers:{...i({origin:`lib`})}}),{validationMessages:s={},customTypesImport:c=r.lib([`@typebox/custom-types`],{origin:`lib`}),settings:l}={...t},u=async e=>{for(let{kind:t,entry:r}of e){if(t!==`apiRoute`)continue;let e=[r.params,...r.validationDefinitions.flatMap(e=>e.target===`response`?e.variants:[e.schema])].flatMap(({resolvedType:e})=>e?[e]:[]),i=[...new Set(r.validationDefinitions.flatMap(({target:e})=>Object.keys(a).includes(e)?[e]:[]))].map(e=>({target:e,methods:r.methods.flatMap(t=>{let n=r.validationDefinitions.find(n=>n.method===t&&n.target===e);return n?[{route:r.name,method:t,target:e,schema:n.schema,...n.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(n.runtimeValidation)},...n.customErrors===void 0?{}:{customErrors:JSON.stringify(n.customErrors)}}]:[]})})),s=r.methods.flatMap(e=>{let t=r.validationDefinitions.find(t=>t.method===e&&t.target===`response`);return t?[{method:e,variants:t.variants.map(e=>({route:r.name,target:`response`,...e,...t.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(t.runtimeValidation)},...t.customErrors===void 0?{}:{customErrors:JSON.stringify(t.customErrors)}}))}]:[]});await o(n.libApi(r.name,`schemas.ts`),xr,{route:r,resolvedTypes:e,requestSchemas:i,responseSchemas:s})}};return{async start(){for(let[e,t]of[[`custom-types.ts`,_r],[`error-handler.ts`,vr],[`index.ts`,yr],[`setup.ts`,br]])await o(n.lib(`@typebox`,e),t,{validationMessages:JSON.stringify(s),customTypesImport:c,settings:JSON.stringify({...Sr,...l})})},async watch(e,t){await u(t?e.filter(({kind:e,entry:n})=>t.kind===`update`&&e===`apiRoute`&&n.fileFullpath===t.file):e)},async build(e){await u(e)}}}),X={PROPERTY:`PROPERTY`,PROPERTIES:`PROPERTIES`,ALLOWED_VALUES:`ALLOWED_VALUES`,FOUND_N_DUPLICATES:`FOUND_N_DUPLICATES`,VALIDATION_PASSED:`VALIDATION_PASSED`,VALIDATION_FAILED_PREFIX:`VALIDATION_FAILED_PREFIX`,ERROR_SUMMARY:`ERROR_SUMMARY`,PLURAL_SUFFIX:`PLURAL_SUFFIX`,FIRST:`FIRST`,SECOND:`SECOND`,THIRD:`THIRD`,FOURTH:`FOURTH`,FIFTH:`FIFTH`,TYPE_INVALID:`TYPE_INVALID`,STRING_MIN_LENGTH:`STRING_MIN_LENGTH`,STRING_MAX_LENGTH:`STRING_MAX_LENGTH`,STRING_PATTERN:`STRING_PATTERN`,STRING_FORMAT:`STRING_FORMAT`,STRING_FORMAT_EMAIL:`STRING_FORMAT_EMAIL`,STRING_FORMAT_DATE:`STRING_FORMAT_DATE`,STRING_FORMAT_DATETIME:`STRING_FORMAT_DATETIME`,STRING_FORMAT_TIME:`STRING_FORMAT_TIME`,STRING_FORMAT_URI:`STRING_FORMAT_URI`,STRING_FORMAT_URL:`STRING_FORMAT_URL`,STRING_FORMAT_UUID:`STRING_FORMAT_UUID`,STRING_FORMAT_IPV4:`STRING_FORMAT_IPV4`,STRING_FORMAT_IPV6:`STRING_FORMAT_IPV6`,STRING_FORMAT_HOSTNAME:`STRING_FORMAT_HOSTNAME`,STRING_FORMAT_JSON_POINTER:`STRING_FORMAT_JSON_POINTER`,STRING_FORMAT_REGEX:`STRING_FORMAT_REGEX`,NUMBER_MINIMUM:`NUMBER_MINIMUM`,NUMBER_MAXIMUM:`NUMBER_MAXIMUM`,NUMBER_EXCLUSIVE_MINIMUM:`NUMBER_EXCLUSIVE_MINIMUM`,NUMBER_EXCLUSIVE_MAXIMUM:`NUMBER_EXCLUSIVE_MAXIMUM`,NUMBER_MULTIPLE_OF:`NUMBER_MULTIPLE_OF`,ARRAY_MIN_ITEMS:`ARRAY_MIN_ITEMS`,ARRAY_MAX_ITEMS:`ARRAY_MAX_ITEMS`,ARRAY_UNIQUE_ITEMS:`ARRAY_UNIQUE_ITEMS`,ARRAY_CONTAINS:`ARRAY_CONTAINS`,ARRAY_MIN_CONTAINS:`ARRAY_MIN_CONTAINS`,ARRAY_MAX_CONTAINS:`ARRAY_MAX_CONTAINS`,ARRAY_PREFIX_ITEMS:`ARRAY_PREFIX_ITEMS`,ARRAY_ITEMS:`ARRAY_ITEMS`,ARRAY_UNEVALUATED_ITEMS:`ARRAY_UNEVALUATED_ITEMS`,TUPLE_MIN_ITEMS:`TUPLE_MIN_ITEMS`,TUPLE_MAX_ITEMS:`TUPLE_MAX_ITEMS`,OBJECT_REQUIRED:`OBJECT_REQUIRED`,OBJECT_ADDITIONAL_PROPERTIES:`OBJECT_ADDITIONAL_PROPERTIES`,OBJECT_MIN_PROPERTIES:`OBJECT_MIN_PROPERTIES`,OBJECT_MAX_PROPERTIES:`OBJECT_MAX_PROPERTIES`,OBJECT_PROPERTY_NAMES:`OBJECT_PROPERTY_NAMES`,OBJECT_DEPENDENCIES:`OBJECT_DEPENDENCIES`,OBJECT_UNEVALUATED_PROPERTIES:`OBJECT_UNEVALUATED_PROPERTIES`,ENUM_MISMATCH:`ENUM_MISMATCH`,CONST_MISMATCH:`CONST_MISMATCH`,CONDITIONAL_IF:`CONDITIONAL_IF`,CONDITIONAL_THEN:`CONDITIONAL_THEN`,CONDITIONAL_ELSE:`CONDITIONAL_ELSE`,COMPOSITION_ONE_OF:`COMPOSITION_ONE_OF`,COMPOSITION_ANY_OF:`COMPOSITION_ANY_OF`,COMPOSITION_ALL_OF:`COMPOSITION_ALL_OF`,COMPOSITION_NOT:`COMPOSITION_NOT`,CONTENT_DISCRIMINATOR:`CONTENT_DISCRIMINATOR`,CONTENT_ENCODING:`CONTENT_ENCODING`,CONTENT_MEDIA_TYPE:`CONTENT_MEDIA_TYPE`,CUSTOM_RANGE:`CUSTOM_RANGE`,CUSTOM_EXCLUSIVE_RANGE:`CUSTOM_EXCLUSIVE_RANGE`,CUSTOM_REGEXP:`CUSTOM_REGEXP`,CUSTOM_DYNAMIC_DEFAULTS:`CUSTOM_DYNAMIC_DEFAULTS`,CUSTOM_SELECT:`CUSTOM_SELECT`,CUSTOM_TRANSFORM:`CUSTOM_TRANSFORM`,CUSTOM_UNIQUE_ITEM_PROPERTIES:`CUSTOM_UNIQUE_ITEM_PROPERTIES`,UNKNOWN:`UNKNOWN`};X.PROPERTY,X.PROPERTIES,X.ALLOWED_VALUES,X.FOUND_N_DUPLICATES,X.VALIDATION_PASSED,X.VALIDATION_FAILED_PREFIX,X.ERROR_SUMMARY,X.PLURAL_SUFFIX,X.FIRST,X.SECOND,X.THIRD,X.FOURTH,X.FIFTH,X.TYPE_INVALID,X.STRING_MIN_LENGTH,X.STRING_MAX_LENGTH,X.STRING_PATTERN,X.STRING_FORMAT,X.STRING_FORMAT_EMAIL,X.STRING_FORMAT_DATE,X.STRING_FORMAT_DATETIME,X.STRING_FORMAT_TIME,X.STRING_FORMAT_URI,X.STRING_FORMAT_URL,X.STRING_FORMAT_UUID,X.STRING_FORMAT_IPV4,X.STRING_FORMAT_IPV6,X.STRING_FORMAT_HOSTNAME,X.STRING_FORMAT_JSON_POINTER,X.STRING_FORMAT_REGEX,X.NUMBER_MINIMUM,X.NUMBER_MAXIMUM,X.NUMBER_EXCLUSIVE_MINIMUM,X.NUMBER_EXCLUSIVE_MAXIMUM,X.NUMBER_MULTIPLE_OF,X.ARRAY_MIN_ITEMS,X.ARRAY_MAX_ITEMS,X.ARRAY_UNIQUE_ITEMS,X.ARRAY_CONTAINS,X.ARRAY_MIN_CONTAINS,X.ARRAY_MAX_CONTAINS,X.ARRAY_PREFIX_ITEMS,X.ARRAY_ITEMS,X.ARRAY_UNEVALUATED_ITEMS,X.TUPLE_MIN_ITEMS,X.TUPLE_MAX_ITEMS,X.OBJECT_REQUIRED,X.OBJECT_ADDITIONAL_PROPERTIES,X.OBJECT_MIN_PROPERTIES,X.OBJECT_MAX_PROPERTIES,X.OBJECT_PROPERTY_NAMES,X.OBJECT_DEPENDENCIES,X.OBJECT_UNEVALUATED_PROPERTIES,X.ENUM_MISMATCH,X.CONST_MISMATCH,X.CONDITIONAL_IF,X.CONDITIONAL_THEN,X.CONDITIONAL_ELSE,X.COMPOSITION_ONE_OF,X.COMPOSITION_ANY_OF,X.COMPOSITION_ALL_OF,X.COMPOSITION_NOT,X.CONTENT_DISCRIMINATOR,X.CONTENT_ENCODING,X.CONTENT_MEDIA_TYPE,X.CUSTOM_RANGE,X.CUSTOM_EXCLUSIVE_RANGE,X.CUSTOM_REGEXP,X.CUSTOM_DYNAMIC_DEFAULTS,X.CUSTOM_SELECT,X.CUSTOM_TRANSFORM,X.CUSTOM_UNIQUE_ITEM_PROPERTIES,X.UNKNOWN;var wr=d({meta:{name:`TypeBox`,resolveTypes:!0},dependencies:{typebox:gr.devDependencies.typebox},factory:Cr}),Z={type:`module`,private:!0,name:`@kosmojs/vue-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/vue-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-vue":`^6.0.8`},devDependencies:{"@tanstack/vue-query":`^5.101.4`,"path-to-regexp":`^8.4.2`,vue:`^3.5.41`,"vue-router":`^5.2.0`}},Q=e=>{let t=e=>e.kind===`splat`?`:${e.name}(.*)?`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[t(e.parts[0])]:[e.parts.map(e=>e.type===`static`?e.value:t(e)).join(``)]).join(`/`)},Tr=()=>{let t=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,n=(r,i)=>r.flatMap(({index:r,layout:a,children:o})=>{let{name:s,pathTokens:c}={...r,...a};if(!c)return[];let l=`${s}/layout`,u=i?Q(c):e(`/`,Q(c)),d=c.at(-1);return t(d)?r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id}]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]:r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]});return n},Er=()=>{let e=[`🎉 Well done! You just created a new Vue route.`,`🚀 Success! A fresh Vue route is ready to roll.`,`🌟 Nice work! Another Vue route added to your app.`,`🧩 All set! A new Vue route has been scaffolded.`,`🔧 Scaffold complete! Your new Vue route is in place.`,`✅ Built! Your Vue route is scaffolded and ready.`,`✨ Fantastic! Your new Vue route is good to go.`,`🎯 Nailed it! A brand new Vue route just landed.`,`💫 Awesome! Another Vue route joins the party.`,`⚡ Lightning fast! A new Vue route created successfully.`];return e[Math.floor(Math.random()*e.length)]},Dr=`import type { Plugin } from "vue";
+`,Ur={exactOptionalPropertyTypes:!0},Wr=g((e,t)=>{let{createPath:n,createImport:r,createImportHelpers:i}=y(e),{renderToFile:a}=x({helpers:{...i({origin:`lib`})}}),{validationMessages:s={},customTypesImport:c=r.lib([`@typebox/custom-types`],{origin:`lib`}),settings:l}={...t},u=async e=>{for(let{kind:t,entry:r}of e){if(t!==`apiRoute`)continue;let e=[r.params,...r.validationDefinitions.flatMap(e=>e.target===`response`?e.variants:[e.schema])].flatMap(({resolvedType:e})=>e?[e]:[]),i=[...new Set(r.validationDefinitions.flatMap(({target:e})=>Object.keys(o).includes(e)?[e]:[]))].map(e=>({target:e,methods:r.methods.flatMap(t=>{let n=r.validationDefinitions.find(n=>n.method===t&&n.target===e);return n?[{route:r.name,method:t,target:e,schema:n.schema,...n.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(n.runtimeValidation)},...n.customErrors===void 0?{}:{customErrors:JSON.stringify(n.customErrors)}}]:[]})})),s=r.methods.flatMap(e=>{let t=r.validationDefinitions.find(t=>t.method===e&&t.target===`response`);return t?[{method:e,variants:t.variants.map(e=>({route:r.name,target:`response`,...e,...t.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(t.runtimeValidation)},...t.customErrors===void 0?{}:{customErrors:JSON.stringify(t.customErrors)}}))}]:[]});await a(n.libApi(r.name,`schemas.ts`),Hr,{route:r,resolvedTypes:e,requestSchemas:i,responseSchemas:s})}};return{async start(){for(let[e,t]of[[`custom-types.ts`,Rr],[`error-handler.ts`,zr],[`index.ts`,Br],[`setup.ts`,Vr]])await a(n.lib(`@typebox`,e),t,{validationMessages:JSON.stringify(s),customTypesImport:c,settings:JSON.stringify({...Ur,...l})})},async watch(e,t){await u(e.filter(p(t,[`create`,`update`])))},async build(e){await u(e)}}}),X={PROPERTY:`PROPERTY`,PROPERTIES:`PROPERTIES`,ALLOWED_VALUES:`ALLOWED_VALUES`,FOUND_N_DUPLICATES:`FOUND_N_DUPLICATES`,VALIDATION_PASSED:`VALIDATION_PASSED`,VALIDATION_FAILED_PREFIX:`VALIDATION_FAILED_PREFIX`,ERROR_SUMMARY:`ERROR_SUMMARY`,PLURAL_SUFFIX:`PLURAL_SUFFIX`,FIRST:`FIRST`,SECOND:`SECOND`,THIRD:`THIRD`,FOURTH:`FOURTH`,FIFTH:`FIFTH`,TYPE_INVALID:`TYPE_INVALID`,STRING_MIN_LENGTH:`STRING_MIN_LENGTH`,STRING_MAX_LENGTH:`STRING_MAX_LENGTH`,STRING_PATTERN:`STRING_PATTERN`,STRING_FORMAT:`STRING_FORMAT`,STRING_FORMAT_EMAIL:`STRING_FORMAT_EMAIL`,STRING_FORMAT_DATE:`STRING_FORMAT_DATE`,STRING_FORMAT_DATETIME:`STRING_FORMAT_DATETIME`,STRING_FORMAT_TIME:`STRING_FORMAT_TIME`,STRING_FORMAT_URI:`STRING_FORMAT_URI`,STRING_FORMAT_URL:`STRING_FORMAT_URL`,STRING_FORMAT_UUID:`STRING_FORMAT_UUID`,STRING_FORMAT_IPV4:`STRING_FORMAT_IPV4`,STRING_FORMAT_IPV6:`STRING_FORMAT_IPV6`,STRING_FORMAT_HOSTNAME:`STRING_FORMAT_HOSTNAME`,STRING_FORMAT_JSON_POINTER:`STRING_FORMAT_JSON_POINTER`,STRING_FORMAT_REGEX:`STRING_FORMAT_REGEX`,NUMBER_MINIMUM:`NUMBER_MINIMUM`,NUMBER_MAXIMUM:`NUMBER_MAXIMUM`,NUMBER_EXCLUSIVE_MINIMUM:`NUMBER_EXCLUSIVE_MINIMUM`,NUMBER_EXCLUSIVE_MAXIMUM:`NUMBER_EXCLUSIVE_MAXIMUM`,NUMBER_MULTIPLE_OF:`NUMBER_MULTIPLE_OF`,ARRAY_MIN_ITEMS:`ARRAY_MIN_ITEMS`,ARRAY_MAX_ITEMS:`ARRAY_MAX_ITEMS`,ARRAY_UNIQUE_ITEMS:`ARRAY_UNIQUE_ITEMS`,ARRAY_CONTAINS:`ARRAY_CONTAINS`,ARRAY_MIN_CONTAINS:`ARRAY_MIN_CONTAINS`,ARRAY_MAX_CONTAINS:`ARRAY_MAX_CONTAINS`,ARRAY_PREFIX_ITEMS:`ARRAY_PREFIX_ITEMS`,ARRAY_ITEMS:`ARRAY_ITEMS`,ARRAY_UNEVALUATED_ITEMS:`ARRAY_UNEVALUATED_ITEMS`,TUPLE_MIN_ITEMS:`TUPLE_MIN_ITEMS`,TUPLE_MAX_ITEMS:`TUPLE_MAX_ITEMS`,OBJECT_REQUIRED:`OBJECT_REQUIRED`,OBJECT_ADDITIONAL_PROPERTIES:`OBJECT_ADDITIONAL_PROPERTIES`,OBJECT_MIN_PROPERTIES:`OBJECT_MIN_PROPERTIES`,OBJECT_MAX_PROPERTIES:`OBJECT_MAX_PROPERTIES`,OBJECT_PROPERTY_NAMES:`OBJECT_PROPERTY_NAMES`,OBJECT_DEPENDENCIES:`OBJECT_DEPENDENCIES`,OBJECT_UNEVALUATED_PROPERTIES:`OBJECT_UNEVALUATED_PROPERTIES`,ENUM_MISMATCH:`ENUM_MISMATCH`,CONST_MISMATCH:`CONST_MISMATCH`,CONDITIONAL_IF:`CONDITIONAL_IF`,CONDITIONAL_THEN:`CONDITIONAL_THEN`,CONDITIONAL_ELSE:`CONDITIONAL_ELSE`,COMPOSITION_ONE_OF:`COMPOSITION_ONE_OF`,COMPOSITION_ANY_OF:`COMPOSITION_ANY_OF`,COMPOSITION_ALL_OF:`COMPOSITION_ALL_OF`,COMPOSITION_NOT:`COMPOSITION_NOT`,CONTENT_DISCRIMINATOR:`CONTENT_DISCRIMINATOR`,CONTENT_ENCODING:`CONTENT_ENCODING`,CONTENT_MEDIA_TYPE:`CONTENT_MEDIA_TYPE`,CUSTOM_RANGE:`CUSTOM_RANGE`,CUSTOM_EXCLUSIVE_RANGE:`CUSTOM_EXCLUSIVE_RANGE`,CUSTOM_REGEXP:`CUSTOM_REGEXP`,CUSTOM_DYNAMIC_DEFAULTS:`CUSTOM_DYNAMIC_DEFAULTS`,CUSTOM_SELECT:`CUSTOM_SELECT`,CUSTOM_TRANSFORM:`CUSTOM_TRANSFORM`,CUSTOM_UNIQUE_ITEM_PROPERTIES:`CUSTOM_UNIQUE_ITEM_PROPERTIES`,UNKNOWN:`UNKNOWN`};X.PROPERTY,X.PROPERTIES,X.ALLOWED_VALUES,X.FOUND_N_DUPLICATES,X.VALIDATION_PASSED,X.VALIDATION_FAILED_PREFIX,X.ERROR_SUMMARY,X.PLURAL_SUFFIX,X.FIRST,X.SECOND,X.THIRD,X.FOURTH,X.FIFTH,X.TYPE_INVALID,X.STRING_MIN_LENGTH,X.STRING_MAX_LENGTH,X.STRING_PATTERN,X.STRING_FORMAT,X.STRING_FORMAT_EMAIL,X.STRING_FORMAT_DATE,X.STRING_FORMAT_DATETIME,X.STRING_FORMAT_TIME,X.STRING_FORMAT_URI,X.STRING_FORMAT_URL,X.STRING_FORMAT_UUID,X.STRING_FORMAT_IPV4,X.STRING_FORMAT_IPV6,X.STRING_FORMAT_HOSTNAME,X.STRING_FORMAT_JSON_POINTER,X.STRING_FORMAT_REGEX,X.NUMBER_MINIMUM,X.NUMBER_MAXIMUM,X.NUMBER_EXCLUSIVE_MINIMUM,X.NUMBER_EXCLUSIVE_MAXIMUM,X.NUMBER_MULTIPLE_OF,X.ARRAY_MIN_ITEMS,X.ARRAY_MAX_ITEMS,X.ARRAY_UNIQUE_ITEMS,X.ARRAY_CONTAINS,X.ARRAY_MIN_CONTAINS,X.ARRAY_MAX_CONTAINS,X.ARRAY_PREFIX_ITEMS,X.ARRAY_ITEMS,X.ARRAY_UNEVALUATED_ITEMS,X.TUPLE_MIN_ITEMS,X.TUPLE_MAX_ITEMS,X.OBJECT_REQUIRED,X.OBJECT_ADDITIONAL_PROPERTIES,X.OBJECT_MIN_PROPERTIES,X.OBJECT_MAX_PROPERTIES,X.OBJECT_PROPERTY_NAMES,X.OBJECT_DEPENDENCIES,X.OBJECT_UNEVALUATED_PROPERTIES,X.ENUM_MISMATCH,X.CONST_MISMATCH,X.CONDITIONAL_IF,X.CONDITIONAL_THEN,X.CONDITIONAL_ELSE,X.COMPOSITION_ONE_OF,X.COMPOSITION_ANY_OF,X.COMPOSITION_ALL_OF,X.COMPOSITION_NOT,X.CONTENT_DISCRIMINATOR,X.CONTENT_ENCODING,X.CONTENT_MEDIA_TYPE,X.CUSTOM_RANGE,X.CUSTOM_EXCLUSIVE_RANGE,X.CUSTOM_REGEXP,X.CUSTOM_DYNAMIC_DEFAULTS,X.CUSTOM_SELECT,X.CUSTOM_TRANSFORM,X.CUSTOM_UNIQUE_ITEM_PROPERTIES,X.UNKNOWN;var Gr=h({meta:{name:`TypeBox`,resolveTypes:!0},dependencies:{typebox:Lr.devDependencies.typebox},factory:Wr}),Z={type:`module`,private:!0,name:`@kosmojs/vue-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/vue-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-vue":`^6.0.8`},devDependencies:{"@tanstack/vue-query":`^5.101.4`,"path-to-regexp":`^8.4.2`,vue:`^3.5.41`,"vue-router":`^5.2.0`}},Q=e=>{let t=e=>e.kind===`splat`?`:${e.name}(.*)?`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[t(e.parts[0])]:[e.parts.map(e=>e.type===`static`?e.value:t(e)).join(``)]).join(`/`)},Kr=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,n=(r,i)=>r.flatMap(({index:r,layout:a,children:o})=>{let{name:s,pathTokens:c}={...r,...a};if(!c)return[];let l=`${s}/layout`,u=i?Q(c):t(`/`,Q(c)),d=c.at(-1);return e(d)?r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id}]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]:r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]});return n},qr=()=>{let e=[`🎉 Well done! You just created a new Vue route.`,`🚀 Success! A fresh Vue route is ready to roll.`,`🌟 Nice work! Another Vue route added to your app.`,`🧩 All set! A new Vue route has been scaffolded.`,`🔧 Scaffold complete! Your new Vue route is in place.`,`✅ Built! Your Vue route is scaffolded and ready.`,`✨ Fantastic! Your new Vue route is good to go.`,`🎯 Nailed it! A brand new Vue route just landed.`,`💫 Awesome! Another Vue route joins the party.`,`⚡ Lightning fast! A new Vue route created successfully.`];return e[Math.floor(Math.random()*e.length)]},Jr=`import type { Plugin } from "vue";
 
 export { default as AppProvider } from "./provider.vue";
 
 export const appProvider: Plugin = {
   install() {},
 };
-`,Or=`import { VueQueryPlugin } from "@tanstack/vue-query";
+`,Yr=`import { VueQueryPlugin } from "@tanstack/vue-query";
 import type { Plugin } from "vue";
 
 import { getQueryClient } from "../query";
@@ -7640,10 +8291,10 @@ export const appProvider: Plugin = {
     app.use(VueQueryPlugin, { queryClient: getQueryClient() });
   },
 };
-`,kr=`<template>
+`,Xr=`<template>
   <slot />
 </template>
-`,Ar=`import type { App } from "vue";
+`,Zr=`import type { App } from "vue";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -7683,7 +8334,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,jr=`{
+`,Qr=`{
   path: "{{path}}",
   {{#if name}}
   name: "{{name}}",
@@ -7701,7 +8352,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,Mr=`import type { App } from "vue";
+`,$r=`import type { App } from "vue";
 
 import {
   renderToString as renderToStringOrig,
@@ -7797,7 +8448,7 @@ export default serverRenderFactory();
   const component: DefineComponent<{}, {}, any>;
   export default component;
 }
-`,Nr=`<script setup lang="ts">
+`,ei=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   headline?: string;
@@ -7836,7 +8487,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,Pr=`<script setup lang="ts">
+`,ti=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   message: string;
@@ -7885,7 +8536,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,Fr=`* {
+`,ni=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -8018,7 +8669,7 @@ defineProps<{
   align-items: center;
   gap: 0.25rem;
 }
-`,Ir=`<script setup lang="ts">
+`,ri=`<script setup lang="ts">
 import styles from "./styles.module.css";
 <\/script>
 
@@ -8082,7 +8733,7 @@ import styles from "./styles.module.css";
     </div>
   </div>
 </template>
-`,Lr=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,ii=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
 
 let client: QueryClient | undefined;
 
@@ -8097,7 +8748,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,Rr=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,ai=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -8120,7 +8771,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,zr=`import {
+`,oi=`import {
   type App,
   type Component,
   createApp,
@@ -8249,7 +8900,18 @@ export const createRouters = (
       // would otherwise skip the guard
       installLoaderGuard(router);
 
-      await router.push(url.pathname + url.search);
+      let { pathname } = url;
+
+      if (base !== "/") {
+        // strip the base from pushed paths
+        if (pathname === base) {
+          pathname = "/";
+        } else if (pathname.startsWith(\`\${base}/\`)) {
+          pathname = pathname.slice(base.length);
+        }
+      }
+
+      await router.push(pathname + url.search);
 
       await router.isReady();
 
@@ -8271,14 +8933,14 @@ export default createRouterFactory<
   Promise<App>,
   { server: { loaderData: Record<string, unknown> } }
 >();
-`,Br=`import { type Ref, unref } from "vue";
+`,si=`import { type Ref, unref } from "vue";
 
 export type MaybeWrapped<T> = Ref<T> | T;
 
 export function unwrap<T>(value: MaybeWrapped<T>): T {
   return unref(value);
 }
-`,Vr=`import { useRoute, useRouter } from "vue-router";
+`,ci=`import { useRoute, useRouter } from "vue-router";
 
 import type { RouterWithLoaderData } from "./router";
 
@@ -8293,7 +8955,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
   const route = useRoute();
   return router.__loaderData?.[key || (route.name as string)] as T;
 };
-`,Hr=`<script setup lang="ts">
+`,li=`<script setup lang="ts">
 import { AppProvider } from "_/app";
 <\/script>
 
@@ -8302,39 +8964,40 @@ import { AppProvider } from "_/app";
     <RouterView />
   </AppProvider>
 </template>
-`,Ur=`<script setup lang="ts" generic="T extends LinkProps">
+`,ui=`<script setup lang="ts" generic="T extends LinkProps">
 import { computed } from "vue";
 import { RouterLink } from "vue-router";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
 
-interface Props {
-  to: T
-  query?: Record<string | number, unknown>
-  replace?: boolean
-  activeClass?: string
-  exactActiveClass?: string
+type Props = {
+  to: T;
+  query?: Record<string | number, unknown>;
+  replace?: boolean;
+  activeClass?: string;
+  exactActiveClass?: string;
 }
 
 const props = defineProps<Props>();
 
 const href = computed(() => {
-  const [key, ...params] = props.to
-  return pageRouteMap[key]?.base(params as never, props.query)
+  const [key, ...params] = props.to;
+  return pageRouteMap[key]?.path(params as never, props.query, { prefix: false });
 })
+
+const linkProps = computed(() => ({
+  ...(props.replace !== undefined ? { replace: props.replace } : {}),
+  ...(props.activeClass !== undefined ? { activeClass: props.activeClass } : {}),
+  ...(props.exactActiveClass !== undefined ? { exactActiveClass: props.exactActiveClass } : {}),
+}))
 <\/script>
 
 <template>
-  <RouterLink
-    :to="href"
-    :replace="replace"
-    :active-class="activeClass"
-    :exact-active-class="exactActiveClass"
-  >
+  <RouterLink :to="href" v-bind="linkProps">
     <slot />
   </RouterLink>
 </template>
-`,Wr=`import renderFactory, {
+`,di=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -8361,7 +9024,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Gr=`import renderFactory, {
+`,fi=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -8388,7 +9051,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,Kr=`<!doctype html>
+`,pi=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -8400,17 +9063,17 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,qr=`<script setup lang="ts">
+`,mi=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/404.vue' }}";
 <\/script>
 
 <template>
   <PageSample />
 </template>
-`,Jr=`<template>
+`,hi=`<template>
   <router-view />
 </template>
-`,Yr=`<script setup lang="ts">
+`,gi=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
 <\/script>
 
@@ -8425,14 +9088,14 @@ import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
     }"
   />
 </template>
-`,Xr=`<script setup lang="ts">
+`,_i=`<script setup lang="ts">
 import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.vue' }}";
 <\/script>
 
 <template>
   <WelcomePage />
 </template>
-`,Zr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,vi=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 import { appProvider } from "{{ createImport 'lib' 'app' }}";
 
 import app from "./app.vue";
@@ -8451,5 +9114,5 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,Qr=f((e,t)=>{let{createPath:n,createImportHelpers:r}=h(e),{renderToFile:i}=_({helpers:{...r({origin:`lib`}),...b()},partials:{routePartial:jr}}),{renderToFile:a}=_({helpers:r({origin:`src`})}),o=Tr(),l=e=>!e?.trim().length,u=s(t?.templates,Yr),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?Xr:u(r.name,r),{route:r,message:Er()},{overwrite:l}):t===`pageLayout`&&await a(n.pages(r.file),Jr,{route:r},{overwrite:l})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(v),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(m(r));for(let[e,t]of[[`client.ts`,Ar],[`server.ts`,Mr]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a,lazyLoad:e===`client.ts`});await i(n.lib(`router.ts`),zr,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[fe(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,$],[`unwrap.ts`,Br],[`use.ts`,Vr],[`pageSamples/styles.module.css`,Fr],[`pageSamples/welcome.vue`,Ir],[`pageSamples/page.vue`,Pr],[`pageSamples/404.vue`,Nr],[`app/provider.vue`,kr],...t?.tanstack?.query?[[`app/index.ts`,Or],[`query.ts`,Lr]]:[[`app/index.ts`,Dr],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.vue`,qr],[`components/Link.vue`,Ur],[`app.vue`,Hr],[`router.ts`,Zr]])await a(n.src(e),t,{entryDir:c.entryDir},{overwrite:l});await a(n.src(`index.html`),Kr,{entryDir:c.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Wr],[`server.ts`,Gr]])await a(n.entry(e),t,{},{overwrite:l})},async watch(e,t){(!t||t.kind===`create`)&&await d(e),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?Rr:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),$r=d({meta:{name:`Vue`,jsxImportSource:`vue`},dependencies(e){return{vue:Z.devDependencies.vue,"vue-router":Z.devDependencies[`vue-router`],"path-to-regexp":Z.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/vue-query":Z.devDependencies[`@tanstack/vue-query`]}:{}}},factory:Qr}),ei=t=>{let i=process.env.NODE_ENV||`development`,a=typeof t.base==`string`?t.base:t.base[i];if(!a?.trim())throw Error(n([`red`],`ERROR: Invalid Config - no base provided`));return{...t,base:e(`/`,a),apiBase:e(`/`,t.apiBase||r)}};export{ei as defineConfig,P as fetchGenerator,Ee as honoGenerator,Ke as koaGenerator,xt as mdxGenerator,Et as openapiGenerator,en as reactGenerator,kn as solidGenerator,Mn as ssgGenerator,Vn as ssrGenerator,hr as svelteGenerator,wr as typeboxGenerator,$r as vueGenerator};
+`,yi=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()},partials:{routePartial:Qr}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=Kr(),s=e=>!e?.trim().length,u=c(t?.templates,gi),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?_i:u(r.name,r),{route:r,message:qr()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),hi,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(v(r));for(let[e,t]of[[`client.ts`,Zr],[`server.ts`,$r]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a,lazyLoad:e===`client.ts`});await i(n.lib(`router.ts`),oi,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[pe(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,$],[`unwrap.ts`,si],[`use.ts`,ci],[`pageSamples/styles.module.css`,ni],[`pageSamples/welcome.vue`,ri],[`pageSamples/page.vue`,ti],[`pageSamples/404.vue`,ei],[`app/provider.vue`,Xr],...t?.tanstack?.query?[[`app/index.ts`,Yr],[`query.ts`,ii]]:[[`app/index.ts`,Jr],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.vue`,mi],[`components/Link.vue`,ui],[`app.vue`,li],[`router.ts`,vi]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),pi,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,di],[`server.ts`,fi]])await a(n.entry(e),t,{},{overwrite:s})},async watch(e,t){await d(e.filter(m(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?ai:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),bi=h({meta:{name:`Vue`,jsxImportSource:`vue`},dependencies(e){return{vue:Z.devDependencies.vue,"vue-router":Z.devDependencies[`vue-router`],"path-to-regexp":Z.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/vue-query":Z.devDependencies[`@tanstack/vue-query`]}:{}}},factory:yi}),xi=e=>{let n=process.env.NODE_ENV||`development`,a=typeof e.base==`string`?e.base:e.base[n];if(!a?.trim())throw Error(r([`red`],`ERROR: Invalid Config - no base provided`));return{...e,base:t(`/`,a),apiBase:t(`/`,e.apiBase||i)}};export{e as coreGenerator,xi as defineConfig,I as fetchGenerator,ke as h3Generator,Je as honoGenerator,pt as koaGenerator,Ht as mdxGenerator,qt as openapiGenerator,Sn as reactGenerator,Xn as solidGenerator,$n as ssgGenerator,cr as ssrGenerator,Ir as svelteGenerator,Gr as typeboxGenerator,bi as vueGenerator};
 //# sourceMappingURL=index.js.map