openpatch · mikebarkmin · Aug 7, 2026 · Aug 7, 2026
diff --git a/.changeset/gentle-pans-smile.md b/.changeset/gentle-pans-smile.md
diff --git a/.changeset/khaki-moles-tap.md b/.changeset/khaki-moles-tap.md
diff --git a/.changeset/olive-moons-shake.md b/.changeset/olive-moons-shake.md
diff --git a/.changeset/quiet-jokes-melt.md b/.changeset/quiet-jokes-melt.md
diff --git a/.changeset/spotty-jars-smash.md b/.changeset/spotty-jars-smash.md
diff --git a/packages/create/CHANGELOG.md b/packages/create/CHANGELOG.md
@@ -1,5 +1,12 @@
 # create-hyperbook
 
+## 0.3.10
+
+### Patch Changes
+
+- Updated dependencies [[`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535)]:
+  - @hyperbook/types@0.24.0
+
 ## 0.3.9
 
 ### Patch Changes

diff --git a/packages/create/package.json b/packages/create/package.json
@@ -1,6 +1,6 @@
 {
   "name": "create-hyperbook",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Shared logic for creating new Hyperbook projects",
   "platform": "node",
   "main": "./dist/index.js",

diff --git a/packages/fs/CHANGELOG.md b/packages/fs/CHANGELOG.md
@@ -1,5 +1,22 @@
 # @hyperbook/fs
 
+## 0.26.0
+
+### Minor Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order pages and sections together by `index`. Pages were always rendered before
+  the sections of the same level, so a page could not sit after or between them.
+  The `index` of a page and the `index` of a section are now one order, and a
+  section that ends up between two pages is rendered between them.
+
+  The reading order follows the navigation, so the previous and next buttons, the
+  breadcrumb and `::pagelist` agree with the sidebar.
+
+  A page or a section without an `index` keeps its old place: pages come before
+  sections, and a page wins a tie against a section. A book that gives its
+  sections an `index` but leaves it off a page will see that page move behind
+  those sections. Give the page an `index` to place it.
+
 ## 0.25.1
 
 ### Patch Changes

diff --git a/packages/fs/package.json b/packages/fs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperbook/fs",
-  "version": "0.25.1",
+  "version": "0.26.0",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",

diff --git a/packages/hyperbook/CHANGELOG.md b/packages/hyperbook/CHANGELOG.md
@@ -1,5 +1,46 @@
 # hyperbook
 
+## 0.102.0
+
+### Minor Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order pages and sections together by `index`. Pages were always rendered before
+  the sections of the same level, so a page could not sit after or between them.
+  The `index` of a page and the `index` of a section are now one order, and a
+  section that ends up between two pages is rendered between them.
+
+  The reading order follows the navigation, so the previous and next buttons, the
+  breadcrumb and `::pagelist` agree with the sidebar.
+
+  A page or a section without an `index` keeps its old place: pages come before
+  sections, and a page wins a tie against a section. A book that gives its
+  sections an `index` but leaves it off a page will see that page move behind
+  those sections. Give the page an `index` to place it.
+
+### Patch Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Inline the script that loads the light and dark stylesheets. It was a file, and
+  nothing can paint before the stylesheets it writes are there, so every first
+  paint waited for a round trip to fetch 1.5 kB and then another for the
+  stylesheets themselves. It is part of the page now, which measured about 140 ms
+  off the first contentful paint of the documentation on a throttled connection.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Fix the drawers flashing over the page while it loads. A custom element renders
+  its children until it is upgraded, and a side drawer is only hidden by its
+  shadow root, so the search drawer and the table of contents drawer painted over
+  the header and the article until `side-drawer.js` had run.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order the pages and the subsections of a section together too. Only the top
+  level of the navigation shared one order, so inside a section a subsection was
+  still rendered after every page of that section, and the sidebar disagreed with
+  the previous and next buttons, which already followed the index.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Indent the pages of a section in the navigation. They sat one pixel to the
+  right of a page of the level above, so only a hairline told the two levels
+  apart. That was harmless while every page came before every section, but a page
+  can sit after a section now, and it has to be readable as a page of the level
+  above.
+
 ## 0.101.0
 
 ### Minor Changes

diff --git a/packages/hyperbook/package.json b/packages/hyperbook/package.json
@@ -1,6 +1,6 @@
 {
   "name": "hyperbook",
-  "version": "0.101.0",
+  "version": "0.102.0",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",

diff --git a/packages/markdown/CHANGELOG.md b/packages/markdown/CHANGELOG.md
@@ -1,5 +1,46 @@
 # @hyperbook/markdown
 
+## 0.73.0
+
+### Minor Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order pages and sections together by `index`. Pages were always rendered before
+  the sections of the same level, so a page could not sit after or between them.
+  The `index` of a page and the `index` of a section are now one order, and a
+  section that ends up between two pages is rendered between them.
+
+  The reading order follows the navigation, so the previous and next buttons, the
+  breadcrumb and `::pagelist` agree with the sidebar.
+
+  A page or a section without an `index` keeps its old place: pages come before
+  sections, and a page wins a tie against a section. A book that gives its
+  sections an `index` but leaves it off a page will see that page move behind
+  those sections. Give the page an `index` to place it.
+
+### Patch Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Inline the script that loads the light and dark stylesheets. It was a file, and
+  nothing can paint before the stylesheets it writes are there, so every first
+  paint waited for a round trip to fetch 1.5 kB and then another for the
+  stylesheets themselves. It is part of the page now, which measured about 140 ms
+  off the first contentful paint of the documentation on a throttled connection.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Fix the drawers flashing over the page while it loads. A custom element renders
+  its children until it is upgraded, and a side drawer is only hidden by its
+  shadow root, so the search drawer and the table of contents drawer painted over
+  the header and the article until `side-drawer.js` had run.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order the pages and the subsections of a section together too. Only the top
+  level of the navigation shared one order, so inside a section a subsection was
+  still rendered after every page of that section, and the sidebar disagreed with
+  the previous and next buttons, which already followed the index.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Indent the pages of a section in the navigation. They sat one pixel to the
+  right of a page of the level above, so only a hairline told the two levels
+  apart. That was harmless while every page came before every section, but a page
+  can sit after a section now, and it has to be readable as a page of the level
+  above.
+
 ## 0.72.0
 
 ### Minor Changes

diff --git a/packages/markdown/package.json b/packages/markdown/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperbook/markdown",
-  "version": "0.72.0",
+  "version": "0.73.0",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",

diff --git a/packages/types/CHANGELOG.md b/packages/types/CHANGELOG.md
@@ -1,5 +1,22 @@
 # @hyperbook/types
 
+## 0.24.0
+
+### Minor Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order pages and sections together by `index`. Pages were always rendered before
+  the sections of the same level, so a page could not sit after or between them.
+  The `index` of a page and the `index` of a section are now one order, and a
+  section that ends up between two pages is rendered between them.
+
+  The reading order follows the navigation, so the previous and next buttons, the
+  breadcrumb and `::pagelist` agree with the sidebar.
+
+  A page or a section without an `index` keeps its old place: pages come before
+  sections, and a page wins a tie against a section. A book that gives its
+  sections an `index` but leaves it off a page will see that page move behind
+  those sections. Give the page an `index` to place it.
+
 ## 0.23.2
 
 ### Patch Changes

diff --git a/packages/types/package.json b/packages/types/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperbook/types",
-  "version": "0.23.2",
+  "version": "0.24.0",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",

diff --git a/platforms/vscode/CHANGELOG.md b/platforms/vscode/CHANGELOG.md
@@ -1,5 +1,50 @@
 # @hyperbook/vscode-extension
 
+## 0.53.0
+
+### Minor Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order pages and sections together by `index`. Pages were always rendered before
+  the sections of the same level, so a page could not sit after or between them.
+  The `index` of a page and the `index` of a section are now one order, and a
+  section that ends up between two pages is rendered between them.
+
+  The reading order follows the navigation, so the previous and next buttons, the
+  breadcrumb and `::pagelist` agree with the sidebar.
+
+  A page or a section without an `index` keeps its old place: pages come before
+  sections, and a page wins a tie against a section. A book that gives its
+  sections an `index` but leaves it off a page will see that page move behind
+  those sections. Give the page an `index` to place it.
+
+### Patch Changes
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Inline the script that loads the light and dark stylesheets. It was a file, and
+  nothing can paint before the stylesheets it writes are there, so every first
+  paint waited for a round trip to fetch 1.5 kB and then another for the
+  stylesheets themselves. It is part of the page now, which measured about 140 ms
+  off the first contentful paint of the documentation on a throttled connection.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Fix the drawers flashing over the page while it loads. A custom element renders
+  its children until it is upgraded, and a side drawer is only hidden by its
+  shadow root, so the search drawer and the table of contents drawer painted over
+  the header and the article until `side-drawer.js` had run.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Order the pages and the subsections of a section together too. Only the top
+  level of the navigation shared one order, so inside a section a subsection was
+  still rendered after every page of that section, and the sidebar disagreed with
+  the previous and next buttons, which already followed the index.
+
+- [#1159](https://github.com/openpatch/hyperbook/pull/1159) [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535) Thanks [@mikebarkmin](https://github.com/mikebarkmin)! - Indent the pages of a section in the navigation. They sat one pixel to the
+  right of a page of the level above, so only a hairline told the two levels
+  apart. That was harmless while every page came before every section, but a page
+  can sit after a section now, and it has to be readable as a page of the level
+  above.
+- Updated dependencies [[`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535), [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535), [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535), [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535), [`9bdb389`](https://github.com/openpatch/hyperbook/commit/9bdb389501ec7cbf96abaf8c6acbeededd311535)]:
+  - @hyperbook/markdown@0.73.0
+  - @hyperbook/fs@0.26.0
+  - create-hyperbook@0.3.10
+
 ## 0.52.0
 
 ### Minor Changes

diff --git a/platforms/vscode/package.json b/platforms/vscode/package.json
@@ -11,7 +11,7 @@
   },
   "homepage": "https://hyperbook.openpatch.org",
   "main": "./out/extension.js",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "engines": {
     "vscode": "^1.71.0"
   },