@heroiclands/package-build 23.0.0 → 23.1.1

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/engine/yaml-lint.mjs

@@ -104,10 +104,11 @@ export const frontmatterProcessor = {
  * - `no-empty-key`, `no-empty-document` — a fence or a file that parses to
  *   nothing at all.
  *
- * **GitHub workflows are exempt from `no-empty-mapping-value`**, because an
- * empty value is the language there: `on:` `push:` and `workflow_dispatch:`
- * carry their meaning by being present, and writing `push: null` to satisfy a
- * linter would be worse YAML, not better.
+ * **Workflows are exempt from `no-empty-mapping-value`**, under
+ * `.github/workflows/` and Gitea's `.gitea/workflows/` alike, because an empty
+ * value is the language there: `on:` `push:` and `workflow_dispatch:` carry
+ * their meaning by being present, and writing `push: null` to satisfy a linter
+ * would be worse YAML, not better.
  *
  * @param {object} plugin - The `eslint-plugin-yml` module.
  * @returns {object[]} A complete flat config, for `overrideConfig`.
@@ -128,6 +129,8 @@ export function yamlLintConfig(plugin) {
             files: [
                 "**/.github/workflows/*.yml",
                 "**/.github/workflows/*.yaml",
+                "**/.gitea/workflows/*.yml",
+                "**/.gitea/workflows/*.yaml",
                 "**/action.yml",
                 "**/action.yaml",
             ],

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.1",
     "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/release.mjs

@@ -45,6 +45,60 @@ import { ZipArchive } from "archiver";
 
 import { SCHEMA_ARTIFACT_FILE } from "./engine/foreign-catalog.mjs";
 
+/** The earliest instant a zip entry's date field can hold. */
+const ZIP_EPOCH_MS = Date.UTC(1980, 0, 1);
+
+/**
+ * The timestamp stamped on every archive entry: `SOURCE_DATE_EPOCH` (seconds)
+ * when set to a number, otherwise 1980-01-01T00:00:00Z. A value earlier than
+ * 1980 is raised to it, which is as early as a zip can record.
+ *
+ * @returns {Date}
+ */
+function archiveDate() {
+    const seconds = Number(process.env.SOURCE_DATE_EPOCH);
+    const ms =
+        process.env.SOURCE_DATE_EPOCH && Number.isFinite(seconds) ? seconds * 1000 : ZIP_EPOCH_MS;
+    return new Date(Math.max(ms, ZIP_EPOCH_MS));
+}
+
+/**
+ * Append a directory tree to an archive in path order, with a fixed date and
+ * fixed permissions (0755 directories, 0644 files) so the bytes depend only on
+ * the tree's names and contents.
+ *
+ * Entries are appended one at a time from buffers: archiver's own directory
+ * walk stats files concurrently, so its entry order and recorded mtimes follow
+ * the filesystem.
+ *
+ * @param {import("archiver").ZipArchive} archive
+ * @param {string} root - The directory whose contents become the archive.
+ * @param {Date} date - The date recorded on every entry.
+ * @returns {Promise<void>}
+ */
+async function appendTree(archive, root, date) {
+    /** @param {string} rel - Path relative to `root`, `/`-separated, or "". */
+    async function walk(rel) {
+        const entries = await fsp.readdir(path.join(root, rel), { withFileTypes: true });
+        entries.sort((a, b) =>
+            a.name < b.name ? -1
+            : a.name > b.name ? 1
+            : 0,
+        );
+        for (const entry of entries) {
+            const name = rel ? `${rel}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                archive.append(Buffer.alloc(0), { name: `${name}/`, date, mode: 0o755 });
+                await walk(name);
+            } else {
+                const body = await fsp.readFile(path.join(root, name));
+                archive.append(body, { name, date, mode: 0o644 });
+            }
+        }
+    }
+    await walk("");
+}
+
 /**
  * Zip the staged tree and place the manifest beside the archive.
  *
@@ -55,6 +109,10 @@ import { SCHEMA_ARTIFACT_FILE } from "./engine/foreign-catalog.mjs";
  * failure is timing-dependent, so it survives every run that happens to be
  * fast enough, which is what makes it worth being explicit about.
  *
+ * **The archive is reproducible.** Entries are written in path order with one
+ * date (`SOURCE_DATE_EPOCH` when set, otherwise 1980-01-01) and fixed
+ * permissions, so a rebuild of one staged tree is byte-identical.
+ *
  * @param {object} [opts]
  * @param {string} [opts.stageDir] - The staged package tree.
  * @param {string} [opts.outDir] - Where the release assets are written.
@@ -114,10 +172,10 @@ export async function packRelease({
     });
 
     archive.pipe(output);
-    // `false` — no top-level directory inside the zip. Foundry unpacks the
-    // archive *into* the package directory, so an extra level would nest the
-    // manifest one deeper than it looks for it.
-    archive.directory(stage, false);
+    // No top-level directory inside the zip: Foundry unpacks the archive
+    // *into* the package directory, so an extra level would nest the manifest
+    // one deeper than it looks for it.
+    await appendTree(archive, stage, archiveDate());
     await archive.finalize();
     await closed;
 

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[];