@kosmojs/dev 0.2.10 → 0.4.0

package/pkg/index.js

@@ -1,245 +1,942 @@
-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.2.10`,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{t as e}from"./assets/pkg-DU-tTiIp.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,defineGenerator as p,defineGeneratorFactory as m,mergeConfigs as h,nestedRoutesFactory as g,pathResolver as _,pathTokensFactory as v,renderFactory as y,renderToFile as ee,sortRoutes as b,spinnerFactory as te,vitePlugins as x}from"@kosmojs/lib";import{routeRenderHelpers as S}from"@kosmojs/core/generators";import C from"crc/crc32";import ne from"@mdx-js/rollup";import{build as w,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 T from"vite-plugin-solid";import{access as ce,constants as le,cp as E,mkdir as ue,rm as D,writeFile as de}from"node:fs/promises";import{svelte as fe}from"@sveltejs/vite-plugin-svelte";import pe from"@vitejs/plugin-vue";var O=`export * from "./transport";
+`,k=`export const transport = undefined;
+`,A=`{{#each routes}}
+import {{id}} from "{{ createImport 'libApi' name 'fetch' }}";
+{{/each}}
 
-import type { ApiRouteSerialized, ValidationTarget } from "@kosmojs/core";
-import type { HTTPMethod } from "@kosmojs/core/api";
-import { createHost, type HostOpt, join, stringify } from "@kosmojs/core/fetch";
+export { ValidationError } from "@kosmojs/core/errors";
 
-export * from "./transport";
+export type ResponseT = {
+{{#each routes}}
+  "{{name}}": import("{{ createImport 'libApi' name 'fetch' }}").ResponseT;
+{{/each}}
+}
 
-export const fetchHelpers = <ParamsT extends readonly unknown[]>(
-  basePath: string,
-  route: ApiRouteSerialized,
-) => {
-  const toPath = compile(route.pathPattern);
+export default {
+{{#each routes}}  "{{name}}": {{id}},
+{{#each alias }}  "{{this}}": {{../id}},
+{{/each}}
+{{/each}}
+}
+`,j=`import fetchFactory, { join } from "@kosmojs/core/fetch";
 
-  const maybeNumber = (val: unknown) => {
-    if (val === undefined || val === null) {
-      return val;
-    }
-    const n = Number(val);
-    return Number.isFinite(n) ? n : val;
-  };
+import { base, apiBase, apiRouteMap } from "{{ createImport 'libCore' }}";
+import { transport } from "{{ createImport 'lib' '@fetch' }}";
 
-  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;
-    }, {});
-  };
+import {
+  type MaybeWrapped,
+  unwrap,
+} from "{{ createImport 'lib' 'unwrap' }}";
+
+{{#each validationTypes}}
+import type { {{id}} } from "./types";
+{{/each}}
+
+import { validationSchemas } from "./schemas";
+
+export { ValidationError } from "@kosmojs/core/errors";
+
+export { validationSchemas };
+
+export type ParamsT = [
+  {{serializeParamsTupleElements route}}
+];
+
+{{#each payloadTypes}}
+export type {{name}} = {
+  {{#each types}}{{method}}: {{id}};
+  {{/each}}
+}
+{{/each}}
+
+export type ResponseT = {
+  {{#each responseTypes}}
+  {{method}}: {{#each types}}{{#unless @first}}|{{/unless}} {{id}}{{/each}};
+  {{/each}}
+}
+
+const {
+  paramsMapper,
+  parametrize,
+  payloadResolver,
+  path,
+  href,
+} = apiRouteMap["{{route.name}}"];
+
+const fetchApi = fetchFactory(
+  join(base, apiBase),
+  { transport },
+);
 
-  const parametrize = (params: ParamsT) => {
-    try {
-      return toPath(paramsMapper(params) as never);
-    } catch (error) {
-      console.error(\`❗ERROR: Failed building path for \${route.name}\`);
-      throw error;
+{{#each routeMethods}}
+export const {{method}} = (
+  _params{{#if ../route.optionalParams}}?{{/if}}: MaybeWrapped<ParamsT>,
+  _payload?: {
+    {{#each payloadTypes}}
+    {{target}}: {{id}} extends { {{method}}: unknown }
+      ? MaybeWrapped<{{id}}["{{method}}"]>
+      : unknown,
+    {{/each}}
+  },
+  opt?: {
+    unwrap?: <T>(data: MaybeWrapped<T>) => T;
+  },
+): Promise<
+  {{#if responseType}}
+  ResponseT["{{method}}"]
+  {{else}}
+  unknown
+  {{/if}}
+> => {
+  const [params, payload] = [_params, _payload].map((data) => {
+    return typeof opt?.unwrap === "function" ? opt.unwrap(data) : unwrap(data);
+  })
+  // validate only on client, skip double validation in SSR mode
+  if (!import.meta.env.SSR) {
+    if (validationSchemas.params) {
+      validationSchemas.params.validate(
+        paramsMapper(params as never, { coerceNumbers: true }),
+      );
     }
-  };
+    {{#each payloadTypes}}
+    if (validationSchemas.{{target}}?.{{method}}) {
+      validationSchemas.{{target}}.{{method}}.validate(
+        payloadResolver(payload as never, "{{target}}", "{{../method}}"),
+      );
+    }
+    {{/each}}
+  }
+  return fetchApi.{{method}}(parametrize(params as never), payload as never);
+};
+{{/each}}
 
-  const base = (params: ParamsT, query?: Record<string, unknown>) => {
-    const path = join("/", parametrize(params));
-    return query ? [path, stringify(query)].join("?") : path;
-  };
+export default {
+  {{#each routeMethods}}
+  {{method}},
+  {{/each}}
+  path,
+  href,
+  validationSchemas,
+};
+`,M=`export type MaybeWrapped<T> = T;
+export const unwrap = <T>(data: T) => data;
+`,N=m(e=>{let{createPath:t,createImportHelpers:n}=_(e),{renderToFile:r}=y({helpers:{...n({origin:`lib`}),...S()}}),i=async(e,n)=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]).sort(b);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 "${l.libPrefix}/@ssr/fetch";`]])await r(t.lib(e),n,{})}}}),P=p({meta:{name:`Fetch`,slot:`fetch`},factory:N}),F={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`}},I=`import { H3, type Middleware } from "h3";
 
-  const path = (params: ParamsT, query?: Record<string, unknown>) => {
-    return join(basePath, base(params, query));
-  };
+import type { Route, RouteDebugOption } from "@kosmojs/core/api";
+
+export type App = H3;
 
-  const href = (
-    host: HostOpt,
-    params: ParamsT,
-    query?: Record<string, unknown>,
-  ) => {
-    return createHost(host) + path(params, query);
+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 payloadResolver = <T>(
-    payload: Record<ValidationTarget, T> | undefined,
-    target: ValidationTarget,
-    method: HTTPMethod,
-  ) => {
-    const data = payload?.[target];
+  const app = new H3(appOptions);
 
-    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 (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),
+        });
+      }
     }
+  }
 
-    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 app;
+}
+`,L=`import type { DevSetup } from "@kosmojs/core/api";
+
+export const devSetup = (setup: DevSetup) => setup;
+`,R=`import type { H3Event } from "h3";
+
+type ErrorHandler = (
+  error: any,
+  event: H3Event,
+) => Promise<Response> | Response;
+
+export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
+
+export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
+  return handler;
+};
+`,z=`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();
+  },
+};
+`,B=`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 map;
-      }, {}) as T;
-    }
+        return next();
+      },
+      { slot: "@extendContext" },
+    ) as never,
 
-    return data;
-  };
+    /**
+     * 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();
+
+        const response: {
+          status: number;
+          contentType: string | null;
+          body?: unknown;
+        } = {
+          status: event.res.status ?? -1,
+          contentType: event.res.headers.get("Content-Type"),
+        };
+
+        // Validate body only for JSON variants
+        if (variants.some((e) => e.contentType?.includes("json"))) {
+          response.body = 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: \${event.res.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,
+  },
+);
+`,me=`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}}
+];
+`,he=`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;
+};
+`,ge=`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,
+  );
+};
 
-  return {
-    paramsMapper,
-    parametrize,
-    base,
-    path,
-    href,
-    payloadResolver,
+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,
+  });
 };
-`,k=`export const transport = undefined;
-`,A=`{{#each routes}}
-import {{id}} from "{{ createImport 'libApi' name 'fetch' }}";
-{{/each}}
-
-export { ValidationError } from "@kosmojs/core/errors";
-
-export type ResponseT = {
-{{#each routes}}
-  "{{name}}": import("{{ createImport 'libApi' name 'fetch' }}").ResponseT;
-{{/each}}
-}
-
-export default {
-{{#each routes}}  "{{name}}": {{id}},
-{{#each alias }}  "{{this}}": {{../id}},
-{{/each}}
-{{/each}}
-}
-`,j=`import fetchFactory, { join, stringify } from "@kosmojs/core/fetch";
+`,_e=`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";
+`,ve=`import { onError } from "h3";
 
-import { base, apiBase, apiRouteMap } from "{{ createImport 'libCore' }}";
-import { transport, fetchHelpers } from "{{ createImport 'lib' '@fetch' }}";
+import appFactory, { routes, type App } from "{{ createImport 'lib' 'api:factory' }}";
+import defaultErrorHandler from "./errors";
 
-import {
-  type MaybeWrapped,
-  unwrap,
-} from "{{ createImport 'lib' 'unwrap' }}";
+export default appFactory(routes, ({ app }) => {
+  app.use(onError(defaultErrorHandler));
+}) as App;
+`,ye=`import { toNodeHandler } from "h3/node";
 
-{{#each validationTypes}}
-import type { {{id}} } from "./types";
-{{/each}}
+import app from "./app";
 
-import { validationSchemas } from "./schemas";
+import { devSetup } from "{{ createImport 'lib' 'api:factory' }}";
 
-export { ValidationError } from "@kosmojs/core/errors";
+export default devSetup({
+  requestHandler() {
+    return toNodeHandler(app);
+  },
+  teardownHandler() {
+    // close db connections, server sockets etc.
+  },
+});
 
-export { validationSchemas };
+process.on("unhandledRejection", (reason) => {
+  console.error("💥 UNHANDLED REJECTION");
+  console.error("Reason:", reason);
+  process.exit(1);
+});
+`,be=`export declare module "{{ createImport 'libApi' }}" {
+  interface DefaultContext {}
+}
+`,xe=`import { ValidationError } from "@kosmojs/core/errors";
+import { HTTPError } from "h3";
 
-export type ParamsT = [
-  {{serializeParamsTupleElements route}}
-];
+import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
 
-{{#each payloadTypes}}
-export type {{name}} = {
-  {{#each types}}{{method}}: {{id}};
-  {{/each}}
-}
-{{/each}}
+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" },
+      });
+});
+`,Se=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
-export type ResponseT = {
-  {{#each responseTypes}}
-  {{method}}: {{#each types}}{{#unless @first}}|{{/unless}} {{id}}{{/each}};
-  {{/each}}
-}
+export default defineRoute<"{{route.name}}">(({ GET }) => [
+  GET(async (event) => {
+    return "Automatically generated route";
+  }),
+]);
+`,Ce=`import { use } from "{{ createImport 'libApi' }}";
 
-const {
-  paramsMapper,
-  parametrize,
-  payloadResolver,
-  path,
-  href,
-} = fetchHelpers<[{{serializeParamsTupleElements route}}]>(
-  apiBase,
-  apiRouteMap["{{route.name}}"],
-);
+export type UseT = {};
 
-const fetchApi = fetchFactory(
-  join(base, apiBase),
-  { transport, stringify },
-);
+export default [
+  use<UseT>(async (event, next) => {
+    return next();
+  }),
+];
+`,we=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+import app from "./app";
 
-{{#each routeMethods}}
-export const {{method}} = (
-  _params{{#if ../route.optionalParams}}?{{/if}}: MaybeWrapped<ParamsT>,
-  _payload?: {
-    {{#each ../payloadTargets}}
-    {{#if payloadType}}
-    {{target}}: {{payloadType.name}} extends { {{../method}}: unknown }
-      ? MaybeWrapped<{{payloadType.name}}["{{../method}}"]>
-      : unknown,
-    {{else}}
-    {{target}}?: unknown;
-    {{/if}}
-    {{/each}}
-  },
-  opt?: {
-    unwrap?: <T>(data: MaybeWrapped<T>) => T;
-  },
-): Promise<
-  {{#if responseType}}
-  ResponseT["{{method}}"]
-  {{else}}
-  unknown
-  {{/if}}
-> => {
-  const [params, payload] = [_params, _payload].map((data) => {
-    return typeof opt?.unwrap === "function" ? opt.unwrap(data) : unwrap(data);
-  })
-  // validate only on client, skip double validation in SSR mode
-  if (!import.meta.env.SSR) {
-    if (validationSchemas.params) {
-      validationSchemas.params.validate(
-        paramsMapper(params as never, { coerceNumbers: true }),
-      );
-    }
-    {{#each ../payloadTypes}}
-    if (validationSchemas.{{target}}?.{{../method}}) {
-      validationSchemas.{{target}}.{{../method}}.validate(
-        payloadResolver(payload, "{{target}}", "{{../method}}"),
-      );
-    }
-    {{/each}}
-  }
-  return fetchApi.{{method}}(parametrize(params as never), payload as never);
-};
-{{/each}}
+await serve(app);
+`,Te=`import { use } from "{{ createImport 'libApi' }}";
 
-export default {
-  {{#each routeMethods}}
-  {{method}},
-  {{/each}}
-  path,
-  href,
-  validationSchemas,
-};
-`,M=`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,responseType:e.find(e=>e.target===`response`&&e.method===t)})),o=Object.entries(e.reduce((e,{id:t,target:n,method:r,resolvedType:i})=>{if([`headers`,`cookies`,`response`].includes(n))return e;let a=`${n.replace(/^./,e=>e.toUpperCase())}T`;return e[a]||(e[a]=[]),e[a].push({id:t,target:n,method:r,resolvedType:i}),e},{})).map(([e,t])=>({name:e,types:t,target:t[0].target})),s=Object.keys(a).map(e=>({target:e,payloadType:o.find(t=>t.target===e)})),c=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,payloadTypes:o,payloadTargets:s,responseTypes:c})}};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.2.10`,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";
+/**
+ * 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();
+  }),
+];
+`,Ee=m((e,n)=>{let{createPath:r,createImportHelpers:i}=_(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=y({helpers:{...i({origin:`lib`}),...S(),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}=y({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,d=c(n?.templates,Se),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),Ce,{},{overwrite:l})},p=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=v(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${C(e)}`,alias:u(n),pathTokens:n}]:[]})]}).sort(b);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`,ge],[`api:factory.ts`,_e],[`@api/app.ts`,I],[`@api/parsers.ts`,z],[`@api/dev.ts`,L],[`@api/errors.ts`,R],[`@api/router.ts`,B],[`@api/server.ts`,he]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,ve],[`dev.ts`,ye],[`errors.ts`,xe],[`server.ts`,we],[`use.ts`,Te],[`env.d.ts`,be]])await s(r.api(e),t,{},{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)}}}),De=p({meta:{name:`H3`,slot:`backend`},dependencies:{h3:F.devDependencies.h3},factory:Ee}),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`}},Oe=`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 +947,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;
+}
+`,ke=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,R=`import type { Context } from "hono";
+`,Ae=`import type { Context } from "hono";
 
 import type { AppEnv } from "./app";
 
@@ -275,10 +1019,14 @@ export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,z=`import type { Context } from "hono";
+`,je=`import type { Context } from "hono";
 
-import type { RequestBodyTarget, RequestMetadataTarget } from "@kosmojs/core";
-import { parseCookies, parseQuerystring } from "@kosmojs/core/api";
+import {
+  parseCookies,
+  parseSearchParams,
+  type RequestBodyTarget,
+  type RequestMetadataTarget,
+} from "@kosmojs/core";
 
 export type BodyparserOptions = {
   json: never;
@@ -290,7 +1038,7 @@ export const metaparsers: {
   [T in RequestMetadataTarget]: (ctx: Context) => unknown;
 } = {
   query(ctx) {
-    return parseQuerystring(ctx.req.url);
+    return parseSearchParams(ctx.req.url);
   },
 
   headers(ctx) {
@@ -320,12 +1068,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";
+`,Me=`import type { MiddlewareHandler } from "hono";
 
 import type {
   RequestBodyTarget,
@@ -337,7 +1080,6 @@ import {
   type CreateRouteMiddleware,
   createRoutes,
   type HTTPMethod,
-  type RouterFactory,
   StateKey,
 } from "@kosmojs/core/api";
 import { ValidationError } from "@kosmojs/core/errors";
@@ -353,7 +1095,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:
@@ -370,33 +1111,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:
@@ -437,15 +1152,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),
                   );
@@ -498,23 +1207,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();
@@ -742,32 +1435,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";
+`,Ne=`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}}": {
@@ -781,14 +1463,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,
@@ -796,52 +1480,48 @@ export const routeSources: Array<RouteSource<never>> = [
   },
   {{/each}}
 ];
-`,pe=`import { chmod, unlink } from "node:fs/promises";
+`,Pe=`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.
@@ -853,50 +1533,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;
+};
+`,Fe=`import type { Context, Next } from "hono";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
 import {
@@ -1079,29 +1748,20 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,he=`export * from "./@api/app";
+`,Ie=`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 });
+`,Le=`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";
+})
+`,Re=`import { getRequestListener } from "@hono/node-server";
 
 import app from "./app";
 
@@ -1115,45 +1775,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);
+});
+
+`,ze=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultVariables {}
   interface DefaultBindings {}
 }
-`,ye=`import { accepts } from "hono/accepts";
+`,Be=`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);
+});
+`,Ve=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (ctx) => {
@@ -1162,7 +1827,7 @@ export default defineRoute<"{{route.name}}">(({ GET }) => [
     return ctx.text("Automatically generated route");
   }),
 ]);
-`,xe=`import { use } from "{{ createImport 'libApi' }}";
+`,He=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -1173,20 +1838,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' }}";
+`,Ue=`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);
+`,We=`import { use } from "{{ createImport 'libApi' }}";
 
 /**
  * Define global middleware applied to all routes.
@@ -1197,9 +1853,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.2.10`,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";
+`,Ge=m((e,n)=>{let{createPath:r,createImportHelpers:i}=_(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=y({helpers:{...i({origin:`lib`}),...S(),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}=y({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,Ve),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),He,{},{overwrite:l})},p=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=v(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${C(e)}`,alias:d(n),pathTokens:n}]:[]})]}).sort(b);for(let[e,t]of[[`@api/routes.ts`,Ne]])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`,Fe],[`api:factory.ts`,Ie],[`@api/app.ts`,Oe],[`@api/parsers.ts`,je],[`@api/dev.ts`,ke],[`@api/errors.ts`,Ae],[`@api/router.ts`,Me],[`@api/server.ts`,Pe]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,Le],[`dev.ts`,Re],[`errors.ts`,Be],[`server.ts`,Ue],[`use.ts`,We],[`env.d.ts`,ze]])await s(r.api(e),t,{},{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=p({meta:{name:`Hono`,slot:`backend`},dependencies:{hono:V.devDependencies.hono,"@hono/node-server":V.devDependencies[`@hono/node-server`]},factory:Ge}),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`}},qe=`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";
 
@@ -1207,34 +1864,86 @@ 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;
+}
+`,Je=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,ke=`import type { ParameterizedMiddleware } from "../api";
+`,Ye=`import type {
+  DefaultContext,
+  DefaultState,
+  ParameterizedContext,
+} from "../api";
+
+type ErrorHandler = (
+  error: any,
+  ctx: ParameterizedContext<unknown, DefaultState, DefaultContext>,
+) => Promise<void> | void;
 
-export type ErrorHandlerFactory = (
-  h: ParameterizedMiddleware,
-) => ParameterizedMiddleware;
+export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,Ae=`import zlib from "node:zlib";
+`,Xe=`import zlib from "node:zlib";
 
 import type { RouterContext } from "@koa/router";
 import Formidable, { type Options as FormidableOptions } from "formidable";
 import rawParser from "raw-body";
 
-import type { RequestBodyTarget, RequestMetadataTarget } from "@kosmojs/core";
-import { parseCookies, parseQuerystring } from "@kosmojs/core/api";
+import {
+  parseCookies,
+  parseSearchParams,
+  type RequestBodyTarget,
+  type RequestMetadataTarget,
+} from "@kosmojs/core";
 
 import type {
   DefaultContext,
@@ -1246,7 +1955,7 @@ export const metaparsers: {
   [T in RequestMetadataTarget]: (ctx: RouterContext) => unknown;
 } = {
   query(ctx) {
-    return parseQuerystring(ctx.req.url ?? "");
+    return parseSearchParams(ctx.req.url ?? "");
   },
 
   headers(ctx) {
@@ -1436,8 +2145,7 @@ export const bodyparsers: {
     return rawParser(stream, rawParserOptions);
   },
 };
-`,je=`import KoaRouter, { type RouterMiddleware } from "@koa/router";
-import { match } from "path-to-regexp";
+`,Ze=`import type { RouterMiddleware } from "@koa/router";
 
 import type {
   RequestBodyTarget,
@@ -1449,7 +2157,6 @@ import {
   type CreateRouteMiddleware,
   createRoutes,
   type HTTPMethod,
-  type RouterFactory,
   StateKey,
 } from "@kosmojs/core/api";
 import { ValidationError } from "@kosmojs/core/errors";
@@ -1465,10 +2172,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:
@@ -1485,33 +2188,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:
@@ -1552,16 +2229,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),
                   );
                 }
@@ -1613,23 +2281,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();
@@ -1858,32 +2510,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";
+`,Qe=`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}}": {
@@ -1897,65 +2538,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";
+];
+`,$e=`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.
@@ -1967,30 +2606,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;
+};
+`,et=`import type { RouterContext } from "@koa/router";
 import type { Next } from "koa";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
@@ -2152,25 +2780,25 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,Fe=`export * from "./@api/app";
+`,tt=`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";
+`,nt=`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";
+`,rt=`import app from "./app";
 
 import { devSetup } from "{{ createImport 'lib' 'api:factory' }}";
 
@@ -2182,45 +2810,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);
+});
+`,it=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultState {}
   interface DefaultContext {}
 }
-`,ze=`import { HTTPError, ValidationError } from "@kosmojs/core/errors";
+`,at=`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;
+  }
+});
+`,ot=`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' }}";
+`,st=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -2231,46 +2859,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";
+`,ct=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+import app from "./app";
 
-import { use } from "{{ createImport 'libApi' }}";
+await serve(app);
+`,lt=`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.2.10`,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,`
+`,ut=m((e,n)=>{let{createPath:r,createImportHelpers:i}=_(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=y({helpers:{...i({origin:`lib`}),...S(),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}=y({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,ot),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),st,{},{overwrite:l})},p=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=v(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${C(e)}`,alias:f(n),pathTokens:n}]:[]})]}).sort(b);for(let[e,t]of[[`@api/routes.ts`,Qe]])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`,et],[`api:factory.ts`,tt],[`@api/app.ts`,qe],[`@api/dev.ts`,Je],[`@api/errors.ts`,Ye],[`@api/parsers.ts`,Xe],[`@api/router.ts`,Ze],[`@api/server.ts`,$e]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,nt],[`dev.ts`,rt],[`errors.ts`,at],[`server.ts`,ct],[`use.ts`,lt],[`env.d.ts`,it]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){(!t||t.kind===`create`)&&await d(e),await p(e)},async build(e){await d(e),await p(e)}}}),dt=p({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:ut}),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`}},ft=()=>{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)]},pt=(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},mt=`import type { FunctionComponent } from "preact";
 
 export const AppProvider: FunctionComponent = (props) => {
   return props.children;
 };
-`,Xe=`import { render, hydrate as hydrateOrig } from "preact";
+`,ht=`import { render, hydrate as hydrateOrig } from "preact";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -2311,7 +2925,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Ze=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
+`,gt=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
 
 import type {
   RenderToStringWrapper,
@@ -2385,7 +2999,7 @@ export const renderToString: RenderToStringWrapper<
 }
 
 export default serverRenderFactory<false>();
-`,Qe=`declare module "*.mdx" {
+`,_t=`declare module "*.mdx" {
   import type { ComponentType } from "preact";
   export const frontmatter: Record<string, unknown>;
   const component: ComponentType;
@@ -2398,10 +3012,12 @@ declare module "*.md" {
   const component: ComponentType;
   export default component;
 }
-`,$e=`import { MDXProvider } from "@mdx-js/preact";
+`,vt=`import { MDXProvider } from "@mdx-js/preact";
 import { match, pathToRegexp } from "path-to-regexp";
 import { type ComponentType, createContext, h, type VNode } from "preact";
 
+import { parseSearchParams } from "@kosmojs/core";
+
 import { paramNames } from "{{ createImport 'lib' 'params' }}";
 import { base } from "{{ createImport 'libCore' }}";
 
@@ -2415,7 +3031,7 @@ export type RawRoute = {
 };
 
 type Loader = (
-  route: Pick<Route, "name" | "params" | "paramsEntries">,
+  route: Pick<Route, "name" | "params" | "paramsEntries" | "searchParams">,
 ) => Promise<unknown> | undefined;
 
 type LayoutModule = {
@@ -2435,6 +3051,7 @@ export type Route = {
   name: string;
   params: Record<string, string | Array<string>>;
   paramsEntries: [keys: Array<string>, values: Array<unknown>];
+  searchParams: Record<string, unknown>;
   frontmatter: Record<string, unknown>;
   loaderData: Record<string, unknown>;
 };
@@ -2443,6 +3060,7 @@ export const RouterContext = createContext<Route>({
   name: "",
   params: {},
   paramsEntries: [[], []],
+  searchParams: {},
   frontmatter: {},
   loaderData: {},
 });
@@ -2472,6 +3090,7 @@ export const createRouter = (
 
   return {
     async resolve(url: URL = new URL(window.location.href)) {
+      const searchParams = parseSearchParams(url);
       const urlSegments = url.pathname.split("/").filter(Boolean).length;
 
       // 1: use lightweight \`RegExp.test()\` on linear scan - no capture allocation
@@ -2516,7 +3135,7 @@ export const createRouter = (
 
       loaderData[name] = await runLoader(name, () => {
         return routeModule.loader
-          ? routeModule.loader({ name, params, paramsEntries })
+          ? routeModule.loader({ name, params, paramsEntries, searchParams })
           : undefined; // should not survive serialization if no loader defined
       });
 
@@ -2531,7 +3150,7 @@ export const createRouter = (
         const key = \`\${name}/layout\`;
         loaderData[key] = await runLoader(key, () => {
           return layoutModule.loader
-            ? layoutModule.loader({ name, params, paramsEntries })
+            ? layoutModule.loader({ name, params, paramsEntries, searchParams })
             : undefined; // should not survive serialization if no loader defined
         });
       }
@@ -2540,6 +3159,7 @@ export const createRouter = (
         name,
         params,
         paramsEntries,
+        searchParams,
         frontmatter,
         loaderData,
       };
@@ -2588,7 +3208,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,et=`/* @jsxImportSource preact */
+`,yt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2629,7 +3249,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,tt=`/* @jsxImportSource preact */
+`,bt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2681,7 +3301,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,nt=`* {
+`,xt=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -2816,7 +3436,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,rt=`/* @jsxImportSource preact */
+`,St=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -2882,7 +3502,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,it=`export type ParamsMap = {
+`,Ct=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -2891,7 +3511,7 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,at=`import type { ComponentType } from "preact";
+`,wt=`import type { ComponentType } from "preact";
 
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
@@ -2935,7 +3555,7 @@ export default createRouterFactory<
   Promise<RouteComponent>,
   { server: { route: Route } }
 >();
-`,ot=`import { join } from "node:path";
+`,Tt=`import { join } from "node:path";
 
 import { compile } from "path-to-regexp";
 
@@ -2981,7 +3601,7 @@ export default Object.entries(routes)
     return [];
   })
   .map((path) => join(base, path));
-`,st=`import type { PageRoute } from "@kosmojs/core";
+`,Et=`import type { PageRoute } from "@kosmojs/core";
 
 {{#each pageRoutes}}
 import * as {{id}} from "{{ createImport 'pages' file }}";
@@ -3005,18 +3625,18 @@ const routeMap: Record<
 }
 
 export default routeMap;
-`,ct=`import { useContext } from "preact/hooks";
+`,Dt=`import { useContext } from "preact/hooks";
 
 import { RouterContext } from "./mdx";
 
 import type { ParamsMap, paramNames } from "{{ createImport 'lib' 'params' }}";
 
 export function useRoute() {
-  return useContext(RouterContext);
+  return structuredClone(useContext(RouterContext));
 }
 
 export function useParams<T extends keyof ParamsMap>(): ParamsMap[T] {
-  return useContext(RouterContext).params as ParamsMap[T];
+  return useRoute().params as ParamsMap[T];
 }
 
 type SameLengthTuple<T extends readonly unknown[], U> = { [K in keyof T]: U };
@@ -3025,7 +3645,11 @@ export function useParamsEntries<T extends keyof ParamsMap>(): [
   (typeof paramNames)[T],
   SameLengthTuple<(typeof paramNames)[T], unknown>,
 ] {
-  return useContext(RouterContext).paramsEntries as never;
+  return useRoute().paramsEntries as never;
+}
+
+export function useSearchParams() {
+  return useRoute().searchParams;
 }
 
 /**
@@ -3035,7 +3659,7 @@ export function useParamsEntries<T extends keyof ParamsMap>(): [
  * a hook can't tell which layout it runs in.
  * */
 export const useLoaderData = <T>(key?: string): T | undefined => {
-  const route = useContext(RouterContext);
+  const route = useRoute();
   return route.loaderData?.[key || route.name] as T;
 };
 
@@ -3045,12 +3669,12 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 export const useFrontmatter = <
   T extends Record<string, unknown> = Record<string, unknown>,
 >(): T => {
-  return useContext(RouterContext).frontmatter as T;
+  return useRoute().frontmatter as T;
 };
-`,lt=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
+`,Ot=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 <AppProvider>{props.children}</AppProvider>
-`,ut=`import { h, type JSX } from "preact";
+`,kt=`import { h, type JSX } from "preact";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
 
@@ -3067,7 +3691,7 @@ export default function Link(
 
   return h("a", { ...restProps, href }, children);
 }
-`,dt=`/**
+`,At=`/**
  * MDX component overrides.
  *
  * Every standard markdown element (headings, links, code blocks, etc.)
@@ -3090,7 +3714,7 @@ export const components = {
 declare global {
   type MDXProvidedComponents = typeof components;
 }
-`,ft=`import renderFactory, {
+`,jt=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -3117,7 +3741,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,pt=`import renderFactory, {
+`,Mt=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on MDX folders
@@ -3138,7 +3762,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,mt=`<!doctype html>
+`,Nt=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -3150,13 +3774,13 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,ht=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,Pt=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,gt=`{props.children}
-`,_t=`---
+`,Ft=`{props.children}
+`,It=`---
 title: "{{title}}"
 ---
 
@@ -3173,7 +3797,7 @@ export const pathMap = {
   routeName="{{route.name}}"
   pathMap={pathMap}
 />
-`,vt=`---
+`,Lt=`---
 title: Welcome to KosmoJS
 description: Content-first development with MDX and Vite
 ---
@@ -3181,7 +3805,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' }}";
+`,Rt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.mdx";
 import { components } from "./components/mdx"
@@ -3197,12 +3821,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{components:t,paths:n}=e.sort(v).flatMap(t=>e.some(e=>e.name!==t.name&&e.name.startsWith(t.name))?[]:[t]).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:n,components:t}}}},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.2.10`,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";
+`,zt=m((e,t)=>{let{createPath:n,createImportHelpers:r}=_(e),{renderToFile:i}=y({helpers:{...r({origin:`lib`}),...S(),serializeParams(e){return JSON.stringify(e.params)}}}),{renderToFile:a}=y({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,It),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?Lt:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:ft()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),Ft,{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(b)}]}return[]}).sort(b);for(let[e,a]of[[`client.ts`,ht],[`server.ts`,gt]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Ct],[`router.ts`,wt],[`ssg:routes.ts`,Et]])await i(n.lib(e),t,{pageRoutes:r})};return{config({command:n}){return{oxc:{jsx:{importSource:`preact`}},plugins:pt(e,n,t)}},async start(){for(let[e,t]of[[`env.d.ts`,_t],[`app.ts`,mt],[`mdx.ts`,vt],[`use.ts`,Dt],[`ssg.ts`,Tt],[`pageSamples/styles.module.css`,xt],[`pageSamples/welcome.tsx`,St],[`pageSamples/page.tsx`,bt],[`pageSamples/404.tsx`,yt]])await i(n.lib(e),t,{});for(let[e,t]of[[`pages/404.mdx`,Pt],[`components/Link.tsx`,kt],[`components/mdx.ts`,At],[`app.mdx`,Ot],[`router.ts`,Rt]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),Nt,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,jt],[`server.ts`,Mt]])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)}}}),Bt=p({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:zt}),Vt={json:`application/json`,form:[`application/x-www-form-urlencoded`,`multipart/form-data`],raw:void 0},Ht=()=>{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,`_`)}${C(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]=Ut(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=Vt[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(b).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}}}},Ut=(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]},Wt=m((e,t)=>{let{outfile:n=``,...r}={...t},{createPath:i}=_(e),{generateOpenAPISchema:a}=Ht(),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)}}}),Gt=p({meta:{name:`OpenAPI`,resolveTypes:!0},factory:Wt}),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`}},Kt=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(`/`)},qt=()=>{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=Kt(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},Jt=()=>{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)]},Yt=`import type { ReactNode } from "react";
 
 export const AppProvider = ({ children }: { children: ReactNode }) => {
   return children;
 }
-`,jt=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
+`,Xt=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import type { ReactNode } from "react";
 
 import { getQueryClient } from "./query";
@@ -3221,7 +3845,7 @@ export const AppProvider = ({
     </QueryClientProvider>
   );
 }
-`,Mt=`import { lazy, type JSX } from "react";
+`,Zt=`import { lazy, type JSX } from "react";
 
 import {
   createRoot,
@@ -3275,7 +3899,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Nt=`{
+`,Qt=`{
   {{#if name}}
   id: "{{name}}",
   {{/if}}
@@ -3293,7 +3917,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,Pt=`import type { JSX } from "react";
+`,$t=`import type { JSX } from "react";
 
 import {
   renderToString as renderToStringOrig,
@@ -3359,7 +3983,7 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory();
-`,Ft=`/* @jsxImportSource react */
+`,en=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3400,7 +4024,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,It=`/* @jsxImportSource react */
+`,tn=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3452,7 +4076,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,Lt=`* {
+`,nn=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -3587,7 +4211,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,Rt=`/* @jsxImportSource react */
+`,rn=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -3653,7 +4277,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,zt=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,an=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
 
 let client: QueryClient | undefined;
 
@@ -3668,7 +4292,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,Bt=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,on=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -3691,40 +4315,27 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,Vt=`export type ComponentLoader = () => Promise<{
+`,sn=`export type ComponentLoader = () => Promise<{
   loader?: (arg: unknown) => Promise<unknown>;
 }>;
 
 export const loaderFactory = (opt?: { withPreload?: boolean }) => {
   return (componentLoader: ComponentLoader) => {
     const loader = async (arg: unknown) => {
-      try {
-        const component = await componentLoader();
-        // Return null, not undefined, when a route has no loader. RR keys
-        // hydration data by route id; an undefined value is dropped by
-        // JSON.stringify during serialization, leaving the id absent, which
-        // makes RR re-run the loader on the client and double-render. null
-        // survives serialization, so the id stays present and RR skips it.
-        return typeof component.loader === "function"
-          ? await component.loader(arg)
-          : null;
-      } catch (error) {
-        // TODO: swallowing loader errors is wrong. Returning null hydrates the
-        // route as "loaded, value null" - RR never sees the failure, so no
-        // errorElement/ErrorBoundary fires on server or client, and this
-        // console.error runs server-side during SSR so the client sees nothing.
-        // Proper fix: let the error reach RR's \`context.errors\` (rethrow, or
-        // return a Response/data() with an error status) so it serializes into
-        // __staticRouterHydrationData.errors and renders the route boundary
-        // isomorphically.
-        console.error(error);
-        return null;
-      }
+      const component = await componentLoader();
+      // Return null, not undefined, when a route has no loader.
+      // React Router keys hydration data by route id;
+      // an undefined value is dropped by JSON.stringify during serialization,
+      // leaving the id absent, which makes RR re-run the loader on the client and double-render.
+      // null survives serialization, so the id stays present.
+      return typeof component.loader === "function"
+        ? await component.loader(arg)
+        : null;
     };
     return opt?.withPreload ? { loader } : {};
   };
 };
-`,Ht=`import type { JSX, ComponentType } from "react";
+`,cn=`import type { JSX, ComponentType } from "react";
 
 import {
   type RouteObject,
@@ -3782,7 +4393,7 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteObject, Promise<JSX.Element>>();
-`,Ut=`import { Outlet } from "react-router";
+`,ln=`import { Outlet } from "react-router";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 export default function App() {
@@ -3792,7 +4403,7 @@ export default function App() {
     </AppProvider>
   );
 }
-`,Wt=`import {
+`,un=`import {
   type LinkProps as RouterLinkProps,
   Link as RouterLink,
 } from "react-router";
@@ -3820,7 +4431,7 @@ export default function Link(
     </RouterLink>
   );
 }
-`,Gt=`import renderFactory, {
+`,dn=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -3847,7 +4458,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Kt=`import renderFactory, {
+`,fn=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -3874,7 +4485,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,qt=`<!doctype html>
+`,pn=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -3886,17 +4497,17 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,Jt=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,mn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,Yt=`import { Outlet } from "react-router";
+`,hn=`import { Outlet } from "react-router";
 
 export default function Layout() {
   return <Outlet />;
 }
-`,Xt=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
+`,gn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -3909,8 +4520,8 @@ export default function Page() {
     },
   });
 }
-`,Zt=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,Qt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,_n=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,vn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -3925,12 +4536,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.2.10`,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";
+`,yn=m((e,t)=>{let{createPath:n,createImportHelpers:r}=_(e),{renderToFile:i}=y({helpers:{...r({origin:`lib`}),...S()},partials:{routePartial:Qt}}),{renderToFile:a}=y({helpers:r({origin:`src`})}),o=qt(),s=e=>!e?.trim().length,u=c(t?.templates,gn),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?_n:u(r.name,r),{route:r,message:Jt()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),hn,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(b),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(g(r));for(let[e,t]of[[`client.ts`,Zt],[`server.ts`,$t]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a});await i(n.lib(`router.tsx`),cn,{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`,sn],[`pageSamples/styles.module.css`,nn],[`pageSamples/welcome.tsx`,rn],[`pageSamples/page.tsx`,tn],[`pageSamples/404.tsx`,en],...t?.tanstack?.query?[[`app.tsx`,Xt],[`query.ts`,an]]:[[`app.tsx`,Yt],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.tsx`,mn],[`components/Link.tsx`,un],[`app.tsx`,ln],[`router.ts`,vn]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),pn,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,dn],[`server.ts`,fn]])await a(n.entry(e),t,{},{overwrite:s})},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?on:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),bn=p({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:yn}),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`}},xn=()=>{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(`/`)},Sn=()=>{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)]},Cn=`import type { ParentComponent } from "solid-js";
 
 export const AppProvider: ParentComponent = (props) => {
   return props.children;
 };
-`,an=`import type { ParentComponent } from "solid-js";
+`,wn=`import type { ParentComponent } from "solid-js";
 import { type QueryClient, QueryClientProvider } from "@tanstack/solid-query";
 
 import { getQueryClient } from "./query";
@@ -3942,7 +4553,7 @@ export const AppProvider: ParentComponent<{ client?: QueryClient }> = (props) =>
     </QueryClientProvider>
   );
 };
-`,on=`import { lazy, type JSX } from "solid-js";
+`,Tn=`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";
@@ -3987,7 +4598,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,sn=`{
+`,En=`{
   path: "{{path}}",
   {{#if component}}
   component: {{component}}_component,
@@ -3997,7 +4608,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,cn=`import type { JSX } from "solid-js";
+`,Dn=`import type { JSX } from "solid-js";
 
 import {
   generateHydrationScript,
@@ -4065,7 +4676,12 @@ export const renderToStream: RenderToStreamWrapper<
 > = async (resolver, { headerTags = [], ...options } = {}) => {
   const stream = renderToStreamOrig(() => resolver().component, options);
   const { readable, writable } = new TransformStream<string, string>();
-  stream.pipeTo(writable);
+  /**
+   * On failure, pipeTo aborts the writable, which errors the readable side
+   * and surfaces the error to the stream consumer; catching here only keeps
+   * the rejection from escaping as an unhandled one.
+   * */
+  stream.pipeTo(writable).catch(() => {});
   return {
     head: [...headerTags, generateHydrationScript()].join("\\n"),
     html: readable,
@@ -4073,7 +4689,7 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory<true>();
-`,ln=`/* @jsxImportSource solid-js */
+`,On=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4114,7 +4730,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,un=`/* @jsxImportSource solid-js */
+`,kn=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4166,7 +4782,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,dn=`* {
+`,An=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -4301,7 +4917,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,fn=`/* @jsxImportSource solid-js */
+`,jn=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4367,7 +4983,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,pn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,Mn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
 
 let client: QueryClient | undefined;
 
@@ -4382,7 +4998,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,mn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,Nn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -4405,7 +5021,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,hn=`import type { JSX, ParentComponent } from "solid-js";
+`,Pn=`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";
@@ -4430,7 +5046,7 @@ export const createRouters = (
 
   const serverRouter = (url: URL) => {
     const component = (
-      <Router root={app} base={base} url={url.pathname}>
+      <Router root={app} base={base} url={url.pathname + url.search}>
         {routes}
       </Router>
     );
@@ -4441,30 +5057,25 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteDefinition, JSX.Element>();
-`,gn=`export type ComponentLoader = () => Promise<{
+`,Fn=`export type ComponentLoader = () => Promise<{
   preload?: () => Promise<unknown>;
 }>;
 
 export const loaderFactory = (opt?: { withPreload?: boolean }) => {
   return (componentLoader: ComponentLoader) => {
     const preload = async () => {
-      try {
-        const component = await componentLoader();
-        return typeof component.preload === "function"
-          ? component.preload
-          : undefined;
-      } catch (error) {
-        console.error(error);
-        return;
-      }
+      const component = await componentLoader();
+      return typeof component.preload === "function"
+        ? component.preload
+        : undefined;
     };
     return opt?.withPreload ? { preload } : {};
   };
 };
-`,_n=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
+`,In=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
 
 export { unwrap } from "solid-js/store";
-`,vn=`import type { ParentComponent } from "solid-js";
+`,Ln=`import type { ParentComponent } from "solid-js";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 const App: ParentComponent = (props) => {
@@ -4472,7 +5083,7 @@ const App: ParentComponent = (props) => {
 };
 
 export default App;
-`,yn=`import { A, type AnchorProps } from "@solidjs/router";
+`,Rn=`import { A, type AnchorProps } from "@solidjs/router";
 import { type JSXElement, splitProps } from "solid-js";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
@@ -4497,7 +5108,7 @@ export default function Link(
 
   return <A {...{ ...restProps, href: href() }}>{knownProps.children}</A>;
 }
-`,bn=`import renderFactory, {
+`,zn=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -4524,7 +5135,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,xn=`import renderFactory, {
+`,Bn=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -4551,7 +5162,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,Sn=`<!doctype html>
+`,Vn=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -4563,19 +5174,19 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,Cn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,Hn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,wn=`import type { ParentComponent } from "solid-js";
+`,Un=`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' }}";
+`,Wn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -4588,8 +5199,8 @@ export default function Page() {
     },
   });
 }
-`,En=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,Dn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Gn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,Kn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -4604,16 +5215,19 @@ 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.2.10`,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}}
+`,qn=m((e,t)=>{let{generators:n=[]}=e.config,{createPath:r,createImportHelpers:i}=_(e),{renderToFile:a}=y({helpers:{...i({origin:`lib`}),...S()},partials:{routePartial:En}}),{renderToFile:o}=y({helpers:i({origin:`src`})}),s=xn(),u=e=>!e?.trim().length,d=c(t?.templates,Wn),f=async e=>{for(let{kind:t,entry:n}of e)t===`pageRoute`?await o(r.pages(n.file),n.name===`index`?Gn:d(n.name,n),{route:n,message:Sn()},{overwrite:u}):t===`pageLayout`&&await o(r.pages(n.file),Un,{route:n},{overwrite:u})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(b),n=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=s(g(n));for(let[e,t]of[[`client.ts`,Tn],[`server.ts`,Dn]])await a(r.libEntry(e),t,{pageEntries:n,nestedRoutes:i});await a(r.lib(`router.tsx`),Pn,{entries:e,indexRoutes:t})};return{config({command:e}){let{templates:r,...i}={...t};return{oxc:{jsx:{importSource:`solid-js`}},plugins:e===`build`?[T({...i,...n.some(e=>e.meta.slot===`ssr`)?{ssr:!0,solid:{...i?.solid,hydratable:!0}}:{}})]:[T({...i,dev:!0,hot:!0})]}},async start(){for(let[e,n]of[[`env.d.ts`,``],[`solid.ts`,Fn],[`unwrap.ts`,In],[`pageSamples/styles.module.css`,An],[`pageSamples/welcome.tsx`,jn],[`pageSamples/page.tsx`,kn],[`pageSamples/404.tsx`,On],...t?.tanstack?.query?[[`app.tsx`,wn],[`query.ts`,Mn]]:[[`app.tsx`,Cn],[`query.ts`,`/** tanstack query disabled */`]]])await a(r.lib(e),n,{});for(let[e,t]of[[`pages/404.tsx`,Hn],[`components/Link.tsx`,Rn],[`app.tsx`,Ln],[`router.ts`,Kn]])await o(r.src(e),t,{entryDir:l.entryDir},{overwrite:u});await o(r.src(`index.html`),Vn,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,zn],[`server.ts`,Bn]])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?Nn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Jn=p({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:qn}),Yn=m(e=>{let{generators:i=[],refineTypeName:a,...o}={...e.config},{createPath:s}=_(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 E(n(a,`../client/assets`),t(a,`assets`),{recursive:!0}),l.append(`bundling routes...`),await w(h(o,...i.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:s.lib(),appType:`custom`,plugins:[x.tsconfigPaths(e),x.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 Xn(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 D(`${a}/routes.js`)}}}}),Xn=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}},Zn=p({meta:{name:`SSG`,slot:`ssg`},factory:Yn}),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`}},Qn=`{{#if apiGenerator}}
 export { default as apiApp } from "{{ createImport 'api' 'app' }}";
 {{else}}
 export const apiApp = undefined;
 {{/if}}
-`,Pn=`import { AsyncLocalStorage } from "node:async_hooks";
+`,$n=`import { AsyncLocalStorage } from "node:async_hooks";
+
+import type { FetchApp, NodeApp } from "@kosmojs/core";
 
 export type RequestContext = {
   headers?: HeadersInit;
   tsqClient?: unknown;
+  error?: unknown;
 };
 
 export const redirectCodes = [
@@ -4646,7 +5260,11 @@ export const maxRedirects = 5;
  * Server-only module - never reaches browser bundles.
  * */
 export const store = new AsyncLocalStorage<RequestContext>();
-`,Fn=`import { type RequestContext, store } from "./base";
+
+export const isFetchApp = (app: FetchApp | NodeApp): app is FetchApp => {
+  return typeof (app as FetchApp).fetch === "function";
+};
+`,er=`import { type RequestContext, store } from "./base";
 
 import { renderWrapper } from "{{ createImport 'libEntry' 'server' }}";
 
@@ -4664,12 +5282,20 @@ export const withSsrContext = <T>(
 ): T => {
   return store.run(context, () => renderWrapper(context, render));
 };
-`,In=`import { inject } from "light-my-request";
 
-import { type FetchApp, isFetchApp, type NodeApp } from "@kosmojs/core";
+export const errorProvider = () => {
+  return store.getStore()?.error;
+};
+`,tr=`import type { FetchApp, NodeApp } from "@kosmojs/core";
 import type { Transport } from "@kosmojs/core/fetch";
 
-import { maxRedirects, redirectCodes, ssrOrigin, store } from "./base";
+import {
+  isFetchApp,
+  maxRedirects,
+  redirectCodes,
+  ssrOrigin,
+  store,
+} from "./base";
 
 import { apiApp } from "{{ createImport 'lib' '@ssr/api' }}";
 
@@ -4680,16 +5306,63 @@ const headersProvider = (): HeadersInit | undefined => {
   return store.getStore()?.headers;
 };
 
-/**
- * Builds a fetch-compatible transport that dispatches requests
- * directly into the given app - no sockets, no interception.
- * Redirects are followed in-process, including the 303 and 301/302 method rewrite to GET.
- * */
-const createTransport = (app: FetchApp | NodeApp): Transport => {
-  const dispatch = isFetchApp(app) //
+const createDispatch = (app: FetchApp | NodeApp) => {
+  return isFetchApp(app)
     ? app.fetch
-    : createNodeDispatch(app);
+    : 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.
+         * */
+        const url = new URL(request.url);
+
+        const payload = ["GET", "HEAD"].includes(request.method)
+          ? undefined
+          : Buffer.from(await request.arrayBuffer());
+
+        const result = await inject(app.callback() as never, {
+          method: request.method as never,
+          url: url.pathname + url.search,
+          headers: Object.fromEntries(request.headers),
+          ...(payload?.length ? { payload } : {}),
+        });
+
+        const headers = new Headers();
+
+        for (const [key, value] of Object.entries(result.headers)) {
+          for (const entry of Array.isArray(value) ? value : [value]) {
+            if (entry !== undefined) {
+              headers.append(key, String(entry));
+            }
+          }
+        }
+
+        /**
+         * 204/304 responses must not carry a body per the Response
+         * constructor contract.
+         * */
+        const body = [204, 304].includes(result.statusCode)
+          ? null
+          : new Uint8Array(result.rawPayload);
+
+        return new Response(body, {
+          status: result.statusCode,
+          statusText: result.statusMessage,
+          headers,
+        });
+      };
+};
+
+const createTransport = (app: FetchApp | NodeApp): Transport => {
+  const dispatch = createDispatch(app);
 
+  /**
+   * Build a fetch-compatible transport that dispatches requests
+   * directly into the given app - no sockets, no interception.
+   * Redirects are followed in-process, including the 303 and 301/302 method rewrite to GET.
+   * */
   return async (input, init) => {
     /**
      * Request-scoped headers act as defaults: anything set explicitly
@@ -4757,58 +5430,71 @@ const createTransport = (app: FetchApp | NodeApp): Transport => {
   };
 };
 
-/**
- * Node dispatch: serializes the web Request into light-my-request's
- * injection format and lifts the injected response back into a web Response.
- * */
-const createNodeDispatch = (app: NodeApp) => {
-  return async (request: Request): Promise<Response> => {
-    const url = new URL(request.url);
-
-    const payload = ["GET", "HEAD"].includes(request.method)
-      ? undefined
-      : Buffer.from(await request.arrayBuffer());
-
-    const result = await inject(app.callback() as never, {
-      method: request.method as never,
-      url: url.pathname + url.search,
-      headers: Object.fromEntries(request.headers),
-      ...(payload?.length ? { payload } : {}),
-    });
-
-    const headers = new Headers();
+const ssrTransport = apiApp ? createTransport(apiApp as never) : undefined;
 
-    for (const [key, value] of Object.entries(result.headers)) {
-      for (const entry of Array.isArray(value) ? value : [value]) {
-        if (entry !== undefined) {
-          headers.append(key, String(entry));
+export const transport = ssrTransport
+  ? async (input: RequestInfo | URL, init?: RequestInit) => {
+      try {
+        const response = await ssrTransport(input, init);
+        if (response?.ok) {
+          return response;
+        }
+        // the rethrow here needed cause ssrTransport does not throw on non-2xx responses
+        throw new SSRFetchError([
+          input,
+          response,
+          typeof response?.text === "function"
+            ? await response.text()
+            : response?.statusText,
+        ]);
+      } catch (error) {
+        /**
+         * Capture the fetch error at the transport level and stash it on the request store.
+         * Some frameworks - Solid notably - swallow a rejecting loader and still emit a partial render tree.
+         * Storing the error here keeps it observable regardless of how the framework handles the loader rejection.
+         * */
+        const storage = store.getStore();
+        if (storage) {
+          storage.error = error;
         }
+        throw error;
       }
     }
+  : undefined; // let fetch clients pick the transport
+
+class SSRFetchError extends Error {
+  constructor([input, response, message]: [
+    input: RequestInfo | URL,
+    response: Response,
+    message: string | undefined,
+  ]) {
+    const pathname = pathnameOf(input);
+    const status = response.status ?? "unknown";
+    super(\`\${pathname}: \${status} [ \${message} ]\`.trim());
+    this.name = "SSRFetchError";
+  }
+}
 
-    /**
-     * 204/304 responses must not carry a body per the Response
-     * constructor contract.
-     * */
-    const body = [204, 304].includes(result.statusCode)
-      ? null
-      : new Uint8Array(result.rawPayload);
-
-    return new Response(body, {
-      status: result.statusCode,
-      statusText: result.statusMessage,
-      headers,
-    });
-  };
+const pathnameOf = (input: RequestInfo | URL): string => {
+  try {
+    if (typeof input === "string") {
+      return new URL(input, "http://x").pathname;
+    }
+    if (input instanceof URL) {
+      return input.pathname;
+    }
+    if (input instanceof Request) {
+      return new URL(input.url).pathname;
+    }
+  } catch {}
+  return String(input);
 };
-
-export const transport = apiApp ? createTransport(apiApp) : globalThis.fetch;
-`,Ln=`export const routeMap = [
+`,nr=`export const routeMap = [
 {{#each pageRoutes}}
   { pathPattern: "{{honoPattern}}", renderMode: "{{renderMode}}" },
 {{/each}}
 ];
-`,Rn=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
+`,rr=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
 import {
   createServer,
   type IncomingMessage,
@@ -4824,14 +5510,9 @@ import { HTTPException } from "hono/http-exception";
 import { stream } from "hono/streaming";
 import { glob } from "tinyglobby";
 
-import {
-  type FetchApp,
-  isFetchApp,
-  type NodeApp,
-  type SSRSetup,
-} from "@kosmojs/core";
+import type { FetchApp, NodeApp, SSRSetup } from "@kosmojs/core";
 
-import { redirectCodes, ssrOrigin } from "./@ssr/base";
+import { isFetchApp, redirectCodes, ssrOrigin } from "./@ssr/base";
 
 import { routeMap } from "{{ createImport 'lib' '@ssr/routes' }}";
 import { apiBase, base } from "{{ createImport 'libCore' }}";
@@ -4853,12 +5534,14 @@ export const createApp = async () => {
   const {
     ssrApp,
     withSsrContext,
+    errorProvider,
   }: {
     ssrApp: SSRSetup;
     withSsrContext: <T>(
       context: { headers?: Record<string, string>; url?: string },
       render: () => T,
     ) => Promise<T>;
+    errorProvider: () => Error | undefined;
   } = await import(\`\${ROOT}/app.js\`);
 
   // Read the client index.html that includes <!--app-head--> and <!--app-html-->
@@ -4918,13 +5601,47 @@ export const createApp = async () => {
   };
 
   const renderPage = async (url: URL, ctx: Context) => {
-    const { head = "", html } = await withSsrContext(
+    const {
+      head = "",
+      html,
+      error,
+    } = await withSsrContext(
       {
         headers: Object.fromEntries(ctx.req.raw.headers),
         url: ctx.req.url,
       },
-      () => renderToString(url, ssrOptions()),
+      async () => {
+        try {
+          /**
+           * Catch a hard SSR render failure and fall back to CSR,
+           * where the client's error boundaries can surface a meaningful error.
+           * Server-side error boundaries behave inconsistently across frameworks,
+           * can not rely on them here.
+           * Instead, the SSR output are discarded and the client shell served verbatim,
+           * letting the client re-render and handle the error uniformly.
+           * This is the render-level counterpart to the transport-level catch in loaders.
+           * */
+          const { head = "", html } = await renderToString(url, ssrOptions());
+          return { head, html, error: errorProvider() };
+        } catch (error) {
+          return { error };
+        }
+      },
     );
+
+    if (error) {
+      console.error("WARN: SSR failed, fallback to CSR");
+      console.error(error);
+      console.error();
+      return [
+        htmlStart.replace(
+          "<!--app-head-->",
+          \`<script>console.error("WARN: SSR failed, fallback to CSR")<\/script>\`,
+        ),
+        htmlEnd,
+      ].join("");
+    }
+
     return [
       htmlStart.replace("<!--app-head-->", head),
       html ?? "",
@@ -5193,14 +5910,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.2.10`,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">
+`,ir=`string`,ar=m((e,r)=>{let{generators:i=[],refineTypeName:a,...o}=e.config,{createPath:c,createImportHelpers:l}=_(e),{renderToFile:u}=y({helpers:{...l({origin:`lib`})}});return{async build(e){let t=r?.renderMode?typeof r.renderMode==`string`?()=>r.renderMode:s(r?.renderMode,`string`):()=>ir,n={renderMode:JSON.stringify(r?.renderMode||null),pageRoutes:e.flatMap(e=>e.kind===`pageRoute`?[{...e.entry,renderMode:t(e.entry.name)}]:[]).sort(b),apiGenerator:i.some(e=>e.meta.slot===`backend`)};for(let[e,t]of[[`ssr.ts`,rr],[`@ssr/api.ts`,Qn],[`@ssr/__kosmo_ssr_bundle.ts`,er],[`@ssr/base.ts`,$n],[`@ssr/fetch.ts`,tr],[`@ssr/routes.ts`,nr]])await u(c.lib(e),t,n)},async postBuild(){let r=c.distDir(`ssr`),a=[x.tsconfigPaths(e),x.nodePrefix()];for(let t of i)await t.factory(e).ssrBuild?.();await w(h(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 w({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 E(n(r,`../client`),r,{recursive:!0});for(let e of[`server.js`,`server.js.map`])await E(`${r}/server/${e}`,`${r}/${e}`);await D(`${r}/server`,{recursive:!0,force:!0})}}}),or=p({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:ar}),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`}},sr=()=>{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">
+`,cr=`<script lang="ts">
   import { type QueryClient, QueryClientProvider } from "@tanstack/svelte-query";
   import type { Snippet } from "svelte";
 
@@ -5217,7 +5934,7 @@ if (isMain) {
 <QueryClientProvider client={queryClient}>
   {@render children()}
 </QueryClientProvider>
-`,Wn=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
+`,lr=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -5258,7 +5975,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Gn=`import { render as renderOrig } from "svelte/server";
+`,ur=`import { render as renderOrig } from "svelte/server";
 
 import type {
   RenderToStringWrapper,
@@ -5324,12 +6041,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" {
+`,dr=`declare module "*.svelte" {
   import type { Component } from "svelte";
   const component: Component;
   export default component;
 }
-`,qn=`<script lang="ts">
+`,fr=`<script lang="ts">
   /**
    * Folds [app, ...layouts] around the page component.
    *
@@ -5363,7 +6080,7 @@ export default serverRenderFactory<false>();
 {/snippet}
 
 {@render layer(0)}
-`,Jn=`<script lang="ts">
+`,pr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let { headline }: { headline?: string } = $props();
@@ -5395,7 +6112,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Yn=`<script lang="ts">
+`,mr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let {
@@ -5440,7 +6157,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Xn=`* {
+`,hr=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -5575,7 +6292,7 @@ export default serverRenderFactory<false>();
   align-items: center;
   gap: 0.25rem;
 }
-`,Zn=`<script lang="ts">
+`,gr=`<script lang="ts">
   import styles from "./styles.module.css";
 <\/script>
 
@@ -5633,7 +6350,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,Qn=`export type ParamsMap = {
+`,_r=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -5642,7 +6359,7 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,$n=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,vr=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
 
 let client: QueryClient | undefined;
 
@@ -5657,7 +6374,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,er=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,yr=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -5680,7 +6397,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,tr=`import type { RouterFactoryReturn } from "@kosmojs/core";
+`,br=`import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
 
 import Layouts from "./Layouts.svelte";
@@ -5720,9 +6437,11 @@ export default createRouterFactory<
   Promise<RouteComponent>,
   { server: { route: Route } }
 >();
-`,nr=`import { match, pathToRegexp } from "path-to-regexp";
+`,xr=`import { match, pathToRegexp } from "path-to-regexp";
 import { type Component, createContext } from "svelte";
 
+import { parseSearchParams } from "@kosmojs/core";
+
 import { paramNames } from "{{ createImport 'lib' 'params' }}";
 import { base } from "{{ createImport 'libCore' }}";
 
@@ -5746,7 +6465,7 @@ export type RawRoute = {
 };
 
 type Loader = (
-  route: Pick<Route, "name" | "params" | "paramsEntries">,
+  route: Pick<Route, "name" | "params" | "paramsEntries" | "searchParams">,
 ) => Promise<unknown> | undefined;
 
 /**
@@ -5788,6 +6507,7 @@ export type Route = {
   name: string;
   params: Record<string, string | Array<string>>;
   paramsEntries: [keys: Array<string>, values: Array<unknown>];
+  searchParams: Record<string, unknown>;
   loaderData: Record<string, unknown>;
 };
 
@@ -5827,6 +6547,7 @@ export const createRouter = (
 
   return {
     async resolve(url: URL = new URL(window.location.href)) {
+      const searchParams = parseSearchParams(url);
       const urlSegments = url.pathname.split("/").filter(Boolean).length;
 
       // 1: use lightweight \`RegExp.test()\` on linear scan - no capture allocation
@@ -5869,7 +6590,7 @@ export const createRouter = (
 
       loaderData[name] = await runLoader(name, () => {
         return routeModule.loader
-          ? routeModule.loader({ name, params, paramsEntries })
+          ? routeModule.loader({ name, params, paramsEntries, searchParams })
           : undefined; // should not survive serialization if no loader defined
       });
 
@@ -5881,7 +6602,12 @@ export const createRouter = (
         const key = \`\${layoutName}/layout\`;
         loaderData[key] = await runLoader(key, () => {
           return layoutModule.loader
-            ? layoutModule.loader({ name: layoutName, params, paramsEntries })
+            ? layoutModule.loader({
+                name: layoutName,
+                params,
+                paramsEntries,
+                searchParams,
+              })
             : undefined; // should not survive serialization if no loader defined
         });
       }
@@ -5890,6 +6616,7 @@ export const createRouter = (
         name,
         params,
         paramsEntries,
+        searchParams,
         loaderData,
       };
 
@@ -5931,7 +6658,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,rr=`import { getRouteContext } from "./svelte";
+`,Sr=`import { getRouteContext } from "./svelte";
 
 import type { ParamsMap, paramNames } from "{{ createImport 'lib' 'params' }}";
 
@@ -5957,6 +6684,10 @@ export function useParamsEntries<T extends keyof ParamsMap>(): [
   return useRoute().paramsEntries as never;
 }
 
+export function useSearchParams() {
+  return useRoute().searchParams;
+}
+
 /**
  * Reads loader data for the current page or one of its layouts.
  * Without a key, returns the page's own data.
@@ -5967,7 +6698,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
   const route = useRoute();
   return route.loaderData?.[key || route.name] as T;
 };
-`,ir=`<script lang="ts">
+`,Cr=`<script lang="ts">
   import { AppProvider } from "{{ createImport 'lib' 'app' }}";
   import type { Snippet } from "svelte";
 
@@ -5977,7 +6708,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 <AppProvider>
   {@render children()}
 </AppProvider>
-`,ar=`<script lang="ts">
+`,wr=`<script lang="ts">
   import type { Snippet } from "svelte";
   import type { HTMLAnchorAttributes } from "svelte/elements";
 
@@ -6001,7 +6732,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 <\/script>
 
 <a {href} {...rest}>{@render children?.()}</a>
-`,or=`import renderFactory, {
+`,Tr=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -6028,7 +6759,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,sr=`import renderFactory, {
+`,Er=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on Svelte folders
@@ -6049,7 +6780,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,cr=`<!doctype html>
+`,Dr=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -6061,19 +6792,19 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,lr=`<script lang="ts">
+`,Or=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/404.svelte' }}";
 <\/script>
 
 <PageSample />
-`,ur=`<script lang="ts">
+`,kr=`<script lang="ts">
   import type { Snippet } from "svelte";
 
   let { children }: { children: Snippet } = $props();
 <\/script>
 
 {@render children()}
-`,dr=`<script lang="ts">
+`,Ar=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/page.svelte' }}";
 
   const pathMap = {
@@ -6092,7 +6823,7 @@ export default renderFactory(() => {
   routeName={"{{route.name}}"}
   {pathMap}
 />
-`,fr=`<script lang="ts">
+`,jr=`<script lang="ts">
   import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.svelte' }}";
 <\/script>
 
@@ -6105,7 +6836,7 @@ export default renderFactory(() => {
 </svelte:head>
 
 <WelcomePage />
-`,pr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Mr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.svelte";
 
@@ -6120,7 +6851,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.2.10`,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";
+`,Nr=m((e,t)=>{let{createPath:n,createImportHelpers:r}=_(e),{renderToFile:i}=y({helpers:{...r({origin:`lib`}),...S()}}),{renderToFile:a}=y({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,Ar),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?jr:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:sr()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),kr,{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(b)}]}return[]}).sort(b);for(let[e,a]of[[`client.ts`,lr],[`server.ts`,ur]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,_r],[`router.ts`,br]])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`,dr],[`svelte.ts`,xr],[`Layouts.svelte`,fr],[`use.ts`,Sr],[`pageSamples/styles.module.css`,hr],[`pageSamples/welcome.svelte`,gr],[`pageSamples/page.svelte`,mr],[`pageSamples/404.svelte`,pr],...t?.tanstack?.query?[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,cr],[`app/index.ts`,`export { default as AppProvider } from "./app-tsq.svelte";`],[`query.ts`,vr]]:[[`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`,Or],[`components/Link.svelte`,wr],[`app.svelte`,Cr],[`router.ts`,Mr]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),Dr,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Tr],[`server.ts`,Er]])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?yr:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Pr=p({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:Nr}),Fr={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`}},Ir=`import Type from "typebox";
 
 /**
  * Custom types for JavaScript constructs that have no JSON Schema
@@ -6192,7 +6923,7 @@ export default {
   Buffer: TBuffer(),
   ArrayBuffer: TArrayBuffer(),
 };
-`,vr=`import type { TValidationError } from "typebox/error";
+`,Lr=`import type { TValidationError } from "typebox/error";
 
 import type { ValidationErrorEntry } from "@kosmojs/core";
 
@@ -7376,7 +8107,7 @@ const format = (fmt: string, ...args: unknown[]): string => {
 
   return str;
 };
-`,yr=`import Type from "typebox";
+`,Rr=`import Type from "typebox";
 import { Compile } from "typebox/compile";
 import Value from "typebox/value";
 
@@ -7428,14 +8159,14 @@ export const validationSchemaFactory = (
     },
   };
 };
-`,br=`import { Settings } from "typebox/system";
+`,zr=`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";
+`,Br=`import type { ValidationSchemas } from "@kosmojs/core";
 
 import { validationSchemaFactory } from "{{ createImport 'lib' '@typebox' }}";
 
@@ -7496,14 +8227,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.2.10`,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";
+`,Vr={exactOptionalPropertyTypes:!0},Hr=m((e,t)=>{let{createPath:n,createImport:r,createImportHelpers:i}=_(e),{renderToFile:a}=y({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`),Br,{route:r,resolvedTypes:e,requestSchemas:i,responseSchemas:s})}};return{async start(){for(let[e,t]of[[`custom-types.ts`,Ir],[`error-handler.ts`,Lr],[`index.ts`,Rr],[`setup.ts`,zr]])await a(n.lib(`@typebox`,e),t,{validationMessages:JSON.stringify(s),customTypesImport:c,settings:JSON.stringify({...Vr,...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 Ur=p({meta:{name:`TypeBox`,resolveTypes:!0},dependencies:{typebox:Fr.devDependencies.typebox},factory:Hr}),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(`/`)},Wr=()=>{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},Gr=()=>{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)]},Kr=`import type { Plugin } from "vue";
 
 export { default as AppProvider } from "./provider.vue";
 
 export const appProvider: Plugin = {
   install() {},
 };
-`,Or=`import { VueQueryPlugin } from "@tanstack/vue-query";
+`,qr=`import { VueQueryPlugin } from "@tanstack/vue-query";
 import type { Plugin } from "vue";
 
 import { getQueryClient } from "../query";
@@ -7515,10 +8246,10 @@ export const appProvider: Plugin = {
     app.use(VueQueryPlugin, { queryClient: getQueryClient() });
   },
 };
-`,kr=`<template>
+`,Jr=`<template>
   <slot />
 </template>
-`,Ar=`import type { App } from "vue";
+`,Yr=`import type { App } from "vue";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -7558,7 +8289,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,jr=`{
+`,Xr=`{
   path: "{{path}}",
   {{#if name}}
   name: "{{name}}",
@@ -7576,7 +8307,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,Mr=`import type { App } from "vue";
+`,Zr=`import type { App } from "vue";
 
 import {
   renderToString as renderToStringOrig,
@@ -7652,31 +8383,27 @@ export const renderToStream: RenderToStreamWrapper<
   Parameters<typeof renderToWebStream>[1]
 > = async (resolver, { headerTags = [], context = {} } = {}) => {
   const { component, loaderData } = await resolver();
-  const source = renderToWebStream(component, context);
-
-  const appendScript = new TransformStream<Uint8Array, Uint8Array>({
-    flush(controller) {
-      // runs once, after \`source\` has fully flushed and closed
-      const script = createHydrationScript(loaderData);
-      if (script) {
-        controller.enqueue(new TextEncoder().encode(script));
-      }
-    },
-  });
+
+  /**
+   * loaderData is fully resolved before streaming starts, so the hydration
+   * script ships in head - same as string mode. Head is written with the shell,
+   * guaranteeing delivery even when the stream errors mid-body.
+   * */
+  const script = createHydrationScript(loaderData);
 
   return {
-    head: [...headerTags].join("\\n"),
-    html: source.pipeThrough(appendScript),
+    head: [...headerTags, ...script ? [script] : []].join("\\n"),
+    html: renderToWebStream(component, context),
   };
 }
 
 export default serverRenderFactory();
-`,$=`declare module "*.vue" {
+`,Qr=`declare module "*.vue" {
   import type { DefineComponent } from "vue";
   const component: DefineComponent<{}, {}, any>;
   export default component;
 }
-`,Nr=`<script setup lang="ts">
+`,$r=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   headline?: string;
@@ -7715,7 +8442,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,Pr=`<script setup lang="ts">
+`,$=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   message: string;
@@ -7764,7 +8491,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,Fr=`* {
+`,ei=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -7897,7 +8624,7 @@ defineProps<{
   align-items: center;
   gap: 0.25rem;
 }
-`,Ir=`<script setup lang="ts">
+`,ti=`<script setup lang="ts">
 import styles from "./styles.module.css";
 <\/script>
 
@@ -7961,7 +8688,7 @@ import styles from "./styles.module.css";
     </div>
   </div>
 </template>
-`,Lr=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,ni=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
 
 let client: QueryClient | undefined;
 
@@ -7976,7 +8703,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return client;
 };
-`,Rr=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,ri=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
 
 import { store } from "{{ createImport 'lib' '@ssr/base' }}";
 
@@ -7999,7 +8726,7 @@ export const getQueryClient = (): QueryClient => {
   }
   return ctx.tsqClient as QueryClient;
 };
-`,zr=`import {
+`,ii=`import {
   type App,
   type Component,
   createApp,
@@ -8128,7 +8855,7 @@ export const createRouters = (
       // would otherwise skip the guard
       installLoaderGuard(router);
 
-      await router.push(url.pathname.replace(base, ""));
+      await router.push(url.pathname + url.search);
 
       await router.isReady();
 
@@ -8150,14 +8877,14 @@ export default createRouterFactory<
   Promise<App>,
   { server: { loaderData: Record<string, unknown> } }
 >();
-`,Br=`import { type Ref, unref } from "vue";
+`,ai=`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";
+`,oi=`import { useRoute, useRouter } from "vue-router";
 
 import type { RouterWithLoaderData } from "./router";
 
@@ -8172,7 +8899,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">
+`,si=`<script setup lang="ts">
 import { AppProvider } from "_/app";
 <\/script>
 
@@ -8181,7 +8908,7 @@ import { AppProvider } from "_/app";
     <RouterView />
   </AppProvider>
 </template>
-`,Ur=`<script setup lang="ts" generic="T extends LinkProps">
+`,ci=`<script setup lang="ts" generic="T extends LinkProps">
 import { computed } from "vue";
 import { RouterLink } from "vue-router";
 
@@ -8213,7 +8940,7 @@ const href = computed(() => {
     <slot />
   </RouterLink>
 </template>
-`,Wr=`import renderFactory, {
+`,li=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -8240,7 +8967,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Gr=`import renderFactory, {
+`,ui=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -8267,7 +8994,7 @@ export default renderFactory(() => {
     },
   };
 });
-`,Kr=`<!doctype html>
+`,di=`<!doctype html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -8279,17 +9006,17 @@ export default renderFactory(() => {
   <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
 </body>
 </html>
-`,qr=`<script setup lang="ts">
+`,fi=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/404.vue' }}";
 <\/script>
 
 <template>
   <PageSample />
 </template>
-`,Jr=`<template>
+`,pi=`<template>
   <router-view />
 </template>
-`,Yr=`<script setup lang="ts">
+`,mi=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
 <\/script>
 
@@ -8304,14 +9031,14 @@ import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
     }"
   />
 </template>
-`,Xr=`<script setup lang="ts">
+`,hi=`<script setup lang="ts">
 import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.vue' }}";
 <\/script>
 
 <template>
   <WelcomePage />
 </template>
-`,Zr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,gi=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 import { appProvider } from "{{ createImport 'lib' 'app' }}";
 
 import app from "./app.vue";
@@ -8330,5 +9057,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};
+`,_i=m((e,t)=>{let{createPath:n,createImportHelpers:r}=_(e),{renderToFile:i}=y({helpers:{...r({origin:`lib`}),...S()},partials:{routePartial:Xr}}),{renderToFile:a}=y({helpers:r({origin:`src`})}),o=Wr(),s=e=>!e?.trim().length,u=c(t?.templates,mi),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?hi:u(r.name,r),{route:r,message:Gr()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),pi,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(b),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(g(r));for(let[e,t]of[[`client.ts`,Yr],[`server.ts`,Zr]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a,lazyLoad:e===`client.ts`});await i(n.lib(`router.ts`),ii,{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`,Qr],[`unwrap.ts`,ai],[`use.ts`,oi],[`pageSamples/styles.module.css`,ei],[`pageSamples/welcome.vue`,ti],[`pageSamples/page.vue`,$],[`pageSamples/404.vue`,$r],[`app/provider.vue`,Jr],...t?.tanstack?.query?[[`app/index.ts`,qr],[`query.ts`,ni]]:[[`app/index.ts`,Kr],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.vue`,fi],[`components/Link.vue`,ci],[`app.vue`,si],[`router.ts`,gi]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),di,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,li],[`server.ts`,ui]])await a(n.entry(e),t,{},{overwrite:s})},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?ri:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),vi=p({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:_i}),yi=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,yi as defineConfig,P as fetchGenerator,De as h3Generator,Ke as honoGenerator,dt as koaGenerator,Bt as mdxGenerator,Gt as openapiGenerator,bn as reactGenerator,Jn as solidGenerator,Zn as ssgGenerator,or as ssrGenerator,Pr as svelteGenerator,Ur as typeboxGenerator,vi as vueGenerator};
 //# sourceMappingURL=index.js.map