betto_pdfium

Fixed

• Native library resolution in a Pub workspace. When dart test runs from a workspace member package, the native-assets pipeline stages the bundled PDFium library to the workspace root .dart_tool/lib/, not the package's own. The runtime loader previously probed only the current directory, so a PDFium call issued from a spawned isolate (which cannot see the test runner's LD_LIBRARY_PATH) failed to load the library with cannot open shared object file. The loader now walks up from the working directory, probing each ancestor's .dart_tool/lib/, covering both the single-package and workspace layouts on Linux, macOS, and Windows. This surfaced under Dart 3.13 in the kmdb workspace's PDF vault indexing.

Toolchain

• Dart 3.13 support. SDK constraint raised to ^3.13.0. Verified end-to-end against the Dart 3.13 native-assets pipeline: the prebuilt-binary build hook, library loading, and the full native API surface (text/annotation/image extraction, rendering, and search) pass on macOS, Linux (x64 and arm64), and Windows.
• lcov 2.x build compatibility. Coverage lcov/genhtml invocations now pass --ignore-errors empty, so the line-only tracefiles Dart emits no longer fail the build under lcov 2.0 (shipped on current Ubuntu runners).
• Regenerated the web pdfium_worker.js with the Dart 3.13 toolchain.

First developer preview. All core PDF operations are implemented and tested (96.1 % line coverage). API is subject to change before 1.0.

Platform support

Pre-built PDFium binaries (bblanchon/pdfium-binaries chromium/7906) are shipped for:

• macOS arm64
• Linux x86_64 and arm64
• iOS arm64 (xcframework via SPM)
• Android arm64 and x86_64

The binary is downloaded automatically by the native-assets hook on the first dart test or dart run — no manual setup needed on desktop. Windows and WASM are not yet supported.

Document loading

• PdfDocument.fromBytes(Uint8List) — loads a PDF from raw bytes into a background isolate so the calling isolate is never blocked.
• PdfExtractionException — thrown when loading fails; exception.error distinguishes PdfError.passwordRequired from PdfError.invalidDocument.
• PdfDocument.close() — releases the native PDFium handle; safe to call more than once. A Finalizer is registered as a fallback but explicit disposal is preferred. After close(), all methods throw StateError.

Metadata and document info

• getMetadata() — returns PdfMetadata with title, author, subject, keywords, creator, producer, creationDate, and modificationDate. All fields are nullable; dates are PdfDate values with a parsed DateTime?.
• getDocumentInfo() — returns PdfDocumentInfo with fileVersion and the 16-byte permanentId / changingId file identifiers.
• pageCount — total page count.

Text extraction

• extractPlainText({int? pageIndex}) — streams PdfPageText per page. Each result carries text, hasTextLayer, and hasUnicodeErrors.
• isPlainTextExtractable() — quick check that returns false when too many pages lack a text layer (configurable via PdfTextExtractorConfig.scannedPageRatio).
• Cancelling the stream or calling close() stops further processing immediately with no handle leaks.

Page size and rendering

• getPageSize(int pageIndex) — returns PdfPageSize with widthPt, heightPt, aspectRatio, and sizeForDpi(dpi) for pixel conversion.
• renderPageToBytes(pageIndex, pixelWidth, pixelHeight) — renders a page to a raw BGRA pixel buffer; returns ({Uint8List pixels, int pixelWidth, int pixelHeight}). Optional flags: renderAnnotations, lcdText, backgroundColor (ARGB packed int).

Annotation extraction

• extractAnnotations({int? pageIndex}) — streams PdfPageAnnotations per page; pages with no annotations yield an entry with an empty list so callers can track page coverage without gaps.
• Concrete annotation types: PdfTextAnnotation, PdfMarkupAnnotation (highlight, underline, squiggly, strikeout), PdfFreeTextAnnotation, PdfInkAnnotation, PdfShapeAnnotation, PdfPopupAnnotation, PdfStampAnnotation, PdfUnknownAnnotation.
• PdfMarkupAnnotation includes quadPoints for precise text-span geometry.
• Annotations with a linked popup carry a non-null popup field.

Image extraction

• extractImages({int? pageIndex, bool includeBitmap}) — streams PdfPageImages per page, each containing a list of PdfImage objects with bounding box and PdfImageMetadata (dimensions, colour space, bits per pixel, filter chain).
• includeBitmap: false (default) — metadata-only; no bitmap allocation.
• includeBitmap: true — populates PdfImage.bgra for every image on the page.
• renderImage(pageIndex, objectIndex) — fetches the BGRA bitmap for a single image object on demand; returns null for mask-only images.

Search

• search(String query, {Set<PdfSearchFlag> flags, int? pageIndex}) — streams PdfSearchMatch values with pageIndex, charIndex, and rects in PDF user-space (origin bottom-left).
• Search flags: PdfSearchFlag.matchCase, PdfSearchFlag.matchWholeWord, PdfSearchFlag.consecutive.

Table of contents

• tableOfContents — returns the complete bookmark tree as List<PdfTocEntry>. Each entry has title, pageIndex, and children for nested entries. Returns an empty list when the document has no bookmarks.

Thumbnails

• getThumbnail(int pageIndex, {bool generateIfAbsent, int maxDimension}) — returns a PdfThumbnail with bgra, width, height, and source (embedded or rendered). When no embedded /Thumb stream is present, a fallback render is produced at the requested maxDimension (longest edge) unless generateIfAbsent: false.

pdfinfo CLI tool

• dart run bin/pdfinfo.dart — a command-line tool for inspecting PDF metadata, document info, page count, table of contents, and plain-text extractability.