diegomura · diegomura · Aug 23, 2026 · Aug 23, 2026
diff --git a/.changeset/bump-media-engine.md b/.changeset/bump-media-engine.md
diff --git a/.changeset/experimental-pagination.md b/.changeset/experimental-pagination.md
diff --git a/.changeset/heavy-pages-repeat.md b/.changeset/heavy-pages-repeat.md
diff --git a/.changeset/lucky-pots-shave.md b/.changeset/lucky-pots-shave.md
diff --git a/.changeset/paginate-flownode-api.md b/.changeset/paginate-flownode-api.md
diff --git a/.changeset/render-props-return-instances.md b/.changeset/render-props-return-instances.md
diff --git a/packages/examples/next-14/CHANGELOG.md b/packages/examples/next-14/CHANGELOG.md
@@ -1,5 +1,12 @@
 # next-14
 
+## 0.1.25
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd)]:
+  - @react-pdf/renderer@4.7.0
+
 ## 0.1.24
 
 ### Patch Changes

diff --git a/packages/examples/next-14/package.json b/packages/examples/next-14/package.json
@@ -1,14 +1,14 @@
 {
   "name": "next-14",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "private": true,
   "scripts": {
     "dev": "next dev",
     "start": "next start",
     "lint": "next lint"
   },
   "dependencies": {
-    "@react-pdf/renderer": "^4.6.1",
+    "@react-pdf/renderer": "^4.7.0",
     "react": "^18",
     "react-dom": "^18",
     "next": "15.5.15"

diff --git a/packages/examples/next-15/CHANGELOG.md b/packages/examples/next-15/CHANGELOG.md
@@ -1,5 +1,12 @@
 # next-15
 
+## 0.1.25
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd)]:
+  - @react-pdf/renderer@4.7.0
+
 ## 0.1.24
 
 ### Patch Changes

diff --git a/packages/examples/next-15/package.json b/packages/examples/next-15/package.json
@@ -1,14 +1,14 @@
 {
   "name": "next-15",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "private": true,
   "scripts": {
     "dev": "next dev",
     "start": "next start",
     "lint": "next lint"
   },
   "dependencies": {
-    "@react-pdf/renderer": "^4.6.1",
+    "@react-pdf/renderer": "^4.7.0",
     "react": "19.1.0",
     "react-dom": "19.1.0",
     "next": "15.5.14"

diff --git a/packages/examples/vite/CHANGELOG.md b/packages/examples/vite/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @react-pdf/examples
 
+## 3.5.4
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd)]:
+  - @react-pdf/renderer@4.7.0
+  - @react-pdf/math@4.0.0
+  - @react-pdf/mermaid@4.0.0
+
 ## 3.5.3
 
 ### Patch Changes

diff --git a/packages/examples/vite/package.json b/packages/examples/vite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf/vite-example",
-  "version": "3.5.3",
+  "version": "3.5.4",
   "license": "MIT",
   "private": true,
   "author": "Diego Muracciole <diegomuracciole@gmail.com>",
@@ -11,9 +11,9 @@
     "build:site": "vite build ./src"
   },
   "dependencies": {
-    "@react-pdf/math": "^3.0.1",
-    "@react-pdf/mermaid": "^3.0.1",
-    "@react-pdf/renderer": "^4.6.1"
+    "@react-pdf/math": "^4.0.0",
+    "@react-pdf/mermaid": "^4.0.0",
+    "@react-pdf/renderer": "^4.7.0"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",

diff --git a/packages/font/CHANGELOG.md b/packages/font/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @react-pdf/font
 
+## 4.0.11
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae)]:
+  - @react-pdf/types@2.12.0
+
 ## 4.0.10
 
 ### Patch Changes

diff --git a/packages/font/package.json b/packages/font/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf/font",
-  "version": "4.0.10",
+  "version": "4.0.11",
   "license": "MIT",
   "description": "Register font and emoji source for react-pdf document",
   "author": "Diego Muracciole <diegomuracciole@gmail.com>",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@react-pdf/pdfkit": "^6.0.1",
-    "@react-pdf/types": "^2.11.3",
+    "@react-pdf/types": "^2.12.0",
     "fontkit": "^2.0.2",
     "is-url": "^1.2.4"
   },

diff --git a/packages/image/CHANGELOG.md b/packages/image/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @react-pdf/image
 
+## 3.1.2
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @react-pdf/svg@1.1.1
+
 ## 3.1.1
 
 ### Patch Changes

diff --git a/packages/image/package.json b/packages/image/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf/image",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "license": "MIT",
   "description": "Parses the images in png or jpeg format for react-pdf document",
   "author": "Diego Muracciole <diegomuracciole@gmail.com>",
@@ -23,7 +23,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@react-pdf/svg": "^1.1.0",
+    "@react-pdf/svg": "^1.1.1",
     "jay-peg": "^1.1.1",
     "png-js": "^2.0.0"
   },

diff --git a/packages/layout/CHANGELOG.md b/packages/layout/CHANGELOG.md
@@ -1,5 +1,58 @@
 # @react-pdf/layout
 
