pretext-pdf 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -7,6 +7,50 @@ Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/)
 
 ---
 
+## [1.0.9] — 2026-05-06
+
+Test coverage Phase 2: filling blind spots in the CLI, the pdfmake compat shim, and
+the performance regression guard. Adds c8 coverage tooling for measurability.
+
+### Added
+
+- **`test/cli.test.ts`** (+13 tests) — End-to-end coverage for the `pretext-pdf` CLI binary,
+  spawning `dist/cli.js` as a subprocess. Covers argument parsing (`--version`, `--help`,
+  `-i/-o/--markdown/--code-font`, positional fallback, unknown flags), JSON and Markdown
+  input modes, stdin/stdout piping, and exit codes 0/1/2.
+
+- **`test/compat.test.ts`** (+34 tests) — Coverage for the pdfmake → pretext-pdf
+  translation shim (`fromPdfmake`). Covers page setup (pageSize string and object,
+  pageMargins scalar/2-tuple/4-tuple, orientation), styles (defaultStyle, named styles,
+  headingMap override), all content node types (string, `text`, `ul`/`ol` with nesting,
+  `table` with header rows, `image`, `qr`, `pageBreak`, `stack`), header/footer string
+  forms, integration render, and unsupported nodes (`columns`, `canvas`).
+
+- **c8 coverage tooling** — `npm run coverage` (text + lcov reporters) and
+  `npm run coverage:check` (75/65/75 thresholds, non-blocking in CI initially).
+  Configuration in `.c8rc.json` excludes type-only files and CLI from instrumentation.
+  Coverage step added to CI as `continue-on-error: true` while baseline thresholds
+  are calibrated.
+
+### Fixed
+
+- **`test/benchmark-baseline.test.ts`: regression guard now actually guards** —
+  Replaced the prior "TODO: enable when baseline is calibrated" stub (which collected
+  timings but asserted nothing) with a real 3x-baseline-with-500ms-floor budget per
+  corpus. Missing corpora in the baseline JSON now `assert.fail()` instead of silently
+  defaulting to a zero budget that would mask any regression.
+
+- **CONTRIBUTING.md: removed stale "(676 tests)" annotation** — Test count drift bait;
+  the README badge already auto-verifies via `verify:badges`.
+
+### Changed
+
+- **Test runner now builds first** — Added `pretest:unit: npm run build` so contributors
+  running `npm run test:unit` always get a fresh dist; the new CLI tests spawn the
+  compiled binary and would otherwise fail with a confusing module-not-found error.
+
+---
+
 ## [1.0.8] — 2026-05-06
 
 Public API contract integrity: the `RenderOptions.logger` option now actually does what

package/README.md

@@ -9,7 +9,7 @@
 [![npm downloads](https://img.shields.io/npm/dw/pretext-pdf)](https://www.npmjs.com/package/pretext-pdf)
 [![CI](https://github.com/Himaan1998Y/pretext-pdf/actions/workflows/ci.yml/badge.svg)](https://github.com/Himaan1998Y/pretext-pdf/actions)
 [![TypeScript](https://img.shields.io/badge/typescript-strict-blue)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-695-brightgreen)](#tests)
+[![Tests](https://img.shields.io/badge/tests-742-brightgreen)](#tests)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 [![Bundle](https://img.shields.io/badge/runtime%20deps-8-informational)](#runtime-footprint)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pretext-pdf",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Generate PDFs from JSON — declarative, serverless, no Chromium. TypeScript-first with professional typography. Ideal for invoices, reports, and AI agents.",
   "keywords": [
     "pdf",
@@ -88,7 +88,8 @@
     "build": "tsc",
     "api:extract": "api-extractor run --local",
     "api:check": "api-extractor run",
-    "test:unit": "tsx --test test/validate.test.ts test/validate-document.test.ts test/builder.test.ts test/rich-text.test.ts test/layout-contract.test.ts test/hard-text-contract.test.ts test/validate-strict.test.ts test/logger-routing.test.ts",
+    "test:unit": "tsx --test test/validate.test.ts test/validate-document.test.ts test/builder.test.ts test/rich-text.test.ts test/layout-contract.test.ts test/hard-text-contract.test.ts test/validate-strict.test.ts test/logger-routing.test.ts test/compat.test.ts test/cli.test.ts",
+    "pretest:unit": "npm run build",
     "test:validate": "tsx --test test/validate.test.ts test/builder.test.ts",
     "test:e2e": "tsx --test test/e2e.test.ts",
     "test:phase-3": "tsx --test test/signatures-validation.test.ts",
@@ -109,6 +110,8 @@
     "test:contract": "tsx --test test/pretext-api-contract.test.ts test/benchmark-baseline.test.ts test/drift-guards.test.ts test/plugin-registry.test.ts test/benchmark-corpora.test.ts test/smoke-staging.test.ts test/table-determinism.test.ts",
     "test:2f": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsx --test test/stress.test.ts",
     "test": "npm run test:contract && npm run test:unit && npm run test:e2e && npm run test:phases",
+    "coverage": "c8 --reporter=text --reporter=lcov npm test",
+    "coverage:check": "c8 check-coverage --lines 75 --branches 65 --functions 75",
     "verify:badges": "cross-env SKIP_TEST_RUN=1 node scripts/verify-badges.js",
     "verify:badges:full": "node scripts/verify-badges.js",
     "test:rich": "tsx --test test/rich-text.test.ts",
@@ -128,7 +131,7 @@
     "example:callout": "tsx examples/phase8-callout.ts",
     "example:gst": "tsx examples/gst-invoice-india.ts",
     "example:plugin": "tsx examples/plugin-custom-element.ts",
-  "example:floats": "tsx examples/phase9b-float-groups.ts",
+    "example:floats": "tsx examples/phase9b-float-groups.ts",
     "example:showcase-invoice": "tsx examples/showcase-invoice.ts",
     "example:showcase-report": "tsx examples/showcase-report.ts",
     "example:showcase-resume": "tsx examples/showcase-resume.ts",
@@ -190,6 +193,7 @@
     "@types/pngjs": "^6.0.5",
     "@types/qrcode": "^1.5.6",
     "bwip-js": "^4.9.2",
+    "c8": "^10.1.3",
     "cross-env": "^10.1.0",
     "highlight.js": "^11.11.1",
     "marked": "^18.0.2",