@heroiclands/package-build 22.24.0 → 22.26.0

package/engine/holdings.mjs

@@ -35,16 +35,15 @@
  * package publishes is listed within a local region, and a house another
  * package publishes is named on the local manor it holds.
  *
- * **A place's tenure is checked.** A settlement, a site or a structure that no
- * affiliation's `domains` names is land nobody holds — a gap in tenure the
- * lint reports as a warning at the note's `type:` line. A region is held
- * through its polity's `domains` and a feature by nobody, so both are exempt.
+ * **Government is stated separately from tenure.** A place with positive
+ * `data.population` and no authored `data.government` receives an advisory.
+ * Explicit null means complete anarchy. Holdings never supply a government.
  *
  * @module
  */
 
 import { isAddressTuple } from "./address.mjs";
-import { positionInFrontmatter } from "./diagnostics.mjs";
+import { positionOfFrontmatterPath } from "./diagnostics.mjs";
 import { parseAddress } from "./address.mjs";
 import { readCanonicalKey } from "./content-address.mjs";
 
@@ -66,9 +65,9 @@ const PLACE_TYPES = Object.freeze(new Set(["place"]));
 export const HOLDINGS_KEYS = Object.freeze(["contains", "held_by", "holdings"]);
 
 /**
- * The place subTypes tenure is checked on. A region is held through its
- * polity's `domains`, a world by nobody, a feature by nobody — a river has no
- * lord — so the rest are the kinds of place a body holds directly.
+ * Legacy subtypes of the retired tenure advisory. Government advisories
+ * apply to every place subtype when its authored population is positive.
+ * @deprecated This list no longer gates any advisory.
  *
  * @type {readonly string[]}
  */
