Virtual Modules
PluginVirtualModulesAPI — declara módulos virtuales que Vite resuelve en runtime sin tocar el sistema de archivos.
ctx.virtualModules — PluginVirtualModulesAPI
Declara módulos virtuales que Vite resuelve y carga sin tocar el
sistema de archivos. Cada plugin llama a add() desde beforeBuild
o beforeDev.
ctx.virtualModules.add(
'virtual:mi-plugin/theme.css',
() => `:root { --primary: #6366f1; }`,
)
ctx.virtualModules.has('virtual:mi-plugin/theme.css')
// → boolean
const todos: readonly RegisteredVirtualModule[] = ctx.virtualModules.list()
Reglas de registro
| Regla | Detalle |
|---|---|
| Ids duplicados lanzan error | Dos plugins no pueden registrar el mismo id virtual. Prefija con el nombre de tu plugin. |
Prefijo virtual:boltdocs- reservado | Los virtuales del core (routes, config, search, etc.) mantienen el namespace virtual:boltdocs-. |
Flag eager | Se acepta en registro pero no se consulta en carga — reservado para futura auto-inyección. |
Ver también
- PluginContext — objeto de contexto base
- HMR — observación de archivos y eventos personalizados del dev server
Last updated on July 27, 2026