@tanstack/start-plugin-core 1.169.11 → 1.169.13

package/dist/esm/schema.d.ts

@@ -20,11 +20,11 @@ declare const importProtectionOptionsSchema: z.ZodOptional<z.ZodObject<{
         dev: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
         build: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
     }, "strip", z.ZodTypeAny, {
-        build?: "error" | "mock" | undefined;
         dev?: "error" | "mock" | undefined;
-    }, {
         build?: "error" | "mock" | undefined;
+    }, {
         dev?: "error" | "mock" | undefined;
+        build?: "error" | "mock" | undefined;
     }>]>>;
     /**
      * In `behavior: 'mock'`, control whether mocked imports emit a runtime
@@ -81,8 +81,8 @@ declare const importProtectionOptionsSchema: z.ZodOptional<z.ZodObject<{
     exclude?: (string | RegExp)[] | undefined;
     enabled?: boolean | undefined;
     behavior?: "error" | "mock" | {
-        build?: "error" | "mock" | undefined;
         dev?: "error" | "mock" | undefined;
+        build?: "error" | "mock" | undefined;
     } | undefined;
     mockAccess?: "error" | "warn" | "off" | undefined;
     onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -104,8 +104,8 @@ declare const importProtectionOptionsSchema: z.ZodOptional<z.ZodObject<{
     exclude?: (string | RegExp)[] | undefined;
     enabled?: boolean | undefined;
     behavior?: "error" | "mock" | {
-        build?: "error" | "mock" | undefined;
         dev?: "error" | "mock" | undefined;
+        build?: "error" | "mock" | undefined;
     } | undefined;
     mockAccess?: "error" | "warn" | "off" | undefined;
     onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -177,6 +177,12 @@ export declare function parseStartConfig(opts: z.input<typeof tanstackStartOptio
         };
         entry?: string | undefined;
     };
+    dev: {
+        ssrStyles: {
+            enabled: boolean;
+            basepath?: string | undefined;
+        };
+    };
     srcDirectory: string;
     start: {
         entry?: string | undefined;
@@ -254,12 +260,6 @@ export declare function parseStartConfig(opts: z.input<typeof tanstackStartOptio
             headers?: Record<string, string> | undefined;
         } | undefined;
     }[];
-    dev: {
-        ssrStyles: {
-            enabled: boolean;
-            basepath?: string | undefined;
-        };
-    };
     sitemap?: {
         enabled: boolean;
         outputPath: string;
@@ -433,8 +433,8 @@ export declare function parseStartConfig(opts: z.input<typeof tanstackStartOptio
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -1212,11 +1212,11 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         };
         entry?: string | undefined;
     }, {
-        entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
             inlineCss?: boolean | undefined;
         } | undefined;
+        entry?: string | undefined;
     }>>>;
     serverFns: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         base: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -3282,11 +3282,11 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
             dev: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
             build: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
         }, "strip", z.ZodTypeAny, {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
-        }, {
             build?: "error" | "mock" | undefined;
+        }, {
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         }>]>>;
         /**
          * In `behavior: 'mock'`, control whether mocked imports emit a runtime
@@ -3343,8 +3343,8 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -3366,8 +3366,8 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -3388,6 +3388,12 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         };
         entry?: string | undefined;
     };
+    dev: {
+        ssrStyles: {
+            enabled: boolean;
+            basepath?: string | undefined;
+        };
+    };
     srcDirectory: string;
     start: {
         entry?: string | undefined;
@@ -3513,12 +3519,6 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
             headers?: Record<string, string> | undefined;
         } | undefined;
     }[];
-    dev: {
-        ssrStyles: {
-            enabled: boolean;
-            basepath?: string | undefined;
-        };
-    };
     sitemap?: {
         enabled: boolean;
         outputPath: string;
@@ -3692,8 +3692,8 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -3708,11 +3708,17 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         base?: string | undefined;
     } | undefined;
     server?: {
-        entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
             inlineCss?: boolean | undefined;
         } | undefined;
+        entry?: string | undefined;
+    } | undefined;
+    dev?: {
+        ssrStyles?: {
+            basepath?: string | undefined;
+            enabled?: boolean | undefined;
+        } | undefined;
     } | undefined;
     srcDirectory?: string | undefined;
     start?: {
@@ -3955,12 +3961,6 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
             headers?: Record<string, string> | undefined;
         } | undefined;
     }[] | undefined;
-    dev?: {
-        ssrStyles?: {
-            basepath?: string | undefined;
-            enabled?: boolean | undefined;
-        } | undefined;
-    } | undefined;
     spa?: {
         enabled?: boolean | undefined;
         prerender?: {
@@ -4018,8 +4018,8 @@ export declare const tanstackStartOptionsObjectSchema: z.ZodObject<{
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -4258,11 +4258,11 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         };
         entry?: string | undefined;
     }, {
-        entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
             inlineCss?: boolean | undefined;
         } | undefined;
+        entry?: string | undefined;
     }>>>;
     serverFns: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         base: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -6328,11 +6328,11 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
             dev: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
             build: z.ZodOptional<z.ZodEnum<["error", "mock"]>>;
         }, "strip", z.ZodTypeAny, {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
-        }, {
             build?: "error" | "mock" | undefined;
+        }, {
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         }>]>>;
         /**
          * In `behavior: 'mock'`, control whether mocked imports emit a runtime
@@ -6389,8 +6389,8 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -6412,8 +6412,8 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -6434,6 +6434,12 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         };
         entry?: string | undefined;
     };
+    dev: {
+        ssrStyles: {
+            enabled: boolean;
+            basepath?: string | undefined;
+        };
+    };
     srcDirectory: string;
     start: {
         entry?: string | undefined;
@@ -6559,12 +6565,6 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
             headers?: Record<string, string> | undefined;
         } | undefined;
     }[];
-    dev: {
-        ssrStyles: {
-            enabled: boolean;
-            basepath?: string | undefined;
-        };
-    };
     sitemap?: {
         enabled: boolean;
         outputPath: string;
@@ -6738,8 +6738,8 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;
@@ -6754,11 +6754,17 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         base?: string | undefined;
     } | undefined;
     server?: {
-        entry?: string | undefined;
         build?: {
             staticNodeEnv?: boolean | undefined;
             inlineCss?: boolean | undefined;
         } | undefined;
+        entry?: string | undefined;
+    } | undefined;
+    dev?: {
+        ssrStyles?: {
+            basepath?: string | undefined;
+            enabled?: boolean | undefined;
+        } | undefined;
     } | undefined;
     srcDirectory?: string | undefined;
     start?: {
@@ -7001,12 +7007,6 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
             headers?: Record<string, string> | undefined;
         } | undefined;
     }[] | undefined;
-    dev?: {
-        ssrStyles?: {
-            basepath?: string | undefined;
-            enabled?: boolean | undefined;
-        } | undefined;
-    } | undefined;
     spa?: {
         enabled?: boolean | undefined;
         prerender?: {
@@ -7064,8 +7064,8 @@ export declare const tanstackStartOptionsSchema: z.ZodDefault<z.ZodOptional<z.Zo
         exclude?: (string | RegExp)[] | undefined;
         enabled?: boolean | undefined;
         behavior?: "error" | "mock" | {
-            build?: "error" | "mock" | undefined;
             dev?: "error" | "mock" | undefined;
+            build?: "error" | "mock" | undefined;
         } | undefined;
         mockAccess?: "error" | "warn" | "off" | undefined;
         onViolation?: ((args_0: any, ...args: unknown[]) => boolean | void | Promise<boolean | void>) | undefined;

package/dist/esm/start-compiler/compiler.d.ts

@@ -1,5 +1,5 @@
 import { DevServerFnModuleSpecifierEncoder, ServerFn } from './types.js';
-import { CompileStartFrameworkOptions } from '../types.js';
+import { CompileStartFrameworkOptions, StartCompilerEnvironment, StartCompilerImportTransform } from '../types.js';
 import * as t from '@babel/types';
 type Binding = {
     type: 'import';
@@ -12,14 +12,23 @@ type Binding = {
     resolvedKind?: Kind;
 };
 type Kind = 'None' | `Root` | `Builder` | LookupKind;
-export type LookupKind = 'ServerFn' | 'Middleware' | 'IsomorphicFn' | 'ServerOnlyFn' | 'ClientOnlyFn' | 'ClientOnlyJSX';
-export declare const KindDetectionPatterns: Record<LookupKind, RegExp>;
-export declare const LookupKindsPerEnv: Record<'client' | 'server', Set<LookupKind>>;
+export type BuiltInLookupKind = 'ServerFn' | 'Middleware' | 'IsomorphicFn' | 'ServerOnlyFn' | 'ClientOnlyFn' | 'ClientOnlyJSX';
+export type ExternalLookupKind = `External:${string}`;
+export type LookupKind = BuiltInLookupKind | ExternalLookupKind;
+export declare function getExternalLookupKind(transform: StartCompilerImportTransform): ExternalLookupKind;
+export declare function isCompilerTransformEnabledForEnv(transform: StartCompilerImportTransform, env: StartCompilerEnvironment): boolean;
+export declare const KindDetectionPatterns: Record<BuiltInLookupKind, RegExp>;
+export declare const LookupKindsPerEnv: Record<'client' | 'server', Set<BuiltInLookupKind>>;
+export declare function getLookupKindsForEnv(env: 'client' | 'server', opts?: {
+    compilerTransforms?: Array<StartCompilerImportTransform> | undefined;
+}): Set<LookupKind>;
 /**
  * Detects which LookupKinds are present in the code using string matching.
  * This is a fast pre-scan before AST parsing to limit the work done during compilation.
  */
