@kosmojs/dev 0.4.2 → 0.4.4

package/pkg/index.js

@@ -1,6 +1,588 @@
-import{t as e}from"./assets/pkg-Bkag325q.js";import{join as t,resolve as n}from"node:path";import{styleText as r}from"node:util";import{DEFAULT_APIBASE as i,RequestBodyTargets as a,RequestValidationTargets as o,createRouteResolver as s,createTemplateResolver as c,defaults as l}from"@kosmojs/core";import{createH3Pattern as u,createHonoPattern as d,createPathPattern as f,createWatchedApiRouteEntriesFilter as p,createWatchedPageRouteEntriesFilter as m,defineGenerator as h,defineGeneratorFactory as g,mergeConfigs as _,nestedRoutesFactory as v,pathResolver as y,pathTokensFactory as b,renderFactory as x,renderToFile as ee,sortRoutes as S,spinnerFactory as te,vitePlugins as C}from"@kosmojs/lib";import{routeRenderHelpers as w}from"@kosmojs/core/generators";import T from"crc/crc32";import ne from"@mdx-js/rollup";import{build as E,createFilter as re}from"vite";import ie from"yaml";import{parse as ae}from"path-to-regexp";import oe from"typebox";import se from"@vitejs/plugin-react";import D from"vite-plugin-solid";import{access as ce,constants as le,cp as O,mkdir as ue,rm as k,writeFile as de}from"node:fs/promises";import{svelte as fe}from"@sveltejs/vite-plugin-svelte";import pe from"@vitejs/plugin-vue";var A=`export * from "./transport";
-`,j=`export const transport = undefined;
-`,M=`{{#each routes}}
+import{dirname as e,join as t,posix as n,resolve as r}from"node:path";import{styleText as i}from"node:util";import{DEFAULT_APIBASE as a,RequestBodyTargets as o,RequestValidationTargets as s,createRouteResolver as c,createTemplateResolver as l,defaults as u}from"@kosmojs/core";import{collectVirtualModules as d,createH3Pattern as f,createHonoPattern as p,createPathPattern as m,createWatchedApiRouteEntriesFilter as h,createWatchedPageRouteEntriesFilter as g,defineGenerator as _,defineGeneratorFactory as v,mergeConfigs as y,nestedRoutesFactory as b,pathExists as x,pathResolver as S,pathTokensFactory as C,renderFactory as w,renderToFile as T,sortRoutes as E,sortRoutesForResolution as D,spinnerFactory as ee,vitePlugins as O}from"@kosmojs/lib";import k from"semver";import{routeRenderHelpers as A}from"@kosmojs/core/generators";import{HTTPMethods as te}from"@kosmojs/core/fetch";import j from"crc/crc32";import ne from"@mdx-js/rollup";import{build as M,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 N from"vite-plugin-solid";import{access as ce,constants as le,cp as P,mkdir as ue,rm as F,writeFile as de}from"node:fs/promises";import{svelte as fe}from"@sveltejs/vite-plugin-svelte";import pe from"@vitejs/plugin-vue";var me={type:`module`,private:!0,name:`@kosmojs/core-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:^`,semver:`^7.8.5`},devDependencies:{"@types/semver":`^7.8.0`,"path-to-regexp":`^8.4.2`}},he=`export const base = "{{config.base}}";
+export const apiBase = "{{config.apiBase}}";
+`,I=`import type { StaticParams } from "./types";
+
+export * from "./config";
+export * from "./routes";
+export * from "./types";
+
+export const defineStaticParams = <T extends keyof StaticParams>(
+  variants: Array<StaticParams[T]>,
+) => {
+  return variants
+};
+`,L=`{{> routeMapperPartial}}
+
+import { base, apiBase } from "./config";
+
+// used by backend generators and fetch clients
+export const apiRouteMap = {
+  {{#each apiRoutes}}
+  "{{name}}": apiRouteMapper<[{{serializeParamsTupleElements .}}]>(
+    join(base, apiBase),
+    {{serializeApiRoute .}},
+  ),
+  {{/each}}
+};
+
+// used by frontend generators on Link component
+export const pageRouteMap = {
+  {{#each pageRoutes}}
+  "{{name}}": pageRouteMapper<[{{serializeParamsTupleElements .}}]>(
+    base,
+    {{serializePageRoute .}},
+  ),
+  {{/each}}
+};
+`,R=`import { compile, match } from "path-to-regexp";
+
+import {
+  type ApiRouteSerialized,
+  type PageRouteSerialized,
+  stringifySearchParams,
+  type ValidationTarget,
+} from "@kosmojs/core";
+import { createHost, join } from "@kosmojs/core/fetch";
+import type { RoutePathMethods } from "@kosmojs/core/generators";
+
+type NormalizeParams = (path: string) => Record<string, unknown>;
+
+type NormalizeSearchParams = (
+  searchParams: Record<string, unknown>,
+  method: string,
+) => Record<string, unknown>;
+
+type PayloadResolver = <T>(
+  payload: Record<ValidationTarget, T> | undefined,
+  target: ValidationTarget,
+  method: string,
+) => T | Record<string, unknown> | undefined;
+
+export const apiRouteMapper = <ParamsT extends readonly unknown[]>(
+  base: string,
+  {
+    name,
+    pathPattern,
+    params,
+    numericProperties,
+    booleanProperties,
+  }: ApiRouteSerialized,
+): RoutePathMethods<ParamsT> & {
+  normalizeParams: NormalizeParams;
+  normalizeSearchParams: NormalizeSearchParams;
+  payloadResolver: PayloadResolver;
+} => {
+  const toPath = compile(pathPattern);
+  const pathMatcher = match(join(base, pathPattern));
+
+  const maybeNumber = (val: unknown) => {
+    if (val === undefined || val === null) {
+      return val;
+    }
+    const n = Number(val);
+    return Number.isFinite(n) ? n : val;
+  };
+
+  const maybeBoolean = (val: unknown) => {
+    return [true, false, "true", "false"].includes(val as never) //
+      ? JSON.parse(val as never)
+      : val;
+  };
+
+  const resolveParam = (path: string, param: (typeof params)[number]) => {
+    try {
+      const match = pathMatcher(path);
+      return match ? match.params[param] : undefined;
+    } catch (e) {
+      return undefined;
+    }
+  };
+
+  const normalizeSearchParams: NormalizeSearchParams = (
+    searchParams,
+    method,
+  ) => {
+    return Object.fromEntries(
+      Object.entries(searchParams).map(([k, v]) => {
+        if (numericProperties.query?.[method]?.includes(k)) {
+          return [
+            k,
+            Array.isArray(v) ? v.map((e) => maybeNumber(e)) : maybeNumber(v),
+          ];
+        }
+        if (booleanProperties.query?.[method]?.includes(k)) {
+          return [
+            k,
+            Array.isArray(v) ? v.map((e) => maybeBoolean(e)) : maybeBoolean(v),
+          ];
+        }
+        return [k, v];
+      }),
+    );
+  };
+
+  const normalizeParams: NormalizeParams = (path) => {
+    return params.reduce((map: Record<string, unknown>, param) => {
+      const value = resolveParam(path, param);
+      if (Array.isArray(value)) {
+        map[param] = numericProperties.params.includes(param)
+          ? value.map((e) => maybeNumber(e))
+          : value;
+      } else if (value) {
+        map[param] = numericProperties.params.includes(param)
+          ? maybeNumber(value)
+          : value;
+      }
+      return map;
+    }, {});
+  };
+
+  const paramsMapper: RoutePathMethods<ParamsT>["paramsMapper"] = (
+    input,
+    opt,
+  ) => {
+    return params.reduce<Record<string, unknown>>((map, name, i) => {
+      const coerceNumbers = opt?.coerceNumbers
+        ? numericProperties.params.includes(name)
+        : false;
+      if (Array.isArray(input[i])) {
+        map[name] = coerceNumbers
+          ? input[i].map((v) => maybeNumber(v))
+          : input[i].map(String);
+      } else if (input[i] !== undefined) {
+        map[name] = coerceNumbers ? maybeNumber(input[i]) : String(input[i]);
+      }
+      return map;
+    }, {});
+  };
+
+  const parametrize: RoutePathMethods<ParamsT>["parametrize"] = (params) => {
+    try {
+      return toPath(paramsMapper(params) as never);
+    } catch (error) {
+      console.error(\`❗ERROR: Failed building path for \${name}\`);
+      throw error;
+    }
+  };
+
+  const path: RoutePathMethods<ParamsT>["path"] = (params, query, opt) => {
+    const path = join(
+      opt?.prefix === false
+        ? "/"
+        : typeof opt?.prefix === "string"
+          ? opt.prefix
+          : base,
+      parametrize(params),
+    );
+    return query //
+      ? [path, stringifySearchParams(query)].join("?")
+      : path;
+  };
+
+  const href: RoutePathMethods<ParamsT>["href"] = (
+    host,
+    params,
+    query,
+    opt,
+  ) => {
+    return createHost(host) + path(params, query, opt);
+  };
+
+  const payloadResolver: PayloadResolver = (payload, target, method) => {
+    const data = payload?.[target];
+
+    if (target === "query") {
+      return Object.fromEntries(
+        Object.entries({ ...data }).map(([k, v]) => {
+          return [
+            k,
+            numericProperties.query[method]?.includes(k)
+              ? Array.isArray(v)
+                ? v.map((v) => maybeNumber(v))
+                : maybeNumber(v)
+              : v,
+          ];
+        }),
+      );
+    }
+
+    if (data instanceof FormData) {
+      return [...data].reduce<
+        Record<string, FormDataEntryValue | Array<FormDataEntryValue>>
+      >((map, [key, val]) => {
+        if (key in map) {
+          map[key] = [map[key]].flat().concat(val);
+        } else {
+          map[key] = val;
+        }
+        return map;
+      }, {});
+    }
+
+    return data;
+  };
+
+  return {
+    normalizeParams,
+    normalizeSearchParams,
+    payloadResolver,
+    paramsMapper,
+    parametrize,
+    path,
+    href,
+  };
+};
+
+export const pageRouteMapper = <ParamsT extends readonly unknown[]>(
+  base: string,
+  route: PageRouteSerialized,
+): RoutePathMethods<ParamsT> => {
+  const toPath = compile(route.pathPattern);
+
+  const paramsMapper: RoutePathMethods<ParamsT>["paramsMapper"] = (params) => {
+    return route.params.reduce<Record<string, unknown>>((map, name, i) => {
+      if (Array.isArray(params[i])) {
+        map[name] = params[i].map(String);
+      } else if (params[i] !== undefined) {
+        map[name] = String(params[i]);
+      }
+      return map;
+    }, {});
+  };
+
+  const parametrize: RoutePathMethods<ParamsT>["parametrize"] = (params) => {
+    try {
+      return toPath(paramsMapper(params) as never);
+    } catch (error) {
+      console.error(\`❗ERROR: Failed building path for \${route.name}\`);
+      throw error;
+    }
+  };
+
+  const path: RoutePathMethods<ParamsT>["path"] = (params, query, opt) => {
+    const path = join(
+      opt?.prefix === false
+        ? "/"
+        : typeof opt?.prefix === "string"
+          ? opt.prefix
+          : base,
+      parametrize(params),
+    );
+    return query //
+      ? [path, stringifySearchParams(query)].join("?")
+      : path;
+  };
+
+  const href: RoutePathMethods<ParamsT>["href"] = (
+    host,
+    params,
+    query,
+    opt,
+  ) => {
+    return createHost(host) + path(params, query, opt);
+  };
+
+  return {
+    paramsMapper,
+    parametrize,
+    path,
+    href,
+  };
+};
+`,ge=`import { AsyncLocalStorage } from "node:async_hooks";
+
+export type RequestContext = {
+  headers?: HeadersInit;
+  tsqClient?: unknown;
+  error?: unknown;
+};
+
+/**
+ * Request-scoped context store.
+ * */
+export const store = new AsyncLocalStorage<RequestContext>();
+
+/**
+ * Origin used to absolutize the relative URLs the client produces.
+ * */
+export const ssrOrigin = "http://ssr.local";
+
+export const redirectCodes = [
+  // Moved Permanently
+  301,
+  // Found (temporary)
+  302,
+  // See Other (redirect after POST)
+  303,
+  // Temporary Redirect (preserves method)
+  307,
+  // Permanent Redirect (preserves method)
+  308,
+];
+`,_e=`export type Override<A, B> = Omit<A, keyof B> & B;
+
+export type StaticParams = {
+  {{#each pageRoutes}}
+  "{{name}}": [ {{serializeParamsTupleElements .}} ];
+  {{/each}}
+};
+
+{{#if pageRoutes.length}}
+export type LinkProps =
+  {{#each pageRoutes}}
+  | [ "{{name}}", {{serializeParamsTupleElements .}} ]
+  {{/each}};
+{{else}}
+export type LinkProps = never;
+{{/if}}
+`,ve=`declare module "virtual:kosmo/env" {
+  export const command: "serve" | "build";
+}
+
+declare module "virtual:kosmo/backend-app" {
+  import type { FetchApp, NodeApp } from "@kosmojs/core";
+  const backend: FetchApp | NodeApp | undefined;
+  export default backend;
+}
+
+declare module "virtual:kosmo/fetch-transport" {
+  import type { Transport } from "@kosmojs/core/fetch";
+  /**
+   * Undefined on the client, where fetch clients fall back to global fetch.
+   * On the SSR bundle it dispatches straight into the backend app, in process.
+   * Supplied by the \`kosmo:virtualModules\` Vite plugin - there is no file.
+   * */
+  export const transport: Transport | undefined;
+}
+
+/**
+ * Enhances base TypeScript types with JSON Schema validation constraints.
+ * Allows declaring refined types that carry validation metadata for runtime
+ * schema validation while maintaining full TypeScript type safety.
+ *
+ * Useful for generating validation schemas and ensuring
+ * data conforms to specific business rules beyond basic type checking.
+ * */
+declare type VRefine<
+  T extends unknown[] | number | string | object,
+  _ extends T extends unknown[]
+    ? TArrayOptions
+    : T extends number
+      ? TNumberOptions
+      : T extends string
+        ? TStringOptions
+        : TObjectOptions,
+> = T;
+
+/**
+ * Type definitions inspired by and gently adapted from TypeBox.
+ * Original TypeBox created by sinclairzx81: https://github.com/sinclairzx81/typebox
+ * TypeBox is licensed under MIT: https://github.com/sinclairzx81/typebox/blob/main/license
+ *
+ * These types provide JSON Schema compatible type refinements for TypeScript.
+ * */
+interface TSchema {}
+
+// ------------------------------------------------------------------
+// ObjectOptions
+// ------------------------------------------------------------------
+interface TObjectOptions {
+  /**
+   * Defines whether additional properties are allowed beyond those explicitly defined in \`properties\`.
+   */
+  additionalProperties?: TSchema | boolean;
+  /**
+   * The minimum number of properties required in the object.
+   */
+  minProperties?: number;
+  /**
+   * The maximum number of properties allowed in the object.
+   */
+  maxProperties?: number;
+  /**
+   * Defines conditional requirements for properties.
+   */
+  dependencies?: Record<string, boolean | TSchema | string[]>;
+  /**
+   * Specifies properties that *must* be present if a given property is present.
+   */
+  dependentRequired?: Record<string, string[]>;
+  /**
+   * Defines schemas that apply if a specific property is present.
+   */
+  dependentSchemas?: Record<string, TSchema>;
+  /**
+   * Maps regular expressions to schemas properties matching a pattern must validate against the schema.
+   */
+  patternProperties?: Record<string, TSchema>;
+  /**
+   * A schema that all property names within the object must validate against.
+   */
+  propertyNames?: TSchema;
+}
+
+// ------------------------------------------------------------------
+// ArrayOptions
+// ------------------------------------------------------------------
+interface TArrayOptions {
+  /**
+   * The minimum number of items allowed in the array.
+   */
+  minItems?: number;
+  /**
+   * The maximum number of items allowed in the array.
+   */
+  maxItems?: number;
+  /**
+   * A schema that at least one item in the array must validate against.
+   */
+  contains?: TSchema;
+  /**
+   * The minimum number of array items that must validate against the \`contains\` schema.
+   */
+  minContains?: number;
+  /**
+   * The maximum number of array items that may validate against the \`contains\` schema.
+   */
+  maxContains?: number;
+  /**
+   * An array of schemas, where each schema in \`prefixItems\` validates against items at corresponding positions from the beginning of the array.
+   */
+  prefixItems?: TSchema[];
+  /**
+   * If \`true\`, all items in the array must be unique.
+   */
+  uniqueItems?: boolean;
+}
+
+// ------------------------------------------------------------------
+// NumberOptions
+// ------------------------------------------------------------------
+interface TNumberOptions {
+  /**
+   * Specifies an exclusive upper limit for the number (number must be less than this value).
+   */
+  exclusiveMaximum?: number | bigint;
+  /**
+   * Specifies an exclusive lower limit for the number (number must be greater than this value).
+   */
+  exclusiveMinimum?: number | bigint;
+  /**
+   * Specifies an inclusive upper limit for the number (number must be less than or equal to this value).
+   */
+  maximum?: number | bigint;
+  /**
+   * Specifies an inclusive lower limit for the number (number must be greater than or equal to this value).
+   */
+  minimum?: number | bigint;
+  /**
+   * Specifies that the number must be a multiple of this value.
+   */
+  multipleOf?: number | bigint;
+}
+
+// ------------------------------------------------------------------
+// StringOptions
+// ------------------------------------------------------------------
+type TFormat =
+  | "date-time"
+  | "date"
+  | "duration"
+  | "email"
+  | "hostname"
+  | "idn-email"
+  | "idn-hostname"
+  | "ipv4"
+  | "ipv6"
+  | "iri-reference"
+  | "iri"
+  | "json-pointer-uri-fragment"
+  | "json-pointer"
+  | "json-string"
+  | "regex"
+  | "relative-json-pointer"
+  | "time"
+  | "uri-reference"
+  | "uri-template"
+  | "url"
+  | "uuid";
+
+interface TStringOptions {
+  /**
+   * Specifies the expected string format.
+   *
+   * Common values include:
+   * - \`base64\` – Base64-encoded string.
+   * - \`date-time\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time format.
+   * - \`date\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (YYYY-MM-DD).
+   * - \`duration\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) duration format.
+   * - \`email\` – RFC 5321/5322 compliant email address.
+   * - \`hostname\` – RFC 1034/1035 compliant host name.
+   * - \`idn-email\` – Internationalized email address.
+   * - \`idn-hostname\` – Internationalized host name.
+   * - \`ipv4\` – IPv4 address.
+   * - \`ipv6\` – IPv6 address.
+   * - \`iri\` / \`iri-reference\` – Internationalized Resource Identifier.
+   * - \`json-pointer\` / \`json-pointer-uri-fragment\` – JSON Pointer format.
+   * - \`json-string\` – String containing valid JSON.
+   * - \`regex\` – Regular expression syntax.
+   * - \`relative-json-pointer\` – Relative JSON Pointer format.
+   * - \`time\` – [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time (HH:MM:SS).
+   * - \`uri-reference\` / \`uri-template\` – URI reference or template.
+   * - \`url\` – Web URL format.
+   * - \`uuid\` – RFC 4122 UUID string.
+   *
+   * May also be a custom format string.
+   */
+  format?: TFormat;
+  /**
+   * Specifies the minimum number of characters allowed in the string.
+   * Must be a non-negative integer.
+   */
+  minLength?: number;
+  /**
+   * Specifies the maximum number of characters allowed in the string.
+   * Must be a non-negative integer.
+   */
+  maxLength?: number;
+  /**
+   * Specifies a regular expression pattern that the string value must match.
+   * Can be provided as a string (ECMA-262 regex syntax) or a \`RegExp\` object.
+   */
+  pattern?: string | RegExp;
+}
+`,ye=`# Ignore all files
+*
+
+# But don't ignore directories (so Git can traverse them)
+!*/
+
+# And don't ignore these files at any depth
+!cache.json
+!types.ts
+`,be=`export declare global {
+  interface Window {
+    __KOSMO_HYDRATION_BOOL__: boolean;
+    __KOSMO_HYDRATION_DATA__: Record<string, unknown> | undefined;
+  }
+}
+`,xe=`<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+</head>
+<body>
+  <div id="app"><!--app-html--></div>
+  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
+</body>
+</html>
+`,Se=`// stub schemas, specialized generators supposed to overwrite this file
+import type { ValidationSchemas } from "@kosmojs/core";
+export type { ValidationSchemas };
+export const validationSchemas: ValidationSchemas = {};
+`,z=({dependencies:e,devDependencies:t},n)=>{let r="${configDir}",i=Object.keys({...e,...t}),a={types:[`vite/client`,...[`node`,`deno`,`bun`].flatMap(e=>i.includes(`@types/${e}`)?[`@types/${e}`]:[])],moduleResolution:`bundler`,module:`ESNext`,target:`ESNext`,strict:!0,exactOptionalPropertyTypes:!0,noImplicitAny:!0,noImplicitThis:!0,noImplicitOverride:!0,noImplicitReturns:!0,noUnusedLocals:!1,noUnusedParameters:!1,allowArbitraryExtensions:!0,allowImportingTsExtensions:!0,allowUnreachableCode:!1,allowUnusedLabels:!1,useUnknownInCatchVariables:!0,noFallthroughCasesInSwitch:!0,noUncheckedSideEffectImports:!0,resolveJsonModule:!0,esModuleInterop:!0,verbatimModuleSyntax:!0,skipLibCheck:!0,noEmit:!0};return n?{include:[`${r}/`,`${r}/../../${u.libDir}/${n}/`,`${r}/../../**/*.d.ts`],compilerOptions:{...a,types:[...a.types],paths:{[`${u.appPrefix}/*`]:[`${r}/../../*`],[`${u.srcPrefix}/*`]:[`${r}/*`],[`${u.libPrefix}/*`]:[`${r}/../../${u.libDir}/${n}/*`]}}}:{include:[`${r}/`],exclude:[`${r}/${u.srcDir}/`],compilerOptions:{...a,paths:{[`${u.appPrefix}/*`]:[`${r}/*`]}}}},Ce=v(t=>{let{createPath:n,createImportHelpers:a}=S(t),{generators:o}=t.config,s=async()=>{let{dependencies:e={},devDependencies:a={}}=await import(r(t.root,`package.json`),{with:{type:`json`}}).then(e=>e.default);{let t=[],n=[],r=o.flatMap(e=>[`dependencies`,`devDependencies`].flatMap(t=>e[t]?Object.entries(typeof e[t]==`function`?e[t](e.options):e[t]).flatMap(([e,n])=>{let r=k.minVersion(n)?.version;return r?[[e,r,t]]:[]}):[]));for(let[i,o,s]of r){let r=e[i]||a[i],c=r?k.minVersion(r)?.version:void 0;!r||!c?t.push([i,o,s]):k.lt(c,o)&&n.push([i,o,s])}if(t.length){console.error(i([`red`,`italic`],`There are ${t.length} missing dependencies, please consider installing them.`));for(let e of[`dependencies`,`devDependencies`]){let n=t.filter(t=>t[2]===e);n.length&&console.error(`${e}: ${i([`blue`],n.map(([e])=>e).join(` `))}`)}}n.length&&(console.error(i([`yellow`,`italic`],`There are ${n.length} outdated dependencies, please consider updating them:`)),console.error(n.map(([e])=>e).join(` `)),console.error())}{await T(r(t.root,`tsconfig.json`),JSON.stringify({extends:`./${u.libDir}/tsconfig.json`},void 0,2),{},{overwrite:!1}),await T(n.lib(`../tsconfig.json`),JSON.stringify(z({dependencies:e,devDependencies:a}),void 0,2),{}),await T(n.src(`tsconfig.json`),JSON.stringify({extends:`../../${u.libDir}/${t.name}/tsconfig.json`},void 0,2),{},{overwrite:!1});let i=z({dependencies:e,devDependencies:a},t.name),s={},c=new Set(i.compilerOptions.types||[]);for(let{meta:e}of o){e.jsx&&(s.jsx=e.jsx),e.jsxImportSource&&(s.jsxImportSource=e.jsxImportSource);for(let t of e.types||[])c.add(t)}await T(n.lib(`tsconfig.json`),JSON.stringify({...i,compilerOptions:{...i.compilerOptions,...s,types:[...c.values()]}},void 0,2),{})}for(let[e,t]of[[`env.d.ts`,ve],[`global.d.ts`,be]])await T(n.lib(`../${e}`),t,{});await T(n.lib(`../.gitignore`),ye,{},{overwrite:!1}),o.some(e=>e.meta.slot===`frontend`)&&await T(n.src(`index.html`),xe,{entryDir:u.entryDir},{overwrite:e=>!e?.trim()})},c=async r=>{let{renderToFile:i}=w({helpers:{...a({origin:`lib`}),...A()},partials:{routeMapperPartial:R}}),o=r.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]),s=r.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]);await i(n.libCore(`routes.ts`),L,{apiRoutes:o,pageRoutes:s});for(let[e,r]of[[`config.ts`,he],[`types.ts`,_e],[`ssr.ts`,ge],[`index.ts`,I]])await i(n.libCore(e),r,{...t,apiRoutes:o,pageRoutes:s});for(let{kind:t,entry:a}of r)t===`apiRoute`&&await i(n.libApi(e(a.file),`schemas.ts`),Se,{route:a},{overwrite:!1})};return{start:s,watch:c,build:c,virtualModules(){let{createImport:e}=S(t);return[{specifier:`virtual:kosmo/backend-app`,csr:`export default undefined;`,ssr:o.some(e=>e.meta.slot===`backend`)?`export { default } from "${e.api([`app`],{origin:`lib`})}";`:`export default undefined;`}]}}}),B=_({meta:{name:`Core`},dependencies:{"path-to-regexp":me.devDependencies[`path-to-regexp`]},factory:Ce}),we={type:`module`,private:!0,name:`@kosmojs/fetch-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/fetch-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`},devDependencies:{"light-my-request":`^6.6.0`}},Te=`{{#each routes}}
 import {{id}} from "{{ createImport 'libApi' name 'fetch' }}";
 {{/each}}
 
@@ -18,10 +600,10 @@ export default {
 {{/each}}
 {{/each}}
 }
-`,N=`import fetchFactory, { join } from "@kosmojs/core/fetch";
+`,Ee=`import fetchFactory, { join } from "@kosmojs/core/fetch";
 
 import { base, apiBase, apiRouteMap } from "{{ createImport 'libCore' }}";
-import { transport } from "{{ createImport 'lib' '@fetch' }}";
+import { transport } from "virtual:kosmo/fetch-transport";
 
 import {
   type MaybeWrapped,
@@ -73,9 +655,7 @@ export const {{method}} = (
   _params{{#if ../route.optionalParams}}?{{/if}}: MaybeWrapped<ParamsT>,
   _payload?: {
     {{#each payloadTypes}}
-    {{target}}: {{id}} extends { {{method}}: unknown }
-      ? MaybeWrapped<{{id}}["{{method}}"]>
-      : unknown,
+    {{target}}: MaybeWrapped<{{id}}>,
     {{/each}}
   },
   opt?: {
@@ -104,27 +684,229 @@ export const {{method}} = (
         payloadResolver(payload as never, "{{target}}", "{{../method}}"),
       );
     }
-    {{/each}}
+    {{/each}}
+  }
+  return fetchApi.{{method}}(parametrize(params as never), payload as never);
+};
+{{/each}}
+
+export default {
+  {{#each routeMethods}}
+  {{method}},
+  {{/each}}
+  path,
+  href,
+  validationSchemas,
+};
+`,De=`import backend from "virtual:kosmo/backend-app";
+
+import {
+  redirectCodes,
+  ssrOrigin,
+  store,
+} from "{{ createImport 'libCore' 'ssr' }}";
+
+/**
+ * Maximum redirect hops, mirroring the fetch spec limit.
+ * */
+export const maxRedirects = 5;
+
+/**
+ * HeadersProvider for createTransport.
+ * */
+const headersProvider = () => {
+  return store.getStore()?.headers;
+};
+
+const createDispatch = (app) => {
+  return typeof app.fetch === "function"
+    ? app.fetch
+    : async (request) => {
+        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(), {
+          method: request.method,
+          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) => {
+  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
+     * on the call itself wins over forwarded values.
+     * */
+    const headers = new Headers(init?.headers);
+
+    // When the body is FormData, the Request constructor sets a multipart
+    // Content-Type with a fresh boundary. A forwarded Content-Type default would
+    // override that boundary and desync it from the serialized body, so never
+    // forward Content-Type for FormData bodies.
+    const isFormBody = init?.body instanceof FormData;
+
+    for (const [key, value] of new Headers(headersProvider() || undefined)) {
+      if (isFormBody && key.toLowerCase() === "content-type") {
+        continue;
+      }
+      if (!headers.has(key)) {
+        headers.set(key, value);
+      }
+    }
+
+    let request = new Request(new URL(String(input), ssrOrigin), {
+      ...init,
+      headers,
+    });
+
+    /**
+     * Bodies are buffered once so they can be replayed across
+     * 307/308 hops; the client only ever sends strings, FormData
+     * and buffer-ish payloads, so this is safe and cheap.
+     * */
+    const body = ["GET", "HEAD"].includes(request.method)
+      ? undefined
+      : await request.arrayBuffer();
+
+    for (let hop = 0; ; hop++) {
+      if (hop === maxRedirects) {
+        throw new TypeError("Failed to fetch: too many redirects");
+      }
+
+      const response = await dispatch(
+        body === undefined || request.method === "GET"
+          ? new Request(request, { body: null })
+          : new Request(request, { body }),
+      );
+
+      const location = response.headers.get("location");
+
+      if (!location || !redirectCodes.includes(response.status)) {
+        return response;
+      }
+
+      const method =
+        response.status === 303 ||
+        ([301, 302].includes(response.status) && request.method === "POST")
+          ? "GET"
+          : request.method;
+
+      request = new Request(new URL(location, request.url), {
+        method,
+        headers: request.headers,
+      });
+    }
+  };
+};
+
+const ssrTransport = backend ? createTransport(backend) : undefined;
+
+export const transport = ssrTransport
+  ? async (input, init) => {
+      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]) {
+    const pathname = pathnameOf(input);
+    const status = response.status ?? "unknown";
+    super(\`\${pathname}: \${status} [ \${message} ]\`.trim());
+    this.name = "SSRFetchError";
   }
-  return fetchApi.{{method}}(parametrize(params as never), payload as never);
-};
-{{/each}}
+}
 
-export default {
-  {{#each routeMethods}}
-  {{method}},
-  {{/each}}
-  path,
-  href,
-  validationSchemas,
+const pathnameOf = (input) => {
+  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);
 };
-`,P=`export type MaybeWrapped<T> = T;
+`,Oe=`export type MaybeWrapped<T> = T;
 export const unwrap = <T>(data: T) => data;
-`,F=g(e=>{let{createPath:t,createImportHelpers:n}=y(e),{renderToFile:r}=x({helpers:{...n({origin:`lib`}),...w()}}),i=async(e,n)=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]).sort(S);await r(t.lib(`fetch.ts`),M,{routes:i});for(let{kind:e,entry:i}of n)if(e===`apiRoute`){let e=[];for(let t of i.validationDefinitions)if(t.target===`response`)for(let{id:n,body:r,resolvedType:i}of t.variants)r&&e.push({id:n,target:t.target,method:t.method,resolvedType:i});else{let{id:n,resolvedType:r}=t.schema;e.push({id:n,target:t.target,method:t.method,resolvedType:r})}let n=i.methods.map(t=>({method:t,payloadTypes:e.filter(e=>e.method===t&&![`headers`,`cookies`,`response`].includes(e.target)),responseType:e.find(e=>e.target===`response`&&e.method===t)})),a=Object.values(e.reduce((e,{id:t,target:n,method:r,resolvedType:i})=>(n===`response`&&(e[r]||(e[r]={method:r,types:[]}),e[r].types.push({id:t,target:n,method:r,resolvedType:i})),e),{}));await r(t.libApi(i.name,`fetch.ts`),N,{route:i,validationTypes:e,routeMethods:n,responseTypes:a})}};return{async start(){for(let[e,n]of[[`unwrap.ts`,P],[`@fetch/transport.ts`,j],[`@fetch/index.ts`,A]])await r(t.lib(e),n,{})},async watch(e,t){await i(e,e.filter(p(t,[`create`,`update`])))},async build(e){await i(e,e)},async ssrBuild(){for(let[e,n]of[[`@fetch/transport.ts`,`export { transport } from "${l.libPrefix}/@ssr/fetch";`]])await r(t.lib(e),n,{})}}}),I=h({meta:{name:`Fetch`,slot:`fetch`},factory:F}),L={type:`module`,private:!0,name:`@kosmojs/h3-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/h3-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{h3:`2.0.1-rc.29`,vite:`^8.2.2`}},R=`import { H3, type Middleware } from "h3";
+`,ke=v(e=>{let{createPath:t,createImportHelpers:n}=S(e),{render:r,renderToFile:i}=w({helpers:{...n({origin:`lib`}),...A()}}),a=async(e,n)=>{let r=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]).sort(E);await i(t.lib(`fetch.ts`),Te,{routes:r});for(let{kind:e,entry:r}of n)if(e===`apiRoute`){let e=[];for(let t of r.validationDefinitions)if(t.target===`response`)for(let{id:n,status:r,body:i,resolvedType:a}of t.variants)!i||Math.floor(r/100)!==2||e.push({id:n,target:t.target,method:t.method,resolvedType:a});else{let{id:n,resolvedType:r}=t.schema;e.push({id:n,target:t.target,method:t.method,resolvedType:r})}let n=Object.keys(te),a=r.methods.flatMap(t=>n.includes(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)}]:[]),o=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 i(t.libApi(r.name,`fetch.ts`),Ee,{route:r,validationTypes:e,routeMethods:a,responseTypes:o})}};return{async start(){for(let[e,n]of[[`unwrap.ts`,Oe]])await i(t.lib(e),n,{})},async watch(e,t){await a(e,e.filter(h(t,[`create`,`update`])))},async build(e){await a(e,e)},virtualModules(){return[{specifier:`virtual:kosmo/fetch-transport`,csr:`export const transport = undefined;`,ssr:r(De,{})}]}}}),Ae=_({meta:{name:`Fetch`,slot:`fetch`},dependencies:{"light-my-request":we.devDependencies[`light-my-request`]},factory:ke}),je={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`}},Me=`import { H3, type Middleware } from "h3";
 
 import type { Route, RouteDebugOption } from "@kosmojs/core/api";
 
-export type App = H3;
+/**
+ * The interface is a nameable symbol of this module, emit stops here and never chases through to the class.
+ * */
+export interface App extends H3 {}
 
 export type AppOptions = ConstructorParameters<typeof H3>[0] & {
   debug?: RouteDebugOption;
@@ -168,23 +950,65 @@ export function appFactory(
     } 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, {
+
+    // last middleware is the handler
+    const handler = route.middleware.at(-1);
+
+    if (handler) {
+      app.on(route.method, route.path, handler as never, {
+        middleware: route.middleware.slice(0, -1),
+      });
+      if (
+        route.method === "GET" &&
+        !routes.some((e) => e.path === route.path && e.method === "HEAD")
+      ) {
+        /**
+         * Register HEAD against the sibling GET handler,
+         * matching the HEAD-via-GET dispatch hono and koa provide natively.
+         * */
+        app.on("HEAD", route.path, handler as never, {
           middleware: route.middleware.slice(0, -1),
         });
       }
     }
   }
 
+  const routesByPath = routes.reduce<Record<string, Array<Route<Middleware>>>>(
+    (map, route) => {
+      if (!map[route.path]) {
+        map[route.path] = [];
+      }
+      map[route.path].push(route);
+      return map;
+    },
+    {},
+  );
+
+  for (const [path, routes] of Object.entries(routesByPath)) {
+    const methods = routes.map((e) => e.method);
+
+    app.all(path, (event) => {
+      const allowedMethods = new Set([...methods, "OPTIONS"]);
+
+      if (methods.includes("GET")) {
+        allowedMethods.add("HEAD");
+      }
+
+      const status = event.req.method === "OPTIONS" ? 204 : 405;
+
+      return new Response(undefined, {
+        status,
+        headers: { Allow: [...allowedMethods].join(", ") },
+      });
+    });
+  }
+
   return app;
 }
-`,z=`import type { DevSetup } from "@kosmojs/core/api";
+`,Ne=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,B=`import { type H3Event, HTTPError } from "h3";
+`,Pe=`import { type H3Event, HTTPError } from "h3";
 
 import { ValidationError } from "@kosmojs/core/errors";
 
@@ -208,7 +1032,17 @@ export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
     );
   };
 };
-`,me=`import { type H3Event, readBody } from "h3";
+`,Fe=`import { createListener } from "./server";
+
+import app from "{{ createImport 'api' 'app' }}";
+
+/**
+ * Entry for the \`dist/<folder>/api/listener.js\` bundle.
+ * Exposes this folder's API as a plain node:http listener, mounted by \`dist/run.js\`
+ * next to the other folders. Nothing here listens on a port - \`server.ts\` does that.
+ * */
+export default createListener(app);
+`,Ie=`import { type H3Event, readBody } from "h3";
 
 import {
   parseCookies,
@@ -248,7 +1082,8 @@ export const bodyparsers: {
     return event.req.text();
   },
 };
-`,he=`import type { Middleware } from "h3";
+`,Le=`import { command } from "virtual:kosmo/env";
+import type { Middleware } from "h3";
 
 import type {
   RequestBodyTarget,
@@ -333,7 +1168,9 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                     target === "query"
                       ? normalizeSearchParams(
                           parser(event),
-                          event.req.method as never,
+                          event.req.method === "HEAD"
+                            ? "GET"
+                            : event.req.method,
                         )
                       : parser(event),
                   );
@@ -411,7 +1248,10 @@ export const createRouteMiddleware: CreateRouteMiddleware<
      * */
     use(
       async function useValidateResponse(event, next) {
-        const variants = validationSchemas.response?.[event.req.method] || [];
+        const variants =
+          validationSchemas.response?.[
+            event.req.method === "HEAD" ? "GET" : event.req.method
+          ] || [];
 
         if (!Array.isArray(variants) || !variants.length) {
           return next();
@@ -420,13 +1260,13 @@ export const createRouteMiddleware: CreateRouteMiddleware<
         // options are same for all variants
         const { runtimeValidation, customErrors } = variants[0];
 
-        if (KOSMO_PRODUCTION_BUILD) {
-          // skip if undefined or explicitly set to false
+        if (command === "build") {
+          // 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
+          // dev mode - skip only if explicitly set to false
           if (runtimeValidation === false) {
             return next();
           }
@@ -460,6 +1300,11 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                 : "application/json"),
         };
 
+        // validate only 2xx responses
+        if (Math.floor(response.status / 100) !== 2) {
+          return;
+        }
+
         // Validate body only for JSON variants
         if (variants.some((e) => e.contentType?.includes("json"))) {
           response.body = rawResponse
@@ -598,7 +1443,9 @@ export const createRouteMiddleware: CreateRouteMiddleware<
       use(
         async (event, next) => {
           const schema = {
-            ...validationSchemas[target]?.[event.req.method],
+            ...validationSchemas[target]?.[
+              event.req.method === "HEAD" ? "GET" : event.req.method
+            ],
           };
           if (schema.validate && schema.runtimeValidation !== false) {
             schema.validate(await loadData(event as never));
@@ -628,7 +1475,7 @@ export const routes = createRoutes<ParameterizedMiddleware, Middleware>(
     createRouteMiddleware,
   },
 );
-`,ge=`import { join } from "node:path";
+`,Re=`import { join } from "node:path";
 
 import type { RouteSource } from "@kosmojs/core/api";
 
@@ -680,12 +1527,25 @@ export const routeSources: Array<RouteSource<never>> = [
   },
   {{/each}}
 ];
-`,_e=`import { parseArgs, styleText } from "node:util";
+`,ze=`import type { IncomingMessage, ServerResponse } from "node:http";
+import { parseArgs, styleText } from "node:util";
 
 import { serve as h3serve } from "h3";
+import { toNodeHandler } from "h3/node";
 
 import type { App } from "./app";
 
+export type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
+
+/**
+ * Wrap the app into a node:http request listener.
+ * Used by dist/run.js to mount this folder's API next to other folders;
+ * the standalone server (\`serve\`) binds the app through h3's own adapter instead.
+ * */
+export const createListener = <T extends App>(app: T): NodeListener => {
+  return toNodeHandler(app);
+};
+
 type Handles = {
   port?: number | undefined;
   onListen?: () => Promise<void>;
@@ -728,7 +1588,7 @@ export const serve = async <T extends App>(app: T, opt?: Handles) => {
 
   return server as never;
 };
-`,ve=`import type { H3Event, H3EventContext } from "h3";
+`,Be=`import type { H3Event, H3EventContext } from "h3";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
 import {
@@ -875,22 +1735,22 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,ye=`export * from "./@api/app";
+`,Ve=`export * from "./@api/app";
 export { appFactory as default } from "./@api/app";
 export * from "./@api/dev";
 export * from "./@api/errors";
 export * from "./@api/router";
 export * from "./@api/routes";
 export * from "./@api/server";
