@heroiclands/package-build 25.2.1 → 25.4.0

package/site-theme/static/css/style.css

@@ -1380,118 +1380,90 @@ a.tag:hover {
   background: var(--bg-card);
 }
 
-/* Verse groups are paragraphs; explicit stanza separators add their own gap. */
-.single-content .verse {
-  margin: 1.5rem 0;
-  line-height: 1.7;
-}
-
-.single-content .verse p {
-  margin: 0;
+.single-content .verse .verse-stanza p {
+    margin: 0;
 }
 
-.single-content .verse p + p {
-  margin-top: 1em;
-}
-
-.single-content .verse .verse-line {
-  display: inline-block;
-  margin-inline-start: var(--verse-indent, 0em);
-  white-space: pre-wrap;
-}
-
-.single-content .verse :is(.verse-line, .verse-part).i1 { --verse-indent: 1.25em; }
-.single-content .verse :is(.verse-line, .verse-part).i2 { --verse-indent: 2.5em; }
-.single-content .verse :is(.verse-line, .verse-part).i3 { --verse-indent: 3.75em; }
-.single-content .verse :is(.verse-line, .verse-part).i4 { --verse-indent: 5em; }
-.single-content .verse :is(.verse-line, .verse-part).i5 { --verse-indent: 6.25em; }
-.single-content .verse :is(.verse-line, .verse-part).i6 { --verse-indent: 7.5em; }
-.single-content .verse :is(.verse-line, .verse-part).i7 { --verse-indent: 8.75em; }
-.single-content .verse :is(.verse-line, .verse-part).i8 { --verse-indent: 10em; }
-
-.single-content .verse .verse-stanza-break { display: block; height: 0.5em; }
-
-/* 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 body serif
-   unless its face sets it. A narrow verse stacks the columns of each line. */
-.single-content .verse.verse-numbered {
-  position: relative;
-  padding-inline-start: 3em;
+/* A quotation stays within its prose paragraph; canto titles retain heading type. */
+.single-content .verse.verse-inline {
+    display: inline-block;
+    vertical-align: baseline;
+    max-inline-size: 100%;
+    margin: 0;
+    container-type: normal;
 }
-
-.single-content .verse .verse-number {
-  color: var(--text-muted);
-  font-size: 0.8em;
-}
-
-.single-content .verse-numbered .verse-line .verse-number {
-  position: absolute;
-  inset-inline-start: 0;
-  width: 2.2em;
-  text-align: end;
+.single-content .verse.verse-inline .verse-stanza {
+    display: block;
+    margin: 0;
 }
-
-.single-content .verse.verse-columns {
-  container-type: inline-size;
+.single-content .verse.verse-inline .verse-stanza + .verse-stanza {
+    margin-top: 0.5em;
 }
-
-.single-content .verse-numbered.verse-columns {
-  padding-inline-start: 0;
+.single-content .verse .verse-canto-heading {
+    display: block;
+    margin: 0.5em 0;
+    font-family: var(--font-display);
+    font-size: 1.1em;
+    font-weight: bold;
+    line-height: 1.3;
 }
 
-.single-content .verse-columns .verse-row {
-  display: grid;
-  grid-auto-flow: column;
-  grid-auto-columns: 1fr;
-  direction: ltr;
-  grid-template-columns: repeat(var(--verse-columns, 2), minmax(0, 1fr));
-  column-gap: 1.5rem;
-  margin-bottom: 0.5em;
+/* Logical stanzas share labels across native and Roman presentations. */
+.single-content .verse {
+    margin: 1.5rem 0;
+    line-height: 1.7;
+    container-type: inline-size;
 }
-
-.single-content .verse-numbered.verse-columns .verse-row {
-  grid-template-columns: 2.5em repeat(var(--verse-columns, 2), minmax(0, 1fr));
+.single-content .verse .verse-stanza {
+    position: relative;
+    margin: 0 0 1em;
 }
-
-.single-content .verse-columns .verse-number {
-  text-align: end;
-  padding-top: 0.2em;
+.single-content .verse-labelled .verse-stanza {
+    padding-inline-start: 3em;
 }
-
-.single-content .verse-columns :is(.verse-column, .verse-part) {
-  display: block;
-  white-space: pre-wrap;
+.single-content .verse .verse-label {
+    position: absolute;
+    inset-inline-start: 0;
+    width: 2.5em;
+    text-align: end;
+    font-size: 0.75em;
+    color: color-mix(in srgb, currentColor 60%, transparent);
 }
-
-.single-content .verse-columns .verse-part {
-  font-family: var(--font-body);
-  padding-inline-start: var(--verse-indent, 0em);
+.single-content .verse .verse-line {
+    display: inline-block;
+    margin-inline-start: var(--verse-indent, 0em);
+    white-space: pre-wrap;
+}
+.single-content .verse .verse-line.i1 { --verse-indent: 1.25em; }
+.single-content .verse .verse-line.i2 { --verse-indent: 2.5em; }
+.single-content .verse .verse-line.i3 { --verse-indent: 3.75em; }
+.single-content .verse .verse-line.i4 { --verse-indent: 5em; }
+.single-content .verse .verse-line.i5 { --verse-indent: 6.25em; }
+.single-content .verse .verse-line.i6 { --verse-indent: 7.5em; }
+.single-content .verse .verse-line.i7 { --verse-indent: 8.75em; }
+.single-content .verse .verse-line.i8 { --verse-indent: 10em; }
+.single-content .verse .verse-canto-break {
+    display: block;
+    height: 0.5em;
 }
-
-.single-content .verse-columns .verse-secondary {
-  color: var(--text-muted);
+.single-content .verse-paired .verse-row {
+    display: grid;
+    direction: ltr;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    column-gap: 1.5rem;
+    align-items: start;
 }
-
-.single-content .verse-columns .verse-secondary * {
-  color: inherit;
+.single-content .verse-paired :is(.verse-native, .verse-roman) {
+    min-width: 0;
+    white-space: pre-wrap;
 }
-
-.single-content .verse-columns .verse-part[dir="rtl"] {
-  text-align: start;
+.single-content .verse-paired .verse-roman {
+    font-family: serif;
 }
-
 @container (max-width: 32rem) {
-  .single-content .verse-columns .verse-row {
-    grid-auto-flow: row;
-    grid-template-columns: 1fr;
-  }
-  .single-content .verse-numbered.verse-columns .verse-row {
-    grid-template-columns: 2.5em 1fr;
-  }
-  .single-content .verse-numbered.verse-columns .verse-column {
-    grid-column: 2;
-  }
+    .single-content .verse-paired .verse-row {
+        grid-template-columns: 1fr;
+    }
 }
 
 /* Ornamental horizontal rule: thin line flanking a centered gold

package/types/engine/code-fences.d.mts

@@ -17,13 +17,11 @@ export function parseHeaderArgs(info: string): {
  * @param {object} [options]
  * @param {boolean} [options.spans=true] - Include inline code spans. Set false
  *   to consider only block-level code.
- * @param {boolean} [options.verseAsProse=true] - Treat verse bodies as inline prose.
  * @returns {Array<{start: number, end: number}>} Non-overlapping regions, in
  *   source order. `end` is exclusive.
  */
-export function codeRegions(markdown: string | null | undefined, { spans, verseAsProse }?: {
+export function codeRegions(markdown: string | null | undefined, { spans }?: {
     spans?: boolean | undefined;
-    verseAsProse?: boolean | undefined;
 }): Array<{
     start: number;
     end: number;

package/types/engine/content-blocks.d.mts

@@ -43,10 +43,12 @@ export function scanBlocks(source: string): {
  * @param {object} [options]
  * @param {(markdown: string) => string} [options.renderInline] - How a title
  *   is rendered; omitted, a title is plain inline Markdown.
+ * @param {Map<string, object>} [options.verses] - Shared encoded verse presentations.
  * @returns {{markdown: string, errors: Array<{line: number, column: number, message: string}>}}
  */
-export function renderBlocks(source: string, target: "foundry" | "web" | "preview", { renderInline }?: {
+export function renderBlocks(source: string, target: "foundry" | "web" | "preview", { renderInline, verses }?: {
     renderInline?: ((markdown: string) => string) | undefined;
+    verses?: Map<string, object> | undefined;
 }): {
     markdown: string;
     errors: Array<{

package/types/engine/content-footnotes.d.mts

@@ -81,6 +81,29 @@ export function footnoteFindings(source: string): Array<{
     column: number;
     message: string;
 }>;
+/**
+ * Labels defined at the top level of this note.
+ * @param {string} source - Complete authored note Markdown.
+ * @returns {Set<string>} Same-note footnote labels.
+ */
+export function footnoteLabels(source: string): Set<string>;
+/**
+ * Actual defined references, excluding literal code, escapes and metadata.
+ * @param {string} source - Full note or raw inline fragment.
+ * @param {object} [options] - Definition context and source grammar.
+ * @param {ReadonlySet<string>} [options.definitions] - Same-note labels; derived from source when omitted.
+ * @param {boolean} [options.inline] - Treat all source as inline verse/prose.
+ * @returns {Array<{from:number,to:number,key:string,text:string}>} Original UTF-16 source ranges.
+ */
+export function footnoteReferences(source: string, { definitions, inline }?: {
+    definitions?: ReadonlySet<string> | undefined;
+    inline?: boolean | undefined;
+}): Array<{
+    from: number;
+    to: number;
+    key: string;
+    text: string;
+}>;
 /**
  * A footnote reference's shape, wherever it is written — excluding a
  * definition's own `[^id]:` opener, which this never matches.

package/types/engine/content-scripts.d.mts

@@ -18,7 +18,7 @@ export function runContext(config: {
     };
 } | undefined, records?: Iterable<Record<string, any>>): RunContext;
 /**
- * Find the spans, divs and verse fences marked with `lang=`, `font=` or
+ * Find the spans, divs and verse divs marked with `lang=`, `font=` or
  * `enc=`, and every fault in their markup and their text.
  *
  * @param {string} source - Authored Markdown: a note body, or a whole file
@@ -50,11 +50,10 @@ export function scanRuns(source: string, ctx?: RunContext, syntax?: import("./co
 };
 /**
  * Rewrite text marked with `lang=`, `font=` and `enc=` into the plain span,
- * div and verse grammar the rest of each chain renders, one line for one line.
+ * div and verse grammar the rest of each chain renders.
  *
- * - **Numbered verse prefixes and indentation markers** stay outside run text.
- *   Each authored run chooses its own language and presentation; physical
- *   lines and source positions remain unchanged.
+ * - **Verse layout markers** stay outside encoded text. A shared logical
+ *   structure retains authored source positions and both presentations.
  * - **The enc, if any, is applied first.** Characters Markdown would read are
  *   then backslash-escaped, so they reach every later pass as characters.
  * - **Emphasis in a face** becomes an `<em>` or a `<strong>` carrying its
@@ -81,7 +80,7 @@ export function scanRuns(source: string, ctx?: RunContext, syntax?: import("./co
  *   scanner projections.
  * @param {{target?: "site"|"foundry"|"book"}} [options] - The target the
  *   Markdown is rendered for; only `site` writes the search marker.
- * @returns {{markdown: string, errors: Array<{file?: string, line: number, column: number, message: string}>, scrolls: Map<string, import("./content-scroll.mjs").ScrollLayout>}}
+ * @returns {{markdown: string, errors: Array<{file?: string, line: number, column: number, message: string}>, scrolls: Map<string, import("./content-scroll.mjs").ScrollLayout>, verses: Map<string, {model: ReturnType<typeof import("./content-verse.mjs").parseVerse>, classes: string[], attributes: Record<string, string>, inline: boolean}>}}
  *   The rewritten Markdown, the findings of {@link scanRuns}, and each
  *   rewritten scroll fence's layout, by its rewritten body.
  */
@@ -96,6 +95,12 @@ export function renderRuns(source: string, ctx?: RunContext, syntax?: import("./
         message: string;
     }>;
     scrolls: Map<string, import("./content-scroll.mjs").ScrollLayout>;
+    verses: Map<string, {
+        model: ReturnType<typeof import("./content-verse.mjs").parseVerse>;
+        classes: string[];
+        attributes: Record<string, string>;
+        inline: boolean;
+    }>;
 };
 /** The keys this module reads, which no construct passes through as written. */
 export const RUN_KEYS: readonly string[];
@@ -346,7 +351,7 @@ export type RunContext = {
     directions?: ReadonlyMap<string, "vertical-rl"> | undefined;
 };
 /**
- * One span, div, verse fence or scroll fence carrying run attributes.
+ * One span, div, verse div or scroll fence carrying run attributes.
  * Values combine explicit choices, class-only inheritance, encoding-document
  * language/font defaults and the Roman default encoding.
  */

package/types/engine/content-spans.d.mts

@@ -3,10 +3,12 @@
  * @param {object} [options] - Surface presentation.
  * @param {boolean} [options.source] - Emit opaque authored source tokens for buffer preview.
  * @param {boolean} [options.spoilers] - Add focusable CSS spoiler wrappers (Foundry).
+ * @param {(token: any, state: any) => void} [options.verseInline] - Populate an opaque quoted-verse token during inline parsing.
  */
-export function spanMarkdownPlugin(md: typeof import("markdown-it"), { spoilers, source }?: {
+export function spanMarkdownPlugin(md: typeof import("markdown-it"), { spoilers, source, verseInline }?: {
     source?: boolean | undefined;
     spoilers?: boolean | undefined;
+    verseInline?: ((token: any, state: any) => void) | undefined;
 }): void;
 /** Read span anchors and located attribute diagnostics outside literal code.
  * @param {string} source - Authored Markdown.