@cogenta/theme-docs 0.5.7 → 0.6.0

package/fonts/manifest.json

@@ -0,0 +1,101 @@
+{
+  "theme": "docs",
+  "faces": [
+    {
+      "family": "IBM Plex Sans",
+      "style": "italic",
+      "weight": "100 700",
+      "subset": "latin-ext",
+      "file": "ibm-plex-sans-italic-latin-ext-bf44b77c.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Sans';\n  font-style: italic;\n  font-weight: 100 700;\n  font-stretch: 100%;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-sans-italic-latin-ext-bf44b77c.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Sans",
+      "style": "italic",
+      "weight": "100 700",
+      "subset": "latin",
+      "file": "ibm-plex-sans-italic-latin-4363757d.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Sans';\n  font-style: italic;\n  font-weight: 100 700;\n  font-stretch: 100%;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-sans-italic-latin-4363757d.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    },
+    {
+      "family": "IBM Plex Sans",
+      "style": "normal",
+      "weight": "100 700",
+      "subset": "latin-ext",
+      "file": "ibm-plex-sans-normal-latin-ext-d160e209.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Sans';\n  font-style: normal;\n  font-weight: 100 700;\n  font-stretch: 100%;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-sans-normal-latin-ext-d160e209.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Sans",
+      "style": "normal",
+      "weight": "100 700",
+      "subset": "latin",
+      "file": "ibm-plex-sans-normal-latin-e2291e84.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Sans';\n  font-style: normal;\n  font-weight: 100 700;\n  font-stretch: 100%;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-sans-normal-latin-e2291e84.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "italic",
+      "weight": "400",
+      "subset": "latin-ext",
+      "file": "ibm-plex-mono-italic-latin-ext-1b07eee6.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: italic;\n  font-weight: 400;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-italic-latin-ext-1b07eee6.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "italic",
+      "weight": "400",
+      "subset": "latin",
+      "file": "ibm-plex-mono-italic-latin-0840095f.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: italic;\n  font-weight: 400;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-italic-latin-0840095f.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "400",
+      "subset": "latin-ext",
+      "file": "ibm-plex-mono-normal-latin-ext-6bc0f226.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 400;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-6bc0f226.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "400",
+      "subset": "latin",
+      "file": "ibm-plex-mono-normal-latin-08949f72.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 400;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-08949f72.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "500",
+      "subset": "latin-ext",
+      "file": "ibm-plex-mono-normal-latin-ext-6bb06407.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 500;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-6bb06407.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "500",
+      "subset": "latin",
+      "file": "ibm-plex-mono-normal-latin-01d28544.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 500;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-01d28544.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "600",
+      "subset": "latin-ext",
+      "file": "ibm-plex-mono-normal-latin-ext-32057cf5.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 600;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-32057cf5.woff2) format('woff2');\n  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}"
+    },
+    {
+      "family": "IBM Plex Mono",
+      "style": "normal",
+      "weight": "600",
+      "subset": "latin",
+      "file": "ibm-plex-mono-normal-latin-0d1f0b8d.woff2",
+      "css": "@font-face {\n  font-family: 'IBM Plex Mono';\n  font-style: normal;\n  font-weight: 600;\n  font-display: swap;\n  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-0d1f0b8d.woff2) format('woff2');\n  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogenta/theme-docs",
-  "version": "0.5.7",
+  "version": "0.6.0",
   "description": "A dense, reference-first documentation theme for Cogenta: a sticky sidebar-navigated doc layout, real code blocks, and a genuine dark mode — zero client JavaScript.",
   "license": "MPL-2.0",
   "type": "module",
@@ -16,10 +16,13 @@
     },
     "./tokens.json": "./tokens.json",
     "./styles/theme.css": "./src/styles/theme.css",
-    "./styles/*.css": "./src/styles/*.css"
+    "./styles/*.css": "./src/styles/*.css",
+    "./fonts/*.woff2": "./fonts/*.woff2",
+    "./fonts/manifest.json": "./fonts/manifest.json"
   },
   "files": [
     "dist",
+    "fonts",
     "src",
     "tokens.json"
   ],
@@ -36,17 +39,17 @@
     "directory": "packages/theme-docs"
   },
   "dependencies": {
-    "@cogenta/render": "0.5.0",
-    "@cogenta/theme-kit": "0.7.1",
-    "@cogenta/blocks": "1.1.6"
+    "@cogenta/blocks": "1.1.7",
+    "@cogenta/theme-kit": "0.7.2",
+    "@cogenta/render": "0.6.0"
   },
   "peerDependencies": {
-    "astro": "^7.2.1"
+    "astro": "^7.2.8"
   },
   "devDependencies": {
-    "astro": "^7.2.1",
+    "astro": "^7.2.8",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/render/blocks/logos.ts

@@ -34,7 +34,16 @@ export function renderLogos(block: LogosBlock, ctx: RenderContext): HtmlElement
           { class: 'cd-logos__item' },
           item.url === undefined
             ? mark
-            : h('a', { class: 'cd-logos__link', href: ctx.link(item.url), rel: 'noopener' }, mark),
+            : h(
+                'a',
+                {
+                  class: 'cd-logos__link',
+                  href: ctx.link(item.url),
+                  'aria-label': item.name,
+                  rel: 'noopener',
+                },
+                mark,
+              ),
         )
       }),
     ),

