@heroiclands/package-build 21.0.0 → 21.1.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @heroiclands/package-build
 
+## 21.1.0
+
+### Minor Changes
+
+- 7577722: **Headings in the book**
+  
+  - A heading is set by its depth rather than every heading alike: a note's top-level heading opens large, keeps its underline and takes a clear run of space above it, and each level beneath is smaller and separated by space alone.
+  - Headings set in the sans face and in the case they were written in, so a section reads as words rather than as tracked capitals. A book that names no sans face still sets them in its book face, exactly as before.
+  - A parent section and the sections inside it can be told apart at a glance, without reading the words.
+- 57fee4c: **Infobox panels in the book**
+  
+  - Each panel is drawn as a closed box — a light border on all four sides over a tint a step below the paper — so a page carrying Profile, system and appearance panels reads as a stack of cards rather than a run of rules.
+  - Skill and equipment groups stand apart from one another, so a group that wraps onto a second line is no longer mistaken for the start of the next one.
+  
+  **Naming the systems**
+  
+  - The system panels are titled _Song of Heroic Lands_ and _HârnMaster 3_ in full, in the book and on the web, in place of the abbreviations.
+
+### Patch Changes
+
+- 705cdc8: **The book** — an entry's first paragraph sets like any other. A raised opening
+  letter is something a note asks for, not something the book decides on its
+  own, so nothing raises one.
+
 ## 21.0.0
 
 ### Major Changes

package/CONTENT.md

@@ -2467,10 +2467,8 @@ alone — a scrolling page has no fixed viewport, so the website keeps one
 measure with a side rail.
 
 A note's `description:` sets as an epigraph between short rules under the
-plate, and the first paragraph of the prose opens on a raised capital. Both
-disappear rather than leave a shell: a note with no description has no
-epigraph, and a body opening on a link or a number keeps its own first
-character. The running foot carries the section's name, an ornament and the
+plate. It disappears rather than leave a shell: a note with no description has
+no epigraph. The running foot carries the section's name, an ornament and the
 folio.
 
 A table of **more than three columns** is given an explicit span rather than

package/engine/infobox-render.mjs

