This landmark release marks a complete architectural overhaul of the docmd monorepo, transitioning the entire engine to TypeScript and ESM while launching a premium suite of automated developer tools.

✨ Highlights

🛡️ The docmd Dev Environment Tools

We’ve transformed the contributor workflow into a professional, automated experience. No more manual npm install blocks or confusing build sequences.

  • pnpm onboard: A single command to set up a fresh fork. It silently handles dependency installation and monorepo builds. Use --link-docmd to instantly add docmd to your system path.
  • pnpm verify: Our new production-grade verification suite. It runs a branded E2E failsafe process, ensuring every parser rule, theme asset, and plugin lifecycle is 100% sound before release.
  • pnpm reset: A total environmental purge. Safely stops background servers, unlinks global binaries, and wipes all build caches for a truly fresh start.

🏗️ TypeScript & ESM Native

The core engine has “grown up.” We’ve migrated the entire monorepo from JavaScript (CJS) to TypeScript (ESM) to ensure long-term stability and developer agility.

  • Type-Safe Core: Internal APIs (Parser, Builder, Plugin System) now feature full type definitions, making contributions safer and eliminating “undefined” runtime errors.
  • Modern Modules (ESM): Dropped legacy CommonJS in favor of native ECMAScript Modules, resulting in faster execution and better compatibility with the modern JS ecosystem.
  • Plugin Ecosystem Upgrade: We didn’t stop at the core! All official plugins (plugin-mermaid, plugin-pwa, plugin-search, plugin-seo, plugin-sitemap, plugin-analytics, plugin-installer, plugin-llms) have been rewritten in fully typed ESM. Frontend assets are now independently bundled with esbuild.
  • Version-Specific Navigation: You can now override the global navigation for specific versions, allowing you to tailor the sidebar for legacy documentation versions.

📝 Complete Changelog

🤖 CI/CD Guardrails

  • Automated Verification: Introduced GitHub Actions that automatically run pnpm verify on every Push and Pull Request to the main branch.
  • Release Automation: Modernized the NPM publish workflow to use the new branded verification suite as a final release gatekeeper.

🐛 Refinements & Fixes

  • Branded CLI: All developer commands now feature the blue docmd branding and consistent dimmed status feedback.
  • Playground Bridges: Added playground:add and playground:remove workspace aliases to allow testing CLI features safely inside an isolated playground context.
  • Optimized Failsafe: The verification suite now automatically handles monorepo builds and supports a --skip-setup flag for lightning-fast CI execution.