@kosmojs/lib 0.4.3 → 0.5.0

package/pkg/vite.d.ts

@@ -1,5 +1,5 @@
 import type { Plugin } from "vite";
-import { type SourceFolder } from "@kosmojs/core";
+import { type ProjectSettings, type SourceFolder } from "@kosmojs/core";
 /**
  * Resolves Kosmo's generated import prefixes to absolute file paths.
  *
@@ -54,8 +54,27 @@ import { type SourceFolder } from "@kosmojs/core";
  * */
 export declare const tsconfigPaths: (sourceFolder: SourceFolder) => Plugin;
 declare const nodePrefix: () => Plugin;
+/**
+ * Resolves the CSR/SSR variant of env-sensitive modules.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * A handful of generated modules must differ between the client graph and the SSR bundle -
+ * the fetch transport (a no-op in the browser, an in-process dispatch on the server)
+ * and the TanStack Query client (a singleton in the browser, per-request on the server).
+ *
+ * Every build installs this plugin; but only the SSR bundle installs it with `kind: "ssr"`.
+ * Nothing is written, so concurrent processes cannot disturb each other.
+ *
+ * Generators declare their modules via `factory.virtualModules()`.
+ * */
+export declare const virtualModules: (sourceFolder: SourceFolder, { kind, command, }: {
+    kind: "csr" | "ssr";
+    command: ProjectSettings["command"];
+}) => Plugin;
 export declare const vitePlugins: {
     tsconfigPaths: typeof tsconfigPaths;
     nodePrefix: typeof nodePrefix;
+    virtualModules: typeof virtualModules;
 };
 export {};