litestar-vite-plugin 0.15.0 → 0.16.0

package/dist/js/shared/emit-schemas-types.js

@@ -0,0 +1,341 @@
+import fs from "node:fs";
+import path from "node:path";
+import { writeIfChanged } from "./write-if-changed.js";
+function toImportPath(fromDir, targetFile) {
+  const relativePath = path.relative(fromDir, targetFile).replace(/\\/g, "/");
+  const withoutExtension = relativePath.replace(/\.d\.ts$/, "").replace(/\.ts$/, "");
+  if (withoutExtension.startsWith(".")) {
+    return withoutExtension;
+  }
+  return `./${withoutExtension}`;
+}
+function parseHeyApiTypes(content) {
+  const dataTypes = /* @__PURE__ */ new Map();
+  const responsesTypes = /* @__PURE__ */ new Set();
+  const errorsTypes = /* @__PURE__ */ new Set();
+  const urlToDataType = /* @__PURE__ */ new Map();
+  const typeBlockRegex = /export\s+type\s+(\w+Data)\s*=\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/gs;
+  for (const match of content.matchAll(typeBlockRegex)) {
+    const typeName = match[1];
+    const typeBody = match[2];
+    const urlMatch = typeBody.match(/url:\s*['"]([^'"]+)['"]/);
+    const url = urlMatch ? urlMatch[1] : null;
+    const hasBody = /\bbody\s*:/.test(typeBody) && !/\bbody\s*\?\s*:\s*never/.test(typeBody);
+    const hasPath = /\bpath\s*:/.test(typeBody) && !/\bpath\s*\?\s*:\s*never/.test(typeBody);
+    const hasQuery = /\bquery\s*:/.test(typeBody) && !/\bquery\s*\?\s*:\s*never/.test(typeBody);
+    const info = { typeName, url, hasBody, hasPath, hasQuery };
+    dataTypes.set(typeName, info);
+    if (url) {
+      urlToDataType.set(url, typeName);
+    }
+  }
+  const responsesRegex = /export\s+type\s+(\w+Responses)\s*=/g;
+  for (const match of content.matchAll(responsesRegex)) {
+    responsesTypes.add(match[1]);
+  }
+  const errorsRegex = /export\s+type\s+(\w+Errors)\s*=/g;
+  for (const match of content.matchAll(errorsRegex)) {
+    errorsTypes.add(match[1]);
+  }
+  return { dataTypes, responsesTypes, errorsTypes, urlToDataType };
+}
+function normalizePath(path2) {
+  return path2.replace(/\{([^:}]+):[^}]+\}/g, "{$1}");
+}
+function createOperationMappings(routes, urlToDataType, responsesTypes, errorsTypes) {
+  const mappings = [];
+  for (const [routeName, route] of Object.entries(routes)) {
+    const normalizedPath = normalizePath(route.uri);
+    const dataType = urlToDataType.get(normalizedPath) || null;
+    let responsesType = null;
+    let errorsType = null;
+    if (dataType) {
+      const baseName = dataType.replace(/Data$/, "");
+      const candidateResponses = `${baseName}Responses`;
+      const candidateErrors = `${baseName}Errors`;
+      if (responsesTypes.has(candidateResponses)) {
+        responsesType = candidateResponses;
+      }
+      if (errorsTypes.has(candidateErrors)) {
+        errorsType = candidateErrors;
+      }
+    }
+    mappings.push({
+      routeName,
+      path: route.uri,
+      method: route.method,
+      dataType,
+      responsesType,
+      errorsType
+    });
+  }
+  return mappings.sort((a, b) => a.routeName.localeCompare(b.routeName));
+}
+function generateSchemasTs(mappings, apiTypesImportPath) {
+  const validMappings = mappings.filter((m) => m.dataType || m.responsesType);
+  if (validMappings.length === 0) {
+    return `// AUTO-GENERATED by litestar-vite. Do not edit.
+/* eslint-disable */
+
+// Re-export all types from hey-api
+export * from "${apiTypesImportPath}"
+
+// No API operations found with matching types.
+// Ensure routes have corresponding hey-api Data/Responses types.
+
+/** No operations found */
+export type OperationName = never
+
+/** No operation data types */
+export interface OperationDataTypes {}
+
+/** No operation response types */
+export interface OperationResponseTypes {}
+
+/** Extract request body type - no operations available */
+export type FormInput<T extends OperationName> = never
+
+/** Extract response type - no operations available */
+export type FormResponse<T extends OperationName, _Status extends number> = never
+
+/** Extract success response - no operations available */
+export type SuccessResponse<T extends OperationName> = never
+`;
+  }
+  const dataTypeImports = [...new Set(validMappings.map((m) => m.dataType).filter(Boolean))];
+  const responsesTypeImports = [...new Set(validMappings.map((m) => m.responsesType).filter(Boolean))];
+  const errorsTypeImports = [...new Set(validMappings.map((m) => m.errorsType).filter(Boolean))];
+  const allImports = [...dataTypeImports, ...responsesTypeImports, ...errorsTypeImports].sort();
+  const operationNames = validMappings.map((m) => `  | '${m.routeName}'`).join("\n");
+  const dataTypeEntries = validMappings.filter((m) => m.dataType).map((m) => `  '${m.routeName}': ${m.dataType}`).join("\n");
+  const responsesTypeEntries = validMappings.filter((m) => m.responsesType).map((m) => `  '${m.routeName}': ${m.responsesType}`).join("\n");
+  const errorsTypeEntries = validMappings.map((m) => `  '${m.routeName}': ${m.errorsType || "never"}`).join("\n");
+  return `// AUTO-GENERATED by litestar-vite. Do not edit.
+/* eslint-disable */
+
+// Re-export all types from hey-api for direct access
+export * from "${apiTypesImportPath}"
+
+// Import specific operation types for mapping
+import type {
+  ${allImports.join(",\n  ")}
+} from "${apiTypesImportPath}"
+
+// ============================================================================
+// Operation Name Registry
+// ============================================================================
+
+/**
+ * All available API operation names.
+ * These match the route names from routes.ts for consistency.
+ *
+ * @example
+ * import type { OperationName } from './generated/schemas'
+ * const op: OperationName = 'api:login'
+ */
+export type OperationName =
+${operationNames}
+
+/**
+ * Mapping of operation names to hey-api Data types.
+ * Data types contain body, path, query, and url properties.
+ */
+export interface OperationDataTypes {
+${dataTypeEntries}
+}
+
+/**
+ * Mapping of operation names to hey-api Responses types.
+ * Responses types map status codes to response shapes.
+ */
+export interface OperationResponseTypes {
+${responsesTypeEntries}
+}
+
+/**
+ * Mapping of operation names to hey-api Error types.
+ * Error types represent non-2xx responses.
+ */
+export interface OperationErrorTypes {
+${errorsTypeEntries}
+}
+
+// ============================================================================
+// Ergonomic Type Helpers
+// ============================================================================
+
+/**
+ * Extract request body type for an operation.
+ * Use this for form data typing.
+ *
+ * @example
+ * import { useForm } from '@inertiajs/react'
+ * import type { FormInput } from './generated/schemas'
+ *
+ * const form = useForm<FormInput<'api:login'>>({
+ *   username: '',
+ *   password: '',
+ * })
+ */
+export type FormInput<T extends OperationName> =
+  T extends keyof OperationDataTypes
+    ? OperationDataTypes[T] extends { body: infer B }
+      ? B extends never ? never : B
+      : never
+    : never
+
+/**
+ * Extract path parameters type for an operation.
+ *
+ * @example
+ * type BookParams = PathParams<'api:book_detail'>  // { book_id: number }
+ */
+export type PathParams<T extends OperationName> =
+  T extends keyof OperationDataTypes
+    ? OperationDataTypes[T] extends { path: infer P }
+      ? P extends never ? never : P
+      : never
+    : never
+
+/**
+ * Extract query parameters type for an operation.
+ *
+ * @example
+ * type SearchQuery = QueryParams<'api:books'>  // { q?: string; limit?: number }
+ */
+export type QueryParams<T extends OperationName> =
+  T extends keyof OperationDataTypes
+    ? OperationDataTypes[T] extends { query: infer Q }
+      ? Q extends never ? never : Q
+      : never
+    : never
+
+/**
+ * Extract response type for a specific HTTP status code.
+ *
+ * @example
+ * type LoginSuccess = FormResponse<'api:login', 201>  // { access_token: string; ... }
+ * type LoginError = FormResponse<'api:login', 400>    // { detail: string; ... }
+ */
+export type FormResponse<T extends OperationName, Status extends number> =
+  T extends keyof OperationResponseTypes
+    ? Status extends keyof OperationResponseTypes[T]
+      ? OperationResponseTypes[T][Status]
+      : never
+    : never
+
+/**
+ * Extract successful response type (200 or 201).
+ * Convenience helper for the most common case.
+ *
+ * @example
+ * type Books = SuccessResponse<'api:books'>  // Book[]
+ * type NewBook = SuccessResponse<'api:book_create'>  // Book
+ */
+export type SuccessResponse<T extends OperationName> =
+  T extends keyof OperationResponseTypes
+    ? OperationResponseTypes[T] extends { 200: infer R }
+      ? R
+      : OperationResponseTypes[T] extends { 201: infer R }
+        ? R
+        : OperationResponseTypes[T] extends { 204: infer R }
+          ? R
+          : never
+    : never
+
+/**
+ * Extract error response type.
+ * Returns the union of all error response types for an operation.
+ *
+ * @example
+ * type LoginErrors = ErrorResponse<'api:login'>  // { detail: string; ... }
+ */
+export type ErrorResponse<T extends OperationName> = OperationErrorTypes[T]
+
+/**
+ * Extract all possible response types as a union.
+ *
+ * @example
+ * type AllResponses = AnyResponse<'api:login'>  // success | error union
+ */
+export type AnyResponse<T extends OperationName> =
+  T extends keyof OperationResponseTypes
+    ? OperationResponseTypes[T][keyof OperationResponseTypes[T]]
+    : never
+
+// ============================================================================
+// Utility Types for Forms
+// ============================================================================
+
+/**
+ * Make all form input properties optional.
+ * Useful for initializing form state with empty values.
+ *
+ * @example
+ * const initialData: PartialFormInput<'api:login'> = {}
+ */
+export type PartialFormInput<T extends OperationName> = Partial<FormInput<T>>
+
+/**
+ * Inertia-style form state with validation errors.
+ *
+ * @example
+ * const formState: FormState<'api:login'> = {
+ *   data: { username: '', password: '' },
+ *   errors: {},
+ *   processing: false,
+ *   wasSuccessful: false,
+ *   recentlySuccessful: false,
+ * }
+ */
+export interface FormState<T extends OperationName> {
+  data: FormInput<T>
+  errors: Partial<Record<keyof FormInput<T>, string | string[]>>
+  processing: boolean
+  wasSuccessful: boolean
+  recentlySuccessful: boolean
+}
+
+/**
+ * Check if an operation has a request body.
+ */
+export type HasBody<T extends OperationName> = FormInput<T> extends never ? false : true
+
+/**
+ * Check if an operation has path parameters.
+ */
+export type HasPathParams<T extends OperationName> = PathParams<T> extends never ? false : true
+
+/**
+ * Check if an operation has query parameters.
+ */
+export type HasQueryParams<T extends OperationName> = QueryParams<T> extends never ? false : true
+`;
+}
+async function emitSchemasTypes(routesJsonPath, outputDir, schemasOutputPath) {
+  const outDir = path.resolve(process.cwd(), outputDir);
+  const outFile = schemasOutputPath ? path.resolve(process.cwd(), schemasOutputPath) : path.join(outDir, "schemas.ts");
+  const schemasDir = path.dirname(outFile);
+  const apiTypesPath = path.join(outDir, "api", "types.gen.ts");
+  const apiTypesImportPath = toImportPath(schemasDir, apiTypesPath);
+  if (!fs.existsSync(apiTypesPath)) {
+    console.warn("litestar-vite: api/types.gen.ts not found, skipping schemas.ts generation");
+    return false;
+  }
+  if (!fs.existsSync(routesJsonPath)) {
+    console.warn("litestar-vite: routes.json not found, skipping schemas.ts generation");
+    return false;
+  }
+  const routesContent = await fs.promises.readFile(routesJsonPath, "utf-8");
+  const routesJson = JSON.parse(routesContent);
+  const typesContent = await fs.promises.readFile(apiTypesPath, "utf-8");
+  const { urlToDataType, responsesTypes, errorsTypes } = parseHeyApiTypes(typesContent);
+  const mappings = createOperationMappings(routesJson.routes, urlToDataType, responsesTypes, errorsTypes);
+  const content = generateSchemasTs(mappings, apiTypesImportPath);
+  await fs.promises.mkdir(schemasDir, { recursive: true });
+  const result = await writeIfChanged(outFile, content, { encoding: "utf-8" });
+  return result.changed;
+}
+export {
+  emitSchemasTypes
+};

