litestar-vite-plugin 0.15.0-beta.5 → 0.15.0-beta.6

package/dist/js/index.js

@@ -1,18 +1,13 @@
-import { exec } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { promisify } from "node:util";
 import colors from "picocolors";
 import { loadEnv } from "vite";
 import fullReload from "vite-plugin-full-reload";
-import { resolveInstallHint, resolvePackageExecutor } from "./install-hint.js";
 import { checkBackendAvailability, loadLitestarMeta } from "./litestar-meta.js";
-import { debounce } from "./shared/debounce.js";
-import { emitRouteTypes } from "./shared/emit-route-types.js";
-import { formatPath } from "./shared/format-path.js";
+import { readBridgeConfig } from "./shared/bridge-schema.js";
 import { createLogger } from "./shared/logger.js";
-const execAsync = promisify(exec);
+import { createLitestarTypeGenPlugin } from "./shared/typegen-plugin.js";
 let exitHandlersBound = false;
 let warnedMissingRuntimeConfig = false;
 const refreshPaths = ["src/**", "resources/**", "assets/**"].filter((path2) => fs.existsSync(path2.replace(/\*\*$/, "")));
@@ -20,7 +15,15 @@ function litestar(config) {
   const pluginConfig = resolvePluginConfig(config);
   const plugins = [resolveLitestarPlugin(pluginConfig), ...resolveFullReloadConfig(pluginConfig)];
   if (pluginConfig.types !== false && pluginConfig.types.enabled) {
-    plugins.push(resolveTypeGenerationPlugin(pluginConfig.types, pluginConfig.executor, pluginConfig.hasPythonConfig));
+    plugins.push(
+      createLitestarTypeGenPlugin(pluginConfig.types, {
+        pluginName: "litestar-vite-types",
+        frameworkName: "litestar-vite",
+        sdkClientPlugin: "@hey-api/client-axios",
+        executor: pluginConfig.executor,
+        hasPythonConfig: pluginConfig.hasPythonConfig
+      })
+    );
   }
   return plugins;
 }
