@dimm-city/print-md 0.1.12 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for print-md — markdown to print-ready PDF.
 
-The CLI is for power users who want to script builds, run in CI, batch-process projects, or work outside the desktop app. If you just want to write a book and export a PDF, use the [desktop app](../../README.md#get-the-desktop-app) instead.
+The CLI is for power users who want to script builds, run in CI, batch-process projects, or work outside the desktop app. If you just want to write a book and export a PDF, use the [desktop app](https://github.com/dimm-city/print-md#get-the-desktop-app) instead.
 
 ## Install
 
@@ -26,34 +26,9 @@ Move the binary somewhere on your `PATH`, mark it executable (`chmod +x`), and y
 npm install -g @dimm-city/print-md
 ```
 
-This installs the CLI for `node`-based projects. Same surface area as the binary.
-
-### With Docker (full PDF/X pipeline pre-installed)
-
-No need to install Chromium, Ghostscript, or qpdf — the image bundles
-everything the `lint → build → validate` pipeline needs, including the PDF/X
-(CMYK) pre-print path. (All other validation runs in-process; Poppler and
-ImageMagick are no longer used.) Mount your project at `/work`:
-
-```sh
-docker run --rm -u "$(id -u):$(id -g)" -v "$PWD:/work" \
-    ghcr.io/dimm-city/print-md build my-book --out dist/my-book.pdf --format pdfx
-```
-
-See [docs/docker.md](../../docs/docker.md) for the full guide.
-
-### From source (development only)
-
-```sh
-git clone https://github.com/dimm-city/print-md.git
-cd print-md
-bun install
-bun packages/cli/src/cli.ts --help
-```
-
 ## System requirements
 
-The CLI needs a Chromium-based browser for PDF generation, and a few external tools for PDF post-processing and validation depending on which features you use. See [User Guide: Chapter 8 — System Setup](../../examples/print-md-user-guide/08-system-setup.md) for the full per-feature requirements matrix.
+The CLI needs a Chromium-based browser for PDF generation, and a few external tools for PDF post-processing and validation depending on which features you use. See [User Guide: Chapter 8 — System Setup](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/08-system-setup.md) for the full per-feature requirements matrix.
 
 The short version: you almost certainly want **Ghostscript** installed for PDF output, and **Chrome** / **Chromium** / **Edge** for the actual render.
 
@@ -91,11 +66,11 @@ my-book/
 └─ images/            ← images referenced from markdown or CSS
 ```
 
-See [User Guide: Chapter 1 — Getting Started](../../examples/print-md-user-guide/01-getting-started.md) for a full first-project walkthrough and [examples/](../../examples/) for working starters.
+See [User Guide: Chapter 1 — Getting Started](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/01-getting-started.md) for a full first-project walkthrough and [examples/](https://github.com/dimm-city/print-md/tree/main/examples) for working starters.
 
 ## Manifest
 
-`manifest.yaml` is where you control everything that isn't authored in markdown — book title, the page-size preset, custom styles, plugin loading, validation rules, PDF/X configuration. The schema lives in [`docs/schema-autocomplete.md`](../../docs/schema-autocomplete.md) for YAML autocomplete in editors.
+`manifest.yaml` is where you control everything that isn't authored in markdown — book title, the page-size preset, custom styles, plugin loading, validation rules, PDF/X configuration. The schema lives in [`docs/schema-autocomplete.md`](https://github.com/dimm-city/print-md/blob/main/docs/schema-autocomplete.md) for YAML autocomplete in editors.
 
 Minimal example:
 
@@ -116,7 +91,7 @@ source:
     - chapter-02.md
 ```
 
-The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`. See [docs/user-guide.md](../../docs/user-guide.md#configuration) for the comprehensive reference.
+The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`. See the [configuration reference](https://github.com/dimm-city/print-md/blob/main/docs/user-guide.md#configuration) for details.
 
 ## Commands
 
@@ -165,7 +140,7 @@ Common print-unsafe patterns the plugin flags: remote `url(...)` references in C
 
 ### `print-md validate`
 
-Run the validation pipeline (pre-build source checks and/or post-build PDF checks). Tools that aren't installed are skipped with a warning — they don't fail the run. See [User Guide: Chapter 7 — Validation](../../examples/print-md-user-guide/07-validation.md) for the full check list and [User Guide: Chapter 8 — System Setup](../../examples/print-md-user-guide/08-system-setup.md) for which external tools each check needs.
+Run the validation pipeline (pre-build source checks and/or post-build PDF checks). Tools that aren't installed are skipped with a warning — they don't fail the run. See [User Guide: Chapter 7 — Validation](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/07-validation.md) for the full check list and [User Guide: Chapter 8 — System Setup](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/08-system-setup.md) for which external tools each check needs.
 
 ```sh
 print-md validate [input-dir] [options]
@@ -196,7 +171,7 @@ plugins:
     priority: 10
 ```
 
-See [User Guide: Chapter 6 — Plugins](../../examples/print-md-user-guide/06-plugins.md) for authoring custom plugins.
+See [User Guide: Chapter 6 — Plugins](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/06-plugins.md) for authoring custom plugins.
 
 ## CI / scripting
 
@@ -212,35 +187,22 @@ The standalone binary is the easiest way — drop it in a GitHub Actions step an
     ./print-md build ./my-book --out dist/my-book.pdf
 ```
 
-The binary is self-contained except for the system tools described in [User Guide: Chapter 8 — System Setup](../../examples/print-md-user-guide/08-system-setup.md). On a runner with Chrome and Ghostscript present, you don't need a separate Node or Bun install.
+The binary is self-contained except for the system tools described in [User Guide: Chapter 8 — System Setup](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/08-system-setup.md). On a runner with Chrome and Ghostscript present, you don't need a separate Node or Bun install.
 
 ## Troubleshooting
 
-- **`spawn gs ENOENT`** — Ghostscript not installed. Plain `--format pdf` keeps working (only loses the `/Creator` metadata stamp). PDF/X builds genuinely need it. See [User Guide: Chapter 8 — System Setup](../../examples/print-md-user-guide/08-system-setup.md).
+- **`spawn gs ENOENT`** — Ghostscript not installed. Plain `--format pdf` keeps working (only loses the `/Creator` metadata stamp). PDF/X builds genuinely need it. See [User Guide: Chapter 8 — System Setup](https://github.com/dimm-city/print-md/blob/main/examples/print-md-user-guide/08-system-setup.md).
 - **`No Chrome or Chromium binary found`** — install Chrome/Chromium/Edge, or set `CHROMIUM_PATH=/path/to/chrome` in your environment.
 - **`Tool "X" not found — skipping`** during validate — that's the graceful path; the check requires `X` and isn't available. Install the tool or accept the skip.
 - **All validate checks skipped on Windows** — was a bug pre-0.1.7 (used `which`, which isn't on stock Windows); fixed to use `where.exe`.
 
-## Development
-
-This package is part of the [print-md monorepo](../../README.md). The CLI itself is a thin shell over [`@dimm-city/print-md-lib`](../lib/) — almost all logic lives there.
-
-```sh
-# From repo root
-bun install
-
-# Run CLI from source
-bun packages/cli/src/cli.ts build ./examples/dc-design-guide
-
-# Build the standalone binary for the current platform
-bun --cwd packages/cli scripts/compile.ts bun-linux-x64 ./dist/print-md-cli-linux-x64
-
-# Build the npm tarball
-bun --cwd packages/cli scripts/build-npm.ts
-```
+## Links
 
-See [`CONTRIBUTING.md`](../../CONTRIBUTING.md) for the contributor workflow and [`docs/ARCHITECTURE.md`](../../docs/ARCHITECTURE.md) for the architectural rules of this package (no bundlers at runtime, lazy-loaded heavy deps, etc).
+- [GitHub repository](https://github.com/dimm-city/print-md)
+- [Report an issue](https://github.com/dimm-city/print-md/issues)
+- [Full user guide](https://github.com/dimm-city/print-md/tree/main/examples/print-md-user-guide)
+- [Desktop app](https://github.com/dimm-city/print-md/releases/latest)
 
 ## License
 
-[MPL-2.0](../../LICENSE)
+[MPL-2.0](https://github.com/dimm-city/print-md/blob/main/LICENSE)

package/dist/cli.js

@@ -22640,7 +22640,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@dimm-city/print-md-lib",
-    version: "0.1.12",
+    version: "0.2.0",
     private: true,
     type: "module",
     main: "dist/index.js",
@@ -22883,7 +22883,7 @@ var manifest_schema_default = "./manifest.schema-16z94mx1.json";
 var init_manifest_schema = () => {};
 
 // ../lib/src/assets/preview/scripts/pagedjs-interface.js
-var pagedjs_interface_default = "./pagedjs-interface-vzkzgeb9.js";
+var pagedjs_interface_default = "./pagedjs-interface-9w9r490k.js";
 var init_pagedjs_interface = () => {};
 
 // ../lib/src/assets/preview/scripts/pagedjs-bridge.js

package/dist/pagedjs-interface-9w9r490k.js

@@ -0,0 +1,175 @@
+// Interface adapter: exposes window.previewAPI for the parent toolbar.
+// Paged.js paginates into .pagedjs_page elements. We use PagedConfig.after
+// to know when rendering is done.
+
+(function () {
+  'use strict';
+
+  var pages = [];
+  var currentPage = 1;
+  var debugMode = false;
+  var currentViewMode = 'two-column';
+  var ignoreScrollUntil = 0;
+
+  function refreshPages() {
+    pages = Array.from(document.querySelectorAll('.pagedjs_page'));
+    return pages;
+  }
+
+  function clampPage(n) {
+    if (pages.length === 0) return 1;
+    var page = Number(n);
+    if (!Number.isFinite(page)) page = 1;
+    return Math.max(1, Math.min(Math.round(page), pages.length));
+  }
+
+  function detectVisiblePage() {
+    if (pages.length === 0) return 1;
+    var scrollTop = window.scrollY || document.documentElement.scrollTop;
+    var threshold = scrollTop + window.innerHeight / 3;
+    var page = 1;
+    var pageTop = pages[0].offsetTop;
+    for (var i = pages.length - 1; i >= 0; i--) {
+      if (pages[i].offsetTop <= threshold) {
+        pageTop = pages[i].offsetTop;
+        break;
+      }
+    }
+    for (var j = 0; j < pages.length; j++) {
+      if (Math.abs(pages[j].offsetTop - pageTop) < 2) {
+        page = j + 1;
+        break;
+      }
+    }
+    return page;
+  }
+
+  function scrollToCurrentPage() {
+    if (pages.length === 0) return;
+    var page = clampPage(currentPage);
+    currentPage = page;
+    ignoreScrollUntil = Date.now() + 300;
+    pages[page - 1].scrollIntoView({ behavior: 'instant', block: 'start', inline: 'nearest' });
+  }
+
+  function pageStep(mode) {
+    return (mode || currentViewMode) === 'single' ? 1 : 2;
+  }
+
+  var api = {
+    getTotalPages: function () { refreshPages(); return pages.length; },
+    getCurrentPage: function () { return currentPage; },
+    goToPage: function (n) {
+      refreshPages();
+      currentPage = clampPage(n);
+      scrollToCurrentPage();
+      return api.notifyPageChange();
+    },
+    getPageDimensions: function () {
+      refreshPages();
+      var page = pages[0] || null;
+      var pagesEl = document.querySelector('.pagedjs_pages');
+      if (!page) return null;
+      return {
+        width: currentViewMode === 'single' ? page.offsetWidth : (pagesEl ? pagesEl.scrollWidth : page.offsetWidth),
+        height: page.offsetHeight
+      };
+    },
+    firstPage: function () { return api.goToPage(1); },
+    prevPage: function (mode) { return api.goToPage(currentPage - pageStep(mode)); },
+    nextPage: function (mode) { return api.goToPage(currentPage + pageStep(mode)); },
+    lastPage: function () { refreshPages(); return api.goToPage(pages.length); },
+    setViewMode: function (mode) {
+      refreshPages();
+      currentViewMode = mode || 'two-column';
+      document.body.classList.remove('view-single', 'view-spread', 'view-two-column');
+      if (mode) document.body.classList.add('view-' + mode);
+      scrollToCurrentPage();
+      return api.notifyPageChange();
+    },
+    setZoom: function (z) {
+      document.documentElement.style.setProperty('--pmd-zoom', z);
+    },
+    toggleDebugMode: function () {
+      debugMode = !debugMode;
+      document.body.classList.toggle('debug', debugMode);
+      return debugMode;
+    },
+    notifyPageChange: function () {
+      var detail = { currentPage: api.getCurrentPage(), totalPages: pages.length };
+      window.dispatchEvent(new CustomEvent('pageChanged', { detail: detail }));
+      return detail;
+    },
+    notifyRenderingComplete: function () {
+      window.dispatchEvent(new CustomEvent('renderingComplete', {
+        detail: { totalPages: pages.length }
+      }));
+    }
+  };
+
+  window.previewAPI = api;
+
+  var observedPageCount = 0;
+  var pageObserverQueued = false;
+  function publishObservedPageCount() {
+    pageObserverQueued = false;
+    if (window.__PAGED_RENDERED__ === true) return;
+    var count = refreshPages().length;
+    if (count > observedPageCount) {
+      observedPageCount = count;
+      window.dispatchEvent(new CustomEvent('pageChanged', {
+        detail: { currentPage: count, totalPages: count }
+      }));
+    }
+  }
+  var pageObserver = new MutationObserver(function () {
+    if (window.__PAGED_RENDERED__ === true) return;
+    if (pageObserverQueued) return;
+    pageObserverQueued = true;
+    window.requestAnimationFrame(publishObservedPageCount);
+  });
+
+  function startPageObserver() {
+    var target = document.body || document.documentElement;
+    if (!target) return false;
+    pageObserver.observe(target, { childList: true, subtree: true });
+    return true;
+  }
+
+  if (!startPageObserver()) {
+    document.addEventListener('DOMContentLoaded', function onReady() {
+      document.removeEventListener('DOMContentLoaded', onReady);
+      startPageObserver();
+    });
+  }
+
+  // Scroll tracking
+  var scrollTimer = null;
+  window.addEventListener('scroll', function () {
+    if (pages.length === 0) refreshPages();
+    if (pages.length === 0) return;
+    if (scrollTimer) clearTimeout(scrollTimer);
+    scrollTimer = setTimeout(function () {
+      if (Date.now() < ignoreScrollUntil) return;
+      var page = detectVisiblePage();
+      if (page !== currentPage) {
+        currentPage = page;
+        api.notifyPageChange();
+      }
+    }, 150);
+  });
+
+  // Paged.js calls this when rendering is complete
+  window.PagedConfig = window.PagedConfig || {};
+  window.PagedConfig.after = function (flow) {
+    refreshPages();
+    observedPageCount = pages.length;
+    pageObserver.disconnect();
+    currentPage = 1;
+    ignoreScrollUntil = Date.now() + 300;
+    window.scrollTo(0, 0);
+    console.log('Paged.js rendered ' + pages.length + ' pages');
+    api.notifyRenderingComplete();
+    setTimeout(api.notifyPageChange, 0);
+  };
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimm-city/print-md",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Markdown-to-PDF converter for professional print layout using Paged.js and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",

package/dist/pagedjs-interface-vzkzgeb9.js

@@ -1,94 +0,0 @@
-// Interface adapter: exposes window.previewAPI for the parent toolbar.
-// Paged.js paginates into .pagedjs_page elements. We use PagedConfig.after
-// to know when rendering is done.
-
-(function () {
-  'use strict';
-
-  var pages = [];
-  var currentIndex = 0;
-  var debugMode = false;
-
-  function refreshPages() {
-    pages = Array.from(document.querySelectorAll('.pagedjs_page'));
-    return pages;
-  }
-
-  function detectCurrentPage() {
-    if (pages.length === 0) return 0;
-    var scrollTop = window.scrollY || document.documentElement.scrollTop;
-    var threshold = scrollTop + window.innerHeight / 3;
-    for (var i = pages.length - 1; i >= 0; i--) {
-      if (pages[i].offsetTop <= threshold) return i;
-    }
-    return 0;
-  }
-
-  var api = {
-    getTotalPages: function () { refreshPages(); return pages.length; },
-    getCurrentPage: function () { return currentIndex + 1; },
-    goToPage: function (n) {
-      refreshPages();
-      currentIndex = Math.max(0, Math.min(n - 1, pages.length - 1));
-      // Use 'instant' so the scroll completes synchronously before notifyPageChange
-      // fires. 'smooth' interacts with the scroll-listener debounce timer and causes
-      // the parent Svelte toolbar to receive a stale page number on fast navigation.
-      pages[currentIndex].scrollIntoView({ behavior: 'instant', block: 'start' });
-      api.notifyPageChange();
-    },
-    getPageDimensions: function () {
-      var page = document.querySelector('.pagedjs_page');
-      return page ? { width: page.offsetWidth, height: page.offsetHeight } : null;
-    },
-    firstPage: function () { api.goToPage(1); },
-    prevPage: function () { api.goToPage(currentIndex); },
-    nextPage: function () { api.goToPage(currentIndex + 2); },
-    lastPage: function () { api.goToPage(pages.length); },
-    setViewMode: function (mode) {
-      document.body.classList.remove('view-single', 'view-spread', 'view-two-column');
-      if (mode) document.body.classList.add('view-' + mode);
-    },
-    setZoom: function (z) {
-      document.documentElement.style.setProperty('--pmd-zoom', z);
-    },
-    toggleDebugMode: function () {
-      debugMode = !debugMode;
-      document.body.classList.toggle('debug', debugMode);
-      return debugMode;
-    },
-    notifyPageChange: function () {
-      window.dispatchEvent(new CustomEvent('pageChanged', {
-        detail: { currentPage: api.getCurrentPage(), totalPages: pages.length }
-      }));
-    },
-    notifyRenderingComplete: function () {
-      window.dispatchEvent(new CustomEvent('renderingComplete', {
-        detail: { totalPages: pages.length }
-      }));
-    }
-  };
-
-  window.previewAPI = api;
-
-  // Scroll tracking
-  var scrollTimer = null;
-  window.addEventListener('scroll', function () {
-    if (pages.length === 0) return;
-    if (scrollTimer) clearTimeout(scrollTimer);
-    scrollTimer = setTimeout(function () {
-      var idx = detectCurrentPage();
-      if (idx !== currentIndex) {
-        currentIndex = idx;
-        api.notifyPageChange();
-      }
-    }, 150);
-  });
-
-  // Paged.js calls this when rendering is complete
-  window.PagedConfig = window.PagedConfig || {};
-  window.PagedConfig.after = function (flow) {
-    refreshPages();
-    console.log('Paged.js rendered ' + pages.length + ' pages');
-    api.notifyRenderingComplete();
-  };
-})();