pdf_document

Bump the app to 5.1.1+41 and the lockstep package suite to 5.1.1
(dart_pdf_cli 0.2.2, dart_pdf_editor_flutter_gpu 0.4.2, dart_pdf_printing
0.2.2), with every runtime inter-package constraint at ^.
This is a patch release: no public API breaks since 5.1.0, and one addition
integrators may see:

• dart_pdf_editor: PdfEditingController gained committedInksOn(page) and
  retireCommittedInk(page, throughRevision:). committedInkOn is unchanged
  and returns the newest commit.

Write the 5.1.1 changelog sections from the one commit since app-v5.1.0,
the ink afterimage fix (#986): quick back-to-back ink commits each hid the
previous one on screen until the page re-rendered, because the editing
overlay kept only the latest commit as its afterimage. Commits now
accumulate and retire per page once the raster and annotation layer are
current. The other packages carry a version-bump entry. Dev dependency
ranges (<6.0.0) already admit 5.1.1.

Store notes cover the ink fix and note that 5.1.1 includes 5.1.0's
improvements, written platform-neutral per release-notes/README.md, across
20 iOS locales, 21 Play changelogs (41.txt) and both Linux metainfo copies.
The forms guide now says it applies to 5.1.1.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

Bump the app to 5.1.0+40 and the lockstep package suite to 5.1.0
(dart_pdf_cli 0.2.1, dart_pdf_editor_flutter_gpu 0.4.1, dart_pdf_printing
0.2.1), with every runtime inter-package constraint at ^.
This is a minor release: no public API breaks since 5.0.0, with two things
integrators should know:

• dart_pdf_editor: DartPdfEditorLocalizations gained the abstract getters
  sigUseTrackpad and sigTrackpadHint; a custom subclass implements them,
  extending a bundled locale class picks them up.
• pdf_graphics: the render-command codec is now wire format v11 (v10 paint
  dedup and aligned path blocks, then Type3 cell back-references). Buffers
  are not compatible across versions, and deserializeCommands /
  deserializePageText throw FormatException on a mismatch.

Write the 5.1.0 changelog sections from the commit bodies since
app-v5.0.0: the P-521 order fix, faster ECDSA, tolerant zlib inflate on
the web, the object-cache key and its side map, T-table AES, web SHA-2,
JPEG 2000, in-place updates on recovered documents, rollbackTo and
openAppended(password:) in pdf_cos; the page-loss fix under a short /Count,
linear page loops, reusable signature crypto cores and onFields in
pdf_document; the flagged masked-image output change, codec v10/v11,
cached luminosity masks, the revision-stable colour context, ICC, colorant
buffer and text-extraction speedups in pdf_graphics; trackpad signatures,
annotation previews, touch row menus, the moved-stamp white box, the web
worker fixes and in-place revisions in dart_pdf_editor; the new overprint
and ICC fixtures. Dev dependency ranges (<6.0.0) already admit 5.1.0.

Store notes cover trackpad signatures, annotation previews, touch row
menus, the moved-stamp fix, the page-loss fix, P-521 signatures and the
speedups, written platform-neutral per release-notes/README.md, across 20
iOS locales, 21 Play changelogs (40.txt) and both Linux metainfo copies.
The forms guide now says it applies to 5.1.0.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

Bump the app to 5.0.0+39 and the lockstep package suite to 5.0.0
(dart_pdf_cli 0.2.0, dart_pdf_editor_flutter_gpu 0.4.0, dart_pdf_printing
0.2.0 - their dependency majors moved under types they expose). This is a
major release because public behaviour and API changed incompatibly since
4.5.0:

• dart_pdf_editor: PdfFormFieldKind gained radioGroup/comboBox/listBox/
  signature and PdfBundledSubstitute gained carlito (exhaustive switches
  break); setFormFieldText now runs keystroke/validate scripts, returns
  false for refused input and stores the normalised value; shells without
  a viewMode: own a per-window PdfViewModeController, so hosts that drove
  the mode through preferences must pass one; DartPdfEditorLocalizations
  gained abstract getters.
• pdf_document: setTextValue truncates to /MaxLen and recalculates AF
  calculated fields; every fill removes /XFA and /NeedsRendering; list
  boxes draw every row; validate() untrusts a chain the /DSS says is
  revoked; PdfTrustStore.addCertificate/addDer gained {source}.
• pdf_cos: decryptObjectGraph leaves a signature's /Contents as-is; OCSP
  delegated responders must be CA-issued with id-kp-OCSPSigning.

Roll the Unreleased sections over with Breaking changes subsections and
migration notes, and write the ones the batch never got: AF* scripts,
comb/MaxLen/password fields, XFA detection, encrypted signing and tab
order in pdf_document; openAppended in pdf_cos; the /ImageMask box filter,
justified-text reflow spaces and multi-select field context in
pdf_graphics; the form-layer, secret-store, Tab navigation and
thumbnail drag-out work in dart_pdf_editor; multi-select values in the
CLI; the print range and copies fixes in dart_pdf_printing; the new
fixtures. Dev dependency ranges on workspace packages now admit <6.0.0 so
the workspace resolves and publishing still accepts the hosted 4.5.0.

Store notes cover form calculations and checks, Tab and multi-select,
password fields kept out of the file, field creation, signing encrypted
PDFs, revocation checks with EU/Adobe trust lists, and Calibri via
Carlito, across 20 iOS locales, 21 Play changelogs, and both Linux
metainfo copies. The forms guide now says it applies to 5.0.0.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

Bump the app to 4.5.0+38 and the lockstep package suite to 4.5.0
(dart_pdf_cli 0.1.8, dart_pdf_editor_flutter_gpu 0.3.4, dart_pdf_printing
0.1.1). Nothing public was removed or changed incompatibly since 4.4.0 -
showPdfShellViewOptionsSheet lost its reflow/pageGrid parameters, but it is
not exported - so this is a minor release.

Roll the Unreleased sections over and write the ones the 4.4.0..HEAD batch
never got: WinAnsi widths and the DocMDP P=1 signing refusal in pdf_document,
CJK selection metrics in pdf_graphics, selection continuity, the stroked-text
floor, stem darkening and the page-grid State fix in dart_pdf_editor.

Store notes cover What's new, the Linux antialiasing fix, exported pages
opening in a tab, the view-mode picker, metric-compatible standard-14
substitutes, and selection and stroked-text fixes, across 20 iOS locales,
21 Play changelogs, and both Linux metainfo copies.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com

Storeflight and release-app.yml both created the release for an app-v tag.
Storeflight pushes that tag, so its own delivery and the workflow the tag
starts were racing to own the same release, and would have attached two sets
of assets for the same platforms under different names.

Storeflight wins, with one exception it cannot cover. A release artifact
there is a single path per platform, and Linux ships two user-facing files -
the portable tarball and the AppImage. Dropping either is not an option:
publish-flatpak.yml downloads dartpdf-linux-x64.tar.gz from the release by
name and verifies its digest, so the Flatpak publisher fails a step later
without it.

So release-app.yml stops creating a release and contributes only the two
Linux assets. It waits for Storeflight's release rather than creating one,
because publishing the tag is what starts it and it can arrive first;
creating one there would be the same race with the roles reversed. It also
asserts the tarball is present under the name the Flatpak publisher looks
for, so a rename fails here rather than ten minutes downstream. The job now
needs only the Linux build, since waiting on the other six delayed that input
for no benefit.

publish-flatpak.yml waits for the asset for the same reason: two workflows
started by one tag have no ordering between them, and an asset still
uploading is not a missing build.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01RNNTEpKG3vAEwMYMvghdvx

Add 4.3.0 Linux release metadata

Release pdf_document 4.2.0

Release pdf_document 4.1.0

Release pdf_document 4.0.0

Release pdf_document 3.8.0

• Add SimpleFont, the simple-font counterpart to Type0Font: one place that resolves a character code to text the way the renderer does (/ToUnicode, /Encoding /Differences, the built-in Symbol and ZapfDingbats encodings, then the base encoding), plus the reverse table for re-encoding replacements and the /Widths lookup.
• Fix content editing against fonts that remap their codes. PdfPageElements decoded a simple font's show string as Latin-1, so a subsetted font reported text such as -=>-/>?-?@ for a page reading 05/08/2026, and replacements were written back as raw code units. Element text, both run codecs, the ' and " operators, and paragraph reflow now all go through the font's own encoding.
• Restrict a replacement to codes the font actually declares - a glyph name from the base encoding or /Differences, or a /ToUnicode entry - so a subset that dropped a character declines the edit instead of drawing notdef. Decoding keeps its lenient Latin-1 fallback. A named base encoding declares printable ASCII (0x20-0x7E) per Annex D.
• Move the Adobe glyph-name tables down from pdf_graphics to src/fonts/encodings.dart and export them, so the content editor and the font engine share one copy.

• Read Bluebeam FreeText paragraph styling from /DS and rich-text /RC when standard PDF entries are absent, preserving alignment, leading, character spacing, horizontal scale, and underline when editing or regenerating an appearance.
• Let FreeText annotations participate in opacity restyling, write opacity on creation, and rebuild their appearances without losing the selected alpha.

• Lockstep patch release for the scanned-page rendering fixes in pdf_cos, pdf_graphics, and dart_pdf_editor. No public document API changes.

• Let PdfDocument.openSource expose its requested first-paint page count as a temporary page-count hint when the source deliberately omits the rest of the page-tree walk. The full document opened during progressive handoff remains authoritative, while sparse page-one previews avoid recovery-scanning every intentionally absent leaf reference.

• Preserve the unresolved vector template on authored stamp annotations and expose it through PdfAnnotation.stampTemplate, allowing a placed stamp to return to a reusable collection without losing dynamic fields (#651).

• Fix annotation property edits duplicating the annotation when a page stores its /Annots array indirectly (#638).
• Preserve embedded font resources when changing FreeText colour, so restyled text continues to use the original embedded typeface (#641).

• Add lightweight diagnostics to PdfDiskCache for hits, misses, writes, oversize rejections, evictions, and byte totals, with resetStats() and a one-line debugStats summary. Manifest writes are coalesced across bursts so persistent page-raster caches do not rewrite an O(n) manifest for every entry (#615).

• Improve FreeText callout interoperability: recognize third-party callouts from their /CL geometry when /IT is missing or private, and clamp malformed or negative /RD insets to a usable callout text box (#621).

• Lockstep patch release to align the dart-pdf package suite at 3.1.1. No public pdf_document API changes since 3.1.0.

• Add PdfEditor.compress()/PdfCompressionResult: lossless file-size compaction on save. A whole-graph reachability pass drops the dead objects incremental edits accumulate, non-stream objects pack into object streams, and uncompressed streams are re-deflated (kept only when smaller). Never returns a larger file, includes pending edits, and refuses encrypted documents. Decoded stream content is preserved bit-for-bit (#368).
• Hyperlink authoring: addLinkToUri / addLinkToDestination / addLinkToPage, mirroring the text-markup creators' quad shape so a text selection turns into a link. /Rect bounds the quads, each quad becomes an active /QuadPoints region, /Border is suppressed by default, and an underline or border decoration bakes an /AP (#500).
• Crop placed images: the image-stamp appearance bakes a normalized crop rect, read back via PdfAnnotation.imageStampCrop; opacity restyles and resizes preserve the crop (#504).
• Render digital-signature boxes in the signer's local timezone (#570).
• Add PdfAnnotation.isPrint (§12.5.3 print-vs-screen visibility) (#546).

Lockstep major release (a breaking change in dart_pdf_editor moves the whole suite to 3.0.0). pdf_document's own public API is additive.

• Add PdfEditor.saveSignedExternal: delegates the RSA operation to a PdfExternalSigner callback so the private key can stay in a hardware keystore (Android KeyStore, iOS Keychain). PdfSignatureAppearance gains overridable signedByLabel/dateLabel/reasonLabel/locationLabel, and the visible /M and signature-box date now preserve a non-UTC signingTime's offset (UTC input unchanged) (#507).
• Fix signature appearance detail text being clipped at the top of the signature box (#468).

• Cache PdfPage instances instead of rebuilding them per access, resolving inherited attributes live: a page holds only ancestor-derived values and reads its own /Rotate, /MediaBox, /CropBox, and /Resources from the dictionary, so the cache cannot serve a stale value after an edit (#418).
• Resolve pageIndexOf in O(1) through an identity map rather than walking the page tree (#397).
• Resolve a form widget to its page in O(1), cache the widget list, and hoist the /Widths lookup out of the per-glyph loop (#406).
• Reuse the caller's element snapshot on a targeted edit instead of re-enumerating the page's elements (#402).
• Support the incremental append save path (CosUpdater.saveTail()), so an incremental revision costs the size of the change (#413).

• Major version bump for the 2.0.0 package suite (breaking change in dart_pdf_editor; the document API is source-compatible with 1.4.7).
• Open documents from an asynchronous PdfByteSource so a remote or large local PDF can be rendered progressively as bytes arrive, rather than after the whole file is in memory (#328).
• One-tap self-signed signing identities: PdfSigningIdentity.generate (P-256 keygen + X.509 v3 self-signed cert) with toPem/fromPem persistence, PdfEditor.saveSelfSigned / saveSignedEcdsa / saveSelfSignedPades (ECDSA CMS), a default TSA (PdfDefaultTimestampAuthority) for trusted B-T time, and org-CA mode (PdfSigningIdentity.generateCa + ca.issue(...)) so members chain to a shared CA (#337).
• Sigstore/Fulcio keyless signing (Tier 3): fulcioSigningIdentity mints an ephemeral P-256 key, proves possession, requests a short-lived certificate from a Fulcio v2 authority (transport injected like the TSA), and wraps the chain in a PdfSigningIdentity to sign B-T (#322, #355).
• Internal refactors with no public API change: consolidate the composite-font path into one Type0Font module and one shared TextRunRewriter, and route text-box appearance generation through a single shared builder.

• Add a visible signature box for saveSigned/saveSignedPades: PdfSignatureAppearance describes the widget's page/rect, optional handwritten-signature or logo graphic, detail-line show flags, and background/border/text colours, rendered into the /AP /N form (name or graphic on the left, "Digitally signed by / Date / Reason / Location" auto-sized on the right). Output is byte-identical when no box is requested; document timestamps never get an appearance (#298).
• Round the corners of /Square annotations: ContentWriter.roundedRect bakes the radius into the /AP, persisted in /Border (§12.5.4) so it survives resize; restyleAnnotation(cornerRadius:) rounds or re-squares a placed rectangle in place (#297).
• Separate cloud/dash pattern scale from stroke width: the multiplier persists on /BE /I (PdfAnnotation.cloudBorderScale) and restyleAnnotation(cloudScale:) reproduces it across restyle and reshape; a cloud's /Rect is re-derived from the padded footprint so growing scallops no longer clip (#300).
• Recolour captured vector snapshots: PdfVectorSnapshotEditing gains isVectorSnapshotStamp and recolorVectorSnapshot, which forces every fill/stroke colour operator in the captured Form XObject to a target ink (recursing into nested forms, forking a private /Cap copy so other pastes keep their colours) while leaving geometry and images untouched; paste marks the stamp (DartPdfVectorSnapshot) (#301).
• Curl revision-cloud scallops inward with a trailing-foot lean for the hand-drawn look, keeping the outward apex extent (and BBox) unchanged (#295).
• Fill cloudy /Polygon annotations along the scalloped cloud path (fill+stroke in one pass) so the interior colour reaches the cloud edges (#287).
• Free-text appearances support line spacing, character spacing (Tc), horizontal glyph scaling (Tz), and underline (per box and per rich run), round-tripping through the annotation dictionary and /RC.
• Regenerate embedded-font and rich free-text boxes on resize (re-wrapping in the recovered face and preserving per-run styling) instead of falling back to the appearance stretch.

• Add operation-scoped page-content text replacement and expose the active font resource on text element snapshots for selection-driven editing.

• Version bump to keep the dart-pdf package suite aligned at 1.4.5. No document API changes since 1.4.4.

• Version bump to keep the dart-pdf package suite aligned at 1.4.4. No document API changes since 1.4.3.

• Add PdfBlankDocument.create for building standalone PDFs with one or more empty pages in a chosen standard or custom page size.
• Keep AcroForm text, button, and image appearances upright when fields are authored, filled, resized, or regenerated on rotated pages.

• Version bump to keep the dart-pdf package suite aligned at 1.4.2. No document API changes since 1.4.1.

• Add callout annotation authoring and editing, and correct cloudy polygon geometry and appearance generation.
• Add rich-text styling for in-place content text edits while preserving the surrounding PDF content structure.
• Centralize annotation capability policy and mutation impact tracking so editing operations invalidate only the document surfaces they change.
• Improve annotation, form, outline, page, redaction, reflow, and content editing robustness through the shared transaction path.

• Add document color-processing APIs that discover paint colors, replace multiple source colors in one pass, support page ranges, tolerance, and transparent replacements.
• Add cloudy polygon annotation appearance generation and resizing support for cloud-style shape markups.
• Improve annotation/page editing support used by the editor UI, including page-range extraction and more robust annotation duplication workflows.

• Add vector stamp templates (PdfStampTemplate and PdfStampTemplateComponent) with text, shapes, images, and saved-signature components. PdfEditor.addTemplateStamp writes them as normal stamp annotations with generated appearance streams.
• Stamp annotations can carry metadata (stampType and stampTags) and resolve dynamic {{field}} placeholders at placement time.
• Note and stamp appearances now account for page rotation when authored, so oriented pages receive counter-rotated annotation appearances.

• Annotation editing now handles malformed or indirect page /Annots entries consistently when adding, removing, reordering, flattening, signing, form editing, redacting, and pasting annotations. Invalid indirect /Annots values are left untouched and replaced by a valid page-owned array.
• Content rewriting, redaction, and structure-tagging paths now share the COS content-stream serializer, including inline-image round-tripping.

• Free-text annotations carry a horizontal alignment (left/center/right) through the /Q quadding: addFreeText and addFreeTextRich take an align argument, PdfFreeTextStyle.alignment reads it back, and resizing or re-editing a box preserves it. Omitting align keeps the previous behaviour - left for LTR text, right for RTL.
• Fix a free-text box auto-sized to its contents wrapping the last word onto a new line: the wrapper's strict width test now tolerates the sub-point floating-point round-off in (lineWidth + 2*pad) - 2*pad.

• Embeddable fonts: PdfEmbeddedFont.parse reads a TrueType (.ttf) or OpenType (.otf) file and addFreeText can now author text in it, embedding the font as a full-Unicode Type0/CIDFontType2 (Identity-H) composite with a /ToUnicode CMap - so authored text can use any font, not just the base-14 faces, and stays selectable, searchable, and portable. PdfEmbeddedFont.fromFreeText recovers the font from a box's own appearance for lossless re-editing.
• Fix non-Latin characters rendering as ?? in free-text annotation appearances.
• Fix free-text annotation appearances rendering sideways on rotated pages.
• Right-to-left text direction support in free-text annotations and AcroForm field appearances.
• Faster batch annotation deletion.

• Add a package example for pub.dev scoring.

• OCR text-layer injection is now used by the standalone app's downloadable on-device OCR flow.
• Version bump to keep the dart-pdf package suite aligned at 1.2.0.

• Page rotation: PdfEditor.rotatePages(indices, degrees) turns the named pages clockwise by a multiple of 90° (negative for counterclockwise), accumulating onto each page's current /Rotate.
• Vector snapshots: PdfEditor.captureVectorSnapshot captures a page region as detached vector graphics (PdfVectorSnapshot) and pasteVectorSnapshot re-materializes it onto any page as a /Stamp annotation whose appearance draws the captured content, so a snapshot pasted back into the PDF stays vector (crisp at any zoom), Bluebeam-style.
• Count tool: PdfEditor.addCheckMark places a Bluebeam-style check-mark stamp annotation (with PdfAnnotation.isCheckMark/iconName). It is the building block for a running on-page tally.
• Fix: JPEG 2000 tile-part desynchronization, and indexed Lab color palettes now decode correctly.

First stable release. Changes since 0.1.0:

• Line/PolyLine/Polygon annotations: reading and authoring with the full PDF Table 176 line-ending vocabulary, plus reshaping.
• Measurement annotations (§12.9): PdfMeasure/PdfNumberFormat, scale calibration (setMeasurementScale), and addMeasurement for distance/perimeter/area with a /Measure dictionary and a baked-in formatted caption.
• True redaction: mark /Redact regions and burn the underlying content irreversibly.
• Image stamps: PdfEditor.addImageStamp places a PNG/JPEG as a stamp annotation; dashed (/D) stroke patterns for all shape subtypes; and annotation flip when a resize handle is dragged past the zero point.
• Form widgets: resizeFormWidget rewrites a field's /Rect and regenerates its appearance at the new size.
• Page assembly: PdfEditor.insertBlankPage adds a new empty page at any position (sized to request, default US Letter), and PdfDocument.extractPageRange exports a contiguous span of pages as a standalone PDF alongside the existing appendPagesFrom (insert pages from another document) and extractPages (arbitrary subset).
• OCR text-layer injection: PdfEditor.injectTextLayer writes recognized PdfOcrSpans onto a page as invisible (render mode 3) text, sized and horizontally scaled to sit over each word. A scanned, image-only page becomes selectable, searchable, and extractable without changing how it looks. applyOcr (with a pluggable engine) lives in dart_pdf_editor.
• PdfImageDocument: assemble a brand-new PDF from a list of PNG/JPEG images, one page per image. This is the pure-Dart half of image/Office ingestion (multi-page TIFF, scans, camera shots).
• PdfImportSource: a host-provided seam for converting foreign formats (DOCX/XLSX/PPTX, …) to PDF bytes. Interface only; dart-pdf does not implement OOXML→PDF layout.

Initial release.

• PdfDocument: page tree with inherited attributes, metadata, outlines, text-page lookup.
• PdfEditor: incremental-save editing. Annotation authoring (highlight, ink with pressure, shapes, free text, notes, stamps), flattening, page manipulation (reorder, remove, append across documents, extract), content stamping/deletion/text replacement.
• Annotations: appearance generation, resize/rotate/restyle, slicing eraser, clipboard snapshots, /NM-keyed diff + replay for sync.
• Measurements (§12.9): PdfMeasure/PdfNumberFormat (parse/emit/format), scale calibration (setMeasurementScale), and addMeasurement for distance/perimeter/area annotations with a /Measure dictionary, a formatted /Contents, and a caption baked into the appearance (PdfAnnotation.measure/measurementText).
• AcroForm: field model, filling with regenerated appearances, field administration (add/rename/remove/retype/flatten), button images.
• Digital signatures: PdfSignature.validate() with optional trust-store chain validation, and signing via saveSigned.
• Image embedding: JPEG passthrough and full baseline PNG (all bit depths/color types, tRNS, Adam7) with alpha soft masks.