package/dist/js/shared/network.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Network utilities for URL and host normalization.
+ */
+/**
+ * Normalizes a host address for URL construction.
+ *
+ * Handles various host formats to produce browser-compatible URLs:
+ * - Converts bind-all addresses (::, 0.0.0.0) to localhost
+ * - Converts IPv4/IPv6 localhost addresses (::1, 127.0.0.1) to localhost
+ * - Wraps other IPv6 addresses in brackets for URL compatibility
+ *
+ * @example
+ * ```typescript
+ * normalizeHost("::") // => "localhost"
+ * normalizeHost("0.0.0.0") // => "localhost"
+ * normalizeHost("::1") // => "localhost"
+ * normalizeHost("127.0.0.1") // => "localhost"
+ * normalizeHost("fe80::1") // => "[fe80::1]"
+ * normalizeHost("[fe80::1]") // => "[fe80::1]" (already bracketed)
+ * normalizeHost("192.168.1.1") // => "192.168.1.1"
+ * ```
+ */
+export declare function normalizeHost(host: string): string;
+/**
+ * Resolve the absolute hot file path from bundleDir + hotFile.
+ *
+ * Python config stores hot_file as a filename (relative to bundle_dir) by default.
+ * If hotFile already includes bundleDir, avoid double-prefixing.
+ */
+export declare function resolveHotFilePath(bundleDir: string, hotFile: string, rootDir?: string): string;

