Changelog

All notable changes to PaperForge will be documented in this file.

The format is based on Keep a Changelog, and this project follows Semantic Versioning.

[1.4.1] - 2026-08-02

Added

• Added declarative fonts and font_fallbacks registries with trusted binary sources and root-confined local TrueType paths.
• Added JSON Schema and validation coverage for declarative fonts.

Fixed

• Fixed Flow measurement of registered TrueType fonts in paragraphs, columns, tables, and footnotes.
• Fixed tables falling back to Helvetica during rendering when the document default was an embedded font, which corrupted extracted UTF-8 text.
• Fixed declarative embedded fonts being registered too late for a custom document default font.

1.4.0 - 2026-08-01

Added

• Added PaperForge.Import.html/2 for document-oriented HTML to Layout IR, including headings, paragraphs, lists, quotes, code, tables, images, inline SVG, explicit page breaks, and safe local content handling.
• Added a strict CSS subset with element, class, and ID selectors; colors, typography, alignment, dimensions, vertical spacing, and page-break properties.
• Added CommonMark import through PaperForge.Import.markdown/2 using the pure-Elixir earmark_parser dependency.
• Added declarative html, markdown, math, automatically numbered equation, equation_reference, bibliography, footnote, endnotes, and annotation blocks to .paperforge and its bundled JSON Schema.
• Added root-level declarative AcroForms with text, checkbox, button, radio, list, combo, and signature fields, including choices, defaults, tooltips, and restricted calculations applied after pagination.
• Added PaperForge.Interoperability and a pure-Elixir classic PDF parser for selected-page import, ordered document composition, resource inventories, graph remapping, and duplicate font/XObject reduction.
• Added PaperForge.Math, a measured native Math AST for symbols, rows, fractions, roots, matrices, superscripts, subscripts, and bounded integrals.
• Added PaperForge.Scientific for numbered equations, named equation destinations, page-aware equation references, citations, and bibliographies.
• Added standard PaperForge.AcroForm text, checkbox, push-button, radio, list, combo, and signature fields with defaults, generated appearances, restricted calculations, data import/export, current-document editing, and flattening.
• Added underline, strikeout, stamp, free-text, square, circle, ink, and file attachment annotations with authors, subjects, colors, reply relationships, real EmbeddedFile objects, and review-conversation metadata.
• Added SVG text rendering and inherited font size, weight, style, and anchor handling to the existing paths, Bézier curves, groups, transforms, viewBox, clipping, and presentation-style pipeline.
• Added focused unit and integration tests for imported markup, PDF page composition, Math AST, scientific references, AcroForms, expanded annotations, SVG text, and declarative 1.4 blocks.
• Added INTEROPERABILITY.md and SCIENTIFIC.md with complete examples, operational boundaries, and migration guidance.
• Added investigacion.paperforge, a six-page fictional photonics study that demonstrates declarative scientific layout, Math AST, tables, charts, references, AES-256 policy, review fields, and signature metadata, plus a minimal runner for protected and digitally signed delivery editions.
• Added native configurable bar, line, area, scatter, pie, and donut charts to both PaperForge.Flow and .paperforge, including palettes, value labels, themed backgrounds, label colors, point sizing, line width, and donut inner-radius controls. Charts reserve configurable interior padding so marks and labels do not touch panel boundaries.
• Added optional declarative user_password and owner_password values so a controlled .paperforge template can produce AES-256 output without Elixir write options.
• Added per-side declarative page margins for reliable clearance between page headers, flowing content, and footers.
• Added declarative weight support and real bold/italic built-in font variant resolution, with matching text metrics for inline rich-text runs.
• Added declarative text-note and highlight annotations alongside the expanded review annotation set.

Changed

• Improved Math AST baseline conversion, symmetric fraction spacing, radical clearance, and symbol advances using the built-in font metrics.
• Added configurable compact AcroForm appearances with rounded corners, background and border styling, and checkbox mark styling in both Elixir and .paperforge templates.
• Preserved tooltip and appearance options when declarative radio groups are compiled, matching the other AcroForm field types.
• Corrected paragraph font-weight defaults and weight-aware text measurement, and made declarative columns honor column_gap, font, weight, color, style, and alignment consistently.
• Added top_left AcroForm rectangle coordinates for direct alignment with flowing layout content while retaining PDF-native bottom_left defaults.
• Fixed hexadecimal AcroForm appearance colors so Preview and other PDF readers render configured backgrounds, borders, and checks instead of black fallback rectangles.
• Improved imported HTML table defaults with vertically centered cells, stronger headers, alternating row fills, increased padding, and lighter configurable dividers. Expanded the safe CSS subset with table padding, line height, border styling, vertical alignment, body/header colors, and deterministic tr:nth-child(even) striping.
• Expanded practical HTML styling with compound selectors, built-in PDF font families, text transformation, block backgrounds and borders, padding, hidden content, list styles, hyphenation, widow/orphan controls, paged-media breaks, and image fit and position.
• Updated the package metadata, HexDocs extras, README, public API policy, migration guide, release examples, and documentation tests for 1.4.0.
• Introduced the project identity "Document engineering for the BEAM" across the README, Hex package description, and primary API documentation. The README now opens with a generated showcase and a concise document-lifecycle diagram before the detailed reference material.
• Reorganized the README around project status, verified compatibility, design principles, representative use cases, a reproducible performance snapshot, ecosystem boundaries, an HTML-to-PDF comparison, architecture, and a concise roadmap so the project can be evaluated quickly.
• Renamed the two maintained release showcases to paper_forge_1_4_showcase.exs and paper_forge_1_4_showcase.paperforge.
• Kept runtime generation free from native compilation, browser processes, command-line renderers, and external services.