@@ -36,7 +39,7 @@ async function findIndexHtmlPath(server, pluginConfig) {
     path.join(root, "index.html"),
     path.join(root, pluginConfig.resourceDir.replace(/^\//, ""), "index.html"),
     // Ensure resourceDir path is relative to root
-    path.join(root, pluginConfig.publicDir.replace(/^\//, ""), "index.html"),
+    path.join(root, pluginConfig.staticDir.replace(/^\//, ""), "index.html"),
     path.join(root, pluginConfig.bundleDir.replace(/^\//, ""), "index.html")
   ];
   for (const indexPath of possiblePaths) {
@@ -67,7 +70,6 @@ function resolveLitestarPlugin(pluginConfig) {
   let litestarMeta = {};
   let shuttingDown = false;
   const pythonDefaults = loadPythonDefaults();
-  const proxyMode = pythonDefaults?.proxyMode ?? "vite_proxy";
   const logger = createLogger(pythonDefaults?.logging);
   const defaultAliases = {
     "@": `/${pluginConfig.resourceDir.replace(/^\/+/, "").replace(/\/+$/, "")}/`
@@ -113,7 +115,7 @@ function resolveLitestarPlugin(pluginConfig) {
       ensureCommandShouldRunInEnvironment(command, env, mode);
       return {
         base: userConfig.base ?? (command === "build" ? resolveBase(pluginConfig, assetUrl) : devBase),
-        publicDir: userConfig.publicDir ?? pluginConfig.publicDir ?? false,
+        publicDir: userConfig.publicDir ?? pluginConfig.staticDir ?? false,
         clearScreen: false,
         build: {
           manifest: userConfig.build?.manifest ?? (ssr ? false : "manifest.json"),
@@ -230,10 +232,8 @@ function resolveLitestarPlugin(pluginConfig) {
         const isAddressInfo = (x) => typeof x === "object";
         if (isAddressInfo(address)) {
           viteDevServerUrl = userConfig.server?.origin ? userConfig.server.origin : resolveDevServerUrl(address, server.config, userConfig);
-          if (proxyMode !== "external_proxy") {
-            fs.mkdirSync(path.dirname(pluginConfig.hotFile), { recursive: true });
-            fs.writeFileSync(pluginConfig.hotFile, viteDevServerUrl);
-          }
+          fs.mkdirSync(path.dirname(pluginConfig.hotFile), { recursive: true });
+          fs.writeFileSync(pluginConfig.hotFile, viteDevServerUrl);
           setTimeout(async () => {
             if (logger.config.level === "quiet") return;
             const litestarVersion = litestarMeta.litestarVersion ?? process.env.LITESTAR_VERSION ?? "unknown";
@@ -292,7 +292,7 @@ function resolveLitestarPlugin(pluginConfig) {
           }, 100);
         }
       });
-      if (!exitHandlersBound && proxyMode !== "external_proxy") {
+      if (!exitHandlersBound) {
         const clean = () => {
           if (pluginConfig.hotFile && fs.existsSync(pluginConfig.hotFile)) {
             fs.rmSync(pluginConfig.hotFile);
@@ -369,26 +369,12 @@ function ensureCommandShouldRunInEnvironment(command, env, mode) {
 }
 function loadPythonDefaults() {
   const isTestEnv = Boolean(process.env.VITEST || process.env.VITE_TEST || process.env.NODE_ENV === "test");
-  let configPath = process.env.LITESTAR_VITE_CONFIG_PATH;
-  if (!configPath) {
-    const defaultPath = path.join(process.cwd(), ".litestar.json");
-    if (fs.existsSync(defaultPath)) {
-      configPath = defaultPath;
-    } else {
-      warnMissingRuntimeConfig("env", isTestEnv);
-      return null;
-    }
-  }
-  if (!fs.existsSync(configPath)) {
-    warnMissingRuntimeConfig("file", isTestEnv);
-    return null;
-  }
-  try {
-    const data = JSON.parse(fs.readFileSync(configPath, "utf8"));
-    return data;
-  } catch {
+  const defaults = readBridgeConfig();
+  if (!defaults) {
+    warnMissingRuntimeConfig("env", isTestEnv);
     return null;
   }
+  return defaults;
 }
 function formatMissingConfigWarning() {
   const y = colors.yellow;
@@ -453,10 +439,10 @@ function resolvePluginConfig(config) {
       throw new Error("litestar-vite-plugin: bundleDir must be a subdirectory. E.g. 'public'.");
     }
   }
-  if (typeof resolvedConfig.publicDir === "string") {
-    resolvedConfig.publicDir = resolvedConfig.publicDir.trim().replace(/^\/+/, "").replace(/\/+$/, "");
-    if (resolvedConfig.publicDir === "") {
-      throw new Error("litestar-vite-plugin: publicDir must be a subdirectory. E.g. 'public'.");
+  if (typeof resolvedConfig.staticDir === "string") {
+    resolvedConfig.staticDir = resolvedConfig.staticDir.trim().replace(/^\/+/, "").replace(/\/+$/, "");
+    if (resolvedConfig.staticDir === "") {
+      throw new Error("litestar-vite-plugin: staticDir must be a subdirectory. E.g. 'src/public'.");
     }
   }
   if (typeof resolvedConfig.ssrOutDir === "string") {
@@ -476,6 +462,8 @@ function resolvePluginConfig(config) {
       pagePropsPath: "src/generated/inertia-pages.json",
       generateZod: false,
       generateSdk: false,
+      generateRoutes: true,
+      generatePageProps: true,
       globalRoute: false,
       debounce: 300
     };
@@ -486,10 +474,12 @@ function resolvePluginConfig(config) {
         output: pythonDefaults.types.output,
         openapiPath: pythonDefaults.types.openapiPath,
         routesPath: pythonDefaults.types.routesPath,
-        pagePropsPath: pythonDefaults.types.pagePropsPath ?? path.join(pythonDefaults.types.output, "inertia-pages.json"),
+        pagePropsPath: pythonDefaults.types.pagePropsPath,
         generateZod: pythonDefaults.types.generateZod,
         generateSdk: pythonDefaults.types.generateSdk,
-        globalRoute: pythonDefaults.types.globalRoute ?? false,
+        generateRoutes: pythonDefaults.types.generateRoutes,
+        generatePageProps: pythonDefaults.types.generatePageProps,
+        globalRoute: pythonDefaults.types.globalRoute,
         debounce: 300
       };
     }
@@ -505,6 +495,8 @@ function resolvePluginConfig(config) {
       pagePropsPath: resolvedConfig.types.pagePropsPath ?? (resolvedConfig.types.output ? path.join(resolvedConfig.types.output, "inertia-pages.json") : "src/generated/inertia-pages.json"),
       generateZod: resolvedConfig.types.generateZod ?? false,
       generateSdk: resolvedConfig.types.generateSdk ?? false,
+      generateRoutes: resolvedConfig.types.generateRoutes ?? true,
+      generatePageProps: resolvedConfig.types.generatePageProps ?? true,
       globalRoute: resolvedConfig.types.globalRoute ?? false,
       debounce: resolvedConfig.types.debounce ?? 300
     };
@@ -519,14 +511,15 @@ function resolvePluginConfig(config) {
     }
   }
   const inertiaMode = resolvedConfig.inertiaMode ?? pythonDefaults?.mode === "inertia";
+  const effectiveResourceDir = resolvedConfig.resourceDir ?? pythonDefaults?.resourceDir ?? "src";
   const result = {
     input: resolvedConfig.input,
     assetUrl: normalizeAssetUrl(resolvedConfig.assetUrl ?? pythonDefaults?.assetUrl ?? "/static/"),
-    resourceDir: resolvedConfig.resourceDir ?? pythonDefaults?.resourceDir ?? "src",
+    resourceDir: effectiveResourceDir,
     bundleDir: resolvedConfig.bundleDir ?? pythonDefaults?.bundleDir ?? "public",
-    publicDir: resolvedConfig.publicDir ?? pythonDefaults?.publicDir ?? "public",
+    staticDir: resolvedConfig.staticDir ?? pythonDefaults?.staticDir ?? path.join(effectiveResourceDir, "public"),
     ssr: resolvedConfig.ssr ?? resolvedConfig.input,
-    ssrOutDir: resolvedConfig.ssrOutDir ?? pythonDefaults?.ssrOutDir ?? path.join(resolvedConfig.resourceDir ?? pythonDefaults?.resourceDir ?? "src", "bootstrap/ssr"),
+    ssrOutDir: resolvedConfig.ssrOutDir ?? pythonDefaults?.ssrOutDir ?? path.join(effectiveResourceDir, "bootstrap/ssr"),
     refresh: resolvedConfig.refresh ?? false,
     hotFile: resolvedConfig.hotFile ?? path.join(resolvedConfig.bundleDir ?? "public", "hot"),
     detectTls: resolvedConfig.detectTls ?? false,
@@ -553,8 +546,8 @@ function validateAgainstPythonDefaults(resolved, pythonDefaults, userConfig) {
   if (userConfig.resourceDir !== void 0 && hasPythonValue(pythonDefaults.resourceDir) && resolved.resourceDir !== pythonDefaults.resourceDir) {
     warnings.push(`resourceDir: vite.config.ts="${resolved.resourceDir}" differs from Python="${pythonDefaults.resourceDir}"`);
   }
-  if (userConfig.publicDir !== void 0 && hasPythonValue(pythonDefaults.publicDir) && resolved.publicDir !== pythonDefaults.publicDir) {
-    warnings.push(`publicDir: vite.config.ts="${resolved.publicDir}" differs from Python="${pythonDefaults.publicDir}"`);
+  if (userConfig.staticDir !== void 0 && hasPythonValue(pythonDefaults.staticDir) && resolved.staticDir !== pythonDefaults.staticDir) {
+    warnings.push(`staticDir: vite.config.ts="${resolved.staticDir}" differs from Python="${pythonDefaults.staticDir}"`);
   }
   if (pythonDefaults.ssrEnabled && userConfig.ssrOutDir !== void 0 && hasPythonValue(pythonDefaults.ssrOutDir) && resolved.ssrOutDir !== pythonDefaults.ssrOutDir) {
     warnings.push(`ssrOutDir: vite.config.ts="${resolved.ssrOutDir}" differs from Python="${pythonDefaults.ssrOutDir}"`);
@@ -609,335 +602,6 @@ function resolveFullReloadConfig({ refresh: config }) {
     return plugin;
   });
 }
-async function emitPagePropsTypes(pagesPath, outputDir) {
-  const contents = await fs.promises.readFile(pagesPath, "utf-8");
-  const json = JSON.parse(contents);
-  const outDir = path.resolve(process.cwd(), outputDir);
-  await fs.promises.mkdir(outDir, { recursive: true });
-  const outFile = path.join(outDir, "page-props.ts");
-  const { includeDefaultAuth, includeDefaultFlash } = json.typeGenConfig;
-  let userTypes = "";
-  let authTypes = "";
-  let flashTypes = "";
-  if (includeDefaultAuth) {
-    userTypes = `/**
- * Default User interface - minimal baseline for common auth patterns.
- * Users extend this via module augmentation with their full user model.
- *
- * @example
- * declare module 'litestar-vite/inertia' {
- *   interface User {
- *     avatarUrl?: string | null
- *     roles: Role[]
- *     teams: Team[]
- *   }
- * }
- */
-export interface User {
-  id: string
-  email: string
-  name?: string | null
-}
-
-`;
-    authTypes = `/**
- * Default AuthData interface - mirrors Laravel Jetstream pattern.
- * isAuthenticated + optional user is the universal pattern.
- */
-export interface AuthData {
-  isAuthenticated: boolean
-  user?: User
-}
-
-`;
-  } else {
-    userTypes = `/**
- * User interface - define via module augmentation.
- * Default auth types are disabled.
- *
- * @example
- * declare module 'litestar-vite/inertia' {
- *   interface User {
- *     uuid: string
- *     username: string
- *   }
- * }
- */
-export interface User {}
-
-`;
-    authTypes = `/**
- * AuthData interface - define via module augmentation.
- * Default auth types are disabled.
- */
-export interface AuthData {}
-
-`;
-  }
-  if (includeDefaultFlash) {
-    flashTypes = `/**
- * Default FlashMessages interface - category to messages mapping.
- * Standard categories: success, error, info, warning.
- */
-export interface FlashMessages {
-  [category: string]: string[]
-}
-
-`;
-  } else {
-    flashTypes = `/**
- * FlashMessages interface - define via module augmentation.
- * Default flash types are disabled.
- */
-export interface FlashMessages {}
-
-`;
-  }
-  const sharedPropsContent = includeDefaultAuth || includeDefaultFlash ? `  auth?: AuthData
-  flash?: FlashMessages` : "";
-  const pageEntries = [];
-  for (const [component, data] of Object.entries(json.pages)) {
-    const propsType = data.propsType ? data.propsType : "Record<string, unknown>";
-    pageEntries.push(`  "${component}": ${propsType} & FullSharedProps`);
-  }
-  const body = `// AUTO-GENERATED by litestar-vite. Do not edit.
-/* eslint-disable */
-
-${userTypes}${authTypes}${flashTypes}/**
- * Generated shared props (always present).
- * Includes built-in props + static config props.
- */
-export interface GeneratedSharedProps {
-  errors?: Record<string, string[]>
-  csrf_token?: string
-}
-
-/**
- * User-defined shared props for dynamic share() calls in guards/middleware.
- * Extend this interface via module augmentation.
- *
- * @example
- * declare module 'litestar-vite/inertia' {
- *   interface User {
- *     avatarUrl?: string | null
- *     roles: Role[]
- *     teams: Team[]
- *   }
- *   interface SharedProps {
- *     locale?: string
- *     currentTeam?: CurrentTeam
- *   }
- * }
- */
-export interface SharedProps {
-${sharedPropsContent}
-}
-
-/** Full shared props = generated + user-defined */
-export type FullSharedProps = GeneratedSharedProps & SharedProps
-
-/** Page props mapped by component name */
-export interface PageProps {
-${pageEntries.join("\n")}
-}
-
-/** Component name union type */
-export type ComponentName = keyof PageProps
-
-/** Type-safe props for a specific component */
-export type InertiaPageProps<C extends ComponentName> = PageProps[C]
-
-/** Get props type for a specific page component */
-export type PagePropsFor<C extends ComponentName> = PageProps[C]
-
-// Re-export for module augmentation
-declare module "litestar-vite/inertia" {
-  export { User, AuthData, FlashMessages, SharedProps, GeneratedSharedProps, FullSharedProps, PageProps, ComponentName, InertiaPageProps, PagePropsFor }
-}
-`;
-  await fs.promises.writeFile(outFile, body, "utf-8");
-}
-function resolveTypeGenerationPlugin(typesConfig, executor, hasPythonConfig) {
-  let lastTypesHash = null;
-  let lastRoutesHash = null;
-  let lastPagePropsHash = null;
-  let server = null;
-  let isGenerating = false;
-  let resolvedConfig = null;
-  let chosenConfigPath = null;
-  async function runTypeGeneration() {
-    if (isGenerating) {
-      return false;
-    }
-    isGenerating = true;
-    const startTime = Date.now();
-    try {
-      const projectRoot = resolvedConfig?.root ?? process.cwd();
-      const openapiPath = path.resolve(projectRoot, typesConfig.openapiPath);
-      const routesPath = path.resolve(projectRoot, typesConfig.routesPath);
-      const pagePropsPath = path.resolve(projectRoot, typesConfig.pagePropsPath);
-      let generated = false;
-      const candidates = [path.resolve(projectRoot, "openapi-ts.config.ts"), path.resolve(projectRoot, "hey-api.config.ts"), path.resolve(projectRoot, ".hey-api.config.ts")];
-      const configPath = candidates.find((p) => fs.existsSync(p)) || null;
-      chosenConfigPath = configPath;
-      const shouldRunOpenApiTs = configPath || typesConfig.generateSdk;
-      if (fs.existsSync(openapiPath) && shouldRunOpenApiTs) {
-        resolvedConfig?.logger.info(`${colors.cyan("\u2022")} Generating TypeScript types...`);
-        if (resolvedConfig && configPath) {
-          const relConfigPath = formatPath(configPath, resolvedConfig.root);
-          resolvedConfig.logger.info(`${colors.cyan("\u2022")} openapi-ts config: ${relConfigPath}`);
-        }
-        const sdkOutput = path.join(typesConfig.output, "api");
-        let args;
-        if (configPath) {
-          args = ["@hey-api/openapi-ts", "--file", configPath];
-        } else {
-          args = ["@hey-api/openapi-ts", "-i", typesConfig.openapiPath, "-o", sdkOutput];
-          const plugins = ["@hey-api/typescript", "@hey-api/schemas"];
-          if (typesConfig.generateSdk) {
-            plugins.push("@hey-api/sdk", "@hey-api/client-axios");
-          }
-          if (typesConfig.generateZod) {
-            plugins.push("zod");
-          }
-          if (plugins.length) {
-            args.push("--plugins", ...plugins);
-          }
-        }
-        if (typesConfig.generateZod) {
-          try {
-            require.resolve("zod", { paths: [process.cwd()] });
-          } catch {
-            resolvedConfig?.logger.warn(`${colors.yellow("!")} zod not installed - run: ${resolveInstallHint()} zod`);
-          }
-        }
-        await execAsync(resolvePackageExecutor(args.join(" "), executor), {
-          cwd: projectRoot
-        });
-        generated = true;
-      }
-      if (fs.existsSync(routesPath)) {
-        await emitRouteTypes(routesPath, typesConfig.output, { globalRoute: typesConfig.globalRoute ?? false });
-        generated = true;
-      }
-      if (fs.existsSync(pagePropsPath)) {
-        await emitPagePropsTypes(pagePropsPath, typesConfig.output);
-        generated = true;
-      }
-      if (generated && resolvedConfig) {
-        const duration = Date.now() - startTime;
-        resolvedConfig.logger.info(`${colors.green("\u2713")} TypeScript artifacts updated ${colors.dim(`(${duration}ms)`)}`);
-      }
-      if (generated && server) {
-        server.ws.send({
-          type: "custom",
-          event: "litestar:types-updated",
-          data: {
-            output: typesConfig.output,
-            timestamp: Date.now()
-          }
-        });
-      }
-      return true;
-    } catch (error) {
-      if (resolvedConfig) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (message.includes("not found") || message.includes("ENOENT")) {
-          const zodHint = typesConfig.generateZod ? " zod" : "";
-          resolvedConfig.logger.warn(
-            `${colors.cyan("litestar-vite")} ${colors.yellow("@hey-api/openapi-ts not installed")} - run: ${resolveInstallHint()} -D @hey-api/openapi-ts${zodHint}`
-          );
-        } else {
-          resolvedConfig.logger.error(`${colors.cyan("litestar-vite")} ${colors.red("type generation failed:")} ${message}`);
-        }
-      }
-      return false;
-    } finally {
-      isGenerating = false;
-    }
-  }
-  const debouncedRunTypeGeneration = debounce(runTypeGeneration, typesConfig.debounce);
-  return {
-    name: "litestar-vite-types",
-    enforce: "pre",
-    configResolved(config) {
-      resolvedConfig = config;
-    },
-    configureServer(devServer) {
-      server = devServer;
-      if (typesConfig.enabled) {
-        const root = resolvedConfig?.root ?? process.cwd();
-        const openapiRel = path.basename(typesConfig.openapiPath);
-        const routesRel = path.basename(typesConfig.routesPath);
-        resolvedConfig?.logger.info(`${colors.cyan("\u2022")} Watching: ${colors.yellow(openapiRel)}, ${colors.yellow(routesRel)}`);
-        if (chosenConfigPath) {
-          const relConfigPath = formatPath(chosenConfigPath, root);
-          resolvedConfig?.logger.info(`${colors.cyan("\u2022")} openapi-ts config: ${colors.yellow(relConfigPath)}`);
-        }
-      }
-    },
-    async buildStart() {
-      if (typesConfig.enabled && !hasPythonConfig) {
-        const projectRoot = resolvedConfig?.root ?? process.cwd();
-        const openapiPath = path.resolve(projectRoot, typesConfig.openapiPath);
-        if (!fs.existsSync(openapiPath)) {
-          this.warn(
-            `Type generation is enabled but .litestar.json was not found.
-The Litestar backend generates this file on startup.
-
-Solutions:
-  1. Start the backend first: ${colors.cyan("litestar run")}
-  2. Use integrated dev: ${colors.cyan("litestar assets serve")}
-  3. Disable types: ${colors.cyan("litestar({ input: [...], types: false })")}
-`
-          );
-        }
-      }
-      if (typesConfig.enabled) {
-        const projectRoot = resolvedConfig?.root ?? process.cwd();
-        const openapiPath = path.resolve(projectRoot, typesConfig.openapiPath);
-        const routesPath = path.resolve(projectRoot, typesConfig.routesPath);
-        if (fs.existsSync(openapiPath) || fs.existsSync(routesPath)) {
-          await runTypeGeneration();
-        }
-      }
-    },
-    async handleHotUpdate({ file }) {
-      if (!typesConfig.enabled) {
-        return;
-      }
-      const root = resolvedConfig?.root ?? process.cwd();
-      const relativePath = path.relative(root, file);
-      const openapiPath = typesConfig.openapiPath.replace(/^\.\//, "");
-      const routesPath = typesConfig.routesPath.replace(/^\.\//, "");
-      const pagePropsPath = typesConfig.pagePropsPath.replace(/^\.\//, "");
-      const isOpenapi = relativePath === openapiPath || file.endsWith(openapiPath);
-      const isRoutes = relativePath === routesPath || file.endsWith(routesPath);
-      const isPageProps = relativePath === pagePropsPath || file.endsWith(pagePropsPath);
-      if (isOpenapi || isRoutes || isPageProps) {
-        if (resolvedConfig) {
-          resolvedConfig.logger.info(`${colors.cyan("litestar-vite")} ${colors.dim("schema changed:")} ${colors.yellow(relativePath)}`);
-        }
-        const newHash = await getFileMtime(file);
-        if (isOpenapi) {
-          if (lastTypesHash === newHash) return;
-          lastTypesHash = newHash;
-        } else if (isRoutes) {
-          if (lastRoutesHash === newHash) return;
-          lastRoutesHash = newHash;
-        } else if (isPageProps) {
-          if (lastPagePropsHash === newHash) return;
-          lastPagePropsHash = newHash;
-        }
-        debouncedRunTypeGeneration();
-      }
-    }
-  };
-}
-async function getFileMtime(filePath) {
-  const stat = await fs.promises.stat(filePath);
-  return stat.mtimeMs.toString();
-}
 function resolveDevServerUrl(address, config, userConfig) {
   const configHmrProtocol = typeof config.server.hmr === "object" ? config.server.hmr.protocol : null;
   const clientProtocol = configHmrProtocol ? configHmrProtocol === "wss" ? "https" : "http" : null;

package/dist/js/inertia-helpers/index.d.ts

@@ -1,17 +1,16 @@
 /**
  * Inertia.js helpers for Litestar applications.
  *
- * This module re-exports common helpers from litestar-vite-plugin/helpers
- * and adds Inertia-specific utilities.
+ * This module provides Inertia-specific runtime utilities.
+ * For CSRF utilities, import from `litestar-vite-plugin/helpers`.
  *
  * For type-safe routing, import from your generated routes file:
  * ```ts
- * import { route, routes, type RouteName } from '@/generated/routes'
+ * import { route, routeDefinitions, type RouteName } from '@/generated/routes'
  * ```
  *
  * @module
  */
-export { csrfFetch, csrfHeaders, getCsrfToken, } from "litestar-vite-plugin/helpers";
 /**
  * Unwrap page props that may have content nested under "content" key.
  *

package/dist/js/inertia-helpers/index.js

@@ -1,21 +1,16 @@
 /**
  * Inertia.js helpers for Litestar applications.
  *
- * This module re-exports common helpers from litestar-vite-plugin/helpers
- * and adds Inertia-specific utilities.
+ * This module provides Inertia-specific runtime utilities.
+ * For CSRF utilities, import from `litestar-vite-plugin/helpers`.
  *
  * For type-safe routing, import from your generated routes file:
  * ```ts
- * import { route, routes, type RouteName } from '@/generated/routes'
+ * import { route, routeDefinitions, type RouteName } from '@/generated/routes'
  * ```
  *
  * @module
  */
-// Re-export all helpers from the main helpers module
-// Note: Using package path instead of relative import to ensure proper build output structure
-export { csrfFetch, csrfHeaders, 
-// CSRF utilities
-getCsrfToken, } from "litestar-vite-plugin/helpers";
 /**
  * Unwrap page props that may have content nested under "content" key.
  *

package/dist/js/nuxt.d.ts

@@ -17,7 +17,7 @@
  *     apiPrefix: '/api',
  *     types: {
  *       enabled: true,
- *       output: 'types/api',
+ *       output: 'generated',
  *     },
  *   },
  * });
@@ -40,7 +40,7 @@ export interface NuxtTypesConfig {
      * Path to output generated TypeScript types.
      * Relative to the Nuxt project root.
      *
-     * @default 'types/api'
+     * @default 'generated'
      */
     output?: string;
     /**
@@ -55,6 +55,12 @@ export interface NuxtTypesConfig {
      * @default 'routes.json'
      */
     routesPath?: string;
+    /**
+     * Path where Inertia page props metadata is exported by Litestar.
+     *
+     * @default 'inertia-pages.json'
+     */
+    pagePropsPath?: string;
     /**
      * Generate Zod schemas in addition to TypeScript types.
      *
@@ -67,6 +73,24 @@ export interface NuxtTypesConfig {
      * @default true
      */
     generateSdk?: boolean;
+    /**
+     * Generate typed routes.ts from routes.json metadata.
+     *
+     * @default true
+     */
+    generateRoutes?: boolean;
+    /**
+     * Generate Inertia page props types from inertia-pages.json metadata.
+     *
+     * @default true
+     */
+    generatePageProps?: boolean;
+    /**
+     * Register route() globally on window object.
+     *
+     * @default false
+     */
+    globalRoute?: boolean;
     /**
      * Debounce time in milliseconds for type regeneration.
      *
@@ -116,33 +140,6 @@ export interface LitestarNuxtConfig {
      */
     executor?: "node" | "bun" | "deno" | "yarn" | "pnpm";
 }
-/**
- * Litestar Vite plugins for Nuxt.
- *
- * This function returns an array of Vite plugins that can be added to Nuxt's
- * vite configuration. For the full Nuxt module experience, use the module
- * directly in your nuxt.config.ts.
- *
- * @param userConfig - Configuration options
- * @returns Array of Vite plugins
- *
- * @example Using as Vite plugins in nuxt.config.ts
- * ```typescript
- * import { litestarPlugins } from 'litestar-vite-plugin/nuxt';
- *
- * export default defineNuxtConfig({
- *   vite: {
- *     plugins: [
- *       ...litestarPlugins({
- *         apiProxy: 'http://localhost:8000',
- *         types: true,
- *       }),
- *     ],
- *   },
- * });
- * ```
- */
-export declare function litestarPlugins(userConfig?: LitestarNuxtConfig): Plugin[];
 /**
  * Nuxt module definition for Litestar integration.
  *
@@ -158,7 +155,7 @@ export declare function litestarPlugins(userConfig?: LitestarNuxtConfig): Plugin
  *     apiPrefix: '/api',
  *     types: {
  *       enabled: true,
- *       output: 'types/api',
+ *       output: 'generated',
  *     },
  *   },
  * });
@@ -167,8 +164,8 @@ export declare function litestarPlugins(userConfig?: LitestarNuxtConfig): Plugin
  * @example Using generated types in a composable
  * ```typescript
  * // composables/useApi.ts
- * import type { User } from '~/types/api/types.gen';
- * import { route } from '~/types/api/routes';
+ * import type { User } from '~/generated/api/types.gen';
+ * import { route } from '~/generated/routes';
  *
  * export async function useUser(id: string) {
  *   const { data } = await useFetch<User>(route('users.show', { id }));