v0.10.0 - Servidor de producción, recursos estáticos y MDX
v0.10.0 - Servidor de producción, recursos estáticos y MDX
Servidor de producción, recursos estáticos y MDX
v0.10.0 introduce un servidor HTTP de producción dedicado (docmd serve), una canalización sin configuración de recursos estáticos raíz (public/), soporte nativo de componentes MDX impulsado por @docmd/lite-mdx, diagnósticos previos del entorno (docmd doctor) y estandarización general del ecosistema en todas las bibliotecas de soporte.
Added
- Servidor HTTP de producción (
@docmd/core): Introduce el comandodocmd servepara servir documentación en producción sin sobrecarga de monitorización de archivos. Incluye compresión Gzip y Deflate, cabeceras de seguridad estándar (CSP, HSTS, protección de marcos), sondas liveness y readiness para contenedores en/healthzy vinculación de host configurable. La imagen Docker ahora utiliza por defectodocmd serve --host 0.0.0.0. Contribuido por @svallory en #273 y #279. - MCP opcional a través de HTTP (
@docmd/core): Expone capacidades del Protocolo de Contexto de Modelo bajodocmd serveenPOST /mcp, mediante un controlador JSON-RPC independiente del transporte protegido conserve.mcp: truey autenticación por token o cabecera. Contribuido por @svallory en #278. - Host de acciones de complementos en producción (
@docmd/core,@docmd/api): Extiende las acciones de complementos adocmd servecon listas de orígenes permitidos estrictas y validación de identidad del llamador para prevenir modificaciones no autorizadas de contexto. Contribuido por @svallory en #272 y #277. - Canalización de recursos estáticos raíz (
@docmd/core): Detecta automáticamente un directoriopublic/superior (o rutas personalizadas definidas enstaticdentro dedocmd.config.json) y copia los archivos directamente a la raíz compilada preservando la jerarquía pararobots.txt,favicon.ico,CNAMEy.well-known/funding-manifest-urls. - Renderizado de componentes MDX (
@docmd/plugin-mdx,@docmd/lite-mdx): Integra soporte MDX de primer nivel en el núcleo mediante el compilador de alto rendimiento@docmd/lite-mdxpara componentes JSX interactivos junto con Markdown estándar sin configuración previa. - Diagnóstico de entorno con Doctor (
@docmd/core,@docmd/tui): Añade el comandodocmd doctorpara validar el estado del sistema, versiones de Node.js, requisitos de motores, disponibilidad de puertos, plantillas e integridad de complementos con informes coloreados en terminal. - Opción headless dinámica (
@docmd/core): Añade la opción CLI--no-openy la variable de entornoDOCMD_NO_OPEN=trueendev,servey ejecutores de pruebas para evitar aperturas accidentales de navegadores en flujos de CI o contenedores. - Valores de respaldo dinámicos de versión (
@docmd/parser,@docmd/ui): Automatiza la sincronización de reservas dedocmd.versionydocmd.buildYearen registros del analizador y tiempos de ejecución del cliente. - Complemento opcional Iconify (
@docmd/plugin-iconify): Proporciona resolución de iconos bajo demanda para más de 100.000 iconos pertenecientes a más de 100 colecciones mediante la sintaxisicon:iconify:<nombre>.
Improved
- Vinculación de interfaces de red (
@docmd/core): Añade la opción CLI--host <dirección>paradocmd dev,docmd servey flujos de trabajo de espacio de trabajo, con127.0.0.1como valor predeterminado seguro. Contribuido por @svallory en #269. - Aislamiento con Web Workers en Playground (
@docmd/plugin-playground): Ejecuta el código en web workers en segundo plano para evitar que scripts bloqueantes congelen el hilo principal de la interfaz de usuario. - Limpieza del árbol de compilación: Garantiza que
pnpm -r run buildmantenga el árbol de trabajo de Git limpio aislando archivos generados. Contribuido por @svallory en #275. - Aislamiento del conjunto de pruebas: Asigna raíces temporales dedicadas por proceso de prueba para prevenir condiciones de carrera. Contribuido por @svallory en #276.
- Metadatos y financiación del ecosistema: Palabras clave estandarizadas, documentación README alineada para complementos internos y manifiestos de repositorio y patrocinio dirigidos a
https://docmd.ioy la organizacióndocmd-io.
Fixed
- Ejecución de scripts en navegación SPA (
@docmd/ui): Evita que la navegación en aplicaciones de página única reejecute scripts en línea en el cuerpo del documento. Contribuido por @MSOB7YY en #270. - Destello del tema de Highlight.js (
@docmd/ui,@docmd/template-summer): Aplica los estilos de resaltado de sintaxis inmediatamente en la carga inicial evitando destellos sin estilo. Contribuido por @MSOB7YY en #270. - Enlaces a carpetas sin barra final (
@docmd/parser): Corrige la resolución de enlaces relativos hacia directorios desde páginas anidadas. Contribuido por @GPT-AGI en #271. - Búsqueda en ancestros con Gitignore (
@docmd/core): Limita las reglas gitignore desancladas a su propio directorio para evitar exclusiones indebidas de archivos fuente. Contribuido por @svallory en #274. - Blindaje de rutas MCP (
@docmd/core): Restringeread_docylist_docsa archivos markdown dentro de las raíces configuradas, bloqueando escapes por enlaces simbólicos. Contribuido por @svallory en #268. - Respaldo de esquema de migas de pan (
@docmd/plugin-seo): Resuelve elementos intermedios omitidos en el marcado JSON-LD con jerarquías de autorrecuperación.
Security & Maintenance
- Las vistas previas HTML de Playground se ejecutan en iframes aislados sin
allow-same-origin. - Cabeceras de seguridad en servidor de producción:
docmd serveaplica CSP, HSTS, X-Content-Type-Options y Frame-Options de forma predeterminada. - Validación de origen en WebSockets: Aplica listas estrictas de orígenes permitidos y rechaza mensajes no autenticados en el host de acciones.
- Actualización de
docker/login-actiona 4.8.0 en PR #281. - Actualización de dependencias de tiempo de ejecución del espacio de trabajo en PR #282.
Links
Documentación: https://docs.docmd.io/
Plataforma Cloud: https://cloud.docmd.io/
Habilidades de desarrollo y redacción: https://github.com/docmd-io/docmd-skills
New Contributors
- @svallory realizó su primera contribución en https://github.com/docmd-io/docmd/pull/268
- @MSOB7YY realizó su primera contribución en https://github.com/docmd-io/docmd/pull/270
- @GPT-AGI realizó su primera contribución en https://github.com/docmd-io/docmd/pull/271
Registro de cambios completo: https://github.com/docmd-io/docmd/compare/0.9.9...0.10.0