pdfnative 1.0.2 → 1.0.4

package/README.md

@@ -42,6 +42,8 @@ Pure native PDF generation library — zero vendor dependencies. ISO 32000-1 (PD
 - **Tree-shakeable** — ESM + CJS dual build with TypeScript declarations
 - **95%+ test coverage** — 1588+ tests across 40 files, fuzz suite, performance benchmarks
 - **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
 
 ## Installation
 
@@ -51,6 +53,17 @@ npm install pdfnative
 
 **Requirements:** Node.js >= 22 | Modern browsers | Deno | Bun
 
+## Documentation
+
+- 🌐 **Website:** [pdfnative.dev](https://pdfnative.dev) — landing page, live in-browser demo with 10 examples, comparisons, benchmarks.
+- 📘 **Quick Start:** [docs/guides/quickstart.md](docs/guides/quickstart.md) — Node.js, browser, Web Worker, streaming.
+- 🏛️ **Architecture:** [docs/guides/architecture.md](docs/guides/architecture.md) — modules, builders, generation pipeline.
+- ♿ **Accessibility:** [docs/guides/accessibility.md](docs/guides/accessibility.md) — tagged PDF, PDF/UA, PDF/A.
+- ❓ **FAQ:** [docs/guides/faq.md](docs/guides/faq.md) — fonts, encryption, signatures, comparisons.
+- 🛠️ **Troubleshooting:** [docs/guides/troubleshooting.md](docs/guides/troubleshooting.md) — common pitfalls.
+- 🎮 **Playgrounds:** [docs/playgrounds/extreme-scripts.html](docs/playgrounds/extreme-scripts.html) (live BiDi/Indic stress tests) and [docs/playgrounds/medical-800.html](docs/playgrounds/medical-800.html) (800-page Web Worker showcase).
+- 🧪 **Sample PDFs:** [scripts/generators/](scripts/generators/) — ~140 sample PDFs across 23 categories (see [Sample PDFs](#sample-pdfs) below).
+
 ## Why pdfnative?
 
 pdfnative was designed for teams that need **ISO-compliant, production-grade PDF generation** with zero supply-chain risk. Here is how it compares to other popular JavaScript PDF libraries:
@@ -344,6 +357,8 @@ The tool extracts cmap, widths, metrics, GSUB, GPOS, and embeds the raw TTF as b
 
 ## Visual PDF Inspection
 
+<a id="sample-pdfs"></a>
+
 Generate sample PDFs for all supported languages to visually verify output:
 
 ```bash
@@ -466,6 +481,9 @@ See [scripts/README.md](scripts/README.md) for the modular generator architectur
 | `doc-arabic.pdf` | Arabic RTL document (headings, lists, table, BiDi) |
 | `doc-hebrew.pdf` | Hebrew RTL document (headings, lists, table, BiDi) |
 | `doc-thai.pdf` | Thai user manual (GSUB+GPOS shaping, pricing table) |
+| `doc-bengali.pdf` | Bengali document (GSUB conjuncts + GPOS marks) |
+| `doc-tamil.pdf` | Tamil document (GSUB substitution + split vowels) |
+| `doc-devanagari.pdf` | Hindi (Devanagari) document — GSUB conjuncts, reph reordering, matra reordering, split vowels |
 | `doc-chinese-catalog.pdf` | Chinese product catalog (tables, ordering info) |
 | `doc-multi-language.pdf` | Multi-language: EN + Arabic + Japanese in one PDF |
 | `doc-invoice.pdf` | Invoice template (line items, totals, payment link) |
@@ -928,6 +946,18 @@ When `tagged` is set, the output includes:
 
 The `tagged` option is backward-compatible — omitting it or setting `false` produces the same output as before.
 
+> **PDF/A status (v1.0.4).** As of v1.0.4 every PDF emits a trailer
+> `/ID` and the `/Info CreationDate` is byte-equivalent to the
+> `xmp:CreateDate` (with timezone offset) — closing two veraPDF
+> reference-validator findings. **Latin font embedding** is **not yet
+> implemented**: standard 14 Helvetica is still emitted as an
+> unembedded reference, which veraPDF flags under ISO 19005-1 §6.3.4.
+> Treat the `pdfaid:part` claim in XMP as aspirational until **v1.0.5**
+> lands. See [docs/guides/pdfa.html](docs/guides/pdfa.html) and the
+> tracking issue [release-notes/draft-issue-v1.0.5-latin-embedding.md](release-notes/draft-issue-v1.0.5-latin-embedding.md).
+> Run `npm run validate:pdfa` locally (with veraPDF installed) to
+> verify against the reference validator.
+
 ### PDF Encryption — Implemented ✅
 
 AES-128 and AES-256 encryption with owner/user passwords and granular permissions:
@@ -1077,6 +1107,19 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for:
 - Code style requirements (strict TypeScript, pure functions, ESM-first)
 - Branch strategy and PR process
 
+## Citing pdfnative
+
+If you use pdfnative in academic, governmental, or compliance work, please cite it. Citation metadata is available in [CITATION.cff](CITATION.cff).
+
+```bibtex
+@software{pdfnative,
+  author  = {Nizoka},
+  title   = {pdfnative: Zero-dependency, ISO 32000-1 compliant PDF generation for TypeScript},
+  url     = {https://github.com/Nizoka/pdfnative},
+  year    = {2026}
+}
+```
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

package/dist/index.cjs

@@ -4623,9 +4623,26 @@ function buildStructureTree(root, startObjNum, pageObjToStructParents) {
     totalObjects: nextObj - startObjNum
   };
 }
-function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B") {
+function buildPdfMetadata(now = /* @__PURE__ */ new Date()) {
+  const pad2 = (n) => String(n).padStart(2, "0");
+  const yyyy = now.getFullYear();
+  const mm = pad2(now.getMonth() + 1);
+  const dd = pad2(now.getDate());
+  const hh = pad2(now.getHours());
+  const mi = pad2(now.getMinutes());
+  const ss = pad2(now.getSeconds());
+  const tzMinutes = -now.getTimezoneOffset();
+  const tzSign = tzMinutes >= 0 ? "+" : "-";
+  const tzAbs = Math.abs(tzMinutes);
+  const tzH = pad2(Math.floor(tzAbs / 60));
+  const tzM = pad2(tzAbs % 60);
+  const pdfDate = `D:${yyyy}${mm}${dd}${hh}${mi}${ss}${tzSign}${tzH}'${tzM}'`;
+  const xmpDate = `${yyyy}-${mm}-${dd}T${hh}:${mi}:${ss}${tzSign}${tzH}:${tzM}`;
+  return { pdfDate, xmpDate };
+}
+function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B", author) {
   const escapedTitle = escapeXml(title);
-  return [
+  const lines = [
     '<?xpacket begin="\xEF\xBB\xBF" id="W5M0MpCehiHzreSzNTczkc9d"?>',
     '<x:xmpmeta xmlns:x="adobe:ns:meta/">',
     ' <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">',
@@ -4634,17 +4651,24 @@ function buildXMPMetadata(title, createDate, pdfaPart = 2, pdfaConformance = "B"
     '    xmlns:pdf="http://ns.adobe.com/pdf/1.3/"',
     '    xmlns:xmp="http://ns.adobe.com/xap/1.0/"',
     '    xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">',
-    `   <dc:title><rdf:Alt><rdf:li xml:lang="x-default">${escapedTitle}</rdf:li></rdf:Alt></dc:title>`,
-    "   <dc:creator><rdf:Seq><rdf:li>pdfnative</rdf:li></rdf:Seq></dc:creator>",
+    `   <dc:title><rdf:Alt><rdf:li xml:lang="x-default">${escapedTitle}</rdf:li></rdf:Alt></dc:title>`
+  ];
+  if (author !== void 0 && author !== "") {
+    lines.push(`   <dc:creator><rdf:Seq><rdf:li>${escapeXml(author)}</rdf:li></rdf:Seq></dc:creator>`);
+  }
+  lines.push(
     "   <pdf:Producer>pdfnative</pdf:Producer>",
     `   <xmp:CreateDate>${createDate}</xmp:CreateDate>`,
+    `   <xmp:ModifyDate>${createDate}</xmp:ModifyDate>`,
+    `   <xmp:MetadataDate>${createDate}</xmp:MetadataDate>`,
     `   <pdfaid:part>${pdfaPart}</pdfaid:part>`,
     `   <pdfaid:conformance>${pdfaConformance}</pdfaid:conformance>`,
     "  </rdf:Description>",
     " </rdf:RDF>",
     "</x:xmpmeta>",
     '<?xpacket end="w"?>'
-  ].join("\n");
+  );
+  return lines.join("\n");
 }
 function buildOutputIntentDict(iccStreamObjNum, subtype = "GTS_PDFA1") {
   return `<< /Type /OutputIntent /S /${subtype} /OutputConditionIdentifier (sRGB IEC61966-2.1) /RegistryName (http://www.color.org) /DestOutputProfile ${iccStreamObjNum} 0 R >>`;
@@ -5256,7 +5280,7 @@ endstream`);
     _offset += d;
   }, objOffsets, parts };
 }
-function writeXrefTrailer(w, totalObjs, infoObjNum, encState) {
+function writeXrefTrailer(w, totalObjs, infoObjNum, encState, idSeed = "") {
   let encryptObjNum = 0;
   if (encState) {
     encryptObjNum = totalObjs + 1;
@@ -5274,11 +5298,13 @@ function writeXrefTrailer(w, totalObjs, infoObjNum, encState) {
 `);
   }
   w.emit("trailer\n");
+  const docId = encState ? encState.docId : md5(new TextEncoder().encode(`pdfnative|${idSeed}|${totalObjs}`));
+  const idArray = buildIdArray(docId);
   if (encState) {
-    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /Encrypt ${encryptObjNum} 0 R /ID ${buildIdArray(encState.docId)} >>
+    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /Encrypt ${encryptObjNum} 0 R /ID ${idArray} >>
 `);
   } else {
-    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R >>
+    w.emit(`<< /Size ${totalObjs + 1} /Root 1 0 R /Info ${infoObjNum} 0 R /ID ${idArray} >>
 `);
   }
   w.emit("startxref\n");
@@ -6014,10 +6040,7 @@ function buildPDF(params, layoutOptions) {
   }
   const baseObjCount = enc.isUnicode ? 4 + fontEntries.length * 5 + wmExtraObjs + totalPages * 2 : 4 + wmExtraObjs + totalPages * 2;
   const infoObjNum = baseObjCount + 1;
-  const now = /* @__PURE__ */ new Date();
-  const pad2 = (n) => String(n).padStart(2, "0");
-  const pdfDate = `D:${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const isoDate = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}T${pad2(now.getHours())}:${pad2(now.getMinutes())}:${pad2(now.getSeconds())}`;
+  const { pdfDate, xmpDate: isoDate } = buildPdfMetadata();
   const infoTitle = params.docTitle || title || "";
   emitObj(
     infoObjNum,
@@ -6097,7 +6120,7 @@ endobj
     }
   }
   const writer = { emit, emitObj, emitStreamObj, offset: getOffset, adjustOffset, objOffsets, parts };
-  writeXrefTrailer(writer, totalObjs, infoObjNum, encState);
+  writeXrefTrailer(writer, totalObjs, infoObjNum, encState, `${infoTitle}|${pdfDate}`);
   return parts.join("");
 }
 function buildPDFBytes(params, layoutOptions) {
@@ -8444,6 +8467,22 @@ function tokenizeForWrap(text) {
   if (buf) segments.push(buf);
   return segments;
 }
+function hardBreakSegment(seg, maxWidth, fontSize, enc) {
+  const pieces = [];
+  let buf = "";
+  for (const ch of seg) {
+    const candidate = buf + ch;
+    const w = measureText(candidate, fontSize, enc);
+    if (w <= maxWidth || buf === "") {
+      buf = candidate;
+    } else {
+      pieces.push(buf);
+      buf = ch;
+    }
+  }
+  if (buf) pieces.push(buf);
+  return pieces.length > 0 ? pieces : [seg];
+}
 function wrapText(text, maxWidth, fontSize, enc) {
   if (!text) return [""];
   if (maxWidth <= 0) return [text];
@@ -8454,12 +8493,25 @@ function wrapText(text, maxWidth, fontSize, enc) {
   for (const seg of segments) {
     const candidate = currentLine + seg;
     const w = measureText(candidate, fontSize, enc);
-    if (w <= maxWidth || currentLine === "") {
+    if (w <= maxWidth) {
       currentLine = candidate;
-    } else {
+      continue;
+    }
+    if (currentLine !== "") {
       lines.push(currentLine.trimEnd());
-      currentLine = seg.trimStart();
+      currentLine = "";
     }
+    const segTrim = seg.trimStart();
+    const segW = measureText(segTrim, fontSize, enc);
+    if (segW <= maxWidth) {
+      currentLine = segTrim;
+      continue;
+    }
+    const pieces = hardBreakSegment(segTrim, maxWidth, fontSize, enc);
+    for (let pi = 0; pi < pieces.length - 1; pi++) {
+      lines.push(pieces[pi].trimEnd());
+    }
+    currentLine = pieces[pieces.length - 1];
   }
   if (currentLine) lines.push(currentLine.trimEnd());
   return lines;
@@ -9674,10 +9726,7 @@ function buildDocumentPDF(params, layoutOptions) {
   }
   const baseObjCount = enc.isUnicode ? 4 + fontEntries.length * 5 + imageCount + wmExtraObjs + totalPages * 2 + totalAnnots + totalFormObjs + formFontObjs : 4 + imageCount + wmExtraObjs + totalPages * 2 + totalAnnots + totalFormObjs + formFontObjs;
   const infoObjNum = baseObjCount + 1;
-  const now = /* @__PURE__ */ new Date();
-  const pad2 = (n) => String(n).padStart(2, "0");
-  const pdfDate = `D:${now.getFullYear()}${pad2(now.getMonth() + 1)}${pad2(now.getDate())}${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const isoDate = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}T${pad2(now.getHours())}:${pad2(now.getMinutes())}:${pad2(now.getSeconds())}`;
+  const { pdfDate, xmpDate: isoDate } = buildPdfMetadata();
   const infoTitle = params.title ?? "";
   const metaParts = [`/Title ${encodePdfTextString(infoTitle)}`, "/Producer (pdfnative)", `/CreationDate (${pdfDate})`];
   if (params.metadata?.author) {
@@ -9705,7 +9754,7 @@ function buildDocumentPDF(params, layoutOptions) {
     structTreeRootObjNum = tree.structTreeRootObjNum;
     totalObjs = treeStart + tree.totalObjects - 1;
     xmpObjNum = totalObjs + 1;
-    const xmpContent = buildXMPMetadata(infoTitle, isoDate, pdfaConfig.pdfaPart, pdfaConfig.pdfaConformance);
+    const xmpContent = buildXMPMetadata(infoTitle, isoDate, pdfaConfig.pdfaPart, pdfaConfig.pdfaConformance, params.metadata?.author);
     emitStreamObj(
       xmpObjNum,
       `<< /Type /Metadata /Subtype /XML /Length ${xmpContent.length}`,
@@ -9811,7 +9860,7 @@ endobj
     }
   }
   const writer = { emit, emitObj, emitStreamObj, offset: getOffset, adjustOffset, objOffsets, parts };
-  writeXrefTrailer(writer, totalObjs, infoObjNum, encState);
+  writeXrefTrailer(writer, totalObjs, infoObjNum, encState, `${infoTitle}|${pdfDate}`);
   return parts.join("");
 }
 function buildDocumentPDFBytes(params, layoutOptions) {