@aitrien/motifspec 1.13.0 → 1.13.3

package/docs/hugo.md

@@ -1,120 +1,132 @@
-# Using MotifSpec in Hugo
-
-The module ships the components as Hugo partials and the Markdown render hooks that turn content into them, so a site writes its page templates and content and nothing else. The partials follow `docs/components/*.md`; when a partial and its doc disagree, the doc is the contract and the partial is the bug.
-
-## Setup
-
-```toml
-[module]
-  [[module.imports]]
-    path = "github.com/aitrien/motifspec"
-
-[markup.highlight]
-  noClasses = false
-
-[markup.goldmark.parser]
-  wrapStandAloneImageWithinParagraph = false   # standalone images reach render-image.html, so they can become figures
-  [markup.goldmark.parser.attribute]
-    block = true                              # {caption="…"} on tables, {file="…"} on code, {width="prose"} on figures
-```
-
-Pin a release with `hugo mod get github.com/aitrien/motifspec@vX.Y.Z`. The module mounts `dist/` at `assets/motifspec`, `fonts/` at `static/fonts` and `layouts/` at `layouts`.
-
-## The page shell
-
-```go-html-template
-<!doctype html>
-<html lang="{{ site.Language.LanguageCode }}">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
-  {{ partial "motifspec/head.html" . }}
-  {{/* the site's own <title>, meta description, favicon */}}
-</head>
-<body class="cx-backdrop-page">
-  {{ partial "motifspec/body-start.html" . }}
-  {{ partial "motifspec/site-header.html" . }}
-  <main id="main" tabindex="-1">{{ block "main" . }}{{ end }}</main>
-  {{/* the site's footer (site-footer.md) */}}
-  {{ partial "motifspec/body-end.html" . }}
-</body>
-</html>
-```
-
-| Partial | What it writes |
-|---|---|
-| `motifspec/head.html` | The stored-theme snippet, font preloads, `codex.css` and `codex.js`, in that order. |
-| `motifspec/body-start.html` | The backdrop, the icon sprite and the skip link to `#main`. |
-| `motifspec/site-header.html` | `site-header.md`: wordmark from `site.Title` and `site.Params.role`, nav from `site.Menus.main`, the backdrop pause control and the theme toggle. A menu entry is current when its `identifier` is the page's section. |
-| `motifspec/body-end.html` | `plate.js`, which drifts the backdrop and reveals the pause control. |
-
-The footer stays in the site: its columns are the site's own links and colophon. Use the markup in `site-footer.md`.
-
-## Component partials
-
-Every partial below is called as `partial "motifspec/<name>.html" <context>`.
-
-| Partial | Doc | Context |
-|---|---|---|
-| `article.html` | `prose.md`, `table-of-contents.md`, `ornament.md` | `dict "page" . "toc" "always"` or `"auto"` (auto shows the TOC at three or more h2s). Ends the prose with the end mark, so the content must end with a paragraph. |
-| `project-card.html` | `project-card.md` | `dict "page" . "level" 2` (the heading level that fits the page outline; default 3). |
-| `post-list-item.html` | `post-list-item.md` | `dict "page" . "level" 3`. Writes an `<li>`, so put it in `<ol class="cx-posts">`. |
-| `accession/label.html` | `accession-label.md` | `dict "page" . "variant" "lead"` above the title, or `"card"` after the article (shown on a phone). |
-| `accession/id.html` | `accession-label.md` | A page. The compact number, date and reading time line. |
-| `accession/status.html` | `accession-label.md` | `live`, `building` or `archived`. |
-| `figure.html` | `figure.md` | `dict "image" <resource> "alt" "…" "caption" <HTML> "plate" 1`, plus `"eager" true` for the largest image above the fold and `"prose" true` to keep it to the text measure. |
-| `table-of-contents.html` | `table-of-contents.md` | A page. `article.html` already calls it. |
-| `tags.html` | `tag.md` | `dict "page" . "max" 3`. |
-| `tag-filter.html` | `tag.md` | `dict "section" "work" "current" nil` on a section page, or `dict "section" "" "current" .` on a term page. |
-| `filed-under.html` | `tag.md`, `docs/templates.md` | A page. "Filed under" and its tags, after an article. |
-| `pagination-entries.html` | `pagination.md` | `dict "page" . "label" "Post navigation" "noun" "Post"`. Previous and next in the page's section, oldest first. |
-| `pagination-pages.html` | `pagination.md` | `dict "pager" $pager "label" "Writing pages"`. Pages of a paginated list; nothing when it fits on one page. |
-| `back-link.html` | `button-and-link.md` | `dict "href" "…" "label" "All work"`. |
-| `section-heading.html` | `heading-anchor.md` | `dict "id" "work" "title" "Selected work"`, inside a `<section id="work" aria-labelledby="work-title">`. |
-| `tokens.html` | | Call with `partialCached "motifspec/tokens.html" "tokens"`. A map from token name to its entry in `dist/tokens.json`, for templates that need a token's value at build time. |
-| `h2s.html` | | A page. Its h2 headings with their h3 children; used by the article and the TOC. |
-
-## Front matter the partials read
-
-| Field | Used by | Notes |
-|---|---|---|
-| `summary` | cards, rows | The lede and the card or row summary. |
-| `tags` | tags, filters | At most five, lowercase kebab-case; cards show three. |
-| `accession` | accession label, cards, rows | The catalogue number. The site checks its own numbering scheme. |
-| `status` | accession label, cards | `live`, `building` or `archived`. |
-| `role`, `stack` | accession label | `stack` is a list. |
-| `hero` | cards, figures | `src`, `alt` and `caption`. With a hero, the hero is Plate 1 and figures in the content start at Plate 2. |
-| `thumb` | cards | Optional SVG for the card instead of the cropped hero, for line drawings whose strokes must stay one pixel wide. |
-
-## Render hooks
-
-These apply to all Markdown content once the module is imported.
-
-| Hook | Markdown | Doc |
-|---|---|---|
-| `render-heading.html` | Headings get ids; h2s get a `#` anchor. | `heading-anchor.md` |
-| `render-image.html` | A standalone image is a numbered figure: `![alt](file.png "caption")`, image in the page bundle, alt and caption required. `{width="prose"}` on the next line keeps it to the text measure. Inline images stay plain. | `figure.md` |
-| `render-table.html` | `{caption="Title \| subtitle"}` on the line after a table is required. Numeric columns align right; more than four columns break out. | `data-table.md` |
-| `render-codeblock.html` | Header bar with language, optional `{file="path"}` and copy button. Breaks out when a line is longer than the prose measure. | `code-block.md` |
-| `render-blockquote.html` | `> [!NOTE]`, `[!TIP]`, `[!WARNING]` and `[!CAUTION]` become callouts. A quotation must end with a line `— Name \| Source title`. | `callout.md`, `prose.md` |
-| `render-link.html` | Internal links are resolved, and a broken one fails the build. External links get the outward arrow. | `icon.md` |
-
-## Checking a site
-
-Run `scripts/check.mjs` from the pinned module, so the site is checked against the release it uses. `hugo config mounts` prints one JSON object per module; MotifSpec's is the one that mounts `assets/motifspec` (under a local `HUGO_MODULE_REPLACEMENTS` too), and its `dir` is where the module is:
-
-```js
-// scripts/audit.mjs in the site
-import { execFileSync } from 'node:child_process';
-import { join } from 'node:path';
-
-const mounts = execFileSync('hugo', ['config', 'mounts'], { encoding: 'utf8' });
-const motifspec = mounts.split(/\n(?=\{)/).map((m) => JSON.parse(m)).find((m) => m.mounts?.some((x) => x.target === 'assets/motifspec'));
-execFileSync('node', [join(motifspec.dir, 'scripts', 'check.mjs'), '.'], { stdio: 'inherit' });
-```
-
-It checks `layouts/` and `content/` and fails on stylesheets, style attributes, raw colours and units, primitive, unknown or deprecated tokens, classes and icons MotifSpec doesn't define, and "·" separators. In GitHub Actions each problem is also an annotation on the pull request; `--json` prints the problems as JSON. In CI, give the step the same `HUGO_CACHEDIR` and `HUGO_MODULE_PROXY` as the build, because `hugo config mounts` downloads the module if it isn't cached.
-
-## Overriding
-
-A file in the site at the same path wins over the module's. Override a partial only to change content, never markup or classes. If a component needs to change, change it here and release it, so every site gets the fix.
+# Using MotifSpec in Hugo
+
+The module ships the components as Hugo partials and the Markdown render hooks that turn content into them, so a site writes its page templates and content and nothing else. The partials follow `docs/components/*.md`; when a partial and its doc disagree, the doc is the contract and the partial is the bug.
+
+## Setup
+
+```toml
+[module]
+  [[module.imports]]
+    path = "github.com/aitrien/motifspec"
+
+[markup.highlight]
+  noClasses = false
+
+[markup.goldmark.parser]
+  wrapStandAloneImageWithinParagraph = false   # standalone images reach render-image.html, so they can become figures
+  [markup.goldmark.parser.attribute]
+    block = true                              # {caption="…"} on tables, {file="…"} on code, {width="prose"} on figures
+```
+
+Pin a release with `hugo mod get github.com/aitrien/motifspec@vX.Y.Z`. The module mounts `dist/` at `assets/motifspec`, `fonts/` at `static/fonts` and `layouts/` at `layouts`. Hugo publishes the stylesheet at `/motifspec/`; keep it one level below the site root, because its font URLs are `../fonts/…`.
+
+## The page shell
+
+```go-html-template
+<!doctype html>
+<html lang="{{ site.Language.LanguageCode }}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  {{ partial "motifspec/head.html" . }}
+  {{/* the site's own <title>, meta description, favicon */}}
+</head>
+<body class="cx-backdrop-page">
+  {{ partial "motifspec/body-start.html" . }}
+  {{ partial "motifspec/site-header.html" . }}
+  <main id="main" tabindex="-1">{{ block "main" . }}{{ end }}</main>
+  {{/* the site's footer (site-footer.md) */}}
+  {{ partial "motifspec/body-end.html" . }}
+</body>
+</html>
+```
+
+| Partial | What it writes |
+|---|---|
+| `motifspec/head.html` | The stored-theme snippet, font preloads, `codex.css` and `codex.js`, in that order. |
+| `motifspec/body-start.html` | The backdrop, the icon sprite and the skip link to `#main`. |
+| `motifspec/site-header.html` | `site-header.md`: wordmark from `site.Title` and `site.Params.role`, nav from `site.Menus.main`, the backdrop pause control and the theme toggle. A menu entry is current when its `identifier` is the page's section. |
+| `motifspec/body-end.html` | `plate.js`, which drifts the backdrop and reveals the pause control. |
+
+The footer stays in the site: its columns are the site's own links and colophon. Use the markup in `site-footer.md`.
+
+## Component partials
+
+Every partial below is called as `partial "motifspec/<name>.html" <context>`.
+
+| Partial | Doc | Context |
+|---|---|---|
+| `article.html` | `prose.md`, `table-of-contents.md`, `ornament.md` | `dict "page" . "toc" "always"` or `"auto"` (auto shows the TOC at three or more h2s). Ends the prose with the end mark, so the content must end with a paragraph. |
+| `project-card.html` | `project-card.md` | `dict "page" . "level" 2` (the heading level that fits the page outline; default 3). |
+| `post-list-item.html` | `post-list-item.md` | `dict "page" . "level" 3`. Writes an `<li>`, so put it in `<ol class="cx-posts">`. |
+| `accession/label.html` | `accession-label.md` | `dict "page" . "variant" "lead"` above the title, or `"card"` after the article (shown on a phone). |
+| `accession/id.html` | `accession-label.md` | A page. The compact number, date and reading time line. |
+| `accession/status.html` | `accession-label.md` | `live`, `building` or `archived`. |
+| `figure.html` | `figure.md` | `dict "image" <resource> "alt" "…" "caption" <HTML> "plate" 1`, plus `"eager" true` for the largest image above the fold and `"prose" true` to keep it to the text measure. |
+| `table-of-contents.html` | `table-of-contents.md` | A page. `article.html` already calls it. |
+| `tags.html` | `tag.md` | `dict "page" . "max" 3`. |
+| `tag-filter.html` | `tag.md` | `dict "section" "work" "current" nil` on a section page, or `dict "section" "" "current" .` on a term page. |
+| `filed-under.html` | `tag.md`, `docs/templates.md` | A page. "Filed under" and its tags, after an article. |
+| `pagination-entries.html` | `pagination.md` | `dict "page" . "label" "Post navigation" "noun" "Post"`. Previous and next in the page's section, oldest first. |
+| `pagination-pages.html` | `pagination.md` | `dict "pager" $pager "label" "Writing pages"`. Pages of a paginated list; nothing when it fits on one page. |
+| `back-link.html` | `button-and-link.md` | `dict "href" "…" "label" "All work"`. |
+| `section-heading.html` | `heading-anchor.md` | `dict "id" "work" "title" "Selected work"`, inside a `<section id="work" aria-labelledby="work-title">`. |
+| `tokens.html` | | Call with `partialCached "motifspec/tokens.html" "tokens"`. A map from token name to its entry in `dist/tokens.json`, for templates that need a token's value at build time. |
+| `h2s.html` | | A page. Its h2 headings with their h3 children; used by the article and the TOC. |
+
+## Front matter the partials read
+
+```yaml
+title: Interactive WebGL globe
+accession: LM-W-001
+date: 2026-03-14
+summary: A React app that renders live routes on a 3D globe.
+role: Sole engineer
+stack: [React, WebGL, Vite]
+status: live        # live | building | archived
+tags: [react, webgl, a11y]
+hero: { src: hero.png, alt: "…", caption: "…" }
+```
+
+| Field | Used by | Notes |
+|---|---|---|
+| `summary` | cards, rows | The lede and the card or row summary. |
+| `tags` | tags, filters | At most five, lowercase kebab-case; cards show three. |
+| `accession` | accession label, cards, rows | The catalogue number. The site checks its own numbering scheme. |
+| `status` | accession label, cards | `live`, `building` or `archived`. |
+| `role`, `stack` | accession label | `stack` is a list. |
+| `hero` | cards, figures | `src`, `alt` and `caption`. With a hero, the hero is Plate 1 and figures in the content start at Plate 2. |
+| `thumb` | cards | Optional SVG for the card instead of the cropped hero, for line drawings whose strokes must stay one pixel wide. |
+
+## Render hooks
+
+These apply to all Markdown content once the module is imported.
+
+| Hook | Markdown | Doc |
+|---|---|---|
+| `render-heading.html` | Headings get ids; h2s get a `#` anchor. | `heading-anchor.md` |
+| `render-image.html` | A standalone image is a numbered figure: `![alt](file.png "caption")`, image in the page bundle, alt and caption required. `{width="prose"}` on the next line keeps it to the text measure. Inline images stay plain. | `figure.md` |
+| `render-table.html` | `{caption="Title \| subtitle"}` on the line after a table is required. Numeric columns align right; more than four columns break out. | `data-table.md` |
+| `render-codeblock.html` | Header bar with language, optional `{file="path"}` and copy button. Breaks out when a line is longer than the prose measure. | `code-block.md` |
+| `render-blockquote.html` | `> [!NOTE]`, `[!TIP]`, `[!WARNING]` and `[!CAUTION]` become callouts. A quotation must end with a line `— Name \| Source title`. | `callout.md`, `prose.md` |
+| `render-link.html` | Internal links are resolved, and a broken one fails the build. External links get the outward arrow. | `icon.md` |
+
+## Checking a site
+
+Run `scripts/check.mjs` from the pinned module, so the site is checked against the release it uses. `hugo config mounts` prints one JSON object per module; MotifSpec's is the one that mounts `assets/motifspec` (under a local `HUGO_MODULE_REPLACEMENTS` too), and its `dir` is where the module is:
+
+```js
+// scripts/audit.mjs in the site
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+
+const mounts = execFileSync('hugo', ['config', 'mounts'], { encoding: 'utf8' });
+const motifspec = mounts.split(/\n(?=\{)/).map((m) => JSON.parse(m)).find((m) => m.mounts?.some((x) => x.target === 'assets/motifspec'));
+execFileSync('node', [join(motifspec.dir, 'scripts', 'check.mjs'), '.'], { stdio: 'inherit' });
+```
+
+It checks `layouts/` and `content/` for what the README's Commands section lists. In GitHub Actions each problem is also an annotation on the pull request; `--json` prints the problems as JSON. In CI, give the step the same `HUGO_CACHEDIR` and `HUGO_MODULE_PROXY` as the build, because `hugo config mounts` downloads the module if it isn't cached.
+
+## Overriding
+
+A file in the site at the same path wins over the module's. Override a partial only to change content, never markup or classes. If a component needs to change, change it here and release it, so every site gets the fix.