package/dist/js/shared/network.js

@@ -0,0 +1,25 @@
+import path from "node:path";
+function normalizeHost(host) {
+  if (host === "::" || host === "::1" || host === "0.0.0.0" || host === "127.0.0.1") {
+    return "localhost";
+  }
+  if (host.includes(":") && !host.startsWith("[")) {
+    return `[${host}]`;
+  }
+  return host;
+}
+function resolveHotFilePath(bundleDir, hotFile, rootDir = process.cwd()) {
+  if (path.isAbsolute(hotFile)) {
+    return hotFile;
+  }
+  const normalizedHot = hotFile.replace(/^\/+/, "");
+  const normalizedBundle = bundleDir.replace(/^\/+/, "").replace(/\/+$/, "");
+  if (normalizedBundle && normalizedHot.startsWith(`${normalizedBundle}/`)) {
+    return path.resolve(rootDir, normalizedHot);
+  }
+  return path.resolve(rootDir, normalizedBundle, normalizedHot);
+}
+export {
+  normalizeHost,
+  resolveHotFilePath
+};

package/dist/js/shared/typegen-core.d.ts

@@ -10,12 +10,18 @@ export interface TypeGenCoreConfig {
     output: string;
     /** Path to inertia-pages.json (relative or absolute) */
     pagePropsPath: string;
+    /** Path to routes.json (relative or absolute) */
+    routesPath: string;
     /** Whether to generate SDK client */
     generateSdk: boolean;
     /** Whether to generate Zod schemas */
     generateZod: boolean;
     /** Whether to generate page props types */
     generatePageProps: boolean;
+    /** Whether to generate schema helper types (schemas.ts) */
+    generateSchemas: boolean;
+    /** Optional path for schemas.ts output */
+    schemasTsPath?: string;
     /** SDK client plugin (e.g., "@hey-api/client-fetch") */
     sdkClientPlugin: string;
     /** JS runtime executor (e.g., "bun", "pnpm") */

package/dist/js/shared/typegen-core.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { promisify } from "node:util";
 import { resolveInstallHint, resolvePackageExecutor } from "../install-hint.js";
 import { emitPagePropsTypes } from "./emit-page-props-types.js";
+import { emitSchemasTypes } from "./emit-schemas-types.js";
 const execAsync = promisify(exec);
 const nodeRequire = createRequire(import.meta.url);
 function findOpenApiTsConfig(projectRoot) {
@@ -109,6 +110,26 @@ async function runTypeGeneration(config, options = {}) {
         logger?.error(`Page props generation failed: ${message}`);
       }
     }
+    const { generateSchemas, routesPath, schemasTsPath } = config;
+    if (generateSchemas && routesPath) {
+      const absoluteRoutesPath = path.resolve(projectRoot, routesPath);
+      if (fs.existsSync(absoluteRoutesPath)) {
+        try {
+          const changed = await emitSchemasTypes(absoluteRoutesPath, output, schemasTsPath);
+          const schemasOutput = schemasTsPath ?? path.join(output, "schemas.ts");
+          if (changed) {
+            result.generatedFiles.push(schemasOutput);
+            result.generated = true;
+          } else {
+            result.skippedFiles.push(schemasOutput);
+          }
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          result.errors.push(`Schema types generation failed: ${message}`);
+          logger?.error(`Schema types generation failed: ${message}`);
+        }
+      }
+    }
   } finally {
     result.durationMs = Date.now() - startTime;
   }

