Destacados

docmd v0.9.1 ofrece una modernización integral del motor de contenedores: introducción de etiquetas de cierre de contenedor explícitas estandarizadas, atributos de cabecera clave-valor explícitos, comentarios # comentario al final, un contenedor de diagramas ::: mermaid nativo, la resolución de Issue #187 (líneas en blanco en bloques HTML en modo noStyle) y paridad de documentación 1:1 en todos los idiomas admitidos (en, de, es, zh).

Estandarización del Motor de Contenedores

  • Etiquetas de Cierre Explícitas: Etiquetas de cierre explícitas estandarizadas (::: container::: /container) en todos los contenedores estructurales para una resolución determinista de bloques y profundidad de anidación infinita.
  • Nomenclatura Unificada de Subcontenedores: Introducción de elementos de subcontenedor con nombre (::: tab::: /tab para ::: tabs, ::: step::: /step para ::: steps, ::: log::: /log para ::: changelog). Los marcadores anteriores (== tab, 1.) siguen siendo compatibles hacia atrás.
  • Formato Clave-Valor Explícito: Sintaxis de parámetros con nombre estandarizada (title:"...", url:"...", align:center, zoom:true, icon:name) en cabeceras manteniendo compatibilidad con argumentos posicionales.
  • Comentarios en Cabeceras de Contenedores: Soporte nativo para comentarios al final # comentario en líneas de contenedor (::: tabs # comentario de cabecera, ::: /tabs # comentario de cierre).
  • Normalizador de Contenedores de Cierre Automático & Etiquetas Flexibles: Seguimiento de profundidad mejorado, incrustación en párrafos (::: button, ::: tag) y eliminación automática de etiquetas huérfanas en contenedores de cierre automático (::: button, ::: tag, ::: embed). Las etiquetas de cierre explícitas opcionales (::: /button, ::: /tag) son totalmente compatibles.
  • Nuevo Contenedor de Tooltip (::: tip): Introducción de explicaciones emergentes e interactivas (::: tip "Explicación" term:"Término" ::: /tip) al pasar el cursor para documentación en línea y en bloque.

Contenedor de Diagramas ::: mermaid Nativo

  • Interfaz de Usuario Avanzada: Introducción de un contenedor dedicado ::: mermaid que envuelve el DSL del diagrama dentro de un contenedor interactivo con cabeceras personalizadas, barra de título, iconos, alineación (left, center, right), temas integrados (default, dark, forest, neutral) y controles de zoom/desplazamiento.
  • Ejecución Vinculada al Plugin: Desarrollado directamente por @docmd/plugin-mermaid. Si el plugin está desactivado en docmd.config.json, tanto los contenedores ::: mermaid como los bloques de código se desactivan limpiamente sin cargar recursos JS en el cliente.
  • Compatibilidad Híbrida con GFM: Los bloques de código estándar (```mermaid) siguen siendo 100% compatibles con GitHub y previsualizadores de IDE.

Mejoras del Asistente de IA y Herramientas de Navegación

  • Nueva Herramienta get_site_structure: Se equipó @docmd/plugin-ai con una herramienta de inspección estructural (get_site_structure) que permite al Asistente de IA obtener el manifiesto completo de versiones del sitio (actuales e históricas), idiomas admitidos, configuración de espacio de trabajo multiproyecto y el árbol completo de navegación de páginas con títulos y URLs.
  • Detección Dinámica de Capacidades de Búsqueda: El Asistente de IA ahora inspecciona los metadatos de compilación de @docmd/plugin-search (searchCapabilities: { keyword: true, semantic: Boolean }) para determinar dinámicamente si la búsqueda vectorial semántica está habilitada o si solo está activa la búsqueda por palabras clave (MiniSearch).
  • Optimización de Consultas de Palabras Clave y Semánticas: Se actualizaron las instrucciones y el enrutamiento del asistente para que las llamadas a search_documentation den formato a los términos como palabras clave concisas y de alta precisión (por ejemplo, "containers hero"), evitando coincidencias irrelevantes en motores de palabras clave y maximizando la relevancia en índices semánticos.

Correcciones del Motor y de Errores

  • Líneas en Blanco en Bloques HTML (Issue #187): Se resolvió un problema en el que las líneas en blanco entre elementos HTML en páginas noStyle o archivos Markdown estándar provocaban que los elementos HTML posteriores se renderizaran como texto sin formato.
  • Preservación de Enlaces de Portada en SPAs Zero-Config (Issue #196): Se solucionó un error en la sincronización de la barra lateral tras transiciones SPA en el que los enlaces de la página de inicio raíz (<a href="">) se convertían erróneamente en <a href="#">, impidiendo volver a la raíz de la documentación.
  • Renderizado del Banner en la Plantilla Summer: Se solucionó un problema en @docmd/template-summer en el que las configuraciones de banner basadas en objetos (con formato Markdown, variantes de tipo, enlaces, iconos y botón de cierre) no mostraban el texto ni los componentes del banner.

Paridad Global de Documentación

  • Sincronización Multilingüe: Se actualizaron todas las páginas de documentación, guías de contenedores y ejemplos de código 1:1 en inglés (en), alemán (de), español (es) y chino (zh).