-`,be=`import { onError } from "h3";
+`,He=`import { onError } from "h3";
 
-import appFactory, { routes, type App } from "{{ createImport 'lib' 'api:factory' }}";
+import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
 import defaultErrorHandler from "./errors";
 
 export default appFactory(routes, ({ app }) => {
   app.use(onError(defaultErrorHandler));
-}) as App;
-`,xe=`import { toNodeHandler } from "h3/node";
+});
+`,Ue=`import { toNodeHandler } from "h3/node";
 
 import app from "./app";
 
@@ -910,10 +1770,10 @@ process.on("unhandledRejection", (reason) => {
   console.error("Reason:", reason);
   process.exit(1);
 });
-`,Se=`export declare module "{{ createImport 'libApi' }}" {
+`,We=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultContext {}
 }
-`,Ce=`import { ValidationError } from "@kosmojs/core/errors";
+`,Ge=`import { ValidationError } from "@kosmojs/core/errors";
 import { HTTPError } from "h3";
 
 import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
@@ -939,14 +1799,14 @@ export default errorHandlerFactory(async (error, event) => {
         headers: { "Content-Type": "text/plain" },
       });
 });
-`,we=`import { defineRoute } from "{{ createImport 'libApi' }}";
+`,Ke=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (event) => {
     return "Automatically generated route";
   }),
 ]);
-`,Te=`import { use } from "{{ createImport 'libApi' }}";
+`,qe=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -955,11 +1815,11 @@ export default [
     return next();
   }),
 ];
-`,Ee=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+`,Je=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
 import app from "./app";
 
 await serve(app);
-`,De=`import { use } from "{{ createImport 'libApi' }}";
+`,Ye=`import { use } from "{{ createImport 'libApi' }}";
 
 /**
  * Define global middleware applied to all routes.
@@ -970,7 +1830,7 @@ export default [
     return next();
   }),
 ];
-`,Oe=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,d=c(n?.templates,we),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),d(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),Te,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,path:r.h3Pattern,basename:r.name,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:u(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,ge]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,ve],[`api:factory.ts`,ye],[`@api/app.ts`,R],[`@api/parsers.ts`,me],[`@api/dev.ts`,z],[`@api/errors.ts`,B],[`@api/router.ts`,he],[`@api/server.ts`,_e]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,be],[`dev.ts`,xe],[`errors.ts`,Ce],[`server.ts`,Ee],[`use.ts`,De],[`env.d.ts`,Se]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await f(e.filter(p(t,[`create`]))),await m(e)},async build(e){await f(e),await m(e)}}}),ke=h({meta:{name:`H3`,slot:`backend`},dependencies:{h3:L.devDependencies.h3},factory:Oe}),V={type:`module`,private:!0,name:`@kosmojs/hono-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/hono-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@hono/node-server":`^2.1.1`,hono:`^4.13.3`,vite:`^8.2.2`}},Ae=`import { Hono, type MiddlewareHandler } from "hono";
+`,Xe=v((e,n)=>{let{createPath:r,createImportHelpers:i}=S(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=w({helpers:{...i({origin:`lib`}),...A(),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}=w({helpers:i({origin:`src`})}),c=e=>e?.trim().length===0,u=l(n?.templates,Ke),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:c}):t===`apiUse`&&await s(r.api(n.file),qe,{},{overwrite:c})},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=C(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${j(e)}`,alias:f(n),pathTokens:n}]:[]})]}).sort(E);for(let[e,t]of[[`@api/routes.ts`,Re]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{async start(){for(let[e,t]of[[`api.ts`,Be],[`api:factory.ts`,Ve],[`@api/app.ts`,Me],[`@api/parsers.ts`,Ie],[`@api/dev.ts`,Ne],[`@api/errors.ts`,Pe],[`@api/listener.ts`,Fe],[`@api/router.ts`,Le],[`@api/server.ts`,ze]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,He],[`dev.ts`,Ue],[`errors.ts`,Ge],[`server.ts`,Je],[`use.ts`,Ye],[`env.d.ts`,We]])await s(r.api(e),t,{},{overwrite:c})},async watch(e,t){await d(e.filter(h(t,[`create`]))),await p(e)},async build(e){await d(e),await p(e)}}}),Ze=_({meta:{name:`H3`,slot:`backend`},dependencies:{h3:je.devDependencies.h3},factory:Xe}),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`}},Qe=`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";
@@ -1037,15 +1897,45 @@ export function appFactory(
     } else if (debug) {
       console.log(route.debug[typeof debug === "string" ? debug : "full"]);
     }
-    app.on(route.methods, [route.path], ...route.middleware);
+
+    app.on(route.method, [route.path], ...route.middleware);
+  }
+
+  const routesByPath = routes.reduce<
+    Record<string, Array<Route<MiddlewareHandler>>>
+  >((map, route) => {
+    if (!map[route.path]) {
+      map[route.path] = [];
+    }
+    map[route.path].push(route);
+    return map;
+  }, {});
+
+  for (const [path, routes] of Object.entries(routesByPath)) {
+    const methods = routes.map((e) => e.method);
+
+    app.all(path, (ctx) => {
+      const allowedMethods = new Set([...methods, "OPTIONS"]);
+
+      if (methods.includes("GET")) {
+        allowedMethods.add("HEAD");
+      }
+
+      const status = ctx.req.method === "OPTIONS" ? 204 : 405;
+
+      return new Response(undefined, {
+        status,
+        headers: { Allow: [...allowedMethods].join(", ") },
+      });
+    });
   }
 
   return app as never;
 }
-`,je=`import type { DevSetup } from "@kosmojs/core/api";
+`,$e=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,Me=`import type { Context } from "hono";
+`,et=`import type { Context } from "hono";
 
 import type { AppEnv } from "./app";
 
@@ -1059,7 +1949,17 @@ export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,Ne=`import type { Context } from "hono";
+`,tt=`import { createListener } from "./server";
+
+import app from "{{ createImport 'api' 'app' }}";
+
+/**
+ * Entry for the \`dist/<folder>/api/listener.js\` bundle.
+ * Exposes this folder's API as a plain node:http listener, mounted by \`dist/run.js\`
+ * next to the other folders. Nothing here listens on a port - \`server.ts\` does that.
+ * */
+export default createListener(app);
+`,nt=`import type { Context } from "hono";
 
 import {
   parseCookies,
@@ -1108,7 +2008,8 @@ export const bodyparsers: {
     return ctx.req[as]();
   },
 };
-`,Pe=`import type { MiddlewareHandler } from "hono";
+`,rt=`import { command } from "virtual:kosmo/env";
+import type { MiddlewareHandler } from "hono";
 
 import type {
   RequestBodyTarget,
@@ -1194,7 +2095,7 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                     target === "query"
                       ? normalizeSearchParams(
                           parser(ctx),
-                          ctx.req.method as never,
+                          ctx.req.method === "HEAD" ? "GET" : ctx.req.method,
                         )
                       : parser(ctx),
                   );
@@ -1274,7 +2175,10 @@ export const createRouteMiddleware: CreateRouteMiddleware<
      * */
     use(
       async function useValidateResponse(ctx, next) {
-        const variants = validationSchemas.response?.[ctx.req.method] || [];
+        const variants =
+          validationSchemas.response?.[
+            ctx.req.method === "HEAD" ? "GET" : ctx.req.method
+          ] || [];
 
         if (!Array.isArray(variants) || !variants.length) {
           return next();
@@ -1283,13 +2187,13 @@ export const createRouteMiddleware: CreateRouteMiddleware<
         // options are same for all variants
         const { runtimeValidation, customErrors } = variants[0];
 
-        if (KOSMO_PRODUCTION_BUILD) {
-          // skip if undefined or explicitly set to false
+        if (command === "build") {
+          // 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
+          // dev mode - skip only if explicitly set to false
           if (runtimeValidation === false) {
             return next();
           }
@@ -1307,10 +2211,17 @@ export const createRouteMiddleware: CreateRouteMiddleware<
           contentType: ctx.res.headers.get("Content-Type"),
         };
 
+        // validate only 2xx responses
+        if (Math.floor(response.status / 100) !== 2) {
+          return;
+        }
+
         // Validate body only for JSON variants
         if (variants.some((e) => e.contentType?.includes("json"))) {
-          const cloned = ctx.res.clone();
-          response.body = await cloned.json();
+          response.body = await ctx.res
+            .clone()
+            .json()
+            .catch(() => undefined);
         }
 
         /**
@@ -1445,7 +2356,9 @@ export const createRouteMiddleware: CreateRouteMiddleware<
       use(
         async (ctx, next) => {
           const schema = {
-            ...validationSchemas[target]?.[ctx.req.method],
+            ...validationSchemas[target]?.[
+              ctx.req.method === "HEAD" ? "GET" : ctx.req.method
+            ],
           };
           if (schema.validate && schema.runtimeValidation !== false) {
             schema.validate(await loadData(ctx as never));
@@ -1475,7 +2388,7 @@ export const routes = createRoutes<ParameterizedMiddleware, MiddlewareHandler>(
     createRouteMiddleware,
   },
 );
-`,Fe=`import { join } from "node:path";
+`,it=`import { join } from "node:path";
 
 import type { RouteSource } from "@kosmojs/core/api";
 
@@ -1527,13 +2440,25 @@ export const routeSources: Array<RouteSource<never>> = [
   },
   {{/each}}
 ];
-`,Ie=`import { chmod, unlink } from "node:fs/promises";
+`,at=`import { chmod, unlink } from "node:fs/promises";
+import type { IncomingMessage, ServerResponse } from "node:http";
 import { parseArgs, styleText } from "node:util";
 
-import { createAdaptorServer } from "@hono/node-server";
+import { createAdaptorServer, getRequestListener } from "@hono/node-server";
 
 import type { App } from "./app";
 
+export type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
+
+/**
+ * Wrap the app into a node:http request listener.
+ * Used by dist/run.js to mount this folder's API next to other folders;
+ * the standalone server (\`serve\`) binds the app through the runtime's native adapter instead.
+ * */
+export const createListener = <T extends App>(app: T): NodeListener => {
+  return getRequestListener(app.fetch);
+};
+
 type Handles = {
   port?: number | undefined;
   sock?: string | undefined;
@@ -1612,7 +2537,7 @@ export const serve = async <T extends App>(app: T, opt?: Handles) => {
 
   return server as never;
 };
-`,Le=`import type { Context, Next } from "hono";
+`,ot=`import type { Context, Next } from "hono";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
 import {
@@ -1795,20 +2720,20 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,Re=`export * from "./@api/app";
+`,st=`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";
-`,ze=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
+`,ct=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
 import defaultErrorHandler from "./errors";
 
 export default appFactory(routes, ({ app }) => {
   app.onError(defaultErrorHandler);
 })
-`,Be=`import { getRequestListener } from "@hono/node-server";
+`,lt=`import { getRequestListener } from "@hono/node-server";
 
 import app from "./app";
 
@@ -1829,11 +2754,11 @@ process.on("unhandledRejection", (reason) => {
   process.exit(1);
 });
 
-`,Ve=`export declare module "{{ createImport 'libApi' }}" {
+`,ut=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultVariables {}
   interface DefaultBindings {}
 }
-`,He=`import { accepts } from "hono/accepts";
+`,dt=`import { accepts } from "hono/accepts";
 import { HTTPException } from "hono/http-exception";
 
 import { ValidationError, HTTPError } from "@kosmojs/core/errors";
@@ -1865,7 +2790,7 @@ export default errorHandlerFactory(async (error, ctx) => {
     ? ctx.json({ error: message }, status)
     : ctx.text(message, status);
 });
-`,Ue=`import { defineRoute } from "{{ createImport 'libApi' }}";
+`,ft=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (ctx) => {
@@ -1874,7 +2799,7 @@ export default defineRoute<"{{route.name}}">(({ GET }) => [
     return ctx.text("Automatically generated route");
   }),
 ]);