package/dist/js/shared/typegen-plugin.d.ts

@@ -5,10 +5,12 @@ export interface RequiredTypeGenConfig {
     openapiPath: string;
     routesPath: string;
     pagePropsPath: string;
+    schemasTsPath?: string;
     generateZod: boolean;
     generateSdk: boolean;
     generateRoutes: boolean;
     generatePageProps: boolean;
+    generateSchemas: boolean;
     globalRoute: boolean;
     debounce: number;
 }

package/dist/js/shared/typegen-plugin.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import colors from "picocolors";
 import { debounce } from "./debounce.js";
 import { emitPagePropsTypes } from "./emit-page-props-types.js";
+import { emitSchemasTypes } from "./emit-schemas-types.js";
 import { formatPath } from "./format-path.js";
 import { shouldRunOpenApiTs, updateOpenApiTsCache } from "./typegen-cache.js";
 import { buildHeyApiPlugins, findOpenApiTsConfig, runHeyApiGeneration } from "./typegen-core.js";
@@ -60,11 +61,13 @@ function createLitestarTypeGenPlugin(typesConfig, options) {
             projectRoot,
             openapiPath: typesConfig.openapiPath,
             output: typesConfig.output,
+            routesPath: typesConfig.routesPath,
             pagePropsPath: typesConfig.pagePropsPath,
             generateSdk: typesConfig.generateSdk,
             generateZod: typesConfig.generateZod,
             generatePageProps: false,
             // Handle separately below
+            generateSchemas: typesConfig.generateSchemas,
             sdkClientPlugin,
             executor
           };