package/src/render/doc-page.ts

@@ -135,7 +135,12 @@ function renderBreadcrumb(
   )
 }
 
-function renderToc(ctx: RenderContext, anchors: HeadingAnchors): HtmlElement | null {
+function renderToc(
+  ctx: RenderContext,
+  anchors: HeadingAnchors,
+  narrow = false,
+): HtmlElement | null {
+  const prefix = narrow ? 'cd-tocn' : 'cd-toc'
   const list = [...anchors.values()]
   if (list.length < 2) return null
   const items: HtmlElement[] = []
@@ -143,9 +148,9 @@ function renderToc(ctx: RenderContext, anchors: HeadingAnchors): HtmlElement | n
   let parent: HeadingAnchor | undefined
   const close = (): void => {
     if (parent === undefined) {
-      for (const orphan of children) items.push(tocItem(orphan, []))
+      for (const orphan of children) items.push(tocItem(orphan, [], prefix))
     } else {
-      items.push(tocItem(parent, children))
+      items.push(tocItem(parent, children, prefix))
     }
     children = []
     parent = undefined
@@ -159,25 +164,45 @@ function renderToc(ctx: RenderContext, anchors: HeadingAnchors): HtmlElement | n
     }
   }
   close()
+  const label = word(ctx.locale, 'onThisPage')
+  if (narrow) {
+    // Below the wide breakpoint the page rail does not fit: the same list sits
+    // under the summary, in a disclosure (no script). Exactly one copy is
+    // displayed at any width.
+    return h(
+      'details',
+      { class: 'cd-tocn' },
+      h('summary', { class: 'cd-tocn__summary' }, label),
+      h(
+        'nav',
+        { class: 'cd-tocn__nav', 'aria-label': label },
+        h('ol', { class: 'cd-tocn__items' }, items),
+      ),
+    )
+  }
   return h(
     'nav',
     { class: 'cd-toc', 'aria-labelledby': 'cd-toc-label' },
-    h('p', { class: 'cd-toc__label', id: 'cd-toc-label' }, word(ctx.locale, 'onThisPage')),
+    h('p', { class: 'cd-toc__label', id: 'cd-toc-label' }, label),
     h('ol', { class: 'cd-toc__items' }, items),
   )
 }
 
