@heroiclands/package-build 21.0.0 → 21.2.0

package/engine/site-build.mjs

@@ -55,7 +55,6 @@ import { protectCode } from "./code-fences.mjs";
 import { expandContentTables } from "./content-tables.mjs";
 import { renderImageFigures } from "./content-images.mjs";
 import { pathnameProblem, resolvePathname } from "./pathnames.mjs";
-import { ART_FIELDS } from "./frontmatter-lint.mjs";
 import { buildSiteIndex, resolveInfoboxRef, wikiContext } from "./site-index.mjs";
 import { frontmatterWikilinks, resolveWebWikilinks } from "./web-wikilinks.mjs";
 import { loadForeignIndexes } from "./metadata-index.mjs";
@@ -63,10 +62,12 @@ import { noteInfoboxes } from "./infobox-registry.mjs";
 import { formatUnaddressableFinding, unaddressableForeignPackages } from "./metadata-index.mjs";
 import { deriveBeingInfo, isBeing } from "../sohl/being-info.mjs";
 import { loadPackConfig } from "./pack-config.mjs";
+import { routerFor } from "./pack-router.mjs";
 import { searchableFrontmatter } from "./note-package.mjs";
 // The corpus, from the one pass that derives it.
 import { indexRecordsFor } from "./content-index.mjs";
 import { isNoteRecord, noteFile } from "./index-records.mjs";
