@broadpaper/pdf 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,55 @@
+# @broadpaper/pdf
+
+[![npm](https://img.shields.io/npm/v/@broadpaper/pdf?color=171511&label=npm)](https://www.npmjs.com/package/@broadpaper/pdf)
+[![Licence: commercial](https://img.shields.io/badge/licence-commercial-171511)](https://www.broadpaper.com/legal/terms/)
+[![Free to evaluate](https://img.shields.io/badge/evaluate-free%2C%20no%20trial%20clock-4a453c)](https://www.broadpaper.com/docs/guide/licensing/)
+
+Chromium-backed PDF generation for BroadPaper, via Playwright. The fidelity reference.
+
+Part of [**BroadPaper**](https://www.broadpaper.com/developers/) — an embeddable visual report designer and PDF renderer.
+Your users design the report in your application; BroadPaper owns the layout, the branding,
+the pagination and the output.
+
+## Install
+
+```bash
+npm install @broadpaper/pdf
+```
+
+Renders through a real browser. This is the backend to reach for when you need Chromium's
+exact typesetting, or when you are comparing output against what a browser would print;
+[`@broadpaper/forme`](https://www.npmjs.com/package/@broadpaper/forme) is the one to deploy,
+because it needs no browser on the server.
+
+Playwright is a peer dependency, so installing this package does not drag a browser download
+into an application that only wanted the designer.
+
+## Licensing
+
+BroadPaper is **free to evaluate, with no trial clock and nothing behind a feature gate**.
+Install it, use every feature and evaluate it against your real data for as long as you like.
+Production use needs a licence.
+
+In the software, the only difference without a licence is that generated PDFs carry an
+evaluation mark, and a licence removes it. Contractually, the licence is also what permits
+production use. No seats, no activation, no machine binding, no telemetry, and no call home at
+any point.
+
+- [How licensing works](https://www.broadpaper.com/docs/guide/licensing/)
+- [Pricing](https://www.broadpaper.com/developers/pricing/)
+- [Licence agreement](https://www.broadpaper.com/legal/terms/)
+
+## Documentation
+
+- [The Chromium backend](https://www.broadpaper.com/docs/guide/pdf)
+- [Browserless PDF](https://www.broadpaper.com/docs/guide/browserless-pdf)
+- [Full documentation](https://www.broadpaper.com/docs/)
+
+## Support
+
+Paid licences include email support at [support@broadpaper.com](mailto:support@broadpaper.com).
+
+---
+
+Copyright © 2026 Codingbadger Creative Limited. See [LICENSE](./LICENSE) in this package, and
+[THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for the components it ships with.

package/dist/{chunk-PFCVDSUU.js → chunk-AAE2MQRQ.js}

@@ -865,11 +865,25 @@ import { dirname, join } from "path";
 // src/server/watermark.ts
 async function stampWatermark(doc, spec) {
   const { StandardFonts, degrees, rgb } = await import("pdf-lib");
-  const font = await doc.embedFont(StandardFonts.HelveticaBold);
+  const font = await doc.embedFont((spec.placement ?? "center") === "bottom" ? StandardFonts.Helvetica : StandardFonts.HelveticaBold);
   const color = hexToRgb(spec.color);
   const radians = spec.angle * Math.PI / 180;
   const width = font.widthOfTextAtSize(spec.text, spec.fontSize);
   const height = font.heightAtSize(spec.fontSize);
+  if ((spec.placement ?? "center") === "bottom") {
+    for (const page of doc.getPages()) {
+      const { width: pw } = page.getSize();
+      page.drawText(spec.text, {
+        x: (pw - width) / 2,
+        y: spec.fontSize * 1.2,
+        size: spec.fontSize,
+        font,
+        color: rgb(color.r, color.g, color.b),
+        opacity: spec.opacity
+      });
+    }
+    return;
+  }
   for (const page of doc.getPages()) {
     const { width: pw, height: ph } = page.getSize();
     const x = pw / 2 - Math.cos(radians) * width / 2 + Math.sin(radians) * height / 2;
@@ -974,7 +988,7 @@ var PdfRenderer = class {
         outline: opts.outline ?? true
       });
       const license = await resolveLicenseStatus(opts.license !== void 0 ? { license: opts.license } : {});
-      const finished = await applyMetadata(pdf, opts.metadata, opts.now, license);
+      const finished = await applyMetadata(pdf, opts.metadata, opts.now, license, opts.watermark);
       return { pdf: finished, pages: result.pages, warnings: result.warnings, durationMs: Date.now() - started };
     } catch (e) {
       if (e instanceof PdfRenderError) throw e;
@@ -984,13 +998,12 @@ var PdfRenderer = class {
     }
   }
 };
-async function applyMetadata(pdf, meta, now, license) {
+async function applyMetadata(pdf, meta, now, license, extraWatermark) {
   const { PDFDocument } = await import("pdf-lib");
   const status = license ?? await resolveLicenseStatus();
   const doc = await PDFDocument.load(pdf, { updateMetadata: false });
   const when = meta?.creationDate ?? now ?? /* @__PURE__ */ new Date();
-  const mark = watermarkFor(status);
-  if (mark) await stampWatermark(doc, mark);
+  for (const mark of [watermarkFor(status), extraWatermark]) if (mark) await stampWatermark(doc, mark);
   doc.setProducer(producerString(status));
   doc.setCreator("BroadPaper");
   doc.setCreationDate(when);
@@ -1172,4 +1185,4 @@ export {
 @noble/ed25519/index.js:
   (*! noble-ed25519 - MIT License (c) 2019 Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=chunk-PFCVDSUU.js.map
+//# sourceMappingURL=chunk-AAE2MQRQ.js.map