explico 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -14,6 +14,23 @@ under **Breaking** below; a PATCH never breaks.
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-09-28
+
+### Fixed
+
+- **A side panel's labels wrap instead of scrolling sideways.** A chapter,
+  lesson or heading longer than the navigation or the "On this page" panel
+  is wide goes onto more lines, at any width, including one the reader
+  dragged a panel down to; a word longer than the panel hyphenates where the
+  language allows, else breaks. A resized panel used to keep each label on
+  one line and scroll sideways (`white-space: nowrap` on
+  `html[data-navigation-resized]` / `html[data-contents-resized]`), and the
+  "On this page" column kept a width taken from the navigation's
+  (`--sl-sidebar-width`), running past a narrowed panel's edge; it now fills
+  its panel. `.sidebar-pane` clips sideways (`overflow-x: hidden`), where a
+  compact chapter's invisible resting tooltip reached past it; a showing
+  tooltip is `position: fixed` and is never cut.
+
 ## [0.11.0] - 2026-09-28
 
 ### Breaking
@@ -2126,7 +2143,8 @@ under **Breaking** below; a PATCH never breaks.
   system with its completeness gate, the curriculum-graph validator, the
   Astro/Starlight UI, the LMS / session / analytics seams, and the `content` CLI.
 
-[Unreleased]: https://github.com/danieltuzes/explico/compare/v0.11.0...HEAD
+[Unreleased]: https://github.com/danieltuzes/explico/compare/v0.11.1...HEAD
+[0.11.1]: https://github.com/danieltuzes/explico/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/danieltuzes/explico/compare/v0.10.0...v0.11.0
 [0.10.0]: https://github.com/danieltuzes/explico/compare/v0.9.0...v0.10.0
 [0.9.0]: https://github.com/danieltuzes/explico/compare/v0.8.0...v0.9.0

package/docs/VERSIONING.md

@@ -105,7 +105,9 @@ applies every intervening section in order.
    the `migrating.md` section.
 6. Run `pnpm build && pnpm test`, then inspect `pnpm pack --dry-run` and confirm
    that `docs/authoring/migrating.md` and `docs/authoring/agents.md` are listed.
-7. Commit, then `git tag vx.y.z`.
+7. Commit, then tag it annotated: `git tag -a vx.y.z -m "explico x.y.z"`. With
+   `push.followTags` on, a plain `git push` sends an annotated tag with its
+   commit; a lightweight tag never travels that way.
 
 ## When you change the engine
 

package/docs/authoring/migrating.md

@@ -33,6 +33,62 @@ required config block throws with the section of this file to read.
 
 ---
 
+## 0.11.0 → 0.11.1
+
+**No course changes required.** This release has one fix, in the engine's
+stylesheet. A label in the navigation or the "On this page" panel that does
+not fit now wraps onto more lines instead of scrolling sideways, and that
+includes a panel the reader resized. No authoring rule, `CourseConfig` field,
+Astro wiring, course script or CLI command changes. The manifest schema stays
+v24.
+
+### 1. Update the dependency
+
+```bash
+pnpm add -D explico@0.11.1
+```
+
+**Coming from 0.8.0:** follow the "Coming from 0.8.0" note of "0.10.0 →
+0.11.0" below, and install 0.11.1 wherever it says to install 0.11.0.
+
+### 2. Only if your course CSS or browser tests reach into the side panels
+
+```bash
+rg -n 'data-(navigation|contents)-resized|\.sidebar-pane|\.right-sidebar|layout-(navigation|page-sidebar)-content' src content tests
+```
+
+No hit means nothing to do. Otherwise:
+
+- **A resized panel's labels** have `white-space: normal` (it was `nowrap`),
+  and the panel never scrolls sideways. A test that asserted `nowrap`, or
+  `scrollWidth > clientWidth` after narrowing a panel, now asserts that the
+  labels wrap and stay inside the panel.
+- **`.sidebar-pane`** has `overflow-x: hidden` at every width. The resized
+  "On this page" panel no longer sets `overflow-x: auto` or
+  `scrollbar-width: thin`, so it hides its scrollbar, as Starlight does by
+  default.
+- **In a resized "On this page" panel**, the column
+  (`.right-sidebar-panel .sl-container`) fills the panel. Its width used to
+  come from the navigation's `--sl-sidebar-width`. The default,
+  shrink-to-fit rail is unchanged.
+- **Word breaking.** Both panels' labels take `overflow-wrap: break-word`
+  and `hyphens: auto`, which replaces Starlight's `overflow-wrap: anywhere`
+  on the contents links. To break words differently, set these properties
+  on `.layout-navigation-content`, `.layout-page-sidebar-content` and
+  `.layout-page-sidebar-content a` in the course CSS.
+- **Screenshots** of a narrowed panel need re-recording.
+
+### 3. Verify
+
+```bash
+pnpm validate:content        # run twice: the first run regenerates build/resolution/*
+pnpm content check --changed
+astro check
+astro build
+```
+
+Then run the course's browser tests, if it has any.
+
 ## 0.10.0 → 0.11.0
 
 **Course changes are required.** Figures and diagrams no longer compact.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explico",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Build-time engine for prerequisite-aware, notation-rigorous course content: one validated content model, a semantic notation/citation/equation system with a completeness gate, and a deterministic JSON manifest.",
   "type": "module",
   "license": "UNLICENSED",

