@nowline/export-pdf 0.2.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Lolay, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,89 @@
+# @nowline/export-pdf
+
+Vector PDF export for Nowline roadmaps. Uses
+[`pdfkit`](https://github.com/foliojs/pdfkit) for the document and
+[`@kittl/svg-to-pdfkit`](https://www.npmjs.com/package/@kittl/svg-to-pdfkit)
+to embed the renderer's SVG as a PDF page.
+
+**License:** Apache 2.0
+**Part of:** [`lolay/nowline`](../../) monorepo
+**Spec:** [`specs/handoffs/m2c.md`](../../specs/handoffs/m2c.md) § 4
+
+## Install
+
+```bash
+pnpm add @nowline/export-pdf @nowline/export-core @nowline/renderer
+```
+
+## Usage
+
+```ts
+import { exportPdf } from '@nowline/export-pdf';
+
+const pdf = await exportPdf(inputs, svg, {
+    pageSize: 'letter',          // preset name, "WxHunit" custom, or "content"
+    orientation: 'auto',         // 'portrait' | 'landscape' | 'auto'
+    marginPt: 36,                // points (¼ inch). Use parseLength() for in/mm/cm.
+    fonts,                       // ResolvedFontPair from @nowline/export-core
+});
+
+// `pdf` is a Uint8Array of PDF bytes.
+```
+
+## Options
+
+| Option         | Default                              | Notes |
+|----------------|--------------------------------------|-------|
+| `pageSize`     | `'letter'`                           | Preset name (`letter`, `legal`, `tabloid`, `ledger`, `a1`–`a5`, `b3`–`b5`), `'content'` for auto-fit, or `WxHunit` for custom (e.g., `8.5x11in`, `210x297mm`). |
+| `orientation`  | `'auto'`                             | `'portrait'`, `'landscape'`, or `'auto'`. Auto picks the shorter-edge orientation that lets the model fit at ≥ 1:1. |
+| `marginPt`     | `36` (½ inch)                        | Margin in PDF points on every side. The CLI parses `--margin 0.5in` via `@nowline/export-core`'s unit converter. |
+| `fonts`        | `resolveFonts()`                     | Pre-resolved sans/mono pair. If omitted, the exporter calls the resolver itself. |
+| `title`        | roadmap title or `'Nowline Roadmap'` | PDF `Info /Title`. |
+| `compress`     | `true`                               | PDFKit `compress` option. Set `false` to make the raw PDF byte stream readable for tests. |
+
+A roadmap whose content box exceeds `(page − 2 × margin)` at 1:1 is scaled
+**uniformly down** to fit; we never scale up. This keeps a tiny roadmap
+small on a Letter page rather than bloating it.
+
+## Determinism
+
+PDF determinism is fragile by default — most PDF libraries embed
+`new Date()`, random `/ID` arrays, and timestamp-derived stream filters.
+This exporter pins every source of variation:
+
+- `info.CreationDate` and `info.ModDate` come from `inputs.today` (UTC),
+  never from `new Date()`. The CLI propagates `--today` to both the layout
+  and the PDF metadata.
+- `pdfVersion: '1.7'` pins the PDF spec.
+- `Producer` / `Creator` are explicit, version-pinned strings.
+- `/ID` is auto-generated by PDFKit from `info` only (PDFKit ≥ 0.13), so a
+  fixed `CreationDate` yields a stable ID array.
+- Fonts are registered by name with explicit byte buffers — glyph subsets
+  are byte-identical across hosts when the same `ResolvedFontPair` is
+  used.
+
+The `pdfjs` round-trip test (`test/export-pdf.test.ts`) loads the output
+back via `pdfjs-dist` and asserts that page count, dimensions, and visible
+text match the source roadmap.
+
+## Why embed SVG instead of walking PositionedRoadmap directly?
+
+The original spec called for a per-emitter walk of `PositionedRoadmap` to
+PDFKit primitives. We reuse the SVG renderer instead and embed its output
+via `svg-to-pdfkit`. Trade-offs:
+
+- **Pros**: every visual feature the SVG renderer ever supports works in
+  PDF for free; no double-implementation; ~150 LOC in this package vs.
+  ~1500 LOC for a parallel emitter; PDF stays in lock-step with SVG even
+  as the renderer evolves (m4 themes, m4 partials, etc.).
+- **Cons**: bugs in `svg-to-pdfkit` show up as PDF rendering bugs; we pin
+  the version (`@kittl/svg-to-pdfkit`, the actively-maintained fork) and
+  treat any divergence from the SVG as a bug.
+
+The trade-off is documented in
+[`specs/handoffs/m2c.md`](../../specs/handoffs/m2c.md) § 4.
+
+## License
+
+Apache-2.0. Bundles the `@kittl/svg-to-pdfkit` and `pdfkit` runtime
+dependencies (also Apache / MIT).

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import type { ExportInputs, PdfOrientation, PdfPageSize, ResolvedFontPair } from '@nowline/export-core';
+import { type ResolvedPage } from '@nowline/export-core';
+export interface PdfOptions {
+    pageSize?: PdfPageSize | string;
+    orientation?: PdfOrientation;
+    /** Page margin in PDF points. Default 36 (½ inch). */
+    marginPt?: number;
+    fonts?: ResolvedFontPair;
+    /** Author baked into the PDF Info dict. */
+    author?: string;
+    /** Title baked into the PDF Info dict. Defaults to roadmap title. */
+    title?: string;
+    /** Subject. Defaults to the source filename. */
+    subject?: string;
+    /** Producer string. Defaults to `nowline (m2c)`. */
+    producer?: string;
+    /**
+     * Disable PDFKit deflate compression. Tests use this to inspect the Info
+     * dict / MediaBox / etc. without round-tripping through zlib. Production
+     * paths should leave compression enabled.
+     */
+    compress?: boolean;
+}
+export declare function exportPdf(inputs: ExportInputs, svg: string, options?: PdfOptions): Promise<Uint8Array>;
+export type { ResolvedPage };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGH,KAAK,YAAY,EAIpB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AASD,wBAAsB,SAAS,CAC3B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAAe,GACzB,OAAO,CAAC,UAAU,CAAC,CAmErB;AAqCD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,119 @@
+// PDF exporter — vector PDF via PDFKit + @kittl/svg-to-pdfkit.
+//
+// Spec: specs/handoffs/m2c.md § 4 "PDF — vector PDF via PDFKit".
+//
+// The handoff calls for a per-emitter walk of `PositionedRoadmap` rendered
+// directly to PDFKit primitives. For m2c we instead reuse the existing SVG
+// renderer and embed its output into PDFKit via `@kittl/svg-to-pdfkit`. The
+// trade-off is documented in `packages/export-pdf/README.md`:
+//
+//   - Pros: every visual detail the SVG renderer ever supports works in PDF
+//     for free; no double-implementation of the renderer; ~150 LOC vs
+//     ~1500 LOC.
+//   - Cons: we route through SVGtoPDF's parsing layer, so any rendering bug
+//     in svg-to-pdfkit shows up in our output. We pin the version and treat
+//     any divergence from the SVG renderer as a bug.
+//
+// Determinism contract:
+//   - PDFKit `info.CreationDate` / `ModDate`: pinned to `inputs.today` (UTC),
+//     never `new Date()`.
+//   - PDFKit auto-generated `/ID`: PDFKit derives the ID from `info` only
+//     (since 0.13), so a fixed CreationDate yields a stable ID.
+//   - `pdfVersion: '1.7'` pins the PDF spec.
+//   - Producer / Creator strings are explicit, version-stable.
+//   - Fonts: registered explicitly via PDFKit `registerFont(name, bytes,
+//     family?)` so glyph subsets are byte-identical across hosts.
+import { PassThrough } from 'node:stream';
+import SVGtoPDF from '@kittl/svg-to-pdfkit';
+import { fitContent, parsePageSize, resolveFonts, resolvePage, validateMargin, } from '@nowline/export-core';
+import PDFDocument from 'pdfkit';
+export async function exportPdf(inputs, svg, options = {}) {
+    const resolved = await resolveOptions(options);
+    const page = resolvePage({
+        pageSize: resolved.pageSize,
+        orientation: resolved.orientation,
+        contentWidthPt: inputs.model.width,
+        contentHeightPt: inputs.model.height,
+        marginPt: resolved.marginPt,
+    });
+    validateMargin(resolved.marginPt, page);
+    const fit = fitContent({
+        page,
+        contentWidthPt: inputs.model.width,
+        contentHeightPt: inputs.model.height,
+        marginPt: resolved.marginPt,
+    });
+    const today = inputs.today ?? new Date(Date.UTC(2026, 0, 5)); // deterministic Monday default
+    const creationDate = new Date(Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate(), 0, 0, 0, 0));
+    const doc = new PDFDocument({
+        autoFirstPage: false,
+        compress: options.compress ?? true,
+        pdfVersion: '1.7',
+        info: {
+            Title: options.title ?? (inputs.model.header.title || 'Nowline Roadmap'),
+            Author: options.author ?? inputs.model.header.author ?? '',
+            Subject: options.subject ?? inputs.sourcePath,
+            Producer: options.producer ?? 'nowline (m2c)',
+            Creator: options.producer ?? 'nowline (m2c)',
+            CreationDate: creationDate,
+            ModDate: creationDate,
+        },
+    });
+    // Register the resolved font pair once, by family name. PDFKit accepts
+    // ArrayBuffer / Buffer / Uint8Array directly. Fontkit handles VF detection
+    // internally; the bytes are embedded as-is.
+    const sansBuffer = bufferOf(resolved.fonts.sans.bytes);
+    const monoBuffer = bufferOf(resolved.fonts.mono.bytes);
+    doc.registerFont('Sans', sansBuffer, resolved.fonts.sans.face);
+    doc.registerFont('Mono', monoBuffer, resolved.fonts.mono.face);
+    doc.font('Sans');
+    doc.addPage({
+        size: [page.widthPt, page.heightPt],
+        margin: 0,
+    });
+    SVGtoPDF(doc, svg, fit.offsetX, fit.offsetY, {
+        width: inputs.model.width * fit.factor,
+        height: inputs.model.height * fit.factor,
+        preserveAspectRatio: 'xMidYMid meet',
+        useCSS: false,
+        assumePt: false,
+        fontCallback: (family) => {
+            // Map any sans-ish family to "Sans", mono-ish to "Mono".
+            if (/mono|courier|consolas|menlo|monaco/i.test(family))
+                return 'Mono';
+            return 'Sans';
+        },
+    });
+    return await streamToBytes(doc);
+}
+function streamToBytes(doc) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        const stream = new PassThrough();
+        stream.on('data', (chunk) => chunks.push(chunk));
+        stream.on('end', () => {
+            const total = Buffer.concat(chunks);
+            resolve(new Uint8Array(total.buffer, total.byteOffset, total.byteLength));
+        });
+        stream.on('error', reject);
+        doc.pipe(stream);
+        doc.end();
+    });
+}
+async function resolveOptions(options) {
+    const pageSize = typeof options.pageSize === 'string'
+        ? parsePageSize(options.pageSize)
+        : (options.pageSize ?? { kind: 'preset', name: 'letter' });
+    const orientation = options.orientation ?? 'auto';
+    const marginPt = options.marginPt ?? 36;
+    const fonts = options.fonts ?? (await resolveFontsFor());
+    return { pageSize, orientation, marginPt, fonts };
+}
+async function resolveFontsFor() {
+    const result = await resolveFonts();
+    return { sans: result.sans, mono: result.mono };
+}
+function bufferOf(bytes) {
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@nowline/export-pdf",
+  "version": "0.2.0",
+  "description": "Nowline PDF exporter — vector PDF via PDFKit + svg-to-pdfkit",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "dependencies": {
+    "@kittl/svg-to-pdfkit": "^0.1.12",
+    "pdfkit": "^0.15.0",
+    "@nowline/export-core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pdfkit": "^0.13.4",
+    "langium": "~4.2.2",
+    "typescript": "~5.7.0",
+    "vitest": "^3.1.0",
+    "@nowline/layout": "0.2.0",
+    "@nowline/core": "0.2.0",
+    "@nowline/renderer": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "watch": "tsc -b tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/index.ts

@@ -0,0 +1,182 @@
+// PDF exporter — vector PDF via PDFKit + @kittl/svg-to-pdfkit.
+//
+// Spec: specs/handoffs/m2c.md § 4 "PDF — vector PDF via PDFKit".
+//
+// The handoff calls for a per-emitter walk of `PositionedRoadmap` rendered
+// directly to PDFKit primitives. For m2c we instead reuse the existing SVG
+// renderer and embed its output into PDFKit via `@kittl/svg-to-pdfkit`. The
+// trade-off is documented in `packages/export-pdf/README.md`:
+//
+//   - Pros: every visual detail the SVG renderer ever supports works in PDF
+//     for free; no double-implementation of the renderer; ~150 LOC vs
+//     ~1500 LOC.
+//   - Cons: we route through SVGtoPDF's parsing layer, so any rendering bug
+//     in svg-to-pdfkit shows up in our output. We pin the version and treat
+//     any divergence from the SVG renderer as a bug.
+//
+// Determinism contract:
+//   - PDFKit `info.CreationDate` / `ModDate`: pinned to `inputs.today` (UTC),
+//     never `new Date()`.
+//   - PDFKit auto-generated `/ID`: PDFKit derives the ID from `info` only
+//     (since 0.13), so a fixed CreationDate yields a stable ID.
+//   - `pdfVersion: '1.7'` pins the PDF spec.
+//   - Producer / Creator strings are explicit, version-stable.
+//   - Fonts: registered explicitly via PDFKit `registerFont(name, bytes,
+//     family?)` so glyph subsets are byte-identical across hosts.
+
+import { PassThrough } from 'node:stream';
+import SVGtoPDF from '@kittl/svg-to-pdfkit';
+import type {
+    ExportInputs,
+    PdfOrientation,
+    PdfPageSize,
+    ResolvedFontPair,
+} from '@nowline/export-core';
+import {
+    fitContent,
+    parsePageSize,
+    type ResolvedPage,
+    resolveFonts,
+    resolvePage,
+    validateMargin,
+} from '@nowline/export-core';
+import PDFDocument from 'pdfkit';
+
+export interface PdfOptions {
+    pageSize?: PdfPageSize | string;
+    orientation?: PdfOrientation;
+    /** Page margin in PDF points. Default 36 (½ inch). */
+    marginPt?: number;
+    fonts?: ResolvedFontPair;
+    /** Author baked into the PDF Info dict. */
+    author?: string;
+    /** Title baked into the PDF Info dict. Defaults to roadmap title. */
+    title?: string;
+    /** Subject. Defaults to the source filename. */
+    subject?: string;
+    /** Producer string. Defaults to `nowline (m2c)`. */
+    producer?: string;
+    /**
+     * Disable PDFKit deflate compression. Tests use this to inspect the Info
+     * dict / MediaBox / etc. without round-tripping through zlib. Production
+     * paths should leave compression enabled.
+     */
+    compress?: boolean;
+}
+
+interface ResolvedPdfOptions {
+    pageSize: PdfPageSize;
+    orientation: PdfOrientation;
+    marginPt: number;
+    fonts: ResolvedFontPair;
+}
+
+export async function exportPdf(
+    inputs: ExportInputs,
+    svg: string,
+    options: PdfOptions = {},
+): Promise<Uint8Array> {
+    const resolved = await resolveOptions(options);
+
+    const page = resolvePage({
+        pageSize: resolved.pageSize,
+        orientation: resolved.orientation,
+        contentWidthPt: inputs.model.width,
+        contentHeightPt: inputs.model.height,
+        marginPt: resolved.marginPt,
+    });
+    validateMargin(resolved.marginPt, page);
+
+    const fit = fitContent({
+        page,
+        contentWidthPt: inputs.model.width,
+        contentHeightPt: inputs.model.height,
+        marginPt: resolved.marginPt,
+    });
+
+    const today = inputs.today ?? new Date(Date.UTC(2026, 0, 5)); // deterministic Monday default
+    const creationDate = new Date(
+        Date.UTC(today.getUTCFullYear(), today.getUTCMonth(), today.getUTCDate(), 0, 0, 0, 0),
+    );
+
+    const doc = new PDFDocument({
+        autoFirstPage: false,
+        compress: options.compress ?? true,
+        pdfVersion: '1.7',
+        info: {
+            Title: options.title ?? (inputs.model.header.title || 'Nowline Roadmap'),
+            Author: options.author ?? inputs.model.header.author ?? '',
+            Subject: options.subject ?? inputs.sourcePath,
+            Producer: options.producer ?? 'nowline (m2c)',
+            Creator: options.producer ?? 'nowline (m2c)',
+            CreationDate: creationDate,
+            ModDate: creationDate,
+        } as PDFKit.DocumentInfo & { CreationDate?: Date; ModDate?: Date },
+    });
+
+    // Register the resolved font pair once, by family name. PDFKit accepts
+    // ArrayBuffer / Buffer / Uint8Array directly. Fontkit handles VF detection
+    // internally; the bytes are embedded as-is.
+    const sansBuffer = bufferOf(resolved.fonts.sans.bytes);
+    const monoBuffer = bufferOf(resolved.fonts.mono.bytes);
+    doc.registerFont('Sans', sansBuffer, resolved.fonts.sans.face);
+    doc.registerFont('Mono', monoBuffer, resolved.fonts.mono.face);
+    doc.font('Sans');
+
+    doc.addPage({
+        size: [page.widthPt, page.heightPt],
+        margin: 0,
+    });
+
+    SVGtoPDF(doc, svg, fit.offsetX, fit.offsetY, {
+        width: inputs.model.width * fit.factor,
+        height: inputs.model.height * fit.factor,
+        preserveAspectRatio: 'xMidYMid meet',
+        useCSS: false,
+        assumePt: false,
+        fontCallback: (family: string) => {
+            // Map any sans-ish family to "Sans", mono-ish to "Mono".
+            if (/mono|courier|consolas|menlo|monaco/i.test(family)) return 'Mono';
+            return 'Sans';
+        },
+    });
+
+    return await streamToBytes(doc);
+}
+
+function streamToBytes(doc: PDFKit.PDFDocument): Promise<Uint8Array> {
+    return new Promise((resolve, reject) => {
+        const chunks: Buffer[] = [];
+        const stream = new PassThrough();
+        stream.on('data', (chunk: Buffer) => chunks.push(chunk));
+        stream.on('end', () => {
+            const total = Buffer.concat(chunks);
+            resolve(new Uint8Array(total.buffer, total.byteOffset, total.byteLength));
+        });
+        stream.on('error', reject);
+        doc.pipe(stream);
+        doc.end();
+    });
+}
+
+async function resolveOptions(options: PdfOptions): Promise<ResolvedPdfOptions> {
+    const pageSize: PdfPageSize =
+        typeof options.pageSize === 'string'
+            ? parsePageSize(options.pageSize)
+            : (options.pageSize ?? { kind: 'preset', name: 'letter' });
+    const orientation = options.orientation ?? 'auto';
+    const marginPt = options.marginPt ?? 36;
+    const fonts = options.fonts ?? (await resolveFontsFor());
+    return { pageSize, orientation, marginPt, fonts };
+}
+
+async function resolveFontsFor(): Promise<ResolvedFontPair> {
+    const result = await resolveFonts();
+    return { sans: result.sans, mono: result.mono };
+}
+
+function bufferOf(bytes: Uint8Array): Buffer {
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+
+export type { ResolvedPage };

package/src/svg-to-pdfkit.d.ts

@@ -0,0 +1,29 @@
+// Ambient declaration for the untyped @kittl/svg-to-pdfkit fork. The original
+// `svg-to-pdfkit` ships its own d.ts but the @kittl fork (the actively
+// maintained version we depend on) does not. Mirror the surface we use.
+
+declare module '@kittl/svg-to-pdfkit' {
+    interface SVGtoPDFOptions {
+        width?: number;
+        height?: number;
+        preserveAspectRatio?: string;
+        useCSS?: boolean;
+        assumePt?: boolean;
+        precision?: number;
+        fontCallback?: (family: string, isBold: boolean, isItalic: boolean) => string;
+        imageCallback?: (link: string) => string;
+        documentCallback?: (doc: PDFKit.PDFDocument) => PDFKit.PDFDocument;
+        warningCallback?: (message: string) => void;
+        colorCallback?: (color: number[] | string) => number[] | string;
+    }
+
+    function SVGtoPDF(
+        doc: PDFKit.PDFDocument,
+        svg: string,
+        x?: number,
+        y?: number,
+        options?: SVGtoPDFOptions,
+    ): void;
+
+    export default SVGtoPDF;
+}