@heroiclands/package-build 23.12.8 → 23.13.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @heroiclands/package-build
 
+## 23.13.0
+
+### Minor Changes
+
+**Language registers**
+
+- A register row tagged `other:<tongue>` or `exonym:<tongue>` that its tongue's own register does not list, or whose tongue no language note claims, is an error instead of a warning, so a package carrying one now fails its lint.
+
+**Verse**
+
+- A poem is written in a ` ```verse ` fence, with the same keys as before; a ` ```poetry ` fence is an ordinary code block, so rename each one to keep it a poem.
+- On the site and in Foundry journals a poem carries the classes `verse` and `verse-line`; restyle any stylesheet that targets the old names.
+
+### Patch Changes
+
+**Languages**
+
+- An affix may name the word classes it attaches to in `attachesTo`, such as `[n, adj]`; mapped text then accepts its forms of those words alone.
+- An affix that names no classes attaches to words of every class.
+
+**Installing**
+
+- `npm audit` in a package that installs this one reports no sprintf-js advisory.
+
+**Names in prose**
+
+- Bold text is emphasis only: a bold label such as `**Strength**:` draws no warning asking you to mark or link it as a name.
+- A name marked with a `data-type` is compared only with notes of that type and subtype: a lineage that shares its name with a place draws no warning to link the place.
+
+**Definition lists**
+
+- A term with several descriptions sets each description on its own line on the site and in Foundry journals, instead of running them together.
+
+**Language notes**
+
+- A language may state `agreement` and `participles` in its grammar, and the word check then accepts its adjectives' and pronouns' agreeing forms and its participles on the verb root.
+- `package-build lexicon --derived` lists every form a language's rules derive, each beside the word it comes from.
+
+**Content index**
+
+- Two notes that spell a key of the same map with different case, such as `carved` and `Carved`, are reported at both notes and their lines, instead of aborting with a message that names no file.
+
+**Verse**
+
+- A poem can number its lines with `numstep=`, and can be set in up to two columns with `col1=` and `col2=`, such as a verse in a script beside its English, line for line.
+- Each column stacks entries that set one written line through a mapping and a font, so a line typed once in roman shows in its script and in roman.
+- A line that does not pair across the columns is an error at that line.
+
 ## 23.12.8
 
 ### Patch Changes

package/README.md