-export declare function detectKindsInCode(code: string, env: 'client' | 'server'): Set<LookupKind>;
+export declare function detectKindsInCode(code: string, env: 'client' | 'server', opts?: {
+    compilerTransforms?: Array<StartCompilerImportTransform> | undefined;
+}): Set<LookupKind>;
 export type LookupConfig = {
     libName: string;
     rootExport: string;
@@ -36,6 +45,9 @@ export declare class StartCompiler {
     private moduleCache;
     private initialized;
     private validLookupKinds;
+    private externalTransformsByKind;
+    private externalLookupSetup;
+    private externalDirectCallKindsBySource;
     private resolveIdCache;
     private exportResolutionCache;
     private knownRootImports;
@@ -74,6 +86,8 @@ export declare class StartCompiler {
          * Called after each file is compiled with its new functions.
          */
         onServerFnsById?: (d: Record<string, ServerFn>) => void;
+        compilerTransforms?: Array<StartCompilerImportTransform> | undefined;
+        serverFnProviderModuleDirectives?: ReadonlyArray<string> | undefined;
         /**
          * Returns the currently known server functions from previous builds.
          * Used by server callers to look up canonical extracted filenames.
@@ -88,6 +102,7 @@ export declare class StartCompiler {
      */
     private generateFunctionId;
     private get mode();
+    private getExternalDirectCallCandidates;
     private resolveIdCached;
     private getExportResolutionCache;
     private init;
@@ -110,6 +125,7 @@ export declare class StartCompiler {
         /** Pre-detected kinds present in this file. If not provided, all valid kinds are checked. */
         detectedKinds?: Set<LookupKind>;
     }): Promise<import('@tanstack/router-utils').GeneratorResult | null>;
+    private runExternalTransforms;
     private resolveIdentifierKind;
     /**
      * Recursively find an export in a module, following `export * from` chains.