@heroiclands/package-build 23.0.0 → 23.1.0

package/engine/wikilink-syntax.mjs

@@ -11,7 +11,7 @@
  * SPDX-License-Identifier: GPL-3.0-or-later
  */
 
-import { parseAddress, isAddressTuple } from "./address.mjs";
+import { parseAddress, isAddressTuple, splitAnchor } from "./address.mjs";
 
 /**
  * What a `[[…]]` **is**, before anything decides where it points.
@@ -104,9 +104,9 @@ export function parseWikilink(rawInner) {
     const linkPart = (labelled ? inner.slice(0, bar) : inner).trim();
     const display = labelled ? inner.slice(bar + 1).trim() : null;
 
-    const hash = linkPart.indexOf("#");
-    const target = (hash === -1 ? linkPart : linkPart.slice(0, hash)).trim();
-    const anchor = hash === -1 ? "" : linkPart.slice(hash + 1).trim();
+    // The anchor is read by the one reader a frontmatter Address uses, so a
+    // 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 };
 }
@@ -206,10 +206,32 @@ export const LINK_FINDING_REASONS = Object.freeze(
         "gm",
         "ambiguous",
         "unknown-anchor",
+        "event-anchor",
         "no-content-index",
     ]),
 );
 
+/**
+ * Whether an anchor a link names is one of its target's events.
+ *
+ * A wikilink names a `prose` anchor; an `event` anchor is named only by the
+ * frontmatter keys that accept one. A local target carries its event ids as
+ * `eventAnchors`, a target another package publishes carries its kinded
+ * anchors as `noteAnchors`.
+ *
+ * @param {{eventAnchors?: Set<string>, noteAnchors?: Array<{slug: string,
+ *   kind?: string}>}|undefined} hit - The link's resolved target.
+ * @param {string} anchor - The anchor the link names.
+ * @returns {boolean} Whether it is an event.
+ */
+export function isEventAnchor(hit, anchor) {
+    if (!hit || !anchor) return false;
+    if (hit.eventAnchors?.has?.(anchor)) return true;
+    return Array.isArray(hit.noteAnchors) ?
+            hit.noteAnchors.some((one) => one?.slug === anchor && one.kind === "event")
+        :   false;
+}
+
 /**
  * What an author writing an address that resolves to nothing is told.
  *
@@ -341,6 +363,14 @@ export function linkFindingMessage({ reason, target, packages, anchor, type, stu
                 `address [[${target}]] resolves, but no section "#${anchor ?? ""}" ` +
                 `is published for it`
             );
+        case "event-anchor":
+            // A link on the event's own note has no note to link to instead,
+            // so it names nothing to write in its place.
+            return target ?
+                    `address [[${target}#${anchor ?? ""}]] names an event, and prose links to ` +
+                        `the note, not to an event — write [[${target}|…]]`
+                :   `address [[#${anchor ?? ""}]] names an event of this note, and prose ` +
+                        "links to sections, not to events — write the words without a link";
         case "unresolved":
             return unresolvedAddressMessage(target);
         case "stub":

package/engine/wikilinks.mjs

@@ -56,6 +56,7 @@ import { replaceOutsideCode } from "./code-fences.mjs";
 import {
     authoredLabel,
     WIKILINK,
+    isEventAnchor,
     parseWikilink,
     unlabelledLinkMessage,
 } from "./wikilink-syntax.mjs";
@@ -100,8 +101,8 @@ export function anchorPageId(noteId, anchorSlug) {
  *
  * @param {Array<{type: string, id: string, shortcode?: string|null,
  *   name?: string, pack?: string, docPack?: string, none?: boolean,
- *   draft?: boolean, anchors?: Set<string>, anchorUuids?: Record<string,string>,
- *   docAnchorUuids?: Record<string,string>}>} docs -
+ *   draft?: boolean, anchors?: Set<string>, eventAnchors?: Set<string>,
+ *   anchorUuids?: Record<string,string>, docAnchorUuids?: Record<string,string>}>} docs -
  *   One entry per content note. `pack` / `docPack` name the packs the note's
  *   document and its documentation entry landed in; omitted, the conventional
  *   one-pack-per-type names stand in. `none` says the note declares
@@ -486,6 +487,17 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
                 return unresolvedLink(text || target, target);
             }
             const hit = hits[0] ?? null;
+            if (hit && slug && isEventAnchor(hit, slug)) {
+                unresolved.push({
+                    link: all,
+                    target,
+                    offset,
+                    reason: "event-anchor",
+                    anchor: slug,
+                    addressed: true,
+                });
+                return unresolvedLink(text || target, target);
+            }
             if (hit) {
                 const uuid = slug ? hit.anchors?.[slug] : hit.uuid;
                 if (uuid) {
@@ -553,6 +565,19 @@ export function convertWikilinks(markdown, { type, id, pack, docPack, index, cap
         // the manifest carries the map — and a local one now is too, from the
         // anchor set the index carries.
         const anchorUuids = itemDoc ? addresses.docAnchors : addresses.anchors;
+        // A wikilink names a prose anchor; an event's id is refused here, before
+        // any surface renders a link to it.
+        if (slug && isEventAnchor(doc, slug)) {
+            unresolved.push({
+                link: all,
+                target,
+                offset,
+                reason: "event-anchor",
+                anchor: slug,
+                addressed: true,
+            });
+            return unresolvedLink(text || doc.name || target, target);
+        }
         if (
             slug &&
             isJournal &&

package/hugo-theme/layouts/partials/infobox/entry.html

@@ -1,13 +1,16 @@
 {{- /*
   One entry of a `runin` group or a `list` section.
 
-  An entry is `{text, url}`. It links when the build reached the page it
+  An entry is `{lead, text, url}`. It links when the build reached the page it
   names, and keeps its words when it did not — a panel naming something this
   site does not publish is better than a panel silently one entry short.
+  `lead`, where present, is plain text set before the link, so a line such as
+  a membership links the body's name and nothing else.
 
   Takes `entry` and the `class` its medium gives it.
 */ -}}
 {{- $entry := .entry -}}