@@ -97,6 +100,20 @@ function createLitestarTypeGenPlugin(typesConfig, options) {
           logger.error(`Page props generation failed: ${message}`);
         }
       }
+      const absoluteRoutesPath = path.resolve(projectRoot, typesConfig.routesPath);
+      if (typesConfig.generateSchemas && fs.existsSync(absoluteRoutesPath)) {
+        try {
+          const changed = await emitSchemasTypes(absoluteRoutesPath, typesConfig.output, typesConfig.schemasTsPath);
+          if (changed) {
+            generated = true;
+          } else {
+            resolvedConfig?.logger.info(`${colors.cyan("\u2022")} Schema types ${colors.dim("(unchanged)")}`);
+          }
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          logger.error(`Schema types generation failed: ${message}`);
+        }
+      }
       if (generated && resolvedConfig) {
         const duration = Date.now() - startTime;
         resolvedConfig.logger.info(`${colors.green("\u2713")} TypeScript artifacts updated ${colors.dim(`(${duration}ms)`)}`);

package/dist/js/sveltekit.d.ts

@@ -18,10 +18,7 @@
  *   plugins: [
  *     litestarSvelteKit({
  *       apiProxy: 'http://localhost:8000',
- *       types: {
- *         enabled: true,
- *         output: 'src/lib/generated',
- *       },
+ *       types: true,
  *     }),
  *     sveltekit(),  // SvelteKit plugin comes after
  *   ],
@@ -51,19 +48,25 @@ export interface SvelteKitTypesConfig {
     /**
      * Path where the OpenAPI schema is exported by Litestar.
      *
-     * @default 'openapi.json'
+     * @default `${output}/openapi.json`
      */
     openapiPath?: string;
     /**
      * Path where route metadata is exported by Litestar.
      *
-     * @default 'routes.json'
+     * @default `${output}/routes.json`
      */
     routesPath?: string;
+    /**
+     * Optional path for the generated schemas.ts helper file.
+     *
+     * @default `${output}/schemas.ts`
+     */
+    schemasTsPath?: string;
     /**
      * Path where Inertia page props metadata is exported by Litestar.
      *
-     * @default 'inertia-pages.json'
+     * @default `${output}/inertia-pages.json`
      */
     pagePropsPath?: string;
     /**
@@ -90,6 +93,12 @@ export interface SvelteKitTypesConfig {
      * @default true
      */
     generatePageProps?: boolean;
+    /**
+     * Generate schemas.ts with ergonomic form/response type helpers.
+     *
+     * @default true
+     */
+    generateSchemas?: boolean;
     /**
      * Register route() globally on window object.
      *

package/dist/js/sveltekit.js

@@ -2,6 +2,8 @@ import fs from "node:fs";
 import path from "node:path";
 import colors from "picocolors";
 import { readBridgeConfig } from "./shared/bridge-schema.js";
+import { DEBOUNCE_MS } from "./shared/constants.js";
+import { normalizeHost, resolveHotFilePath } from "./shared/network.js";
 import { createLitestarTypeGenPlugin } from "./shared/typegen-plugin.js";
 function resolveConfig(config = {}) {
   let hotFile;
@@ -21,7 +23,7 @@ function resolveConfig(config = {}) {
   if (runtime) {
     hasPythonConfig = true;
     const hot = runtime.hotFile;
-    hotFile = path.isAbsolute(hot) ? hot : path.resolve(process.cwd(), runtime.bundleDir, hot);
+    hotFile = resolveHotFilePath(runtime.bundleDir, hot);
     proxyMode = runtime.proxyMode;
     port = runtime.port;
     pythonExecutor = runtime.executor;
@@ -30,47 +32,71 @@ function resolveConfig(config = {}) {
     }
   }
   let typesConfig = false;
+  const defaultTypesOutput = "src/lib/generated";
+  const buildTypeDefaults = (output) => ({
+    openapiPath: path.join(output, "openapi.json"),
+    routesPath: path.join(output, "routes.json"),
+    pagePropsPath: path.join(output, "inertia-pages.json"),
+    schemasTsPath: path.join(output, "schemas.ts")
+  });
   if (config.types === true) {
+    const output = pythonTypesConfig?.output ?? defaultTypesOutput;
+    const defaults = buildTypeDefaults(output);
     typesConfig = {
       enabled: true,
-      output: pythonTypesConfig?.output ?? "src/lib/generated",
-      openapiPath: pythonTypesConfig?.openapiPath ?? "openapi.json",
-      routesPath: pythonTypesConfig?.routesPath ?? "routes.json",
-      pagePropsPath: pythonTypesConfig?.pagePropsPath ?? "inertia-pages.json",
+      output,
+      openapiPath: pythonTypesConfig?.openapiPath ?? defaults.openapiPath,
+      routesPath: pythonTypesConfig?.routesPath ?? defaults.routesPath,
+      pagePropsPath: pythonTypesConfig?.pagePropsPath ?? defaults.pagePropsPath,
+      schemasTsPath: pythonTypesConfig?.schemasTsPath ?? defaults.schemasTsPath,
       generateZod: pythonTypesConfig?.generateZod ?? false,
       generateSdk: pythonTypesConfig?.generateSdk ?? true,
       generateRoutes: pythonTypesConfig?.generateRoutes ?? true,
       generatePageProps: pythonTypesConfig?.generatePageProps ?? true,
+      generateSchemas: pythonTypesConfig?.generateSchemas ?? true,
       globalRoute: pythonTypesConfig?.globalRoute ?? false,
-      debounce: 300
+      debounce: DEBOUNCE_MS
     };
   } else if (typeof config.types === "object" && config.types !== null) {
+    const userProvidedOutput = Object.hasOwn(config.types, "output");
+    const output = config.types.output ?? pythonTypesConfig?.output ?? defaultTypesOutput;
+    const defaults = buildTypeDefaults(output);
+    const openapiFallback = userProvidedOutput ? defaults.openapiPath : pythonTypesConfig?.openapiPath ?? defaults.openapiPath;
+    const routesFallback = userProvidedOutput ? defaults.routesPath : pythonTypesConfig?.routesPath ?? defaults.routesPath;
+    const pagePropsFallback = userProvidedOutput ? defaults.pagePropsPath : pythonTypesConfig?.pagePropsPath ?? defaults.pagePropsPath;
+    const schemasFallback = userProvidedOutput ? defaults.schemasTsPath : pythonTypesConfig?.schemasTsPath ?? defaults.schemasTsPath;
     typesConfig = {
       enabled: config.types.enabled ?? true,
-      output: config.types.output ?? pythonTypesConfig?.output ?? "src/lib/generated",
-      openapiPath: config.types.openapiPath ?? pythonTypesConfig?.openapiPath ?? "openapi.json",
-      routesPath: config.types.routesPath ?? pythonTypesConfig?.routesPath ?? "routes.json",
-      pagePropsPath: config.types.pagePropsPath ?? pythonTypesConfig?.pagePropsPath ?? "inertia-pages.json",
+      output,
+      openapiPath: config.types.openapiPath ?? openapiFallback,
+      routesPath: config.types.routesPath ?? routesFallback,
+      pagePropsPath: config.types.pagePropsPath ?? pagePropsFallback,
+      schemasTsPath: config.types.schemasTsPath ?? schemasFallback,
       generateZod: config.types.generateZod ?? pythonTypesConfig?.generateZod ?? false,
       generateSdk: config.types.generateSdk ?? pythonTypesConfig?.generateSdk ?? true,
       generateRoutes: config.types.generateRoutes ?? pythonTypesConfig?.generateRoutes ?? true,
       generatePageProps: config.types.generatePageProps ?? pythonTypesConfig?.generatePageProps ?? true,
+      generateSchemas: config.types.generateSchemas ?? pythonTypesConfig?.generateSchemas ?? true,
       globalRoute: config.types.globalRoute ?? pythonTypesConfig?.globalRoute ?? false,
-      debounce: config.types.debounce ?? 300
+      debounce: config.types.debounce ?? DEBOUNCE_MS
     };
   } else if (config.types !== false && pythonTypesConfig?.enabled) {
+    const output = pythonTypesConfig.output ?? defaultTypesOutput;
+    const defaults = buildTypeDefaults(output);
     typesConfig = {
       enabled: true,
-      output: pythonTypesConfig.output ?? "src/lib/generated",
-      openapiPath: pythonTypesConfig.openapiPath ?? "openapi.json",
-      routesPath: pythonTypesConfig.routesPath ?? "routes.json",
-      pagePropsPath: pythonTypesConfig.pagePropsPath ?? "inertia-pages.json",
+      output,
+      openapiPath: pythonTypesConfig.openapiPath ?? defaults.openapiPath,
+      routesPath: pythonTypesConfig.routesPath ?? defaults.routesPath,
+      pagePropsPath: pythonTypesConfig.pagePropsPath ?? defaults.pagePropsPath,
+      schemasTsPath: pythonTypesConfig.schemasTsPath ?? defaults.schemasTsPath,
       generateZod: pythonTypesConfig.generateZod ?? false,
       generateSdk: pythonTypesConfig.generateSdk ?? true,
       generateRoutes: pythonTypesConfig.generateRoutes ?? true,
       generatePageProps: pythonTypesConfig.generatePageProps ?? true,
+      generateSchemas: pythonTypesConfig.generateSchemas ?? true,
       globalRoute: pythonTypesConfig.globalRoute ?? false,
-      debounce: 300
+      debounce: DEBOUNCE_MS
     };
   }
   return {
@@ -127,12 +153,7 @@ function litestarSvelteKit(userConfig = {}) {
         server.httpServer?.once("listening", () => {
           const address = server.httpServer?.address();
           if (address && typeof address === "object" && "port" in address) {
-            let host = address.address;
-            if (host === "::" || host === "::1") {
-              host = "localhost";
-            } else if (host.includes(":")) {
-              host = `[${host}]`;
-            }
+            const host = normalizeHost(address.address);
             const url = `http://${host}:${address.port}`;
             fs.mkdirSync(path.dirname(hotFile), { recursive: true });
             fs.writeFileSync(hotFile, url);