@dkothule/md2pdf 1.0.1 → 1.0.3

package/README.md

@@ -18,20 +18,74 @@ It keeps Mermaid diagrams sharp in PDF by rendering vector assets (SVG by defaul
 - Configurable defaults (`~/.config/md2pdf/config.env`, project `.md2pdfrc`, or `--config`).
 - Optional Finder Quick Action integration on macOS.
 
-## Install
+## New Machine Bootstrap (No Homebrew or npm)
+
+If this is a fresh machine, install package manager/runtime first:
+
+macOS:
 
-### 1) Install system dependencies
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+eval "$(/opt/homebrew/bin/brew shellenv)" || eval "$(/usr/local/bin/brew shellenv)"
+brew install node
+```
 
-From repo checkout, install required tools:
+Debian/Ubuntu:
 
 ```bash
-./install-system-deps.sh
+sudo apt-get update
+sudo apt-get install -y nodejs npm
 ```
 
-### 2) Install md2pdf CLI
+Then continue with the install steps below.
+
+## Install
+
+### Frictionless install (recommended)
+
+Prerequisite: Node.js + npm installed (required to install the npm package).
+
+1) Install md2pdf:
 
 ```bash
 npm i -g @dkothule/md2pdf
+```
+
+2) Install runtime dependencies (system packages + `pandocfilters`):
+
+```bash
+md2pdf-install-system-deps
+```
+
+Use `--yes` to skip the confirmation prompt (helpful for automation):
+
+```bash
+md2pdf-install-system-deps --yes
+```
+
+3) Verify:
+
+```bash
+md2pdf --version
+md2pdf --help
+```
+
+`md2pdf-install-system-deps` supports macOS (Homebrew) and Debian/Ubuntu.
+Run `md2pdf-install-system-deps --help` to see options.
+
+### Manual fallback (if helper script does not support your Linux distro)
+
+Install these dependencies yourself:
+
+- `pandoc`
+- LaTeX PDF engine (`xelatex` default)
+- `librsvg` / `rsvg-convert`
+- `python3` + `pip`
+- `node` + `npm`
+
+Then install the Python dependency:
+
+```bash
 python3 -m pip install pandocfilters
 ```
 
@@ -167,7 +221,7 @@ md2pdf ./tests/samples/mermaid-all-diagram-types.md --keep-mermaid-assets
 
 ## Keywords
 
-markdown to pdf, md to pdf, mermaid to pdf, mermaid svg, pandoc markdown pdf, markdown pdf cli, macOS markdown pdf, Linux markdown pdf
+markdown to pdf, md to pdf, md2pdf, mermaid to pdf, mermaid svg, pandoc markdown pdf, markdown pdf cli, macOS markdown pdf, Linux markdown pdf
 
 ## License
 

package/install-system-deps.sh

@@ -3,8 +3,99 @@
 # Copyright (c) 2026 Deepak Kothule
 set -euo pipefail
 
+YES=0
 OS="$(uname -s)"
 
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") [options]
+
+Install md2pdf runtime dependencies (system packages + pandocfilters).
+
+Options:
+  -y, --yes   Skip confirmation prompt and proceed immediately
+  -h, --help  Show this help message
+
+Supported platforms:
+  - macOS (Homebrew)
+  - Debian/Ubuntu Linux (apt)
+EOF
+}
+
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      -y|--yes)
+        YES=1
+        ;;
+      -h|--help)
+        usage
+        exit 0
+        ;;
+      *)
+        echo "Error: unknown option: $1" >&2
+        usage >&2
+        exit 1
+        ;;
+    esac
+    shift
+  done
+}
+
+confirm_install() {
+  if [[ "$YES" -eq 1 ]]; then
+    return
+  fi
+
+  if [[ ! -t 0 ]]; then
+    echo "Non-interactive shell detected. Re-run with --yes to proceed." >&2
+    exit 1
+  fi
+
+  echo "This command will install system packages for md2pdf and may prompt for sudo password."
+  echo "Detected OS: $OS"
+  printf "Continue? [y/N] "
+  local response
+  read -r response
+
+  case "${response,,}" in
+    y|yes)
+      ;;
+    *)
+      echo "Aborted."
+      exit 0
+      ;;
+  esac
+}
+
+has_pandocfilters() {
+  python3 - <<'PY' >/dev/null 2>&1
+import pandocfilters
+PY
+}
+
+install_python_dependency() {
+  if has_pandocfilters; then
+    echo "Python dependency already installed: pandocfilters"
+    return
+  fi
+
+  echo "Installing Python dependency: pandocfilters"
+  if python3 -m pip install --user pandocfilters; then
+    return
+  fi
+
+  if python3 -m pip install pandocfilters --break-system-packages; then
+    return
+  fi
+
+  echo "Failed to install pandocfilters automatically." >&2
+  echo "Please install manually with one of:" >&2
+  echo "  python3 -m pip install --user pandocfilters" >&2
+  echo "  python3 -m pip install pandocfilters --break-system-packages" >&2
+  exit 1
+}
+
 install_macos() {
   if ! command -v brew >/dev/null 2>&1; then
     echo "Homebrew is required on macOS. Install from https://brew.sh and retry."
@@ -12,7 +103,11 @@ install_macos() {
   fi
 
   brew update
-  brew install pandoc librsvg node python
+  brew install pandoc librsvg python
+
+  if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
+    brew install node
+  fi
 
   if ! command -v xelatex >/dev/null 2>&1; then
     echo "Installing BasicTeX for xelatex..."
@@ -26,14 +121,20 @@ install_debian_ubuntu() {
   sudo apt-get install -y \
     pandoc \
     librsvg2-bin \
-    nodejs \
-    npm \
     python3 \
     python3-venv \
     python3-pip \
+    python3-pandocfilters \
     texlive-xetex
+
+  if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
+    sudo apt-get install -y nodejs npm
+  fi
 }
 
+parse_args "$@"
+confirm_install
+
 if [[ "$OS" == "Darwin" ]]; then
   install_macos
 elif [[ "$OS" == "Linux" ]]; then
@@ -49,4 +150,6 @@ else
   exit 1
 fi
 
-echo "System dependencies installed."
+install_python_dependency
+
+echo "Runtime dependencies installed."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dkothule/md2pdf",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Markdown to PDF converter with high-resolution Mermaid diagram rendering",
   "author": "Deepak Kothule",
   "license": "MIT",
@@ -44,6 +44,7 @@
   ],
   "bin": {
     "md2pdf": "./bin/md2pdf",
+    "md2pdf-install-system-deps": "./install-system-deps.sh",
     "md2pdf-install-finder-action": "./scripts/install_md2pdf_quick_action.sh",
     "md2pdf-uninstall-finder-action": "./scripts/uninstall_md2pdf_quick_action.sh"
   },