Fixed

• Fixed numeric radio-group values so they are normalized to valid PDF names and can always be serialized and exported consistently.
• Fixed multiline rich text so inline font, weight, style, color, and URI-link options survive word wrapping and pagination.
• Fixed paragraph and rich-text background_color rendering, and made grid blocks honor their configured font, weight, style, color, and alignment.
• Fixed top-left AcroForm coordinates for pages with offset or inherited MediaBox geometry.
• Fixed declarative rich-text run objects that omit options, treating them as regular runs instead of rejecting them during compilation.
• Fixed Math AST spacing for integral limits and differentials, added radical clearance for superscripted radicands, centered matrix cells within symmetric brackets, and corrected integral height measurement for tight layouts.

Not Supported

• XFA forms are intentionally outside the standard AcroForm implementation.
• Binary PDF import currently rejects encryption and compressed object streams and does not merge source outlines, named destinations, or catalog-level AcroForms.
• HTML/CSS import is a document subset rather than a browser engine; it does not execute JavaScript or implement flexbox, grid, or a complete CSS cascade.

1.3.0 - 2026-08-01

Added

• Added PaperForge.Signature and a stable provider contract for incremental PAdES signing, verification, capability discovery, and application-selected HSM, KMS, or service integrations.

• Added a default PKCS#8/X.509 signature provider implemented with Elixir/OTP only, requiring no executable, NIF, native compilation, or system package.

• Added signing reason, location, contact information, integrity verification, and optional TSA timestamp support through the default provider.

• Added explicit PKCS#12/PFX compatibility loading through optional runtime OpenSSL use, without making OpenSSL a default or installation requirement.

• Added declarative signature policies while keeping certificates, private keys, and passwords exclusively in final write-time options.

• Added real PKCS#8 signing tests and provider-contract tests, including clear unsupported-capability errors for visible and multiple signatures in the built-in provider.

• Added AES-256 PDF encryption using the Standard Security Handler revision 6, including separate user and owner passwords and permissions for printing, copying, modification, and content extraction.

• Added write-time security options to PaperForge.to_binary/2, write/3, and write!/3; passwords and derived keys are never retained by a document.

• Added PaperForge.Protection for per-page watermarks, stable SHA-256 content fingerprints, deterministic identifiers, modification detection, and pre-output resource-policy audits.

• Added allow policies for URI schemes and hosts plus attachment enablement, count, byte-size, and MIME restrictions.

• Added PaperForge.Compliance with structural PDF/UA-1 preparation, tagged document trees, logical page reading order, document language, alternate image text metadata, and machine-readable validation reports.

• Added PDF/A-2b and PDF/A-3b preparation with application-supplied ICC output profiles, XMP profile metadata, output intents, and explicit rejection of encryption under archival profiles.

• Added declarative security, protection, and compliance policies and PaperForge.Declarative.write/4; passwords remain write-time values rather than template or compiled-IR state.

• Added JSON Schema definitions and integration coverage for declarative security permissions, protection policies, watermarks, and conformance profiles.

• Added direct AES interoperability checks through Poppler when available, protection/fingerprint tests, tagged-PDF tests, ICC validation tests, and combined declarative rendering tests.

• Added PHOENIX.md, a start-to-production guide for controller downloads, LiveView integration, declarative templates, bounded background rendering, optional Oban jobs, security, Telemetry, tests, and deployment limits.

Changed

• Updated the package, HexDocs, public API policy, README, and maintained examples for PaperForge 1.3.0.
• Added Phoenix to the README start paths and documented the planned optional visual .paperforge editor without changing the open library workflow.
• Reduced the examples directory to two maintained release showcases: one full-control Elixir report and one no-code declarative report.
• Updated both release showcases for PaperForge 1.3 security, signatures, protection, tagged PDF structure, and polished declarative output.
• Exposed table row height, cell line height, and block spacing options to the declarative format for polished content-aware tables.

1.2.0 - 2026-08-01

Added

• Added the versioned .paperforge JSON format for reusable document templates that contain data only and never evaluate arbitrary Elixir code.
• Added PaperForge.Declarative.parse/1, load/1, validate/2, compile/3, and render/3 for the complete declarative document lifecycle.
• Added typed variables with required fields, defaults, nested interpolation, and structured validation errors containing stable codes and JSON paths.
• Added deep schemas with string and numeric constraints, list item schemas, nested map requirements, URL/color/file formats, and optional rejection of undeclared input fields.
• Added declarative conditions, list loops, reusable components with props and defaults, and bounded recursive expansion.
• Added comparison, boolean, containment, and emptiness expressions.
• Added component prop schemas, required props, named slots, variants, trusted application component registration, and direct cycle detection.
• Added standalone kind: "component" .paperforge files, declarative component imports, nested component composition, required slot validation, cross-file cycle detection, and CLI validation without application code.
• Added rooted imports, includes, external design libraries, safe local resource resolution, import-cycle detection, and configurable complexity limits.
• Added source-aware errors, strict unknown-property checks, format migrations, a bundled Draft 2020-12 JSON Schema, deterministic template identifiers and hashes, and a bounded compiled-template cache.
• Added exact source file, line, column, and JSON path reporting for semantic template and input-data validation errors.
• Added mix paper_forge.validate for CI validation without PDF generation.
• Added compilation to PaperForge.Flow Layout IR so declarative templates use the existing pagination, navigation, table, typography, image, and PDF engine.
• Added PaperForge.DesignSystem with immutable tokens, reusable styles, visual components, shared layouts, mergeable design libraries, and themes with inheritance and cycle detection.
• Added nested token references, hexadecimal color tokens, dynamic metadata, reusable page templates, and application-supplied design systems.
• Added a complete annual-report .paperforge template and a data-only Elixir runner demonstrating validation, loops, conditions, components, themes, tables, navigation, and QR output.
• Added unit and integration coverage for malformed JSON, deep variable schemas, expressions, trusted and declarative components, imports, resources, limits, migrations, deterministic caching, CLI validation, and PDF rendering.
• Added DECLARATIVE.md as the format, security, Design System, and integration guide.
• Added PAPERFORGE_TEMPLATES.md, a non-technical guide for creating documents, reusable component libraries, loops, conditions, slots, variants, styles, validation, and PDFs without writing Elixir.

