feat(rsc): add import(.., { environment: ... })

Author: hi-ogawa

packages/plugin-rsc/README.md

@@ -245,6 +245,18 @@ ssrModule.renderHTML(...);
 export function renderHTML(...) {}
 ```
 
+#### `import.meta.viteRsc.import(..., { environment: ... })`
+
+TODO
+
+```ts
+const ssrModule = await import.meta.viteRsc.import(
+  "./entry.ssr.tsx",
+  { with: { environment: "ssr" } }
+)
+ssrModule.renderHTML(...);
+```
+
 ### Available on `rsc` environment
 
 #### `import.meta.viteRsc.loadCss`

packages/plugin-rsc/examples/basic/src/framework/entry.rsc.tsx

@@ -91,6 +91,16 @@ async function handleRequest({
     })
   }
 
+  // TODO: implement this
+  import.meta.viteRsc.import<typeof import('./entry.ssr.tsx')>('./entry.ssr', {
+    environment: 'ssr',
+  })
+  // import.meta.viteRsc.importEnvironment(import("./entry.ssr.tsx"));
+  // import.meta.viteRsc.importAsset(import("./entry.browser.tsx"));
+  // import(String("test"), { with: { viteRsc: "environment:ssr" } });
+  // import(String("test"), { with: { viteRsc: "asset:client" } });
+  // import("./entry.ssr.tsx", { with: { viteRscEnvironment: "rsc" } });
+
   // Delegate to SSR environment for html rendering.
   // The plugin provides `loadModule` helper to allow loading SSR environment entry module
   // in RSC environment. however this can be customized by implementing own runtime communication

packages/plugin-rsc/types/index.d.ts

@@ -4,6 +4,12 @@ declare global {
       loadCss: (importer?: string) => import('react').ReactNode
       loadModule: <T>(environmentName: string, entryName?: string) => Promise<T>
       loadBootstrapScriptContent: (entryName: string) => Promise<string>
+
+      // TODO: loadModule alternative
+      import: <T>(specifier, attributes: { environment: string }) => Promise<T>
+
+      // TODO: loadBootstrapScriptContent alternative?
+      // import: (specifier, attributes: { asset: string }) => Promise<string>
     }
   }