package/src/styles/global.css

@@ -1043,28 +1043,24 @@ details.layout-part-has-open > summary > .group-label {
     display: none;
   }
 
-  /* A panel the reader narrowed past its own labels scrolls sideways rather
-     than wrapping every chapter title into a column of single words. */
-  html[data-navigation-resized] .layout-navigation-content :is(a, summary) {
-    white-space: nowrap;
-  }
-
-  html[data-navigation-resized] .sidebar-pane {
-    overflow-x: auto;
-  }
-
-  /* A compact chapter's tooltip is a child of one of those links, and it is
-     the one label that must still wrap — it is sized by its own max-width,
-     not by the panel, so inheriting `nowrap` would run its text straight out
-     of its own background. */
-  html[data-navigation-resized]
-    .layout-compact-sidebar
-    details[data-compact]
-    > ul:not(.top-level)
-    > li
-    > a
-    > span {
-    white-space: normal;
+  /* A label that does not fit wraps onto more lines, and the side panels
+     never scroll sideways: a word longer than the panel is wide is
+     hyphenated where the language allows, else broken. Starlight's
+     `overflow-wrap: anywhere` on the contents links broke words at any
+     letter before hyphenation got a chance. */
+  .layout-navigation-content,
+  .layout-page-sidebar-content,
+  .layout-page-sidebar-content a {
+    overflow-wrap: break-word;
+    hyphens: auto;
+  }
+
+  /* With every label wrapping, what still reaches past the navigation's
+     edge is a compact chapter's resting tooltip (absolutely placed, and
+     invisible): it would only add a sideways scrollbar. A showing tooltip is
+     `position: fixed` (below), so this clip never cuts it. */
+  .sidebar-pane {
+    overflow-x: hidden;
   }
 
   html[data-navigation-hidden] {
@@ -1249,15 +1245,15 @@ details.layout-part-has-open > summary > .group-label {
     max-width: none;
   }
 
-  /* Starlight hides this panel's scrollbar (`scrollbar-width: none`), which
-     would quietly cut a heading the reader narrowed the panel past. */
-  html[data-contents-resized]:not([data-page-sidebar-hidden]) .right-sidebar {
-    overflow-x: auto;
-    scrollbar-width: thin;
-  }
-
-  html[data-contents-resized] .layout-page-sidebar-content :is(a, h2) {
-    white-space: nowrap;
+  /* Starlight sizes the column inside from the navigation's width
+     (`--sl-sidebar-width`), not from this panel: in a panel the reader set,
+     it fills the panel, so its headings wrap at the panel's edge instead of
+     running past it. */
+  html[data-contents-resized]:not([data-page-sidebar-hidden])
+    .right-sidebar-panel
+    .sl-container {
+    width: auto;
+    max-width: none;
   }
 
   html[data-page-sidebar-hidden] {