v0.1.5
Release Notes - v0.1.5
major polish and bug-fix release focused on CLI User Experience, robust error handling, and resolving edge-case crashes found in the wild.
Features & Enhancements:
- Native Footnotes Restored: Fully resolved CSS selector bugs causing footnote backlinks to render incorrectly. Footnotes (with bidirectional links) are now fully supported out-of-the-box.
- Friendly CLI Error UX: The CLI now catches almost all edge cases (missing files, providing directories instead of files, missing arguments) and provides clean, color-coded, human-readable hints instead of raw Node.js stack traces.
- Auto-Extension & Safety: Automatically appends
.pdfto output paths if the user forgets. Explicitly prevents accidental overwriting of your source.mdfile if the input and output paths match. - Orphaned Flag Warnings: Safely alerts users if they pass sub-flags like
--toc-depthor--header-templatewithout their required parent flags (--toc,--header).
Bug Fixes:
- Playwright Installation Fix: Removed an unreliable global guard in the
postinstallscript to guarantee that Chromium binaries are downloaded consistently uponnpm update. - API Path Resolution: Fixed a severe
ENOENTcrash inconvert()(specificallymetadata.ts) where the tool couldn't locatepackage.jsonin bundleddist/environments vs. localts-node. - Frontmatter Hardening: Gracefully intercepts
YAMLExceptionparsing errors andpublish: falseskips with clean frontend warnings, completely eliminating massivejs-yamllibrary stack dumps. - TOC Depth Validation:
--toc-depthnow strictly validates integer inputs (1-6) and gracefully halts on garbage input. - Exit Code Normalization: Differentiated exit codes (USAGE, INPUT, CONFIG, DEPENDENCY, RENDER) for reliable CI and bash scripting.
Full Changelog: v0.1.4...v0.1.5