+import { ART_SLOTS, artPathname, assetAddressIndex } from "./art-fields.mjs";
 import {
     checkHomepageCount,
     homepageDestination,
@@ -627,13 +628,16 @@ export function sectionFrontmatter(meta) {
  *   for.
  * @param {(data: object, page: object) => void} [options.decorate] - Called
  *   with each page's frontmatter, for whatever a consumer's own pass adds.
+ * @param {(value: unknown, type: string) => string|null} [options.artSrc] -
+ *   Translates an art address into the pathname the website resolver takes, or
+ *   `null` where nothing answers it.
  * @param {(src: string) => string} [options.webSrc] - Translates an authored
  *   pathname into the address the website serves. Every artwork field goes
  *   through it, so a page's `img:` and its body images name the same file the
  *   same way.
  * @returns {object} The frontmatter to write.
  */
-export function pageFrontmatter(page, { readmeSections = {}, decorate, webSrc }) {
+export function pageFrontmatter(page, { readmeSections = {}, decorate, webSrc, artSrc }) {
     const { fm, name, slug, sec, isReadme } = page;
     let data;
     if (page.kind === "content") {
@@ -665,29 +669,39 @@ export function pageFrontmatter(page, { readmeSections = {}, decorate, webSrc })
         if (meta) Object.assign(data, sectionFrontmatter(meta));
     }
     delete data.aliases;
-    if (webSrc) resolveArtFields(data, webSrc);
+    if (webSrc && artSrc) resolveArtFields(data, webSrc, artSrc);
     return data;
 }
 
 /**
- * Rewrite a page's artwork fields into the addresses the website serves.
+ * Rewrite a page's artwork addresses into the URLs the website serves.
  *
- * The same fields the linter holds to the pathname rule, read from the same
- * list, so a third art field added to the vocabulary reaches the page without
- * anyone remembering this function exists. Only an authored **string** is
- * touched: `null` is a note naming no art and `""` is one naming none on
- * purpose, and neither is a pathname to resolve.
+ * The slots are read from {@link module:engine/art-fields.ART_SLOTS}, so a slot
+ * added to the vocabulary reaches the page without anyone remembering this
+ * function exists. Only an authored **string** is touched: `null` is a note
+ * naming no art and `""` is one naming none on purpose, and neither is an
+ * address to resolve.
+ *
+ * **An address nothing answers is dropped**, not emitted as written. The theme
+ * renders nothing where a value is absent — its silent-disappear convention —
+ * and a raw address left in place would reach the reader as a broken image
+ * source with nothing saying why.
  *
  * @param {object} data - The frontmatter being emitted, rewritten in place.
- * @param {(src: string) => string} webSrc - The website's resolver.
+ * @param {(src: string) => string} webSrc - The website's pathname resolver.
+ * @param {(value: unknown, type: string) => string|null} artSrc - The address
+ *   resolver, yielding the pathname `webSrc` takes.
  * @returns {void}
  */
-function resolveArtFields(data, webSrc) {
-    for (const { key, inData } of ART_FIELDS) {
-        const holder = inData && isPlainObject(data.data) ? data.data : data;
-        const value = holder?.[key];
+function resolveArtFields(data, webSrc, artSrc) {
+    for (const { key, type } of ART_SLOTS) {
+        const holder = isPlainObject(data.data) ? data.data : null;
+        if (!holder) continue;
+        const value = holder[key];
         if (typeof value !== "string" || value === "") continue;
-        holder[key] = webSrc(value);
+        const pathname = artSrc(value, type);
+        if (pathname === null) delete holder[key];
+        else holder[key] = webSrc(pathname);
     }
 }
 
@@ -758,8 +772,17 @@ export function renderPages(pages, options) {
         linkable = (d) => Boolean(d.fm.shortcode),
         sqlTables,
         config,
+        records = [],
     } = options;
 
+    // The address space the art slots and the body's embeds resolve against:
+    // the files this package ships, and the ones a dependency published.
+    const artIndex = assetAddressIndex(records, {
+        config,
+        foreign,
+        types: index?.contentTypes ?? [],
+    });
+
     const tableErrors = [];
     const wikiErrors = [];
     const imageErrors = [];
@@ -817,9 +840,11 @@ export function renderPages(pages, options) {
             type: page.fm.type ?? null,
             errors: wikiErrors,
             foreignIndex: foreign.index,
+            assets: artIndex,
         });
 
         const webSrc = webAddresses(page.file);
+        const artSrc = (value, type) => artPathname(artIndex, value, type).pathname;
         const resolve = (text) => {
             let t = text;
             if (pass.beforeLinks) t = pass.beforeLinks(t, page);
@@ -851,7 +876,7 @@ export function renderPages(pages, options) {
             body = markdown;
         }
 
-        const data = pageFrontmatter(page, { readmeSections, decorate, webSrc });
+        const data = pageFrontmatter(page, { readmeSections, decorate, webSrc, artSrc });
         const dest = path.join(outRoot, pageDestination(page));
         fs.mkdirSync(path.dirname(dest), { recursive: true });
         fs.writeFileSync(dest, matter.stringify(protectCode(body, resolve), data));
@@ -1235,6 +1260,7 @@ export function buildSite({ config, outRoot, sqlTables } = {}) {
         outRoot: out,
         sqlTables,
         config: resolved,
+        records: ctx.records,
         index: gates.index,
         foreign: gates.foreign,
         universe: tableUniverse(pages),
@@ -1254,6 +1280,7 @@ export function buildSite({ config, outRoot, sqlTables } = {}) {
             // book from one definition.
             data.infoboxes = noteInfoboxes(page.fm, {
                 resolve: (ref, hint) => resolveInfoboxRef(gates.index, ref, hint),
+                router: routerFor(resolved),
             });
         },
     });

package/engine/site-index.mjs

@@ -322,6 +322,8 @@ export function buildSiteIndex(entries, { foreignIndex = new Map() } = {}) {
  *   diagnostic names. Absent, `src` stands in.
  * @param {Map<string, object>} [options.foreignIndex] - The foreign index, for
  *   resolvers that distinguish a foreign hit from a local one.
+ * @param {object} [options.assets] - The address space an `![[…]]` embed
+ *   resolves against, shaped as every asset resolver reads one.
  * @returns {object} The resolver context.
  *
  * There is deliberately **no `manifestsComplete`**. It used to let a resolver
@@ -330,10 +332,17 @@ export function buildSiteIndex(entries, { foreignIndex = new Map() } = {}) {
  * checker never had it and one authored link must not get two verdicts. A
  * caller still passing it is ignored rather than obeyed.
  */
-export function wikiContext(built, { src, file, type = null, errors, foreignIndex = new Map() }) {
+export function wikiContext(
+    built,
+    { src, file, type = null, errors, foreignIndex = new Map(), assets },
+) {
     return {
         index: built.index,
         foreign: foreignIndex,
+        // The address space an embed resolves against. Separate from `index`
+        // because the two hold different record shapes: a note's entry carries
+        // a URL and a name, an asset's carries the path to a file.
+        assets,
         collide: built.ambiguous,
         sections: built.sections,
         contentTypes: built.contentTypes,

package/engine/subtype-registry.mjs

@@ -65,6 +65,27 @@ export const KNOWN_DOCUMENT_SUBTYPE_MAPS = Object.freeze([
     HM3_DOCUMENT_SUBTYPES,
 ]);
 
+/**
+ * The map a pack declaring no `system:` compiles its documents against.
+ *
+ * A pack names the system its documents are shaped for, and one declaring none
+ * is compiled by the fallback pass for its document type — a single-system
+ * package's ordinary arrangement, and the one `sohl-thalorna` ships. That pass
+ * follows one map whatever a note carries, which makes this the answer to "a
+ * document compiled here belongs to *which* system?" wherever a pack has not
+ * said.
+ *
+ * Stated here rather than read off the compiler classes because those are not
+ * reachable from a leaf: `engine/item-compiler.mjs` imports the journals pass,
+ * which draws infoboxes, so anything the infobox reads cannot import a pass.
+ * `tests/default-document-subtypes.test.ts` holds this to `compilerFor`, which
+ * is where the fallback is actually decided — so the two cannot drift apart in
+ * silence.
+ *
+ * @type {import("./document-subtypes.mjs").DocumentSubtypeMap}
+ */
+export const DEFAULT_DOCUMENT_SUBTYPES = SOHL_DOCUMENT_SUBTYPES;
+
 /**
  * Every note type any shipped map compiles into an **Actor**.
  *

package/engine/web-wikilinks.mjs

@@ -61,6 +61,7 @@ import { slugify } from "./content-slug.mjs";
 /** KB heading/anchor slug: lowercase, non-alphanumerics to single hyphens. */
 export { slugify };
 import { authoredLabel, WIKILINK, isSamePage, parseWikilink } from "./wikilink-syntax.mjs";
+import { resolveEmbeds } from "./content-embeds.mjs";
 
 /**
  * The index key a **piped** target resolves to, or `null` when it does not
@@ -300,15 +301,25 @@ function isPlainMap(value) {
  * web pages, so the author wrote a real address and there is simply nothing to
  * link to.
  *
+ * ## Embeds first, and they are not links
+ *
+ * `![[address|label]]` names a file rather than a note, so it is resolved into
+ * an ordinary markdown image before anything looks for a link — which is what
+ * stops the link pass reading an embed's interior as a link to a note nobody
+ * wrote. The image the rewrite leaves behind is what
+ * {@link module:engine/content-images.renderImageFigures} turns into a figure
+ * for the website, and what the book reads its staging list out of.
+ *
  * @param {string} body - The markdown body.
- * @param {object} ctx - `{ index, collide, sections, contentTypes, packages,
- *   foreign, type, errors, src, file }`.
+ * @param {object} ctx - `{ index, assets, collide, sections, contentTypes,
+ *   packages, foreign, type, errors, src, file }`.
  *   `packages` is every package an address may name, without which the leading
  *   package segment of a canonical address reads as an unknown type; `foreign`
- *   is the cross-package manifest index. `src` is the page's display
+ *   is the cross-package manifest index; `assets` is the address space an embed
+ *   resolves against. `src` is the page's display
  *   path and `file` the source file a diagnostic should name — absent, `src`
  *   stands in.
- * @returns {string} The body with wikilinks rewritten.
+ * @returns {string} The body with embeds and wikilinks rewritten.
  */
 export function resolveWebWikilinks(body, ctx) {
     // How many times each authored link has been seen, so two identical links
@@ -317,15 +328,13 @@ export function resolveWebWikilinks(body, ctx) {
     // `file:line:column:` diagnostic rather than a note-wide one.
     const seen = new Map();
     /**
-     * Records a finding, and returns the marked-up link it renders as.
+     * Records a finding against one authored literal.
      *
-     * @param {string} all - The authored link, brackets and all.
-     * @param {object} finding - `{ target, reason }`, plus any extras the class
-     *   carries.
-     * @param {string} text - What the link renders as.
-     * @returns {string} The marked span.
+     * @param {string} all - The literal, exactly as authored.
+     * @param {object} finding - The finding's own fields.
+     * @returns {void}
      */
-    const report = (all, finding, text) => {
+    const record = (all, finding) => {
         const occurrence = (seen.get(all) ?? 0) + 1;
         seen.set(all, occurrence);
         ctx.errors.push({
@@ -337,12 +346,37 @@ export function resolveWebWikilinks(body, ctx) {
             occurrence,
             ...finding,
         });
+    };
+
+    /**
+     * Records a finding, and returns the marked-up link it renders as.
+     *
+     * @param {string} all - The authored link, brackets and all.
+     * @param {object} finding - `{ target, reason }`, plus any extras the class
+     *   carries.
+     * @param {string} text - What the link renders as.
+     * @returns {string} The marked span.
+     */
+    const report = (all, finding, text) => {
+        record(all, finding);
         return unresolvedLink(text, finding.target);
     };
 
+    // An embed names a file, so it resolves before anything looks for a link.
+    // Its findings are recorded rather than rendered: the rewrite already
+    // leaves an embed it cannot resolve exactly as authored, which is the
+    // visible degradation an unresolved link gets from `unresolvedLink`.
+    const embedded = resolveEmbeds(body, { index: ctx.assets });
+    for (const u of embedded.unresolved) {
+        record(u.link, { target: u.target, reason: u.reason, ...(u.type ? { type: u.type } : {}) });
+    }
+    for (const problem of embedded.problems) {
+        record(problem.link, { target: problem.link, message: problem.message });
+    }
+
     // Code is verbatim: a `[[…]]` inside a code fence, an indented block or an
     // inline span is source text, not a link.
-    return replaceOutsideCode(body, WIKILINK, (all, rawInner) => {
+    return replaceOutsideCode(embedded.markdown, WIKILINK, (all, rawInner) => {
         const parsed = parseWikilink(rawInner);
         const { target, anchor, display } = parsed;
         // An empty label is not a label: `[[x|]]` addresses the target and

package/engine/wikilink-syntax.mjs

@@ -57,8 +57,15 @@
  * unclosed `[[` is a typo, and the alternative is letting it swallow arbitrary
  * prose in search of a closer. Erring towards "not a link" leaves the author's
  * text as written, which is the safe direction for a rewriter.
+ *
+ * **A leading `!` makes it an embed, not a link**, and the lookbehind is what
+ * keeps every reader from seeing one as the other. Stated here rather than in
+ * each reader for the reason the rest of this module exists: the checker, the
+ * pack compilers and the web resolver all match on this pattern, and three
+ * 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]+)\]\]/g;
 
 /**
  * The parts of a wikilink's interior.
@@ -171,7 +178,9 @@ export function unlabelledLinkMessage(target) {
  *
  * - `unlabelled` — no `|`, so the link addresses nothing.
  * - `not-an-address` — labelled, but the target does not parse as an address.
+ * - `not-lowercase` — a package, system or type segment carries a capital.
  * - `unknown-type` — definitely qualified, but names no type this build knows.
+ * - `not-an-asset` — a real address, embedded where only a file can be drawn.
  * - `unresolved` — parses as an address, and nothing publishes it.
  * - `ambiguous` — more than one package publishes the short address.
  * - `unknown-anchor` — the address resolved, the `#section` it names did not.
@@ -184,6 +193,7 @@ export const LINK_FINDING_REASONS = Object.freeze(
         "not-an-address",
         "not-lowercase",
         "unknown-type",
+        "not-an-asset",
         "unresolved",
         "ambiguous",
         "unknown-anchor",
@@ -262,11 +272,13 @@ export function ambiguousAddressMessage(target, packages = []) {
  * @param {Iterable<string>} [finding.packages] - For `ambiguous`, the
  *   claimants.
  * @param {string} [finding.anchor] - For `unknown-anchor`, the section named.
+ * @param {string} [finding.type] - For `not-an-asset`, the type the address
+ *   named.
  * @returns {string} The message.
  * @throws {Error} On a reason outside the closed set — a resolver inventing one
  *   would otherwise report a link with no explanation at all.
  */
-export function linkFindingMessage({ reason, target, packages, anchor }) {
+export function linkFindingMessage({ reason, target, packages, anchor, type }) {
     switch (reason) {
         case "unlabelled":
             return unlabelledLinkMessage(target);
@@ -285,6 +297,12 @@ export function linkFindingMessage({ reason, target, packages, anchor }) {
             );
         case "unknown-type":
             return `address [[${target}]] names no known content type`;
+        case "not-an-asset":
+            return (
+                `![[${target}]] embeds a \`${type ?? "note"}\`, and an embed draws a ` +
+                `file — only an \`icon\`, an \`image\` or an \`audio\` address can be ` +
+                `embedded. Write [[${target}|Text]] to link to it instead`
+            );
         case "ambiguous":
             return ambiguousAddressMessage(target, packages ?? []);
         case "unknown-anchor":

package/engine/wikilinks.mjs

@@ -86,6 +86,7 @@ import crypto from "crypto";
 
 import { compendiumUuid, ITEM_PACK, packForType, pageUuid, PACK_BY_TYPE } from "./ids.mjs";
 import { readCanonicalKey } from "./content-address.mjs";
+import { ASSET_TYPE_NAMES } from "./asset-types.mjs";
 import { isSystemSegment, NO_SYSTEM } from "./systems.mjs";
 import { systemOf } from "./document-subtypes.mjs";
 import { KNOWN_DOCUMENT_SUBTYPE_MAPS } from "./subtype-registry.mjs";
@@ -354,11 +355,15 @@ export function anchorPageId(noteId, anchorSlug) {
  *   vendored manifests of packages this build links into but does not publish.
  * @param {string} [contentPackage] - This build's *content* package, which an
  *   authored address may name explicitly. Defaults to `packageId`.
+ * @param {object} [opts] - Options.
+ * @param {Map<string, object>} [opts.assets] - The files this package ships, by
+ *   canonical address. They resolve no link — an asset is not a document — and
+ *   answer only the art fields, which name a file and never a document.
  * @returns {{byShortcode: Map<string, object>, types: Set<string>}} `types` is
  *   every type the tree actually contains, so a qualifier naming no real type
  *   can be told apart from a missing target.
  */
-export function buildWikilinkIndex(docs, packageId, foreign, contentPackage) {
+export function buildWikilinkIndex(docs, packageId, foreign, contentPackage, { assets } = {}) {
     if (!packageId) {
         throw new Error(
             "buildWikilinkIndex: packageId is required — it is the first " +
@@ -368,7 +373,11 @@ export function buildWikilinkIndex(docs, packageId, foreign, contentPackage) {
     }
 
     const byShortcode = new Map();
-    const types = new Set();
+    // The **asset** types join unconditionally, whether or not this tree holds
+    // a file of each: they are a closed vocabulary rather than a census of what
+    // was found, and an art field hands the resolver `icon-<shortcode>` whose
+    // type has to parse before anything can be looked up.
+    const types = new Set(ASSET_TYPE_NAMES);
 
     // Each note's address is computed once, here, and every reference to it is
     // that stored value. Nothing downstream assembles a UUID from parts, so a
@@ -439,8 +448,12 @@ export function buildWikilinkIndex(docs, packageId, foreign, contentPackage) {
         types,
         uuidByDoc,
         packageId,
+        /** The content package this build publishes, which an art address defaults to. */
+        contentPackage: contentPackage ?? packageId,
         packages,
         foreign: foreignByKey,
+        /** The files this package ships, by canonical address. */
+        assets: assets ?? new Map(),
     };
 }
 

package/hm3/actors.mjs

@@ -49,8 +49,8 @@
  * @module
  */
 
-import { resolveName, resolveImg } from "../engine/helpers.mjs";
-import { buildFromFields, readField, retiredTopLevelKey, STRING } from "../engine/field-spec.mjs";
+import { resolveName } from "../engine/helpers.mjs";
+import { buildFromFields, retiredTopLevelKey, STRING } from "../engine/field-spec.mjs";
 import { SystemActorCompiler } from "../engine/actor-compiler.mjs";
 import { renderSection } from "../engine/anchored-sections.mjs";
 import { documentSubtype } from "../engine/document-subtypes.mjs";
@@ -99,33 +99,6 @@ const ACTOR_FIELDS = Object.freeze([
     },
 ]);
 
-/**
- * The actor's bio image — the fourth row of the specification's `being` table,
- * and the last one that was still read by hand.
- *
- * Declared for the reason {@link ACTOR_FIELDS} is, and fixed for the reason
- * `data.species` was: read with `blockProperty(fm, block, "portrait")` it saw
- * the block and the note's top level and nothing else, so the `data.portrait`
- * the specification names never reached the document and the `?? defaultImg`
- * beside it dressed the miss up as "this note names no art".
- *
- * It is **not** in `ACTOR_FIELDS`, because `buildFromFields` has no seam for
- * the subtype default that has to follow it — the `?? defaultImg` is the whole
- * of what distinguishes an unnamed portrait from a deliberately blank one,
- * and it needs a subtype the coercion is not handed.
- *
- * @type {import("../engine/field-spec.mjs").FieldSpec}
- */
-const BIO_IMAGE_FIELD = Object.freeze({
-    name: "data.portrait",
-    legacyKey: "portrait",
-    to: "bioImage",
-    shape: "path",
-    read: (raw) => resolveImg(raw),
-    default: null,
-    describe: "Path to the portrait image.",
-});
-
 /**
  * The two `data:` facts HM3 declares on a `character` and not on a `creature`.
  *
@@ -285,7 +258,10 @@ export class Hm3Actors extends SystemActorCompiler {
                 absPath: this.currentNote?.absPath,
             })
         );
-        const defaultImg = defaultActorImg(subType);
+        // The being's own default sits above the subtype's: only the note's
+        // tags say whether it is a person or a creature, and only this pass
+        // reads them.
+        const art = this.actorArt(fm, defaultActorImg(subType));
 
         const items = this.buildEmbeddedItems(itemsMap, id, fm, ctx);
 
@@ -326,11 +302,9 @@ export class Hm3Actors extends SystemActorCompiler {
         });
 
         const system = {
-            // Nullish, not `||`: a note that names no portrait gets the
-            // subtype's default, one that writes `""` ships blank on purpose.
-            // Resolved through the declaration so `data.portrait` is reached at
-            // all — see {@link BIO_IMAGE_FIELD}.
-            bioImage: readField(BIO_IMAGE_FIELD, fm, reports) ?? defaultImg,
+            // `system.bioImage` is **not** written here, for the reason SoHL's
+            // `system.portrait` is not: a being's portrait is the lead image of
+            // its `{#appearance}` section, which is the markup below.
             description: renderSection(body || "", "appearance"),
             biography: renderSection(body || "", "dossier"),
             ...buildFromFields(ACTOR_FIELDS, reports)(fm),
@@ -356,12 +330,11 @@ export class Hm3Actors extends SystemActorCompiler {
         });
 
         const effects = blockProperty(fm, block, "effects");
-        const img = resolveImg(blockProperty(fm, block, "img")) ?? defaultImg;
 
         return {
             name,
             type: subType,
-            img,
+            img: art.img,
             _id: id,
             system,
             items,
@@ -369,7 +342,7 @@ export class Hm3Actors extends SystemActorCompiler {
                 name,
                 displayName: 0,
                 actorLink: false,
-                texture: { src: img },
+                texture: { src: art.token },
                 width: 1,
                 height: 1,
                 sight: { enabled: false },

package/hm3/infobox.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "21.0.0",
+    "version": "21.2.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",
@@ -102,6 +102,8 @@
         "CHANGELOG.md",
         "CONTENT.md",
         "README.md",
+        "assets",
+        "packagebuild-metadata.jsonl",
         "bin",
         "bundle.mjs",
         "ci",
@@ -160,8 +162,9 @@
     "scripts": {
         "test": "vitest run",
         "test:watch": "vitest",
-        "prepack": "npm run build:types",
+        "prepack": "run-s build:types build:asset-index",
         "build:types": "tsc -p tsconfig.dts.json",
+        "build:asset-index": "node ci/emit-asset-index.mjs",
         "format": "prettier --write .",
         "format:check": "prettier --check .",
         "lint": "run-p --aggregate-output -c --max-parallel 4 format:check lint:markdown lint:yaml lint:labels lint:content-format",

package/packagebuild-metadata.jsonl

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