@heroiclands/package-build 23.10.0 → 23.12.0

package/engine/web-wikilinks.mjs

@@ -41,7 +41,8 @@
 // cannot drift apart on it: they disagreed once over the unlabelled hyphen
 // form, which the packs showed as a raw shortcode and the knowledgebase as a
 // name.
-import { readWikilink } from "./wikilink-syntax.mjs";
+import { collectAnchors } from "./anchors.mjs";
+import { presentWikilink, readWikilink } from "./wikilink-syntax.mjs";
 import { readQualifier } from "./wikilinks.mjs";
 import { replaceOutsideCode } from "./code-fences.mjs";
 // The canonical `package-system-type-shortcode` key, so a package-qualified
@@ -354,6 +355,7 @@ export function resolveWebWikilinks(body, ctx) {
     // same counting the checker does, and what turns a finding into a
     // `file:line:column:` diagnostic rather than a note-wide one.
     const seen = new Map();
+    let ownAnchors = ctx.noteAnchors;
     /**
      * Records a finding against one authored literal.
      *
@@ -404,18 +406,28 @@ export function resolveWebWikilinks(body, ctx) {
     // Code is verbatim: a `[[…]]` inside a code fence, an indented block or an
     // inline span is source text, not a link.
     return replaceOutsideCode(embedded.markdown, WIKILINK, (all, rawInner) => {
-        const parsed = readWikilink(rawInner, {
-            package: ctx.contentPackage,
-            system: "note",
-            types: ctx.contentTypes ?? new Set(),
-            packages: ctx.packages,
-            noIndexPackages: ctx.noIndexPackages,
-        });
+        const parsed = readWikilink(
+            rawInner,
+            {
+                package: ctx.contentPackage,
+                system: "note",
+                types: ctx.contentTypes ?? new Set(),
+                packages: ctx.packages,
+                noIndexPackages: ctx.noIndexPackages,
+            },
+            all,
+        );
         const { rawTarget: target, anchor, display } = parsed;
         // An empty label is not a label: `[[x|]]` addresses the target and
         // shows its name, so `""` falls through to the same place `null` does.
         // One reading, from {@link authoredLabel}.
         const label = authoredLabel({ display });
+        if (parsed.attributes?.problems.length)
+            return report(
+                all,
+                { target, reason: "invalid-attributes", problems: parsed.attributes.problems },
+                label ?? target,
+            );
 
         // **Every link carries a label**. Without one there is nothing
         // to resolve against, and nothing to show either, a shortcode being an
@@ -445,7 +457,11 @@ export function resolveWebWikilinks(body, ctx) {
                     label ?? anchor,
                 );
             }
-            return `[${label ?? ctx.captionLabels?.get(anchor) ?? anchor}](#${slugify(anchor)})`;
+            return presentWikilink(
+                `[${label ?? ctx.captionLabels?.get(anchor) ?? anchor}](#${slugify(anchor)})`,
+                parsed,
+                { noteAnchors: (ownAnchors ??= collectAnchors(body)) },
+            );
         }
 
         // The canonical separator has to be resolved, not merely
@@ -480,7 +496,7 @@ export function resolveWebWikilinks(body, ctx) {
                     label ?? hit.name ?? target,
                 );
             }
-            if (anchor && hit.url && !hasAnchor(hit.noteAnchors ?? hit.anchors, anchor)) {
+            if (anchor && !hasAnchor(hit.noteAnchors ?? hit.anchors, anchor)) {
                 return report(
                     all,
                     { target, reason: "unknown-anchor", anchor, addressed: true },
@@ -506,8 +522,13 @@ export function resolveWebWikilinks(body, ctx) {
             // Presentation only — the href above is unchanged, and a
             // `[[#anchor]]` self-link is not marked because the reader is
             // already on the page it would be telling them about.
-            if (!hit.draft) return link;
-            return ctx.output === "book" ? `${link} (draft)` : draftLink(link);
+            return presentWikilink(
+                !hit.draft ? link
+                : ctx.output === "book" ? `${link} (draft)`
+                : draftLink(link),
+                parsed,
+                hit,
+            );
         }
 
         // **An address resolving nowhere is a failure, unconditionally**.

package/engine/wikilink-syntax.mjs

@@ -11,6 +11,9 @@
  * SPDX-License-Identifier: GPL-3.0-or-later
  */
 
+import { parseExtensionAttributes, refusedAttributes } from "./extension-attributes.mjs";
+import { isGmNote } from "./note-vocabulary.mjs";
+
 import { parseAddress, isAddressTuple, splitAnchor } from "./address.mjs";
 
 /**
@@ -67,7 +70,7 @@ import { parseAddress, isAddressTuple, splitAnchor } from "./address.mjs";
  * copies of the exclusion is three places for it to be forgotten. An embed's
  * own grammar is {@link module:engine/content-embeds}.
  */
-export const WIKILINK = /(?<!!)\[\[([^\]\n]+)\]\]/g;
+export const WIKILINK = /(?<!!)\[\[([^\]\n]+)\]\](?:\{(?:[^{}"\n]|"(?:\\.|[^"\\\n])*")*\})?/g;
 
 /**
  * The parts of a wikilink's interior.
@@ -80,6 +83,7 @@ export const WIKILINK = /(?<!!)\[\[([^\]\n]+)\]\]/g;
  * @property {string} anchor - The `#section` slug, `""` when there is none.
  * @property {string|null} display - The text after `|`, or `null` when the link
  *   is unlabelled. `null` and `""` differ: an author may write `[[x|]]`.
+ * @property {ReturnType<typeof parseExtensionAttributes>} [attributes] - Trailing extension attributes.
  * @property {boolean} labelled - Whether a `|` was present at all. A link
  *   without one addresses nothing and is a finding — see
  *   {@link unlabelledLinkMessage} — so every reader has to be able to ask.
@@ -92,9 +96,10 @@ export const WIKILINK = /(?<!!)\[\[([^\]\n]+)\]\]/g;
  * not the whole link, so a caller that has already matched does not re-match.
  *
  * @param {string} rawInner - The text between `[[` and `]]`.
+ * @param {string} [literal] - Whole matched link, including trailing attributes.
  * @returns {ParsedWikilink} The parts, each trimmed.
  */
-export function parseWikilink(rawInner) {
+export function parseWikilink(rawInner, literal = "") {
     // A pipe inside a markdown table cell is escaped as `\|`; undo that before
     // looking for the label separator, or the cell's own escape reads as one.
     const inner = String(rawInner ?? "").replace(/\\\|/g, "|");
@@ -108,7 +113,18 @@ export function parseWikilink(rawInner) {
     // link and a field cannot disagree about where the anchor starts.
     const { address: target, anchor = "" } = splitAnchor(linkPart);
 
-    return { inner: inner.trim(), target, anchor, display, labelled };
+    const suffix = literal.slice(literal.indexOf("]]") + 2);
+    const attributes =
+        suffix.startsWith("{") ? parseExtensionAttributes(suffix.slice(1, -1)) : null;
+    if (attributes) attributes.problems.push(...refusedAttributes(attributes.values));
+    return {
+        inner: inner.trim(),
+        target,
+        anchor,
+        display,
+        labelled,
+        ...(attributes ? { attributes } : {}),
+    };
 }
 
 /**
@@ -193,6 +209,7 @@ export function unlabelledLinkMessage(target) {
  */
 export const LINK_FINDING_REASONS = Object.freeze(
     new Set([
+        "invalid-attributes",
         "unlabelled",
         "not-an-address",
         "not-lowercase",
@@ -201,7 +218,6 @@ export const LINK_FINDING_REASONS = Object.freeze(
         "not-an-asset",
         "unresolved",
         "stub",
-        "gm",
         "ambiguous",
         "unknown-anchor",
         "event-anchor",
@@ -323,6 +339,7 @@ export function ambiguousAddressMessage(target, packages = []) {
  * @param {string} [finding.stub] - For `stub`, where the stub is.
  * @param {string} [finding.shortcode] - For `shortcode-not-lowercase`, the
  *   shortcode as written.
+ * @param {string[]} [finding.problems] - Invalid attribute diagnostics.
  * @param {string} [finding.declared] - For `shortcode-not-lowercase`, the
  *   lowercase spelling, when it is a declared shortcode.
  * @returns {string} The message.
@@ -338,8 +355,11 @@ export function linkFindingMessage({
     stub,
     shortcode,
     declared,
+    problems,
 }) {
     switch (reason) {
+        case "invalid-attributes":
+            return `wikilink [[${target}]] has invalid attributes: ${(problems ?? []).join("; ")}`;
         case "unlabelled":
             return unlabelledLinkMessage(target);
         case "not-an-address":
@@ -386,8 +406,6 @@ export function linkFindingMessage({
             return unresolvedAddressMessage(target);
         case "stub":
             return stubAddressMessage(target, stub);
-        case "gm":
-            return `address [[${target}]] names a GM-only note from a player-facing note`;
         case "no-content-index":
             return (
                 `address [[${target}]] names a package declared \`contentIndex: false\` — ` +
@@ -419,10 +437,11 @@ export function isSamePage({ target, anchor }) {
  * Read an operational link target in its enclosing Address context.
  * @param {string} inner - Lexical link contents.
  * @param {object} context - Builder defaults and type vocabulary.
+ * @param {string} [literal] - Whole matched link, including trailing attributes.
  * @returns {object} Typed target and diagnostic source spelling.
  */
-export function readWikilink(inner, context) {
-    const parsed = parseWikilink(inner);
+export function readWikilink(inner, context, literal = "") {
+    const parsed = parseWikilink(inner, literal);
     const rawTarget = parsed.target;
     if (!rawTarget) return { ...parsed, rawTarget, target: { kind: "same-page" } };
     const target = parseAddress(rawTarget, context);
@@ -433,3 +452,41 @@ export function readWikilink(inner, context) {
             { ...parsed, rawTarget, target: { kind: "literal", text: rawTarget }, problem: target }
         :   { ...parsed, rawTarget, target };
 }
+
+/** Whether the actual referenced destination needs spoiler presentation.
+ * @param {object} destination - Resolved note metadata.
+ * @param {string} [anchor] - Referenced prose anchor.
+ * @returns {boolean} Whole-note or section audience.
+ */
+export function secretDestination(destination, anchor = "") {
+    return Boolean(
+        destination?.gm ||
+        isGmNote(destination?.fm ?? destination) ||
+        (anchor && destination?.noteAnchors?.some((one) => one.slug === anchor && one.secret)),
+    );
+}
+
+/** Apply destination-derived presentation without changing its address.
+ * @param {string} reference - Rendered reference Markdown.
+ * @param {object} parsed - Shared parsed wikilink.
+ * @param {object} destination - Resolved target metadata.
+ * @returns {string} Inline spoiler or visible reference.
+ */
+export function presentWikilink(reference, parsed, destination) {
+    const attrs = parsed.attributes;
+    const classes = (attrs?.classes ?? []).filter((value) => value !== "show");
+    if (
+        !attrs?.classes.includes("show") &&
+        secretDestination(destination, parsed.anchor) &&
+        !classes.includes("secret")
+    )
+        classes.push("secret");
+    const fields = [
+        attrs?.id ? `#${attrs.id}` : "",
+        ...classes.map((value) => `.${value}`),
+        ...Object.entries(attrs?.values ?? {}).map(
+            ([key, value]) => `${key}="${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`,
+        ),
+    ].filter(Boolean);
+    return fields.length ? `[${reference}]{${fields.join(" ")}}` : reference;
+}

package/engine/wikilinks.mjs

@@ -27,7 +27,7 @@
 
 import { resolveShortcodeReference } from "./shortcode-references.mjs";
 
-import { readWikilink } from "./wikilink-syntax.mjs";
+import { presentWikilink, readWikilink } from "./wikilink-syntax.mjs";
 import crypto from "crypto";
 
 import { compendiumUuid, ITEM_PACK, packForType, pageUuid, PACK_BY_TYPE } from "./ids.mjs";
@@ -407,15 +407,29 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
     // one capture group. It is what makes two identical unresolved links on
     // one note tellable apart, and a position reportable at all.
     const out = replaceOutsideCode(markdown, WIKILINK, (all, rawInner, offset) => {
-        const parsed = readWikilink(rawInner, {
-            package: index.contentPackage,
-            system: "note",
-            types: index.types,
-            packages: index.packages,
-            noIndexPackages: index.noIndexPackages,
-        });
+        const parsed = readWikilink(
+            rawInner,
+            {
+                package: index.contentPackage,
+                system: "note",
+                types: index.types,
+                packages: index.packages,
+                noIndexPackages: index.noIndexPackages,
+            },
+            all,
+        );
         const target = parsed.rawTarget;
         const slug = parsed.anchor || null;
+        if (parsed.attributes?.problems.length) {
+            unresolved.push({
+                link: all,
+                target,
+                offset,
+                reason: "invalid-attributes",
+                problems: parsed.attributes.problems,
+            });
+            return unresolvedLink(authoredLabel(parsed) ?? target, target);
+        }
 
         // **Every link carries a label**. Without one there is nothing
         // to resolve against: a shortcode is an address rather than prose, so
@@ -512,7 +526,11 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
             if (hit) {
                 const uuid = slug ? hit.anchors?.[slug] : hit.uuid;
                 if (uuid) {
-                    return `@UUID[${uuid}]{${text || hit.name || target}}`;
+                    return presentWikilink(
+                        `@UUID[${uuid}]{${text || hit.name || target}}`,
+                        parsed,
+                        hit,
+                    );
                 }
                 unresolved.push({
                     link: all,
@@ -559,7 +577,7 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
         const entryUuid = itemDoc ? addresses.docUuid : addresses.uuid;
         // The target has no single Foundry document. Its address is real, but
         // a compendium has nothing to open, so the reader gets the label.
-        if (entryUuid === undefined) return text;
+        if (entryUuid === undefined) return presentWikilink(text, parsed, doc);
         const entryId = itemDoc ? itemDocEntryId(doc.id) : doc.id;
         const isJournal = itemDoc || packForType(doc.type).docType === "JournalEntry";
         // A JournalEntry link opens a journal — at its first page, or at the
@@ -614,7 +632,7 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
         // Presentation only — the UUID above is unchanged, and a
         // `[[#slug]]` self-link is not marked because the reader is already in
         // the note it would be telling them about.
-        return doc.draft ? draftLink(link) : link;
+        return presentWikilink(doc.draft ? draftLink(link) : link, parsed, doc);
     });
 
     return { markdown: out, unresolved };

package/hugo-theme/layouts/_default/list.html

@@ -19,7 +19,7 @@
   <div class="single-content">
     {{ if .Content }}
     <div class="single-body" data-pagefind-body>
-      {{ .Content }}
+      {{ partial "dictionary-lists.html" .Content }}
     </div>
     {{ end }}
 

package/hugo-theme/layouts/blog/list.html

@@ -4,7 +4,7 @@
   <div class="single-content">
     {{ if .Content }}
     <div class="single-body">
-      {{ .Content }}
+      {{ partial "dictionary-lists.html" .Content }}
     </div>
     {{ end }}
 

package/hugo-theme/layouts/blog-post/single.html

@@ -22,7 +22,7 @@
     </div>
 
     <div class="single-body" data-pagefind-body>
-      {{ .Content }}
+      {{ partial "dictionary-lists.html" .Content }}
     </div>
 
     {{ partial "related.html" . }}

package/hugo-theme/layouts/partials/dictionary-lists.html

@@ -0,0 +1,53 @@
+{{- /* Group the final Goldmark HTML. Quote-aware tokens preserve attributes,
+     literal examples, comments and raw blocks; a stack gives each nested list
+     its own rows. Existing grouped lists keep their authored divs. */ -}}
+{{- $source := string . -}}
+{{- if not (findRE `(?i)<dl(?:\s|>)` $source) -}}{{- return ($source | safeHTML) -}}{{- end -}}
+{{- $pattern := `(?is)<!--.*?-->|<script\b(?:[^"'<>]|"[^"]*"|'[^']*')*>.*?</script\s*>|<style\b(?:[^"'<>]|"[^"]*"|'[^']*')*>.*?</style\s*>|<pre\b(?:[^"'<>]|"[^"]*"|'[^']*')*>.*?</pre\s*>|<textarea\b(?:[^"'<>]|"[^"]*"|'[^']*')*>.*?</textarea\s*>|<![^>]*>|</?[a-z][a-z0-9:-]*(?:[^"'<>]|"[^"]*"|'[^']*')*>|[^<]+|<` -}}
+{{- $parts := slice -}}
+{{- $lists := slice -}}
+{{- $elements := slice -}}
+{{- $tokens := findRE $pattern $source -}}
+{{- range $i, $token := $tokens -}}
+  {{- if and (gt (len $lists) 0) (gt $i 0) (lt (add $i 1) (len $tokens)) (findRE `^\s+$` $token) (findRE `(?i)^</dt\s*>$` (index $tokens (sub $i 1))) (findRE `(?i)^<dd(?:\s|>)` (index $tokens (add $i 1))) -}}
+    {{- $token = "" -}}
+  {{- end -}}
+  {{- if and (gt (len $lists) 0) (gt $i 0) (lt (add $i 1) (len $tokens)) (findRE `^\s+$` $token) (findRE `(?i)^<dd(?:\s[^>]*)?>$` (index $tokens (sub $i 1))) (findRE `(?i)^<p(?:\s|>)` (index $tokens (add $i 1))) -}}
+    {{- $token = "" -}}
+  {{- end -}}
+  {{- $tag := "" -}}
+  {{- $opaque := findRE `(?i)^<(?:!--|script\b|style\b|pre\b|textarea\b)` $token -}}
+  {{- if and (not $opaque) (findRE `(?i)^</?[a-z]` $token) -}}
+    {{- $tag = lower (replaceRE `(?is)^</?([a-z][a-z0-9:-]*).*` "$1" $token) -}}
+    {{- $closing := hasPrefix $token "</" -}}
+    {{- if and (eq $tag "dl") (not $closing) -}}
+      {{- $list := newScratch -}}
+      {{- $list.Set "row" false -}}
+      {{- $lists = $lists | append $list -}}
+      {{- if or (findRE `(?i)\sclass\s*=\s*["'](?:[^"']*\s)?dictionary(?:\s|["'])` $token) (findRE `(?i)\sclass\s*=\s*dictionary(?:\s|>)` $token) -}}
+      {{- else if findRE `(?i)\sclass\s*=\s*["']` $token -}}
+        {{- $token = replaceRE `(?i)(\sclass\s*=\s*["'])` "${1}dictionary " $token -}}
+      {{- else if findRE `(?i)\sclass\s*=` $token -}}
+        {{- $token = replaceRE `(?i)(\sclass\s*=\s*)([^\s>]+)` `${1}"dictionary ${2}"` $token -}}
+      {{- else -}}
+        {{- $token = replaceRE `(?i)^<dl` `<dl class="dictionary"` $token -}}
+      {{- end -}}
+    {{- else if and (eq $tag "dt") (not $closing) (gt (len $lists) 0) (eq (index $elements (sub (len $elements) 1)) "dl") -}}
+      {{- $list := index $lists (sub (len $lists) 1) -}}
+      {{- if $list.Get "row" -}}{{- $parts = $parts | append "</div>" -}}{{- end -}}
+      {{- $parts = $parts | append "<div>" -}}
+      {{- $list.Set "row" true -}}
+    {{- else if and (eq $tag "dl") $closing (gt (len $lists) 0) -}}
+      {{- $list := index $lists (sub (len $lists) 1) -}}
+      {{- if $list.Get "row" -}}{{- $parts = $parts | append "</div>" -}}{{- end -}}
+      {{- $lists = first (sub (len $lists) 1) $lists -}}
+    {{- end -}}
+    {{- if $closing -}}
+      {{- if gt (len $elements) 0 -}}{{- $elements = first (sub (len $elements) 1) $elements -}}{{- end -}}
+    {{- else if not (or (findRE `/\s*>$` $token) (in (slice "area" "base" "br" "col" "embed" "hr" "img" "input" "link" "meta" "param" "source" "track" "wbr") $tag)) -}}
+      {{- $elements = $elements | append $tag -}}
+    {{- end -}}
+  {{- end -}}
+  {{- $parts = $parts | append $token -}}
+{{- end -}}
+{{- return (delimit $parts "" | safeHTML) -}}

package/hugo-theme/layouts/partials/footer.html

@@ -27,3 +27,5 @@ document.querySelector('.nav-toggle')?.addEventListener('click', function() {
   this.classList.toggle('open');
 });
 </script>
+
+<script src="{{ "js/inline-spoilers.js" | relURL }}" defer></script>

package/hugo-theme/layouts/partials/page-body.html

@@ -67,7 +67,7 @@
     {{ end }}
 
     <div class="single-body" data-pagefind-body>
-      {{ .Content }}
+      {{ partial "dictionary-lists.html" .Content }}
     </div>
 
     {{ partial "related.html" . }}

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

@@ -2955,20 +2955,21 @@ summary.info-sidebar-title::after {
   }
 }
 
-/* GitHub-style author alerts remain open and inherit the prose foreground. */
+/* Author alerts use the dark palette of this site's single-mode theme. */
 .single-content .alert {
   border-inline-start: 0.25rem solid var(--pb-alert-color);
-  padding: 0.5rem 1rem;
+  border-radius: 0.375rem;
+  padding: 1rem;
   margin: 1rem 0;
-  color: inherit;
-  background: transparent;
+  color: #e6edf3;
+  background: var(--pb-alert-background);
 }
 .single-content .alert-title {
   display: flex;
   align-items: center;
   gap: 0.5em;
   margin: 0 0 0.5rem;
-  font-weight: 600;
+  font-weight: 700;
   color: var(--pb-alert-color);
 }
 .single-content .alert-icon {
@@ -2981,14 +2982,43 @@ summary.info-sidebar-title::after {
   margin-bottom: 0;
 }
 .single-content .alert-note {
-  --pb-alert-color: #4493f8;
+  --pb-alert-color: #58a6ff;
+  --pb-alert-background: #101a28;
 }
 .single-content .alert-tip {
-  --pb-alert-color: #3fb950;
+  --pb-alert-color: #7ee787;
+  --pb-alert-background: #102018;
 }
 .single-content .alert-important {
-  --pb-alert-color: #ab7df8;
+  --pb-alert-color: #c4b0ff;
+  --pb-alert-background: #1c172a;
 }
 .single-content .alert-warning {
   --pb-alert-color: #d29922;
-}
+  --pb-alert-background: #241d10;
+}
+
+/* Inline spoiler controls remain inline, with links outside the button. */
+[data-inline-secret] .inline-secret-content[hidden] { display: none !important; }
+.inline-secret-toggle {
+    display: inline;
+    padding: 0.05em 0.35em;
+    border: 1px solid currentColor;
+    border-radius: 0.2em;
+    color: inherit;
+    background: transparent;
+    font: inherit;
+    font-size: 0.85em;
+    cursor: pointer;
+}
+.inline-secret-toggle:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; }
+.inline-secret-content { margin-inline-start: 0.25em; }
+
+/* Authored definition lists use dictionary rows; profile grids remain separate. */
+.single-body .dictionary { --indent:150px; --gap:.75em; margin:0; display:block; }
+.single-body .dictionary > div { padding-left:var(--indent); text-indent:calc(-1 * var(--indent)); margin-bottom:.5em; }
+.single-body .dictionary > div > dt { display:inline-block; min-width:calc(var(--indent) - var(--gap)); margin-right:var(--gap); font-weight:bold; white-space:nowrap; text-indent:0; text-align:left; }
+.single-body .dictionary > div > dd { display:inline; margin:0; font-weight:normal; }
+.single-body .dictionary > div > dd > :is(p, ul, ol, dl, blockquote, pre, table, div) { text-indent:0; }
+.single-body .dictionary > div > dd > p:first-child { display:inline; }
+@media (max-width:600px) { .single-body .dictionary { --indent:100px; } }

package/hugo-theme/static/js/inline-spoilers.js

@@ -0,0 +1,23 @@
+/*
+ * This file is part of the Song of Heroic Lands (SoHL) system for Foundry VTT.
+ * Copyright (c) 2024-2026 Tom Rodriguez ("Toasty") — <toasty@heroiclands.org>
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+// A native button provides pointer, Enter and Space activation without taking
+// keyboard events away from links within the independently revealed content.
+document.addEventListener("click", (event) => {
+    const button = event.target.closest?.(".inline-secret-toggle");
+    if (!button) return;
+    const wrapper = button.parentElement;
+    const content = button.nextElementSibling;
+    if (!wrapper?.hasAttribute("data-inline-secret") || !content?.classList.contains("inline-secret-content")) return;
+    const expanded = button.getAttribute("aria-expanded") !== "true";
+    if (!expanded && content.contains(document.activeElement)) button.focus();
+    content.hidden = !expanded;
+    button.setAttribute("aria-expanded", String(expanded));
+    const label = expanded ? "Hide spoiler" : "Show spoiler";
+    button.setAttribute("aria-label", label);
+    button.textContent = label;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "23.10.0",
+    "version": "23.12.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",
@@ -35,6 +35,11 @@
             "types": "./types/hm3/*.d.mts",
             "import": "./hm3/*.mjs"
         },
+        "./preview": {
+            "types": "./types/engine/site-preview.d.mts",
+            "import": "./engine/site-preview.mjs",
+            "default": "./engine/site-preview.mjs"
+        },
         "./content-config": {
             "types": "./types/content-config.d.mts",
             "import": "./content-config.mjs"
@@ -95,7 +100,8 @@
         "./package.json": "./package.json"
     },
     "bin": {
-        "package-build": "./bin/package-build.mjs"
+        "package-build": "./bin/package-build.mjs",
+        "package-build-preview": "./bin/package-build-preview.mjs"
     },
     "files": [
         "CHANGELOG-content-build.md",

package/types/content-config.d.mts

@@ -628,6 +628,10 @@ export type ContentBuildConfigInput = {
      * depends on the working directory.
      */
     rootDir: string;
+    /**
+     * Setting-wide neutral current date; defaults to "720.1".
+     */
+    currentDate?: string | undefined;
     /**
      * Content package name — the address
      * namespace every note in this
@@ -748,6 +752,10 @@ export type ContentBuildConfigInput = {
  * The normalized, frozen configuration the toolchain reads.
  */
 export type ContentBuildConfig = {
+    /**
+     * Setting-wide neutral current date.
+     */
+    currentDate: string;
     rootDir: string;
     contentPackage: string;
     /**

package/types/engine/anchors.d.mts

@@ -14,7 +14,7 @@
  *   {@link module:engine/content-figures.scanFigures}.
  * @param {import("./content-session.mjs").ContentSyntax} [syntax] - Exact-text scanner projections.
  * @returns {Array<{slug: string, name: string, level: number, line: number,
- *   kind: string}>} In document order.
+ *   kind: string, secret?: boolean}>} In document order.
  */
 export function collectAnchors(body: string, bodyLine?: number, resolveRole?: (address: string) => string | undefined, syntax?: import("./content-session.mjs").ContentSyntax): Array<{
     slug: string;
@@ -22,6 +22,7 @@ export function collectAnchors(body: string, bodyLine?: number, resolveRole?: (a
     level: number;
     line: number;
     kind: string;
+    secret?: boolean;
 }>;
 /** Collisions involving a div, verse or inline-span anchor.
  * Heading and caption collisions are diagnosed by their existing scanners.

package/types/engine/base-compiler.d.mts

@@ -358,7 +358,7 @@ export class BasePackCompiler {
     reportsCorpusProblems: boolean | undefined;
     linkIndex: any;
     sqlTables: any;
-    worldPresent: unknown;
+    currentDate: string | undefined;
     /**
      * Report every finding {@link BasePackCompiler#convertBody} collected
      * across its passes, and decline the note if there were any.