@typed/vite-plugin 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -89,6 +89,7 @@ export default defineConfig({
 | `routerVmOptions` | `RouterVirtualModulePluginOptions` | `{}` | Options for the router VM plugin. |
 | `apiVmOptions` | `HttpApiVirtualModulePluginOptions` | — | When set, enables the HttpApi VM plugin. |
 | `createTypeInfoApiSession` | `CreateTypeInfoApiSession` | — | Required for router VM type-checking in dev. |
+| `tsconfig` | `string` | — | Path to `tsconfig.json` (relative to cwd or absolute). When set, both the Language Service session and vite-tsconfig-paths use this tsconfig. Default: auto-discovered from project root. |
 | `tsconfigPaths` | `boolean \| object` | `true` | Enable tsconfig path resolution. |
 | `analyze` | `boolean \| object` | `process.env.ANALYZE === '1'` | Enable bundle analyzer (dist/stats.html). |
 | `warnOnError` | `boolean` | `true` | Log virtual module resolution errors. |

package/dist/debugBuildPlugin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Debug plugin for tracing build failures. Enabled when DEBUG_TYPED_BUILD=1.
+ * Logs config resolution and module resolution to diagnose realworld/counter build issues.
+ */
+import type { Plugin } from "vite";
+export declare function createDebugBuildPlugin(): Plugin;
+//# sourceMappingURL=debugBuildPlugin.d.ts.map

package/dist/debugBuildPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugBuildPlugin.d.ts","sourceRoot":"","sources":["../src/debugBuildPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAsBnC,wBAAgB,sBAAsB,IAAI,MAAM,CAmC/C"}

package/dist/debugBuildPlugin.js

@@ -0,0 +1,54 @@
+const LOG_URL = "http://127.0.0.1:7563/ingest/ae4c829f-512d-4a3a-9ef6-9b34461b49d9";
+const SESSION = "d02fd1";
+function log(msg, data, hypothesisId) {
+    // #region agent log
+    fetch(LOG_URL, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "X-Debug-Session-Id": SESSION },
+        body: JSON.stringify({
+            sessionId: SESSION,
+            location: "debugBuildPlugin.ts",
+            message: msg,
+            data,
+            timestamp: Date.now(),
+            hypothesisId,
+        }),
+    }).catch(() => { });
+    // #endregion
+}
+export function createDebugBuildPlugin() {
+    return {
+        name: "typed:debug-build",
+        enforce: "pre",
+        config(config) {
+            // #region agent log
+            log("config() received", { hasBuild: !!config.build, hasRoot: !!config.root, base: config.base }, "H-counter-1");
+            // #endregion
+            return null;
+        },
+        configResolved(viteConfig) {
+            // #region agent log
+            log("configResolved", {
+                root: viteConfig.root,
+                base: viteConfig.base,
+                outDir: viteConfig.build?.outDir,
+                rollupInput: viteConfig.build?.rollupOptions?.input,
+                assetsDir: viteConfig.build?.assetsDir,
+            }, "H-counter-2");
+            // #endregion
+        },
+        resolveId(id, importer) {
+            if (id.includes("virtual-modules") || id.includes("@typed/virtual-modules")) {
+                // #region agent log
+                log("resolveId: virtual-modules requested", { id, importer: importer?.slice(-120) }, "H-realworld-1");
+                // #endregion
+            }
+            if (importer && importer.includes("node_modules/@typed/app") && !id.startsWith(".") && !id.startsWith("/")) {
+                // #region agent log
+                log("resolveId: from @typed/app", { id: id.slice(0, 80), importer: importer.slice(-100) }, "H-realworld-2");
+                // #endregion
+            }
+            return null;
+        },
+    };
+}

package/dist/index.d.ts

@@ -1,17 +1,6 @@
-/**
- * @typed/vite-plugin — One-stop Vite preset: tsconfig paths, bundle analyzer,
- * Brotli compression, virtual-modules Vite plugin, and @typed/app VM plugins.
- */
-import type { Plugin } from "vite";
+import { HttpApiVirtualModulePluginOptions, RouterVirtualModulePluginOptions } from "@typed/app";
 import type { CreateTypeInfoApiSession, VirtualModuleResolver } from "@typed/virtual-modules";