-function tocItem(anchor: HeadingAnchor, children: readonly HeadingAnchor[]): HtmlElement {
+function tocItem(
+  anchor: HeadingAnchor,
+  children: readonly HeadingAnchor[],
+  prefix: string,
+): HtmlElement {
   return h(
     'li',
-    { class: 'cd-toc__item', 'data-level': String(anchor.level) },
-    h('a', { class: 'cd-toc__link', href: `#${anchor.id}` }, anchor.text),
+    { class: `${prefix}__item`, 'data-level': String(anchor.level) },
+    h('a', { class: `${prefix}__link`, href: `#${anchor.id}` }, anchor.text),
     children.length === 0
       ? null
       : h(
           'ol',
-          { class: 'cd-toc__items' },
-          children.map((child) => tocItem(child, [])),
+          { class: `${prefix}__items` },
+          children.map((child) => tocItem(child, [], prefix)),
         ),
   )
 }
@@ -261,6 +286,7 @@ export function renderDocPage(
   const anchors = headingAnchors(content)
   const ownHeading = pageHasOwnHeading(content)
   const toc = renderToc(ctx, anchors)
+  const narrowToc = renderToc(ctx, anchors, true)
 
   return h(
     'main',
@@ -287,6 +313,7 @@ export function renderDocPage(
           page.entry?.excerpt === undefined
             ? null
             : h('p', { class: 'cd-doc__lede' }, page.entry.excerpt),
+          narrowToc,
         ),
         h(
           'div',

package/src/render/rich-text.ts

@@ -136,7 +136,8 @@ function isCodeBlock(node: RichTextNode): boolean {
   )
 }
 
-const NOTE_LABEL = /^(note|tip|important|warning|caution)\s*[:.]?\s*$/i
+const NOTE_LABEL =
+  /^(note|tip|important|warning|caution|remarque|astuce|attention|avertissement|mise en garde)\s*[:.]?\s*$/iu
 
 function calloutLabel(node: RichTextNode): string | null {
   if (!isTextBlock(node) || node.style !== 'blockquote' || node.children.length < 2) return null
@@ -225,7 +226,7 @@ function renderCodeBlock(node: TextBlock): HtmlElement {
 }
 
 function renderCallout(ctx: RenderContext, node: TextBlock, label: string): HtmlElement {
-  const kind = /^(note|tip)$/i.test(label) ? 'note' : 'warning'
+  const kind = /^(note|tip|remarque|astuce)$/iu.test(label) ? 'note' : 'warning'
   const normalised = label.charAt(0).toUpperCase() + label.slice(1).toLowerCase()
   return h(
     'div',
@@ -293,6 +294,17 @@ function renderHeading(ctx: RenderContext, node: TextBlock, anchor: HeadingAncho
 // ---------------------------------------------------------------------------
 
 const NAMED_KEYS: ReadonlySet<string> = new Set([
+  'entrée',
+  'échap',
+  'suppr',
+  'maj',
+  'majuscule',
+  'espace',
+  'tabulation',
+  'haut',
+  'bas',
+  'gauche',
+  'droite',
   'ctrl',
   'control',
   'cmd',
@@ -321,6 +333,10 @@ const NAMED_KEYS: ReadonlySet<string> = new Set([
   '⌃',
 ])
 const LONE_KEYS: ReadonlySet<string> = new Set([
+  'entrée',
+  'échap',
+  'suppr',
+  'tabulation',
   'enter',
   'return',
   'esc',

package/src/render/search.ts

@@ -24,8 +24,20 @@ export function renderSearchForm(locale: string, id: string, size: SearchSize):
       action: SEARCH_PATH,
       method: 'get',
       role: 'search',
+      'aria-label': word(
+        locale,
+        id === 'cd-search-header'
+          ? 'headerSearch'
+          : id === 'cd-search-menu'
+            ? 'menuSearch'
+            : 'pageSearch',
+      ),
     },
-    h('label', { class: 'cg-visually-hidden', for: id }, word(locale, 'searchLabel')),
+    h(
+      'label',
+      { id: `${id}-label`, class: 'cg-visually-hidden', for: id },
+      word(locale, 'searchLabel'),
+    ),
     renderIcon('search', { className: 'cd-search__icon', size: 20 }),
     h('input', {
       id,

package/src/render/strings.ts

@@ -10,6 +10,9 @@ const STRINGS = {
   en: {
     search: 'Search',
     searchLabel: 'Search the documentation',
+    headerSearch: 'Search from the header',
+    menuSearch: 'Search from the menu',
+    pageSearch: 'Search this documentation',
     searchPlaceholder: 'Search the documentation',
     menu: 'Menu',
     documentation: 'Documentation',
@@ -27,6 +30,9 @@ const STRINGS = {
   fr: {
     search: 'Rechercher',
     searchLabel: 'Rechercher dans la documentation',
+    headerSearch: 'Rechercher depuis l’en-tête',
+    menuSearch: 'Rechercher depuis le menu',
+    pageSearch: 'Rechercher dans cette documentation',
     searchPlaceholder: 'Rechercher dans la documentation',
     menu: 'Menu',
     documentation: 'Documentation',

package/src/styles/base.css

@@ -33,6 +33,15 @@ body {
   font-synthesis: none;
   text-rendering: optimizeLegibility;
   -webkit-font-smoothing: antialiased;
+  /* A short page (a search with no result, a 404) keeps its footer at the
+     bottom of the window rather than under a strip of bare canvas. */
+  display: flex;
+  flex-direction: column;
+  min-block-size: 100vh;
+}
+
+body > main {
+  flex: 1 0 auto;
 }
 
 ::selection {

package/src/styles/blocks.css

@@ -536,6 +536,11 @@
   quotes: "\201C" "\201D";
 }
 
+.cd-quote__text:lang(fr),
+.cd-testimonial__quote:lang(fr) > p:first-child {
+  quotes: "\00AB\202F" "\202F\00BB";
+}
+
 .cd-quote__text::before,
 .cd-testimonial__quote > p:first-child::before {
   content: open-quote;

package/src/styles/chrome.css

@@ -28,7 +28,8 @@
 
 .cd-header__brand {
   display: inline-flex;
-  flex: none;
+  flex: 0 1 auto;
+  min-inline-size: 0;
   align-items: center;
   min-block-size: 44px;
   color: var(--cd-ink);
@@ -47,7 +48,7 @@
   font-weight: var(--cd-weight-semibold);
   letter-spacing: var(--cd-tracking-heading);
   line-height: 1;
-  white-space: nowrap;
+  overflow-wrap: anywhere;
 }
 
 .cd-wordmark__kind {
@@ -63,6 +64,7 @@
 
 .cd-header__nav {
   display: none;
+  flex: none;
   margin-inline-start: auto;
 }
 
@@ -84,6 +86,8 @@
   color: var(--cd-ink-soft);
   font-size: var(--cd-text-ui);
   text-decoration: none;
+  /* A two-word section ("Premiers pas") never breaks over two lines. */
+  white-space: nowrap;
 }
 
 .cd-header__item a:hover {
@@ -92,7 +96,8 @@
 
 .cd-header__end {
   display: flex;
-  flex: none;
+  flex: 0 1 auto;
+  min-inline-size: 0;
   align-items: center;
   gap: var(--cd-s2);
   margin-inline-start: auto;
@@ -130,7 +135,7 @@
   border: var(--cd-rule) solid var(--cd-line-strong);
   border-radius: var(--cd-radius-control);
   color: var(--cd-ink);
-  white-space: nowrap;
+  overflow-wrap: anywhere;
 }
 
 .cg-action[data-emphasis="outline"]:hover {
@@ -437,3 +442,10 @@
     grid-column: 6 / -1;
   }
 }
+
+.cd-header__logo {
+  max-inline-size: 100%;
+}
+.cd-header__inner > * {
+  min-inline-size: 0;
+}

package/src/styles/docs.css

@@ -370,6 +370,79 @@
   }
 }
 
+/* Narrow screens: the same list in a disclosure under the summary. */
+.cd-tocn {
+  max-inline-size: var(--cd-measure);
+  margin-block-start: var(--cd-s6);
+  border: var(--cd-rule) solid var(--cd-line);
+  border-radius: var(--cd-radius-control);
+}
+
+@media (min-width: 80rem) {
+  .cd-tocn {
+    display: none;
+  }
+}
+
+.cd-tocn__summary {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--cd-s3);
+  min-block-size: 44px;
+  padding-inline: var(--cd-s4);
+  color: var(--cd-ink);
+  font-size: var(--cd-text-ui);
+  font-weight: var(--cd-weight-semibold);
+  cursor: pointer;
+  list-style: none;
+}
+
+.cd-tocn__summary::-webkit-details-marker {
+  display: none;
+}
+
+.cd-tocn__summary::after {
+  content: "";
+  inline-size: 0.5rem;
+  block-size: 0.5rem;
+  margin-block-start: -0.25rem;
+  border-inline-end: var(--cd-rule-strong) solid var(--cd-ink-muted);
+  border-block-end: var(--cd-rule-strong) solid var(--cd-ink-muted);
+  rotate: 45deg;
+}
+
+.cd-tocn[open] > .cd-tocn__summary::after {
+  margin-block-start: 0.25rem;
+  rotate: 225deg;
+}
+
+.cd-tocn__nav {
+  padding: 0 var(--cd-s4) var(--cd-s3);
+}
+
+.cd-tocn__items {
+  display: grid;
+  gap: 0;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.cd-tocn__items .cd-tocn__items {
+  padding-inline-start: var(--cd-s4);
+}
+
+.cd-tocn__link {
+  display: block;
+  padding-block: var(--cd-s2);
+  color: var(--cd-link);
+  font-size: var(--cd-text-ui);
+  line-height: var(--cd-leading-ui);
+  text-decoration: none;
+  overflow-wrap: anywhere;
+}
+
 .cd-toc__label {
   margin: 0 0 var(--cd-s3);
   color: var(--cd-ink);
@@ -402,3 +475,9 @@
 .cd-toc__link:hover {
   color: var(--cd-ink);
 }
+
+.cd-doc__title,
+.cd-pager__title,
+.cd-doc__body {
+  overflow-wrap: anywhere;
+}

package/src/styles/fonts.css

@@ -0,0 +1,125 @@
+/*
+ * The web fonts of `@cogenta/theme-docs`, served by the site itself.
+ *
+ * GENERATED by `scripts/fetch-theme-fonts.mjs` — edit that script, not this
+ * file. The faces live in this package's `fonts/` directory and are sent by
+ * `cogenta serve` at `/_cogenta/fonts/docs/<file>`; no request leaves the
+ * site, so a visitor's address is never handed to a font provider. See
+ * `fonts/README.md` for the families, their licence and their source.
+ *
+ * `font-display: swap` keeps text visible in a system face while a file loads,
+ * and `unicode-range` splits Latin from Latin Extended so a French page
+ * downloads only the first.
+ */
+
+@font-face {
+  font-family: 'IBM Plex Sans';
+  font-style: italic;
+  font-weight: 100 700;
+  font-stretch: 100%;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-sans-italic-latin-ext-bf44b77c.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Sans';
+  font-style: italic;
+  font-weight: 100 700;
+  font-stretch: 100%;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-sans-italic-latin-4363757d.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'IBM Plex Sans';
+  font-style: normal;
+  font-weight: 100 700;
+  font-stretch: 100%;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-sans-normal-latin-ext-d160e209.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Sans';
+  font-style: normal;
+  font-weight: 100 700;
+  font-stretch: 100%;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-sans-normal-latin-e2291e84.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: italic;
+  font-weight: 400;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-italic-latin-ext-1b07eee6.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: italic;
+  font-weight: 400;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-italic-latin-0840095f.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-6bc0f226.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-08949f72.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 500;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-6bb06407.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 500;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-01d28544.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 600;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-ext-32057cf5.woff2) format('woff2');
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'IBM Plex Mono';
+  font-style: normal;
+  font-weight: 600;
+  font-display: swap;
+  src: url(/_cogenta/fonts/docs/ibm-plex-mono-normal-latin-0d1f0b8d.woff2) format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}