Boltdocs 2.9.0 — DUI, Feedback, Math y mucho pulido
·Jesús Alcalá
2.9.0 lanza el toolkit DUI como paquete independiente, soporte nativo de feedback, un plugin de matemáticas con KaTeX, el hook de ciclo de vida transformSource, banderas CLI para desarrollo, una larga lista de correcciones de bugs y un optimizador de imágenes completamente nuevo.
2.8.0 fue sobre escala — división de código, presupuestos, tipos estrictos. 2.9.0 es sobre tomar las piezas que construí y llevarlas más lejos al mundo.
Note
DUI ahora es su propio paquete, el feedback funciona out of the box, las matemáticas se ven hermosas con KaTeX, la API de plugins tiene un nuevo hook transformSource, el desarrollo tiene banderas CLI y finalmente corregí ese flash de tema que me ha estado molestando durante meses.
Construí @bdocs/dui como un toolkit interno para el CLI de Boltdocs — salida con colores, spinners, tablas, barras de progreso, lo típico de UI de terminal. Pero cuanto más lo usaba, más pensaba: ¿por qué quedarme solo con esto?
Así que lo separé en su propio repositorio — bolt-docs/dui — con una API adecuada, documentación y un playground en vivo en dui-terms.vercel.app. Cualquiera puede usarlo ahora, no solo Boltdocs. Mejor superficie de API, mejores tipos, mejor todo.
Y sí — sigue siendo la biblioteca de UI de terminal más rápida que existe. Boltdocs simplemente tiende a hacer todo más rápido.
Quería una forma para que los lectores me digan cuando algo está mal — o cuando está bien. Así que construí un sistema de feedback directamente en Boltdocs.
Agrega la configuración y cada página obtiene un widget de pulgar arriba/abajo. Funciona en dos modos:
Desarrollo/Vista previa: un middleware de Vite intercepta las solicitudes POST a /api/feedback — cero configuración
Producción: despliega una función serverless usando la exportación handleFeedbackRequest (o Netlify, Cloudflare, AWS, Vercel)
El hook useFeedback te da rating, comment, submit y todo el manejo de estado. Los bloques de código pueden tener su propio feedback por fragmento — revisa showCodeBlockFeedback en el hook useCodeBlock.
He querido esto por un tiempo. @bdocs/plugin-math te permite escribir LaTeX en tu MDX usando los delimitadores familiares $...$ y $...$:
Cuando $a \ne 0$, hay dos soluciones para $ax^2 + bx + c = 0$ y son$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $
Internamente usa un hook transformSource para convertir esos delimitadores en componentes <Math> y <BlockMath> antes de que el parser MDX los vea. KaTeX maneja el renderizado del lado del cliente — CSS cargado desde CDN, cero configuración requerida.
Instálalo con pnpm add @bdocs/plugin-math, agrega mathPlugin() a los plugins de tu configuración y listo. Lee la documentación de plugin-math para más detalles.
Hablando de transformSource — ahora es un hook de ciclo de vida de primera clase en la API de plugins. Se ejecuta en la fuente MDX en bruto antes de la compilación, para que puedas transformar patrones de texto, inyectar contenido o preprocesar sintaxis antes de que el parser MDX lo toque.
Múltiples plugins pueden registrar cada uno un hook transformSource y se encadenan — la salida de cada uno alimenta al siguiente. El plugin de matemáticas fue el primer caso de uso real, pero veo mucho potencial aquí para extensiones de sintaxis personalizadas, plantillas o preprocesamiento.
Este lanzamiento tuvo una ronda sólida de correcciones para cosas que me han estado molestando:
Flash de tema en la navegación — el cambio de modo oscuro/claro ya no parpadea al navegar entre páginas
collapsible: true / collapsed: false en meta_loaders — estas opciones de configuración de la barra lateral estaban siendo ignoradas. Ahora funcionan como se espera
Rutas planas de page-nav — el componente de navegación de página ahora aplan correctamente las rutas anidadas
Sincronización i18n — se corrigió una condición de carrera donde cambiar de idioma podía dejar algunos elementos de UI sin traducir
Mejoras en la API de code-block — el hook useCodeBlock obtuvo mejor tipado, resolución de LangIcon y la API del componente pre personalizado es más predecible
Un nuevo paquete interno: @bdocs/plugin-image-optimizer. Es un fork de vite-plugin-image-optimizer — pero lo optimicé para Boltdocs.
Qué es diferente:
Caché persistente — las imágenes no se re-optimizan en cada construcción. La caché se indexa por hash de contenido y sobrevive reinicios
Procesamiento paralelo — los hilos de trabajo usan todos los núcleos disponibles (menos uno) con transferencia de buffer zero-copy
Integración de escala — funciona con el sistema AssetCache de Boltdocs y respeta la estructura de directorio .boltdocs/cache/
Salida de estadísticas — una tabla impulsada por DUI muestra cuánto ahorró cada formato
Maneja PNG, JPEG, WebP, AVIF, GIF, TIFF y SVG (a través de Sharp + SVGO). La sección de plugins del sitio de documentación oficial tendrá una página pronto — por ahora, revisa el README del paquete.
Pasé tiempo actualizando la documentación oficial en todos los frentes — la página del sistema de plugins, la referencia del CLI, las guías de componentes y la documentación de integraciones todas se limpiaron. Las páginas de feedback y matemáticas son completamente nuevas, y la guía de code-blocks es mucho más completa.
y `$...$`:\\n\\n```mdx\\nCuando $a \\\\ne 0$, hay dos soluciones para $ax^2 + bx + c = 0$ y son\\n\\n$ x = {-b \\\\pm \\\\sqrt{b^2-4ac} \\\\over 2a} $\\n```\\n\\nInternamente usa un hook `transformSource` para convertir esos delimitadores en componentes `\u003cMath\u003e` y `\u003cBlockMath\u003e` antes de que el parser MDX los vea. KaTeX maneja el renderizado del lado del cliente — CSS cargado desde CDN, cero configuración requerida.\\n\\nInstálalo con `pnpm add @bdocs/plugin-math`, agrega `mathPlugin()` a los plugins de tu configuración y listo. Lee la [documentación de plugin-math](/docs/plugins/plugin-math) para más detalles.\\n\\n---\\n\\n## `transformSource` — Un nuevo hook de plugins\\n\\nHablando de `transformSource` — ahora es un hook de ciclo de vida de primera clase en la API de plugins. Se ejecuta en la fuente MDX en bruto **antes** de la compilación, para que puedas transformar patrones de texto, inyectar contenido o preprocesar sintaxis antes de que el parser MDX lo toque.\\n\\nMúltiples plugins pueden registrar cada uno un hook `transformSource` y se encadenan — la salida de cada uno alimenta al siguiente. El plugin de matemáticas fue el primer caso de uso real, pero veo mucho potencial aquí para extensiones de sintaxis personalizadas, plantillas o preprocesamiento.\\n\\nRevisa la [documentación de plugins](/docs/plugins) para la firma completa del hook.\\n\\n---\\n\\n## Banderas de desarrollo: `--port`, `--host`, `--force`\\n\\nTres banderas que finalmente agregué a `boltdocs dev`:\\n\\n- **`--port \u003cnumber\u003e`** — puerto del servidor de desarrollo (por defecto 5173)\\n- **`--host [address]** — vincular a una dirección específica, o `--host` sin argumentos para exponer a tu red local\\n- **`--force`** — forzar la re-optimización de dependencias de Vite\\n\\nNada fancy — solo banderas que escribía manualmente y me cansé de hacerlo. Documentación completa en la [página de CLI](/docs/api/cli).\\n\\n---\\n\\n## Corrección de bugs y pulido\\n\\nEste lanzamiento tuvo una ronda sólida de correcciones para cosas que me han estado molestando:\\n\\n- **Flash de tema en la navegación** — el cambio de modo oscuro/claro ya no parpadea al navegar entre páginas\\n- **`collapsible: true` / `collapsed: false` en meta_loaders** — estas opciones de configuración de la barra lateral estaban siendo ignoradas. Ahora funcionan como se espera\\n- **Rutas planas de page-nav** — el componente de navegación de página ahora aplan correctamente las rutas anidadas\\n- **Sincronización i18n** — se corrigió una condición de carrera donde cambiar de idioma podía dejar algunos elementos de UI sin traducir\\n- **Mejoras en la API de code-block** — el hook `useCodeBlock` obtuvo mejor tipado, resolución de `LangIcon` y la API del componente `pre` personalizado es más predecible\\n\\n---\\n\\n## Plugin-Image-Optimizer\\n\\nUn nuevo paquete interno: `@bdocs/plugin-image-optimizer`. Es un fork de [vite-plugin-image-optimizer](https://github.com/FatehAK/vite-plugin-image-optimizer/) — pero lo optimicé para Boltdocs.\\n\\nQué es diferente:\\n- **Caché persistente** — las imágenes no se re-optimizan en cada construcción. La caché se indexa por hash de contenido y sobrevive reinicios\\n- **Procesamiento paralelo** — los hilos de trabajo usan todos los núcleos disponibles (menos uno) con transferencia de buffer zero-copy\\n- **Integración de escala** — funciona con el sistema `AssetCache` de Boltdocs y respeta la estructura de directorio `.boltdocs/cache/`\\n- **Salida de estadísticas** — una tabla impulsada por DUI muestra cuánto ahorró cada formato\\n\\nManeja PNG, JPEG, WebP, AVIF, GIF, TIFF y SVG (a través de Sharp + SVGO). La sección de plugins del sitio de documentación oficial tendrá una página pronto — por ahora, revisa el README del paquete.\\n\\n---\\n\\n## Actualización de documentación\\n\\nPasé tiempo actualizando la documentación oficial en todos los frentes — la página del sistema de plugins, la referencia del CLI, las guías de componentes y la documentación de integraciones todas se limpiaron. Las páginas de feedback y matemáticas son completamente nuevas, y la guía de code-blocks es mucho más completa.\\n\\n---\\n\\n## Qué sigue\\n\\nYa estoy trabajando en la siguiente ronda. Esto es lo que viene:\\n\\n- **Giscus** — integración de comentarios/discusiones para páginas de documentación\\n- **Vercel Analytics \u0026 Speed Insights** — analíticas con un clic y cero configuración\\n- **Verificación de Google Search Console** — inyección de meta tag para verificación del sitio\\n- **Mejoras en la API de búsqueda** — mejor ranking, coincidencia difusa y vistas previas de resultados\\n- **Documentación en español** — la documentación oficial obtendrá una traducción completa al español\\n\\nInstala o actualiza:\\n\\n```bash\\npnpm add boltdocs@latest\\n```\\n\\nRevisa la [documentación completa](/docs/) para explorar todo lo nuevo.\",\"locale\":\"es\",\"collection\":\"blog\",\"tags\":[\"Release\"],\"author\":\"Jesús Alcalá\",\"excerpt\":\"2.9.0 lanza el toolkit DUI como paquete independiente, soporte nativo de feedback, un plugin de matemáticas con KaTeX, el hook de ciclo de vida transformSource, banderas CLI para desarrollo, una larga lista de correcciones de bugs y un optimizador de imágenes completamente nuevo.\",\"coverImage\":\"/blog-covers/Boltdocs-2.9.0.webp\",\"seo\":{\"author\":{\"name\":\"Jesús Alcalá\",\"avatar\":\"/avatar.jpeg\"}},\"date\":\"2026-06-06\",\"lastUpdated\":1785192302155.242,\"frontmatter\":{\"title\":\"Boltdocs 2.9.0 — DUI, Feedback, Math y mucho pulido\",\"description\":\"DUI se vuelve independiente, integración de feedback, plugin oficial de matemáticas, hook transformSource, banderas de desarrollo, corrección de bugs y un nuevo optimizador de imágenes\",\"date\":\"2026-06-06\",\"tags\":[\"Release\"],\"author\":{\"name\":\"Jesús Alcalá\",\"avatar\":\"/avatar.jpeg\"},\"excerpt\":\"2.9.0 lanza el toolkit DUI como paquete independiente, soporte nativo de feedback, un plugin de matemáticas con KaTeX, el hook de ciclo de vida transformSource, banderas CLI para desarrollo, una larga lista de correcciones de bugs y un optimizador de imágenes completamente nuevo.\",\"cover\":\"/blog-covers/Boltdocs-2.9.0.webp\",\"lastUpdated\":1785192302155.242},\"slugParts\":[]},\"headings\":[{\"level\":2,\"text\":\"Esta se trata de compartir\",\"id\":\"esta-se-trata-de-compartir\"},{\"level\":2,\"text\":\"DUI se vuelve independiente\",\"id\":\"dui-se-vuelve-independiente\"},{\"level\":2,\"text\":\"Soporte nativo de feedback\",\"id\":\"soporte-nativo-de-feedback\"},{\"level\":2,\"text\":\"Plugin-Math: Ecuaciones hermosas\",\"id\":\"plugin-math-ecuaciones-hermosas\"},{\"level\":2,\"text\":\"transformSource — Un nuevo hook de plugins\",\"id\":\"transformsource--un-nuevo-hook-de-plugins\"},{\"level\":2,\"text\":\"Banderas de desarrollo: --port, --host, --force\",\"id\":\"banderas-de-desarrollo---port---host---force\"},{\"level\":2,\"text\":\"Corrección de bugs y pulido\",\"id\":\"corrección-de-bugs-y-pulido\"},{\"level\":2,\"text\":\"Plugin-Image-Optimizer\",\"id\":\"plugin-image-optimizer\"},{\"level\":2,\"text\":\"Actualización de documentación\",\"id\":\"actualización-de-documentación\"},{\"level\":2,\"text\":\"Qué sigue\",\"id\":\"qué-sigue\"}],\"collection\":\"blog\",\"path\":\"es/boltdocs-2.9.0\",\"frontmatter\":{\"title\":\"Boltdocs 2.9.0 — DUI, Feedback, Math y mucho pulido\",\"description\":\"DUI se vuelve independiente, integración de feedback, plugin oficial de matemáticas, hook transformSource, banderas de desarrollo, corrección de bugs y un nuevo optimizador de imágenes\",\"date\":\"2026-06-06\",\"tags\":[\"Release\"],\"author\":{\"name\":\"Jesús Alcalá\",\"avatar\":\"/avatar.jpeg\"},\"excerpt\":\"2.9.0 lanza el toolkit DUI como paquete independiente, soporte nativo de feedback, un plugin de matemáticas con KaTeX, el hook de ciclo de vida transformSource, banderas CLI para desarrollo, una larga lista de correcciones de bugs y un optimizador de imágenes completamente nuevo.\",\"cover\":\"/blog-covers/Boltdocs-2.9.0.webp\",\"lastUpdated\":1785192302155.242},\"filePath\":\"es/[blog]/boltdocs-2.9.0.mdx\",\"locale\":\"es\",\"date\":\"2026-06-06\",\"lastUpdated\":1785192302155.242}},\"actionData\":null,\"errors\":null}");
