v0.9.3 Release Notes
Highlights
docmd v0.9.3 delivers offline air-gapped Mermaid bundling, OpenAPI request/response examples and schema layout containment, universal AI Assistant tool-call parsing powered by docmd-assistant v0.1.14, and URL sanitisation stability enhancements.
Offline & Air-Gapped Mermaid Diagrams (@docmd/plugin-mermaid)
- Local Self-Contained Bundling: The Mermaid plugin now bundles the entire Mermaid runtime locally using
esbuildas a classic IIFE script, completely removing runtime CDN dependencies (jsdelivr.net). - Air-Gapped &
file://Compatibility: Diagrams now render completely offline, in zero-network air-gapped environments, and when viewing compiled documentation directly through thefile://protocol.
OpenAPI Plugin Enhancements (@docmd/plugin-openapi)
- Examples & Media Types: Added comprehensive support for OpenAPI 3.x request body examples, response examples, and multi-schema sample bodies.
- Schema Table Containment & Horizontal Scrolling:
- Wrapped parameter and schema tables in
.oa-table-wrapcontainers with isolatedoverflow-x: autoscrolling. - Expanding deep schema trees or complex nested tables no longer causes page-level viewport distortion or horizontal blowout.
- Operation headers, method badges, summaries, and descriptions remain stably positioned with word-break wrapping.
- Wrapped parameter and schema tables in
AI Assistant Plugin & Engine (@docmd/plugin-ai & docmd-assistant v0.1.14)
- Universal Multi-Format Tool Parser: Upgraded
docmd-assistantwith universal tool-call extraction handling balanced JSON objects, Markdown codeblocks (```json), bracketed syntax ([Tool Call: name(...)]), and zero-argument calls (get_site_structure()). - Zero Raw String Leakage: Guarantees raw tool-call strings are never exposed in user chat; tools are executed autonomously and synthesised into clean, fact-grounded explanations.
- Classic Script Execution: Client assets now compile as classic IIFE scripts, ensuring compatibility with offline
file://browsing.
Parser & Core Fixes (@docmd/parser & @docmd/core)
- URL Sanitisation: Fixed leading
//protocol-relative collapse insanitizeUrlpreventing broken links in generated sub-sites. - Service Worker Protocol Guard: Added protocol checks ensuring
navigator.serviceWorkerregistration queries are safely bypassed onfile://origins without throwing security exceptions.
Resolved Issues & Pull Requests
- Issue #198: Allow using mermaid plugin in air-gapped sites and offline mode (reported by @cboitel).
- Issue #199 / PR #200: Add support for examples in OpenAPI plugin (contributed by @w666).
- PR #203: Collapse leading
//insanitizeUrl(contributed by @eeshsaxena). - Issue #205: Unstable verification pipeline (reported by @w666).
- Issue #206: AI chat returns tool-call string instead of real responses (reported by @mewc).
Global Documentation Parity
- Multilingual Synchronisation: Updated all release notes and plugin references across English (
en), German (de), Spanish (es), and Chinese (zh).