Changed

• Updated the package, HexDocs, public API policy, README, and examples for PaperForge 1.2.0.
• Expanded the README with practical guidance on when and how to use .paperforge templates and linked the plain-language authoring guide.
• Added the pure-Elixir jason dependency for standards-compliant JSON parsing.

1.1.0 - 2026-07-30

Added

• Added PaperForge.Concurrent for bounded, backpressured rendering through caller-owned or temporary Task.Supervisor processes.
• Added per-job timeout, cancellation, exception isolation, stable job IDs, completion callbacks, and duration/reductions/garbage-collection metrics.
• Added concurrent load coverage for hundreds of real PDF renders and a configurable 1,000-render production benchmark.
• Added per-job memory and reductions limits, configurable retry policies, attempt counts, and peak-memory metrics for concurrent rendering.
• Added atomic incremental file output that serializes PDF objects directly to a temporary file before renaming the completed artifact.
• Added a production scaling guide covering staged rendering, optional Oban integration, distributed nodes, failure recovery, large documents, resource budgets, deployment sizing, and load benchmarks.
• Added Telemetry events for render start, stop, and exception plus per-attempt batch jobs and completed collected batches.
• Added render and batch measurements for duration, bytes, memory, reductions, garbage collections, attempts, status, pages, and concurrency metadata.
• Added the lightweight official telemetry dependency for integration with Prometheus, OpenTelemetry, Grafana, and application-specific handlers.
• Added bounded process-local caches for repeated text measurements and Flate-compressed PDF streams.
• Added stable metric identities for built-in and embedded TrueType fonts.
• Added cache behavior, isolation, determinism, and performance regression tests.
• Added reproducible small, medium, and large render profiles reporting layout, cold/warm serialization, memory, output size, pages, and cache reuse.

Changed

• Changed object serialization to use linear reverse accumulation instead of repeatedly nesting the growing object section.
• Changed documents without page-aware tables of contents or references to use one pagination pass while retaining bounded convergence for navigation-aware documents.
• Changed pagination state to prepend pages internally and update the current page in constant time, removing repeated full-list traversal as documents grow.
• Changed table row, row-group, and cell accumulation to use reverse accumulation instead of repeated list concatenation.
• Reduced repeated glyph-width traversal for identical text, font, and size combinations and removed intermediate character-list allocation from UTF-8 measurement.
• Bypassed cache bookkeeping for short text whose direct measurement is cheaper than a process-cache lookup.
• Reused compressed stream binaries when immutable documents are serialized repeatedly in the same render process.
• Isolated bounded cache namespaces so metric churn cannot evict reusable compressed streams; concurrent renders still share no mutable cache state.
• Expanded render profiles with configurable warmups and sample counts plus median, p95, range, peak process memory, reductions, and garbage-collection measurements under the selected Mix environment.

1.0.0 - 2026-07-29

PaperForge 1.0 is the first stable release of the pure-Elixir PDF authoring engine. It consolidates the document, layout, typography, graphics, navigation, and production-hardening work delivered throughout the 0.x series and establishes the public API and Semantic Versioning contract for 1.x.

Stable authoring platform

• Unified flow layout with automatic pagination, keep controls, widow/orphan handling, overflow strategies, reusable components, themes, inherited templates, grids, columns, and structured layout diagnostics.
• Rich text, embedded Unicode TrueType fonts, physical font subsetting, font families, deterministic font deduplication, and searchable /ToUnicode mappings.
• Content-aware multipage tables with wrapped cells, repeated headers, row splitting policies, colspan, rowspan, vertical alignment, per-cell styling, and nested measured content.
• Automatic tables of contents, named destinations, outlines, bookmarks, internal and external links, page-aware references, and figure/table numbering.
• First, last, odd, and even page templates, section-aware page counters, headers, footers, footnotes, endnotes, attachments, and annotations.

Images and native graphics

• JPEG and PNG images with deduplication, alpha soft masks, EXIF orientation, contain/cover fitting, clipping, alignment, and focal positioning.
• Native vector paths, shapes, charts, QR codes, barcodes, and XML-parsed SVG content with groups, transforms, viewBox, clipping, and inherited styles.

Production readiness

• Structured document validation, deterministic serialization, corrupted-input coverage, conformance checks, compatibility hooks, and a documented large-document performance benchmark.
• Public API policy, migration guide, expanded HexDocs, release examples, and 165 automated tests with warning-free compilation.
• Pure Elixir installation with no browser, rendering service, or manual native build process.

Compatibility contract