+{{- with $entry.lead }}{{ . }}{{ end -}}
 {{- with $entry.url -}}
 <a class="{{ $.class }}" href="{{ . }}">{{ $entry.text }}</a>
 {{- else -}}

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

@@ -70,9 +70,6 @@
       {{ .Content }}
     </div>
 
-    {{ partial "holdings.html" . }}
-    {{ partial "literature-works.html" . }}
-    {{ partial "place-map.html" . }}
     {{ partial "related.html" . }}
 
     {{- /*

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

@@ -2862,20 +2862,14 @@ summary.info-sidebar-title::after {
   }
 }
 
-/* ---- Related and Holdings cards (bottom of article) ----
-
-   Both are bordered, tinted cards holding one or more labelled groups, each
-   group's entries laid out as a CSS grid that reflows its own column count
-   from the available width — two or three columns on a desktop, one on a
-   phone — with no breakpoint needed. Related groups by the connected page's
-   `type`; Holdings groups `contains` and `governed_places` by place `subType`
-   (`.holdings-kind-group`, one level deeper, for the region/settlement/site
-   hierarchy) and leaves `governed_by` a flat grid with the kind printed beside
-   each name. */
-
-.related,
-.holdings,
-.place-map {
+/* ---- Related card (bottom of article) ----
+
+   A bordered, tinted card holding one or more labelled groups, each group's
+   entries laid out as a CSS grid that reflows its own column count from the
+   available width — two or three columns on a desktop, one on a phone — with
+   no breakpoint needed. Related groups by the connected page's `type`. */
+
+.related {
   margin: 3rem 0 1rem;
   padding: 1.5rem 1.75rem;
   background: var(--bg-card);
@@ -2883,8 +2877,7 @@ summary.info-sidebar-title::after {
   border-radius: 0.5rem;
 }
 
-.related-heading,
-.place-map-heading {
+.related-heading {
   font-family: var(--font-display);
   font-size: 1.4rem;
   font-weight: 700;
@@ -2895,13 +2888,11 @@ summary.info-sidebar-title::after {
   border-bottom: 1px solid var(--border);
 }
 
-.related-group + .related-group,
-.holdings-table + .holdings-table {
+.related-group + .related-group {
   margin-top: 1.25rem;
 }
 
-.related-group-label,
-.holdings-table-label {
+.related-group-label {
   font-family: var(--font-display);
   font-size: 0.94rem;
   font-weight: 700;
@@ -2910,8 +2901,7 @@ summary.info-sidebar-title::after {
   margin: 0 0 0.5rem;
 }
 
-.related-group-grid,
-.holdings-table-grid {
+.related-group-grid {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(14em, 1fr));
   gap: 0.4rem 1rem;
@@ -2920,49 +2910,27 @@ summary.info-sidebar-title::after {
   list-style: none;
 }
 
-.related-group-grid li,
-.holdings-table-grid li {
+.related-group-grid li {
   color: var(--text);
   font-size: 0.94rem;
   line-height: 1.5;
   overflow-wrap: break-word;
 }
 
-.related-group-grid a,
-.holdings-table-grid a {
+.related-group-grid a {
   color: var(--accent);
   border-bottom: 1px solid transparent;
 }
 
-.related-group-grid a:hover,
-.holdings-table-grid a:hover {
+.related-group-grid a:hover {
   color: var(--accent-hover);
   border-bottom-color: var(--accent-dim);
 }
 
-.holdings-kind-group + .holdings-kind-group {
-  margin-top: 0.75rem;
-}
-
-.holdings-kind-label {
-  font-weight: 700;
-  font-size: 0.76rem;
-  letter-spacing: 0.06em;
-  text-transform: uppercase;
-  color: var(--text-muted);
-  margin: 0 0 0.35rem;
-}
-
-.holdings-entry-kind {
-  color: var(--text-muted);
-}
-
-.place-map-drawing {
-  max-width: 100%;
-  overflow-x: auto;
-}
-
-.place-map-drawing svg {
+/* A drawing the build sets inline — the map in a place's From here section —
+   scales to its figure, and scrolls rather than shrinking past legibility on
+   a phone. */
+.single-content figure.note-image > svg {
   display: block;
   width: 100%;
   max-width: 100%;
@@ -2970,13 +2938,15 @@ summary.info-sidebar-title::after {
 }
 
 @media (max-width: 640px) {
-  .place-map-drawing svg {
+  .single-content figure.note-image:has(> svg) {
+    overflow-x: auto;
+  }
+
+  .single-content figure.note-image > svg {
     min-width: 32rem;
   }
 
-  .related,
-  .holdings,
-  .place-map {
+  .related {
     padding: 1.25rem 1.25rem;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "23.0.0",
+    "version": "23.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",
@@ -133,7 +133,6 @@
     "dependencies": {
         "@duckdb/node-api": "^1.5.5-r.4",
         "@foundryvtt/foundryvtt-cli": "^3.0.4",
-        "@resvg/resvg-js": "^2.6.2",
         "@viz-js/viz": "^3.30.0",
         "acorn": "^8.18.0",
         "archiver": "^8.0.0",

package/packagebuild-metadata.jsonl

@@ -1,13 +1,13 @@
-{"address":{"canonical":"packagebuild-none-image-afflictionbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/afflictionbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"afflictionbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-armorclothingbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/armorclothingbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"armorclothingbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-attributebnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/attributebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"attributebnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-containerbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/containerbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"containerbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-devdocsbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/devdocsbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"devdocsbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-miscgearbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/miscgearbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"miscgearbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-mysticalabilitybnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/mysticalabilitybnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"mysticalabilitybnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-projectilebnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/projectilebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"projectilebnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-rulesbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/rulesbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"rulesbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-skillbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/skillbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"skillbnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-traumabnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/traumabnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"traumabnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-userguidebnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/userguidebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"userguidebnr","type":"image"}
-{"address":{"canonical":"packagebuild-none-image-weapongearbnr"},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/weapongearbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"weapongearbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-afflictionbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/afflictionbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"afflictionbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-armorclothingbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/armorclothingbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"armorclothingbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-attributebnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/attributebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"attributebnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-containerbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/containerbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"containerbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-devdocsbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/devdocsbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"devdocsbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-miscgearbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/miscgearbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"miscgearbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-mysticalabilitybnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/mysticalabilitybnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"mysticalabilitybnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-projectilebnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/projectilebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"projectilebnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-rulesbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/rulesbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"rulesbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-skillbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/skillbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"skillbnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-traumabnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/traumabnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"traumabnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-userguidebnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/userguidebnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"userguidebnr","type":"image"}
+{"address":{"canonical":{"address":"packagebuild-none-image-weapongearbnr","anchor":null,"anchorKind":null}},"asset":{"ai":false,"attribution":"Tom Rodriguez","height":768,"license":"CC-BY-SA-4.0","notes":"","path":"images/banners/weapongearbnr.webp","role":"","source":"","width":1792},"package":"packagebuild","shortcode":"weapongearbnr","type":"image"}

package/sohl/note-schemas.mjs

@@ -20,7 +20,7 @@
  * builder cannot disagree — they are one object. The linter simply reads it.
  *
  * **The other types are declared, because their compilers are hand-written.**
- * A being, a macro, a journal note and the three map types are built by code
+ * A being, a macro, a journal note and a map are built by code
  * that reads frontmatter directly rather than from a field list, so their
  * vocabulary has to be *stated* to be checkable. These entries carry no `to`:
  * nothing here builds anything, and claiming an emitted path they do not
@@ -37,7 +37,7 @@
  * @module
  */
 
-import { AS_AUTHORED, NUMBER, STRING } from "../engine/field-spec.mjs";
+import { AS_AUTHORED, STRING } from "../engine/field-spec.mjs";
 import { ENGINE_NOTE_SCHEMAS } from "../engine/note-schemas.mjs";
 import { ITEM_FIELDS } from "./item-fields.mjs";
 
@@ -128,81 +128,16 @@ const BEING_FIELDS = Object.freeze([
 ]);
 
 /**
- * A map note — one type whose `battlemap` / `localmap` / `regionalmap`
- * subType decides the derived canvas. Compiled into a
- * Foundry Scene.
+ * A `map` note — an exported Foundry Scene under `data.scene`.
  *
- * The three differ only in derived canvas defaults, which is the map compiler's
- * business; their authored vocabulary is the same, so they share one
- * declaration rather than three copies that could drift.
- *
- * `data.bgImage` is the one required piece of art — the compiler refuses a map
- * note without it, since a scene with no background is not a map. It is
- * declared in the note vocabulary rather than here, because it is an art slot
- * like every other and a Scene has no `img` for the shared key to reach.
+ * Empty on purpose: everything a map note says is a `data:` field, and the
+ * Scene's walls, lights, sounds, regions and pins are the exported Scene's own.
+ * Declaring the type with no fields is what makes every `sohl:` key on a map
+ * note a finding rather than a note of an unknown type.
  *
  * @type {readonly import("../engine/field-spec.mjs").FieldSpec[]}
  */
-const MAP_FIELDS = Object.freeze([
-    {
-        name: "dimensions",
-        ...LIST,
-        required: true,
-        describe: "`[width, height]` in whole pixels — the map art's own size.",
-    },
-    {
-        name: "pxPerGrid",
-        ...NUMBER,
-        required: true,
-        describe:
-            "Whole pixels per grid square. Must match the art, so the compiler refuses a map note without it.",
-    },
-    {
-        name: "navName",
-        ...STRING,
-        describe: "The scene's short name in Foundry's navigation bar.",
-    },
-    {
-        name: "levelName",
-        ...STRING,
-        describe: "Name of the ground level.",
-    },
-    {
-        name: "backgroundColor",
-        ...STRING,
-        describe: "Colour shown beyond the background image.",
-    },
-    {
-        name: "overlay",
-        ...STRING,
-        describe: "Foreground image drawn over the scene.",
-    },
-    { name: "walls", ...MAP, describe: "Wall segments, by key." },
-    { name: "doors", ...MAP, describe: "Doors, by key." },
-    { name: "lights", ...MAP, describe: "Light sources, by key." },
-    { name: "tiles", ...MAP, describe: "Tiles, by key." },
-    { name: "sounds", ...MAP, describe: "Ambient sounds, by key." },
-    {
-        name: "locations",
-        ...MAP,
-        describe: "Map notes pinned to the scene, by key.",
-    },
-    {
-        name: "regions",
-        ...MAP,
-        describe: "Regions and their behaviours, by key.",
-    },
-    {
-        name: "place",
-        ...AS_AUTHORED,
-        describe: "The place this map depicts.",
-    },
-    {
-        name: "placeName",
-        ...STRING,
-        describe: "Display name of the place this map depicts.",
-    },
-]);
+const MAP_FIELDS = Object.freeze([]);
 
 /**
  * Authored, but not compiled — vocabulary the *presentation* surfaces read.

package/types/engine/address-values.d.mts

@@ -1,3 +1,42 @@
+/**
+ * Whether a parsed JSON value is an Address in its published form.
+ *
+ * @param {unknown} value - A value read from a published index.
+ * @returns {boolean} Whether it is a map of exactly `address`, `anchor` and
+ *   `anchorKind`, with `address` a string.
+ */
+export function isPublishedAddress(value: unknown): boolean;
+/**
+ * Write typed properties in the published index's form.
+ *
+ * Every Address becomes `{ address, anchor, anchorKind }`: `address` the full
+ * canonical Address, `anchor` the anchor's slug or `null`, `anchorKind` its
+ * kind or `null`. An Address-keyed map keeps string keys — JSON has no other —
+ * and a key takes no anchor, so nothing is lost.
+ *
+ * @param {any} value - A tuple-bearing tree.
+ * @param {WeakMap<object, object>} [seen] - Shared containers in this output.
+ * @returns {any} A serializable tree.
+ */
+export function publishAddresses(value: any, seen?: WeakMap<object, object>): any;
+/**
+ * Read a published index record back into typed properties: every published
+ * Address becomes a tuple, or an {@link AddressLink} where it carries an anchor.
+ *
+ * @param {any} value - A parsed record.
+ * @returns {any} The same tree, typed.
+ * @throws {Error} When a published Address is not a complete canonical one.
+ */
+export function readPublishedAddresses(value: any): any;
+/**
+ * Write every published Address in a parsed record as a plain string — the
+ * canonical Address, with `#<anchor>` where it carries one. What the SQL tables
+ * present, so a fence compares an Address as the text an author writes.
+ *
+ * @param {any} value - A parsed record.
+ * @returns {any} The same tree with each Address a string.
+ */
+export function flattenPublishedAddresses(value: any): any;
 /**
  * Render typed properties at a generated-output boundary.
  * @param {any} value - A tuple-bearing tree.
@@ -25,10 +64,18 @@ export class AddressEntries {
         sourceKey: string;
     }[];
 }
-/** An Address and the section within its document. */
+/** An Address and an anchor within its note, with the anchor's kind where it is known. */
 export class AddressLink {
-    /** @param {object} target - Complete tuple. @param {string} anchor - Section slug. */
-    constructor(target: object, anchor: string);
+    /**
+     * @param {object} target - Complete tuple.
+     * @param {string} anchor - The anchor's slug.
+     * @param {"prose"|"event"|null} [kind] - The anchor's kind, or `null` where the
+     *   position that holds the link does not fix one.
+     */
+    constructor(target: object, anchor: string, kind?: "prose" | "event" | null);
     target: object;
     anchor: string;
+    kind: "event" | "prose" | null;
 }
+/** The keys of an Address as the published index writes it, and no others. */
+export const PUBLISHED_ADDRESS_KEYS: readonly string[];

package/types/engine/address.d.mts

@@ -106,6 +106,27 @@ export function parseAddress(written: unknown, defaults?: AddressDefaults, { dec
     declared?: boolean;
     legacyShortcodeCase?: boolean;
 }): AddressTuple | AddressProblem;
+/**
+ * Split a written value at its anchor.
+ *
+ * The anchor is everything after the first `#`, and the Address everything
+ * before it; both are trimmed. A value with no `#` has no `anchor` key at
+ * all, which is how a caller tells "no anchor" from `place-x#`, an empty one.
+ *
+ * @param {string} written - The value as authored, any Wikilink label removed.
+ * @returns {{address: string, anchor?: string}} The two parts.
+ */
+export function splitAnchor(written: string): {
+    address: string;
+    anchor?: string;
+};
+/**
+ * Whether a written value carries an anchor.
+ *
+ * @param {unknown} written - The value as authored.
+ * @returns {boolean} Whether it is a string holding a `#`.
+ */
+export function hasAnchor(written: unknown): boolean;
 /**
  * Whether a value is an internally parsed Address.
  * @param {unknown} value - A property value.

package/types/engine/anchors.d.mts

@@ -12,14 +12,15 @@
  *   picture's address to the role its asset declares, so a figure anchor's
  *   `name` reads `Map 1` rather than `Figure 1` where it is due — see
  *   {@link module:engine/content-figures.scanFigures}.
- * @returns {Array<{slug: string, name: string, level: number, line: number}>}
- *   In document order.
+ * @returns {Array<{slug: string, name: string, level: number, line: number,
+ *   kind: string}>} In document order.
  */
 export function collectAnchors(body: string, bodyLine?: number, resolveRole?: (address: string) => string | undefined): Array<{
     slug: string;
     name: string;
     level: number;
     line: number;
+    kind: string;
 }>;
 /** Collisions involving a div, verse or inline-span anchor.
  * Heading and caption collisions are diagnosed by their existing scanners.
@@ -31,3 +32,49 @@ export function markupAnchorFindings(body: string): Array<{
     column: number;
     message: string;
 }>;
+/**
+ * The anchors a note's events declare: one per `data.events` entry carrying
+ * an `id`, at the line its `id` is written on.
+ *
+ * The `id` is taken as written — {@link module:engine/note-events} holds it to
+ * the address-segment charset — and named by the note's own name for the event
+ * when one is given, else by its summary.
+ *
+ * @param {object} fm - The note's frontmatter.
+ * @param {string} [raw] - The note's full text, for the line; without it the
+ *   line is omitted rather than guessed.
+ * @returns {Array<{slug: string, name: string, level: number, line?: number,
+ *   kind: "event"}>} In entry order.
+ */
+export function eventAnchors(fm: object, raw?: string): Array<{
+    slug: string;
+    name: string;
+    level: number;
+    line?: number;
+    kind: "event";
+}>;
+/**
+ * Event `id`s that repeat one of the note's body anchors.
+ *
+ * A note's anchors are one namespace, so `place-ironfells#sack` names one
+ * thing whether `sack` is a heading or an event. Two body anchors that collide
+ * are reported by the scanners that read them, and two events sharing an `id`
+ * by the event check; this reports the remaining case, an event against a body
+ * anchor, at the event's `id`.
+ *
+ * @param {{file: string, fm: object, raw?: string, body?: string}} note - The
+ *   note, as the link index hands it over.
+ * @returns {object[]} Findings, each at the colliding `id`.
+ */
+export function noteAnchorFindings(note: {
+    file: string;
+    fm: object;
+    raw?: string;
+    body?: string;
+}): object[];
+/**
+ * What an anchor marks. `prose` is every anchor the body declares — a heading,
+ * a caption, a block, an alert, a poem or a span — and `event` is the `id` of
+ * an entry in `data.events`.
+ */
+export const ANCHOR_KINDS: readonly string[];

package/types/engine/art-slots.d.mts

@@ -1,5 +1,5 @@
 /**
- * The four art slots, in the order the specification tabulates them.
+ * The art slots, in the order the specification tabulates them.
  *
  * `banner` is the one that reaches no compiled document: it is the page's hero
  * image, read by the site and by nothing else. The book's section plates read a