This release introduces the much-anticipated Menubar component, significantly hardens the Zero-Config engine, and transforms the developer experience with a robust dev server and a built-in playground.

🚀 New Features

1. Global Menubar

The focus of this release is the new Menubar, providing a top-level navigation layer for your documentation.

  • Versatile Positioning: Can be placed at the very top of the viewport (fixed) or inside the header slot (sticky).
  • Rich Components: Supports branding (logo + title), link items, and nested dropdowns for complex navigation needs.
  • Responsive Design: Automatically collapses on mobile devices to maintain a clean reading experience.

2. Built-in _playground

We’ve added a dedicated _playground package within the repository. Developers can now test core engine changes, UI components, and parser rules in real-time without leaving the codebase.

3. Smarter Options Menu Positioning

The Options Menu (Search, Theme Toggle, Sponsor) is now more flexible than ever.

  • Menubar Integration: A new menubar position allows the options menu to sit perfectly on the right side of your navigation bar.
  • Intelligent Fallbacks: If you configure the options menu to a position that is currently disabled (like header or menubar), docmd now automatically falls back to sidebar-top to ensure your users never lose access to essential utilities.

🛠️ Improvements & Fixes

✨ Dev-UX & Dev Server Hardening

  • Auto Port Selection: docmd dev now automatically finds and binds to the next available port if 3000 is in use, eliminating interactive prompts and speeding up launch times.
  • Log Refinement: We’ve eliminated repeating build logs and improved visual highlights, providing clearer details about the build process and PWA asset generation.
  • Robust Rebuilds: Fixed issues where pnpm dev would fail during active development. The internal watcher is now smarter about tracking core utility changes.

📦 Zero-Config Evolution

  • Selective Activation: Zero-Config is now more surgical about where it activates, implementing “silent kills” to avoid triggering in invalid or non-project directories.
  • Stability: Multiple edge cases in directory analysis have been resolved, making the zero-config start much more reliable across different OS environments.

🍱 Container Improvements

  • Indentation Fixes: Resolved long-standing indentation issues in container syntax parsing.
  • Nested Design: Improved the visual and structural handling of nested containers (e.g., Tabs inside Callouts).

🐛 Bug Fixes

  • Container Heading Logic: Fixed a design flaw where headings inside containers (Tabs, Cards, etc.) were receiving permalinks and appearing in the Table of Contents. They are now correctly excluded to keep your TOC focused on main page sections.
  • Sidebar-Top Fallback: Fixed an issue where the Options Menu would remain invisible if its primary target container was disabled.

📥 Upgrade

npm install -g @docmd/core

Full Changelog: https://github.com/docmd-io/docmd/compare/0.5.1...0.5.2

Previous 0.5.3 Next 0.5.1