-`,We=`import { use } from "{{ createImport 'libApi' }}";
+`,pt=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -1885,11 +2810,11 @@ export default [
     return next();
   }),
 ];
-`,Ge=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+`,mt=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
 import app from "./app";
 
 await serve(app);
-`,Ke=`import { use } from "{{ createImport 'libApi' }}";
+`,ht=`import { use } from "{{ createImport 'libApi' }}";
 
 /**
  * Define global middleware applied to all routes.
@@ -1900,7 +2825,9 @@ export default [
     return next();
   }),
 ];
-`,qe=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,Ue),f=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),u(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),We,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,path:r.honoPattern,basename:r.name,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:d(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,Fe]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,Le],[`api:factory.ts`,Re],[`@api/app.ts`,Ae],[`@api/parsers.ts`,Ne],[`@api/dev.ts`,je],[`@api/errors.ts`,Me],[`@api/router.ts`,Pe],[`@api/server.ts`,Ie]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,ze],[`dev.ts`,Be],[`errors.ts`,He],[`server.ts`,Ge],[`use.ts`,Ke],[`env.d.ts`,Ve]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await f(e.filter(p(t,[`create`]))),await m(e)},async build(e){await f(e),await m(e)}}}),Je=h({meta:{name:`Hono`,slot:`backend`},dependencies:{hono:V.devDependencies.hono,"@hono/node-server":V.devDependencies[`@hono/node-server`]},factory:qe}),H={type:`module`,private:!0,name:`@kosmojs/koa-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`},"./lib":{types:`./pkg/lib.d.ts`,default:`./pkg/lib.js`}},scripts:{build:`wsbuild src/index.ts src/lib.ts`,test:`vitest --root ../.. --project generators/koa-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`},devDependencies:{"@koa/router":`^15.7.0`,"@types/formidable":`^3.5.1`,"@types/koa":`^3.0.3`,"@types/koa-compose":`^3.2.9`,formidable:`^3.5.4`,koa:`^3.2.1`,"koa-compose":`^4.1.0`,"light-my-request":`^6.6.0`,"raw-body":`^4.0.0`,vite:`^8.2.2`}},Ye=`import Router, { type RouterMiddleware } from "@koa/router";
+`,gt=v((e,n)=>{let{createPath:r,createImportHelpers:i}=S(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=w({helpers:{...i({origin:`lib`}),...A(),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}=w({helpers:i({origin:`src`})}),c=e=>e?.trim().length===0,u=l(n?.templates,ft),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:c}):t===`apiUse`&&await s(r.api(n.file),pt,{},{overwrite:c})},f=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=C(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${j(e)}`,alias:p(n),pathTokens:n}]:[]})]}).sort(E);for(let[e,t]of[[`@api/routes.ts`,it]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{async start(){for(let[e,t]of[[`api.ts`,ot],[`api:factory.ts`,st],[`@api/app.ts`,Qe],[`@api/parsers.ts`,nt],[`@api/dev.ts`,$e],[`@api/errors.ts`,et],[`@api/listener.ts`,tt],[`@api/router.ts`,rt],[`@api/server.ts`,at]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,ct],[`dev.ts`,lt],[`errors.ts`,dt],[`server.ts`,mt],[`use.ts`,ht],[`env.d.ts`,ut]])await s(r.api(e),t,{},{overwrite:c})},async watch(e,t){await d(e.filter(h(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)}}}),_t=_({meta:{name:`Hono`,slot:`backend`},dependencies:{hono:V.devDependencies.hono,"@hono/node-server":V.devDependencies[`@hono/node-server`]},factory:gt}),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`}},vt=`import { styleText } from "node:util";
+
+import Router, { type RouterMiddleware } from "@koa/router";
 import Koa from "koa";
 
 import type { Route, RouteDebugOption } from "@kosmojs/core/api";
@@ -1911,7 +2838,7 @@ export type App = Koa<DefaultState, DefaultContext>;
 
 export type AppOptions = ConstructorParameters<
   typeof Koa<DefaultState, DefaultContext>
->[0] & { router?: Router; debug?: RouteDebugOption };
+>[0] & { debug?: RouteDebugOption };
 
 export function appFactory(
   routes: Array<Route<RouterMiddleware>>,
@@ -1935,51 +2862,98 @@ export function appFactory(
 ): App {
   const [options, fn] = typeof rest[0] === "function" ? [{}, rest[0]] : rest;
 
-  const {
-    router = new Router(),
-    debug = undefined,
-    ...appOptions
-  } = {
+  const { debug = undefined, ...appOptions } = {
     ...(options ? { ...options } : {}),
   };
 
+  const app = new Koa(appOptions);
+  const router = new 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"]);
     }
-    router.register(route.path, route.methods, route.middleware, route);
+    router.register(route.path, [route.method], route.middleware, route);
   }
 
-  const app = new Koa(appOptions);
+  const routesByPath = routes.reduce<
+    Record<string, Array<Route<RouterMiddleware>>>
+  >((map, route) => {
+    if (!map[route.path]) {
+      map[route.path] = [];
+    }
+    map[route.path].push(route);
+    return map;
+  }, {});
+
+  for (const [path, routes] of Object.entries(routesByPath)) {
+    const methods = routes.map((e) => e.method);
+
+    if (
+      methods.includes("GET") &&
+      methods.indexOf("HEAD") > methods.indexOf("GET")
+    ) {
+      console.warn("----");
+      console.warn(
+        \`\${styleText("yellow", "WARN")}: HEAD handler for \${styleText("blue", routes[0].name)} route is unreachable - \${styleText("magenta", "define HEAD before GET")}\`,
+      );
+      console.warn("----");
+    }
+
+    router.all(path, (ctx) => {
+      const allowedMethods = new Set([...methods, "OPTIONS"]);
+
+      if (methods.includes("GET")) {
+        allowedMethods.add("HEAD");
+      }
+
+      ctx.status = ctx.method === "OPTIONS" ? 204 : 405;
+
+      ctx.set("Allow", [...allowedMethods].join(", "));
+    });
+  }
 
   if (typeof fn === "function") {
     fn({ app, router });
   }
 
+  // NOTE: Routes should be added last, after any middleware
+  app.use(router.routes());
+
   return app;
 }
-`,Xe=`import type { DevSetup } from "@kosmojs/core/api";
+`,yt=`import type { DevSetup } from "@kosmojs/core/api";
 
 export const devSetup = (setup: DevSetup) => setup;
-`,Ze=`import type {
+`,bt=`import type {
   DefaultContext,
   DefaultState,
   ParameterizedContext,
 } from "../api";
 
 type ErrorHandler = (
-  error: any,
   ctx: ParameterizedContext<unknown, DefaultState, DefaultContext>,
-) => Promise<void> | void;
+  next: Function,
+) => Promise<void>;
 
 export type ErrorHandlerFactory = (handler: ErrorHandler) => ErrorHandler;
 
 export const errorHandlerFactory: ErrorHandlerFactory = (handler) => {
   return handler;
 };
-`,Qe=`import zlib from "node:zlib";
+`,xt=`import { createListener } from "./server";
+
+import app from "{{ createImport 'api' 'app' }}";
+
+/**
+ * Entry for the \`dist/<folder>/api/listener.js\` bundle.
+ * Exposes this folder's API as a plain node:http listener, mounted by \`dist/run.js\`
+ * next to the other folders. Nothing here listens on a port - \`server.ts\` does that.
+ * */
+export default createListener(app);
+`,St=`import zlib from "node:zlib";
 
 import type { RouterContext } from "@koa/router";
 import Formidable, { type Options as FormidableOptions } from "formidable";
@@ -2192,7 +3166,8 @@ export const bodyparsers: {
     return rawParser(stream, rawParserOptions);
   },
 };
-`,$e=`import type { RouterMiddleware } from "@koa/router";
+`,Ct=`import { command } from "virtual:kosmo/env";
+import type { RouterMiddleware } from "@koa/router";
 
 import type {
   RequestBodyTarget,
@@ -2276,7 +3251,10 @@ export const createRouteMiddleware: CreateRouteMiddleware<
                   ctx[StateKey].set(
                     target,
                     target === "query"
-                      ? normalizeSearchParams(parser(ctx), ctx.method as never)
+                      ? normalizeSearchParams(
+                          parser(ctx),
+                          ctx.method === "HEAD" ? "GET" : ctx.method,
+                        )
                       : parser(ctx),
                   );
                 }
@@ -2355,7 +3333,10 @@ export const createRouteMiddleware: CreateRouteMiddleware<
      * */
     use(
       async function useValidateResponse(ctx, next) {
-        const variants = validationSchemas.response?.[ctx.method] || [];
+        const variants =
+          validationSchemas.response?.[
+            ctx.method === "HEAD" ? "GET" : ctx.method
+          ] || [];
 
         if (!Array.isArray(variants) || !variants.length) {
           return next();
@@ -2364,13 +3345,13 @@ export const createRouteMiddleware: CreateRouteMiddleware<
         // options are same for all variants
         const { runtimeValidation, customErrors } = variants[0];
 
-        if (KOSMO_PRODUCTION_BUILD) {
-          // skip if undefined or explicitly set to false
+        if (command === "build") {
+          // 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
+          // dev mode - skip only if explicitly set to false
           if (runtimeValidation === false) {
             return next();
           }
@@ -2389,6 +3370,11 @@ export const createRouteMiddleware: CreateRouteMiddleware<
           contentType: ctx.type,
         };
 
+        // validate only 2xx responses
+        if (Math.floor(response.status / 100) !== 2) {
+          return;
+        }
+
         // Validate body only for JSON variants
         if (variants.some((e) => e.contentType?.includes("json"))) {
           response.body = ctx.body;
@@ -2527,7 +3513,9 @@ export const createRouteMiddleware: CreateRouteMiddleware<
       use(
         async (ctx, next) => {
           const schema = {
-            ...validationSchemas[target]?.[ctx.method],
+            ...validationSchemas[target]?.[
+              ctx.method === "HEAD" ? "GET" : ctx.method
+            ],
           };
           if (schema.validate && schema.runtimeValidation !== false) {
             schema.validate(await loadData(ctx as never));
@@ -2557,7 +3545,7 @@ export const routes = createRoutes<ParameterizedMiddleware, RouterMiddleware>(
     createRouteMiddleware,
   },
 );
-`,et=`import { join } from "node:path";
+`,wt=`import { join } from "node:path";
 
 import type { RouteSource } from "@kosmojs/core/api";
 
@@ -2609,11 +3597,23 @@ export const routeSources: Array<RouteSource<never>> = [
   },
   {{/each}}
 ];
-`,tt=`import { chmod, unlink } from "node:fs/promises";
+`,Tt=`import { chmod, unlink } from "node:fs/promises";
+import type { IncomingMessage, ServerResponse } from "node:http";
 import { parseArgs, styleText } from "node:util";
 
 import type { App } from "./app";
 
+export type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
+
+/**
+ * Wrap the app into a node:http request listener.
+ * Used by dist/run.js to mount this folder's API next to other folders;
+ * the standalone server (\`serve\`) calls app.listen() directly instead.
+ * */
+export const createListener = <T extends App>(app: T): NodeListener => {
+  return app.callback();
+};
+
 type Handles = {
   port?: number | undefined;
   sock?: string | undefined;
@@ -2672,7 +3672,7 @@ export const serve = async <T extends App>(app: T, opt?: Handles) => {
   const server = app.listen(port || sock, onListen);
   return server as never;
 };
-`,nt=`import type { RouterContext } from "@koa/router";
+`,Et=`import type { RouterContext } from "@koa/router";
 import type { Next } from "koa";
 
 import type { ValidationDefmap, ValidationOptmap } from "@kosmojs/core";
@@ -2834,25 +3834,20 @@ export const defineRoute: <
     use: use as never,
   });
 };
-`,rt=`export * from "./@api/app";
+`,Dt=`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";
-`,it=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
+`,Ot=`import appFactory, { routes } from "{{ createImport 'lib' 'api:factory' }}";
 import defaultErrorHandler from "./errors";
 
-export default appFactory(routes, ({ app, router }) => {
-
-  app.on("error", defaultErrorHandler);
-
-  // NOTE: Routes should be added last, after any middleware
-  app.use(router.routes());
-
-});
-`,at=`import app from "./app";
+export default appFactory(routes, ({ app }) => {
+  app.use(defaultErrorHandler);
+})
+`,kt=`import app from "./app";
 
 import { devSetup } from "{{ createImport 'lib' 'api:factory' }}";
 
@@ -2870,39 +3865,43 @@ process.on("unhandledRejection", (reason) => {
   console.error("Reason:", reason);
   process.exit(1);
 });
-`,ot=`export declare module "{{ createImport 'libApi' }}" {
+`,At=`export declare module "{{ createImport 'libApi' }}" {
   interface DefaultState {}
   interface DefaultContext {}
 }
-`,st=`import { HTTPError, ValidationError } from "@kosmojs/core/errors";
+`,jt=`import { HTTPError, ValidationError } from "@kosmojs/core/errors";
 
 import { errorHandlerFactory } from "{{ createImport 'lib' 'api:factory' }}";
 
-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;
+export default errorHandlerFactory(async (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;
+    }
   }
 });
-`,ct=`import { defineRoute } from "{{ createImport 'libApi' }}";
+`,Mt=`import { defineRoute } from "{{ createImport 'libApi' }}";
 
 export default defineRoute<"{{route.name}}">(({ GET }) => [
   GET(async (ctx) => {
     ctx.body = "Automatically generated route";
   }),
 ]);
-`,lt=`import { use } from "{{ createImport 'libApi' }}";
+`,Nt=`import { use } from "{{ createImport 'libApi' }}";
 
 export type UseT = {};
 
@@ -2913,11 +3912,11 @@ export default [
     return next();
   }),
 ];
