Document clickable PDF links with a downloadable alpha 14 report

.gitattributes

@@ -182,3 +182,9 @@ docs/assets/cloudflare-starter/** -text
 docs/assets/cloudflare-starter/*.pdf binary
 docs/assets/cloudflare-starter/*.png binary
 docs/assets/cloudflare-starter/*.zip binary
+
+# Keep the linked-report downloads and verification bytes immutable.
+docs/assets/pdf-links-alpha14/** -text
+docs/assets/pdf-links-alpha14/*.pdf binary
+docs/assets/pdf-links-alpha14/*.png binary
+docs/assets/pdf-links-alpha14/*.zip binary

docs/assets/pdf-links-alpha14/manifest.json

@@ -0,0 +1,34 @@
+{
+  "ok": true,
+  "at": "2026-10-23T14:23:20.103968+00:00",
+  "version": "2.6.0a14",
+  "source_commit": "0e418e174a0d1a4cfe44bc29828c48e635829d90",
+  "guide_sha256": "39282c56abfac46d68b76c9031ff56aecb62ed3b50a97e9bd4886b1d88409d37",
+  "public_pdf_identical": true,
+  "public_vs_local_native_previews_identical": true,
+  "public_vs_local_pdfium_previews_identical": true,
+  "website_preview_source": "PDFium raster of the downloadable PDF",
+  "files": {
+    "linked-report.pdf": {
+      "sha256": "1ad53b6d97dc3ad6f605e33c82325b1b0e75a805f5b06069cf0553fe1b3b1274",
+      "bytes": 160746
+    },
+    "page-1.png": {
+      "sha256": "8d6a014be2a686cc37fcea4a866dcebd5a6671dfee0520ce4b0531bbfee3ea15",
+      "bytes": 80497
+    },
+    "page-2.png": {
+      "sha256": "bf1b28c24516e2e765116558fcc6b36d9282f018fee6fe074f2185563e9467a1",
+      "bytes": 126640
+    },
+    "project.zip": {
+      "sha256": "a3ae4e0ea1a49c32d7c34788010b1757d70b99820afeaf6291f514dce2d4577a",
+      "bytes": 213884
+    },
+    "verification.json": {
+      "sha256": "62797ba48caf667be3d414f67203c3ad20ae7478f325f1880658d686d0f08d52",
+      "bytes": 4068
+    }
+  },
+  "snippets_receipt_sha256": "34a79d65ce8d82b61f970de75e94f136cd0b814f27ebf443bd9fbeda5764bdf3"
+}

docs/assets/pdf-links-alpha14/verification.json

@@ -0,0 +1,121 @@
+{
+  "ok": true,
+  "at": "2026-10-23T14:23:19.622531+00:00",
+  "version": "2.6.0a14",
+  "pdf_sha256": "1ad53b6d97dc3ad6f605e33c82325b1b0e75a805f5b06069cf0553fe1b3b1274",
+  "pages": 2,
+  "authored_links": 5,
+  "annotation_fragments": 6,
+  "links": [
+    {
+      "page": 1,
+      "rect": [
+        98.352996,
+        197.929016,
+        160.666994,
+        210.029015
+      ],
+      "target_page": 2,
+      "target_y": 495.591004
+    },
+    {
+      "page": 1,
+      "rect": [
+        98.352996,
+        161.929017,
+        198.196992,
+        174.029017
+      ],
+      "target_page": 2,
+      "target_y": 226.591015
+    },
+    {
+      "page": 2,
+      "rect": [
+        55.684998,
+        183.364016,
+        227.956991,
+        195.464016
+      ],
+      "uri": "https://docs.fullbleed.dev/"
+    },
+    {
+      "page": 2,
+      "rect": [
+        55.684998,
+        162.364017,
+        160.796994,
+        174.464017
+      ],
+      "uri": "mailto:hello@example.com"
+    },
+    {
+      "page": 2,
+      "rect": [
+        39.659998,
+        105.60502,
+        60.682998,
+        116.495019
+      ],
+      "target_page": 1,
+      "target_y": 555.591002
+    },
+    {
+      "page": 2,
+      "rect": [
+        60.707998,
+        105.60502,
+        112.939995,
+        116.495019
+      ],
+      "target_page": 1,
+      "target_y": 555.591002
+    }
+  ],
+  "diagnostics_ok": true,
+  "component_snippet_verified": true,
+  "component_annotation_fragments": 3,
+  "visual_review_pending": false,
+  "source_sha256": {
+    "report.html": "532fe583e0ca173443e0bfc55d7f20712c83d04cea63072d38c088cd61760354",
+    "report.css": "c3c2d6f4d1ff17fb0604cf049ba096c7deb19bd4b0d1f9201799797e3cdb9183",
+    "render.py": "26bc3dbc4a0107cbaccda75469a57be831ffe5fc69908ad1c7ffcac6b6ce023c"
+  },
+  "files": {
+    "component-links.pdf": "d8eb3d846ca2c71a72a69bee5b806dffb74f69f643dda223b16185054b149a89",
+    "component-styled.html": "12f8304efbde609e039d08fb3aa480cde3fb85643e7b096d4050c5958497bb60",
+    "component-unstyled.html": "ace387d8d59fd5e56e09e1d1f1ceda50fbae79fdb3fa7f9aee281b415acc62d5",
+    "diagnostics.json": "63e1c38dc9bfd16e1307c69cf823387235240398d2017c6a882e5cf0395542a2",
+    "diagnostics.stderr.txt": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    "pdfium-page-1.png": "8d6a014be2a686cc37fcea4a866dcebd5a6671dfee0520ce4b0531bbfee3ea15",
+    "pdfium-page-2.png": "bf1b28c24516e2e765116558fcc6b36d9282f018fee6fe074f2185563e9467a1"
+  },
+  "scope": "Actual two-page report, all five authored links in six native annotation fragments, page content and bounds, independent PDFium renders, runtime layout/font diagnostics, and the component snippet exports. The back link has two adjacent fragments with the same destination. Visual review is separate. No universal viewer or accessibility claim.",
+  "visual_review": {
+    "at": "2026-10-23T13:23:50.683692+00:00",
+    "reviewed_pages": [
+      1,
+      2
+    ],
+    "native_png_pages": [
+      1,
+      2
+    ],
+    "independent_reader": "PDFium",
+    "observations": [
+      "Two complete A5 pages; headings, metrics, index and footer fit without overlap or clipping.",
+      "All content and both page headers are present; the initial preview concern was not reproduced.",
+      "Link text is readable and underlined; both section destinations and the return link resolve to the intended pages.",
+      "Native width is 839 pixels; PDFium width is 840 at 144dpi because of page-size rounding. No pixel-parity assertion is made."
+    ],
+    "reproduced_from_public_wheel": true,
+    "matching_pdf_and_native_pngs": true,
+    "matching_independent_pdfium_pngs": true,
+    "local_receipt_sha256": "9e0eac8907af7d286afc9b4f348738ad6c1fd95e7190c038b77e28c10602d4e8"
+  },
+  "public_package": {
+    "version": "2.6.0a14",
+    "source_commit": "0e418e174a0d1a4cfe44bc29828c48e635829d90",
+    "release_verification_sha256": "e373f26fa3636e7e117d129161e31a0cb03d4e0688db1bdf6507495232b8db68"
+  }
+}

docs/examples.md

@@ -14,8 +14,8 @@ Common Ground report, Riverton notice, and Hillside statements were generated
 with the public **Fullbleed 2.4.0** wheel; the pandas report below
 uses **2.5.2**, the bilingual invoice uses **2.5.8**, and the Markdown brief uses
 **2.5.10**. The numbered report uses **2.5.18**, and the Streamlit report uses
-**2.5.23**. All sample data and organizations
-are fictional.
+**2.5.23**. The linked project handoff uses the opt-in **2.6.0a14**
+prerelease. All sample data and organizations are fictional.
 
 [Download showcase sources](assets/showcase/source.zip){ .md-button .md-button--primary }
 [Browse the source](https://github.com/fullbleed-engine/fullbleed-official/tree/b57e8ea5bb8315f04f7daac41a3489d21a2be158/examples/design_showcase){ .md-button }
@@ -107,6 +107,28 @@ project outline a clear visual structure.
 </div>
 </div>
 
+## A connected project handoff { #linked-report }
+
+<div class="showcase-entry" markdown>
+<figure markdown>
+[![Cedar Field Studio's green and cream project report with a snapshot and linked contents.](assets/pdf-links-alpha14/page-1.png)](assets/pdf-links-alpha14/linked-report.pdf)
+</figure>
+<div markdown>
+
+**Two pages · Section navigation · Web and email links**
+
+Jump from the contents to either section, open a source, or return to the
+overview. The project includes the HTML, CSS, bundled-font setup and Python
+render script. Generated with the opt-in **2.6.0a14** prerelease; stable 2.5.34
+predates the native-navigation feature.
+
+[Open the linked PDF](assets/pdf-links-alpha14/linked-report.pdf){ .md-button }
+[Download the project](assets/pdf-links-alpha14/project.zip){ .md-button }
+[Add links to your PDFs](guides/pdf-links.md)
+
+</div>
+</div>
+
 ## Northstar Studio invoice { #styled-invoice }
 
 <div class="showcase-entry" markdown>

docs/guides/component-preview-12.md

@@ -13,11 +13,12 @@ tree as a PDF, styled HTML or unstyled HTML without writing HTML strings.
 It preserves both earlier import paths and adds a complete document migration
 example: two implementations produce the same A5 and Letter landscape reports.
 
-The current opt-in release is **2.6.0a13**, which fixes rich-inline initial
-styling. This guide and its downloadable kit stay pinned to alpha 12; see the
-[release status](component-status.md) for the latest install command and
-[alpha 13 release notes](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.6.0a13)
-for the rendering fix.
+The current opt-in release is **2.6.0a14**, which adds native PDF navigation
+and fixes inline opacity and table-cell alignment. This guide and its downloadable
+kit stay pinned to alpha 12. See the [release status](component-status.md) for
+the latest install command, the [PDF links guide](pdf-links.md) for a working
+report, and the [alpha 14 release notes](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.6.0a14)
+for the rendering changes.
 
 [Download the migration source kit](https://github.com/fullbleed-engine/fullbleed-official/releases/download/v2.6.0a12/fullbleed-component-migration-2.6.0a12.zip){ .md-button .md-button--primary }
 [Read the migration reference](https://github.com/fullbleed-engine/fullbleed-official/blob/v2.6.0a12/docs/component-namespace.md){ .md-button }

docs/guides/component-status.md

@@ -5,13 +5,13 @@ description: Choose the stable Fullbleed Python component API or its opt-in 2.6
 
 # Python component release status
 
-Reviewed **21 October 2026**. Fullbleed's released Python component API is
+Reviewed **23 October 2026**. Fullbleed's released Python component API is
 available today. The newer API remains an opt-in alpha.
 
 | Channel | Install | Authoring surface |
 | --- | --- | --- |
 | Stable **2.5.34** | `python -m pip install fullbleed` | HTML/CSS rendering and the existing `fullbleed.ui` components |
-| Alpha **2.6.0a13** | `python -m pip install --pre "fullbleed==2.6.0a13"` | New authoring values under `fullbleed.components`; earlier imports remain supported |
+| Alpha **2.6.0a14** | `python -m pip install --pre "fullbleed==2.6.0a14"` | New authoring values under `fullbleed.components`; earlier imports remain supported |
 
 Start with the [Python quickstart](../getting-started/quickstart.md) for either
 HTML/CSS or stable components. Both examples produce the same invoice.
@@ -24,24 +24,25 @@ without styles. The [namespace and migration guide](component-preview-12.md)
 includes explicit styling examples and a complete kit pinned to alpha 12.
 Those authoring paths remain supported in the current alpha.
 
-Alpha 13 fixes `::first-letter` styling in paragraphs containing styled spans
-or links, including floated initials and paragraphs that continue across pages.
+Alpha 14 adds [native PDF links](pdf-links.md), including section jumps, web
+URLs and email links. It also corrects inline opacity and mixed-content table
+alignment. The earlier rich-inline initial fixes remain included.
 
 For interactive walkthroughs, [Explore the versioned component notebook](../getting-started/component-notebook.md)
 or [Try the current styling notebook](../getting-started/component-styling.md).
 Each notebook states its own package pin and includes downloadable output.
 
 ## Decision: retain the alpha
 
-The alpha is **merged into `master` and published on PyPI**. It is not an
-unmerged prototype. Merging it makes the implementation available for development;
-it does not make the new API a stable compatibility promise. Ordinary
-`pip install fullbleed` continues to select the stable channel.
+The component authoring implementation is **merged into `master`**, and
+prerelease packages are published on PyPI. The alpha label describes the API
+compatibility promise; merging the implementation does not make that promise
+stable. Ordinary `pip install fullbleed` continues to select the stable channel.
 
 The current release has substantial rendered-output evidence, including paired
 HTML/CSS and component showcases, saved PDFs, styled/unstyled HTML, page-band
 checks, typing checks and browser layout checks. The
-[alpha 13 release](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.6.0a13)
+[alpha 14 release](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.6.0a14)
 records the exact package and fixture evidence. Passing those checks establishes
 the tested behavior; it does not settle how the API should evolve for its callers.
 

docs/guides/css-corpus.md

@@ -38,6 +38,27 @@ comparison policy. They do not establish complete CSS support, arbitrary website
 rendering, or PDF standards conformance. The historical runs below keep their
 original versions and results.
 
+## Navigation alpha source comparison: 2.6.0a14
+
+The [final alpha 14 source run](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/39953154688)
+tests the tagged source tree at `0e418e174a0d1a4cfe44bc29828c48e635829d90`.
+It records **1,625 PASS, 19 FAIL and 18 REFERENCE-DISPUTED** across the same
+1,662 fixtures. The all-pass gate remains failed. Two fixtures improve against
+published alpha 13, with no new failing fixtures.
+
+All 7,467 manifest entries were verified. The 7,435 saved PDF/PNG files and
+every fixture verdict and raster metric match the qualified candidate; the
+29 remaining-failure PNGs also match published alpha 13. Inputs, references,
+comparator and thresholds are unchanged.
+
+[Complete source-run evidence](https://github.com/fullbleed-engine/fullbleed-official/releases/download/v2.6.0a14/fullbleed-css-corpus-2.6.0a14.zip)
+· [Scoped release checks](https://github.com/fullbleed-engine/fullbleed-official/releases/tag/v2.6.0a14)
+
+This is the final **source-built Linux wheel** comparison. The separate public
+package checks verify distribution hashes, a fresh installation and targeted
+fixtures; they are not a full-corpus run of every published wheel. The online
+explorer continues to show the stable published-wheel result above.
+
 ## Component alpha source comparison: 2.6.0a11
 
 The [alpha 11 source run](https://github.com/fullbleed-engine/fullbleed-official/actions/runs/39403828268)