• Public modules documented in API.md follow Semantic Versioning for the 1.x series. Breaking public API changes are reserved for a future major release.
• Complex-script shaping, bidirectional layout, and glyph-level fallback are outside the 1.0 contract while PaperForge waits for harfbuzz_ex to expose numeric glyph IDs without requiring a private native integration.
• Language-dictionary hyphenation and PDF/A output profiles remain outside the 1.0 feature set and are not advertised as supported.

0.6.0 - 2026-07-29

Added

Authoring and layout

• Added rich-text runs, named styles, reusable components, inherited templates, grids, multi-column sections, and measured custom blocks.
• Added linked tables of contents and page-aware cross-references using bounded multi-pass pagination.
• Added widow/orphan controls, optional long-word hyphenation, and placement diagnostics.
• Added bottom-of-page footnotes with automatic numbering and continuation, plus automatic endnote sections.
• Added automatic footnote call markers for preceding paragraphs, headings, rich-text blocks, and final table cells.
• Added first, last, odd, and even header/footer variants plus independent section page counters.
• Added justified text and explicit :clip, :ellipsis, :continue, and :error overflow strategies.
• Added configurable multilevel TOC formatting and numbered figure/table destinations with page-aware references.

Advanced tables

• Added content-aware row heights and text wrapping inside cells.

• Added repeated headers and row_split: :keep | :split | :error.

• Added cell and row continuation across pages without dropping content.
• Added explicit column widths, header colors, alignment, and striped rows.
• Added composable cells with colspan, rowspan, vertical alignment, per-side borders, colors, and nested block content.

Fonts, graphics, and PDF features

• Added physical TrueType subsetting with composite glyph retention and reconstruction of glyf, loca, hmtx, and maxp.
• Added font-program deduplication and primary-font fallback selection.
• Added vector QR codes, Interleaved 2 of 5 barcodes, native bar charts, and an XML-based SVG renderer supporting paths, Bézier curves, polygons, ellipses, groups, transforms, viewBox, clipping, and inherited styles.
• Added image :contain/:cover fitting, focal positioning, PDF clipping, and automatic JPEG EXIF orientation.
• Added embedded file attachments, text-note annotations, and highlights.

Production hardening

• Added PaperForge.validate/1 and PaperForge.validate!/1.
• Added PaperForge.ValidationError with machine-readable issue maps.
• Added pre-serialization checks for catalog/page-tree integrity, object identity, dangling references, page counts, and PDF versions.
• Added byte-for-byte determinism tests.
• Added corrupted-image fuzz coverage and internal xref/EOF conformance checks.
• Added optional pdfinfo compatibility validation.
• Added optional qpdf --check and VeraPDF CI checks.
• Added a 5,000-row memory and runtime benchmark.
• Added API.md with the developing 1.x compatibility and deprecation policy.
• Added MIGRATING.md for the developing 1.0 compatibility contract.

Changed

• Changed the package version to 0.6.0.
• Changed navigation materialization to iterate until page labels stabilize.
• Changed linked flow paragraphs, table-of-contents entries, and cross-references to emit real PDF /Link annotations targeting their named destinations.
• Changed bar-chart geometry to reserve consistent space above the plot for value labels, including the tallest bar.
• Increased the default footnote separator clearance so the rule cannot touch the first line of note text.
• Rebuilt the invoice and investor-report examples with production-oriented visual layouts.

Examples and tests

• Added examples/paper_forge_0_6_complete.exs, a complete release showcase.
• Added polished invoice and investor-report examples.
• Added integration coverage for authoring, navigation, advanced tables, footnotes, graphics, attachments, annotations, and physical font subsets.

Known limitations

• Complex-script shaping, advanced bidirectional layout, and glyph-level font fallback are waiting for harfbuzz_ex to expose numeric glyph IDs. PaperForge will consume that API without introducing a private NIF or manual native installation steps; the behavior is intentionally not simulated.
• Language-aware dictionary hyphenation is not included. hyphenate: true deterministically splits only words that cannot fit on a line.
• PDF/A output profiles are not yet emitted. Optional VeraPDF checks are skipped when the validator is unavailable and never affect package installation.

0.5.0 - 2026-07-27

Added

Unified document layout

• Added PaperForge.Layout.Block as the common block representation.
• Added stable block identifiers for layout debugging and reports.
• Added PaperForge.Flow as the builder for unified layout documents.
• Added PaperForge.flow/2 for rendering unified document flows.
• Added PaperForge.layout/3 for rendering flows with layout reports.
• Added an internal layout engine with deterministic pagination and rendering.
• Added block measurement before rendering.
• Added block splitting for paragraphs, lists, and tables.
• Added page-break blocks.
• Added page_break_before and page_break_after block options.
• Added keep_with_next support for headings and related content.
• Added minimum remaining-height checks before heading placement.
• Added keep-together containers.
• Added oversized-block detection to prevent infinite pagination loops.
• Added custom blocks that receive Page and PageContext.
• Added layout reports with page count, block count, placements, warnings, and rendered pages.
• Added placement reports containing block ID, block type, page number, coordinates, dimensions, and section metadata.
• Added structured layout debug reports through PaperForge.debug/2.

Flow API

• Added PaperForge.Flow.heading/3.
• Added PaperForge.Flow.paragraph/3.
• Added PaperForge.Flow.image/3.
• Added PaperForge.Flow.table/4.
• Added PaperForge.Flow.list/3.
• Added PaperForge.Flow.spacer/2.
• Added PaperForge.Flow.separator/2.
• Added PaperForge.Flow.page_break/1.
• Added PaperForge.Flow.keep_together/2.
• Added PaperForge.Flow.custom/3.
• Added PaperForge.Flow.section/4.