@@ -82,7 +82,7 @@ Every icon and image is covered by a provenance record stating `attribution`, `l
 
 `package-build cdn publish --set <file> --name <display name>` uploads every icon and image the package has, shipped or not, to `<site.assets>/<contentPackage>/` in that flat layout, and writes the named set listing the pictures the package leaves out. It reads the bucket from `CDN_ENDPOINT`, `CDN_BUCKET`, `CDN_ACCESS_KEY_ID` and `CDN_SECRET_ACCESS_KEY`, in the environment or `.env.local`. See [publish pictures to the CDN](docs/guides/release-and-deploy.md#publish-pictures-to-the-cdn).
 
-Leading captions, generic fenced divs, inline spans, and poetry code fences are described in [links and markup](docs/authoring/links-and-markup.md).
+Leading captions, generic fenced divs, inline spans, and verse code fences are described in [links and markup](docs/authoring/links-and-markup.md).
 
 Cypress end-to-end suites use pinned Chrome for Testing 155.0.8059.84 by default
 on macOS arm64 and Linux x64, downloaded once into a reusable cache. Select an

package/assets/preview/gitea.ini

@@ -9,12 +9,12 @@ RENDER_CONTENT_MODE = sanitized
 [markup.sanitizer.markdown.previewDiv]
 ELEMENT = div
 ALLOW_ATTR = class
-REGEXP = ^(hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|poetry)( (hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|poetry))*$
+REGEXP = ^(hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|verse)( (hl-preview(?:-[a-z-]+)?|alert(?:-(?:note|tip|important|warning))?|content-figure(?:-[a-z-]+)?|verse))*$
 
 [markup.sanitizer.markdown.previewSpan]
 ELEMENT = span
 ALLOW_ATTR = class
-REGEXP = ^(hl-preview-[a-z-]+|alert-(?:title|icon)|poetry-[a-z-]+|i[0-8])( (hl-preview-[a-z-]+|alert-(?:title|icon)|poetry-[a-z-]+|i[0-8]))*$
+REGEXP = ^(hl-preview-[a-z-]+|alert-(?:title|icon)|verse-[a-z-]+|i[0-8])( (hl-preview-[a-z-]+|alert-(?:title|icon)|verse-[a-z-]+|i[0-8]))*$
 
 [markup.sanitizer.markdown.previewPre]
 ELEMENT = pre

package/assets/styles/content-base.css

@@ -16,7 +16,7 @@
  * named first in the manifest's `styles`.
  *
  * It carries what every package's compiled content needs to read in Foundry as
- * it does in the preview and on the site: definition lists, poetry, alerts,
+ * it does in the preview and on the site: definition lists, verse, alerts,
  * inline spoilers, marked names, unresolved links and captioned blocks. Every
  * class the Foundry renderer emits is styled here or exempted by name in
  * `tests/base-styles.test.ts`. A package keeps its own stylesheet for its own
@@ -120,48 +120,152 @@
 }
 
 /* Each verse line breaks in the markup; each paragraph is a stanza. */
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .poetry {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .verse {
     margin: 1.5rem 0;
     line-height: 1.7;
 }
 
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .poetry p {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .verse p {
     margin: 0;
 }
 
-:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .poetry p + p {
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .verse p + p {
     margin-top: 1em;
 }
 
-.poetry .poetry-line {
+.verse .verse-line {
     display: inline-block;
-    margin-inline-start: var(--poetry-indent, 0em);
+    margin-inline-start: var(--verse-indent, 0em);
     white-space: pre-wrap;
 }
 
-.poetry .poetry-line.i1 {
-    --poetry-indent: 1.25em;
+.verse .verse-line.i1 {
+    --verse-indent: 1.25em;
 }
-.poetry .poetry-line.i2 {
-    --poetry-indent: 2.5em;
+.verse .verse-line.i2 {
+    --verse-indent: 2.5em;
 }
-.poetry .poetry-line.i3 {
-    --poetry-indent: 3.75em;
+.verse .verse-line.i3 {
+    --verse-indent: 3.75em;
 }
-.poetry .poetry-line.i4 {
-    --poetry-indent: 5em;
+.verse .verse-line.i4 {
+    --verse-indent: 5em;
 }
-.poetry .poetry-line.i5 {
-    --poetry-indent: 6.25em;
+.verse .verse-line.i5 {
+    --verse-indent: 6.25em;
 }
-.poetry .poetry-line.i6 {
-    --poetry-indent: 7.5em;
+.verse .verse-line.i6 {
+    --verse-indent: 7.5em;
 }
-.poetry .poetry-line.i7 {
-    --poetry-indent: 8.75em;
+.verse .verse-line.i7 {
+    --verse-indent: 8.75em;
 }
-.poetry .poetry-line.i8 {
-    --poetry-indent: 10em;
+.verse .verse-line.i8 {
+    --verse-indent: 10em;
+}
+
+/* Numbered verse carries its numbers in a margin. A verse in columns is one
+ * grid per verse line: its number, then each column's parts stacked, the
+ * first in the normal tone and the rest muted, every part in the serif unless
+ * its face sets it. A narrow journal stacks the columns of each line. */
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse.verse-numbered {
+    position: relative;
+    padding-inline-start: 3em;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse
+    .verse-number {
+    color: color-mix(in srgb, currentColor 60%, transparent);
+    font-size: 0.8em;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-numbered
+    .verse-line
+    .verse-number {
+    position: absolute;
+    inset-inline-start: 0;
+    width: 2.2em;
+    text-align: end;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse.verse-columns {
+    container-type: inline-size;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-numbered.verse-columns {
+    padding-inline-start: 0;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    .verse-row {
+    display: grid;
+    grid-auto-flow: column;
+    grid-auto-columns: 1fr;
+    column-gap: 1.5rem;
+    margin-bottom: 0.5em;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-numbered.verse-columns
+    .verse-row {
+    grid-template-columns: 2.5em;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    .verse-number {
+    text-align: end;
+    padding-top: 0.2em;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    :is(.verse-column, .verse-part) {
+    display: block;
+    white-space: pre-wrap;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    .verse-part {
+    font-family: serif;
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    .verse-secondary {
+    color: color-mix(in srgb, currentColor 60%, transparent);
+}
+
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .verse-columns
+    .verse-part[dir="rtl"] {
+    text-align: start;
+}
+
+@container (max-width: 32rem) {
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+        .verse-columns
+        .verse-row {
+        grid-auto-flow: row;
+        grid-template-columns: 1fr;
+    }
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+        .verse-numbered.verse-columns
+        .verse-row {
+        grid-template-columns: 2.5em 1fr;
+    }
+    :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+        .verse-numbered.verse-columns
+        .verse-column {
+        grid-column: 2;
+    }
 }
 
 /* Text set in one of the faces. The font family and features come from the
@@ -172,7 +276,7 @@
 }
 
 .script-block[dir="rtl"],
-.poetry[dir="rtl"] {
+.verse[dir="rtl"] {
     text-align: start;
 }
 
@@ -343,6 +447,22 @@
     > p:first-child {
     display: inline;
 }
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dd
+    + dd {
+    display: block;
+    text-indent: 0;
+}
+:is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror)
+    .dictionary
+    > div
+    > dd
+    + dd
+    > p:first-child {
+    display: block;
+}
 @media (max-width: 600px) {
     :is(.journal-entry-page, .journal-entry-content, .editor-content, .prosemirror) .dictionary {
         --indent: 100px;

package/bin/content-commands.mjs

@@ -31,7 +31,7 @@
  *   npx package-build map [--tree] [--from <shortcode>] [--chart <shortcode>] [--travel] [--out <dir>]
  *   npx package-build reachability <dir> [file] [--index <shortcode>]
  *   npx package-build transliterate <map> [--lang <language>] [--font <slug>] [--hex] [text..]
- *   npx package-build lexicon <language> --map <map> [--font <slug>] [--json]
+ *   npx package-build lexicon <language> --map <map> [--font <slug>] [--derived] [--json]
  *   npx package-build addresses diff --from <zip|dir> [--strict]
  *   npx package-build npc new (--spec <json> | --specfile <path>) [--seed <text>] [--out <path>]
  *
@@ -45,6 +45,7 @@ import fs from "fs";
 import path from "node:path";
 import log from "loglevel";
 import prefix from "loglevel-plugin-prefix";
+import { readStdin } from "../engine/read-stdin.mjs";
 import { compilePacks, cleanPacks, unpackPacks } from "../engine/compendiums.mjs";
 import { compilesFoundryDocuments, publishesContentPages } from "../content-config.mjs";
 import { loadPackConfig, packConfigPath } from "../engine/pack-config.mjs";
@@ -2397,7 +2398,7 @@ function transliterateCommand() {
                     default: false,
                     describe: "Print the code points, as `U+XXXX` separated by spaces",
                 }),
-        handler: (argv) => {
+        handler: async (argv) => {
             try {
                 const read = mappingContext();
                 if (!read) {
@@ -2407,7 +2408,7 @@ function transliterateCommand() {
                 const words = (argv.text ?? []).map(String);
                 const text =
                     !words.length || (words.length === 1 && words[0] === "-") ?
-                        fs.readFileSync(0, "utf8").replace(/\r?\n$/, "")
+                        (await readStdin()).replace(/\r?\n$/, "")
                     :   words.join(" ");
                 const mapped = transliterate(
                     read.ctx,
@@ -2437,7 +2438,9 @@ function transliterateCommand() {
 
 /**
  * `package-build lexicon <language> --map <map>` — every word of a language's
- * lexicon with its native form under a map, as the build writes it.
+ * lexicon with its native form under a map, as the build writes it; with
+ * `--derived`, the forms its rules derive follow, each naming its word in a
+ * sixth column.
  *
  * @returns {object} The yargs command module.
  */
@@ -2461,6 +2464,12 @@ function lexiconCommand() {
                     type: "string",
                     describe: "The face; required when the map lists more than one",
                 })
+                .option("derived", {
+                    type: "boolean",
+                    default: false,
+                    describe:
+                        "Also list the forms the language's rules derive, each beside its lexicon word",
+                })
                 .option("json", {
                     type: "boolean",
                     default: false,
@@ -2477,6 +2486,7 @@ function lexiconCommand() {
                     lang: String(argv.language),
                     map: String(argv.map),
                     font: argv.font,
+                    derived: Boolean(argv.derived),
                 });
                 if ("problem" in listed) {
                     reportMapping(read.config, listed);
@@ -2492,6 +2502,7 @@ function lexiconCommand() {
                                 entry.exception ? "exception" : "rows",
                                 entry.class ?? "",
                                 entry.gloss ?? "",
+                                ...(argv.derived ? [entry.from ?? ""] : []),
                             ].join("\t"),
                         );
             } catch (err) {

package/bin/package-build-preview.mjs

@@ -13,7 +13,6 @@
  */
 
 /** Render stdin with optional date-only configuration and no content index. */
-import { readFileSync } from "node:fs";
 import { formatDiagnostic } from "../engine/diagnostics.mjs";
 
 const HELP = `Usage: package-build-preview [--dark] [--current-date DATE] [--css]