-/**
- * Options passed through to the HttpApi virtual-module plugin when enabled.
- * Forwarded to createHttpApiVirtualModulePlugin from the package that provides it
- * (e.g. @typed/app when the export is added). See httpapi-virtual-module-plugin spec.
- */
-export interface HttpApiVirtualModulePluginOptions {
-    readonly [key: string]: unknown;
-}
+import type { Plugin } from "vite";
 /** Options for vite-plugin-compression when compression is enabled. */
 export type TypedViteCompressionOptions = boolean | {
     readonly algorithm?: "gzip" | "brotliCompress" | "deflate" | "deflateRaw";
@@ -23,7 +12,7 @@ export interface TypedVitePluginOptions {
     /**
      * Options for the router VM plugin from @typed/app.
      */
-    readonly routerVmOptions?: import("@typed/app").RouterVirtualModulePluginOptions;
+    readonly routerVmOptions?: RouterVirtualModulePluginOptions;
     /**
      * Options for the HttpApi VM plugin from @typed/app. HttpApi VM plugin is always
      * registered (router first, then HttpApi). Use this to customize its behavior.
@@ -35,6 +24,12 @@ export interface TypedVitePluginOptions {
      * Override for custom session setup.
      */
     readonly createTypeInfoApiSession?: CreateTypeInfoApiSession;
+    /**
+     * Path to tsconfig.json (relative to cwd or absolute). When set, both the
+     * Language Service session and vite-tsconfig-paths use this tsconfig.
+     * Default: auto-discovered from project root.
+     */
+    readonly tsconfig?: string;
     /**
      * Enable tsconfig path resolution. Default true.
      */
@@ -70,9 +65,8 @@ export declare function createTypedViteResolver(options?: TypedVitePluginOptions
  * Returns Vite plugins: tsconfig paths, virtual modules (@typed/app), and optional bundle analyzer.
  * Use as: `defineConfig({ plugins: typedVitePlugin() })`.
  *
- * When createTypeInfoApiSession is not provided, the plugin automatically creates a
- * Language Service-backed session from the project's tsconfig. The type program evolves
- * as files change during dev. Pass createTypeInfoApiSession to override.
+ * When called with no arguments, auto-discovers `typed.config.ts` in the project root.
+ * When called with explicit options, those take full precedence (config file is not loaded).
  */
 export declare function typedVitePlugin(options?: TypedVitePluginOptions): Plugin[];
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAgB9F;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GACnC,OAAO,GACP;IACE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,YAAY,EAAE,gCAAgC,CAAC;IAEjF;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,iCAAiC,CAAC;IAE1D;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAE7D;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtF;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;CACpD;AAED,kFAAkF;AAClF,MAAM,WAAW,6BAA6B;IAC5C,gCAAgC,CAAC,EAAE,CACjC,IAAI,EAAE,iCAAiC,KACpC,OAAO,wBAAwB,EAAE,mBAAmB,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,sBAA2B,EACpC,YAAY,CAAC,EAAE,6BAA6B,GAC3C,qBAAqB,CASvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,EAAE,CAuE9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,iCAAiC,EAEjC,gCAAgC,EACjC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAW9F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GACnC,OAAO,GACP;IACE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,gCAAgC,CAAC;IAE5D;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,iCAAiC,CAAC;IAE1D;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAE7D;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtF;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;CACpD;AAED,kFAAkF;AAClF,MAAM,WAAW,6BAA6B;IAC5C,gCAAgC,CAAC,EAAE,CACjC,IAAI,EAAE,iCAAiC,KACpC,OAAO,wBAAwB,EAAE,mBAAmB,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,sBAA2B,EACpC,YAAY,CAAC,EAAE,6BAA6B,GAC3C,qBAAqB,CAQvB;AAgBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAgG1E"}

package/dist/index.js

@@ -1,43 +1,70 @@
+import { createHttpApiVirtualModulePlugin, createRouterVirtualModulePlugin, loadTypedConfig, } from "@typed/app";
 import { collectTypeTargetSpecsFromPlugins, createLanguageServiceSessionFactory, PluginManager, } from "@typed/virtual-modules";
-import { createHttpApiVirtualModulePlugin, createRouterVirtualModulePlugin, } from "@typed/app";
 import { virtualModulesVitePlugin } from "@typed/virtual-modules-vite";
-import ts from "typescript";
-import tsconfigPaths from "vite-tsconfig-paths";
+import { dirname, relative, resolve } from "node:path";
+import process from "node:process";
 import { visualizer } from "rollup-plugin-visualizer";
+import ts from "typescript";
 import viteCompression from "vite-plugin-compression";
+import tsconfigPaths from "vite-tsconfig-paths";
 /**
  * Invariant: ALL @typed/app VM plugins are always registered. There are no optional
  * or conditional app plugins. When adding a new VM plugin to @typed/app, add it here.
  */
 export function createTypedViteResolver(options = {}, dependencies) {
-    const httpApiFactory = dependencies?.createHttpApiVirtualModulePlugin ??
-        createHttpApiVirtualModulePlugin;
+    const httpApiFactory = dependencies?.createHttpApiVirtualModulePlugin ?? createHttpApiVirtualModulePlugin;
     const plugins = [
         createRouterVirtualModulePlugin(options.routerVmOptions ?? {}),
         httpApiFactory(options.apiVmOptions ?? {}),
     ];
     return new PluginManager(plugins);
 }
+function optionsFromTypedConfig(config) {
+    return {
+        routerVmOptions: config.router ? { prefix: config.router.prefix } : undefined,
+        apiVmOptions: config.api
+            ? { prefix: config.api.prefix, pathPrefix: config.api.pathPrefix }
+            : undefined,
+        tsconfig: config.tsconfig,
+        tsconfigPaths: config.tsconfigPaths,
+        analyze: config.analyze,
+        warnOnError: config.warnOnError,
+        compression: config.compression,
+    };
+}
 /**
  * Returns Vite plugins: tsconfig paths, virtual modules (@typed/app), and optional bundle analyzer.
  * Use as: `defineConfig({ plugins: typedVitePlugin() })`.
  *
- * When createTypeInfoApiSession is not provided, the plugin automatically creates a
- * Language Service-backed session from the project's tsconfig. The type program evolves
- * as files change during dev. Pass createTypeInfoApiSession to override.
+ * When called with no arguments, auto-discovers `typed.config.ts` in the project root.
+ * When called with explicit options, those take full precedence (config file is not loaded).
  */
-export function typedVitePlugin(options = {}) {
-    const resolver = createTypedViteResolver(options);
-    const analyze = options.analyze ?? (process.env.ANALYZE === "1" ? true : false);
-    let createTypeInfoApiSession = options.createTypeInfoApiSession;
+export function typedVitePlugin(options) {
+    const resolvedOptions = (() => {
+        if (options)
+            return options;
+        const result = loadTypedConfig({ projectRoot: process.cwd(), ts });
+        if (result.status === "loaded")
+            return optionsFromTypedConfig(result.config);
+        return {};
+    })();
+    const resolver = createTypedViteResolver(resolvedOptions);
+    const analyze = resolvedOptions.analyze ?? (process.env.ANALYZE === "1" ? true : false);
+    let createTypeInfoApiSession = resolvedOptions.createTypeInfoApiSession;
     if (createTypeInfoApiSession === undefined) {
         try {
             const manager = resolver;
             const typeTargetSpecs = collectTypeTargetSpecsFromPlugins(manager.plugins);
+            const cwd = process.cwd();
+            const tsconfigPath = resolvedOptions.tsconfig
+                ? resolve(cwd, resolvedOptions.tsconfig)
+                : undefined;
+            const projectRoot = tsconfigPath ? dirname(tsconfigPath) : cwd;
             createTypeInfoApiSession = createLanguageServiceSessionFactory({
                 ts,
-                projectRoot: process.cwd(),
+                projectRoot,
                 typeTargetSpecs,
+                tsconfigPath,
             });
         }
         catch {
@@ -45,14 +72,25 @@ export function typedVitePlugin(options = {}) {
         }
     }
     const plugins = [];
-    if (options.tsconfigPaths !== false) {
-        const pathsOpts = typeof options.tsconfigPaths === "object" ? options.tsconfigPaths : {};
+    if (resolvedOptions.tsconfigPaths !== false) {
+        const basePathsOpts = typeof resolvedOptions.tsconfigPaths === "object" ? resolvedOptions.tsconfigPaths : {};
+        const cwd = process.cwd();
+        const resolvedTsconfig = resolvedOptions.tsconfig
+            ? resolve(cwd, resolvedOptions.tsconfig)
+            : undefined;
+        const pathsOpts = resolvedTsconfig !== undefined
+            ? {
+                ...basePathsOpts,
+                root: cwd,
+                projects: [relative(cwd, resolvedTsconfig)],
+            }
+            : basePathsOpts;
         plugins.push(tsconfigPaths(pathsOpts));
     }
     plugins.push(virtualModulesVitePlugin({
         resolver,
         createTypeInfoApiSession,
-        warnOnError: options.warnOnError ?? true,
+        warnOnError: resolvedOptions.warnOnError ?? true,
     }));
     if (analyze) {
         const vizOpts = typeof analyze === "object"
@@ -64,7 +102,7 @@ export function typedVitePlugin(options = {}) {
             template: vizOpts.template ?? "treemap",
         }));
     }
-    const compression = options.compression ?? true;
+    const compression = resolvedOptions.compression ?? true;
     if (compression !== false) {
         const compressionOpts = typeof compression === "object"
             ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typed/vite-plugin",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "type": "module",
   "exports": {
     ".": {
@@ -11,23 +11,19 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "[ -d dist ] || rm -f tsconfig.tsbuildinfo; tsc",
-    "test": "vitest run --passWithNoTests"
-  },
   "dependencies": {
-    "@typed/app": "workspace:*",
-    "@typed/virtual-modules": "workspace:*",
-    "@typed/virtual-modules-vite": "workspace:*",
     "rollup-plugin-visualizer": "^5.12.0",
     "vite-plugin-compression": "^0.5.1",
-    "vite-tsconfig-paths": "^6.1.0"
+    "vite-tsconfig-paths": "^6.1.0",
+    "@typed/app": "1.0.0-beta.2",
+    "@typed/virtual-modules-vite": "1.0.0-beta.2",
+    "@typed/virtual-modules": "1.0.0-beta.2"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",
-    "typescript": "catalog:",
+    "typescript": "5.9.3",
     "vite": "^7.3.1",
-    "vitest": "catalog:"
+    "vitest": "4.0.18"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0",
@@ -36,5 +32,9 @@
   "files": [
     "dist",
     "src"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "[ -d dist ] || rm -f tsconfig.tsbuildinfo; tsc",
+    "test": "vitest run --passWithNoTests"
+  }
+}

package/src/index.ts

@@ -2,31 +2,28 @@
  * @typed/vite-plugin — One-stop Vite preset: tsconfig paths, bundle analyzer,
  * Brotli compression, virtual-modules Vite plugin, and @typed/app VM plugins.
  */
-import type { Plugin } from "vite";
+import type { TypedConfig } from "@typed/app";
+import {
+  createHttpApiVirtualModulePlugin,
+  createRouterVirtualModulePlugin,
+  HttpApiVirtualModulePluginOptions,
+  loadTypedConfig,
+  RouterVirtualModulePluginOptions,
+} from "@typed/app";
 import type { CreateTypeInfoApiSession, VirtualModuleResolver } from "@typed/virtual-modules";
 import {
   collectTypeTargetSpecsFromPlugins,
   createLanguageServiceSessionFactory,
   PluginManager,
 } from "@typed/virtual-modules";
-import {
-  createHttpApiVirtualModulePlugin,
-  createRouterVirtualModulePlugin,
-} from "@typed/app";
 import { virtualModulesVitePlugin } from "@typed/virtual-modules-vite";
-import ts from "typescript";
-import tsconfigPaths from "vite-tsconfig-paths";
+import { dirname, relative, resolve } from "node:path";
+import process from "node:process";
 import { visualizer } from "rollup-plugin-visualizer";
+import ts from "typescript";
+import type { Plugin } from "vite";
 import viteCompression from "vite-plugin-compression";
-
-/**
- * Options passed through to the HttpApi virtual-module plugin when enabled.
- * Forwarded to createHttpApiVirtualModulePlugin from the package that provides it
- * (e.g. @typed/app when the export is added). See httpapi-virtual-module-plugin spec.
- */
-export interface HttpApiVirtualModulePluginOptions {
-  readonly [key: string]: unknown;
-}
+import tsconfigPaths from "vite-tsconfig-paths";
 
 /** Options for vite-plugin-compression when compression is enabled. */
 export type TypedViteCompressionOptions =
@@ -42,7 +39,7 @@ export interface TypedVitePluginOptions {
   /**
    * Options for the router VM plugin from @typed/app.
    */
-  readonly routerVmOptions?: import("@typed/app").RouterVirtualModulePluginOptions;
+  readonly routerVmOptions?: RouterVirtualModulePluginOptions;
 
   /**
    * Options for the HttpApi VM plugin from @typed/app. HttpApi VM plugin is always
@@ -57,6 +54,13 @@ export interface TypedVitePluginOptions {
    */
   readonly createTypeInfoApiSession?: CreateTypeInfoApiSession;
 
+  /**
+   * Path to tsconfig.json (relative to cwd or absolute). When set, both the
+   * Language Service session and vite-tsconfig-paths use this tsconfig.
+   * Default: auto-discovered from project root.
+   */
+  readonly tsconfig?: string;
+
   /**
    * Enable tsconfig path resolution. Default true.
    */
@@ -95,8 +99,7 @@ export function createTypedViteResolver(
   dependencies?: TypedViteResolverDependencies,
 ): VirtualModuleResolver {
   const httpApiFactory =
-    dependencies?.createHttpApiVirtualModulePlugin ??
-    createHttpApiVirtualModulePlugin;
+    dependencies?.createHttpApiVirtualModulePlugin ?? createHttpApiVirtualModulePlugin;
   const plugins: import("@typed/virtual-modules").VirtualModulePlugin[] = [
     createRouterVirtualModulePlugin(options.routerVmOptions ?? {}),
     httpApiFactory(options.apiVmOptions ?? {}),
@@ -104,30 +107,55 @@ export function createTypedViteResolver(
   return new PluginManager(plugins);
 }
 
+function optionsFromTypedConfig(config: TypedConfig): TypedVitePluginOptions {
+  return {
+    routerVmOptions: config.router ? { prefix: config.router.prefix } : undefined,
+    apiVmOptions: config.api
+      ? { prefix: config.api.prefix, pathPrefix: config.api.pathPrefix }
+      : undefined,
+    tsconfig: config.tsconfig,
+    tsconfigPaths: config.tsconfigPaths,
+    analyze: config.analyze,
+    warnOnError: config.warnOnError,
+    compression: config.compression,
+  };
+}
+
 /**
  * Returns Vite plugins: tsconfig paths, virtual modules (@typed/app), and optional bundle analyzer.
  * Use as: `defineConfig({ plugins: typedVitePlugin() })`.
  *
- * When createTypeInfoApiSession is not provided, the plugin automatically creates a
- * Language Service-backed session from the project's tsconfig. The type program evolves
- * as files change during dev. Pass createTypeInfoApiSession to override.
+ * When called with no arguments, auto-discovers `typed.config.ts` in the project root.
+ * When called with explicit options, those take full precedence (config file is not loaded).
  */
-export function typedVitePlugin(options: TypedVitePluginOptions = {}): Plugin[] {
-  const resolver = createTypedViteResolver(options);
-  const analyze =
-    options.analyze ?? (process.env.ANALYZE === "1" ? true : false);
+export function typedVitePlugin(options?: TypedVitePluginOptions): Plugin[] {
+  const resolvedOptions: TypedVitePluginOptions = (() => {
+    if (options) return options;
+    const result = loadTypedConfig({ projectRoot: process.cwd(), ts });
+    if (result.status === "loaded") return optionsFromTypedConfig(result.config);
+    return {};
+  })();
+
+  const resolver = createTypedViteResolver(resolvedOptions);
+  const analyze = resolvedOptions.analyze ?? (process.env.ANALYZE === "1" ? true : false);
 
   let createTypeInfoApiSession: CreateTypeInfoApiSession | undefined =
-    options.createTypeInfoApiSession;
+    resolvedOptions.createTypeInfoApiSession;
 
   if (createTypeInfoApiSession === undefined) {
     try {
       const manager = resolver as PluginManager;
       const typeTargetSpecs = collectTypeTargetSpecsFromPlugins(manager.plugins);
+      const cwd = process.cwd();
+      const tsconfigPath = resolvedOptions.tsconfig
+        ? resolve(cwd, resolvedOptions.tsconfig)
+        : undefined;
+      const projectRoot = tsconfigPath ? dirname(tsconfigPath) : cwd;
       createTypeInfoApiSession = createLanguageServiceSessionFactory({
         ts,
-        projectRoot: process.cwd(),
+        projectRoot,
         typeTargetSpecs,
+        tsconfigPath,
       });
     } catch {
       // Graceful degradation: no session, plugins get noop TypeInfoApi
@@ -136,9 +164,21 @@ export function typedVitePlugin(options: TypedVitePluginOptions = {}): Plugin[]
 
   const plugins: Plugin[] = [];
 
-  if (options.tsconfigPaths !== false) {
+  if (resolvedOptions.tsconfigPaths !== false) {
+    const basePathsOpts =
+      typeof resolvedOptions.tsconfigPaths === "object" ? resolvedOptions.tsconfigPaths : {};
+    const cwd = process.cwd();
+    const resolvedTsconfig = resolvedOptions.tsconfig
+      ? resolve(cwd, resolvedOptions.tsconfig)
+      : undefined;
     const pathsOpts =
-      typeof options.tsconfigPaths === "object" ? options.tsconfigPaths : {};
+      resolvedTsconfig !== undefined
+        ? {
+            ...basePathsOpts,
+            root: cwd,
+            projects: [relative(cwd, resolvedTsconfig)],
+          }
+        : basePathsOpts;
     plugins.push(tsconfigPaths(pathsOpts) as Plugin);
   }
 
@@ -146,7 +186,7 @@ export function typedVitePlugin(options: TypedVitePluginOptions = {}): Plugin[]
     virtualModulesVitePlugin({
       resolver,
       createTypeInfoApiSession,
-      warnOnError: options.warnOnError ?? true,
+      warnOnError: resolvedOptions.warnOnError ?? true,
     }),
   );
 
@@ -159,12 +199,13 @@ export function typedVitePlugin(options: TypedVitePluginOptions = {}): Plugin[]
       visualizer({
         filename: vizOpts.filename ?? "dist/stats.html",
         open: vizOpts.open ?? false,
-        template: (vizOpts.template as "treemap" | "sunburst" | "flamegraph" | "network") ?? "treemap",
+        template:
+          (vizOpts.template as "treemap" | "sunburst" | "flamegraph" | "network") ?? "treemap",
       }) as Plugin,
     );
   }
 
-  const compression = options.compression ?? true;
+  const compression = resolvedOptions.compression ?? true;
   if (compression !== false) {
     const compressionOpts =
       typeof compression === "object"