Two-pass rendering

• Added PaperForge.PageContext.
• Added page number and total page count in layout context.
• Added content bounds and section metadata in layout context.
• Added late header/footer rendering after total pages are known.
• Added Page {page} of {total} footer placeholders for string footers.
• Added automatic named destinations for rendered headings.
• Added outline bookmark generation from rendered headings.
• Added duplicate destination validation before rendering.
• Added unresolved internal link-target validation for flow block link metadata.

Sections and templates

• Added flow sections with IDs, titles, template selection, page-break behavior, destinations, bookmarks, and section metadata.
• Added PaperForge.page_template/3.
• Added named page template registration on documents.
• Added named page templates with page size, orientation, margins, headers, and footers.
• Added template resolution in PaperForge.layout/3 and section template switching inside flow documents.
• Added reserved header and footer regions through page margins and content bounds.
• Added dynamic header and footer callbacks receiving PaperForge.PageContext.
• Added PaperForge.PageTemplateError for missing templates.

Layout blocks

• Added heading blocks with levels.
• Added paragraph blocks with wrapping and page splitting.
• Added image blocks with width: :content, fixed width/height, alignment, and captions.
• Added multipage table blocks with repeated headers.
• Added deterministic table continuation across pages.
• Added list blocks with ordered and unordered markers.
• Added spacer and separator blocks.

Structured errors

• Added PaperForge.LayoutError.
• Added PaperForge.TableError.
• Added PaperForge.NavigationError.
• Added PaperForge.PageTemplateError.
• Added structured metadata fields for layout, table, navigation, and template failures.

Tests

• Added tests for stable block IDs.
• Added tests for flow builder APIs.
• Added tests for unified flow rendering, headings, paragraphs, lists, sections, page breaks, tables, images, templates, debug reports, and bookmarks.
• Added tests for pagination controls, section template switching, placement reports, duplicate destinations, unresolved link targets, and oversized-block diagnostics.

Changed

• Changed the package version to 0.5.0.
• Updated README for the unified layout API.

Compatibility

• Existing Page, add_flow/4, and add_table/4 APIs remain supported.
• New applications should prefer PaperForge.Flow and PaperForge.layout/3.
• Legacy APIs are not removed or formally deprecated in this release.

Limitations

• The 0.5.0 layout engine is the new unified rendering path. Existing page-level APIs remain available for compatibility, but new applications should prefer PaperForge.Flow and PaperForge.layout/3.
• Rich text and inline mixed-style runs are not yet supported.
• Advanced widow and orphan control is not yet supported.
• Table rows can continue across pages as grouped units, but content inside an individual row or cell cannot yet be split across pages.
• Automatic table-of-contents generation is not yet supported.
• Advanced image cropping, fitting modes, and object positioning remain future work.
• Page-template inheritance and advanced first, odd, even, or final-page variants are not yet supported.
• Physical TrueType /FontFile2 reconstruction is not enabled yet. PaperForge continues to use the subsetting planner foundation introduced in 0.4.0 while embedding the original TrueType font program.

0.4.0 - 2026-07-27

Added

TrueType subsetting foundation

• Added TrueType font-program deduplication by SHA-256 binary hash.
• Added parsing of loca offsets and head.indexToLocFormat.
• Added preservation of raw TrueType table data for physical subsetting work.
• Added PaperForge.Fonts.TrueType.glyph_dependencies/2.
• Added recursive composite glyph dependency expansion.
• Added PaperForge.Fonts.TrueType.Subsetter.
• Added physical subsetting plans that include:
  • Requested glyphs
  • .notdef
  • Composite glyph dependencies
  • Tables that must be rebuilt: glyf, loca, hmtx, and maxp
  • TrueType table checksums
  • Font binary hashes
• Added TrueType checksum calculation with four-byte padding.

Advanced layout

• Added PaperForge.layout_flow/4 for flow layout with a report.
• Added flow reports with :pages_added, :blocks, and :overflow?.
• Added :keep_together support for flowed blocks.
• Added :header and :footer support for flowed pages.
• Added PaperForge.add_table/4 for paginated tables.
• Added repeating table headers across generated pages.
• Added row_split: :keep validation for table row splitting policy.
• Added PaperForge.Page.list/3 for ordered and unordered lists.

PDF navigation

• Added named destinations.
• Added internal document links through PaperForge.Page.link_to/3.
• Added page destinations through PaperForge.Page.destination/3.
• Added outlines and bookmarks through PaperForge.Page.bookmark/3.
• Added catalog /Names trees for named destinations.
• Added catalog /Outlines trees and linked outline items.
• Added internal link annotations using /Dest.

Tests

• Added tests for TrueType font-program deduplication by binary hash.
• Added tests for TrueType subsetting plans and checksum calculation.
• Added tests for named destinations, internal links, and outline bookmarks.
• Added tests for ordered and unordered lists.
• Added tests for flow reports, headers, footers, and keep-together behavior.
• Added tests for paginated tables with repeated headers.

Changed

• Changed the package version to 0.4.0.
• Updated the README for the 0.4.0 subsetting, layout, and navigation work.

Limitations

