@heroiclands/package-build 22.15.0 → 22.16.0

package/types/engine/helpers.d.mts

@@ -1,5 +1,5 @@
 /** Render a note body with Foundry's secret section markup. */
-export function renderFoundryMarkdown(body: any): string;
+export function renderFoundryMarkdown(body: any, captions: any, footnoteNumbers: any, docId: any): string;
 /**
  * Parses a markdown file with YAML frontmatter.
  *
@@ -11,19 +11,19 @@ export function renderFoundryMarkdown(body: any): string;
  * {@link positionInBody}. If the file has no frontmatter block, returns
  * `{ frontmatter: null, body: "", description: "" }` with a warn log, and no
  * position: there is no body to have one.
+ * @param {string} filePath - Markdown file to read.
+ * @param {{addressContext?: object}} [opts] - Address defaults for decoded fields.
+ * @returns {{frontmatter: object|null, body: string, description: string,
+ *   bodyLine?: number, bodyColumn?: number}} Parsed note and body position.
  */
-export function parseMarkdownFile(filePath: any, { addressContext }?: {}): {
-    frontmatter: null;
-    body: string;
-    description: string;
-    bodyLine?: undefined;
-    bodyColumn?: undefined;
-} | {
-    frontmatter: any;
+export function parseMarkdownFile(filePath: string, { addressContext }?: {
+    addressContext?: object;
+}): {
+    frontmatter: object | null;
     body: string;
     description: string;
-    bodyLine: number;
-    bodyColumn: number;
+    bodyLine?: number;
+    bodyColumn?: number;
 };
 /**
  * Refuse a corpus read whose scope its caller did not state.
@@ -80,6 +80,7 @@ export function assertSuppliedCorpus(records: readonly object[] | undefined, who
  * @param {readonly string[]} opts.skipDirectories - Directory names to ignore.
  *   Required: the scope is the caller's to state, so two passes cannot
  *   disagree about which files are the corpus.
+ * @param {object} [opts.addressContext] - Address resolution context.
  * @yields {{frontmatter: object|null, body: string, description: string,
  *   file: string, absPath: string, bodyLine?: number, bodyColumn?: number}}
  *   One entry per `.md` file found.
@@ -88,22 +89,15 @@ export function assertSuppliedCorpus(records: readonly object[] | undefined, who
  */
 export function walkMarkdownTree(rootDir: string, { skipDirectories, addressContext }?: {
     skipDirectories: readonly string[];
+    addressContext?: object | undefined;
 }): Generator<{
     file: string & NonSharedBuffer;
     absPath: string;
-    frontmatter: null;
+    frontmatter: object | null;
     body: string;
     description: string;
-    bodyLine?: undefined;
-    bodyColumn?: undefined;
-} | {
-    file: string & NonSharedBuffer;
-    absPath: string;
-    frontmatter: any;
-    body: string;
-    description: string;
-    bodyLine: number;
-    bodyColumn: number;
+    bodyLine?: number;
+    bodyColumn?: number;
 }, void, unknown>;
 /**
  * The template priority a note states, for a system that treats an unstated one
@@ -176,8 +170,11 @@ export function systemTemplatePriority(fm: object, label: string): number | null
 /**
  * Generates a compendium-source filename: `Name_id.json` with non-
  * alphanumeric runs replaced by underscores.
+ * @param {string} name - Document name.
+ * @param {string} id - Document id.
+ * @returns {string} Filename for the document.
  */
-export function makeFilename(name: any, id: any): string;
+export function makeFilename(name: string, id: string): string;
 /**
  * Translate an authored pathname into the address a Foundry install serves.
  *
@@ -228,8 +225,11 @@ export function resolveImg(raw: string | null | undefined, config?: {
 /**
  * Resolves the display name from frontmatter, preferring `name.full`,
  * falling back to `name` (if string), then `defaultValue`.
+ * @param {object|null|undefined} fm - Parsed frontmatter.
+ * @param {string} [defaultValue] - Name when the note provides none.
+ * @returns {string} Display name.
  */
-export function resolveName(fm: any, defaultValue?: string): any;
+export function resolveName(fm: object | null | undefined, defaultValue?: string): string;
 /**
  * The oldest Foundry core this package supports, stamped into every compiled
  * document as `_stats.coreVersion`.
@@ -345,21 +345,15 @@ export function defaultStats(): object;
  *   the index and the compile agree about where each note landed; defaults to
  *   this repository's own.
  * @param {object} [opts]
- * @param {readonly string[]} [opts.skipDirectories] - Part of the options bag
- *   every corpus reader takes; the scope is already settled by `records`.
  * @param {object} [opts.config] - The resolved build configuration; loaded when
  *   omitted.
  * @param {readonly object[]} [opts.records] - The corpus, derived once per
  *   compile and handed in. Required: see {@link assertSuppliedCorpus}.
- * @param {object[]} [opts.problems] - Part of the same options bag; the notes
- *   the index cannot record are collected where the corpus is derived.
  * @returns {{byShortcode: Map, types: Set}} From `buildWikilinkIndex`.
  */
-export function buildContentLinkIndex(contentBase: string, router?: object, { skipDirectories, config, records, problems }?: {
-    skipDirectories?: readonly string[] | undefined;
+export function buildContentLinkIndex(contentBase: string, router?: object, { config, records }?: {
     config?: object | undefined;
     records?: readonly object[] | undefined;
-    problems?: object[] | undefined;
 }): {
     byShortcode: Map<any, any>;
     types: Set<any>;
@@ -421,68 +415,16 @@ export function convertNoteWikilinks(body: string, { type, id, pack, docPack, in
     unresolved: Array<object>;
 };
 /**
- * Every note in the content tree, in the shape the `dataview` table expander
- * searches: its frontmatter plus where it sits in the tree. Ordered by path so
- * a table that leaves rows tied still emits identically on every build.
- *
- * @param {string} contentBase - Root of the content tree.
- * @param {object} [opts]
- * @param {readonly string[]} [opts.skipDirectories] - Part of the options bag
- *   every corpus reader takes; the scope is already settled by `records`.
- * @param {object} [opts.config] - The resolved build configuration; loaded when
- *   omitted.
- * @param {readonly object[]} [opts.records] - The corpus, derived once per
- *   compile and handed in. Required: see {@link assertSuppliedCorpus}.
- * @param {object[]} [opts.problems] - Part of the same options bag; the notes
- *   the walk cannot read are collected where the corpus is derived.
- * @returns {Array<{fm: object, path: string, tld: string, folder: string,
- *   absPath: string}>}
- */
-export function collectContentDocs(contentBase: string, { skipDirectories, config, records, problems }?: {
-    skipDirectories?: readonly string[] | undefined;
-    config?: object | undefined;
-    records?: readonly object[] | undefined;
-    problems?: object[] | undefined;
-}): Array<{
-    fm: object;
-    path: string;
-    tld: string;
-    folder: string;
-    absPath: string;
-}>;
-/**
- * Expand the fenced `dataview` tables in one note's markdown, before wikilinks
- * are resolved — so a generated cell may itself be a wikilink.
- *
- * A table searches the whole tree, which is one package's notes and nothing
- * else — so there is no longer a package to scope on. It used to filter, back
- * when a tree could hold several packages' notes and `package:` said which was
- * which; that field is retired and the filter with it.
- *
- * @param {string} body - The note's markdown body.
- * @param {object} ctx
- * @param {Array<object>} ctx.docs - From {@link collectContentDocs}.
- * @param {string} ctx.name - The note, for the error message.
- * @param {object} [ctx.fm] - The source note's frontmatter, which is what a
- *   query's `this` reads. Its entry in `docs` supplies the path as well.
- * @param {number} [ctx.bodyLine] - 1-based file line of the body's first line,
- *   so a failing directive can be reported at its position in the file.
- * @param {object[]} [ctx.sqlTables] - This note's prepared `sql` results, in
- *   document order, from
- *   {@link module:engine/sql-tables.prepareSqlTables}. An `sql` directive with
- *   no prepared result fails the note: nothing here runs a query.
- * @returns {{markdown: string, lineMap: Array<{line: number,
- *   generated: boolean}>}} The body with every table expanded, and where each
- *   emitted line came from — which is what lets a diagnostic about the
- *   expanded body name an authored position.
- * @throws {Error} When a query is malformed or unsupported — the note fails to
- *   compile rather than shipping a table-shaped hole. The error carries
- *   `position`, the directive's own line.
+ * Expand prepared SQL tables before resolving wikilinks in generated cells.
+ * @param {string} body - The note body.
+ * @param {object} ctx - Source and prepared query results.
+ * @param {string} ctx.name - Name used in diagnostics.
+ * @param {number} [ctx.bodyLine] - The first body line in the source file.
+ * @param {object[]} [ctx.sqlTables] - Prepared SQL results in document order.
+ * @returns {{markdown: string, lineMap: Array<{line: number, generated: boolean}>}}
  */
-export function expandNoteTables(body: string, { docs, name, fm, bodyLine, sqlTables }: {
-    docs: Array<object>;
+export function expandNoteTables(body: string, { name, bodyLine, sqlTables }: {
     name: string;
-    fm?: object | undefined;
     bodyLine?: number | undefined;
     sqlTables?: object[] | undefined;
 }): {
@@ -496,8 +438,11 @@ export function expandNoteTables(body: string, { docs, name, fm, bodyLine, sqlTa
  * Builds a compendium-source filename for a folder JSON document:
  * `folder_Name_id.json` with non-alphanumeric runs replaced by
  * underscores.
+ * @param {string} name - Folder name.
+ * @param {string} id - Folder id.
+ * @returns {string} Filename for the folder.
  */
-export function folderFilename(name: any, id: any): string;
+export function folderFilename(name: string, id: string): string;
 /**
  * The markdown renderer every surface shares.
  *

package/types/engine/homepage.d.mts

@@ -87,9 +87,8 @@ export function checkHomepageAddressFields(fm: object | null | undefined, { isAu
  * {@link module:engine/diagnostics}. {@link lintContentTree} already reports an
  * empty walk against the same locator.
  *
- * The rule reads no `site:` configuration and does not vary by
- * `publish.site`: that setting chooses whether the *content* surfaces are
- * published, and the homepage is the floor underneath both modes.
+ * The rule applies to every content tree, whether it contains only the
+ * homepage or other notes as well.
  *
  * @param {ReadonlyArray<{file: string}>} found - The homepage notes, in walk
  *   order. Paths may be absolute or relative to the working directory.

package/types/engine/index.d.mts

@@ -1,6 +1,7 @@
 export * as ids from "./ids.mjs";
 export * as systemBlock from "./system-block.mjs";
 export * as codeFences from "./code-fences.mjs";
+export { formatGenerated } from "./format-generated.mjs";
 export * as frontmatter from "./frontmatter.mjs";
 export * as contentTree from "./content-tree.mjs";
 export * as packConfig from "./pack-config.mjs";
@@ -31,6 +32,10 @@ export * as siteMaps from "./site-maps.mjs";
 export * as systems from "./systems.mjs";
 export * as calendars from "./calendars.mjs";
 export * as noteDates from "./note-dates.mjs";
+export * as dateConversion from "./date-conversion.mjs";
+export * as markdownExpressions from "./markdown-expressions.mjs";
+export * as calendarChoice from "./calendar-choice.mjs";
+export * as cultureChoice from "./culture-choice.mjs";
 export * as reckoningMarkers from "./reckoning-markers.mjs";
 export * as calendarNotes from "./calendar-notes.mjs";
 export * as calendarArtifacts from "./calendar-artifacts.mjs";

package/types/engine/infobox-registry.d.mts

@@ -50,13 +50,15 @@ export function compilesSystemDocument(fm: object, map: object, router: object):
  *   Resolves a reference to `{name, url?, uuid?, address?, subType?}`.
  * @param {object} [options.router] - The pack router deciding which system
  *   compiles a document for this note. Defaults to the consuming repository's.
+ * @param {object} [options.dates] - Calendar conversion context.
  * @returns {object[]} The boxes, in the order every medium renders them.
  * @throws {Error} When the built set disagrees with what the note's type maps
  *   to — see {@link module:engine/infobox.assertInfoboxSet}.
  */
-export function noteInfoboxes(fm: object, { resolve, router }?: {
+export function noteInfoboxes(fm: object, { resolve, router, dates }?: {
     resolve?: ((ref: unknown, hint?: object) => object | undefined) | undefined;
     router?: object | undefined;
+    dates?: object | undefined;
 }): object[];
 /**
  * Every system's infobox declaration, in the order a page shows them.

package/types/engine/infobox.d.mts

@@ -236,10 +236,16 @@ export function isDeclaredDefault(field: object, raw: unknown): boolean;
  *
  * @param {object} fm - The note's frontmatter.
  * @param {readonly object[]} fields - The system's field declaration.
- * @param {object} ctx - `{ block, resolve, resolveField, taken, presentation }`.
+ * @param {{block: string, resolve?: Function, resolveField?: Function, taken?: Set<string>, presentation?: object}} ctx - Rendering context.
  * @returns {object[]} Zero or one section.
  */
-export function systemRowsSection(fm: object, fields: readonly object[], { block, resolve, resolveField, taken, presentation }: object): object[];
+export function systemRowsSection(fm: object, fields: readonly object[], { block, resolve, resolveField, taken, presentation }: {
+    block: string;
+    resolve?: Function;
+    resolveField?: Function;
+    taken?: Set<string>;
+    presentation?: object;
+}): object[];
 /**
  * Every box a note carries, in the order every medium renders them.
  *
@@ -290,10 +296,12 @@ export function sectionHolds(section: object): boolean;
  * against a restatement of it.
  *
  * @param {object} fm - The note's frontmatter.
- * @param {object} options - `{ maps }`.
+ * @param {{maps: readonly object[]}} options - Document subtype mappings.
  * @returns {string[]} The ids.
  */
-export function requiredInfoboxIds(fm: object, { maps }: object): string[];
+export function requiredInfoboxIds(fm: object, { maps }: {
+    maps: readonly object[];
+}): string[];
 /**
  * Refuse a page carrying anything but the boxes its type maps to.
  *
@@ -306,12 +314,15 @@ export function requiredInfoboxIds(fm: object, { maps }: object): string[];
  *
  * @param {readonly object[]} boxes - What was built.
  * @param {object} fm - The note's frontmatter.
- * @param {object} options - `{ maps, where }`.
+ * @param {{maps: readonly object[], where?: string}} options - Document subtype mappings and context.
  * @returns {readonly object[]} The boxes, unchanged, so a caller may assert
  *   inline.
  * @throws {Error} Naming the note, what is missing and what is extra.
  */
-export function assertInfoboxSet(boxes: readonly object[], fm: object, { maps, where }?: object): readonly object[];
+export function assertInfoboxSet(boxes: readonly object[], fm: object, { maps, where }?: {
+    maps: readonly object[];
+    where?: string;
+}): readonly object[];
 /**
  * How a section arranges what it holds.
  *

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

@@ -1,13 +1,13 @@
 /**
- * The description an item carries: a pointer to its **item doc**, the
- * JournalEntry the journals pass compiles this same body into.
+ * The description an item carries: a pointer to a page of its **item doc**,
+ * the JournalEntry the journals pass compiles this same body into.
  *
  * The prose is not rendered into the item at all. Carrying it would duplicate
  * it onto every actor holding the item — 7.59 MB of copies across the actors
  * pack, of which 133 KB was distinct — where a link is 60 bytes and always
  * current. The two passes derive the target from the note's own id, so neither
- * has to see the other's output; both split the *converted* markdown, so an H1
- * carrying a wikilink names the same page on both sides.
+ * has to see the other's output. `{#description}` selects the named page;
+ * an item without that anchor points to its first page.
  *
  * An item with no prose points at nothing, exactly as the journals pass writes
  * no entry for it.

package/types/engine/item-docs.d.mts

@@ -18,7 +18,7 @@
 export function itemDocEntryId(itemId: string): string;
 /**
  * The description an item carries in place of its prose: a `@UUID` link to the
- * first page of its item doc, and nothing else.
+ * description page of its item doc, and nothing else.
  *
  * "Nothing else" is the whole convention — a description that is *only* a link
  * is a pointer, and anything alongside it would make it ordinary prose that
@@ -30,11 +30,12 @@ export function itemDocEntryId(itemId: string): string;
  * @param {string} name - The item's name, used as the link's label. It shows
  *   only if the target ever fails to resolve, where a broken link naming the
  *   item beats a bare UUID.
- * @param {string} firstPageId - The id of the entry's first page, from
+ * @param {string} pageId - The id of the selected entry page, from
  *   {@link journalPageId}.
+ * @param {object} [fm] - The source note, used to route GM-only prose.
  * @returns {string} The pointer to store in `system.docHtml`.
  */
-export function itemDocPointer(packageId: string, itemId: string, name: string, firstPageId: string): string;
+export function itemDocPointer(packageId: string, itemId: string, name: string, pageId: string, fm?: object): string;
 export { itemTypes };
 import { itemTypes } from "./item-registry.mjs";
 export { docEntryTypes, hasDocEntry } from "./address.mjs";

package/types/engine/journals.d.mts

@@ -4,7 +4,7 @@
  * a split. Content before the first H1 (if non-empty) becomes a leading
  * page. Each H1 yields a page whose name is the heading
  * text (with any `{#anchor-id}` suffix stripped out and surfaced as
- * `anchorId`).
+ * `anchorSlug`).
  *
  * `leadName` names that leading page. A journal note's is "Introduction",
  * because it introduces the pages that follow. An item doc's is the item — a
@@ -12,14 +12,17 @@
  * calling that page "Introduction" would label the description as a preamble to
  * nothing.
  *
- * Returns an array of `{ name, anchorId, markdown }` in document order.
+ * @param {string} body - Markdown body to split.
+ * @param {string} [leadName] - Name of the page before the first heading.
+ * @returns {Array<{name: string, anchorSlug: string|null, level: number,
+ *   markdown: string}>} Pages in document order.
  */
-export function splitPages(body: any, leadName?: string): {
+export function splitPages(body: string, leadName?: string): Array<{
     name: string;
-    anchorSlug: null;
+    anchorSlug: string | null;
     level: number;
     markdown: string;
-}[];
+}>;
 /**
  * Two pages in one note that would derive the same id, which the LevelDB packer
  * reports only as an opaque duplicate-key collision. Catch it here, where the
@@ -66,7 +69,7 @@ export function assertUniqueAnchors(rawPages: Array<{
  * An anchored page takes the id its inbound links compute from the note id and
  * the slug, so link and page agree without shared state. Every other page is
  * keyed by its **name**, which is what lets the items pass address an item
- * doc's first page without having compiled it (see
+ * doc's selected page without having compiled it (see
  * {@link sohl.utils.packs.itemDocPointer}).
  *
  * **It takes no index**. Keying a page by position *and* name,
@@ -100,7 +103,7 @@ export function journalPageId(entryId: string, page: {
  *   documents, in order.
  * @throws {Error} When the note has no content at all, or repeats an anchor.
  */
-export function buildPages(rawPages: Array<object>, entryId: string, noteName: string): Array<{
+export function buildPages(rawPages: Array<object>, entryId: string, noteName: string, captions: any): Array<{
     _id: string;
     name: string;
     type: string;

package/types/engine/map-graphviz.d.mts

@@ -16,7 +16,7 @@
  */
 export function renderDot(dotPath: string, outPath: string, { engine, format, nop, dpi }: {
     engine: "dot" | "twopi" | "neato";
-    format?: "svg" | "plain" | "png" | undefined;
+    format?: "svg" | "png" | "plain" | undefined;
     nop?: 2 | undefined;
     dpi?: number | undefined;
 }): {

package/types/engine/markdown-expressions.d.mts

@@ -0,0 +1,17 @@
+/** Find SQL helper calls, including calls nested inside Boolean expressions. */
+export function sqlQueriesInMarkdown(body: any, fm?: {}): any[];
+/**
+ * Expand scalar frontmatter references and registered functions in Markdown prose.
+ * @param {string} body
+ * @param {{fm?: object, dates?: object, sqlResults?: Map<string, object>, file?: string, bodyLine?: number}} [options]
+ */
+export function renderMarkdownExpressions(body: string, { fm, dates, sqlResults, file, bodyLine }?: {
+    fm?: object;
+    dates?: object;
+    sqlResults?: Map<string, object>;
+    file?: string;
+    bodyLine?: number;
+}): {
+    markdown: string;
+    findings: any[];
+};

package/types/engine/note-dates.d.mts

@@ -20,8 +20,12 @@
  *   the month it names. A calendar that declares no list bounds nothing.
  * @param {Map<string, object>} [options.markers] - Resolved era markers from
  *   the corpus, each carrying its calendar and canonical start.
+ * @param {Map<string, object>} [options.eras] - Resolved calendar eras, keyed
+ *   by their addressed qualifier.
+ * @param {boolean} [options.ignoreEraBounds=false] - Parse a calendar row's
+ *   own boundary in a referenced era without applying that era's note span.
  * @param {number} [options.daysPerYear] - The world's year length, required for
- *   canonical days and marked dates.
+ *   canonical days and named dates.
  * @param {string} [options.field] - The key that carried it, named in every
  *   message. Omitted, a message names the value alone.
  * @param {boolean} [options.allowUnknown=true] - Whether `"unknown"` is a
@@ -39,6 +43,8 @@ export function parseNoteDate(value: unknown, options?: {
         months?: readonly object[] | null;
     } | undefined;
     markers?: Map<string, object> | undefined;
+    eras?: Map<string, object> | undefined;
+    ignoreEraBounds?: boolean | undefined;
     daysPerYear?: number | undefined;
     field?: string | undefined;
     allowUnknown?: boolean | undefined;
@@ -49,6 +55,44 @@ export function parseNoteDate(value: unknown, options?: {
     date: object | null;
     findings: object[];
 };
+/** Select the single era covering the full precision of a resolved date. */
+export function eraCovering(date: any, eraRows: any, daysPerYear: any): any;
+/** Resolve a calendar or one of its eras from an Address or shortcode. */
+export function calendarEras(reference: any, context: any): any;
+/** Print a resolved date using the era active in one addressed calendar. */
+export function formatDateInCalendar(date: any, reference: any, context: any): {
+    era: null;
+    year: number;
+    text: any;
+    prose: null;
+    month?: undefined;
+    day?: undefined;
+} | {
+    era: any;
+    year: number;
+    month: number | null;
+    day: number | null;
+    text: string;
+    prose: string | null;
+} | null;
+/** Print a resolved date in one era, retaining its authored precision. */
+export function formatNoteDate(date: any, era: any, daysPerYear: any): {
+    era: null;
+    year: number;
+    text: any;
+    prose: null;
+    month?: undefined;
+    day?: undefined;
+} | {
+    era: any;
+    year: number;
+    month: number | null;
+    day: number | null;
+    text: string;
+    prose: string | null;
+} | null;
+/** Normalize a note's declared dates for indexes and generated pages. */
+export function resolvedDateFields(fm: any, context: any): {};
 /**
  * The literal that says a thing happened and the date is not recorded.
  *
@@ -74,3 +118,5 @@ export const ERA_QUALIFIER_PATTERN: RegExp;
  * @type {RegExp}
  */
 export const NOTE_DATE_PATTERN: RegExp;
+/** A calendar conversion written as a frontmatter date value. */
+export const DATEFROM_PATTERN: RegExp;

package/types/engine/note-package.d.mts

@@ -1,24 +1,8 @@
 /**
- * A note's frontmatter as a generated table searches it — its package present,
- * though no note declares one.
- *
- * A `dataview` query resolves `package` out of frontmatter like any other
- * field, so a collection note that scopes itself with `WHERE … and package =
- * "sohl"` would match nothing now that the field is gone, and would render an
- * **empty table** in silence. Supplying the derived value here is what kept the
- * sweep mechanical rather than a trap — and a query that never mentions
- * `package` is unaffected either way.
- *
- * The frontmatter is copied rather than written into: it is the note's own
- * parsed object, shared with every other reader, and the derived package is a
- * property of *this search*, not of the note.
- *
+ * A copy of frontmatter carrying the configured package for query evaluation.
  * @param {object|null|undefined} fm - Parsed frontmatter.
- * @param {string} [configured] - The package this build compiles. Defaults to
- *   the configured `contentPackage`; passed explicitly by callers that already
- *   carry it in a context object, so a caller's configuration drives every read.
- * @returns {object|null|undefined} A shallow copy carrying the derived package,
- *   or whatever was passed when it is not frontmatter at all.
+ * @param {string} [configured] - The package this build compiles.
+ * @returns {object|null|undefined} Frontmatter with a derived package value.
  */
 export function searchableFrontmatter(fm: object | null | undefined, configured?: string): object | null | undefined;
 /**

package/types/engine/note-state.d.mts

@@ -111,7 +111,8 @@ export function placeholderBody(body: string | null | undefined): Array<{
  *
  * Fence blocks, headings, thematic breaks and HTML comments are dropped, and a
  * wikilink counts as the one word it renders — `[[affiliation-meivor|Mëivōr]]`
- * is a word, not three. What is left is split on whitespace.
+ * is a word, not three. A dash, slash, or ellipsis between words separates
+ * them even without surrounding spaces.
  *
  * @param {string|null|undefined} body - The note body.
  * @returns {number} The word count.

package/types/engine/note-vocabulary.d.mts

@@ -61,6 +61,8 @@ export function hasTag(fm: object | null | undefined, tag: string): boolean;
  * @returns {boolean} Whether the note carries the `draft` tag.
  */
 export function isDraftNote(fm: object | null | undefined): boolean;
+/** Whether a note is restricted to GM-facing output. */
+export function isGmNote(fm: any): boolean;
 /**
  * What a note carrying a subType outside the address charset is told.
  *
@@ -167,6 +169,8 @@ export const SHARED_DATA_FIELDS: readonly DataFieldSpec[];
  * {@link draftRetiredMessage}.
  */
 export const DRAFT_TAG: "draft";
+/** A note intended for the GM rather than the player-facing outputs. */
+export const GM_TAG: "gm";
 /**
  * The tags that **classify** a note, grouped by what they classify.
  *
@@ -243,6 +247,11 @@ export const DECLARED_TAGS: Readonly<{
         types: null;
         tags: readonly string[];
     }>;
+    /** Who may read a completed note. */
+    audience: Readonly<{
+        types: null;
+        tags: readonly string[];
+    }>;
 }>;
 /**
  * Every note type this toolchain compiles, and the closed vocabulary it

package/types/engine/number-words.d.mts

@@ -0,0 +1,4 @@
+/** Spell a SQL integer in running prose, using American cardinal style. */
+export function numberWords(value: any): string;
+/** Render a SQL number with grouped thousands and its fractional part. */
+export function numberDigits(value: any): string;

package/types/engine/office-holders.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Validate one affiliation's office roster against dated beings in the corpus.
+ * @param {object} note
+ * @param {{index?: object}} [options]
+ */
+export function checkDatedOffices(note: object, { index }?: {
+    index?: object;
+}): {
+    severity: string;
+    message: any;
+    line?: number;
+    column?: number;
+    file: any;
+}[];

package/types/engine/pack-config.d.mts

@@ -137,7 +137,7 @@ export const CONFIG_BASENAME: "package-build.config";
  * the order the names are *reported* in, which is the order a reader should
  * reach for them: YAML first, `.mjs` last.
  *
- * The `content-build.config.*` stem this package read before the two toolchains
+ * The `package-build.config.*` stem this package read before the two toolchains
  * merged is **not** resolved. 3.0.0 renames the file rather than accepting both:
  * a deprecation window here would mean a repository could sit indefinitely on a
  * name for a package that no longer exists, and the upgrade already requires

package/types/engine/packages.d.mts

@@ -40,8 +40,9 @@ export function isReservedPackage(pkg: unknown): boolean;
  * with, which is the whole point: the alternative is every package depending on
  * one of the others just to borrow a banner.
  *
- * So nothing may create a real package that collides with the name, and its
- * resolution is special-cased, because no installed directory sits behind it.
+ * Only this toolchain's own documentation package may share the name. Other
+ * repositories cannot claim it, and asset resolution is special-cased because
+ * no installed Foundry directory sits behind it.
  *
  * This module is a **leaf with no local imports**, so the configuration
  * validator can name it without closing a cycle around `content-config.mjs`.