Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,6 @@
*.png -text
*.pdf -text
*.wasm -text
test/fixtures/radial-gradient-endpoints-2.5.43.json -text
assets/fonts/*-OFL.txt -whitespace
test/fonts/*-OFL.txt -whitespace
19 changes: 17 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,13 @@ jobs:
python tools/verify-preformatted.py output/preformatted-baseline --negative-control
npm run render:preformatted
npm run verify:preformatted -- --baseline output/preformatted-baseline
- name: Verify radial endpoint colors, stitching bounds and the public failure control
run: |
npm install --prefix output/radial-baseline-consumer --ignore-scripts --no-audit --no-fund --save-exact fullbleed@0.8.6
node tools/render-radial-gradients.mjs --package-root output/radial-baseline-consumer/node_modules/fullbleed --out output/radial-baseline
python tools/verify-radial-gradients.py output/radial-baseline --negative-control
npm run render:radial
npm run verify:radial -- --baseline output/radial-baseline
- name: Verify hidden text and author display overrides in installed output
run: |
node tools/render-hidden-text.mjs
Expand All @@ -110,7 +117,7 @@ jobs:
npm run render:fonts -- --package-root output/font-baseline-consumer/node_modules/fullbleed --out output/font-baseline
npm run verify:fonts -- --evidence-root output/font-baseline --allow-legacy-metadata
npm run render:fonts
npm run verify:fonts -- --baseline output/font-baseline --reviewed-layout test/fixtures/inline-layout-2.5.41.json
npm run verify:fonts -- --baseline output/font-baseline --reviewed-layout test/fixtures/inline-layout-2.5.43.json
- name: Verify installed custom font families against explicit faces
run: |
npm run render:families
Expand Down Expand Up @@ -168,10 +175,13 @@ jobs:
output/generated-quotes-baseline-consumer/package-lock.json
output/text-decorations/
output/preformatted-whitespace/
output/radial-gradient-endpoints/
output/text-decorations-baseline/
output/text-decorations-baseline-consumer/package-lock.json
output/preformatted-baseline/
output/preformatted-baseline-consumer/package-lock.json
output/radial-baseline/
output/radial-baseline-consumer/package-lock.json
output/component-verification/
output/cloudflare-verification/
output/cloudflare-starter-verification/
Expand Down Expand Up @@ -215,7 +225,7 @@ jobs:
run: |
python -m pip install pypdf==6.19.0 pypdfium2==5.14.0 fonttools==4.65.0 pillow==12.3.0
npm run render:fonts
npm run verify:fonts -- --reviewed-layout test/fixtures/inline-layout-2.5.41.json
npm run verify:fonts -- --reviewed-layout test/fixtures/inline-layout-2.5.43.json
npm run render:families
npm run verify:families
npm run render:inline
Expand All @@ -238,6 +248,8 @@ jobs:
npm run verify:decorations
npm run render:preformatted
npm run verify:preformatted
npm run render:radial
npm run verify:radial
python tools/verify-components.py
npm run verify:cloudflare
python tools/verify-cloudflare.py
Expand Down Expand Up @@ -266,10 +278,13 @@ jobs:
output/generated-quotes-baseline-consumer/package-lock.json
output/text-decorations/
output/preformatted-whitespace/
output/radial-gradient-endpoints/
output/text-decorations-baseline/
output/text-decorations-baseline-consumer/package-lock.json
output/preformatted-baseline/
output/preformatted-baseline-consumer/package-lock.json
output/radial-baseline/
output/radial-baseline-consumer/package-lock.json
output/component-verification/
output/cloudflare-verification/
output/cloudflare-starter-verification/
Expand Down
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ no Python, Rust compiler, browser, or system fonts. MIT licensed.

Use `fullbleed` in Node.js, `fullbleed/browser` in a web application, or
[`fullbleed/cloudflare`](docs/cloudflare.md) inside a Cloudflare Worker.
Package **0.8.6** wraps the published **Fullbleed 2.5.41** engine.
Package **0.8.7** wraps the published **Fullbleed 2.5.43** engine.

[Try the browser playground](https://docs.fullbleed.dev/playground/) ·
[Documentation](https://docs.fullbleed.dev/getting-started/node/) ·
Expand Down Expand Up @@ -38,7 +38,7 @@ await writeFile('invoice.png', result.previews[0]);
Open `invoice.pdf` or its PNG preview. Inter is the default font. CommonJS also
works: `const { renderPdf } = require('fullbleed')`. TypeScript declarations are
included. For a pinned installation, use
`npm install --save-exact fullbleed@0.8.6`.
`npm install --save-exact fullbleed@0.8.7`.

Prefer components? [Compose documents with functions or JSX](#compose-documents-with-components)
and export HTML with or without styles using `fullbleed/ui`.
Expand Down Expand Up @@ -308,6 +308,10 @@ arbitrary browser pages.

## Release notes and verification

Version 0.8.7 corrects [radial-gradient endpoint colors and opacity](docs/radial-gradients.md)
and invalid zero-width gradient stitching intervals. The public JavaScript API
and isolation options are unchanged.

Version 0.8.6 fixes [authored whitespace and wrapping in code blocks](docs/preformatted-whitespace.md).
A `pre` block with `white-space: pre-wrap` can wrap within the page; long tokens
can use `overflow-wrap: anywhere`. Default `pre` and explicit no-wrap policies
Expand Down
6 changes: 3 additions & 3 deletions docs/browser.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Generate PDFs in a browser

The `fullbleed/browser` entry in Fullbleed 0.8.6 renders static HTML/CSS in a
dedicated Web Worker. It uses the same pinned 2.5.41 engine and bundled fonts as
The `fullbleed/browser` entry in Fullbleed 0.8.7 renders static HTML/CSS in a
dedicated Web Worker. It uses the same pinned 2.5.43 engine and bundled fonts as
the Node entry. The result is a `Uint8Array`, suitable for a PDF `Blob`, plus
optional PNG previews. No PDF server or account is required.

Expand All @@ -21,7 +21,7 @@ Install the package in your web project, then copy its browser files into the
directory your application serves as static files:

```sh
npm install --save-exact fullbleed@0.8.6
npm install --save-exact fullbleed@0.8.7
npx fullbleed-browser-assets public/fullbleed
```

Expand Down
2 changes: 1 addition & 1 deletion docs/cloudflare.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ local tests for normal, long, escaped and invalid invoices.
Use Node.js 22 or newer for your development tools:

```sh
npm install --save-exact fullbleed@0.8.6
npm install --save-exact fullbleed@0.8.7
npm install --save-dev --save-exact wrangler@4.151.3
```

Expand Down
22 changes: 22 additions & 0 deletions docs/radial-gradients.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Radial-gradient endpoint colors and opacity

Fullbleed 0.8.7 embeds engine 2.5.43. Radial gradients preserve the final color
and opacity outside the ending shape, including a color change at the last stop.

```css
.seal {
background: radial-gradient(circle 30pt at 50pt 50pt,
red, gold 100%, blue 100%);
}
```

The exterior is blue. A transparent final stop exposes the background beneath
the gradient. The update also corrects zero-width PDF stitching intervals.
The JavaScript API and worker/process isolation options are unchanged.

The installed-package checks cover twelve inputs in both isolation modes.
They inspect saved PDF bounds and compare PDF bytes, native pixels and PDFium
pixels with the qualified core 2.5.43 reference. The actual public 0.8.6 control
reproduces eighteen color failures and twenty invalid-stitching cases. Four
smooth/repeating controls retain their output exactly. These checks cover the
named fixtures; they are not a general CSS or PDF conformance claim.
6 changes: 3 additions & 3 deletions engine/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions engine/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
[package]
name = "fullbleed-node-adapter"
version = "0.8.6"
version = "0.8.7"
edition = "2024"
license = "MIT"
publish = false

[dependencies]
fullbleed = { version = "=2.5.41", features = ["svg_raster"] }
fullbleed = { version = "=2.5.43", features = ["svg_raster"] }

[profile.release]
lto = true
Expand Down
2 changes: 1 addition & 1 deletion examples/cloudflare/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,6 @@
"test": "node --test test/request.test.mjs",
"test:worker": "node test/worker.mjs"
},
"dependencies": { "fullbleed": "0.8.6" },
"dependencies": { "fullbleed": "0.8.7" },
"devDependencies": { "wrangler": "4.151.3" }
}
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 5 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "fullbleed",
"version": "0.8.6",
"version": "0.8.7",
"description": "Generate PDFs from HTML/CSS, components or JSX in Node.js, browsers and Cloudflare Workers, with bundled fonts and PNG previews.",
"type": "module",
"main": "./src/index.cjs",
Expand Down Expand Up @@ -107,7 +107,9 @@
"render:decorations": "node tools/render-text-decorations.mjs",
"verify:decorations": "python tools/verify-text-decorations.py",
"render:preformatted": "node tools/render-preformatted.mjs",
"verify:preformatted": "python tools/verify-preformatted.py"
"verify:preformatted": "python tools/verify-preformatted.py",
"render:radial": "node tools/render-radial-gradients.mjs",
"verify:radial": "python tools/verify-radial-gradients.py"
},
"dependencies": {
"@bjorn3/browser_wasi_shim": "0.4.2"
Expand Down Expand Up @@ -138,7 +140,7 @@
"access": "public"
},
"fullbleed": {
"engineVersion": "2.5.41"
"engineVersion": "2.5.43"
},
"devDependencies": {
"@types/node": "22.20.5",
Expand Down
4 changes: 2 additions & 2 deletions test/fixtures/default-styles.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"engineVersion": "2.5.41",
"engineVersion": "2.5.43",
"legacyPackage": "0.4.1",
"baseline": "Playground WASI renderer with unchanged HTML/CSS; legacy hashes from the published fullbleed@0.4.1 package.",
"wasmSha256": "2fc9dc5548df93a1d8bac7a7f898781ae7a46c4112911294a07756123d895c40",
Expand Down Expand Up @@ -90,5 +90,5 @@
}
],
"baselineEngineVersion": "2.5.24",
"compatibilityScope": "The existing source, control and output hashes are unchanged. Engine 2.5.41 must reproduce them before release."
"compatibilityScope": "The existing source, control and output hashes are unchanged. Engine 2.5.43 must reproduce them before release."
}
2 changes: 1 addition & 1 deletion test/fixtures/engine-paint-2.5.28.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"schema": "fullbleed.javascript.paint-fixtures.v1",
"engineVersion": "2.5.41",
"engineVersion": "2.5.43",
"provenance": [
{
"path": "tools/smoke_svg_styles.py",
Expand Down
4 changes: 2 additions & 2 deletions test/fixtures/hidden-text-2.5.24.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"schema": "fullbleed.javascript.hidden-text-fixtures.v1",
"engineVersion": "2.5.41",
"engineVersion": "2.5.43",
"sourceCommit": "6251674614fff698ce685733e81bf481e6e81313",
"sourceReview": "https://github.com/fullbleed-engine/fullbleed-official/pull/79",
"sourceVerificationSha256": "7d5a431ca20aa50d94022494a0d6acdbfd73632aca7159f6aa60a0cfc541a7cd",
Expand Down Expand Up @@ -1606,5 +1606,5 @@
}
],
"baselineEngineVersion": "2.5.24",
"compatibilityScope": "The existing source, control and output hashes are unchanged. Engine 2.5.41 must reproduce them before release."
"compatibilityScope": "The existing source, control and output hashes are unchanged. Engine 2.5.43 must reproduce them before release."
}
94 changes: 94 additions & 0 deletions test/fixtures/inline-layout-2.5.43.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
{
"schema": "fullbleed.reviewed_inline_layout.v1",
"engineVersion": "2.5.43",
"source": "https://crates.io/crates/fullbleed/2.5.43",
"reason": "Engine 2.5.43 must preserve the reviewed 2.5.41 outputs. Expected PDF, preview and text values are unchanged.",
"fonts": [
{
"name": "Inter-Variable.ttf",
"path": "fonts/Inter-Variable.ttf",
"bytes": 876576,
"sha256": "29160a80ff49ddcab2c97711247e08b1fab27a484a329ce8b813d820dc559031"
},
{
"name": "DMSerifDisplay-Regular.ttf",
"path": "fonts/DMSerifDisplay-Regular.ttf",
"bytes": 76580,
"sha256": "8cc3643535edf039aa5d95440a8542735e9197e4f4b8d9303e980fefbf5ab616"
},
{
"name": "DMSerifDisplay-Italic.ttf",
"path": "fonts/DMSerifDisplay-Italic.ttf",
"bytes": 71208,
"sha256": "df74c0ac387baeaeb0fe4f2324e1668e6a3ed8c09cd9796fe162c71753e19e45"
},
{
"name": "BebasNeue-Regular.ttf",
"path": "fonts/BebasNeue-Regular.ttf",
"bytes": 61400,
"sha256": "08e4623805102d819f58601e46e345648846075e363b2ceb23313c2d1c83ec73"
},
{
"name": "NotoSansMath-Regular.ttf",
"path": "fonts/NotoSansMath-Regular.ttf",
"bytes": 590904,
"sha256": "80b61fd613d3519197e64fff6f7e71fdc7f3e6526440ea4115b554ef7fd59af7"
}
],
"fixtures": {
"invoice": {
"htmlSha256": "195725eeeb32c521e19b47dbacbb55048bebb6df8566ab135cdc41fbf33fe57a",
"cssSha256": "cda22b39ab1f7a1eeac7cd76d162b05cd3568c2430c099123ba30a2fbd58a296",
"pages": 1,
"text": "Northstar\nStudio\nD E S I G N W I T H D I R E C T I O N\nB R A N D\nD I G I T A L\nE X P E R I E N C E S\nT H A T M A T T E R .\n42 Cedar Avenue\nPortland, OR 97205\nhello@example.invalid\nnorthstar.example.invalid\nINVOICE\nGOOD WORK.\nCLEAR DETAILS.\nLET'S MAKE\nWHAT'S NEXT.\nP R E P A R E D F O R\nMaple & Finch\nAttn. Avery Morgan\nPortland, Oregon\nT H E P R O J E C T\nAutumn launch\nBrand workshop, digital\ndesign & handoff\nI N V O I C E N S - 1 0 4 2\nIssued · 01 October 2026\nDue · 31 October 2026\nCurrency · USD\nDESCRIPTION HOURS RATE AMOUNT\nDiscovery & brand workshop\nPositioning, priorities, and a clear creative direction\n8 $125.00 $1,000.00\nDigital design & implementation\nA cohesive visual system, from layout to launch\n6 $95.00 $570.00\nReview & studio handoff\nFinal refinements, documentation, and delivery\n2 $150.00 $300.00\nA little clarity.\nA lot of possibility.\nThank you for inviting us\nto help shape your next chapter.\nSubtotal $1,870.00\nTax · 0% in this sample $0.00\nT O T A L D U E · U S D\n$1,870.00\nP A Y M E N T D E T A I L S\nReference NS-1042 with your payment.\nPayment instructions are supplied separately.\nA N O T E F R O M T H E S T U D I O\nQuestions about a line item?\nWrite to hello@example.invalid.\nNORTHSTAR STUDIO / INVOICE NS-1042 FICTIONAL SAMPLE · 01 / 01",
"pdfSha256": "3078d155f30536f5ad721f7be3c241cd78661ae41249131fc0fd65f37f23e408",
"previewsSha256": [
"72420749ccc3deaa8025daf7baffcdf79be716b6e8e93ed605effebed01e86c7"
],
"pdfiumPixelSha256": [
"d71293741974bef9abffbdf5d88b0827b48fe6523f8d9baf46f46fe1000895a5"
]
},
"report": {
"htmlSha256": "46b0e975d43914c8b4492218feae09ea0ad684091a9f9ee3b18f66a87202e521",
"cssSha256": "519591ae75c239ec602324f008dd99108ebeae0b9306df7215fa5f0442905473",
"pages": 3,
"text": "Common Ground\nC O M M U N I T Y T R U S T\nP E O P L E\nP L A C E S\nP O S S I B I L I T I E S\nCOMMON\nGROUND\nStronger places.\nMore room\nfor everyone.\n2026\nC O M M U N I T Y R E V I E W\nA Y E A R\nI N C O M M O N\n0 2 / O U R R E A C H\nSmall actions,\nshared outcomes.\n0 3 / O U R R E S O U R C E S\nWhere the\nsupport goes.\nCOMMON GROUND / COMMUNITY REVIEW FICTIONAL DATA · 01 / 03Common Ground\n0 2 / O U R R E A C H\nA P L A C E T O B E G I N\nSmall actions.\nShared outcomes.\nAn open door, a working kitchen, a garden plot. This year, our fictional neighborhood\nprograms connected more people with practical spaces to learn, make, and belong.\n1,240\nhouseholds took part\nacross four neighborhoods\n4,860\nvolunteer hours\nshared across our programs\n12\ncommunity spaces\nkept open and active\nMore neighbors, each quarter.\nP A R T I C I P A T I N G H O U S E H O L D S\n420\n560\n790\n980\nQ1 Q2 Q3 Q4\nQuarterly participation counts; a household can participate in more than one quarter.\n“Belonging starts\nwith somewhere\nto show up.”\nO U R P R O G R A M P R I N C I P L E\nBuilt around daily life.\nEvening workshops, shared meals, and weekend garden\nsessions made participation easier for people with different\nschedules. The next step is a longer opening window at\neach neighborhood space.\nILLUSTRATIVE ANNUAL REVIEW / NOT AN ACTUAL ORGANIZATION 02 / 03Common Ground\n0 3 / O U R R E S O U R C E S\nF O L L O W T H E S U P P O R T\nGood intentions.\nClear allocations.\nA practical view of this fictional operating budget. Every category supports the same\naim: useful places, open to more people.\nPROGRAM AREA ALLOCATION SHARE\nNeighborhood spaces $168,000.00 40%\nLearning & workshops $126,000.00 30%\nShared meals & gardens $84,000.00 20%\nAccess & transport $42,000.00 10%\nT O T A L O P E R A T I N G A L L O C A T I O N · U S D $420,000.00\nWhat we count.\nHouseholds are deduplicated within the annual program\nregister. Volunteer hours include recorded event and\nmaintenance time. Space counts refer to year-round\nlocations, not individual events.\nQuarterly counts show participation within each period and\nmust not be added to estimate unique annual reach.\nWhat comes next.\nExtend evening access. Improve step-free entrances.\nPublish a simple monthly view of program activity and\nspending.\nA shared tomorrow\nis built in the everyday.\nCOMMON GROUND / METHODS & ALLOCATIONS FICTIONAL DATA · 03 / 03",
"pdfSha256": "80fc4306db1898688d846cfea4fb1b4ef5bf07713fe9301662143619441205b5",
"previewsSha256": [
"33ee3398d59f6836368cdab0f3c725c3cf12cbf2f9f3a3ac6a6b168f6c1886f5",
"9e883a04ab32392aa87ef5931761285b8dc15f8fd642b4f9bbea582c044bcdbe",
"8c8bfdc01ef7a3c376fbe61a0736dbc5b65280b0781f0040c550e097e71a5dcd"
],
"pdfiumPixelSha256": [
"c7dc8db8fc08a78f74c4477629e0f68f3b34aa37b9b9eba46a977805933d3f03",
"50298b3a05370f4dcefedf47b121c1da74e48307e85fac695dfbc5c1207b100e",
"55c5468322b64ae2583439553a13057218c418d38c4fcbeb0e492ec98160961c"
]
}
},
"baselineSource": "https://crates.io/crates/fullbleed/2.5.24",
"previousReference": "inline-layout-2.5.41.json",
"previousReferenceSha256": "e6c796356e3b1360885ad3ea9c1ae27adda484f76cc6fee9c1f31fb7c9eae828",
"previousReview": {
"unchangedFixtures": [
"invoice",
"inter",
"dm-serif",
"dm-serif-italic",
"bebas-neue",
"math"
],
"reportPages": 3,
"changedGlyphsPerPage": [
0,
12,
12
],
"change": "Common Ground heading baseline: 0.75pt down on pages 2 and 3.",
"allContentPreserved": true,
"allGlyphsWithinPage": true,
"publicPythonCore": "2.5.34",
"publicPythonPdfSha256": "80fc4306db1898688d846cfea4fb1b4ef5bf07713fe9301662143619441205b5"
}
}
Loading
Loading