ctx.paths — PluginPathsAPI

Helpers de resolución de rutas que validan que cada resultado permanezca dentro del workspace. Tanto resolveDocs como resolveAsset rechazan rutas que escapen del directorio base.

const mdxFile = ctx.paths.resolveDocs('guias', 'primeros-pasos', 'instalacion.mdx')
const image = ctx.paths.resolveAsset('public', 'logo.webp')
const fileUrl = ctx.paths.safeFileURL('/ruta/absoluta/diagrama.svg')

Lanzan un Error cuando la ruta resuelta queda fuera del workspace:

// Lanza: Path '../../etc/passwd' resolves to '/etc/passwd' which is
// outside the workspace boundary...
ctx.paths.resolveDocs('../../etc/passwd')

Ver también

• PluginContext — objeto de contexto base
• Virtual Modules — declaraciones de módulos virtuales en runtime
• Middleware — pipeline de middleware de transformación

Jesús Alcalá

Last updated on October 18, 2026