Skip to content

v0.1.5

Choose a tag to compare

@amitdevx amitdevx released this 29 Jun 11:08
· 7 commits to main since this release

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 .pdf to output paths if the user forgets. Explicitly prevents accidental overwriting of your source .md file if the input and output paths match.
  • Orphaned Flag Warnings: Safely alerts users if they pass sub-flags like --toc-depth or --header-template without their required parent flags (--toc, --header).

Bug Fixes:

  • Playwright Installation Fix: Removed an unreliable global guard in the postinstall script to guarantee that Chromium binaries are downloaded consistently upon npm update.
  • API Path Resolution: Fixed a severe ENOENT crash in convert() (specifically metadata.ts) where the tool couldn't locate package.json in bundled dist/ environments vs. local ts-node.
  • Frontmatter Hardening: Gracefully intercepts YAMLException parsing errors and publish: false skips with clean frontend warnings, completely eliminating massive js-yaml library stack dumps.
  • TOC Depth Validation: --toc-depth now 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