-`,ut=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
+`,Pt=`import { serve } from "{{ createImport 'lib' 'api:factory' }}";
 import app from "./app";
 
 await serve(app);
-`,dt=`import { use } from "{{ createImport 'libApi' }}";
+`,Ft=`import { use } from "{{ createImport 'libApi' }}";
 
 /**
  * Define global middleware applied to all routes.
@@ -2928,17 +3927,17 @@ export default [
     return next();
   }),
 ];
-`,ft=g((e,n)=>{let{createPath:r,createImportHelpers:i}=y(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=x({helpers:{...i({origin:`lib`}),...w(),paramsDefaults({params:e}){return`[${e.schema.map(()=>`unknown?`).join(`, `)}]`},paramsMappings({params:e}){return`[${e.schema.map(({name:e,kind:t})=>`["${e}", unknown, ${t===`required`?`true`:`false`}]`).join(`, `)}]`},cascadingState({cascadingMiddleware:e}){return a(e.map(({id:e})=>`UseT${e}`))}}}),{renderToFile:s}=x({helpers:i({origin:`src`})}),l=e=>e?.trim().length===0,u=c(n?.templates,ct),d=async e=>{for(let{kind:t,entry:n}of e)t===`apiRoute`?await s(r.api(n.file),u(n.name,n),{route:n},{overwrite:l}):t===`apiUse`&&await s(r.api(n.file),lt,{},{overwrite:l})},m=async e=>{let i=e.flatMap(({kind:e,entry:t})=>e===`apiUse`?[t]:[]),a=e.flatMap(({kind:e,entry:r})=>{if(e!==`apiRoute`)return[];let a=r.name.split(`/`).reduce((e,n)=>{let r=e[e.length-1];return e.push(r?t(r,n):n),e},[]),o={...r,basename:r.name,path:r.pathPattern,cascadingMiddleware:i.flatMap(e=>a.some(t=>e.name===t)?[e]:[])};return[o,...Object.entries({...n?.alias}).flatMap(([e,t])=>{let n=b(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${T(e)}`,alias:f(n),pathTokens:n}]:[]})]}).sort(S);for(let[e,t]of[[`@api/routes.ts`,et]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{config({command:e}){return{define:{KOSMO_PRODUCTION_BUILD:e===`build`?`true`:`false`}}},async start(){for(let[e,t]of[[`api.ts`,nt],[`api:factory.ts`,rt],[`@api/app.ts`,Ye],[`@api/dev.ts`,Xe],[`@api/errors.ts`,Ze],[`@api/parsers.ts`,Qe],[`@api/router.ts`,$e],[`@api/server.ts`,tt]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,it],[`dev.ts`,at],[`errors.ts`,st],[`server.ts`,ut],[`use.ts`,dt],[`env.d.ts`,ot]])await s(r.api(e),t,{},{overwrite:l})},async watch(e,t){await d(e.filter(p(t,[`create`]))),await m(e)},async build(e){await d(e),await m(e)}}}),pt=h({meta:{name:`Koa`,slot:`backend`,types:[`@types/koa`]},dependencies:{koa:H.devDependencies.koa,"@koa/router":H.devDependencies[`@koa/router`],formidable:H.devDependencies.formidable,"raw-body":H.devDependencies[`raw-body`]},devDependencies:{"@types/koa":H.devDependencies[`@types/koa`],"@types/formidable":H.devDependencies[`@types/formidable`]},factory:ft}),U={type:`module`,private:!0,name:`@kosmojs/mdx-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@mdx-js/rollup":`^3.1.1`,vite:`^8.2.2`},devDependencies:{"@mdx-js/mdx":`^3.1.1`,"@mdx-js/preact":`^3.1.1`,"path-to-regexp":`^8.4.2`,preact:`^10.29.8`,"preact-render-to-string":`^6.7.0`,"remark-frontmatter":`^5.0.0`,"remark-mdx-frontmatter":`^5.2.0`}},mt=()=>{let e=[`🎉 Well done! You just created a new MDX page.`,`🚀 Success! A fresh MDX page is ready to roll.`,`🌟 Nice work! Another MDX page added to your site.`,`🧩 All set! A new MDX page has been scaffolded.`,`🔧 Scaffold complete! Your new MDX page is in place.`,`✅ Built! Your MDX page is scaffolded and ready.`,`✨ Fantastic! Your new MDX page is good to go.`,`🎯 Nailed it! A brand new MDX page just landed.`,`💫 Awesome! Another MDX page joins the party.`,`⚡ Lightning fast! A new MDX page created successfully.`];return e[Math.floor(Math.random()*e.length)]},ht=(e,t,n)=>{let{remarkPlugins:r=[],rehypePlugins:i=[]}={...n},a=()=>{let t=[`${l.srcDir}/${e.name}/${l.entryDir}/client.ts`].map(e=>re(e)),n=e=>t.some(t=>t(e));return{name:`kosmo:mdx[hmr]`,enforce:`post`,transform(e,t){if(!(!n(t)||e.includes(`import.meta.hot.accept`)))return{code:[e,`
+`,It=v((e,n)=>{let{createPath:r,createImportHelpers:i}=S(e),a=e=>e.length===0?`{}`:e.length===1?e[0]:`Override<${e[0]}, ${a(e.slice(1))}>`,{renderToFile:o}=w({helpers:{...i({origin:`lib`}),...A(),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}=w({helpers:i({origin:`src`})}),c=e=>e?.trim().length===0,u=l(n?.templates,Mt),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:c}):t===`apiUse`&&await s(r.api(n.file),Nt,{},{overwrite:c})},f=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=C(e);return t===r.name?[{...o,name:e,basename:r.name,id:`${o.id}_${j(e)}`,alias:m(n),pathTokens:n}]:[]})]}).sort(E);for(let[e,t]of[[`@api/routes.ts`,wt]])await o(r.lib(e),t,{routes:a,cascadingMiddleware:i})};return{async start(){for(let[e,t]of[[`api.ts`,Et],[`api:factory.ts`,Dt],[`@api/app.ts`,vt],[`@api/dev.ts`,yt],[`@api/errors.ts`,bt],[`@api/listener.ts`,xt],[`@api/parsers.ts`,St],[`@api/router.ts`,Ct],[`@api/server.ts`,Tt]])await o(r.lib(e),t,{});for(let[e,t]of[[`app.ts`,Ot],[`dev.ts`,kt],[`errors.ts`,jt],[`server.ts`,Pt],[`use.ts`,Ft],[`env.d.ts`,At]])await s(r.api(e),t,{},{overwrite:c})},async watch(e,t){await d(e.filter(h(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)}}}),Lt=_({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:It}),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`}},Rt=()=>{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)]},zt=(e,t,n)=>{let{remarkPlugins:r=[],rehypePlugins:i=[]}={...n},a=()=>{let t=[`${u.srcDir}/${e.name}/${u.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},gt=`import type { FunctionComponent } from "preact";
+`)}}}},o=[ne({jsxImportSource:`preact`,providerImportSource:`@mdx-js/preact`,remarkPlugins:r,rehypePlugins:i})];return t===`serve`&&o.push(a()),o},Bt=`import type { FunctionComponent } from "preact";
 
 export const AppProvider: FunctionComponent = (props) => {
   return props.children;
 };
-`,_t=`import { render, hydrate as hydrateOrig } from "preact";
+`,Vt=`import { render, hydrate as hydrateOrig } from "preact";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -2979,7 +3978,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,vt=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
+`,Ht=`import { renderToString as renderToStringOrig } from "preact-render-to-string";
 
 import type {
   RenderToStringWrapper,
@@ -3053,7 +4052,7 @@ export const renderToString: RenderToStringWrapper<
 }
 
 export default serverRenderFactory<false>();
-`,yt=`declare module "*.mdx" {
+`,Ut=`declare module "*.mdx" {
   import type { ComponentType } from "preact";
   export const frontmatter: Record<string, unknown>;
   const component: ComponentType;
@@ -3066,7 +4065,7 @@ declare module "*.md" {
   const component: ComponentType;
   export default component;
 }
-`,bt=`import { MDXProvider } from "@mdx-js/preact";
+`,Wt=`import { MDXProvider } from "@mdx-js/preact";
 import { match, pathToRegexp } from "path-to-regexp";
 import { type ComponentType, createContext, h, type VNode } from "preact";
 
@@ -3077,7 +4076,6 @@ import { base } from "{{ createImport 'libCore' }}";
 
 export type RawRoute = {
   name: string;
-  pathSegments: number | undefined;
   regexp: RegExp;
   extractParams: (path: string) => Route["params"];
   loader: () => Promise<RouteModule>;
@@ -3145,23 +4143,20 @@ 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
-      const matchedRoutes = routes.filter(({ regexp }) => {
-        return regexp.test(url.pathname);
-      });
 
+      // The routes array is generated pre-sorted by specificity
+      // (static beats required beats optional beats splat, token by token),
+      // the same ordering the SSR server registers routes in -
+      // so the first pattern that matches IS the most specific one,
+      // and CSR resolution stays consistent with SSR.
+      // A route with optional parameters matches a range of segment counts,
+      // which is why no segment-count heuristic can disambiguate here.
+      // Lightweight \`RegExp.test()\` on linear scan - no capture allocation.
       const matchedRoute =
-        matchedRoutes.length > 1
-          ? matchedRoutes.find(({ pathSegments }) => {
-              return pathSegments === undefined || pathSegments === urlSegments;
-            }) || catchallRoute
-          : matchedRoutes.length === 1
-            ? matchedRoutes[0]
-            : catchallRoute;
-
-      // 2: capture params only on matched route
+        routes.find(({ regexp }) => {
+          return regexp.test(url.pathname);
+        }) || catchallRoute;
+
       const params = matchedRoute
         ? matchedRoute.extractParams(url.pathname)
         : {};
@@ -3255,11 +4250,6 @@ export const createRoute = (
   return {
     name,
     regexp,
-    // count segments of the same base-joined path the regexp matches against;
-    // resolve() compares this against the full url pathname's segment count
-    pathSegments: name.includes("...")
-      ? undefined
-      : path.split("/").filter(Boolean).length,
     extractParams: (path) => {
       const match = matcher(path);
       return match ? match.params : {};
@@ -3268,7 +4258,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,xt=`/* @jsxImportSource preact */
+`,Gt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -3309,7 +4299,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,St=`/* @jsxImportSource preact */
+`,Kt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -3361,7 +4351,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,Ct=`* {
+`,qt=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -3496,7 +4486,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,wt=`/* @jsxImportSource preact */
+`,Jt=`/* @jsxImportSource preact */
 
 import styles from "./styles.module.css";
 
@@ -3562,7 +4552,7 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,Tt=`export type ParamsMap = {
+`,Yt=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -3571,7 +4561,7 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,Et=`import type { ComponentType } from "preact";
+`,Xt=`import type { ComponentType } from "preact";
 
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
@@ -3585,107 +4575,37 @@ import {
 
 export const createRouters = (
   routes: Array<RawRoute>,
-  {
-    app,
-    components,
-  }: {
-    app: ComponentType;
-    components: Record<string, ComponentType<never>>;
-  },
-): {
-  clientRouter: () => RouterFactoryReturn<Promise<RouteComponent>>;
-  serverRouter: (
-    url: URL,
-  ) => RouterFactoryReturn<Promise<RouteComponent>, { route: Route }>;
-} => {
-  const router = createRouter(routes, app, { components });
-
-  return {
-    clientRouter() {
-      return router.resolve();
-    },
-    serverRouter(url) {
-      return router.resolve(url);
-    },
-  };
-};
-
-export default createRouterFactory<
-  RawRoute,
-  Promise<RouteComponent>,
-  { server: { route: Route } }
->();
-`,Dt=`import { join } from "node:path";
-
-import { compile } from "path-to-regexp";
-
-import type { PageRoute } from "@kosmojs/core";
-
-import routes from "{{ createImport 'lib' 'ssg:routes' }}";
-import { base } from "{{ createImport 'libCore' }}";
-
-const paramsMapper = (params: PageRoute["params"], value: Array<unknown>) => {
-  return params.schema.reduce<Record<string, unknown>>(
-    (map, { name, kind }, i) => {
-      if (kind === "splat") {
-        if (Array.isArray(value[i]) && value[i].length) {
-          map[name] = value[i].map(String);
-        }
-      } else if (value[i] !== undefined) {
-        map[name] = String(value[i]);
-      }
-      return map;
-    },
-    {},
-  );
-};
-
-export default Object.entries(routes)
-  .flatMap(([name, { pathPattern, params, frontmatter }]) => {
-    if (!params.schema.length || Array.isArray(frontmatter?.staticParams)) {
-      if (params.schema.length) {
-        const toPath = compile(pathPattern);
-        return Array.from(frontmatter?.staticParams || []).flatMap((entry) => {
-          try {
-            return [toPath(paramsMapper(params, entry) as never)];
-          } catch (error: any) {
-            console.error(\`❗SSG: Failed building path for \${name}\`);
-            console.error(error);
-            return [];
-          }
-        });
-      }
-      // static route
-      return [pathPattern.replace(/^index\\/?/, "")];
-    }
-    return [];
-  })
-  .map((path) => join(base, path));
-`,Ot=`import type { PageRoute } from "@kosmojs/core";
-
-{{#each pageRoutes}}
-import * as {{id}} from "{{ createImport 'pages' file }}";
-{{/each}}
-
-const routeMap: Record<
-  string,
-  {
-    frontmatter?: { staticParams?: Array<Array<string | Array<string>>> };
-    pathPattern: string;
-    params: PageRoute["params"];
-  }
-> = {
-{{#each pageRoutes}}
-  "{{name}}": {
-    frontmatter: {{id}}.frontmatter,
-    pathPattern: "{{pathPattern}}",
-    params: {{serializeParams .}},
+  {
+    app,
+    components,
+  }: {
+    app: ComponentType;
+    components: Record<string, ComponentType<never>>;
   },
-{{/each}}
-}
+): {
+  clientRouter: () => RouterFactoryReturn<Promise<RouteComponent>>;
+  serverRouter: (
+    url: URL,
+  ) => RouterFactoryReturn<Promise<RouteComponent>, { route: Route }>;
+} => {
+  const router = createRouter(routes, app, { components });
 
-export default routeMap;
-`,kt=`import { useContext } from "preact/hooks";
+  return {
+    clientRouter() {
+      return router.resolve();
+    },
+    serverRouter(url) {
+      return router.resolve(url);
+    },
+  };
+};
+
+export default createRouterFactory<
+  RawRoute,
+  Promise<RouteComponent>,
+  { server: { route: Route } }
+>();
+`,Zt=`import { useContext } from "preact/hooks";
 
 import { RouterContext } from "./mdx";
 
@@ -3731,10 +4651,10 @@ export const useFrontmatter = <
 >(): T => {
   return useRoute().frontmatter as T;
 };
-`,At=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
+`,Qt=`import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 <AppProvider>{props.children}</AppProvider>
-`,jt=`import { h, type JSX } from "preact";
+`,$t=`import { h, type JSX } from "preact";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
 
@@ -3751,7 +4671,7 @@ export default function Link(
 
   return h("a", { ...restProps, href }, children);
 }
-`,Mt=`/**
+`,en=`/**
  * MDX component overrides.
  *
  * Every standard markdown element (headings, links, code blocks, etc.)
@@ -3774,7 +4694,7 @@ export const components = {
 declare global {
   type MDXProvidedComponents = typeof components;
 }
-`,Nt=`import renderFactory, {
+`,tn=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -3801,7 +4721,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Pt=`import renderFactory, {
+`,nn=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on MDX folders
@@ -3822,25 +4742,13 @@ export default renderFactory(() => {
     },
   };
 });
-`,Ft=`<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <!--app-head-->
-</head>
-<body>
-  <div id="app"><!--app-html--></div>
-  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
-</body>
-</html>
-`,It=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,rn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,Lt=`{props.children}
-`,Rt=`---
+`,an=`{props.children}
+`,on=`---
 title: "{{title}}"
 ---
 
@@ -3857,7 +4765,7 @@ export const pathMap = {
   routeName="{{route.name}}"
   pathMap={pathMap}
 />
-`,zt=`---
+`,sn=`---
 title: Welcome to KosmoJS
 description: Content-first development with MDX and Vite
 ---
@@ -3865,7 +4773,7 @@ description: Content-first development with MDX and Vite
 import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}"
 
 <WelcomePage />
-`,Bt=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,cn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.mdx";
 import { components } from "./components/mdx"
@@ -3881,12 +4789,12 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,Vt=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w(),serializeParams(e){return JSON.stringify(e.params)}}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,Rt),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?zt:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:mt()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),Lt,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(S)}]}return[]}).sort(S);for(let[e,a]of[[`client.ts`,_t],[`server.ts`,vt]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Tt],[`router.ts`,Et],[`ssg:routes.ts`,Ot]])await i(n.lib(e),t,{pageRoutes:r})};return{config({command:n}){return{oxc:{jsx:{runtime:`automatic`,importSource:`preact`}},plugins:ht(e,n,t)}},async start(){for(let[e,t]of[[`env.d.ts`,yt],[`app.ts`,gt],[`mdx.ts`,bt],[`use.ts`,kt],[`ssg.ts`,Dt],[`pageSamples/styles.module.css`,Ct],[`pageSamples/welcome.tsx`,wt],[`pageSamples/page.tsx`,St],[`pageSamples/404.tsx`,xt]])await i(n.lib(e),t,{});for(let[e,t]of[[`pages/404.mdx`,It],[`components/Link.tsx`,jt],[`components/mdx.ts`,Mt],[`app.mdx`,At],[`router.ts`,Bt]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),Ft,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Nt],[`server.ts`,Pt]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){await u(e.filter(m(t,[`create`]))),await d(e)},async build(e){await u(e),await d(e)}}}),Ht=h({meta:{name:`MDX`,jsx:`react-jsx`,jsxImportSource:`preact`},dependencies:{"path-to-regexp":U.devDependencies[`path-to-regexp`]},devDependencies:{preact:U.devDependencies.preact,"preact-render-to-string":U.devDependencies[`preact-render-to-string`],"@mdx-js/preact":U.devDependencies[`@mdx-js/preact`],"remark-frontmatter":U.devDependencies[`remark-frontmatter`],"remark-mdx-frontmatter":U.devDependencies[`remark-mdx-frontmatter`]},factory:Vt}),Ut={json:`application/json`,form:[`application/x-www-form-urlencoded`,`multipart/form-data`],raw:void 0},Wt=()=>{let e=e=>[`Buffer`,`ArrayBuffer`,`Blob`].includes(e)?{type:`string`,format:`binary`}:oe.Script(e),n=(e,t,n)=>{let r=n?`${t}_${n.replace(/[^\w.-]/g,`_`)}${T(n)}`:t;return`${e.id}_${r}`},r=(e,t,r,i)=>[`#`,`components`,e,n(t,r,i)].join(`/`),i=e=>e.split(`/`).reduce((e,t)=>e+ +!t.includes(`{`),0),o=e=>{if(e.name===`index`)return[`/`];let{tokens:n}=ae(e.pathPattern),r=e=>e.flatMap(e=>{switch(e.type){case`param`:return[e.name];case`wildcard`:return[e.name];case`group`:return r(e.tokens);default:return[]}}),a=(e,t)=>{if(!e.length)return[t];let[n,...i]=e;switch(n.type){case`text`:return a(i,{path:`${t.path}${n.value}`,params:t.params});case`param`:return a(i,{path:`${t.path}{${n.name}}`,params:[...t.params,n.name]});case`wildcard`:return a(i,{path:`${t.path}{${n.name}*}`,params:[...t.params,n.name]});case`group`:{let e=a(i,t),o=a([...n.tokens,...i],t),s=r(n.tokens),c=o.filter(e=>s.some(t=>e.params.includes(t)));return[...e,...c]}}},o=a(n,{path:``,params:[]}),s=e.params.schema.reduce((e,{name:t},n)=>(e[n]=t,e),{});return o.reduce((e,n)=>{let r=t(`/`,n.path);return e.includes(r)||n.params.every((e,t)=>e===s[t])&&e.push(r),e},[]).sort((e,t)=>i(t)-i(e))},s=(e,t)=>{let n=e.params.resolvedType?.properties?.flatMap(n=>RegExp(`\\{${n.name}\\*?\\}`).test(t)?[{$ref:r(`parameters`,e,e.params.id,n.name)}]:[]);return n?.length?n:void 0},c=(e,t)=>{let n=e.validationDefinitions.find(e=>e.method===t&&e.target===`response`);return Array.isArray(n?.variants)?n.variants.reduce((t,{id:n,status:i,contentType:a,body:o})=>(t[i]=Gt(i,a)||{description:`Success`,content:{[a||`application/json`]:{schema:o?{$ref:r(`schemas`,e,n)}:{type:`object`}}}},t),{}):{200:{description:`Success - TODO: Add response schema`,content:{"text/plain":{schema:{type:`string`}}}}}},l=t=>{let{parameters:r,schemas:i}={parameters:{},schemas:{}};for(let r of t.validationDefinitions)if(r.target===`response`)for(let{id:a,resolvedType:o}of r.variants)o?.typeboxSchema&&(i[n(t,a)]=e(o.typeboxSchema));else if(r.target===`query`){let{id:a,resolvedType:o}=r.schema;for(let r of o?.properties||[])if(r?.typeboxSchema){let o=n(t,a,r.name);i[o]=e(r.typeboxSchema)}}else{let{id:a,resolvedType:o}=r.schema;o?.typeboxSchema&&(i[n(t,a)]=e(o.typeboxSchema))}if(t.params.resolvedType)for(let i of t.params.resolvedType.properties||[])i?.typeboxSchema&&(r[n(t,t.params.id,i.name)]={name:i.name,in:`path`,required:!0,schema:e(i.typeboxSchema)});return{parameters:r,schemas:i}},u=e=>{let t={},n=e.validationDefinitions.flatMap(e=>e.target===`response`?[]:e.schema.resolvedType?[e]:[]);for(let i of o(e))for(let o of e.methods){let l={responses:c(e,o)},u=s(e,i);u&&(l.parameters=u);let d=n.find(e=>e.method===o&&e.target===`query`);if(d?.schema)for(let t of d.schema.resolvedType?.properties||[])l.parameters||=[],l.parameters.push({name:t.name,in:`query`,required:!t.optional,schema:{$ref:r(`schemas`,e,d.schema.id,t.name)}});let f=n.filter(e=>e.method===o&&Object.keys(a).includes(e.target));f.length&&(l.requestBody={required:!0,content:f.reduce((t,n)=>{let{contentType:i=Ut[n.target]}=n;if(i){let a={$ref:r(`schemas`,e,n.schema.id)};for(let e of[i].flat())t[e]={schema:a}}return t},{})}),t[i]||(t[i]={}),t[i][o.toLowerCase()]=l}return t};return{generateComponentId:n,generateComponentPath:r,generatePathVariations:o,generateOpenAPISchema:e=>{let t=new Map;for(let n of e)t.set(n.name,o(n));let{components:n,paths:r}=e.sort(S).flatMap(n=>{let r=t.get(n.name)??[];return r.length>0&&e.some(e=>{if(e.name===n.name)return!1;let i=t.get(e.name)??[],a=new Set(i);return r.every(e=>a.has(e))})?[]:[n]}).reduce((e,t)=>{let n=u(t),{parameters:r,schemas:i}=l(t);return{paths:{...e.paths,...n},components:{parameters:{...e.components.parameters,...r},schemas:{...e.components.schemas,...i}}}},{paths:{},components:{parameters:{},schemas:{}}});return{paths:r,components:n}}}},Gt=(e,t)=>{let n={type:`string`,format:`uri`,...t?{enum:[t]}:{}};return{301:{description:`Moved Permanently`,headers:{Location:{description:`New permanent location`,schema:n}}},302:{description:`Found`,headers:{Location:{description:`Temporary location`,schema:n}}},303:{description:`See Other`,headers:{Location:{description:`Location to GET after POST/PUT/DELETE`,schema:n}}},307:{description:`Temporary Redirect`,headers:{Location:{description:`Temporary location (preserves request method)`,schema:n}}},308:{description:`Permanent Redirect`,headers:{Location:{description:`New permanent location (preserves request method)`,schema:n}}}}[e]},Kt=g((e,t)=>{let{outfile:n=``,...r}={...t},{createPath:i}=y(e),{generateOpenAPISchema:a}=Wt(),o=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`apiRoute`?[t]:[]),{paths:o,components:s}=a(t),c={...JSON.parse(JSON.stringify(r)),paths:o,components:s},l=/ya?ml/.test(n)?ie.stringify(c):JSON.stringify(c,null,2);await ee(i.src(n),l,{})};return{async watch(e){await o(e)},async build(e){await o(e)}}}),qt=h({meta:{name:`OpenAPI`,resolveTypes:!0},factory:Kt}),W={type:`module`,private:!0,name:`@kosmojs/react-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/react-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-react":`^6.1.0`},devDependencies:{"@tanstack/react-query":`^5.102.2`,"@types/react":`^19.2.18`,"@types/react-dom":`^19.2.5`,"path-to-regexp":`^8.4.2`,react:`^19.2.8`,"react-dom":`^19.2.8`,"react-router":`^8.3.0`}},Jt=e=>{let t=e.map(e=>e.orig).join(`/`),n=e=>e.kind===`splat`?`*`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[n(e.parts[0])]:(/\.\w+$/.test(e.orig)||(console.warn(`❗${r([`red`,`bold`],`WARN`)}: React Router v7 only supports dot-suffix mixed segments (e.g. :param.html).`),console.warn(`  ${r([`magenta`],e.orig)} in ${r([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},Yt=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=n=>n.flatMap(({index:n,layout:r,children:i})=>{let{name:a,pathTokens:o}={...n,...r};if(!o)return[];let s=`${a}:layout`,c=Jt(o),l=o.at(-1);return e(l)?n&&r?[{name:s,path:c,component:r.id,children:[{name:a,path:`*`,component:n.id}]}]:n?[{path:c,children:[{name:a,path:`*`,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]:n&&r?[{name:s,path:c,component:r.id,children:[{name:a,index:!0,component:n.id},...t(i)]}]:n?[{path:c,children:[{name:a,index:!0,component:n.id},...t(i)]}]:r?[{name:s,path:c,component:r.id,children:t(i)}]:[]});return t},Xt=()=>{let e=[`🎉 Well done! You just created a new React route.`,`🚀 Success! A fresh React route is ready to roll.`,`🌟 Nice work! Another React route added to your app.`,`⚡ Quick and easy! Your new React route is good to go.`,`🥳 Congrats! Your app just leveled up with a new React route.`,`🧩 All set! A new React route has been scaffolded.`,`🔧 Scaffold complete! Your new React route is in place.`,`✨ Fantastic! Your new React route is ready.`,`🎯 Nailed it! A brand new React route just landed.`,`💫 Awesome! Another React route joins the lineup.`];return e[Math.floor(Math.random()*e.length)]},Zt=`import type { ReactNode } from "react";
+`,ln=v((e,t)=>{let{createPath:n,createImportHelpers:r}=S(e),{renderToFile:i}=w({helpers:{...r({origin:`lib`}),...A(),serializeParams(e){return JSON.stringify(e.params)}}}),{renderToFile:a}=w({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=l(t?.templates,on),c=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?sn:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:Rt()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),an,{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(E)}]}return[]}).sort(D);for(let[e,a]of[[`client.ts`,Vt],[`server.ts`,Ht]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Yt],[`router.ts`,Xt]])await i(n.lib(e),t,{pageRoutes:r})};return{config({command:n}){return{oxc:{jsx:{runtime:`automatic`,importSource:`preact`}},plugins:zt(e,n,t)}},async start(){for(let[e,t]of[[`env.d.ts`,Ut],[`app.ts`,Bt],[`mdx.ts`,Wt],[`use.ts`,Zt],[`pageSamples/styles.module.css`,qt],[`pageSamples/welcome.tsx`,Jt],[`pageSamples/page.tsx`,Kt],[`pageSamples/404.tsx`,Gt]])await i(n.lib(e),t,{});for(let[e,t]of[[`pages/404.mdx`,rn],[`components/Link.tsx`,$t],[`components/mdx.ts`,en],[`app.mdx`,Qt],[`router.ts`,cn]])await a(n.src(e),t,{entryDir:u.entryDir},{overwrite:o});for(let[e,t]of[[`client.ts`,tn],[`server.ts`,nn]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){await c(e.filter(g(t,[`create`]))),await d(e)},async build(e){await c(e),await d(e)}}}),un=_({meta:{name:`MDX`,slot:`frontend`,jsx:`react-jsx`,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:ln}),dn={json:`application/json`,form:[`application/x-www-form-urlencoded`,`multipart/form-data`],raw:void 0},fn=()=>{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,`_`)}${j(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),a=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]=pn(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 a(e))for(let a of e.methods){let l={responses:c(e,a)},u=s(e,i);u&&(l.parameters=u);let d=n.find(e=>e.method===a&&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===a&&Object.keys(o).includes(e.target));f.length&&(l.requestBody={required:!0,content:f.reduce((t,n)=>{let{contentType:i=dn[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][a.toLowerCase()]=l}return t};return{generateComponentId:n,generateComponentPath:r,generatePathVariations:a,generateOpenAPISchema:e=>{let t=new Map;for(let n of e)t.set(n.name,a(n));let{components:n,paths:r}=e.sort(E).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}}}},pn=(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]},mn=v((e,t)=>{let{outfile:n=``,...r}={...t},{createPath:i}=S(e),{generateOpenAPISchema:a}=fn(),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 T(i.src(n),l,{})};return{async watch(e){await o(e)},async build(e){await o(e)}}}),hn=_({meta:{name:`OpenAPI`,resolveTypes:!0},factory:mn}),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.102.2`,"@types/react":`^19.2.18`,"@types/react-dom":`^19.2.5`,react:`^19.2.8`,"react-dom":`^19.2.8`,"react-router":`^8.3.0`}},gn=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(`❗${i([`red`,`bold`],`WARN`)}: React Router v7 only supports dot-suffix mixed segments (e.g. :param.html).`),console.warn(`  ${i([`magenta`],e.orig)} in ${i([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},_n=()=>{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=gn(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},vn=()=>{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)]},yn=`import type { ReactNode } from "react";
 
 export const AppProvider = ({ children }: { children: ReactNode }) => {
   return children;
 }
-`,Qt=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
+`,bn=`import { type QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import type { ReactNode } from "react";
 
 import { getQueryClient } from "./query";
@@ -3905,7 +4813,7 @@ export const AppProvider = ({
     </QueryClientProvider>
   );
 }
-`,$t=`import { lazy, type JSX } from "react";
+`,xn=`import { lazy, type JSX } from "react";
 
 import {
   createRoot,
@@ -3959,7 +4867,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,en=`{
+`,Sn=`{
   {{#if name}}
   id: "{{name}}",
   {{/if}}
@@ -3977,7 +4885,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,tn=`import type { JSX } from "react";
+`,Cn=`import type { JSX } from "react";
 
 import {
   renderToString as renderToStringOrig,
@@ -4043,7 +4951,12 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory();
-`,nn=`/* @jsxImportSource react */
+`,wn=`declare module "virtual:kosmo/tsq-client" {
+  import type { QueryClient, QueryClientConfig } from "@tanstack/react-query";
+  export const createQueryClient: (options?: QueryClientConfig) => QueryClient;
+  export const getQueryClient: () => QueryClient;
+}
+`,Tn=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -4084,7 +4997,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,rn=`/* @jsxImportSource react */
+`,En=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -4136,7 +5049,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,an=`* {
+`,Dn=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -4271,7 +5184,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,on=`/* @jsxImportSource react */
+`,On=`/* @jsxImportSource react */
 
 import styles from "./styles.module.css";
 
@@ -4337,26 +5250,27 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,sn=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,kn=`export * from "virtual:kosmo/tsq-client";
+`,An=`import { QueryClient } from "@tanstack/react-query";
 
-let client: QueryClient | undefined;
+let client = undefined;
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   client = new QueryClient(options);
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   if (!client) {
     client = new QueryClient();
   }
   return client;
 };
-`,cn=`import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+`,jn=`import { QueryClient } from "@tanstack/react-query";
 
-import { store } from "{{ createImport 'lib' '@ssr/base' }}";
+import { store } from "{{ createImport 'libCore' 'ssr' }}";
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   const client = new QueryClient(options);
   const ctx = store?.getStore();
   if (ctx) {
@@ -4365,7 +5279,7 @@ export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   const ctx = store?.getStore();
   if (!ctx) {
     throw new Error("getQueryClient(): called outside an SSR request scope");
@@ -4373,9 +5287,9 @@ export const getQueryClient = (): QueryClient => {
   if (!ctx.tsqClient) {
     ctx.tsqClient = new QueryClient();
   }
-  return ctx.tsqClient as QueryClient;
+  return ctx.tsqClient;
 };
-`,ln=`export type ComponentLoader = () => Promise<{
+`,Mn=`export type ComponentLoader = () => Promise<{
   loader?: (arg: unknown) => Promise<unknown>;
 }>;
 
@@ -4395,7 +5309,7 @@ export const loaderFactory = (opt?: { withPreload?: boolean }) => {
     return opt?.withPreload ? { loader } : {};
   };
 };
-`,un=`import type { JSX, ComponentType } from "react";
+`,Nn=`import type { JSX, ComponentType } from "react";
 
 import {
   type RouteObject,
@@ -4453,7 +5367,7 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteObject, Promise<JSX.Element>>();
-`,dn=`import { Outlet } from "react-router";
+`,Pn=`import { Outlet } from "react-router";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 export default function App() {
@@ -4463,7 +5377,7 @@ export default function App() {
     </AppProvider>
   );
 }
-`,fn=`import {
+`,Fn=`import {
   type LinkProps as RouterLinkProps,
   Link as RouterLink,
 } from "react-router";
@@ -4491,7 +5405,7 @@ export default function Link(
     </RouterLink>
   );
 }
-`,pn=`import renderFactory, {
+`,In=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -4518,7 +5432,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,mn=`import renderFactory, {
+`,Ln=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -4545,29 +5459,17 @@ export default renderFactory(() => {
     },
   };
 });
-`,hn=`<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <!--app-head-->
-</head>
-<body>
-  <div id="app"><!--app-html--></div>
-  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
-</body>
-</html>
-`,gn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,Rn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,_n=`import { Outlet } from "react-router";
+`,zn=`import { Outlet } from "react-router";
 
 export default function Layout() {
   return <Outlet />;
 }
-`,vn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
+`,Bn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -4580,8 +5482,8 @@ export default function Page() {
     },
   });
 }
-`,yn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,bn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Vn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,Hn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -4596,12 +5498,12 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,xn=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()},partials:{routePartial:en}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=Yt(),s=e=>!e?.trim().length,u=c(t?.templates,vn),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?yn:u(r.name,r),{route:r,message:Xt()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),_n,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(v(r));for(let[e,t]of[[`client.ts`,$t],[`server.ts`,tn]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a});await i(n.lib(`router.tsx`),un,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[se(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,``],[`react.ts`,ln],[`pageSamples/styles.module.css`,an],[`pageSamples/welcome.tsx`,on],[`pageSamples/page.tsx`,rn],[`pageSamples/404.tsx`,nn],...t?.tanstack?.query?[[`app.tsx`,Qt],[`query.ts`,sn]]:[[`app.tsx`,Zt],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.tsx`,gn],[`components/Link.tsx`,fn],[`app.tsx`,dn],[`router.ts`,bn]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),hn,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,pn],[`server.ts`,mn]])await a(n.entry(e),t,{},{overwrite:s})},async watch(e,t){await d(e.filter(m(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?cn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Sn=h({meta:{name:`React`,jsx:`preserve`,jsxImportSource:`react`},dependencies(e){return{react:W.devDependencies.react,"react-router":W.devDependencies[`react-router`],"path-to-regexp":W.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/react-query":W.devDependencies[`@tanstack/react-query`]}:{}}},devDependencies:{"@types/react":W.devDependencies[`@types/react`],"@types/react-dom":W.devDependencies[`@types/react-dom`],"react-dom":W.devDependencies[`react-dom`]},factory:xn}),G={type:`module`,private:!0,name:`@kosmojs/solid-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/solid-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"vite-plugin-solid":`^2.11.14`},devDependencies:{"@solidjs/router":`^1.0.0`,"@tanstack/solid-query":`^5.102.2`,"path-to-regexp":`^8.4.2`,"solid-js":`^1.9.15`}},Cn=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,t=t=>t?.kind===`param`?t.parts[0]?.kind===`optional`||e(t):!1,n=r=>r.flatMap(({index:r,layout:i,children:a})=>{let{pathTokens:o}={...r,...i},s=K(o.map((e,n)=>e.kind===`param`&&(t(o[n+1])||a.some(e=>e.index?.pathTokens.some(t)))?{...e,parts:[{...e.parts[0],kind:`required`}]}:e)),c=o.at(-1);if(e(c)){let e=K([c]);return r&&i?[{path:s,component:i.id,children:[{path:e,component:r.id}]}]:r?[{path:s,children:[{path:e,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]}return r&&i?[{path:s,component:i.id,children:[{path:`/`,component:r.id},...n(a)]}]:r?[{path:s,children:[{path:`/`,component:r.id},...n(a)]}]:i?[{path:s,component:i.id,children:n(a)}]:[]});return n},K=e=>{let t=e.map(e=>e.orig).join(`/`),n=e=>e.kind===`splat`?`*${e.name}`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[n(e.parts[0])]:(e.parts.length&&(console.warn(`❗${r([`red`,`bold`],`WARN`)}: At the moment Solid Router does not support mixed path segments.`),console.warn(`  ${r([`magenta`],e.orig)} segment in ${r([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},wn=()=>{let e=[`🎉 Well done! You just created a new Solid route.`,`🚀 Success! A fresh Solid route is ready to roll.`,`🌟 Nice work! Another Solid route added to your app.`,`🧩 All set! A new Solid route has been scaffolded.`,`🔧 Scaffold complete! Your new Solid route is in place.`,`✅ Built! Your Solid route is scaffolded and ready.`,`✨ Fantastic! Your new Solid route is good to go.`,`🎯 Nailed it! A brand new Solid route just landed.`,`💫 Awesome! Another Solid route joins the party.`,`⚡ Lightning fast! A new Solid route created successfully.`];return e[Math.floor(Math.random()*e.length)]},Tn=`import type { ParentComponent } from "solid-js";
+`,Un=v((e,t)=>{let{createPath:n,createImportHelpers:r}=S(e),{render:i,renderToFile:a}=w({helpers:{...r({origin:`lib`}),...A()},partials:{routePartial:Sn}}),{renderToFile:o}=w({helpers:r({origin:`src`})}),s=_n(),c=e=>!e?.trim().length,d=l(t?.templates,Bn),f=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await o(n.pages(r.file),r.name===`index`?Vn:d(r.name,r),{route:r,message:vn()},{overwrite:c}):t===`pageLayout`&&await o(n.pages(r.file),zn,{route:r},{overwrite:c})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(E),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=s(b(r));for(let[e,t]of[[`client.ts`,xn],[`server.ts`,Cn]])await a(n.libEntry(e),t,{pageEntries:r,nestedRoutes:i});await a(n.lib(`router.tsx`),Nn,{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`,wn],[`react.ts`,Mn],[`pageSamples/styles.module.css`,Dn],[`pageSamples/welcome.tsx`,On],[`pageSamples/page.tsx`,En],[`pageSamples/404.tsx`,Tn],...t?.tanstack?.query?[[`app.tsx`,bn],[`query.ts`,kn]]:[[`app.tsx`,yn],[`query.ts`,`/** tanstack query disabled */`]]])await a(n.lib(e),r,{});for(let[e,t]of[[`pages/404.tsx`,Rn],[`components/Link.tsx`,Fn],[`app.tsx`,Pn],[`router.ts`,Hn]])await o(n.src(e),t,{entryDir:u.entryDir},{overwrite:c});for(let[e,t]of[[`client.ts`,In],[`server.ts`,Ln]])await o(n.entry(e),t,{},{overwrite:c})},async watch(e,t){await f(e.filter(g(t,[`create`]))),await p(e)},async build(e){await f(e),await p(e)},virtualModules(){return t?.tanstack?.query?[{specifier:`virtual:kosmo/tsq-client`,csr:i(An,{}),ssr:i(jn,{})}]:[]}}}),Wn=_({meta:{name:`React`,slot:`frontend`,jsx:`preserve`,jsxImportSource:`react`},dependencies(e){return{react:W.devDependencies.react,"react-router":W.devDependencies[`react-router`],...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:Un}),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.102.2`,"solid-js":`^1.9.15`}},Gn=()=>{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=>e.kind===`param`&&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(`❗${i([`red`,`bold`],`WARN`)}: At the moment Solid Router does not support mixed path segments.`),console.warn(`  ${i([`magenta`],e.orig)} segment in ${i([`blue`],t)} route won't match as expected.`),console.warn()),[e.parts.map(e=>e.type===`static`?e.value:n(e)).join(``)])).join(`/`)},Kn=()=>{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)]},qn=`import type { ParentComponent } from "solid-js";
 
 export const AppProvider: ParentComponent = (props) => {
   return props.children;
 };
-`,En=`import type { ParentComponent } from "solid-js";
+`,Jn=`import type { ParentComponent } from "solid-js";
 import { type QueryClient, QueryClientProvider } from "@tanstack/solid-query";
 
 import { getQueryClient } from "./query";
@@ -4613,7 +5515,7 @@ export const AppProvider: ParentComponent<{ client?: QueryClient }> = (props) =>
     </QueryClientProvider>
   );
 };
-`,Dn=`import { lazy, type JSX } from "solid-js";
+`,Yn=`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";
@@ -4658,7 +5560,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,On=`{
+`,Xn=`{
   path: "{{path}}",
   {{#if component}}
   component: {{component}}_component,
@@ -4668,7 +5570,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,kn=`import type { JSX } from "solid-js";
+`,Zn=`import type { JSX } from "solid-js";
 
 import {
   generateHydrationScript,
@@ -4723,11 +5625,44 @@ export const renderWrapper: SSRRenderWrapper = (context, render) => {
 export const renderToString: RenderToStringWrapper<
   () => RouterFactoryReturn<JSX.Element>,
   Parameters<typeof renderToStringAsync>[1]
-> = async (resolver, { headerTags = [], ...options } = {}) => {
-  return {
-    head: [...headerTags, generateHydrationScript()].join("\\n"),
-    html: await renderToStringAsync(() => resolver().component, options),
-  };
+> = async (resolver, { headerTags = [], timeoutMs = 30_000, ...options } = {}) => {
+  /**
+   * renderToStringAsync adaptation.
+   * Solid arms its internal timeout before invoking the component,
+   * so a component throwing synchronously leaves that timeout promise orphaned -
+   * its rejection, 30s later, is unhandled and fatal to the process.
+   * renderToStream's thenable resolves with the same html;
+   * deferring the call turns a sync throw into an immediate, catchable rejection carrying the real error,
+   * and the replacement timeout below is pre-observed, so it can never reject unhandled.
+   * */
+  let timeoutHandle: ReturnType<typeof setTimeout> | undefined;
+
+  const timeout = new Promise<never>((_, reject) => {
+    timeoutHandle = setTimeout(() => {
+      reject(new Error("SSR: solid render timed out"));
+    }, timeoutMs);
+  });
+
+  timeout.catch(() => {});
+
+  try {
+    return {
+      head: [...headerTags, generateHydrationScript()].join("\\n"),
+      html: await Promise.race([
+        Promise.resolve().then(() => {
+          // typed as a stream handle, but resolving to the full html at runtime.
+          // renderToStringAsync itself races it the same way.
+          return renderToStreamOrig(
+            () => resolver().component,
+            options,
+          ) as unknown as Promise<string>;
+        }),
+        timeout,
+      ]),
+    };
+  } finally {
+    clearTimeout(timeoutHandle);
+  }
 };
 
 export const renderToStream: RenderToStreamWrapper<
@@ -4749,7 +5684,12 @@ export const renderToStream: RenderToStreamWrapper<
 };
 
 export default serverRenderFactory<true>();
-`,An=`/* @jsxImportSource solid-js */
+`,Qn=`declare module "virtual:kosmo/tsq-client" {
+  import type { QueryClient, QueryClientConfig } from "@tanstack/solid-query";
+  export const createQueryClient: (options?: QueryClientConfig) => QueryClient;
+  export const getQueryClient: () => QueryClient;
+}
+`,$n=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4790,7 +5730,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,jn=`/* @jsxImportSource solid-js */
+`,er=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -4842,7 +5782,7 @@ export default function PageSample(props: {
     </div>
   );
 }
-`,Mn=`* {
+`,tr=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -4977,7 +5917,7 @@ export default function PageSample(props: {
   align-items: center;
   gap: 0.25rem;
 }
-`,Nn=`/* @jsxImportSource solid-js */
+`,nr=`/* @jsxImportSource solid-js */
 
 import styles from "./styles.module.css";
 
@@ -5043,26 +5983,27 @@ export default function WelcomePage() {
     </div>
   );
 }
-`,Pn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,rr=`export * from "virtual:kosmo/tsq-client";
+`,ir=`import { QueryClient } from "@tanstack/solid-query";
 
-let client: QueryClient | undefined;
+let client = undefined;
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   client = new QueryClient(options);
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   if (!client) {
     client = new QueryClient();
   }
   return client;
 };
-`,Fn=`import { QueryClient, type QueryClientConfig } from "@tanstack/solid-query";
+`,ar=`import { QueryClient } from "@tanstack/solid-query";
 
-import { store } from "{{ createImport 'lib' '@ssr/base' }}";
+import { store } from "{{ createImport 'libCore' 'ssr' }}";
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   const client = new QueryClient(options);
   const ctx = store?.getStore();
   if (ctx) {
@@ -5071,7 +6012,7 @@ export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   const ctx = store?.getStore();
   if (!ctx) {
     throw new Error("getQueryClient(): called outside an SSR request scope");
@@ -5079,9 +6020,9 @@ export const getQueryClient = (): QueryClient => {
   if (!ctx.tsqClient) {
     ctx.tsqClient = new QueryClient();
   }
-  return ctx.tsqClient as QueryClient;
+  return ctx.tsqClient;
 };
-`,In=`import type { JSX, ParentComponent } from "solid-js";
+`,or=`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";
@@ -5117,7 +6058,7 @@ export const createRouters = (
 }
 
 export default createRouterFactory<RouteDefinition, JSX.Element>();
-`,Ln=`export type ComponentLoader = () => Promise<{
+`,sr=`export type ComponentLoader = () => Promise<{
   preload?: () => Promise<unknown>;
 }>;
 
@@ -5132,10 +6073,10 @@ export const loaderFactory = (opt?: { withPreload?: boolean }) => {
     return opt?.withPreload ? { preload } : {};
   };
 };
-`,Rn=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
+`,cr=`export type MaybeWrapped<T> = import("solid-js/store").Store<T> | T;
 
 export { unwrap } from "solid-js/store";
-`,zn=`import type { ParentComponent } from "solid-js";
+`,lr=`import type { ParentComponent } from "solid-js";
 import { AppProvider } from "{{ createImport 'lib' 'app' }}";
 
 const App: ParentComponent = (props) => {
@@ -5143,7 +6084,7 @@ const App: ParentComponent = (props) => {
 };
 
 export default App;
-`,Bn=`import { A, type AnchorProps } from "@solidjs/router";
+`,ur=`import { A, type AnchorProps } from "@solidjs/router";
 import { type JSXElement, splitProps } from "solid-js";
 
 import { pageRouteMap, type LinkProps } from "{{ createImport 'libCore' }}";
@@ -5168,7 +6109,7 @@ export default function Link(
 
   return <A {...{ ...restProps, href: href() }}>{knownProps.children}</A>;
 }
-`,Vn=`import renderFactory, {
+`,dr=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -5195,7 +6136,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Hn=`import renderFactory, {
+`,fr=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -5222,31 +6163,19 @@ export default renderFactory(() => {
     },
   };
 });
-`,Un=`<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <!--app-head-->
-</head>
-<body>
-  <div id="app"><!--app-html--></div>
-  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
-</body>
-</html>
-`,Wn=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
+`,pr=`import PageSample from "{{ createImport 'lib' 'pageSamples/404.tsx' }}";
 
 export default function Page() {
   return <PageSample />;
 }
-`,Gn=`import type { ParentComponent } from "solid-js";
+`,mr=`import type { ParentComponent } from "solid-js";
 
 const Layout: ParentComponent = (props) => {
   return props.children;
 };
 
 export default Layout;
-`,Kn=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
+`,hr=`import PageSample from "{{ createImport 'lib' 'pageSamples/page.tsx' }}";
 
 export default function Page() {
   return PageSample({
@@ -5259,8 +6188,8 @@ export default function Page() {
     },
   });
 }
-`,qn=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
-`,Jn=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,gr=`export { default } from "{{ createImport 'lib' 'pageSamples/welcome.tsx' }}";
+`,_r=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app";
 
@@ -5275,286 +6204,130 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,Yn=g((e,t)=>{let{generators:n=[]}=e.config,{createPath:r,createImportHelpers:i}=y(e),{renderToFile:a}=x({helpers:{...i({origin:`lib`}),...w()},partials:{routePartial:On}}),{renderToFile:o}=x({helpers:i({origin:`src`})}),s=Cn(),u=e=>!e?.trim().length,d=c(t?.templates,Kn),f=async e=>{for(let{kind:t,entry:n}of e)t===`pageRoute`?await o(r.pages(n.file),n.name===`index`?qn:d(n.name,n),{route:n,message:wn()},{overwrite:u}):t===`pageLayout`&&await o(r.pages(n.file),Gn,{route:n},{overwrite:u})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),n=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=s(v(n));for(let[e,t]of[[`client.ts`,Dn],[`server.ts`,kn]])await a(r.libEntry(e),t,{pageEntries:n,nestedRoutes:i});await a(r.lib(`router.tsx`),In,{entries:e,indexRoutes:t})};return{config({command:e}){let{templates:r,...i}={...t};return{oxc:{jsx:{importSource:`solid-js`}},plugins:e===`build`?[D({...i,...n.some(e=>e.meta.slot===`ssr`)?{ssr:!0,solid:{...i?.solid,hydratable:!0}}:{}})]:[D({...i,dev:!0,hot:!0})]}},async start(){for(let[e,n]of[[`env.d.ts`,``],[`solid.ts`,Ln],[`unwrap.ts`,Rn],[`pageSamples/styles.module.css`,Mn],[`pageSamples/welcome.tsx`,Nn],[`pageSamples/page.tsx`,jn],[`pageSamples/404.tsx`,An],...t?.tanstack?.query?[[`app.tsx`,En],[`query.ts`,Pn]]:[[`app.tsx`,Tn],[`query.ts`,`/** tanstack query disabled */`]]])await a(r.lib(e),n,{});for(let[e,t]of[[`pages/404.tsx`,Wn],[`components/Link.tsx`,Bn],[`app.tsx`,zn],[`router.ts`,Jn]])await o(r.src(e),t,{entryDir:l.entryDir},{overwrite:u});await o(r.src(`index.html`),Un,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Vn],[`server.ts`,Hn]])await o(r.entry(e),t,{},{overwrite:u})},async watch(e,t){await f(e.filter(m(t,[`create`]))),await p(e)},async build(e){await f(e),await p(e)},async ssrBuild(){await a(r.lib(`query.ts`),t?.tanstack?.query?Fn:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Xn=h({meta:{name:`SolidJS`,jsx:`preserve`,jsxImportSource:`solid-js`},dependencies(e){return{"solid-js":G.devDependencies[`solid-js`],"@solidjs/router":G.devDependencies[`@solidjs/router`],"path-to-regexp":G.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/solid-query":G.devDependencies[`@tanstack/solid-query`]}:{}}},factory:Yn}),Zn=g(e=>{let{generators:i=[],refineTypeName:a,...o}={...e.config},{createPath:s}=y(e);return{async postBuild(){let a=s.distDir(`ssg`),c=n(a,`../ssr/server.js`);if(!await ce(c,le.F_OK).then(()=>!0,()=>!1)){console.error(),console.error(r(`red`,`❗Please enable ssrGenerator in ${e.name}/kosmo.config.ts`)),console.error(`  SSG generator can not run without SSR server`),console.error();return}let l=te(`${e.name}: SSG`);l.append(`preparing...`);let{createDisposableServer:u}=await import(c);await O(n(a,`../client/assets`),t(a,`assets`),{recursive:!0}),l.append(`bundling routes...`),await E(_(o,...i.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:s.lib(),appType:`custom`,plugins:[C.tsconfigPaths(e),C.nodePrefix()],resolve:{conditions:[`node`]},build:{ssr:s.lib(`ssg.ts`),target:`esnext`,sourcemap:!1,emptyOutDir:!0,rolldownOptions:{output:{dir:a,entryFileNames:`routes.js`,format:`esm`}}}}));try{let e=await import(t(a,`routes.js`)).then(e=>e.default);u(async n=>{for(let[r,i]of e.entries()){l.append(`[ ${r+1} of ${e.length} ] ${i}`);let o=await Qn(n,i);o!==void 0&&(await ue(t(a,i),{recursive:!0}),await de(t(a,t(i,`index.html`)),o,`utf8`))}l.succeed(`done ✨`)})}finally{await k(`${a}/routes.js`)}}}}),Qn=async(e,t)=>{try{let n=`http://localhost:${e}${t}`;return await(await fetch(n)).text()}catch(e){console.error(r(`red`,`✗ SSG: Failed generating ${t} route: ${e.message}`));return}},$n=h({meta:{name:`SSG`,slot:`ssg`},factory:Zn}),q={type:`module`,private:!0,name:`@kosmojs/ssr-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,vite:`^8.2.2`},devDependencies:{"@hono/node-server":`^2.1.1`,hono:`^4.13.3`,"light-my-request":`^6.6.0`,tinyglobby:`^0.2.17`}},er=`{{#if apiGenerator}}
-export { default as apiApp } from "{{ createImport 'api' 'app' }}";
-{{else}}
-export const apiApp = undefined;
-{{/if}}
-`,tr=`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 = [
-  // Moved Permanently
-  301,
-  // Found (temporary)
-  302,
-  // See Other (redirect after POST)
-  303,
-  // Temporary Redirect (preserves method)
-  307,
-  // Permanent Redirect (preserves method)
-  308,
-];
-
-/**
- * Origin used to absolutize the relative URLs the client produces.
- * Never resolved over the network; the host part is irrelevant to
- * route matching in both Hono and Koa.
- * */
-export const ssrOrigin = "http://ssr.local";
-
-/**
- * Maximum redirect hops, mirroring the fetch spec limit.
- * */
-export const maxRedirects = 5;
-
-/**
- * Request-scoped context store.
- * Server-only module - never reaches browser bundles.
- * */
-export const store = new AsyncLocalStorage<RequestContext>();
-
-export const isFetchApp = (app: FetchApp | NodeApp): app is FetchApp => {
-  return typeof (app as FetchApp).fetch === "function";
-};
-`,nr=`import { type RequestContext, store } from "./base";
-
-import { renderWrapper } from "{{ createImport 'libEntry' 'server' }}";
-
-export { default as ssrApp } from "{{ createImport 'entry' 'server' }}";
-export { apiApp } from "{{ createImport 'lib' '@ssr/api' }}";
+`,vr=v((e,t)=>{let{generators:n=[]}=e.config,{createPath:r,createImportHelpers:i}=S(e),{render:a,renderToFile:o}=w({helpers:{...i({origin:`lib`}),...A()},partials:{routePartial:Xn}}),{renderToFile:s}=w({helpers:i({origin:`src`})}),c=Gn(),d=e=>!e?.trim().length,f=l(t?.templates,hr),p=async e=>{for(let{kind:t,entry:n}of e)t===`pageRoute`?await s(r.pages(n.file),n.name===`index`?gr:f(n.name,n),{route:n,message:Kn()},{overwrite:d}):t===`pageLayout`&&await s(r.pages(n.file),mr,{route:n},{overwrite:d})},m=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(E),n=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=c(b(n));for(let[e,t]of[[`client.ts`,Yn],[`server.ts`,Zn]])await o(r.libEntry(e),t,{pageEntries:n,nestedRoutes:i});await o(r.lib(`router.tsx`),or,{entries:e,indexRoutes:t})};return{config({command:e}){let{templates:r,...i}={...t};return{oxc:{jsx:{importSource:`solid-js`}},plugins:e===`build`?[N({...i,...n.some(e=>e.meta.slot===`ssr`)?{ssr:!0,solid:{...i?.solid,hydratable:!0}}:{}})]:[N({...i,dev:!0,hot:!0})]}},async start(){for(let[e,n]of[[`env.d.ts`,Qn],[`solid.ts`,sr],[`unwrap.ts`,cr],[`pageSamples/styles.module.css`,tr],[`pageSamples/welcome.tsx`,nr],[`pageSamples/page.tsx`,er],[`pageSamples/404.tsx`,$n],...t?.tanstack?.query?[[`app.tsx`,Jn],[`query.ts`,rr]]:[[`app.tsx`,qn],[`query.ts`,`/** tanstack query disabled */`]]])await o(r.lib(e),n,{});for(let[e,t]of[[`pages/404.tsx`,pr],[`components/Link.tsx`,ur],[`app.tsx`,lr],[`router.ts`,_r]])await s(r.src(e),t,{entryDir:u.entryDir},{overwrite:d});for(let[e,t]of[[`client.ts`,dr],[`server.ts`,fr]])await s(r.entry(e),t,{},{overwrite:d})},async watch(e,t){await p(e.filter(g(t,[`create`]))),await m(e)},async build(e){await p(e),await m(e)},virtualModules(){return t?.tanstack?.query?[{specifier:`virtual:kosmo/tsq-client`,csr:a(ir,{}),ssr:a(ar,{})}]:[]}}}),yr=_({meta:{name:`SolidJS`,slot:`frontend`,jsx:`preserve`,jsxImportSource:`solid-js`},dependencies(e){return{"solid-js":G.devDependencies[`solid-js`],"@solidjs/router":G.devDependencies[`@solidjs/router`],...e?.tanstack?.query?{"@tanstack/solid-query":G.devDependencies[`@tanstack/solid-query`]}:{}}},factory:vr}),br=`import { join } from "node:path";
 
-/**
- * Wraps a render call, making the given context visible to every
- * fetch dispatch that happens during it - across await points,
- * stream chunks and parallel component data loads.
- * */
-export const withSsrContext = <T>(
-  context: RequestContext,
-  render: () => T,
-): T => {
-  return store.run(context, () => renderWrapper(context, render));
-};
+import { compile } from "path-to-regexp";
 
-export const errorProvider = () => {
-  return store.getStore()?.error;
-};
-`,rr=`import type { FetchApp, NodeApp } from "@kosmojs/core";
-import type { Transport } from "@kosmojs/core/fetch";
+import type { PageRoute } from "@kosmojs/core";
 
-import {
-  isFetchApp,
-  maxRedirects,
-  redirectCodes,
-  ssrOrigin,
-  store,
-} from "./base";
+import routes from "{{ createImport 'lib' 'ssg:routes' }}";
+import { base } from "{{ createImport 'libCore' }}";
 
-import { apiApp } from "{{ createImport 'lib' '@ssr/api' }}";
+type StaticParams = Array<Array<string | number | Array<string | number>>>;
 
 /**
- * HeadersProvider for createTransport.
+ * Where a page declares the parameter sets to pre-render:
+ *   - a \`staticParams\` named export - React/Solid page modules,
+ *     a plain \`<script>\` block in Vue, a \`<script module>\` block in Svelte
+ *   - \`staticParams\` in MDX frontmatter
+ * Each entry is positional, in the route's parameter order.
  * */
-const headersProvider = (): HeadersInit | undefined => {
-  return store.getStore()?.headers;
+const staticParamsOf = (module: unknown): StaticParams | undefined => {
+  const { staticParams, frontmatter } = (module ?? {}) as {
+    staticParams?: unknown;
+    frontmatter?: { staticParams?: unknown };
+  };
+  const value = staticParams ?? frontmatter?.staticParams;
+  return Array.isArray(value) ? (value as StaticParams) : undefined;
 };
 
-const createDispatch = (app: FetchApp | NodeApp) => {
-  return isFetchApp(app)
-    ? app.fetch
-    : async (request: Request): Promise<Response> => {
-        const { inject } = await import("light-my-request");
-
-        /**
-         * Node dispatch: serializes the web Request into light-my-request's
-         * injection format and lifts the injected response back into a web Response.
-         * */
-        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));
-            }
-          }
+const paramsMapper = (
+  params: PageRoute["params"],
+  value: StaticParams[number],
+) => {
+  return params.schema.reduce<Record<string, unknown>>(
+    (map, { name, kind }, i) => {
+      if (kind === "splat") {
+        if (Array.isArray(value[i]) && value[i].length) {
+          map[name] = value[i].map(String);
         }
-
-        /**
-         * 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
-     * on the call itself wins over forwarded values.
-     * */
-    const headers = new Headers(init?.headers);
-
-    // When the body is FormData, the Request constructor sets a multipart
-    // Content-Type with a fresh boundary. A forwarded Content-Type default would
-    // override that boundary and desync it from the serialized body, so never
-    // forward Content-Type for FormData bodies.
-    const isFormBody = init?.body instanceof FormData;
-
-    for (const [key, value] of new Headers(headersProvider() || undefined)) {
-      if (isFormBody && key.toLowerCase() === "content-type") {
-        continue;
-      }
-      if (!headers.has(key)) {
-        headers.set(key, value);
-      }
-    }
-
-    let request = new Request(new URL(String(input), ssrOrigin), {
-      ...init,
-      headers,
-    });
-
-    /**
-     * Bodies are buffered once so they can be replayed across
-     * 307/308 hops; the client only ever sends strings, FormData
-     * and buffer-ish payloads, so this is safe and cheap.
-     * */
-    const body = ["GET", "HEAD"].includes(request.method)
-      ? undefined
-      : await request.arrayBuffer();
-
-    for (let hop = 0; ; hop++) {
-      if (hop === maxRedirects) {
-        throw new TypeError("Failed to fetch: too many redirects");
+      } else if (value[i] !== undefined) {
+        map[name] = String(value[i]);
       }
+      return map;
+    },
+    {},
+  );
+};
 
-      const response = await dispatch(
-        body === undefined || request.method === "GET"
-          ? new Request(request, { body: null })
-          : new Request(request, { body }),
-      );
-
-      const location = response.headers.get("location");
-
-      if (!location || !redirectCodes.includes(response.status)) {
-        return response;
-      }
+export default Object.entries(routes)
+  .flatMap(([name, { module, pathPattern, params }]) => {
+    if (!params.schema.length) {
+      // static route
+      return [pathPattern.replace(/^index\\/?/, "")];
+    }
 
-      const method =
-        response.status === 303 ||
-        ([301, 302].includes(response.status) && request.method === "POST")
-          ? "GET"
-          : request.method;
+    const staticParams = staticParamsOf(module);
 
-      request = new Request(new URL(location, request.url), {
-        method,
-        headers: request.headers,
-      });
+    // a dynamic route without staticParams has nothing to pre-render
+    if (!staticParams) {
+      return [];
     }
-  };
-};
 
-const ssrTransport = apiApp ? createTransport(apiApp as never) : undefined;
+    const toPath = compile(pathPattern);
 
-export const transport = ssrTransport
-  ? async (input: RequestInfo | URL, init?: RequestInit) => {
+    return staticParams.flatMap((entry) => {
       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,
-        ]);
+        return [toPath(paramsMapper(params, entry) as never)];
       } 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;
+        console.error(\`❗SSG: Failed building path for \${name}\`);
+        console.error(error);
+        return [];
       }
-    }
-  : undefined; // let fetch clients pick the transport
+    });
+  })
+  .map((path) => join(base, path));
+`,xr=`import type { PageRoute } from "@kosmojs/core";
 
-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";
-  }
-}
+{{#each pageRoutes}}
+import * as {{id}} from "{{ createImport 'pages' file }}";
+{{/each}}
 
-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);
+type SSGRoute = {
+  // the page module as imported; the shape differs per framework
+  module: unknown;
+  pathPattern: string;
+  params: PageRoute["params"];
+};
+
+const routeMap: Record<string, SSGRoute> = {
+{{#each pageRoutes}}
+  "{{name}}": {
+    module: {{id}},
+    pathPattern: "{{pathPattern}}",
+    params: {{serializeParams .}},
+  },
+{{/each}}
+};
+
+export default routeMap;
+`,Sr=v(a=>{let{generators:o=[],refineTypeName:s,...c}={...a.config},{base:l}=c,{createPath:u,createImportHelpers:f}=S(a),{renderToFile:p}=w({helpers:{...f({origin:`lib`}),...A(),serializeParams(e){return JSON.stringify(e.params)}}}),m=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(E);await p(u.lib(`ssg:routes.ts`),xr,{pageRoutes:t})};return{async start(){await p(u.lib(`ssg.ts`),br,{})},async watch(e){await m(e)},async build(e){await m(e)},async postBuild(){let s=u.distDir(`ssg`),f=r(s,`../ssr/server.js`);if(!await ce(f,le.F_OK).then(()=>!0,()=>!1)){console.error(),console.error(i(`red`,`❗Please enable ssrGenerator in ${a.name}/kosmo.config.ts`)),console.error(`  SSG generator can not run without SSR server`),console.error();return}let p=ee(`${a.name}: SSG`);p.append(`preparing...`);let{createApp:m}=await import(f);p.append(`bundling routes...`),await M(y(c,...o.map(({factory:e})=>e(a).config?.({kind:`client`,command:`build`})),{root:u.lib(),appType:`custom`,plugins:[O.tsconfigPaths(a),O.nodePrefix(),O.virtualModules(d(a,o),{kind:`csr`,command:`build`})],resolve:{conditions:[`node`]},build:{ssr:u.lib(`ssg.ts`),target:`esnext`,sourcemap:!1,emptyOutDir:!0,rolldownOptions:{output:{dir:s,entryFileNames:`routes.js`,format:`esm`}}}}));try{let i=await import(t(s,`routes.js`)).then(e=>e.default),a=new Map,o=await m(e=>{a.set(new URL(e.url).pathname,{error:e.message})});for(let[e,t]of i.entries()){p.append(`[ ${e+1} of ${i.length} ] ${t}`);try{let e=await Cr(o,t);a.has(t)||a.set(t,{html:e})}catch(e){a.has(t)||a.set(t,{error:String(e)})}}let c=[...a.entries()].flatMap(([e,t])=>`error`in t?[[e,t.error]]:[]);if(c.length)throw p.failed(`failed ❗`),Error([`SSG: failed rendering ${c.length} route(s):`,...c.map(([e,t])=>`  ${e} - ${t}`)].join(`
+`));await P(r(s,`../ssr/assets`),t(s,`assets`),{recursive:!0});let u=r(s,`../ssr/public`);await x(u)&&await P(u,s,{recursive:!0});for(let[r,i]of a)if(`html`in i){let a=t(s,n.relative(l,r),`index.html`);await ue(e(a),{recursive:!0}),await de(a,i.html,`utf8`)}p.succeed(`done ✨`)}finally{await F(`${s}/routes.js`)}}}}),Cr=async(e,t)=>{let n=await e.fetch(new Request(`http://localhost${t}`));if(!n.ok)throw Error(`app responded with ${n.status}`);return n.text()},wr=_({meta:{name:`SSG`,slot:`ssg`},factory:Sr}),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`,tinyglobby:`^0.2.17`}},Tr=`import { type RequestContext, store } from "{{ createImport 'libCore' 'ssr' }}";
+import { renderWrapper } from "{{ createImport 'libEntry' 'server' }}";
+
+export { default as backendApp } from "virtual:kosmo/backend-app";
+
+export { default as ssrApp } from "{{ createImport 'entry' 'server' }}";
+
+/**
+ * Wrap a render call, making the given context visible to every component
+ * */
+export const withSsrContext = <T>(
+  context: RequestContext,
+  render: () => T,
+): T => {
+  return store.run(context, () => renderWrapper(context, render));
+};
+
+export const errorProvider = () => {
+  return store.getStore()?.error;
 };
-`,ir=`export const routeMap = [
+`,Er=`export const routeMap = [
 {{#each pageRoutes}}
   { pathPattern: "{{honoPattern}}", renderMode: "{{renderMode}}" },
 {{/each}}
 ];
-`,ar=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
+`,Dr=`import { access, chmod, constants, readFile, unlink } from "node:fs/promises";
 import {
   createServer,
   type IncomingMessage,
@@ -5564,20 +6337,25 @@ import { extname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parseArgs, styleText } from "node:util";
 
-import { createAdaptorServer, getRequestListener } from "@hono/node-server";
+import { getRequestListener } from "@hono/node-server";
 import { type Context, Hono } from "hono";
 import { HTTPException } from "hono/http-exception";
 import { stream } from "hono/streaming";
 import { glob } from "tinyglobby";
 
-import type { FetchApp, NodeApp, SSRSetup } from "@kosmojs/core";
-
-import { isFetchApp, redirectCodes, ssrOrigin } from "./@ssr/base";
+import {
+  type FetchApp,
+  MIME_TYPES,
+  type NodeApp,
+  type SSRSetup,
+} from "@kosmojs/core";
 
 import { routeMap } from "{{ createImport 'lib' '@ssr/routes' }}";
 import { apiBase, base } from "{{ createImport 'libCore' }}";
+import { redirectCodes, ssrOrigin } from "{{ createImport 'libCore' 'ssr' }}";
 
 const ROOT = import.meta.dirname;
+const HEAD_CLOSE_PATTERN = /<\\/head\\s*>/i;
 
 type AssetInfo = {
   file: string;
@@ -5587,9 +6365,13 @@ type AssetInfo = {
   contentType: string;
   // Cached size to set Content-Length without re-measuring the buffer.
   size: number;
+  // Cache-Control header - hashed assets are immutable, public/ files are not.
+  cacheControl: string;
 };
 
-export const createApp = async () => {
+export const createApp = async (
+  errorHandler?: (error: Error & { url: string }) => void | undefined,
+) => {
   // Import the SSR entry produced by Vite's ssr build.
   const {
     ssrApp,
@@ -5604,8 +6386,7 @@ export const createApp = async () => {
     errorProvider: () => Error | undefined;
   } = await import(\`\${ROOT}/app.js\`);
 
-  // Read the client index.html that includes <!--app-head--> and <!--app-html-->
-  // placeholders used for SSR injection.
+  // Read the client index.html that includes <!--app-html--> placeholder
   const template = await readFile(\`\${ROOT}/index.html\`, "utf8");
 
   // Load the Vite manifest
@@ -5613,8 +6394,9 @@ export const createApp = async () => {
     with: { type: "json" },
   }).then((e) => e.default);
 
-  const { renderToString, renderToStream } = ssrApp;
-  const [htmlStart, htmlEnd] = template.split("<!--app-html-->");
+  const { renderToString, renderToStream, onError } = ssrApp;
+
+  const [htmlStart, htmlEnd = ""] = template.split(/<!--\\s*app-html\\s*-->/);
 
   const assets = await loadAssets(ROOT);
 
@@ -5660,6 +6442,29 @@ export const createApp = async () => {
     };
   };
 
+  const handleError = (url: string, error: Error, fallback: Function) => {
+    // assign, not spread: message and stack are non-enumerable on Error,
+    // a spread silently drops them
+    Object.assign(error, { url });
+    if (onError) {
+      onError(error as never);
+    } else {
+      fallback();
+    }
+    errorHandler?.(error as never);
+  };
+
+  const injectHead = (html: string, head: string) => {
+    const error = "WARN: missing </head> - required for SSR head injection";
+    if (HEAD_CLOSE_PATTERN.test(html)) {
+      return html.replace(HEAD_CLOSE_PATTERN, (headEnd) => {
+        return [head, headEnd].join("\\n");
+      });
+    }
+    console.error(error);
+    return \`\${html}\\n<script>console.error("\${error}")<\/script>\`;
+  };
+
   const renderPage = async (url: URL, ctx: Context) => {
     const {
       head = "",
@@ -5690,27 +6495,51 @@ export const createApp = async () => {
     );
 
     if (error) {
-      console.error("WARN: SSR failed, fallback to CSR");
-      console.error(error);
-      console.error();
+      const errorMessage = "WARN: SSR failed, fallback to CSR";
+      handleError(ctx.req.url, error as never, () => {
+        console.error(errorMessage);
+        console.error(error);
+        console.error();
+      });
       return [
-        htmlStart.replace(
-          "<!--app-head-->",
-          \`<script>console.error("WARN: SSR failed, fallback to CSR")<\/script>\`,
+        injectHead(
+          htmlStart,
+          \`<script>console.error("\${errorMessage}")<\/script>\`,
         ),
         htmlEnd,
       ].join("");
     }
 
-    return [
-      htmlStart.replace("<!--app-head-->", head),
-      html ?? "",
-      htmlEnd,
-    ].join("");
+    return [injectHead(htmlStart, head), html ?? "", htmlEnd].join("");
   };
 
   const app = new Hono({ strict: false });
 
+  // Static files win over routes, as they do in vite dev and behind a reverse proxy.
+  // This covers hashed assets/ (JS, CSS, images, fonts, .map siblings) and public/ files.
+  app.use(async (ctx, next) => {
+    if (!["GET", "HEAD"].includes(ctx.req.method)) {
+      return next();
+    }
+
+    const asset = assets.get(ctx.req.path);
+
+    if (!asset) {
+      return next();
+    }
+
+    return new Response(
+      ctx.req.method === "HEAD" ? null : (asset.buffer as never),
+      {
+        headers: {
+          "Content-Type": asset.contentType,
+          "Content-Length": String(asset.size),
+          "Cache-Control": asset.cacheControl,
+        },
+      },
+    );
+  });
+
   for (const { pathPattern, renderMode } of routeMap) {
     app.get(join(base, pathPattern), async (ctx) => {
       try {
@@ -5724,16 +6553,37 @@ export const createApp = async () => {
         if (renderMode === "stream" && typeof renderToStream === "function") {
           ctx.header("Content-Type", "text/html");
           return stream(ctx, async (stream) => {
-            const { head = "", html } = await withSsrContext(
-              {
-                headers: Object.fromEntries(ctx.req.raw.headers),
-                url: ctx.req.url,
-              },
-              () => renderToStream(url, ssrOptions(), stream as never),
-            );
-            await stream.write(htmlStart.replace("<!--app-head-->", head));
-            await stream.pipe(html);
-            await stream.write(htmlEnd);
+            let error: Error | undefined;
+
+            /**
+             * Stream failures surface here, not in a catch upstream:
+             * on solid and vue pipe rejects; react shell errors reject the render promise itself.
+             * The shell may already be on the wire -
+             * reporting is all that is left to do, the response cannot be replaced.
+             * */
+            try {
+              const { head = "", html } = await withSsrContext(
+                {
+                  headers: Object.fromEntries(ctx.req.raw.headers),
+                  url: ctx.req.url,
+                },
+                () => renderToStream(url, ssrOptions(), stream as never),
+              );
+              await stream.write(injectHead(htmlStart, head));
+              await stream.pipe(html);
+              error = errorProvider();
+              await stream.write(htmlEnd);
+            } catch (e: any) {
+              error = e;
+            }
+
+            if (error) {
+              handleError(ctx.req.url, error, () => {
+                console.error("ERROR: SSR stream render failed");
+                console.error(error);
+                console.error();
+              });
+            }
           });
         }
 
@@ -5758,21 +6608,6 @@ export const createApp = async () => {
   }
 
   app.get("/*", async (ctx) => {
-    const { path } = ctx.req;
-
-    // If incoming request path matches something cached at startup, serve it directly.
-    // This covers JS, CSS, images, fonts, etc., including their .map siblings.
-    const asset = assets.get(path);
-
-    if (asset) {
-      return new Response(asset.buffer as never, {
-        headers: {
-          "Content-Type": asset.contentType,
-          "Content-Length": String(asset.size),
-        },
-      });
-    }
-
     // render 404 page
     if (typeof renderToString === "function") {
       const url = new URL(ctx.req.url);
@@ -5791,47 +6626,47 @@ export const createApp = async () => {
  * Build an in-memory asset graph, loading asset content into memory.
  * The asset graph always includes every built asset URL so the SSR server
  * can correctly recognize static asset requests.
+ *
+ * Two roots, each directory being its own allowlist - nothing else in the bundle root is served:
+ *   - assets/ - emitted by vite with content hashes, served at base/assets/, cacheable forever
+ *   - public/ - copied verbatim from the folder's public dir, served at base/, names are stable so clients must revalidate
  * */
-const loadAssets = async (
-  root: string,
-  patterns: string | Array<string> = "**",
-) => {
-  const mimeTypeMap: Record<string, string> = {
-    ".js": "application/javascript",
-    ".mjs": "application/javascript",
-    ".css": "text/css",
-    ".json": "application/json",
-    ".png": "image/png",
-    ".apng": "image/png",
-    ".jpg": "image/jpeg",
-    ".jpeg": "image/jpeg",
-    ".gif": "image/gif",
-    ".svg": "image/svg+xml",
-    ".ico": "image/x-icon",
-    ".woff": "font/woff",
-    ".woff2": "font/woff2",
-    ".ttf": "font/ttf",
-    ".webp": "image/webp",
-  };
-
+const loadAssets = async (root: string) => {
   // Resolve HTTP Content-Type from the asset's file extension.
   const contentTypeResolver = (filePath: string) => {
     const ext = extname(filePath).toLowerCase();
-    return mimeTypeMap[ext] || "application/octet-stream";
+    return MIME_TYPES[ext] || "application/octet-stream";
   };
 
   // Map from URL path (as used in requests) to asset metadata.
   const assetCache = new Map<string, AssetInfo>();
 
-  const folder = "assets";
-  const cwd = resolve(root, folder);
+  const roots = [
+    {
+      folder: "assets",
+      prefix: join(base, "assets"),
+      cacheControl: "public, max-age=31536000, immutable",
+    },
+    {
+      folder: "public",
+      prefix: base,
+      cacheControl: "no-cache",
+    },
+  ];
+
+  for (const { folder, prefix, cacheControl } of roots) {
+    const cwd = resolve(root, folder);
+
+    const readable = await access(cwd, constants.F_OK).then(
+      () => true,
+      () => false,
+    );
+
+    if (!readable) {
+      continue;
+    }
 
-  if (
-    await access(cwd, constants.R_OK)
-      .then(() => true)
-      .catch(() => false)
-  ) {
-    const files = await glob(patterns, {
+    const files = await glob("**", {
       cwd,
       onlyFiles: true,
       absolute: false,
@@ -5839,11 +6674,12 @@ const loadAssets = async (
 
     for (const file of files) {
       const buffer = new Uint8Array(await readFile(resolve(cwd, file)));
-      assetCache.set(join(base, folder, file), {
+      assetCache.set(join(prefix, file), {
         file,
         buffer,
         contentType: contentTypeResolver(file),
-        size: buffer?.length,
+        size: buffer.length,
+        cacheControl,
       });
     }
   }
@@ -5854,11 +6690,40 @@ const loadAssets = async (
 type NodeListener = (req: IncomingMessage, res: ServerResponse) => void;
 
 const createNodeListener = (app: FetchApp | NodeApp): NodeListener => {
-  return isFetchApp(app)
+  return typeof (app as FetchApp).fetch === "function"
     ? getRequestListener((app as FetchApp).fetch)
     : (app as NodeApp).callback();
 };
 
+/**
+ * The folder's complete request surface as a single node:http listener:
+ * API requests under \`apiBase\` go to the bundled backend, everything else to the SSR app.
+ * \`startServer\` binds it to a port/socket; \`dist/run.js\` mounts it next to other folders.
+ * */
+export const createListener = async (): Promise<NodeListener> => {
+  const {
+    backendApp,
+  }: {
+    backendApp: FetchApp | NodeApp;
+  } = await import(\`\${ROOT}/app.js\`);
+
+  const ssrApp = await createApp();
+  const apiPrefix = join(base, apiBase);
+
+  const ssrListener = createNodeListener(ssrApp as never);
+
+  const apiListener = backendApp
+    ? createNodeListener(backendApp as never)
+    : async () => {};
+
+  return (req, res) => {
+    const { pathname } = new URL(req.url ?? "/", ssrOrigin);
+    return pathname === apiPrefix || pathname.startsWith(\`\${apiPrefix}/\`)
+      ? apiListener(req, res)
+      : ssrListener(req, res);
+  };
+};
+
 export const startServer = async ({
   sock,
   port,
@@ -5870,12 +6735,6 @@ export const startServer = async ({
     throw new Error("Please provide either -p/--port or -s/--sock");
   }
 
-  const {
-    apiApp,
-  }: {
-    apiApp: FetchApp | NodeApp;
-  } = await import(\`\${ROOT}/app.js\`);
-
   if (sock) {
     // Clean up any stale socket file before binding.
     await unlink(sock).catch((error) => {
@@ -5892,23 +6751,7 @@ export const startServer = async ({
     sock ? \`sock: \${sock}\` : \`port: \${port}\`,
   );
 
-  const ssrApp = await createApp();
-  const apiPrefix = join(base, apiBase);
-
-  const ssrListener = createNodeListener(ssrApp as never);
-
-  const apiListener = apiApp
-    ? createNodeListener(apiApp as never)
-    : async () => {};
-
-  const gatewayListener: NodeListener = (req, res) => {
-    const { pathname } = new URL(req.url ?? "/", ssrOrigin);
-    return pathname === apiPrefix || pathname.startsWith(\`\${apiPrefix}/\`)
-      ? apiListener(req, res)
-      : ssrListener(req, res);
-  };
-
-  const server = createServer(gatewayListener);
+  const server = createServer(await createListener());
 
   server.listen(sock || port, async () => {
     if (sock) {
@@ -5922,24 +6765,6 @@ export const startServer = async ({
   return server;
 };
 
-export const createDisposableServer = async (
-  callback: (port: number) => Promise<void>,
-) => {
-  const app = await createApp();
-  const server = createAdaptorServer(app).listen(0); // OS picks a free port
-  const address = server.address();
-
-  if (!address || typeof address === "string") {
-    throw new Error("SSR: Failed starting disposable server on a free port");
-  }
-
-  try {
-    await callback(address.port);
-  } finally {
-    server.close();
-  }
-};
-
 const isMain = fileURLToPath(import.meta.url) === resolve(process.argv[1]);
 
 if (isMain) {
@@ -5970,14 +6795,14 @@ if (isMain) {
     process.exit(1);
   }
 }
-`,or=`string`,sr=g((e,r)=>{let{generators:i=[],refineTypeName:a,...o}=e.config,{createPath:c,createImportHelpers:l}=y(e),{renderToFile:u}=x({helpers:{...l({origin:`lib`})}});return{async build(e){let t=r?.renderMode?typeof r.renderMode==`string`?()=>r.renderMode:s(r?.renderMode,`string`):()=>or,n={renderMode:JSON.stringify(r?.renderMode||null),pageRoutes:e.flatMap(e=>e.kind===`pageRoute`?[{...e.entry,renderMode:t(e.entry.name)}]:[]).sort(S),apiGenerator:i.some(e=>e.meta.slot===`backend`)};for(let[e,t]of[[`ssr.ts`,ar],[`@ssr/api.ts`,er],[`@ssr/__kosmo_ssr_bundle.ts`,nr],[`@ssr/base.ts`,tr],[`@ssr/fetch.ts`,rr],[`@ssr/routes.ts`,ir]])await u(c.lib(e),t,n)},async postBuild(){let r=c.distDir(`ssr`),a=[C.tsconfigPaths(e),C.nodePrefix()];for(let t of i)await t.factory(e).ssrBuild?.();await E(_(o,...i.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:c.src(),plugins:a,define:{KOSMO_PRODUCTION_BUILD:`true`},build:{ssr:c.lib(`@ssr/__kosmo_ssr_bundle`),ssrEmitAssets:!0,sourcemap:!0,emptyOutDir:!0,minify:!1,rolldownOptions:{output:{dir:r,entryFileNames:`app.js`,format:`esm`}}}})),await E({root:c.lib(),configFile:!1,appType:`custom`,plugins:a,resolve:{conditions:[`node`]},build:{ssr:c.lib(`ssr.ts`),target:`esnext`,sourcemap:!0,emptyOutDir:!0,rolldownOptions:{output:{dir:t(r,`server`),entryFileNames:`server.js`,format:`esm`}}}}),await O(n(r,`../client`),r,{recursive:!0});for(let e of[`server.js`,`server.js.map`])await O(`${r}/server/${e}`,`${r}/${e}`);await k(`${r}/server`,{recursive:!0,force:!0})}}}),cr=h({meta:{name:`SSR`,slot:`ssr`},dependencies:{tinyglobby:q.devDependencies.tinyglobby,hono:q.devDependencies.hono,"@hono/node-server":q.devDependencies[`@hono/node-server`],"light-my-request":q.devDependencies[`light-my-request`]},factory:sr}),J={type:`module`,private:!0,name:`@kosmojs/svelte-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@sveltejs/vite-plugin-svelte":`^7.3.0`,vite:`^8.2.2`},devDependencies:{"@tanstack/svelte-query":`^6.1.41`,"path-to-regexp":`^8.4.2`,svelte:`^5.56.10`}},lr=()=>{let e=[`🎉 Well done! You just created a new Svelte page.`,`🚀 Success! A fresh Svelte page is ready to roll.`,`🌟 Nice work! Another Svelte page added to your app.`,`🧩 All set! A new Svelte page has been scaffolded.`,`🔧 Scaffold complete! Your new Svelte page is in place.`,`✅ Built! Your Svelte page is scaffolded and ready.`,`✨ Fantastic! Your new Svelte page is good to go.`,`🎯 Nailed it! A brand new Svelte page just landed.`,`💫 Awesome! Another Svelte page joins the party.`,`⚡ Lightning fast! A new Svelte page created successfully.`];return e[Math.floor(Math.random()*e.length)]},Y=`<script lang="ts">
+`,Or=`string`,kr=v((e,n)=>{let{createPath:i,createImportHelpers:a}=S(e),{generators:o,refineTypeName:s,...l}=e.config,{renderToFile:u}=w({helpers:{...a({origin:`lib`})}});return{async build(e){let t=n?.renderMode?typeof n.renderMode==`string`?()=>n.renderMode:c(n?.renderMode,`string`):()=>Or,r={renderMode:JSON.stringify(n?.renderMode||null),pageRoutes:e.flatMap(e=>e.kind===`pageRoute`?[{...e.entry,renderMode:t(e.entry.name)}]:[]).sort(E),apiGenerator:o.some(e=>e.meta.slot===`backend`)};for(let[e,t]of[[`ssr.ts`,Dr],[`@ssr/__kosmo_ssr_bundle.ts`,Tr],[`@ssr/routes.ts`,Er]])await u(i.lib(e),t,r)},async postBuild(){if(!o.some(e=>e.meta.slot===`frontend`))return;let n=i.distDir(`ssr`),a=[O.tsconfigPaths(e),O.nodePrefix(),O.virtualModules(d(e,o),{kind:`ssr`,command:`build`})];await M(y(l,...o.map(({factory:t})=>t(e).config?.({kind:`client`,command:`build`})),{root:i.src(),plugins:a,build:{ssr:i.lib(`@ssr/__kosmo_ssr_bundle`),ssrEmitAssets:!0,sourcemap:!0,emptyOutDir:!0,minify:!1,copyPublicDir:!1,rolldownOptions:{output:{dir:n,entryFileNames:`app.js`,format:`esm`}}}})),await M({root:i.lib(),configFile:!1,appType:`custom`,plugins:a,resolve:{conditions:[`node`]},build:{ssr:i.lib(`ssr.ts`),target:`esnext`,sourcemap:!0,emptyOutDir:!0,rolldownOptions:{output:{dir:t(n,`server`),entryFileNames:`server.js`,format:`esm`}}}});for(let e of[`.vite`,`assets`,`index.html`])await P(r(n,`../client`,e),t(n,e),{recursive:!0});if(![!1,``].includes(l.publicDir)){let e=r(i.src(),l.publicDir||`public`);await x(e)&&await P(e,t(n,`public`),{recursive:!0})}for(let e of[`server.js`,`server.js.map`])await P(`${n}/server/${e}`,`${n}/${e}`);await F(`${n}/server`,{recursive:!0,force:!0})}}}),Ar=_({meta:{name:`SSR`,slot:`ssr`},dependencies:{tinyglobby:q.devDependencies.tinyglobby,hono:q.devDependencies.hono,"@hono/node-server":q.devDependencies[`@hono/node-server`]},factory:kr}),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.41`,"path-to-regexp":`^8.4.2`,svelte:`^5.56.10`}},jr=()=>{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()}
-`,ur=`<script lang="ts">
+`,Mr=`<script lang="ts">
   import { type QueryClient, QueryClientProvider } from "@tanstack/svelte-query";
   import type { Snippet } from "svelte";
 
@@ -5994,7 +6819,7 @@ if (isMain) {
 <QueryClientProvider client={queryClient}>
   {@render children()}
 </QueryClientProvider>
-`,dr=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
+`,Nr=`import { hydrate as hydrateOrig, mount as mountOrig } from "svelte";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -6035,7 +6860,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,fr=`import { render as renderOrig } from "svelte/server";
+`,Pr=`import { render as renderOrig } from "svelte/server";
 
 import type {
   RenderToStringWrapper,
@@ -6101,12 +6926,18 @@ export const renderToString: RenderToStringWrapper<
 // svelte/server exposes only render() - no web-stream renderer -
 // so this folder is string-only SSR.
 export default serverRenderFactory<false>();
-`,pr=`declare module "*.svelte" {
+`,Fr=`declare module "*.svelte" {
   import type { Component } from "svelte";
   const component: Component;
   export default component;
 }
-`,mr=`<script lang="ts">
+
+declare module "virtual:kosmo/tsq-client" {
+  import type { QueryClient, QueryClientConfig } from "@tanstack/svelte-query";
+  export const createQueryClient: (options?: QueryClientConfig) => QueryClient;
+  export const getQueryClient: () => QueryClient;
+}
+`,Ir=`<script lang="ts">
   /**
    * Folds [app, ...layouts] around the page component.
    *
@@ -6140,7 +6971,7 @@ export default serverRenderFactory<false>();
 {/snippet}
 
 {@render layer(0)}
-`,hr=`<script lang="ts">
+`,Lr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let { headline }: { headline?: string } = $props();
@@ -6172,7 +7003,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,gr=`<script lang="ts">
+`,Rr=`<script lang="ts">
   import styles from "./styles.module.css";
 
   let {
@@ -6217,7 +7048,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,_r=`* {
+`,zr=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -6352,7 +7183,7 @@ export default serverRenderFactory<false>();
   align-items: center;
   gap: 0.25rem;
 }
-`,vr=`<script lang="ts">
+`,Br=`<script lang="ts">
   import styles from "./styles.module.css";
 <\/script>
 
@@ -6410,7 +7241,7 @@ export default serverRenderFactory<false>();
     </div>
   </div>
 </div>
-`,yr=`export type ParamsMap = {
+`,Vr=`export type ParamsMap = {
 {{#each pageRoutes}}"{{name}}": {{serializeParamsLiteral .}};
 {{/each}}
 };
@@ -6419,26 +7250,27 @@ export const paramNames = {
 {{#each pageRoutes}}"{{name}}": [ {{#each params.schema}}"{{name}}", {{/each}}],
 {{/each}}
 } as const;
-`,br=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,Hr=`export * from "virtual:kosmo/tsq-client";
+`,Ur=`import { QueryClient } from "@tanstack/svelte-query";
 
-let client: QueryClient | undefined;
+let client = undefined;
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   client = new QueryClient(options);
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   if (!client) {
     client = new QueryClient();
   }
   return client;
 };
-`,xr=`import { QueryClient, type QueryClientConfig } from "@tanstack/svelte-query";
+`,Wr=`import { QueryClient } from "@tanstack/svelte-query";
 
-import { store } from "{{ createImport 'lib' '@ssr/base' }}";
+import { store } from "{{ createImport 'libCore' 'ssr' }}";
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   const client = new QueryClient(options);
   const ctx = store?.getStore();
   if (ctx) {
@@ -6447,7 +7279,7 @@ export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   const ctx = store?.getStore();
   if (!ctx) {
     throw new Error("getQueryClient(): called outside an SSR request scope");
@@ -6455,9 +7287,9 @@ export const getQueryClient = (): QueryClient => {
   if (!ctx.tsqClient) {
     ctx.tsqClient = new QueryClient();
   }
-  return ctx.tsqClient as QueryClient;
+  return ctx.tsqClient;
 };
-`,Sr=`import type { RouterFactoryReturn } from "@kosmojs/core";
+`,Gr=`import type { RouterFactoryReturn } from "@kosmojs/core";
 import { createRouterFactory } from "@kosmojs/core/generators";
 
 import Layouts from "./Layouts.svelte";
@@ -6497,7 +7329,7 @@ export default createRouterFactory<
   Promise<RouteComponent>,
   { server: { route: Route } }
 >();
-`,Cr=`import { match, pathToRegexp } from "path-to-regexp";
+`,Kr=`import { match, pathToRegexp } from "path-to-regexp";
 import { type Component, createContext } from "svelte";
 
 import { parseSearchParams } from "@kosmojs/core";
@@ -6517,7 +7349,6 @@ export type AnyComponent = Component<any, any, any>;
 
 export type RawRoute = {
   name: string;
-  pathSegments: number | undefined;
   regexp: RegExp;
   extractParams: (path: string) => Route["params"];
   loader: () => Promise<RouteModule>;
@@ -6608,23 +7439,19 @@ 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
-      const matchedRoutes = routes.filter(({ regexp }) => {
-        return regexp.test(url.pathname);
-      });
 
+      // The routes array is generated pre-sorted by specificity
+      // (static beats required beats optional beats splat, token by token),
+      // the same ordering the SSR server registers routes in -
+      // so the first pattern that matches IS the most specific one, and CSR resolution stays consistent with SSR.
+      // A route with optional parameters matches a range of segment counts,
+      // which is why no segment-count heuristic can disambiguate here.
+      // Lightweight \`RegExp.test()\` on linear scan - no capture allocation.
       const matchedRoute =
-        matchedRoutes.length > 1
-          ? matchedRoutes.find(({ pathSegments }) => {
-              return pathSegments === undefined || pathSegments === urlSegments;
-            }) || catchallRoute
-          : matchedRoutes.length === 1
-            ? matchedRoutes[0]
-            : catchallRoute;
-
-      // 2: capture params only on matched route
+        routes.find(({ regexp }) => {
+          return regexp.test(url.pathname);
+        }) || catchallRoute;
+
       const params = matchedRoute
         ? matchedRoute.extractParams(url.pathname)
         : {};
@@ -6711,11 +7538,6 @@ export const createRoute = (
   return {
     name,
     regexp,
-    // count segments of the same base-joined path the regexp matches against;
-    // resolve() compares this against the full url pathname's segment count
-    pathSegments: name.includes("...")
-      ? undefined
-      : path.split("/").filter(Boolean).length,
     extractParams: (path) => {
       const match = matcher(path);
       return match ? match.params : {};
@@ -6724,7 +7546,7 @@ export const createRoute = (
     layouts,
   };
 };
-`,wr=`import { getRouteContext } from "./svelte";
+`,qr=`import { getRouteContext } from "./svelte";
 
 import type { ParamsMap, paramNames } from "{{ createImport 'lib' 'params' }}";
 
@@ -6764,7 +7586,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
   const route = useRoute();
   return route.loaderData?.[key || route.name] as T;
 };
-`,Tr=`<script lang="ts">
+`,Jr=`<script lang="ts">
   import { AppProvider } from "{{ createImport 'lib' 'app' }}";
   import type { Snippet } from "svelte";
 
@@ -6774,7 +7596,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 <AppProvider>
   {@render children()}
 </AppProvider>
-`,Er=`<script lang="ts">
+`,Yr=`<script lang="ts">
   import type { Snippet } from "svelte";
   import type { HTMLAnchorAttributes } from "svelte/elements";
 
@@ -6798,7 +7620,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
 <\/script>
 
 <a {href} {...rest}>{@render children?.()}</a>
-`,Dr=`import renderFactory, {
+`,Xr=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -6825,7 +7647,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,Or=`import renderFactory, {
+`,Zr=`import renderFactory, {
   createRoutes,
   renderToString,
   // no renderToStream on Svelte folders
@@ -6846,31 +7668,19 @@ export default renderFactory(() => {
     },
   };
 });
-`,kr=`<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <!--app-head-->
-</head>
-<body>
-  <div id="app"><!--app-html--></div>
-  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
-</body>
-</html>
-`,Ar=`<script lang="ts">
+`,Qr=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/404.svelte' }}";
 <\/script>
 
 <PageSample />
-`,jr=`<script lang="ts">
+`,$r=`<script lang="ts">
   import type { Snippet } from "svelte";
 
   let { children }: { children: Snippet } = $props();
 <\/script>
 
 {@render children()}
-`,Mr=`<script lang="ts">
+`,ei=`<script lang="ts">
   import PageSample from "{{ createImport 'lib' 'pageSamples/page.svelte' }}";
 
   const pathMap = {
@@ -6889,7 +7699,7 @@ export default renderFactory(() => {
   routeName={"{{route.name}}"}
   {pathMap}
 />
-`,Nr=`<script lang="ts">
+`,ti=`<script lang="ts">
   import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.svelte' }}";
 <\/script>
 
@@ -6902,7 +7712,7 @@ export default renderFactory(() => {
 </svelte:head>
 
 <WelcomePage />
-`,Pr=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,ni=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 
 import app from "./app.svelte";
 
@@ -6917,7 +7727,7 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,Fr=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=e=>!e?.trim().length,s=c(t?.templates,Mr),u=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?Nr:s(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:lr()},{overwrite:o}):t===`pageLayout`&&await a(n.pages(r.file),jr,{route:r},{overwrite:o})},d=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageLayout`?[t]:[]),r=e.flatMap(({kind:e,entry:n})=>{if(e===`pageRoute`){let{name:e,file:r}=n;return[{...n,layouts:t.flatMap(t=>t.name===e||r.startsWith(`${t.name}/`)?[t]:[]).sort(S)}]}return[]}).sort(S);for(let[e,a]of[[`client.ts`,dr],[`server.ts`,fr]])await i(n.libEntry(e),a,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,yr],[`router.ts`,Sr]])await i(n.lib(e),t,{pageRoutes:r})};return{config(){let{templates:e,...n}={...t};return{plugins:fe(n)}},async start(){for(let[e,r]of[[`env.d.ts`,pr],[`svelte.ts`,Cr],[`Layouts.svelte`,mr],[`use.ts`,wr],[`pageSamples/styles.module.css`,_r],[`pageSamples/welcome.svelte`,vr],[`pageSamples/page.svelte`,gr],[`pageSamples/404.svelte`,hr],...t?.tanstack?.query?[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,ur],[`app/index.ts`,`export { default as AppProvider } from "./app-tsq.svelte";`],[`query.ts`,br]]:[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,`/** tanstack query disabled */`],[`app/index.ts`,`export { default as AppProvider } from "./app.svelte";`],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.svelte`,Ar],[`components/Link.svelte`,Er],[`app.svelte`,Tr],[`router.ts`,Pr]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:o});await a(n.src(`index.html`),kr,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,Dr],[`server.ts`,Or]])await a(n.entry(e),t,{},{overwrite:o})},async watch(e,t){await u(e.filter(m(t,[`create`]))),await d(e)},async build(e){await u(e),await d(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?xr:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),Ir=h({meta:{name:`Svelte`},dependencies(e){return{svelte:J.devDependencies.svelte,"path-to-regexp":J.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/svelte-query":J.devDependencies[`@tanstack/svelte-query`]}:{}}},factory:Fr}),Lr={type:`module`,private:!0,name:`@kosmojs/typebox-generator`,version:`0.3.0`,cacheVersion:`1`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/typebox-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,crc:`^4.3.2`,semver:`^7.8.5`},devDependencies:{"@kosmojs/core-generator":`workspace:^`,"@kosmojs/koa-generator":`workspace:^`,typebox:`^1.3.18`}},Rr=`import Type from "typebox";
+`,ri=v((e,t)=>{let{createPath:n,createImportHelpers:r}=S(e),{render:i,renderToFile:a}=w({helpers:{...r({origin:`lib`}),...A()}}),{renderToFile:o}=w({helpers:r({origin:`src`})}),s=e=>!e?.trim().length,c=l(t?.templates,ei),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await o(n.pages(r.file),r.name===`index`?ti:c(r.name,r),{route:r,title:r.name.replace(/\{([^}]+)\}/g,`$1`),message:jr()},{overwrite:s}):t===`pageLayout`&&await o(n.pages(r.file),$r,{route:r},{overwrite:s})},f=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(E)}]}return[]}).sort(D);for(let[e,i]of[[`client.ts`,Nr],[`server.ts`,Pr]])await a(n.libEntry(e),i,{pageRoutes:r,layouts:t});for(let[e,t]of[[`params.ts`,Vr],[`router.ts`,Gr]])await a(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`,Fr],[`svelte.ts`,Kr],[`Layouts.svelte`,Ir],[`use.ts`,qr],[`pageSamples/styles.module.css`,zr],[`pageSamples/welcome.svelte`,Br],[`pageSamples/page.svelte`,Rr],[`pageSamples/404.svelte`,Lr],...t?.tanstack?.query?[[`app/app.svelte`,Y],[`app/app-tsq.svelte`,Mr],[`app/index.ts`,`export { default as AppProvider } from "./app-tsq.svelte";`],[`query.ts`,Hr]]:[[`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 a(n.lib(e),r,{});for(let[e,t]of[[`pages/404.svelte`,Qr],[`components/Link.svelte`,Yr],[`app.svelte`,Jr],[`router.ts`,ni]])await o(n.src(e),t,{entryDir:u.entryDir},{overwrite:s});for(let[e,t]of[[`client.ts`,Xr],[`server.ts`,Zr]])await o(n.entry(e),t,{},{overwrite:s})},async watch(e,t){await d(e.filter(g(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)},virtualModules(){return t?.tanstack?.query?[{specifier:`virtual:kosmo/tsq-client`,csr:i(Ur,{}),ssr:i(Wr,{})}]:[]}}}),ii=_({meta:{name:`Svelte`,slot:`frontend`},dependencies(e){return{svelte:J.devDependencies.svelte,...e?.tanstack?.query?{"@tanstack/svelte-query":J.devDependencies[`@tanstack/svelte-query`]}:{}}},factory:ri}),ai={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.18`}},oi=`import Type from "typebox";
 
 /**
  * Custom types for JavaScript constructs that have no JSON Schema
@@ -6989,13 +7799,13 @@ export default {
   Buffer: TBuffer(),
   ArrayBuffer: TArrayBuffer(),
 };
-`,zr=`import type { TValidationError } from "typebox/error";
+`,si=`import type { TValidationError } from "typebox/error";
 
 import type { ValidationErrorEntry } from "@kosmojs/core";
 
 /**
  * Message codes for i18n/l10n support
- */
+ * */
 export const MESSAGE_CODES = {
   // Generic messages
 
@@ -7185,7 +7995,7 @@ export type ValidationMessages = typeof MESSAGE_CODES;
  *
  * Usage: format(ERROR_MESSAGES[ErrorCode.STRING_MIN_LENGTH], 5)
  * Result: "must be at least 5 characters long"
- */
+ * */
 const MESSAGE_MAP: Record<keyof ValidationMessages, string> = {
   // Generic messages
 
@@ -7305,7 +8115,7 @@ const MESSAGE_MAP: Record<keyof ValidationMessages, string> = {
  * Comprehensive error handler for TypeBox validation errors.
  * Supports most JSON Schema validation keywords and produces human-friendly messages
  * with i18n/l10n support through message code mapping.
- */
+ * */
 export const errorHandlerFactory = (
   customMessages?: Partial<Record<keyof ValidationMessages, string>>,
 ) => {
@@ -7313,7 +8123,7 @@ export const errorHandlerFactory = (
 
   /**
    * Formats the instancePath into a human-readable field name
-   */
+   * */
   function formatFieldPath(instancePath: string, schemaPath?: string): string {
     if (!instancePath?.trim?.()) {
       return "root";
@@ -7351,7 +8161,7 @@ export const errorHandlerFactory = (
 
   /**
    * Pluralizes a word based on count
-   */
+   * */
   function pluralize(
     count: number,
     plural: string = messageMap[MESSAGE_CODES.PLURAL_SUFFIX],
@@ -7361,7 +8171,7 @@ export const errorHandlerFactory = (
 
   /**
    * Maps validation error to error code and formats message
-   */
+   * */
   function getErrorCodeAndMessage(error: TValidationError): {
     code: keyof ValidationMessages;
     message: string;
@@ -7781,7 +8591,7 @@ export const errorHandlerFactory = (
        * TODO: Periodically check the TypeBox repository for implementation updates.
        * Some validation cases (minContains, prefixItems, etc.) are not yet
        * implemented by TypeBox, so they are commented out below.
-       */
+       * */
 
       /**
       case "minContains": {
@@ -7935,7 +8745,7 @@ export const errorHandlerFactory = (
           ),
         };
       }
-      */
+    * */
 
       // Default fallback
       default: {
@@ -7946,7 +8756,7 @@ export const errorHandlerFactory = (
 
   /**
    * Groups errors by field to avoid duplicate messages
-   */
+   * */
   function groupErrorsByField(
     errors: TValidationError[],
   ): Map<string, TValidationError[]> {
@@ -7965,7 +8775,7 @@ export const errorHandlerFactory = (
 
   /**
    * Prioritizes errors to show the most important one per field
-   */
+   * */
   function prioritizeErrors(errors: TValidationError[]): TValidationError {
     // Priority order: required > type > format > const/enum > other constraints
     const priority: Record<string, number> = {
@@ -7994,13 +8804,51 @@ export const errorHandlerFactory = (
     })[0];
   }
 
+  /**
+   * A failed union of literals arrives as one \`anyOf\` error plus one \`const\` error per branch,
+   * all at the same instancePath.
+   * Collapse them into a single synthetic \`enum\` error so the message reflects the whole union.
+   * */
+  function collapseLiteralUnion(
+    fieldErrors: TValidationError[],
+  ): TValidationError[] {
+    const anyOfError = fieldErrors.find((e) => e.keyword === "anyOf");
+    if (!anyOfError) {
+      return fieldErrors;
+    }
+    const branchConsts = fieldErrors.filter((e) => {
+      return e.keyword === "const"
+        ? e.schemaPath.startsWith(\`\${anyOfError.schemaPath}/anyOf/\`)
+        : false;
+    });
+    // bail unless EVERY sibling is a const branch of this anyOf -
+    // mixed unions (literal | object) keep their current behavior
+    if (
+      !branchConsts.length ||
+      fieldErrors.length !== branchConsts.length + 1
+    ) {
+      return fieldErrors;
+    }
+    return [
+      {
+        ...anyOfError,
+        keyword: "enum",
+        params: {
+          allowedValues: branchConsts.map(
+            (e) => (e.params as never)["allowedValue"],
+          ),
+        },
+      },
+    ];
+  }
+
   // ============================================================================
   // Public API
   // ============================================================================
 
   /**
    * Main function to format validation errors
-   */
+   * */
   function formatValidationErrors(
     errors: TValidationError[],
     options: {
@@ -8035,7 +8883,7 @@ export const errorHandlerFactory = (
       const formatted: ValidationErrorEntry[] = [];
 
       for (const [_, fieldErrors] of grouped) {
-        const prioritized = prioritizeErrors(fieldErrors);
+        const prioritized = prioritizeErrors(collapseLiteralUnion(fieldErrors));
         const { code, message } = getErrorCodeAndMessage(prioritized);
         formatted.push({
           keyword: prioritized.keyword,
@@ -8067,7 +8915,7 @@ export const errorHandlerFactory = (
 
   /**
    * Formats errors into a single human-readable message
-   */
+   * */
   function formatValidationErrorMessage(
     errors: TValidationError[],
     options: {
@@ -8096,7 +8944,7 @@ export const errorHandlerFactory = (
 
   /**
    * Gets a simple error summary for quick feedback
-   */
+   * */
   function getErrorSummary(errors: TValidationError[]): string {
     if (!errors?.length) {
       return messageMap[MESSAGE_CODES.VALIDATION_PASSED];
@@ -8173,7 +9021,7 @@ const format = (fmt: string, ...args: unknown[]): string => {
 
   return str;
 };
-`,Br=`import Type from "typebox";
+`,ci=`import Type from "typebox";
 import { Compile } from "typebox/compile";
 import Value from "typebox/value";
 
@@ -8225,14 +9073,14 @@ export const validationSchemaFactory = (
     },
   };
 };
-`,Vr=`import { Settings } from "typebox/system";
+`,li=`import { Settings } from "typebox/system";
 
 Settings.Set({{settings}});
 
 export { default as customTypes } from "{{customTypesImport}}";
 
 export const validationMessages = {{validationMessages}};
-`,Hr=`import type { ValidationSchemas } from "@kosmojs/core";
+`,ui=`import type { ValidationSchemas } from "@kosmojs/core";
 
 import { validationSchemaFactory } from "{{ createImport 'lib' '@typebox' }}";
 
@@ -8293,14 +9141,14 @@ export const validationSchemas: ValidationSchemas = {
   {{/each}}
   },
 };
-`,Ur={exactOptionalPropertyTypes:!0},Wr=g((e,t)=>{let{createPath:n,createImport:r,createImportHelpers:i}=y(e),{renderToFile:a}=x({helpers:{...i({origin:`lib`})}}),{validationMessages:s={},customTypesImport:c=r.lib([`@typebox/custom-types`],{origin:`lib`}),settings:l}={...t},u=async e=>{for(let{kind:t,entry:r}of e){if(t!==`apiRoute`)continue;let e=[r.params,...r.validationDefinitions.flatMap(e=>e.target===`response`?e.variants:[e.schema])].flatMap(({resolvedType:e})=>e?[e]:[]),i=[...new Set(r.validationDefinitions.flatMap(({target:e})=>Object.keys(o).includes(e)?[e]:[]))].map(e=>({target:e,methods:r.methods.flatMap(t=>{let n=r.validationDefinitions.find(n=>n.method===t&&n.target===e);return n?[{route:r.name,method:t,target:e,schema:n.schema,...n.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(n.runtimeValidation)},...n.customErrors===void 0?{}:{customErrors:JSON.stringify(n.customErrors)}}]:[]})})),s=r.methods.flatMap(e=>{let t=r.validationDefinitions.find(t=>t.method===e&&t.target===`response`);return t?[{method:e,variants:t.variants.map(e=>({route:r.name,target:`response`,...e,...t.runtimeValidation===void 0?{}:{runtimeValidation:JSON.stringify(t.runtimeValidation)},...t.customErrors===void 0?{}:{customErrors:JSON.stringify(t.customErrors)}}))}]:[]});await a(n.libApi(r.name,`schemas.ts`),Hr,{route:r,resolvedTypes:e,requestSchemas:i,responseSchemas:s})}};return{async start(){for(let[e,t]of[[`custom-types.ts`,Rr],[`error-handler.ts`,zr],[`index.ts`,Br],[`setup.ts`,Vr]])await a(n.lib(`@typebox`,e),t,{validationMessages:JSON.stringify(s),customTypesImport:c,settings:JSON.stringify({...Ur,...l})})},async watch(e,t){await u(e.filter(p(t,[`create`,`update`])))},async build(e){await u(e)}}}),X={PROPERTY:`PROPERTY`,PROPERTIES:`PROPERTIES`,ALLOWED_VALUES:`ALLOWED_VALUES`,FOUND_N_DUPLICATES:`FOUND_N_DUPLICATES`,VALIDATION_PASSED:`VALIDATION_PASSED`,VALIDATION_FAILED_PREFIX:`VALIDATION_FAILED_PREFIX`,ERROR_SUMMARY:`ERROR_SUMMARY`,PLURAL_SUFFIX:`PLURAL_SUFFIX`,FIRST:`FIRST`,SECOND:`SECOND`,THIRD:`THIRD`,FOURTH:`FOURTH`,FIFTH:`FIFTH`,TYPE_INVALID:`TYPE_INVALID`,STRING_MIN_LENGTH:`STRING_MIN_LENGTH`,STRING_MAX_LENGTH:`STRING_MAX_LENGTH`,STRING_PATTERN:`STRING_PATTERN`,STRING_FORMAT:`STRING_FORMAT`,STRING_FORMAT_EMAIL:`STRING_FORMAT_EMAIL`,STRING_FORMAT_DATE:`STRING_FORMAT_DATE`,STRING_FORMAT_DATETIME:`STRING_FORMAT_DATETIME`,STRING_FORMAT_TIME:`STRING_FORMAT_TIME`,STRING_FORMAT_URI:`STRING_FORMAT_URI`,STRING_FORMAT_URL:`STRING_FORMAT_URL`,STRING_FORMAT_UUID:`STRING_FORMAT_UUID`,STRING_FORMAT_IPV4:`STRING_FORMAT_IPV4`,STRING_FORMAT_IPV6:`STRING_FORMAT_IPV6`,STRING_FORMAT_HOSTNAME:`STRING_FORMAT_HOSTNAME`,STRING_FORMAT_JSON_POINTER:`STRING_FORMAT_JSON_POINTER`,STRING_FORMAT_REGEX:`STRING_FORMAT_REGEX`,NUMBER_MINIMUM:`NUMBER_MINIMUM`,NUMBER_MAXIMUM:`NUMBER_MAXIMUM`,NUMBER_EXCLUSIVE_MINIMUM:`NUMBER_EXCLUSIVE_MINIMUM`,NUMBER_EXCLUSIVE_MAXIMUM:`NUMBER_EXCLUSIVE_MAXIMUM`,NUMBER_MULTIPLE_OF:`NUMBER_MULTIPLE_OF`,ARRAY_MIN_ITEMS:`ARRAY_MIN_ITEMS`,ARRAY_MAX_ITEMS:`ARRAY_MAX_ITEMS`,ARRAY_UNIQUE_ITEMS:`ARRAY_UNIQUE_ITEMS`,ARRAY_CONTAINS:`ARRAY_CONTAINS`,ARRAY_MIN_CONTAINS:`ARRAY_MIN_CONTAINS`,ARRAY_MAX_CONTAINS:`ARRAY_MAX_CONTAINS`,ARRAY_PREFIX_ITEMS:`ARRAY_PREFIX_ITEMS`,ARRAY_ITEMS:`ARRAY_ITEMS`,ARRAY_UNEVALUATED_ITEMS:`ARRAY_UNEVALUATED_ITEMS`,TUPLE_MIN_ITEMS:`TUPLE_MIN_ITEMS`,TUPLE_MAX_ITEMS:`TUPLE_MAX_ITEMS`,OBJECT_REQUIRED:`OBJECT_REQUIRED`,OBJECT_ADDITIONAL_PROPERTIES:`OBJECT_ADDITIONAL_PROPERTIES`,OBJECT_MIN_PROPERTIES:`OBJECT_MIN_PROPERTIES`,OBJECT_MAX_PROPERTIES:`OBJECT_MAX_PROPERTIES`,OBJECT_PROPERTY_NAMES:`OBJECT_PROPERTY_NAMES`,OBJECT_DEPENDENCIES:`OBJECT_DEPENDENCIES`,OBJECT_UNEVALUATED_PROPERTIES:`OBJECT_UNEVALUATED_PROPERTIES`,ENUM_MISMATCH:`ENUM_MISMATCH`,CONST_MISMATCH:`CONST_MISMATCH`,CONDITIONAL_IF:`CONDITIONAL_IF`,CONDITIONAL_THEN:`CONDITIONAL_THEN`,CONDITIONAL_ELSE:`CONDITIONAL_ELSE`,COMPOSITION_ONE_OF:`COMPOSITION_ONE_OF`,COMPOSITION_ANY_OF:`COMPOSITION_ANY_OF`,COMPOSITION_ALL_OF:`COMPOSITION_ALL_OF`,COMPOSITION_NOT:`COMPOSITION_NOT`,CONTENT_DISCRIMINATOR:`CONTENT_DISCRIMINATOR`,CONTENT_ENCODING:`CONTENT_ENCODING`,CONTENT_MEDIA_TYPE:`CONTENT_MEDIA_TYPE`,CUSTOM_RANGE:`CUSTOM_RANGE`,CUSTOM_EXCLUSIVE_RANGE:`CUSTOM_EXCLUSIVE_RANGE`,CUSTOM_REGEXP:`CUSTOM_REGEXP`,CUSTOM_DYNAMIC_DEFAULTS:`CUSTOM_DYNAMIC_DEFAULTS`,CUSTOM_SELECT:`CUSTOM_SELECT`,CUSTOM_TRANSFORM:`CUSTOM_TRANSFORM`,CUSTOM_UNIQUE_ITEM_PROPERTIES:`CUSTOM_UNIQUE_ITEM_PROPERTIES`,UNKNOWN:`UNKNOWN`};X.PROPERTY,X.PROPERTIES,X.ALLOWED_VALUES,X.FOUND_N_DUPLICATES,X.VALIDATION_PASSED,X.VALIDATION_FAILED_PREFIX,X.ERROR_SUMMARY,X.PLURAL_SUFFIX,X.FIRST,X.SECOND,X.THIRD,X.FOURTH,X.FIFTH,X.TYPE_INVALID,X.STRING_MIN_LENGTH,X.STRING_MAX_LENGTH,X.STRING_PATTERN,X.STRING_FORMAT,X.STRING_FORMAT_EMAIL,X.STRING_FORMAT_DATE,X.STRING_FORMAT_DATETIME,X.STRING_FORMAT_TIME,X.STRING_FORMAT_URI,X.STRING_FORMAT_URL,X.STRING_FORMAT_UUID,X.STRING_FORMAT_IPV4,X.STRING_FORMAT_IPV6,X.STRING_FORMAT_HOSTNAME,X.STRING_FORMAT_JSON_POINTER,X.STRING_FORMAT_REGEX,X.NUMBER_MINIMUM,X.NUMBER_MAXIMUM,X.NUMBER_EXCLUSIVE_MINIMUM,X.NUMBER_EXCLUSIVE_MAXIMUM,X.NUMBER_MULTIPLE_OF,X.ARRAY_MIN_ITEMS,X.ARRAY_MAX_ITEMS,X.ARRAY_UNIQUE_ITEMS,X.ARRAY_CONTAINS,X.ARRAY_MIN_CONTAINS,X.ARRAY_MAX_CONTAINS,X.ARRAY_PREFIX_ITEMS,X.ARRAY_ITEMS,X.ARRAY_UNEVALUATED_ITEMS,X.TUPLE_MIN_ITEMS,X.TUPLE_MAX_ITEMS,X.OBJECT_REQUIRED,X.OBJECT_ADDITIONAL_PROPERTIES,X.OBJECT_MIN_PROPERTIES,X.OBJECT_MAX_PROPERTIES,X.OBJECT_PROPERTY_NAMES,X.OBJECT_DEPENDENCIES,X.OBJECT_UNEVALUATED_PROPERTIES,X.ENUM_MISMATCH,X.CONST_MISMATCH,X.CONDITIONAL_IF,X.CONDITIONAL_THEN,X.CONDITIONAL_ELSE,X.COMPOSITION_ONE_OF,X.COMPOSITION_ANY_OF,X.COMPOSITION_ALL_OF,X.COMPOSITION_NOT,X.CONTENT_DISCRIMINATOR,X.CONTENT_ENCODING,X.CONTENT_MEDIA_TYPE,X.CUSTOM_RANGE,X.CUSTOM_EXCLUSIVE_RANGE,X.CUSTOM_REGEXP,X.CUSTOM_DYNAMIC_DEFAULTS,X.CUSTOM_SELECT,X.CUSTOM_TRANSFORM,X.CUSTOM_UNIQUE_ITEM_PROPERTIES,X.UNKNOWN;var Gr=h({meta:{name:`TypeBox`,resolveTypes:!0},dependencies:{typebox:Lr.devDependencies.typebox},factory:Wr}),Z={type:`module`,private:!0,name:`@kosmojs/vue-generator`,version:`0.3.0`,author:`Slee Woo`,license:`MIT`,files:[`pkg/*`],exports:{".":{types:`./pkg/index.d.ts`,default:`./pkg/index.js`}},scripts:{build:`wsbuild src/index.ts`,test:`vitest --root ../.. --project generators/vue-generator`},dependencies:{"@kosmojs/core":`workspace:^`,"@kosmojs/lib":`workspace:^`,"@vitejs/plugin-vue":`^6.0.8`},devDependencies:{"@tanstack/vue-query":`^5.102.2`,"path-to-regexp":`^8.4.2`,vue:`^3.5.41`,"vue-router":`^5.2.0`}},Q=e=>{let t=e=>e.kind===`splat`?`:${e.name}(.*)?`:e.kind===`optional`?`:${e.name}?`:`:${e.name}`;return e.flatMap(e=>e.kind===`static`?[e.parts[0].value]:e.kind===`param`?[t(e.parts[0])]:[e.parts.map(e=>e.type===`static`?e.value:t(e)).join(``)]).join(`/`)},Kr=()=>{let e=e=>e?.kind===`param`&&e.parts[0]?.kind===`splat`,n=(r,i)=>r.flatMap(({index:r,layout:a,children:o})=>{let{name:s,pathTokens:c}={...r,...a};if(!c)return[];let l=`${s}/layout`,u=i?Q(c):t(`/`,Q(c)),d=c.at(-1);return e(d)?r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id}]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]:r&&a?[{name:l,path:u,component:a.id,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:r?[{path:u,children:[{name:s,path:``,component:r.id},...n(o,s)]}]:a?[{name:l,path:u,component:a.id,children:n(o,s)}]:[]});return n},qr=()=>{let e=[`🎉 Well done! You just created a new Vue route.`,`🚀 Success! A fresh Vue route is ready to roll.`,`🌟 Nice work! Another Vue route added to your app.`,`🧩 All set! A new Vue route has been scaffolded.`,`🔧 Scaffold complete! Your new Vue route is in place.`,`✅ Built! Your Vue route is scaffolded and ready.`,`✨ Fantastic! Your new Vue route is good to go.`,`🎯 Nailed it! A brand new Vue route just landed.`,`💫 Awesome! Another Vue route joins the party.`,`⚡ Lightning fast! A new Vue route created successfully.`];return e[Math.floor(Math.random()*e.length)]},Jr=`import type { Plugin } from "vue";
+`,di={exactOptionalPropertyTypes:!0},fi=v((e,t)=>{let{createPath:n,createImport:r,createImportHelpers:i}=S(e),{renderToFile:a}=w({helpers:{...i({origin:`lib`})}}),{validationMessages:o={},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(s).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)}}]:[]})})),o=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`),ui,{route:r,resolvedTypes:e,requestSchemas:i,responseSchemas:o})}};return{async start(){for(let[e,t]of[[`custom-types.ts`,oi],[`error-handler.ts`,si],[`index.ts`,ci],[`setup.ts`,li]])await a(n.lib(`@typebox`,e),t,{validationMessages:JSON.stringify(o),customTypesImport:c,settings:JSON.stringify({...di,...l})})},async watch(e,t){await u(e.filter(h(t,[`create`,`update`])))},async build(e){await u(e)}}}),X={PROPERTY:`PROPERTY`,PROPERTIES:`PROPERTIES`,ALLOWED_VALUES:`ALLOWED_VALUES`,FOUND_N_DUPLICATES:`FOUND_N_DUPLICATES`,VALIDATION_PASSED:`VALIDATION_PASSED`,VALIDATION_FAILED_PREFIX:`VALIDATION_FAILED_PREFIX`,ERROR_SUMMARY:`ERROR_SUMMARY`,PLURAL_SUFFIX:`PLURAL_SUFFIX`,FIRST:`FIRST`,SECOND:`SECOND`,THIRD:`THIRD`,FOURTH:`FOURTH`,FIFTH:`FIFTH`,TYPE_INVALID:`TYPE_INVALID`,STRING_MIN_LENGTH:`STRING_MIN_LENGTH`,STRING_MAX_LENGTH:`STRING_MAX_LENGTH`,STRING_PATTERN:`STRING_PATTERN`,STRING_FORMAT:`STRING_FORMAT`,STRING_FORMAT_EMAIL:`STRING_FORMAT_EMAIL`,STRING_FORMAT_DATE:`STRING_FORMAT_DATE`,STRING_FORMAT_DATETIME:`STRING_FORMAT_DATETIME`,STRING_FORMAT_TIME:`STRING_FORMAT_TIME`,STRING_FORMAT_URI:`STRING_FORMAT_URI`,STRING_FORMAT_URL:`STRING_FORMAT_URL`,STRING_FORMAT_UUID:`STRING_FORMAT_UUID`,STRING_FORMAT_IPV4:`STRING_FORMAT_IPV4`,STRING_FORMAT_IPV6:`STRING_FORMAT_IPV6`,STRING_FORMAT_HOSTNAME:`STRING_FORMAT_HOSTNAME`,STRING_FORMAT_JSON_POINTER:`STRING_FORMAT_JSON_POINTER`,STRING_FORMAT_REGEX:`STRING_FORMAT_REGEX`,NUMBER_MINIMUM:`NUMBER_MINIMUM`,NUMBER_MAXIMUM:`NUMBER_MAXIMUM`,NUMBER_EXCLUSIVE_MINIMUM:`NUMBER_EXCLUSIVE_MINIMUM`,NUMBER_EXCLUSIVE_MAXIMUM:`NUMBER_EXCLUSIVE_MAXIMUM`,NUMBER_MULTIPLE_OF:`NUMBER_MULTIPLE_OF`,ARRAY_MIN_ITEMS:`ARRAY_MIN_ITEMS`,ARRAY_MAX_ITEMS:`ARRAY_MAX_ITEMS`,ARRAY_UNIQUE_ITEMS:`ARRAY_UNIQUE_ITEMS`,ARRAY_CONTAINS:`ARRAY_CONTAINS`,ARRAY_MIN_CONTAINS:`ARRAY_MIN_CONTAINS`,ARRAY_MAX_CONTAINS:`ARRAY_MAX_CONTAINS`,ARRAY_PREFIX_ITEMS:`ARRAY_PREFIX_ITEMS`,ARRAY_ITEMS:`ARRAY_ITEMS`,ARRAY_UNEVALUATED_ITEMS:`ARRAY_UNEVALUATED_ITEMS`,TUPLE_MIN_ITEMS:`TUPLE_MIN_ITEMS`,TUPLE_MAX_ITEMS:`TUPLE_MAX_ITEMS`,OBJECT_REQUIRED:`OBJECT_REQUIRED`,OBJECT_ADDITIONAL_PROPERTIES:`OBJECT_ADDITIONAL_PROPERTIES`,OBJECT_MIN_PROPERTIES:`OBJECT_MIN_PROPERTIES`,OBJECT_MAX_PROPERTIES:`OBJECT_MAX_PROPERTIES`,OBJECT_PROPERTY_NAMES:`OBJECT_PROPERTY_NAMES`,OBJECT_DEPENDENCIES:`OBJECT_DEPENDENCIES`,OBJECT_UNEVALUATED_PROPERTIES:`OBJECT_UNEVALUATED_PROPERTIES`,ENUM_MISMATCH:`ENUM_MISMATCH`,CONST_MISMATCH:`CONST_MISMATCH`,CONDITIONAL_IF:`CONDITIONAL_IF`,CONDITIONAL_THEN:`CONDITIONAL_THEN`,CONDITIONAL_ELSE:`CONDITIONAL_ELSE`,COMPOSITION_ONE_OF:`COMPOSITION_ONE_OF`,COMPOSITION_ANY_OF:`COMPOSITION_ANY_OF`,COMPOSITION_ALL_OF:`COMPOSITION_ALL_OF`,COMPOSITION_NOT:`COMPOSITION_NOT`,CONTENT_DISCRIMINATOR:`CONTENT_DISCRIMINATOR`,CONTENT_ENCODING:`CONTENT_ENCODING`,CONTENT_MEDIA_TYPE:`CONTENT_MEDIA_TYPE`,CUSTOM_RANGE:`CUSTOM_RANGE`,CUSTOM_EXCLUSIVE_RANGE:`CUSTOM_EXCLUSIVE_RANGE`,CUSTOM_REGEXP:`CUSTOM_REGEXP`,CUSTOM_DYNAMIC_DEFAULTS:`CUSTOM_DYNAMIC_DEFAULTS`,CUSTOM_SELECT:`CUSTOM_SELECT`,CUSTOM_TRANSFORM:`CUSTOM_TRANSFORM`,CUSTOM_UNIQUE_ITEM_PROPERTIES:`CUSTOM_UNIQUE_ITEM_PROPERTIES`,UNKNOWN:`UNKNOWN`};X.PROPERTY,X.PROPERTIES,X.ALLOWED_VALUES,X.FOUND_N_DUPLICATES,X.VALIDATION_PASSED,X.VALIDATION_FAILED_PREFIX,X.ERROR_SUMMARY,X.PLURAL_SUFFIX,X.FIRST,X.SECOND,X.THIRD,X.FOURTH,X.FIFTH,X.TYPE_INVALID,X.STRING_MIN_LENGTH,X.STRING_MAX_LENGTH,X.STRING_PATTERN,X.STRING_FORMAT,X.STRING_FORMAT_EMAIL,X.STRING_FORMAT_DATE,X.STRING_FORMAT_DATETIME,X.STRING_FORMAT_TIME,X.STRING_FORMAT_URI,X.STRING_FORMAT_URL,X.STRING_FORMAT_UUID,X.STRING_FORMAT_IPV4,X.STRING_FORMAT_IPV6,X.STRING_FORMAT_HOSTNAME,X.STRING_FORMAT_JSON_POINTER,X.STRING_FORMAT_REGEX,X.NUMBER_MINIMUM,X.NUMBER_MAXIMUM,X.NUMBER_EXCLUSIVE_MINIMUM,X.NUMBER_EXCLUSIVE_MAXIMUM,X.NUMBER_MULTIPLE_OF,X.ARRAY_MIN_ITEMS,X.ARRAY_MAX_ITEMS,X.ARRAY_UNIQUE_ITEMS,X.ARRAY_CONTAINS,X.ARRAY_MIN_CONTAINS,X.ARRAY_MAX_CONTAINS,X.ARRAY_PREFIX_ITEMS,X.ARRAY_ITEMS,X.ARRAY_UNEVALUATED_ITEMS,X.TUPLE_MIN_ITEMS,X.TUPLE_MAX_ITEMS,X.OBJECT_REQUIRED,X.OBJECT_ADDITIONAL_PROPERTIES,X.OBJECT_MIN_PROPERTIES,X.OBJECT_MAX_PROPERTIES,X.OBJECT_PROPERTY_NAMES,X.OBJECT_DEPENDENCIES,X.OBJECT_UNEVALUATED_PROPERTIES,X.ENUM_MISMATCH,X.CONST_MISMATCH,X.CONDITIONAL_IF,X.CONDITIONAL_THEN,X.CONDITIONAL_ELSE,X.COMPOSITION_ONE_OF,X.COMPOSITION_ANY_OF,X.COMPOSITION_ALL_OF,X.COMPOSITION_NOT,X.CONTENT_DISCRIMINATOR,X.CONTENT_ENCODING,X.CONTENT_MEDIA_TYPE,X.CUSTOM_RANGE,X.CUSTOM_EXCLUSIVE_RANGE,X.CUSTOM_REGEXP,X.CUSTOM_DYNAMIC_DEFAULTS,X.CUSTOM_SELECT,X.CUSTOM_TRANSFORM,X.CUSTOM_UNIQUE_ITEM_PROPERTIES,X.UNKNOWN;var pi=_({meta:{name:`TypeBox`,resolveTypes:!0},dependencies:{typebox:ai.devDependencies.typebox},factory:fi}),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.102.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(`/`)},mi=()=>{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},hi=()=>{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)]},gi=`import type { Plugin } from "vue";
 
 export { default as AppProvider } from "./provider.vue";
 
 export const appProvider: Plugin = {
   install() {},
 };
-`,Yr=`import { VueQueryPlugin } from "@tanstack/vue-query";
+`,_i=`import { VueQueryPlugin } from "@tanstack/vue-query";
 import type { Plugin } from "vue";
 
 import { getQueryClient } from "../query";
@@ -8312,10 +9160,10 @@ export const appProvider: Plugin = {
     app.use(VueQueryPlugin, { queryClient: getQueryClient() });
   },
 };
-`,Xr=`<template>
+`,vi=`<template>
   <slot />
 </template>
-`,Zr=`import type { App } from "vue";
+`,yi=`import type { App } from "vue";
 import type { RouterFactoryReturn } from "@kosmojs/core";
 import { clientRenderFactory } from "@kosmojs/core/generators";
 
@@ -8355,7 +9203,7 @@ export const mount = async (
 }
 
 export default clientRenderFactory();
-`,Qr=`{
+`,bi=`{
   path: "{{path}}",
   {{#if name}}
   name: "{{name}}",
@@ -8373,7 +9221,7 @@ export default clientRenderFactory();
   children: [ {{#each children}}{{> routePartial}}, {{/each}}],
   {{/if}}
 }
-`,$r=`import type { App } from "vue";
+`,$=`import type { App } from "vue";
 
 import {
   renderToString as renderToStringOrig,
@@ -8464,12 +9312,18 @@ export const renderToStream: RenderToStreamWrapper<
 }
 
 export default serverRenderFactory();
-`,$=`declare module "*.vue" {
+`,xi=`declare module "*.vue" {
   import type { DefineComponent } from "vue";
   const component: DefineComponent<{}, {}, any>;
   export default component;
 }
-`,ei=`<script setup lang="ts">
+
+declare module "virtual:kosmo/tsq-client" {
+  import type { QueryClient, QueryClientConfig } from "@tanstack/vue-query";
+  export const createQueryClient: (options?: QueryClientConfig) => QueryClient;
+  export const getQueryClient: () => QueryClient;
+}
+`,Si=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   headline?: string;
@@ -8508,7 +9362,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,ti=`<script setup lang="ts">
+`,Ci=`<script setup lang="ts">
 import styles from "./styles.module.css";
 defineProps<{
   message: string;
@@ -8557,7 +9411,7 @@ defineProps<{
     </div>
   </div>
 </template>
-`,ni=`* {
+`,wi=`* {
   margin: 0;
   padding: 0;
   box-sizing: border-box;
@@ -8690,7 +9544,7 @@ defineProps<{
   align-items: center;
   gap: 0.25rem;
 }
-`,ri=`<script setup lang="ts">
+`,Ti=`<script setup lang="ts">
 import styles from "./styles.module.css";
 <\/script>
 
@@ -8754,26 +9608,27 @@ import styles from "./styles.module.css";
     </div>
   </div>
 </template>
-`,ii=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,Ei=`export * from "virtual:kosmo/tsq-client";
+`,Di=`import { QueryClient } from "@tanstack/vue-query";
 
-let client: QueryClient | undefined;
+let client = undefined
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   client = new QueryClient(options);
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   if (!client) {
     client = new QueryClient();
   }
   return client;
 };
-`,ai=`import { QueryClient, type QueryClientConfig } from "@tanstack/vue-query";
+`,Oi=`import { QueryClient } from "@tanstack/vue-query";
 
-import { store } from "{{ createImport 'lib' '@ssr/base' }}";
+import { store } from "{{ createImport 'libCore' 'ssr' }}";
 
-export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
+export const createQueryClient = (options) => {
   const client = new QueryClient(options);
   const ctx = store?.getStore();
   if (ctx) {
@@ -8782,7 +9637,7 @@ export const createQueryClient = (options?: QueryClientConfig): QueryClient => {
   return client;
 };
 
-export const getQueryClient = (): QueryClient => {
+export const getQueryClient = () => {
   const ctx = store?.getStore();
   if (!ctx) {
     throw new Error("getQueryClient(): called outside an SSR request scope");
@@ -8790,9 +9645,9 @@ export const getQueryClient = (): QueryClient => {
   if (!ctx.tsqClient) {
     ctx.tsqClient = new QueryClient();
   }
-  return ctx.tsqClient as QueryClient;
+  return ctx.tsqClient;
 };
-`,oi=`import {
+`,ki=`import {
   type App,
   type Component,
   createApp,
@@ -8923,7 +9778,7 @@ export const createRouters = (
 
       let { pathname } = url;
 
-      if (base !== "/") {
+      if ((base as string) !== "/") {
         // strip the base from pushed paths
         if (pathname === base) {
           pathname = "/";
@@ -8954,14 +9809,14 @@ export default createRouterFactory<
   Promise<App>,
   { server: { loaderData: Record<string, unknown> } }
 >();
-`,si=`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);
 }
-`,ci=`import { useRoute, useRouter } from "vue-router";
+`,ji=`import { useRoute, useRouter } from "vue-router";
 
 import type { RouterWithLoaderData } from "./router";
 
@@ -8976,7 +9831,7 @@ export const useLoaderData = <T>(key?: string): T | undefined => {
   const route = useRoute();
   return router.__loaderData?.[key || (route.name as string)] as T;
 };
-`,li=`<script setup lang="ts">
+`,Mi=`<script setup lang="ts">
 import { AppProvider } from "_/app";
 <\/script>
 
@@ -8985,7 +9840,7 @@ import { AppProvider } from "_/app";
     <RouterView />
   </AppProvider>
 </template>
-`,ui=`<script setup lang="ts" generic="T extends LinkProps">
+`,Ni=`<script setup lang="ts" generic="T extends LinkProps">
 import { computed } from "vue";
 import { RouterLink } from "vue-router";
 
@@ -9018,7 +9873,7 @@ const linkProps = computed(() => ({
     <slot />
   </RouterLink>
 </template>
-`,di=`import renderFactory, {
+`,Pi=`import renderFactory, {
   createRoutes,
   hydrate,
   mount,
@@ -9045,7 +9900,7 @@ if (root) {
 } else {
   console.error("❌ Root element not found!");
 }
-`,fi=`import renderFactory, {
+`,Fi=`import renderFactory, {
   createRoutes,
   renderToStream,
   renderToString,
@@ -9072,29 +9927,17 @@ export default renderFactory(() => {
     },
   };
 });
-`,pi=`<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <!--app-head-->
-</head>
-<body>
-  <div id="app"><!--app-html--></div>
-  <script type="module" src="/{{ entryDir }}/client.ts"><\/script>
-</body>
-</html>
-`,mi=`<script setup lang="ts">
+`,Ii=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/404.vue' }}";
 <\/script>
 
 <template>
   <PageSample />
 </template>
-`,hi=`<template>
+`,Li=`<template>
   <router-view />
 </template>
-`,gi=`<script setup lang="ts">
+`,Ri=`<script setup lang="ts">
 import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
 <\/script>
 
@@ -9109,14 +9952,14 @@ import PageSample from "{{ createImport 'lib' 'pageSamples/page.vue' }}";
     }"
   />
 </template>
-`,_i=`<script setup lang="ts">
+`,zi=`<script setup lang="ts">
 import WelcomePage from "{{ createImport 'lib' 'pageSamples/welcome.vue' }}";
 <\/script>
 
 <template>
   <WelcomePage />
 </template>
-`,vi=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
+`,Bi=`import routerFactory, { createRouters } from "{{ createImport 'lib' 'router' }}";
 import { appProvider } from "{{ createImport 'lib' 'app' }}";
 
 import app from "./app.vue";
@@ -9135,5 +9978,5 @@ export default routerFactory((routes) => {
     },
   };
 });
-`,yi=g((e,t)=>{let{createPath:n,createImportHelpers:r}=y(e),{renderToFile:i}=x({helpers:{...r({origin:`lib`}),...w()},partials:{routePartial:Qr}}),{renderToFile:a}=x({helpers:r({origin:`src`})}),o=Kr(),s=e=>!e?.trim().length,u=c(t?.templates,gi),d=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await a(n.pages(r.file),r.name===`index`?_i:u(r.name,r),{route:r,message:qr()},{overwrite:s}):t===`pageLayout`&&await a(n.pages(r.file),hi,{route:r},{overwrite:s})},f=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(S),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),a=o(v(r));for(let[e,t]of[[`client.ts`,Zr],[`server.ts`,$r]])await i(n.libEntry(e),t,{pageEntries:r,nestedRoutes:a,lazyLoad:e===`client.ts`});await i(n.lib(`router.ts`),oi,{entries:e,indexRoutes:t})};return{config(){let{templates:e,...n}={...t};return{plugins:[pe(n)]}},async start(){for(let[e,r]of[[`env.d.ts`,$],[`unwrap.ts`,si],[`use.ts`,ci],[`pageSamples/styles.module.css`,ni],[`pageSamples/welcome.vue`,ri],[`pageSamples/page.vue`,ti],[`pageSamples/404.vue`,ei],[`app/provider.vue`,Xr],...t?.tanstack?.query?[[`app/index.ts`,Yr],[`query.ts`,ii]]:[[`app/index.ts`,Jr],[`query.ts`,`/** tanstack query disabled */`]]])await i(n.lib(e),r,{});for(let[e,t]of[[`pages/404.vue`,mi],[`components/Link.vue`,ui],[`app.vue`,li],[`router.ts`,vi]])await a(n.src(e),t,{entryDir:l.entryDir},{overwrite:s});await a(n.src(`index.html`),pi,{entryDir:l.entryDir},{overwrite:e=>!e?.trim().length||!e.replace(/<!--[\s\S]*?-->/g,``).trim().length});for(let[e,t]of[[`client.ts`,di],[`server.ts`,fi]])await a(n.entry(e),t,{},{overwrite:s})},async watch(e,t){await d(e.filter(m(t,[`create`]))),await f(e)},async build(e){await d(e),await f(e)},async ssrBuild(){await i(n.lib(`query.ts`),t?.tanstack?.query?ai:`/** tanstack query disabled */`,{ssrBundle:!0})}}}),bi=h({meta:{name:`Vue`,jsxImportSource:`vue`},dependencies(e){return{vue:Z.devDependencies.vue,"vue-router":Z.devDependencies[`vue-router`],"path-to-regexp":Z.devDependencies[`path-to-regexp`],...e?.tanstack?.query?{"@tanstack/vue-query":Z.devDependencies[`@tanstack/vue-query`]}:{}}},factory:yi}),xi=e=>{let n=process.env.NODE_ENV||`development`,a=typeof e.base==`string`?e.base:e.base[n];if(!a?.trim())throw Error(r([`red`],`ERROR: Invalid Config - no base provided`));return{...e,base:t(`/`,a),apiBase:t(`/`,e.apiBase||i)}};export{e as coreGenerator,xi as defineConfig,I as fetchGenerator,ke as h3Generator,Je as honoGenerator,pt as koaGenerator,Ht as mdxGenerator,qt as openapiGenerator,Sn as reactGenerator,Xn as solidGenerator,$n as ssgGenerator,cr as ssrGenerator,Ir as svelteGenerator,Gr as typeboxGenerator,bi as vueGenerator};
+`,Vi=v((e,t)=>{let{createPath:n,createImportHelpers:r}=S(e),{render:i,renderToFile:a}=w({helpers:{...r({origin:`lib`}),...A()},partials:{routePartial:bi}}),{renderToFile:o}=w({helpers:r({origin:`src`})}),s=mi(),c=e=>!e?.trim().length,d=l(t?.templates,Ri),f=async e=>{for(let{kind:t,entry:r}of e)t===`pageRoute`?await o(n.pages(r.file),r.name===`index`?zi:d(r.name,r),{route:r,message:hi()},{overwrite:c}):t===`pageLayout`&&await o(n.pages(r.file),Li,{route:r},{overwrite:c})},p=async e=>{let t=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`?[t]:[]).sort(E),r=e.flatMap(({kind:e,entry:t})=>e===`pageRoute`||e===`pageLayout`?[t]:[]),i=s(b(r));for(let[e,t]of[[`client.ts`,yi],[`server.ts`,$]])await a(n.libEntry(e),t,{pageEntries:r,nestedRoutes:i,lazyLoad:e===`client.ts`});await a(n.lib(`router.ts`),ki,{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`,xi],[`unwrap.ts`,Ai],[`use.ts`,ji],[`pageSamples/styles.module.css`,wi],[`pageSamples/welcome.vue`,Ti],[`pageSamples/page.vue`,Ci],[`pageSamples/404.vue`,Si],[`app/provider.vue`,vi],...t?.tanstack?.query?[[`app/index.ts`,_i],[`query.ts`,Ei]]:[[`app/index.ts`,gi],[`query.ts`,`/** tanstack query disabled */`]]])await a(n.lib(e),r,{});for(let[e,t]of[[`pages/404.vue`,Ii],[`components/Link.vue`,Ni],[`app.vue`,Mi],[`router.ts`,Bi]])await o(n.src(e),t,{entryDir:u.entryDir},{overwrite:c});for(let[e,t]of[[`client.ts`,Pi],[`server.ts`,Fi]])await o(n.entry(e),t,{},{overwrite:c})},async watch(e,t){await f(e.filter(g(t,[`create`]))),await p(e)},async build(e){await f(e),await p(e)},virtualModules(){return t?.tanstack?.query?[{specifier:`virtual:kosmo/tsq-client`,csr:i(Di,{}),ssr:i(Oi,{})}]:[]}}}),Hi=_({meta:{name:`Vue`,slot:`frontend`,jsxImportSource:`vue`},dependencies(e){return{vue:Z.devDependencies.vue,"vue-router":Z.devDependencies[`vue-router`],...e?.tanstack?.query?{"@tanstack/vue-query":Z.devDependencies[`@tanstack/vue-query`]}:{}}},factory:Vi}),Ui=e=>{let n=process.env.NODE_ENV||`development`,r=typeof e.base==`string`?e.base:e.base[n];if(!r?.trim())throw Error(i([`red`],`ERROR: Invalid Config - no base provided`));return{...e,base:t(`/`,r),apiBase:t(`/`,e.apiBase||a),generators:Wi(e)}},Wi=e=>{let t=[],n={};for(let r of e.generators||[])r.meta.slot?n[r.meta.slot]=r:t.push(r);return[B(),...n.backend?[n.backend]:[],...n.fetch&&n.backend?[n.fetch]:[],...n.frontend?[n.frontend]:[],...t,...n.ssr?[n.ssr]:[],...n.ssg?[n.ssg]:[]]};export{B as coreGenerator,Ui as defineConfig,Ae as fetchGenerator,Ze as h3Generator,_t as honoGenerator,Lt as koaGenerator,un as mdxGenerator,hn as openapiGenerator,Wn as reactGenerator,yr as solidGenerator,wr as ssgGenerator,Ar as ssrGenerator,ii as svelteGenerator,pi as typeboxGenerator,Hi as vueGenerator};
 //# sourceMappingURL=index.js.map