@@ -54,10 +53,11 @@ try {
     else {
         const { renderPreview, previewStyles, readPreviewCurrentDate } =
             await import("../engine/site-preview.mjs");
+        const { readStdin } = await import("../engine/read-stdin.mjs");
         if (css) process.stdout.write(`${previewStyles()}\n`);
         else {
             currentDate ??= await readPreviewCurrentDate(process.cwd());
-            const result = await renderPreview(readFileSync(0, "utf8"), {
+            const result = await renderPreview(await readStdin(), {
                 dark,
                 file: "<stdin>",
                 currentDate,

package/docs/api.md

@@ -1001,7 +1001,6 @@ into one warning for each occurrence; the message names the full name or
 explicit label that needs attention. Only `.name` spans and authored link
 labels enter name tracking; plain text is not searched. Indexed full names and
 declared aliases share an identity, while other labels use their whole text.
-A whole bold indexed name receives an advisory without entering name tracking.
 Local and captured dependency names and aliases share the same corpus
 context. The command's lint target constructs
 the checker once, uses exact authored `raw` strings and keeps these findings
@@ -1340,7 +1339,7 @@ const result = renderPreview(currentBufferText, { dark: true });
 showDiagnostics(result.findings);
 ```
 
-Ordinary Markdown, definition lists, footnotes, alert boxes, poetry, captions, local figures and container blocks render locally. Alerts reuse the four shared icons and titles, accept custom titles and nested alerts, and have opaque tinted backgrounds in both modes. Definition terms are bold; definitions retain ordinary Markdown styling. Wikilinks and image embeds retain their entire authored source: blue opening markers (including all of `![[`), brackets and pipes, purple addresses and anchors, bold foreground labels, and grey attributes. Spans retain their entire source in bold, with blue brackets and grey attributes. Code examples stay literal. Incomplete syntax remains visible while editing.
+Ordinary Markdown, definition lists, footnotes, alert boxes, verse, captions, local figures and container blocks render locally. Alerts reuse the four shared icons and titles, accept custom titles and nested alerts, and have opaque tinted backgrounds in both modes. Definition terms are bold; definitions retain ordinary Markdown styling. Wikilinks and image embeds retain their entire authored source: blue opening markers (including all of `![[`), brackets and pipes, purple addresses and anchors, bold foreground labels, and grey attributes. Spans retain their entire source in bold, with blue brackets and grey attributes. Code examples stay literal. Incomplete syntax remains visible while editing.
 
 SQL and pagelist fences remain grey source, including delimiters. Calendar/date expressions, cross-note references and maps remain green source. A dependent call nested inside a pure helper preserves the entire outer expression. Pure helpers and scalar frontmatter expressions evaluate locally; same-note figure references and non-date event facts can resolve from this buffer. Infobox fields show authored values and green reference source; image and portrait wikilinks use the image syntax colors. Missing ages are calculated locally from neutral birth dates and `currentDate`, defaulting to `"720.1"`; authored ages, including `0`, take precedence. Unavailable ages remain `null` internally, have no infobox row, and render as empty text in `{{data.age}}`. Named-calendar birth dates remain unavailable without calendar context. Set `infobox: false` to omit the profile.
 
@@ -2439,12 +2438,12 @@ Not a JavaScript module — this subpath entry exists so tooling (bundlers, `imp
 
 The engine wildcard subpath also exposes the body parsers below. Their figure exports operate on leading captions.
 
-| Module                       | Exports                                                                                      | Contract                                                                                                                                                                                                                               |
-| ---------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `engine/content-figures.mjs` | `FIGURE_NAMES`, `FIGURE_CLASSES`, `scanFigures`, `numberFigures`, `renderFigureBlocks`       | Scan leading captions and their next supported blocks; `numbered` distinguishes `:` and `:@`. `type` may override inference; `example` is supported. `FIGURE_CLASSES` retains built-in styled classes, not a closed author vocabulary. |
-| `engine/content-blocks.mjs`  | `BLOCK_NAMES`, `BLOCK_CONTAINERS`, `scanBlocks`, `renderBlocks`, `renderWithheldSections`    | Read div and secret fences; generic div records have `name: "div"` and no generated title. Scanning includes poetry errors.                                                                                                            |
-| `engine/content-poetry.mjs`  | `verseLines`, `poetryStanzas`, `inlineVerse`, `poetryMarkdown`, `scanPoetry`, `renderPoetry` | Read `poetry` code fences, validate authored metadata and tabs, and preserve relative indent levels and stanzas.                                                                                                                       |
-| `engine/content-spans.mjs`   | `spanMarkdownPlugin`, `scanSpans`, `renderSpans`                                             | Parse bracket spans after recognized links. The scanner returns spans, the exact `.name` inventory and located errors, retaining visible text and attribute positions; rendering preserves inline Markdown and permitted attributes.   |
+| Module                       | Exports                                                                                   | Contract                                                                                                                                                                                                                               |
+| ---------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `engine/content-figures.mjs` | `FIGURE_NAMES`, `FIGURE_CLASSES`, `scanFigures`, `numberFigures`, `renderFigureBlocks`    | Scan leading captions and their next supported blocks; `numbered` distinguishes `:` and `:@`. `type` may override inference; `example` is supported. `FIGURE_CLASSES` retains built-in styled classes, not a closed author vocabulary. |
+| `engine/content-blocks.mjs`  | `BLOCK_NAMES`, `BLOCK_CONTAINERS`, `scanBlocks`, `renderBlocks`, `renderWithheldSections` | Read div and secret fences; generic div records have `name: "div"` and no generated title. Scanning includes verse errors.                                                                                                             |
+| `engine/content-verse.mjs`   | `verseLines`, `verseStanzas`, `inlineVerse`, `verseMarkdown`, `scanVerse`, `renderVerse`  | Read `verse` code fences, validate authored metadata and tabs, and preserve relative indent levels and stanzas.                                                                                                                        |
+| `engine/content-spans.mjs`   | `spanMarkdownPlugin`, `scanSpans`, `renderSpans`                                          | Parse bracket spans after recognized links. The scanner returns spans, the exact `.name` inventory and located errors, retaining visible text and attribute positions; rendering preserves inline Markdown and permitted attributes.   |
 
 Inline `.secret` spans preserve their inline content, name classes and
 attributes. Site rendering uses a separate show/hide button and content span,
@@ -2535,16 +2534,17 @@ The wildcard engine subpath exposes
 `@heroiclands/package-build/engine/dictionary-rows` for deriving the
 `dictionary` and `terms` SQL relations from content-index records:
 
-| Export                  | Signature                                       | Returns                                     | Use it when                                                                                        |
-| ----------------------- | ----------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| `DICTIONARY_COLUMNS`    | `const DICTIONARY_COLUMNS`                      | A readonly list of column names             | Declaring the schema of a language's dictionary.                                                   |
-| `TERM_COLUMNS`          | `const TERM_COLUMNS`                            | A readonly list of column names             | Declaring the schema of owner-specific glossary terms.                                             |
-| `ETYMOLOGY_KEYS`        | `const ETYMOLOGY_KEYS`                          | A readonly list of keys                     | Reading the structure of a dictionary word's etymology.                                            |
-| `dictionaryLetter`      | `dictionaryLetter(text)`                        | `string`                                    | Deriving a heading letter from a sort key.                                                         |
-| `dictionaryEntryAnchor` | `dictionaryEntryAnchor(language, name)`         | `string`                                    | Deriving the stable entry anchor for a word in a language's dictionary.                            |
-| `dictionaryAndTermRows` | `dictionaryAndTermRows(records, all = records)` | `{ dictionary: object[], terms: object[] }` | Deriving dictionary words and glossary terms for the selected records.                             |
-| `serializeRows`         | `serializeRows(rows)`                           | `string`                                    | Writing deterministic JSON Lines with keys sorted at every depth.                                  |
-| `pluralOf`              | `pluralOf(word, grammar)`                       | `string \| null`                            | Deriving a noun's plural: its own `plural`, else the first `grammar.plural` row whose ending fits. |
+| Export                  | Signature                                       | Returns                                     | Use it when                                                                                                        |
+| ----------------------- | ----------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `DICTIONARY_COLUMNS`    | `const DICTIONARY_COLUMNS`                      | A readonly list of column names             | Declaring the schema of a language's dictionary.                                                                   |
+| `TERM_COLUMNS`          | `const TERM_COLUMNS`                            | A readonly list of column names             | Declaring the schema of owner-specific glossary terms.                                                             |
+| `ETYMOLOGY_KEYS`        | `const ETYMOLOGY_KEYS`                          | A readonly list of keys                     | Reading the structure of a dictionary word's etymology.                                                            |
+| `dictionaryLetter`      | `dictionaryLetter(text)`                        | `string`                                    | Deriving a heading letter from a sort key.                                                                         |
+| `dictionaryEntryAnchor` | `dictionaryEntryAnchor(language, name)`         | `string`                                    | Deriving the stable entry anchor for a word in a language's dictionary.                                            |
+| `dictionaryAndTermRows` | `dictionaryAndTermRows(records, all = records)` | `{ dictionary: object[], terms: object[] }` | Deriving dictionary words and glossary terms for the selected records.                                             |
+| `serializeRows`         | `serializeRows(rows)`                           | `string`                                    | Writing deterministic JSON Lines with keys sorted at every depth.                                                  |
+| `pluralOf`              | `pluralOf(word, grammar)`                       | `string \| null`                            | Deriving a noun's plural: its own `plural`, else the first `grammar.plural` row whose ending fits.                 |
+| `pluralByRule`          | `pluralByRule(form, grammar)`                   | `string \| null`                            | Deriving the plural the `grammar.plural` rule gives any form, whatever its class: the first row whose ending fits. |
 
 `dictionaryEntryAnchor` takes the language's canonical Address and the
 word's form. Its `word-` anchor is derived from the full SHA-256 digest of