• Final physical /FontFile2 reconstruction is still in progress. The new subsetting planner resolves dependencies and checksum data, but PaperForge still embeds the original font program when generating PDFs.
• Table row splitting currently supports keeping rows together with row_split: :keep; splitting a single row across pages is not implemented yet.
• Additional annotation types beyond URI links and internal links are still planned.

0.3.0 - 2026-07-26

Added

Embedded TrueType fonts

• Added PaperForge.register_font/3 for registering embedded TrueType fonts.
• Added support for loading TrueType fonts from file paths.
• Added support for loading TrueType fonts from in-memory binaries.
• Added PaperForge.Fonts.TrueType for parsing compatible .ttf files.
• Added validation for unsupported OpenType CFF fonts.
• Added validation for invalid or truncated TrueType files.
• Added parsing for required TrueType tables:
  • head
  • hhea
  • maxp
  • hmtx
  • cmap
  • name
  • OS/2
  • post
  • loca
  • glyf
• Added extraction of:
  • Units per em
  • Glyph count
  • Unicode-to-glyph mappings
  • Glyph widths
  • Font bounding box
  • Ascent
  • Descent
  • Cap height
  • Italic angle
  • PostScript font name
• Added support for Unicode cmap format 4 and format 12 subtables.
• Added embedded PDF Type 0 fonts with CIDFontType2 descendants.
• Added /Identity-H encoding for embedded TrueType fonts.
• Added /FontFile2 streams for embedded TrueType font programs.
• Added /FontDescriptor dictionaries for embedded TrueType fonts.
• Added CID width arrays from real TrueType metrics.
• Added prefixed embedded font names such as PF0001+FontName.
• Added subsetting of generated CID width arrays to glyphs used by the document.
• Added subsetting of generated /ToUnicode CMaps to glyphs used by the document.
• Added PaperForge.register_font_family/3 for TrueType font families.
• Added support for :regular, :bold, :italic, and :bold_italic TrueType family variants.
• Added document-level default font selection through PaperForge.default_font/2.
• Added :default_font support to PaperForge.new/1.

Unicode visible text

• Added visible Unicode text rendering through registered TrueType fonts.
• Added glyph-id text encoding for embedded Type 0 fonts.
• Added /ToUnicode CMaps for registered TrueType fonts.
• Added Unicode extraction/search support for generated embedded-font text.
• Added PaperForge.FontError for font registration, parsing, and glyph errors.
• Added clear errors for unregistered font keys.
• Added clear errors when a registered TrueType font does not contain a required glyph.
• Added support for Spanish accents, ñ, ü, inverted punctuation, typographic symbols, Greek, and Cyrillic when the registered font contains those glyphs.

Text metrics

• Added TrueType-backed width measurement in PaperForge.TextMetrics.
• Updated text alignment to use real TrueType glyph widths when a registered font is used.
• Updated text wrapping and text boxes to use registered TrueType metrics.
• Updated page compilation to pass registered font instances into text measurement and rendering.

Tests

• Added unit tests for TrueType parsing and metrics.
• Added unit tests for Unicode cmap glyph resolution.
• Added unit tests for Spanish, symbol, Greek, and Cyrillic glyph coverage.
• Added unit tests for truncated and unsupported font files.
• Added integration tests for TrueType registration from paths and binaries.
• Added integration tests for TrueType font deduplication by registered key.
• Added structural PDF tests for /Type0, /CIDFontType2, /FontFile2, /Identity-H, and /ToUnicode.
• Added tests for TrueType-backed text measurement.
• Added tests for unregistered fonts and missing glyph errors.
• Added benchmarks/truetype.exs for TrueType registration, text measurement, multiline rendering, and multilingual PDF generation.
• Added tests for TrueType width and /ToUnicode subsetting.
• Added tests for default fonts and font-family variant resolution.
• Added PDF compatibility smoke tests for multilingual documents, xref markers, startxref, EOF markers, and /ToUnicode.

Document layout

• Added PaperForge.add_flow/4 for vertical content flow.
• Added automatic page breaks for flowed text blocks.
• Added PaperForge.Page.paragraph/3 as a paragraph-oriented text-box alias.
• Added PaperForge.Page.table/3 for basic table rendering.
• Added PaperForge.Page.link/3 for URI link annotations.
• Added PDF /Annot link dictionaries with URI actions.
• Added page /Annots arrays when a page contains link annotations.
• Added tests for tables, links, vertical flow, and automatic page breaks.

Changed

• Changed unknown non-standard font keys to raise PaperForge.FontError instead of a generic ArgumentError.
• Changed the package version to 0.3.0.
• Updated the README to document embedded TrueType fonts, visible Unicode text, font families, default fonts, vertical flow, tables, links, and current font limitations.

Limitations

• Physical TrueType table reconstruction is not implemented yet; generated PDF width arrays and /ToUnicode maps are subset to used glyphs, but the full .ttf program is still embedded in /FontFile2.
• OpenType CFF (OTTO) and TrueType Collection (.ttc) fonts are not supported yet.
• Complex shaping for scripts such as Arabic and Devanagari is not performed yet.

0.2.0 - 2026-07-26

Added

Document configuration

• Added document-level configuration through PaperForge.new/1.
• Added the :compress document option.
• Enabled Flate stream compression by default.
• Added support for disabling compression with PaperForge.new(compress: false).
• Added the :pdf_version document option with "1.7" as the default.
• Added validation for unsupported document options.
• Added validation for invalid compression and PDF version values.

Stream compression