@@ -360,9 +360,10 @@ export function infoboxTypstPreamble() {
         '#let infobox-rule = rgb("#7c3b1e")',
         '#let infobox-faint = rgb("#6b6357")',
         '#let infobox-hairline = rgb("#c9bfa8")',
+        '#let infobox-fill = rgb("#eae2d0")',
         "#let infobox-panel(body) = block(width: 100%, breakable: true, " +
-            "inset: (x: 9pt, y: 8pt), below: 0.8em, " +
-            "stroke: (top: 1.4pt + infobox-rule, bottom: 1.4pt + infobox-rule))[" +
+            "inset: (x: 9pt, y: 8pt), below: 0.8em, radius: 2pt, " +
+            "fill: infobox-fill, stroke: 0.5pt + infobox-hairline)[" +
             "#set par(first-line-indent: 0em, justify: false, leading: 0.40em)\n#body]",
         '#let infobox-title(t) = { text(size: 9pt, weight: "bold", tracking: 1.3pt, ' +
             "fill: infobox-rule)[#upper(t)]; v(0.20em) }",
@@ -373,7 +374,7 @@ export function infoboxTypstPreamble() {
         "#let infobox-cell(lab, val) = align(center)[" +
             "#text(size: 7pt, tracking: 0.6pt, fill: infobox-faint)[#lab]#h(2.5pt)" +
             '#text(size: 8.6pt, weight: "bold")[#val]]',
-        "#let infobox-runin(lab, body) = block(below: 0.28em, breakable: false)[" +
+        "#let infobox-runin(lab, body) = block(below: 0.78em, breakable: false)[" +
             "#set par(justify: false, first-line-indent: 0em, hanging-indent: 0.5cm, leading: 0.40em)\n" +
             '#text(size: 7.8pt)[#if lab != "" [ #text(weight: "bold")[#lab: ] ]#body]]',
         '#let infobox-statement(t) = text(size: 8pt, style: "italic", fill: infobox-faint)[#t]',

package/engine/pdf-build.mjs

@@ -498,8 +498,6 @@ export async function buildPdf({ config, out, version = "", compile = true } = {
             images,
             headingOffset,
             anchorPrefix,
-            // An entry opens a page, so its first paragraph opens the page too.
-            dropCap: true,
         });
         // The infobox is generated content in document order — prepended,
         // before the prose. An image the note authored ahead of it still comes

package/engine/pdf-render.mjs

@@ -168,7 +168,6 @@ export function createParser(registry) {
  *   note's own `##` nests beneath the entry heading the book gave it.
  * @param {string} [opts.anchorPrefix] - The entry's anchor, which namespaces
  *   every `{#slug}` the body declares.
- * @param {boolean} [opts.dropCap] - Whether to open the body with a raised
  *   capital. Set for an entry, which begins a page; not for front matter or a
  *   prose file, which carry headings of their own.
  * @returns {string} Typst markup.
@@ -181,7 +180,6 @@ export function markdownToTypst(markdown, opts = {}) {
         images = new Map(),
         headingOffset = 0,
         anchorPrefix = "",
-        dropCap = false,
     } = opts;
     const tokens = md.parse(String(markdown ?? ""), {});
     // One map for the whole body, not one per block: a heading inside a
@@ -194,7 +192,6 @@ export function markdownToTypst(markdown, opts = {}) {
         images,
         headingOffset,
         anchorPrefix,
-        dropCap,
         seen: new Map(),
     });
 }
@@ -258,7 +255,7 @@ function renderBlock(tokens, i, out, ctx) {
             return 3;
         }
         case "paragraph_open": {
-            out.push(`\n${openingParagraph(renderInline(tokens[i + 1], ctx), ctx)}\n\n`);
+            out.push(`\n${renderInline(tokens[i + 1], ctx)}\n\n`);
             return 3;
         }
         case "fence":
@@ -271,7 +268,7 @@ function renderBlock(tokens, i, out, ctx) {
             return 1;
         case "blockquote_open": {
             const end = matching(tokens, i, "blockquote_open", "blockquote_close");
-            const inner = renderTokens(tokens.slice(i + 1, end), { ...ctx, dropCap: false });
+            const inner = renderTokens(tokens.slice(i + 1, end), { ...ctx });
             out.push(`\n#quote(block: true)[${inner}]\n\n`);
             return end - i + 1;
         }
@@ -298,29 +295,6 @@ function renderBlock(tokens, i, out, ctx) {
     }
 }
 
-/**
- * The first paragraph of an entry, opened with a raised capital.
- *
- * Only the first, and only when it begins with a letter: a paragraph opening
- * on a link, a bold run or a number has no character to raise, and raising
- * whatever happened to be first would put a 26pt accent on a bracket. The
- * chance is spent either way — a body opens once — so a paragraph that cannot
- * take the capital simply sets as itself.
- *
- * @param {string} rendered - The paragraph's Typst markup.
- * @param {object} ctx - Render context.
- * @returns {string} The same markup, or it with a raised capital.
- */
-function openingParagraph(rendered, ctx) {
-    if (!ctx.dropCap) return rendered;
-    ctx.dropCap = false;
-    // A letter is never escaped, so the first character of the markup is the
-    // first character of the prose whenever the prose starts with one.
-    const match = /^(\p{L})([\s\S]*)$/u.exec(rendered);
-    if (!match) return rendered;
-    return `#book-dropcap[${match[1]}]#h(1pt)${match[2]}`;
-}
-
 /**
  * A heading's text, and the `{#slug}` it may end with.
  *
@@ -438,7 +412,7 @@ function listItems(tokens, start, end, ctx) {
             continue;
         }
         const close = matching(tokens, i, "list_item_open", "list_item_close");
-        items.push(renderTokens(tokens.slice(i + 1, close), { ...ctx, dropCap: false }));
+        items.push(renderTokens(tokens.slice(i + 1, close), { ...ctx }));
         i = close + 1;
     }
     return items;
@@ -825,6 +799,7 @@ export function bookTypstPreamble() {
         '#let book-ink = rgb("#241f1a")',
         '#let book-paper = rgb("#f4efe4")',
         '#let book-accent = rgb("#7c3b1e")',
+        '#let book-head = rgb("#5e2b14")',
         '#let book-faint = rgb("#6b6357")',
         "#let book-ornament = box(baseline: 1pt, " +
             "rotate(45deg, rect(width: 3pt, height: 3pt, fill: book-accent)))",
@@ -835,16 +810,34 @@ export function bookTypstPreamble() {
             "}",
         // A heading justifies and hyphenates like body text unless told
         // otherwise, and both make a display line look broken.
-        "#let book-sechead(it) = block(width: 100%, above: 0.9em, below: 0.5em, " +
-            "breakable: false)[\n" +
-            "  #set par(justify: false, first-line-indent: 0em)\n" +
-            "  #set text(hyphenate: false)\n" +
-            '  #text(size: 11pt, weight: "bold", tracking: 1.6pt, fill: book-accent)[#upper(it.body)]\n' +
-            "  #v(-0.35em)\n" +
-            "  #line(length: 100%, stroke: 0.5pt + book-accent)\n" +
-            "]",
-        '#let book-dropcap(letter) = text(size: 26pt, weight: "bold", fill: book-accent, ' +
-            "baseline: 5pt)[#letter]",
+        //
+        // Size, weight and the space above follow the level, so a parent reads
+        // as one without the words being read. The rule belongs to the note's own
+        // top level alone; every level under it is set apart by space. Headings set
+        // in the sans face and in the case they were authored in, so neither
+        // capitals nor tracking is carrying the distinction. The scale starts
+        // at 3: `book-plate` shadows this rule while it draws the title, so
+        // the section landing and the entry title never arrive here, and the
+        // headings that do are the note's own.
+        "#let book-sechead(it) = {\n" +
+            "  let lv = it.level\n" +
+            "  let size = if lv <= 3 { 26pt } else if lv == 4 { 19pt }\n" +
+            "    else if lv == 5 { 14pt } else { 11pt }\n" +
+            "  let above = if lv <= 3 { 2.5em } else if lv == 4 { 2.0em }\n" +
+            "    else { 1.0em }\n" +
+            "  let below = if lv <= 3 { 0.5em } else if lv == 4 { 0.36em }\n" +
+            "    else { 0.28em }\n" +
+            '  let weight = if lv <= 5 { "bold" } else { "regular" }\n' +
+            "  block(width: 100%, above: above, below: below, breakable: false)[\n" +
+            "    #set par(justify: false, first-line-indent: 0em)\n" +
+            "    #set text(hyphenate: false)\n" +
+            "    #text(size: size, weight: weight, fill: book-head)[#it.body]\n" +
+            "    #if lv <= 3 {\n" +
+            "      v(-0.30em)\n" +
+            "      line(length: 100%, stroke: 0.5pt + book-accent)\n" +
+            "    }\n" +
+            "  ]\n" +
+            "}",
         // The plate bleeds off the paper: the placed panel is the full width of
         // the sheet and starts a margin above and to the left of wherever the
         // flow has reached, which on an entry's first page is the top corner.

package/hm3/infobox.mjs

@@ -33,7 +33,7 @@ import { GEAR_UNITS, defineInfobox } from "../engine/infobox.mjs";
 import { HM3_ITEM_FIELDS } from "./item-fields.mjs";
 
 /** What this system's box is called. @type {string} */
-export const HM3_INFOBOX_TITLE = "HM3";
+export const HM3_INFOBOX_TITLE = "HârnMaster 3";
 
 /**
  * HM3's presentation overlay: what one of this system's fields is called where

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "21.0.0",
+    "version": "21.1.0",
     "description": "Shared toolchain for building and shipping a HeroicLands Foundry VTT package — content compilation, manifest, localization, staging, bundle, release and deployment.",
     "license": "GPL-3.0-or-later",
     "type": "module",

package/sohl/infobox.mjs

@@ -67,7 +67,7 @@ import { NOTE_SCHEMAS } from "./note-schemas.mjs";
 import { GEAR_TYPE_TO_KEY } from "./being-info.mjs";
 
 /** What this system's box is called. @type {string} */
-export const SOHL_INFOBOX_TITLE = "SoHL";
+export const SOHL_INFOBOX_TITLE = "Song of Heroic Lands";
 
 /**
  * What a value nobody stated is shown as, where showing nothing would be the

package/types/engine/pdf-render.d.mts

@@ -55,7 +55,6 @@ export function createParser(registry?: object): object;
  *   note's own `##` nests beneath the entry heading the book gave it.
  * @param {string} [opts.anchorPrefix] - The entry's anchor, which namespaces
  *   every `{#slug}` the body declares.
- * @param {boolean} [opts.dropCap] - Whether to open the body with a raised
  *   capital. Set for an entry, which begins a page; not for front matter or a
  *   prose file, which carry headings of their own.
  * @returns {string} Typst markup.
@@ -68,7 +67,6 @@ export function markdownToTypst(markdown: string, opts?: {
     images?: Map<string, string> | undefined;
     headingOffset?: number | undefined;
     anchorPrefix?: string | undefined;
-    dropCap?: boolean | undefined;
 }): string;
 /**
  * The Typst definitions the book's page furniture is drawn with.