feat(rsc): add import.meta.viteRsc.import API

[hi-ogawa]

Summary

Add import.meta.viteRsc.import() - a more ergonomic API for cross-environment module loading.

import.meta.viteRsc.import: <T>(
  specifier: string,
  options: { environment: "ssr" | "rsc" },
) => Promise<T>

Comparison

Before (loadModule):

// vite.config.ts - must configure entry manually
export default {
  environments: {
    ssr: {
      build: {
        rollupOptions: {
          input: { index: './entry.ssr.tsx' }
        }
      }
    }
  }
}

// entry.rsc.tsx
const ssrModule = await import.meta.viteRsc.loadModule<typeof import('./entry.ssr')>(
  'ssr',
  'index'
);

After (import):

// vite.config.ts - no explicit `rollupOptions.input` needed

// entry.rsc.tsx
const ssrModule = await import.meta.viteRsc.import<typeof import('./entry.ssr')>(
  './entry.ssr',
  { environment: 'ssr' }
);

How it works

• Dev: Uses __VITE_ENVIRONMENT_RUNNER_IMPORT__ (same as loadModule)
• Build: Auto-discovers imports, emits entries, generates manifest (__vite_rsc_env_imports_manifest.js)

Documentation

• README.md - API documentation with comparison
• types/index.d.ts - TypeScript types with JSDoc

Test plan

• Implement transform plugin
• Test build mode with starter example
• Verify entry auto-discovery works
• Test dev mode

🤖 Generated with Claude Code