• Added PaperForge.Compression.
• Added stream compression using the PDF /FlateDecode filter.
• Added support for streams with zero, one, or multiple filters.
• Added automatic insertion of the /Filter entry in stream dictionaries.
• Added compression support for page content streams.
• Preserved JPEG image data without recompressing it.
• Added tests that decompress Flate streams and verify their actual commands.

Fonts

• Added a built-in font registry.
• Added automatic reuse of fonts already registered in a document.
• Added on-demand font registration when pages are compiled.
• Added sequential font resource names such as /F1, /F2, and /F3.
• Added support for the 14 standard PDF Type 1 fonts:
  • Helvetica
  • Helvetica Bold
  • Helvetica Oblique
  • Helvetica Bold Oblique
  • Times Roman
  • Times Bold
  • Times Italic
  • Times Bold Italic
  • Courier
  • Courier Bold
  • Courier Oblique
  • Courier Bold Oblique
  • Symbol
  • Zapf Dingbats
• Added font family and style metadata.
• Added support for WinAnsi and built-in font encodings.
• Added PaperForge.Font.definition_to_dictionary/1.
• Added built-in font metrics.
• Added text-width measurement through PaperForge.TextMetrics.
• Added tests for font registration, font reuse, unsupported fonts, and consecutive font resource names without relying on fixed object IDs.

Text layout

• Added text alignment:
  • Left
  • Center
  • Right
• Added optional text width for alignment calculations.
• Added automatic text measurement using built-in font metrics.
• Added PaperForge.TextWrapper.
• Added automatic word wrapping.
• Added support for explicit newline characters.
• Added configurable line height.
• Added long-word splitting when a word exceeds the available width.
• Added PaperForge.Graphics.TextBox.
• Added multiline text boxes.
• Added optional text-box height limits.
• Added line-count and overflow information from text-box layout.
• Added support for text-box alignment.
• Added support for text-box fill color.
• Added support for selecting built-in fonts by atom.

Page coordinates and margins

• Added PaperForge.Coordinates.
• Added support for bottom-left page coordinates.
• Added support for top-left page coordinates.
• Added per-operation origin overrides.
• Added coordinate conversion for:
  • Text
  • Text boxes
  • Lines
  • Rectangles
  • Circles
  • Images
• Added PaperForge.Margins.
• Added uniform page margins.
• Added independent top, right, bottom, and left margins.
• Added margin validation against page dimensions.
• Added page content helpers:
  • PaperForge.Page.content_width/1
  • PaperForge.Page.content_height/1
  • PaperForge.Page.content_left/1
  • PaperForge.Page.content_top/1
  • PaperForge.Page.content_bottom/1
• Added automatic text positioning based on page margins when :x or :y are omitted.

Images

• Added JPEG image support.
• Added support for non-interlaced 8-bit grayscale, RGB, grayscale-alpha, and RGBA PNG images.
• Added JPEG signature validation.
• Added PNG signature validation.
• Added JPEG marker parsing without decoding image pixels.
• Added PNG IHDR and IDAT parsing without decoding image pixels.
• Added extraction of:
  • Width
  • Height
  • Bits per component
  • Number of color components
  • Color space
• Added support for:
  • Grayscale JPEG images
  • RGB JPEG images
  • CMYK JPEG images
  • Grayscale PNG images
  • RGB PNG images
  • Grayscale PNG images with alpha
  • RGBA PNG images
• Added PDF image XObjects using /DCTDecode.
• Added PNG image XObjects using /FlateDecode and PNG predictor decode parameters.
• Added PNG transparency support using PDF soft masks (/SMask).
• Optimized PNG parsing to avoid unnecessary per-pixel reconstruction when the PNG can be inserted directly into the PDF.
• Added CMYK decode arrays for compatible JPEG images.
• Added PaperForge.Image.
• Added PaperForge.ImageRegistry.
• Added SHA-256-based image deduplication.
• Added sequential image resource names such as /Im1 and /Im2.
• Added image loading from:
  • File paths
  • JPEG binaries
  • PNG binaries
• Added automatic aspect-ratio preservation.
• Added image sizing using:
  • Original dimensions
  • Width only
  • Height only
  • Explicit width and height
• Added PaperForge.Graphics.Image.
• Added PDF image drawing using the cm and Do operators.
• Added page-level image operations through PaperForge.Page.image/3.
• Added tests for RGB, grayscale, CMYK, invalid, truncated, duplicated, and distinct JPEG image handling.
• Added tests for RGB, grayscale, grayscale-alpha, RGBA, invalid, truncated, deduplicated, and unsupported PNG image handling.
• Added PNG parsing benchmarks and large-image tests.

Page resources

• Added PaperForge.PageResources.
• Added centralized page resource management.
• Added automatic font resource dictionaries.
• Added automatic image XObject dictionaries.
• Added resource deduplication within pages.
• Added support for pages containing multiple fonts and images.

Metadata and string encoding

• Added PaperForge.StringEncoding.
• Added automatic PDF string encoding selection.
• Added literal PDF strings for compatible text.
• Added UTF-16BE encoding for Unicode metadata.
• Added Unicode support for:
  • Title
  • Author
  • Subject
  • Keywords
  • Creator
  • Producer
• Added creation-date metadata.
• Added modification-date metadata.
• Added PDF date serialization for:
  • DateTime
  • NaiveDateTime
• Added timezone-offset serialization for DateTime metadata.
• Added metadata option validation.
• Added omission of empty metadata values.
• Added tests for Latin-1 and UTF-16BE metadata serialization.

Public API