+## 5.0.0
+
+### Major Changes
+
+- [#3500](https://github.com/diegomura/react-pdf/pull/3500) [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd) Thanks [@diegomura](https://github.com/diegomura)! - Move render-prop element conversion from layout to the renderer
+
+  Render props are now wrapped at the reconciler boundary: by the time layout
+  calls them they return internal instances, not React elements. Layout's
+  `createInstances` is deleted and `resolvePagination` consumes instances
+  directly.
+
+  **Breaking (layout):** anyone calling `@react-pdf/layout` directly with
+  trees whose render props return React elements must convert the result
+  before handing it to layout — the contract is now instance arrays. Users of
+  `@react-pdf/renderer` are unaffected: the renderer performs the conversion.
+
+### Minor Changes
+
+- [#3505](https://github.com/diegomura/react-pdf/pull/3505) [`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae) Thanks [@diegomura](https://github.com/diegomura)! - Experimental pagination engine, opt-in per page
+
+  A new pagination engine ships alongside the current one: content is
+  measured once and packed into pages instead of relayouting on every split,
+  making long documents paginate orders of magnitude faster (a 300-page
+  document drops from ~40s to ~200ms).
+
+  Opt in with `<Page experimentalPagination>` — any page opting in switches
+  the whole document. The default behavior is unchanged.
+
+  Under the new engine:
+
+  - `<Page layout={Layout}>` renders per-page chrome (headers, footers,
+    sidebars) around the content. The layout component receives
+    `{ pageNumber, totalPages, subPageNumber, subPageTotalPages }` and the
+    page content as `children`, and runs once per output page. Using `layout`
+    implies `experimentalPagination`.
+  - One `fixed` semantic: in-flow fixed elements repeat at the top of every
+    page they span; footers are the layout's job.
+  - `minPresenceAhead` is supported, with one refinement: a trailing element
+    with nothing after it stays in place instead of moving to its own page.
+
+  The current engine remains the default until the next major, when the new
+  engine takes over.
+
+### Patch Changes
+
+- Updated dependencies [[`d38d17759b3856ab64c69101bd359aace4b532fc`](https://github.com/diegomura/react-pdf/commit/d38d17759b3856ab64c69101bd359aace4b532fc), [`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`482d7cd600ffa28c60b5db46e7eb1466398feb7b`](https://github.com/diegomura/react-pdf/commit/482d7cd600ffa28c60b5db46e7eb1466398feb7b), [`cb445c063adf87c2f250d11f7c36a71c7695bc61`](https://github.com/diegomura/react-pdf/commit/cb445c063adf87c2f250d11f7c36a71c7695bc61), [`cf1348df7bfbc8091ff495320a3ae798569ccc4e`](https://github.com/diegomura/react-pdf/commit/cf1348df7bfbc8091ff495320a3ae798569ccc4e)]:
+  - @react-pdf/stylesheet@6.2.4
+  - @react-pdf/primitives@4.4.0
+  - @react-pdf/types@2.12.0
+  - @react-pdf/paginate@1.0.0
+  - @react-pdf/textkit@6.4.2
+  - @react-pdf/image@3.1.2
+
 ## 4.7.1
 
 ### Patch Changes

diff --git a/packages/layout/package.json b/packages/layout/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf/layout",
-  "version": "4.7.1",
+  "version": "5.0.0",
   "license": "MIT",
   "description": "Resolve document component's layout",
   "author": "Diego Muracciole <diegomuracciole@gmail.com>",
@@ -21,12 +21,12 @@
   },
   "dependencies": {
     "@react-pdf/fns": "3.1.3",
-    "@react-pdf/image": "^3.1.1",
-    "@react-pdf/paginate": "0.1.0",
-    "@react-pdf/primitives": "^4.3.0",
-    "@react-pdf/stylesheet": "^6.2.3",
-    "@react-pdf/textkit": "^6.4.1",
-    "@react-pdf/types": "^2.11.3",
+    "@react-pdf/image": "^3.1.2",
+    "@react-pdf/paginate": "1.0.0",
+    "@react-pdf/primitives": "^4.4.0",
+    "@react-pdf/stylesheet": "^6.2.4",
+    "@react-pdf/textkit": "^6.4.2",
+    "@react-pdf/types": "^2.12.0",
     "emoji-regex-xs": "^1.0.0",
     "queue": "^6.0.1",
     "yoga-layout": "^3.2.1"

diff --git a/packages/math/CHANGELOG.md b/packages/math/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @react-pdf/math
 
+## 4.0.0
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd)]:
+  - @react-pdf/renderer@4.7.0
+  - @react-pdf/primitives@4.4.0
+  - @react-pdf/svg@1.1.1
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/math/package.json b/packages/math/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@react-pdf/math",
-  "version": "3.0.1",
+  "version": "4.0.0",
   "license": "MIT",
   "description": "Render LaTeX math expressions in react-pdf documents",
   "author": "Diego Muracciole <diegomuracciole@gmail.com>",
@@ -23,12 +23,12 @@
     "lib"
   ],
   "dependencies": {
-    "@react-pdf/primitives": "^4.3.0",
-    "@react-pdf/svg": "^1.1.0",
+    "@react-pdf/primitives": "^4.4.0",
+    "@react-pdf/svg": "^1.1.1",
     "mathjax-full": "^3.2.2"
   },
   "peerDependencies": {
-    "@react-pdf/renderer": ">=4.6.1",
+    "@react-pdf/renderer": ">=4.7.0",
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "devDependencies": {

diff --git a/packages/mermaid/CHANGELOG.md b/packages/mermaid/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @react-pdf/mermaid
 
+## 4.0.0
+
+### Patch Changes
+
+- Updated dependencies [[`ae9a9983e8bd8b63c3873000531a8307e22c7bae`](https://github.com/diegomura/react-pdf/commit/ae9a9983e8bd8b63c3873000531a8307e22c7bae), [`572cedc23493e4a3085e259bf129ceec458418bd`](https://github.com/diegomura/react-pdf/commit/572cedc23493e4a3085e259bf129ceec458418bd)]:
+  - @react-pdf/renderer@4.7.0
+  - @react-pdf/primitives@4.4.0
+  - @react-pdf/svg@1.1.1
+
 ## 3.0.1
 
 ### Patch Changes