package/docs/syntax-highlighting.md

@@ -1,55 +1,55 @@
-# Syntax highlighting
-
-Hugo highlights code with [Chroma](https://github.com/alecthomas/chroma). MotifSpec maps Chroma's CSS classes to `color.syntax.*` roles, so one stylesheet covers both themes and every colour is checked for contrast.
-
-## Setup
-
-In `hugo.toml`:
-
-```toml
-[markup.highlight]
-  noClasses = false   # emit classes, not inline colours
-  lineNos = false     # opt in per block with {linenos=table}
-  codeFences = true
-  guessSyntax = false
-```
-
-Load `dist/chroma.css` (also bundled in `dist/codex.css`). Do not generate a Chroma theme with `hugo gen chromastyles`; it would hard-code colours and bypass the tokens.
-
-Wrap highlighted output in the code-block component (see `components/code-block.md`) so it gets the header bar, border and copy button.
-
-## Rules
-
-- Every role has a contrast pair against `color.surface.sunken` and `color.syntax.line-highlight` at 4.5:1 or more, in both themes.
-- Comments stay upright. No mono italic is loaded, and synthetic italic in code is hard to read.
-- Keywords and headings are the only bold roles. Weight is a second cue so highlighting never depends on hue alone.
-- Plain identifiers use `color.syntax.variable`, which matches body text, so most code reads as text and the colour goes to structure.
-- Diff lines keep their `+` and `-` prefixes; colour is a second signal, never the only one.
-
-## Mapping
-
-Generated by `npm run build` from `syntax/chroma.json`. Values are light / dark.
-
-<!-- TABLE:START -->
-| Role | Chroma classes | Token | Light / dark | Contrast on code surface (light / dark) |
-|---|---|---|---|---|
-| Keywords | `.k` `.kd` `.kn` `.kp` `.kr` `.ow` `.bp` | `color.syntax.keyword` + weight `font.weight.strong` | #942f29 / #feb5ac | 6.79 / 10.36 |
-| Type keywords, classes, built-ins, namespaces, exceptions | `.kt` `.nb` `.nc` `.nn` `.ne` | `color.syntax.type` | #123961 / #cde4fe | 10.27 / 13.46 |
-| Constants: numbers, booleans, null, dates, symbols, entities, escapes | `.kc` `.no` `.m` `.mb` `.mf` `.mh` `.mi` `.il` `.mo` `.ld` `.ss` `.ni` `.se` | `color.syntax.number` | #6c5302 / #e0c88f | 6.37 / 10.70 |
-| Strings and regex | `.s` `.sa` `.sb` `.sc` `.dl` `.s2` `.sh` `.sx` `.sr` `.s1` `.cpf` | `color.syntax.string` | #126836 / #a7d9b3 | 5.99 / 11.03 |
-| Functions | `.nf` `.fm` | `color.syntax.function` | #26598e / #abcef6 | 6.31 / 10.76 |
-| Markup tags | `.nt` | `color.syntax.tag` | #651916 / #ffd6d1 | 10.75 / 13.18 |
-| Attributes, properties, object keys | `.na` `.py` | `color.syntax.attribute` | #473502 / #f9dfa1 | 10.30 / 13.43 |
-| Names and variables | `.n` `.nx` `.nv` `.vc` `.vg` `.vi` `.vm` `.l` | `color.syntax.variable` | #171a19 / #eaf1ee | 15.28 / 15.28 |
-| Operators and punctuation | `.o` `.p` | `color.syntax.operator` | #323a36 / #c4cdc8 | 10.21 / 10.78 |
-| Comments and doc strings | `.c` `.ch` `.cm` `.c1` `.cs` `.sd` `.go` | `color.syntax.comment` | #515955 / #a4ada9 | 6.29 / 7.62 |
-| Meta: decorators, preprocessor, labels, interpolation, prompts | `.nd` `.cp` `.nl` `.si` `.gp` | `color.syntax.meta` | #01441f / #bbf1c8 | 9.91 / 13.79 |
-| Diff: inserted | `.gi` | `color.syntax.inserted` | #01441f / #bbf1c8 | 9.91 / 13.79 |
-| Diff: deleted, errors, tracebacks | `.gd` `.gr` `.gt` `.err` | `color.syntax.deleted` | #651916 / #ffd6d1 | 10.75 / 13.18 |
-| Headings and diff hunks | `.gh` `.gu` | `color.syntax.heading` + weight `font.weight.strong` | #123961 / #cde4fe | 10.27 / 13.46 |
-| Generic strong and emphasis (no italic available) | `.gs` `.ge` | weight `font.weight.strong` | — | — |
-| Line numbers | `.ln` `.lnt` | `color.syntax.line-number` | #515955 / #a4ada9 | 6.29 / 7.62 |
-| Highlighted lines (hl_lines) | `.hl` | background `color.syntax.line-highlight` | #dae4df / #252a28 | — |
-<!-- TABLE:END -->
-
-Classes not listed (for example `.w` whitespace, `.x` other) inherit `color.syntax.variable` from `.chroma`.
+# Syntax highlighting
+
+Hugo highlights code with [Chroma](https://github.com/alecthomas/chroma). MotifSpec maps Chroma's CSS classes to `color.syntax.*` roles, so one stylesheet covers both themes and every colour is checked for contrast.
+
+## Setup
+
+In `hugo.toml`:
+
+```toml
+[markup.highlight]
+  noClasses = false   # emit classes, not inline colours
+  lineNos = false     # opt in per block with {linenos=table}
+  codeFences = true
+  guessSyntax = false
+```
+
+Load `dist/chroma.css` (also bundled in `dist/codex.css`). Do not generate a Chroma theme with `hugo gen chromastyles`; it would hard-code colours and bypass the tokens.
+
+Wrap highlighted output in the code-block component (see `components/code-block.md`) so it gets the header bar, border and copy button.
+
+## Rules
+
+- Every role has a contrast pair against `color.surface.sunken` and `color.syntax.line-highlight` at 4.5:1 or more, in both themes.
+- Comments stay upright. No mono italic is loaded, and synthetic italic in code is hard to read.
+- Keywords and headings are the only bold roles. Weight is a second cue so highlighting never depends on hue alone.
+- Plain identifiers use `color.syntax.variable`, which matches body text, so most code reads as text and the colour goes to structure.
+- Diff lines keep their `+` and `-` prefixes; colour is a second signal, never the only one.
+
+## Mapping
+
+Generated by `npm run build` from `syntax/chroma.json`. Values are light / dark.
+
+<!-- TABLE:START -->
+| Role | Chroma classes | Token | Light / dark | Contrast on code surface (light / dark) |
+|---|---|---|---|---|
+| Keywords | `.k` `.kd` `.kn` `.kp` `.kr` `.ow` `.bp` | `color.syntax.keyword` + weight `font.weight.strong` | #942f29 / #feb5ac | 6.79 / 10.36 |
+| Type keywords, classes, built-ins, namespaces, exceptions | `.kt` `.nb` `.nc` `.nn` `.ne` | `color.syntax.type` | #123961 / #cde4fe | 10.27 / 13.46 |
+| Constants: numbers, booleans, null, dates, symbols, entities, escapes | `.kc` `.no` `.m` `.mb` `.mf` `.mh` `.mi` `.il` `.mo` `.ld` `.ss` `.ni` `.se` | `color.syntax.number` | #6c5302 / #e0c88f | 6.37 / 10.70 |
+| Strings and regex | `.s` `.sa` `.sb` `.sc` `.dl` `.s2` `.sh` `.sx` `.sr` `.s1` `.cpf` | `color.syntax.string` | #126836 / #a7d9b3 | 5.99 / 11.03 |
+| Functions | `.nf` `.fm` | `color.syntax.function` | #26598e / #abcef6 | 6.31 / 10.76 |
+| Markup tags | `.nt` | `color.syntax.tag` | #651916 / #ffd6d1 | 10.75 / 13.18 |
+| Attributes, properties, object keys | `.na` `.py` | `color.syntax.attribute` | #473502 / #f9dfa1 | 10.30 / 13.43 |
+| Names and variables | `.n` `.nx` `.nv` `.vc` `.vg` `.vi` `.vm` `.l` | `color.syntax.variable` | #171a19 / #eaf1ee | 15.28 / 15.28 |
+| Operators and punctuation | `.o` `.p` | `color.syntax.operator` | #323a36 / #c4cdc8 | 10.21 / 10.78 |
+| Comments and doc strings | `.c` `.ch` `.cm` `.c1` `.cs` `.sd` `.go` | `color.syntax.comment` | #515955 / #a4ada9 | 6.29 / 7.62 |
+| Meta: decorators, preprocessor, labels, interpolation, prompts | `.nd` `.cp` `.nl` `.si` `.gp` | `color.syntax.meta` | #01441f / #bbf1c8 | 9.91 / 13.79 |
+| Diff: inserted | `.gi` | `color.syntax.inserted` | #01441f / #bbf1c8 | 9.91 / 13.79 |
+| Diff: deleted, errors, tracebacks | `.gd` `.gr` `.gt` `.err` | `color.syntax.deleted` | #651916 / #ffd6d1 | 10.75 / 13.18 |
+| Headings and diff hunks | `.gh` `.gu` | `color.syntax.heading` + weight `font.weight.strong` | #123961 / #cde4fe | 10.27 / 13.46 |
+| Generic strong and emphasis (no italic available) | `.gs` `.ge` | weight `font.weight.strong` | — | — |
+| Line numbers | `.ln` `.lnt` | `color.syntax.line-number` | #515955 / #a4ada9 | 6.29 / 7.62 |
+| Highlighted lines (hl_lines) | `.hl` | background `color.syntax.line-highlight` | #dae4df / #252a28 | — |
+<!-- TABLE:END -->
+
+Classes not listed (for example `.w` whitespace, `.x` other) inherit `color.syntax.variable` from `.chroma`.

package/docs/templates.md

@@ -1,30 +1,21 @@
-# Page templates
-
-Content hierarchy for the six page types. Every template sits on the backdrop (`components/backdrop.md`): the frost shows through behind the header and the opening of the page, and again behind the footer. Every template keeps the full site header (Work, Writing, About, the backdrop pause, the theme toggle) and the footer. Every `<h2>` section heading carries a heading anchor.
-
-| Template | Order | Dominant | Secondary |
-|---|---|---|---|
-| **Home** | Header → statement (eyebrow, display h1, lede, primary + secondary button) on the frost, inside the top fade → selected work (2–3 project cards) → recent writing (5 post rows) → capabilities table → footer | Statement and selected work | Writing rows, capabilities, the backdrop |
-| **Project index** | Header → page head (h1 "Work", entry count, one-line intro) → tag filter → project cards or ledger, newest first → footer | The list of projects | Filter and intro |
-| **Case study** | Header → back link "← All work" → accession label (`cx-label--lead`; on a phone, number, date and status only) → h1 and lede → hero figure (Plate 1) → article layout: TOC + prose (Problem, Constraints, Approach, Outcome with a data table, What I'd change) → on a phone, the full label as a card (`cx-label--card`) → pagination → footer | Title and hero, then prose | Label, TOC |
-| **Writing list** | Header → page head (h1 "Writing", description, RSS link) → tag filter → post rows grouped by year → pagination → footer | Post titles | Numbers, dates, tags |
-| **Blog post** | Header → back link "← All writing" → meta line (`cx-id`: number, date, reading time) → h1 and lede → article layout: TOC (when three or more h2s) + prose with figures, code blocks and callouts → end mark → "Filed under" tags → pagination → footer | The prose column | Meta, TOC |
-| **404** | Header → sprout ornament (lg) → accession label "No. — / Not in collection" → h1 "Page not found" → the requested path in mono → three links: Home, Work, Writing → footer | Heading and the routes out | Ornament, path |
-
-## Catalogue numbers
-
-- Work: `LM-W-001` onward. Writing: `LM-P-001` onward. Zero-padded, never reused, stored in front matter as `accession`.
-- They appear on cards, post rows, post meta lines and case-study labels.
-
-## Hugo front matter
-
-```yaml
-title: Interactive WebGL globe
-accession: LM-W-001
-date: 2026-03-14
-summary: A React app that renders live routes on a 3D globe.
-role: Sole engineer
-stack: [React, WebGL, Vite]
-status: live        # live | building | archived
-tags: [react, webgl, a11y]
-```
+# Page templates
+
+Content hierarchy for the six page types. Every template sits on the backdrop (`components/backdrop.md`): the frost shows through behind the header and the opening of the page, and again behind the footer. Every template keeps the full site header (Work, Writing, About, the backdrop pause, the theme toggle) and the footer. Every `<h2>` section heading carries a heading anchor.
+
+| Template | Order | Dominant | Secondary |
+|---|---|---|---|
+| **Home** | Header → statement (eyebrow, display h1, lede, primary + secondary button) on the frost, inside the top fade → selected work (2–3 project cards) → recent writing (5 post rows) → capabilities table → footer | Statement and selected work | Writing rows, capabilities, the backdrop |
+| **Project index** | Header → page head (h1 "Work", entry count, one-line intro) → tag filter → project cards or ledger, newest first → footer | The list of projects | Filter and intro |
+| **Case study** | Header → back link "← All work" → accession label (`cx-label--lead`; on a phone, number, date and status only) → h1 and lede → hero figure (Plate 1) → article layout: TOC + prose (Problem, Constraints, Approach, Outcome with a data table, What I'd change) → on a phone, the full label as a card (`cx-label--card`) → pagination → footer | Title and hero, then prose | Label, TOC |
+| **Writing list** | Header → page head (h1 "Writing", description, RSS link) → tag filter → post rows grouped by year → pagination → footer | Post titles | Numbers, dates, tags |
+| **Blog post** | Header → back link "← All writing" → meta line (`cx-id`: number, date, reading time) → h1 and lede → article layout: TOC (when three or more h2s) + prose with figures, code blocks and callouts → end mark → "Filed under" tags → pagination → footer | The prose column | Meta, TOC |
+| **404** | Header → sprout ornament (lg) → accession label "No. — / Not in collection" → h1 "Page not found" → the requested path in mono → three links: Home, Work, Writing → footer | Heading and the routes out | Ornament, path |
+
+## Catalogue numbers
+
+- Work: `LM-W-001` onward. Writing: `LM-P-001` onward. Zero-padded, never reused, stored in front matter as `accession`.
+- They appear on cards, post rows, post meta lines and case-study labels.
+
+## Front matter
+
+The fields each template reads are in `docs/hugo.md` (Front matter the partials read).

package/fonts/OFL-jetbrains-mono.txt

@@ -1,93 +1,93 @@
-Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono) JetBrainsMono-Italic[wght].ttf: Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-http://scripts.sil.org/OFL
-
-
------------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
------------------------------------------------------------
-
-PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded,
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting -- in part or in whole -- any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-TERMINATION
-This license becomes null and void if any of the above conditions are
-not met.
-
-DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono) JetBrainsMono-Italic[wght].ttf: Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.