• Added PaperForge.new/1.
• Added page creation with options through PaperForge.add_page/3.
• Added support for passing an existing page to PaperForge.add_page/2.
• Added support for passing a page callback to PaperForge.add_page/2.
• Added callback return-value validation.
• Added metadata creation through PaperForge.metadata/2.
• Added output-path validation for PaperForge.write/2 and PaperForge.write!/2.

Testing

• Expanded document graph tests.
• Added tests for document compression and PDF version configuration.
• Added tests for unsupported document options.
• Added tests for invalid compression values.
• Added tests for compressed PDF output.
• Added tests for uncompressed PDF output.
• Added tests for font reuse and additional font registration.
• Added tests for JPEG and PNG parsing, image registration, image deduplication, and image scaling.
• Added tests for top-left and bottom-left coordinate compilation.
• Added tests for margins and text-box layout behavior.
• Added tests that verify every xref offset points to the beginning of its object.
• Added a structural round-trip style writer test covering multiple pages, fonts, repeated images, metadata, compression, resources, and xref offsets.
• Updated writer tests so they no longer assume compressed stream contents are visible as plain text.
• Updated document tests to use explicit PDF reference fields.
• Restored compilation with --warnings-as-errors.

Changed

• Changed the default page content stream behavior to use Flate compression.
• Changed document creation to accept configuration options.
• Changed document creation so only the page tree and catalog are created initially.
• Changed font creation to register standard Type 1 fonts only when used.
• Changed the next automatically allocated object identifier to start after the initial page tree and catalog objects.
• Changed page compilation to register fonts and images dynamically.
• Changed page image compilation to detect supported image formats before registering image XObjects.
• Changed page compilation to flow through PaperForge.PageCompiler.
• Changed page resource generation to use PaperForge.PageResources.
• Changed text rendering to use registered font resource names instead of a hardcoded font resource.
• Changed text positioning to support page margins and configurable origins.
• Changed metadata values to use automatic PDF string encoding.
• Changed JPEG files to be embedded directly as PDF image streams.
• Changed the document structure to use explicit reference field names:
  • root_reference
  • pages_reference
  • info_reference
• Changed tests to validate behavior and structure rather than relying on compressed stream contents or fixed internal assumptions.
• Changed page streams to select filters from the document configuration.
• Changed multiline text rendering to use text wrapping and layout metrics.

Fixed

• Fixed duplicate @doc warnings for multi-clause PaperForge.add_page/2.
• Fixed the missing PaperForge.Font.definition_to_dictionary/1 function.
• Fixed JPEG bitstring matching by pinning payload_length.
• Fixed compilation under mix compile --warnings-as-errors.
• Fixed font resource reuse across pages.
• Fixed repeated image embedding by deduplicating JPEG binaries.
• Fixed repeated image embedding by deduplicating PNG binaries.
• Fixed image aspect-ratio calculations when only one dimension is provided.
• Fixed top-left coordinate conversion for box-shaped operations.
• Fixed page resource dictionaries for multiple fonts and image XObjects.
• Fixed metadata encoding for characters outside simple PDF literal-string ranges.
• Fixed stream filter serialization for compressed page content.
• Fixed tests that referenced removed or renamed document fields.
• Fixed tests that expected uncompressed text while compression was enabled.

Internal

• Added PaperForge.PageCompiler as the central page operation compiler.
• Added separate registries for fonts and images.
• Added normalized built-in font definitions.
• Added font metric tables.
• Added dedicated modules for:
  • Compression
  • Coordinates
  • Margins
  • Font registration
  • Image registration
  • JPEG parsing
  • PNG parsing
  • Page compilation
  • Page resources
  • String encoding
  • Text measurement
  • Text wrapping
  • Text boxes
  • Image drawing
• Continued using iodata for PDF command and document construction.
• Kept PDF object references separate from indirect object values.

0.1.0 - 2026-07-26

Added

• Initial PaperForge project structure
• Pure Elixir PDF generation without external rendering tools
• PDF primitive serialization for:
  • Null values
  • Booleans
  • Integers
  • Floating-point numbers
  • Names
  • Literal strings
  • Arrays
  • Dictionaries
  • Indirect references
  • Streams
• Indirect PDF object representation
• PDF object references with generation numbers
• PDF stream support with automatic byte-length calculation
• Internal document object graph
• Automatic PDF object ID allocation
• Document catalog generation
• PDF page tree generation
• Multi-page document support
• Cross-reference table generation
• PDF trailer and startxref generation
• Binary PDF output
• File-writing API
• Built-in Helvetica font support using WinAnsiEncoding
• A3, A4, A5, Letter, Legal, and custom page sizes
• Portrait and landscape page orientations
• Text drawing with:
  • Position
  • Font size
  • Fill color
• Line drawing with:
  • Start and end coordinates
  • Stroke color
  • Configurable line width
• Rectangle drawing with:
  • Stroke
  • Fill
  • Stroke color
  • Fill color
  • Configurable line width
• Circle drawing using cubic Bézier curves
• RGB color support
• 8-bit RGB color helpers
• Grayscale color support
• Basic PDF metadata:
  • Title
  • Author
  • Subject
  • Keywords
  • Creator
  • Producer
• Example documents for text, multiple pages, and graphics
• Unit tests for the PDF serializer, document graph, pages, and writer

Technical details

• Uses iodata internally to reduce unnecessary binary concatenation
• Produces traditional PDF cross-reference tables
• Uses generation 0 for newly generated indirect objects
• Uses native PDF coordinates with the origin at the bottom-left corner
• Isolates graphic operations using the PDF q and Q operators