@@ -373,71 +372,44 @@ export function holdingsPages(nodes) {
 /* --------------------------------------------------------------------- */
 
 /**
- * Every shortcode some affiliation's `domains` names, computed once per link
- * index. The lint asks the question once per place note, and the answer is a
- * fact about the whole corpus — local notes and every fetched entry — so it
- * is read off the index the first time and kept beside it.
- *
- * @type {WeakMap<object, Set<string>>}
- */
-const HELD = new WeakMap();
-
-/**
- * The shortcodes every affiliation's `domains` names, across the link index.
- *
- * @param {object} index - The link index.
- * @returns {Set<string>} The held shortcodes, lower case.
+ * Advise when a place with an authored positive population omits government.
+ * Missing, null or zero population establishes no inhabited population.
+ * Property presence distinguishes omitted government from explicit null,
+ * which means complete anarchy. Non-null values are validated by the declared
+ * affiliation reference field. Neither geographic containment nor tenure
+ * supplies this fact, and the rule is independent of place subtype.
+ *
+ * @param {object} note - The note with parsed frontmatter and raw source.
+ * @returns {object[]} Located warning findings.
  */
-function heldShortcodes(index) {
-    let held = HELD.get(index);
-    if (held) return held;
-    held = new Set();
-    for (const note of index.notes ?? []) {
-        if (String(note.type ?? note.fm?.type ?? "") !== "affiliation") continue;
-        const data = note.fm?.data;
-        const domains = data && typeof data === "object" ? data.domains : undefined;
-        for (const shortcode of shortcodesOf(domains)) held.add(shortcode);
-    }
-    for (const entry of index.foreign?.index?.values?.() ?? []) {
-        if (String(entry?.type ?? "") !== "affiliation") continue;
-        for (const shortcode of shortcodesOf(entry.domains)) held.add(shortcode);
-    }
-    HELD.set(index, held);
-    return held;
-}
-
-/**
- * Check a place note's tenure: a settlement, a site or a structure that no
- * affiliation's `domains` names is unheld land, reported as a warning at the
- * note's `type:` line.
- *
- * Declared on the `place` vocabulary as its type-level check, so the lint
- * runs it beside the field checks with the same index. Without an index the
- * question cannot be asked and nothing is reported.
- *
- * @param {object} note - The note, as the link index hands it over.
- * @param {object} [opts]
- * @param {object} [opts.index] - The link index, holding every affiliation.
- * @returns {object[]} Findings.
- */
-export function checkHeld(note, { index } = {}) {
-    if (!index) return [];
+export function checkGovernment(note) {
     const fm = note.fm ?? {};
-    if (String(fm.type ?? "") !== "place") return [];
-    const subType = String(fm.subType ?? "");
-    if (!HELD_SUBTYPES.includes(subType)) return [];
-    const shortcode = String(fm.shortcode ?? "").toLowerCase();
-    if (!shortcode) return [];
-    if (heldShortcodes(index).has(shortcode)) return [];
+    if (fm.type !== "place") return [];
+    const data = fm.data;
+    if (!data || typeof data !== "object" || Array.isArray(data)) return [];
+    const population = data.population;
+    if (typeof population !== "number" && typeof population !== "string") return [];
+    const count = Number(population);
+    if (!Number.isFinite(count) || count <= 0 || Object.hasOwn(data, "government")) return [];
     return [
         {
             file: note.file,
-            ...positionInFrontmatter(note.raw ?? "", "type", undefined, { topLevel: true }),
+            ...positionOfFrontmatterPath(note.raw ?? "", ["data", "population"], { key: true }),
             severity: "warning",
             message:
-                `unheld land: no affiliation's \`domains\` names "${shortcode}", so nothing ` +
-                `says who holds this ${subType}; name it in the \`domains\` of the house, ` +
-                `order or polity that does`,
+                `missing government: place "${fm.shortcode ?? ""}" has positive population ` +
+                "but no `data.government`; name an affiliation or write null for complete anarchy",
         },
     ];
 }
+
+/**
+ * The historical API name for the government advisory. Tenure is no longer checked.
+ * @deprecated Use checkGovernment.
+ * @param {object} note - The place note.
+ * @param {object} [_opts] - Historical options, no longer needed.
+ * @returns {object[]} Government advisory findings.
+ */
+export function checkHeld(note, _opts = {}) {
+    return checkGovernment(note);
+}

package/engine/index.mjs

@@ -99,7 +99,7 @@ export * as stubLint from "./stub-lint.mjs";
 /** What a place is next to and reachable from: the closed sets, and the checks. */
 export * as placeRelations from "./place-relations.mjs";
 
-/** What lies within a place, who holds it, and what an affiliation holds — the page lists, and the tenure check. */
+/** What lies within a place, who holds it, and what an affiliation holds — the page lists, and the government advisory. */
 export * as holdings from "./holdings.mjs";
 export * as populations from "./populations.mjs";
 

package/engine/infobox.mjs

@@ -427,6 +427,7 @@ export function isUnsetSentinel(value) {
 /**
  * Whether a value is worth a row.
  *
+ * A field declaring `nullText` handles explicit null before this general test.
  * Rule 4: an absent field is absent. `null`, `""` and `[]` are how the corpus
  * writes "nobody filled this in" — a note that declares every key of its type
  * and leaves most of them empty is the ordinary shape, not the exception — and
@@ -943,6 +944,15 @@ function noteBox(
             if (structured.length) shown.add(field.name);
             continue;
         }
+        if (raw === null && field.nullText) {
+            rows.push({
+                label: overlay.label ?? humanizeFieldName(field.name),
+                kind: "text",
+                value: field.nullText,
+            });
+            shown.add(field.name);
+            continue;
+        }
         if (!hasValue(raw)) continue;
 
         if (overlay.group) {

package/engine/metadata-index.mjs

@@ -435,6 +435,9 @@ export function loadForeignIndexes(config, localPackages, bases = PACKAGE_BASE)
                 parents: record.data?.parents ?? undefined,
                 domains: record.data?.domains ?? undefined,
                 population: record.data?.population ?? undefined,
+                ...(Object.hasOwn(record.data ?? {}, "government") ?
+                    { government: record.data.government }
+                :   {}),
                 package: pkg,
             });
             const entry = index.get(key);

package/engine/note-vocabulary.mjs

@@ -105,14 +105,14 @@ import { checkSocialTies } from "./social-ties.mjs";
 import { checkStandings } from "./standings.mjs";
 import { STANDING_BODY_TYPES } from "./standing-terms.mjs";
 import { checkDatedOffices } from "./office-holders.mjs";
-import { checkRankLadder } from "./rank-ladder.mjs";
+import { checkAffiliationRankFloor, checkRankLadder } from "./rank-ladder.mjs";
 import { checkCalendarChoice } from "./calendar-choice.mjs";
 import { checkLoreEvents } from "./lore-events.mjs";
 import { checkCultureChoice } from "./culture-choice.mjs";
 import { SOCIAL_TIES, SOCIAL_TIE_TARGET_TYPES } from "./social-tie-terms.mjs";
 import { parseNoteDate } from "./note-dates.mjs";
 import { reckoningContext } from "./reckoning-markers.mjs";
-import { checkHeld } from "./holdings.mjs";
+import { checkGovernment } from "./holdings.mjs";
 import {
     checkBeingMeasurement,
     parseBeingHeight,
@@ -153,6 +153,7 @@ import { positionOfFrontmatterPath } from "./diagnostics.mjs";
  *   so each takes a row labelled and anchored by the post's own name.
  * @property {"subType"} [keySelector] - An alternative `subType:<skill-subtype>` key.
  * @property {readonly string[]} [accepts] - Allowed Address types, separate from `ref`.
+ * @property {string} [nullText] - Infobox text for an explicitly authored null with a declared meaning.
  * @property {string} [shape] - Human-readable shape, for a finding and for
  *   documentation.
  * @property {string} [entryShape] - For a `scalar-or-map` field, what one
@@ -512,8 +513,8 @@ const CHARGES = Object.freeze([
 /**
  * Everything `place` asks of a whole note.
  *
- * Two questions about one subject, and they are independent: who holds this
- * land, and — where the note is a body rather than somewhere within one — what
+ * Two questions about one subject, and they are independent: who governs this
+ * inhabited place, and — where the note is a body rather than somewhere within one — what
  * the body states about itself. A type declares one whole-note check, so the
  * two are composed here rather than either being folded into the other.
  *
@@ -522,7 +523,7 @@ const CHARGES = Object.freeze([
  * @returns {object[]} Findings from both.
  */
 function checkPlace(note, opts) {
-    return [...checkHeld(note, opts), ...checkWorldFacts(note, opts)];
+    return [...checkGovernment(note), ...checkWorldFacts(note, opts)];
 }
 
 /** Validate a being's authored date using the shared note-date grammar. */
@@ -1014,6 +1015,7 @@ export const NOTE_VOCABULARY = Object.freeze({
 
     affiliation: Object.freeze({
         stubbable: true,
+        check: checkAffiliationRankFloor,
         subTypes: Object.freeze([
             "guild",
             "order",
@@ -1562,6 +1564,17 @@ export const NOTE_VOCABULARY = Object.freeze({
                 check: checkPopulation,
                 describe: "Approximate population, to two significant digits.",
             },
+            {
+                name: "government",
+                ...LINK,
+                shape: "an affiliation Address or null",
+                ref: "affiliation",
+                accepts: ["affiliation"],
+                nullText: "Complete anarchy",
+                describe:
+                    "The governing affiliation; explicit null means complete anarchy. " +
+                    "A positive population with no government key produces an advisory.",
+            },
             {
                 name: "market",
                 ...NUM,

package/engine/pdf-build.mjs

@@ -744,7 +744,7 @@ export async function buildPdf({
      * @param {number} columns - The entry's page columns.
      * @returns {string} Typst markup.
      */
-    const figureCounts = { code: 0, table: 0, figure: 0, map: 0, prose: 0 };
+    const figureCounts = { code: 0, table: 0, figure: 0, map: 0, poem: 0, prose: 0 };
     // The role lookup a `:::figure` fence's `map` counter reaches through —
     // see `engine/content-figures.mjs`'s `resolveRole`. Addressed form, for a
     // page's own scan below, which runs before its embeds are rewritten into

package/engine/pdf-render.mjs

@@ -88,6 +88,7 @@ export const BOOK_IMAGE_WIDTHS = Object.freeze({
 import { slugify } from "./content-slug.mjs";
 import { scanFigures } from "./content-figures.mjs";
 import { BLOCK_CONTAINERS, scanBlocks, BLOCK_NAMES } from "./content-blocks.mjs";
+import { inlineVerse, poetryStanzas } from "./content-poetry.mjs";
 import { matchAllOutsideCode, replaceOutsideCode } from "./code-fences.mjs";
 import { HTML_TAG, htmlMessage } from "./content-html.mjs";
 import { EXPRESSION } from "./markdown-expressions.mjs";
@@ -526,7 +527,16 @@ export function markdownToTypst(markdown, opts = {}) {
         }
     }
     if (!opts.insideAdmonition) {
-        const { blocks } = scanBlocks(source);
+        const figuresHoldingPoetry = scanFigures(source).figures;
+        const blocks = scanBlocks(source).blocks.filter(
+            (block) =>
+                !figuresHoldingPoetry.some(
+                    (figure) =>
+                        block.name === "poetry" &&
+                        block.start >= figure.bodyStart &&
+                        block.end < figure.bodyEnd,
+                ),
+        );
         if (blocks.length) {
             const lines = source.split("\n");
             const output = [];
@@ -538,6 +548,24 @@ export function markdownToTypst(markdown, opts = {}) {
                         insideAdmonition: true,
                     }),
                 );
+                if (block.name === "poetry") {
+                    const content = poetryStanzas(block.body)
+                        .map((stanza) =>
+                            stanza
+                                .map(({ text, level }) => {
+                                    const verse = markdownToTypst(inlineVerse(text), {
+                                        ...sharedOptions,
+                                        insideAdmonition: true,
+                                    });
+                                    return `${level ? `#h(${level * 1.25}em)` : ""}${verse}`;
+                                })
+                                .join(" \\\n"),
+                        )
+                        .join("\n\n");
+                    output.push(`\n#block(width: 100%)[${content}]\n`);
+                    cursor = block.end + 1;
+                    continue;
+                }
                 const { color, background, symbol } = BLOCK_PRINT[block.name];
                 // The title is inline markdown, rendered the way every other
                 // phrase in the book is. Set as it was written it would be read
@@ -601,7 +629,9 @@ export function markdownToTypst(markdown, opts = {}) {
                 { ...caption, imagesRemaining: { n: countImages(block) } }
             :   caption;
         const segments = [
-            renderMarkdownSegment(block, md, { ...ctx, caption: captioned }, definitions),
+            caption.kind === "poem" ?
+                markdownToTypst(block, { ...sharedOptions, captions: undefined })
+            :   renderMarkdownSegment(block, md, { ...ctx, caption: captioned }, definitions),
         ];
         if (caption.kind !== "table" && caption.kind !== "figure" && caption.kind !== "map") {
             segments.push(

package/engine/rank-ladder.mjs

@@ -50,6 +50,38 @@ const RUNG_KEYS = Object.freeze(["level", "title", "description", "lore"]);
 /** The keys a rung must carry a value for. */
 const REQUIRED_TEXT = Object.freeze(["title", "description"]);
 
+/** Every affiliation has an ordinary standing that a being can name as rank 1. */
+export function checkAffiliationRankFloor(note) {
+    if (note.fm?.type !== "affiliation") return [];
+    const governance = note.fm?.data?.governance;
+    const ranks = governance?.ranks;
+    // A non-list already has a shape finding. Do not repeat it here.
+    if (ranks !== undefined && ranks !== null && !Array.isArray(ranks)) return [];
+    if (
+        Array.isArray(ranks) &&
+        ranks.some((rung) => integer(rung?.level) && Number(rung.level) === 1)
+    )
+        return [];
+
+    const path = Array.isArray(ranks) ? ["data", "governance", "ranks"] : ["data", "governance"];
+    const atRankOrGovernance = positionOfFrontmatterPath(note.raw ?? "", path, { key: true });
+    const position =
+        atRankOrGovernance.line !== undefined ?
+            atRankOrGovernance
+        :   positionOfFrontmatterPath(note.raw ?? "", ["data"], { key: true });
+    return [
+        {
+            file: note.file,
+            ...position,
+            severity: "error",
+            message:
+                !Array.isArray(ranks) || ranks.length === 0 ?
+                    "affiliation needs data.governance.ranks with a level 1 standing"
+                :   "affiliation data.governance.ranks needs a level 1 standing",
+        },
+    ];
+}
+
 /**
  * Whether a value is a YAML mapping rather than a list or a scalar.
  *

package/hugo-theme/data/banners.yaml

@@ -19,7 +19,7 @@
 # used as given and never looked for here.
 #
 # Keeping it in step is not left to hope: `npm run lint:banners`
-# (`utils/check-banners.mjs`, part of `npm run lint`) fetches every name below
+# (`ci/check-banners.mjs`, part of `npm run lint`) fetches every name below
 # from a real asset host and fails on any non-200. Add a name here only after
 # the file is published, or the check will say so.
 #

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

@@ -1373,6 +1373,35 @@ a.tag:hover {
   background: var(--bg-card);
 }
 
+/* Verse lines are hard breaks in the markup; paragraphs mark stanzas. */
+.single-content .poetry {
+  margin: 1.5rem 0;
+  line-height: 1.7;
+}
+
+.single-content .poetry p {
+  margin: 0;
+}
+
+.single-content .poetry p + p {
+  margin-top: 1em;
+}
+
+.single-content .poetry .poetry-line {
+  display: inline-block;
+  margin-inline-start: var(--poetry-indent, 0em);
+  white-space: pre-wrap;
+}
+
+.single-content .poetry .poetry-line.i1 { --poetry-indent: 1.25em; }
+.single-content .poetry .poetry-line.i2 { --poetry-indent: 2.5em; }
+.single-content .poetry .poetry-line.i3 { --poetry-indent: 3.75em; }
+.single-content .poetry .poetry-line.i4 { --poetry-indent: 5em; }
+.single-content .poetry .poetry-line.i5 { --poetry-indent: 6.25em; }
+.single-content .poetry .poetry-line.i6 { --poetry-indent: 7.5em; }
+.single-content .poetry .poetry-line.i7 { --poetry-indent: 8.75em; }
+.single-content .poetry .poetry-line.i8 { --poetry-indent: 10em; }
+
 /* Ornamental horizontal rule: thin line flanking a centered gold
    diamond. Uses gradients on ::before/::after to keep the markup
    clean (authors just write `---` in markdown). */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@heroiclands/package-build",
-    "version": "22.24.0",
+    "version": "22.26.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",
@@ -187,10 +187,12 @@
         "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",
+        "lint": "run-p --aggregate-output -c --max-parallel 4 format:check lint:markdown lint:yaml lint:labels lint:image-roles lint:banners lint:content-format",
         "lint:markdown": "node bin/package-build.mjs markdown",
         "lint:yaml": "node bin/package-build.mjs yaml",
         "lint:labels": "node bin/package-build.mjs labels check",
+        "lint:image-roles": "vitest run tests/theme-image-roles.test.ts",
+        "lint:banners": "node ci/check-banners.mjs",
         "lint:markdown:fix": "node bin/package-build.mjs markdown --fix",
         "lint:content-format": "npm run lint:content-format:schema && npm run lint:content-format:fields && node ci/content-format-reference.mjs --check",
         "lint:content-format:schema": "node bin/package-build.mjs content-format schema --schema sohl=tests/fixtures/content-format/schema-sohl.json --schema hm3=tests/fixtures/content-format/schema-hm3.json",

package/types/engine/calendar-notes.d.mts

@@ -29,7 +29,7 @@ export function checkCalendarDateFormats(note: any): {
 /**
  * Check a `place` note's world facts.
  *
- * Declared on `place` beside its tenure check, so the lint runs both with the
+ * Declared on `place` beside its government advisory, so the lint runs both with the
  * same index. Four rules, and each is a fact about the setting rather than
  * about the file:
  *

package/types/engine/content-figures.d.mts

@@ -87,6 +87,7 @@ export const FIGURE_NAMES: Readonly<{
     table: "Table";
     figure: "Figure";
     map: "Map";
+    poem: "Poem";
     prose: "Prose";
 }>;
 /**

package/types/engine/content-poetry.d.mts

@@ -0,0 +1,19 @@
+/** The authored verse lines, excluding stanza separators. */
+export function verseLines(body: any): string[];
+/**
+ * The least-indented verse is level zero. Every two additional leading spaces
+ * add one level; a leftover space is discarded and the level stops at eight.
+ * Blank lines divide stanzas rather than contributing to the baseline.
+ */
+export function poetryStanzas(body: any): {
+    text: string;
+    level: number;
+}[][];
+/** A verse is inline Markdown even when it starts with block syntax. */
+export function inlineVerse(text: any): string;
+/**
+ * Keep stanzas as Markdown paragraphs and make every verse line a hard break.
+ * The surrounding renderer still sees the entire note, so links and footnote
+ * definitions remain in scope. The span carries the indent for each line.
+ */
+export function poetryMarkdown(body: any): string;

package/types/engine/holdings.d.mts

@@ -53,22 +53,25 @@ export function foreignHoldingsNodes(foreignIndex: Map<string, object> | undefin
  */
 export function holdingsPages(nodes: Iterable<HoldingsNode | null>): Map<string, Holdings>;
 /**
- * Check a place note's tenure: a settlement, a site or a structure that no
- * affiliation's `domains` names is unheld land, reported as a warning at the
- * note's `type:` line.
+ * Advise when a place with an authored positive population omits government.
+ * Missing, null or zero population establishes no inhabited population.
+ * Property presence distinguishes omitted government from explicit null,
+ * which means complete anarchy. Non-null values are validated by the declared
+ * affiliation reference field. Neither geographic containment nor tenure
+ * supplies this fact, and the rule is independent of place subtype.
  *
- * Declared on the `place` vocabulary as its type-level check, so the lint
- * runs it beside the field checks with the same index. Without an index the
- * question cannot be asked and nothing is reported.
- *
- * @param {object} note - The note, as the link index hands it over.
- * @param {object} [opts]
- * @param {object} [opts.index] - The link index, holding every affiliation.
- * @returns {object[]} Findings.
+ * @param {object} note - The note with parsed frontmatter and raw source.
+ * @returns {object[]} Located warning findings.
+ */
+export function checkGovernment(note: object): object[];
+/**
+ * The historical API name for the government advisory. Tenure is no longer checked.
+ * @deprecated Use checkGovernment.
+ * @param {object} note - The place note.
+ * @param {object} [_opts] - Historical options, no longer needed.
+ * @returns {object[]} Government advisory findings.
  */
-export function checkHeld(note: object, { index }?: {
-    index?: object | undefined;
-}): object[];
+export function checkHeld(note: object, _opts?: object): object[];
 /**
  * The keys this module writes, and which a note cannot author: `contains`
  * and `held_by` on a place, `holdings` on an affiliation.
@@ -77,9 +80,9 @@ export function checkHeld(note: object, { index }?: {
  */
 export const HOLDINGS_KEYS: readonly string[];
 /**
- * The place subTypes tenure is checked on. A region is held through its
- * polity's `domains`, a world by nobody, a feature by nobody — a river has no
- * lord — so the rest are the kinds of place a body holds directly.
+ * Legacy subtypes of the retired tenure advisory. Government advisories
+ * apply to every place subtype when its authored population is positive.
+ * @deprecated This list no longer gates any advisory.
  *
  * @type {readonly string[]}
  */

package/types/engine/infobox.d.mts

@@ -27,6 +27,7 @@ export function isUnsetSentinel(value: unknown): boolean;
 /**
  * Whether a value is worth a row.
  *
+ * A field declaring `nullText` handles explicit null before this general test.
  * Rule 4: an absent field is absent. `null`, `""` and `[]` are how the corpus
  * writes "nobody filled this in" — a note that declares every key of its type
  * and leaves most of them empty is the ordinary shape, not the exception — and

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

@@ -380,6 +380,10 @@ export type DataFieldSpec = {
      * - Allowed Address types, separate from `ref`.
      */
     accepts?: readonly string[] | undefined;
+    /**
+     * - Infobox text for an explicitly authored null with a declared meaning.
+     */
+    nullText?: string | undefined;
     /**
      * - Human-readable shape, for a finding and for
      * documentation.

package/types/engine/rank-ladder.d.mts

@@ -1,3 +1,11 @@
+/** Every affiliation has an ordinary standing that a being can name as rank 1. */
+export function checkAffiliationRankFloor(note: any): {
+    severity: string;
+    message: string;
+    line?: number;
+    column?: number;
+    file: any;
+}[];
 /**
  * Check one affiliation's `data.governance.ranks` against the rung contract.
  *