pdfnative 1.0.4 → 1.0.5

package/README.md

@@ -10,6 +10,8 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![npm provenance](https://img.shields.io/badge/provenance-signed-blueviolet)](https://docs.npmjs.com/generating-provenance-statements)
 [![website](https://img.shields.io/badge/pdfnative.dev-0066FF?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxyZWN0IHg9IjMiIHk9IjIiIHdpZHRoPSIxNCIgaGVpZ2h0PSIxOCIgcng9IjIiIGZpbGw9Im5vbmUiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMS41Ii8+PHBhdGggZD0iTTcgN2g2TTcgMTFoOE03IDE1aDQiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMS41IiBzdHJva2UtbGluZWNhcD0icm91bmQiLz48L3N2Zz4=)](https://pdfnative.dev)
+[![pdfnative-mcp](https://img.shields.io/npm/v/pdfnative-mcp?label=pdfnative-mcp&color=6366f1)](https://www.npmjs.com/package/pdfnative-mcp)
+[![pdfnative-cli](https://img.shields.io/npm/v/pdfnative-cli?label=pdfnative-cli&color=0e7490)](https://www.npmjs.com/package/pdfnative-cli)
 
 Pure native PDF generation library — zero vendor dependencies. ISO 32000-1 (PDF 1.7) compliant.
 
@@ -44,6 +46,8 @@ Pure native PDF generation library — zero vendor dependencies. ISO 32000-1 (PD
 - **NPM provenance** — signed builds via GitHub Actions OIDC
 - **On-device generation** — runs in Node, browsers, Workers, Deno, Bun. No SaaS round-trip; documents never leave the calling process unless your application explicitly sends them
 - **No telemetry, no network calls** — verifiable in source. The library never opens a socket, fetches remote fonts, or phones home
+- **AI client integration** — use pdfnative from Claude Desktop, Cursor, Continue, and Zed via [`pdfnative-mcp`](https://github.com/Nizoka/pdfnative-mcp)
+- **Command-line interface** — render, sign, and inspect PDFs from the shell with [`pdfnative-cli`](https://github.com/Nizoka/pdfnative-cli) — zero-config, scriptable, ideal for CI/CD pipelines
 
 ## Installation
 
@@ -804,6 +808,66 @@ const pdf = buildPDFBytes(params, { compress: true });
 | `PAGE_SIZES` | Preset page dimensions (A4, Letter, Legal, A3, Tabloid) |
 | `resolveTemplate(tpl, page, pages, title, date)` | Resolve header/footer template placeholders |
 
+## Ecosystem
+
+pdfnative ships as a library, but two official companion packages cover the most common non-library use cases. Both live in separate repositories and depend on `pdfnative` only through the public API.
+
+### pdfnative-cli — command-line interface
+
+[`pdfnative-cli`](https://github.com/Nizoka/pdfnative-cli) is the **official CLI**. It exposes three commands — `render`, `sign`, `inspect` — for use in shell scripts, Makefiles, GitHub Actions, and Docker images. Zero extra runtime dependencies, npm-provenance-signed.
+
+```bash
+# render a JSON document spec to PDF
+npx pdfnative-cli render document.json --output report.pdf
+
+# sign an existing PDF (RSA or ECDSA, CMS/PKCS#7)
+npx pdfnative-cli sign report.pdf --cert cert.pem --key key.pem --output signed.pdf
+
+# inspect a PDF (page count, metadata, fonts, signatures)
+npx pdfnative-cli inspect signed.pdf
+```
+
+See the [CLI Guide](https://pdfnative.dev/guides/cli.html) for full reference, security model, and pipeline examples.
+
+### pdfnative-mcp — Model Context Protocol server
+
+[`pdfnative-mcp`](https://github.com/Nizoka/pdfnative-mcp) is a **Model Context Protocol server** that bridges pdfnative to any MCP-compatible AI client. Once configured, your AI assistant can generate PDFs, embed barcodes, create forms, sign documents, and render international text — all without writing code.
+
+```bash
+npx -y pdfnative-mcp
+```
+
+### Available tools
+
+| Tool | Purpose |
+|------|---------|
+| `generate_basic_pdf` | Multi-page documents from structured blocks (headings, paragraphs, lists) |
+| `add_table` | Tabular reports from column headers and data rows |
+| `add_barcode` | QR Code, Code 128, EAN-13, Data Matrix, PDF417 |
+| `add_international_text` | 16 non-Latin scripts with BiDi & OpenType shaping |
+| `add_form` | Interactive AcroForm PDFs (text, checkbox, radio, dropdown) |
+| `embed_image` | Embed a JPEG or PNG image (base64) |
+| `prepare_signature_placeholder` | PDF with a `/Sig` field ready to be signed |
+| `sign_pdf` | CMS/PKCS#7 digital signatures (RSA-SHA256 / ECDSA-SHA256) |
+
+### Claude Desktop configuration
+
+```json
+{
+  "mcpServers": {
+    "pdfnative": {
+      "command": "npx",
+      "args": ["-y", "pdfnative-mcp"],
+      "env": {
+        "PDFNATIVE_MPC_OUTPUT_DIR": "/Users/you/Documents/mcp-pdfs"
+      }
+    }
+  }
+}
+```
+
+See the [MCP Integration Guide](https://pdfnative.dev/guides/mcp.html) and the [pdfnative-mcp repository](https://github.com/Nizoka/pdfnative-mcp) for configuration on Cursor, Continue, Zed, and more.
+
 ## Architecture
 
 ```

package/dist/index.cjs

@@ -5501,6 +5501,7 @@ var DEFAULT_TEXT_COLOR = "0.75 0.75 0.75";
 var DEFAULT_TEXT_OPACITY = 0.15;
 var DEFAULT_TEXT_ANGLE = -45;
 var DEFAULT_IMAGE_OPACITY = 0.1;
+var DEFAULT_CAP_HEIGHT_RATIO = 0.718;
 function validateWatermark(watermark, pdfaLevel) {
   if (pdfaLevel === "pdfa1b") {
     const textOpacity = watermark.text?.opacity ?? DEFAULT_TEXT_OPACITY;
@@ -5555,10 +5556,12 @@ function _buildTextWatermarkOps(wm, pgW, pgH, enc, gsName) {
   const cy = pgH / 2;
   const textWidth = enc.tw(wm.text, sz);
   const offsetX = -textWidth / 2;
-  const offsetY = -sz / 2;
+  const fd = enc.fontData;
+  const capHeightRatio = fd ? fd.metrics.capHeight / fd.metrics.unitsPerEm : DEFAULT_CAP_HEIGHT_RATIO;
+  const offsetY = -sz * capHeightRatio / 2;
   const tx = cx + offsetX * cos - offsetY * sin;
   const ty = cy + offsetX * sin + offsetY * cos;
-  const escapedText = pdfString(wm.text);
+  const escapedText = enc.ps(wm.text);
   const ops = [
     "q",
     `${gsName} gs`,