@rpgm-tools/neo-angband-mod-sdk 0.10.0

package/dist/loader.js

@@ -0,0 +1,314 @@
+/**
+ * Content-pack loading: turn a resolved set of packs into the merged per-file
+ * record arrays a host binds into the running game.
+ *
+ * This is the join MOD_INTEGRATION_PLAN.md (Wave 1, W1.1) calls for. Until now
+ * the composition engine (resolveLoadOrder + composePacks) had no runtime
+ * caller: the game bound a single hard-coded pack directly. This wraps the
+ * engine into one entry point so the base game and every mod flow through the
+ * same pipeline, and a mod's records / patches / replaces / removes /
+ * fieldPatches actually take effect.
+ *
+ * The host (web / cli) owns the glue: it reads packs off disk or bundle, calls
+ * composeContentPacks, assembles its GamePack from the result, and hands that
+ * to core bindCore. Core stays mod-sdk-agnostic (it only ever sees a merged
+ * pack), so the layering the audit relied on is preserved.
+ *
+ * TWO MERGE PHASES, AND WHY
+ *
+ * composePacks needs a unique string `name` on every added record, because that
+ * is the identity it builds refs from. Measured over the shipped core pack, 24
+ * of the 44 record files satisfy that and 20 do not (14 carry no string `name`
+ * at all; 6 carry names that slug to the same ref). So:
+ *
+ *  1. COMPOSED FILES (24) go through composePacks, which merges records
+ *     per-record and appends a later pack's additions after an earlier pack's.
+ *  2. PASSTHROUGH FILES (20) keep whole-file semantics for `records` - the last
+ *     provider in load order wins the file - because a mod that ships
+ *     `constants.json` means "use mine", not "add a second constants record",
+ *     and the host binds one. Per-record ops are then applied on top, in load
+ *     order, against the winning array (applyPassthroughOps below), using the
+ *     per-file identity declared in record-key.ts.
+ *
+ * NOTHING IS DROPPED IN SILENCE. This is the invariant the whole file exists to
+ * hold. Until 2026-07-29 phase 2 did not exist: a `patches` / `replaces` /
+ * `fieldPatches` / `removes` entry aimed at any of the 20 was stripped from the
+ * contribution before compose ever saw it, so a mod author shipped a valid op
+ * and got no effect and no message - the worst failure mode there is, because a
+ * feature that appears to work cannot be found by review. Now every per-record
+ * op either takes effect or produces a line in `ComposedContent.problems`
+ * naming the pack, the file, the op and the ref. Whole-file replacement of a
+ * passthrough file is reported the same way, because it silently discards
+ * whatever the previous provider (usually core) put there.
+ *
+ * `problems` is reported rather than thrown because the web host composes at
+ * module scope with no try (packages/web/src/pack.ts), so a throw here is a
+ * blank page rather than a message. It is the same shape of channel the pack
+ * readers already use (`problems: readonly string[]`), so a host concatenates it
+ * into the list it already shows.
+ */
+import { slugify } from "./manifest.js";
+import { resolveLoadOrder } from "./resolve.js";
+import { composePacks, mergePatch } from "./compose.js";
+import { applyFieldPatch } from "./patch.js";
+import { keyDescription, keySpecFor, recordKey, RECORD_KEY_SPECS } from "./record-key.js";
+function isNamedRecord(r) {
+    return (typeof r === "object" &&
+        r !== null &&
+        !Array.isArray(r) &&
+        typeof r.name === "string" &&
+        r.name.length > 0);
+}
+/**
+ * A pack's added records for one file are per-record composable only if they
+ * are all name-keyed and their refs (pack:slug(name)) do not collide - exactly
+ * the two conditions composePacks would otherwise throw on.
+ */
+function recordsComposable(records) {
+    const slugs = new Set();
+    for (const r of records) {
+        if (!isNamedRecord(r))
+            return false;
+        const slug = slugify(r["name"]);
+        if (slugs.has(slug))
+            return false;
+        slugs.add(slug);
+    }
+    return true;
+}
+/** Reorder loaded packs into resolved load order (dependencies first). */
+function orderPacks(packs) {
+    const ordered = resolveLoadOrder(packs.map((p) => p.manifest));
+    const byId = new Map(packs.map((p) => [p.manifest.id, p]));
+    return ordered.map((m) => byId.get(m.id));
+}
+/** The pack id a ref's "<owner>:<slug>" prefix names. */
+function ownerOf(ref) {
+    const at = ref.indexOf(":");
+    return at === -1 ? "" : ref.slice(0, at);
+}
+/** compose.ts mayModify: a pack may only touch its own or a declared dep's records. */
+function mayModify(m, ownerPack) {
+    return ownerPack === m.id || (m.dependencies ?? {})[ownerPack] !== undefined;
+}
+/** Every per-record op in one contribution, flattened, in apply order. */
+function perRecordOps(contrib) {
+    const out = [];
+    for (const ref of Object.keys(contrib.patches ?? {}))
+        out.push({ kind: "patch", ref });
+    for (const ref of Object.keys(contrib.replaces ?? {}))
+        out.push({ kind: "replace", ref });
+    for (const ref of Object.keys(contrib.fieldPatches ?? {})) {
+        out.push({ kind: "fieldPatch", ref });
+    }
+    for (const ref of contrib.removes ?? [])
+        out.push({ kind: "remove", ref });
+    return out;
+}
+const OP_VERB = {
+    patch: "patches",
+    replace: "replaces",
+    fieldPatch: "fieldPatches",
+    remove: "removes",
+};
+/**
+ * Apply every pack's per-record ops to a PASSTHROUGH file's winning record
+ * array, in load order, and report every op that could not be honoured.
+ *
+ * Returns the (possibly new) record array; the input is never mutated, and when
+ * no pack contributes an op the input array is returned unchanged so routing the
+ * base game alone through this path stays a no-op by reference.
+ */
+function applyPassthroughOps(file, records, ordered, providerId, problems) {
+    const hasOps = ordered.some((p) => p.files[file] !== undefined && perRecordOps(p.files[file]).length > 0);
+    if (!hasOps)
+        return records;
+    /* No declared identity (history: chart/next/roll/phrase are all values a mod
+     * would change). Every op is reported and none is applied - the one honest
+     * answer, because inventing a key here would mis-merge instead of dropping. */
+    if (RECORD_KEY_SPECS[file] === undefined && !recordsKeyedByName(records)) {
+        for (const pack of ordered) {
+            const contrib = pack.files[file];
+            if (!contrib)
+                continue;
+            for (const { kind, ref } of perRecordOps(contrib)) {
+                problems.push(`${pack.manifest.id}: ${file} ${OP_VERB[kind]} "${ref}", but ${file} records have no per-record identity, so only whole-file replacement can change them`);
+            }
+        }
+        return records;
+    }
+    const spec = keySpecFor(file);
+    const working = records.map((r) => typeof r === "object" && r !== null && !Array.isArray(r) ? r : null);
+    /* ref -> EVERY position claiming it. Kept as a list rather than resolved to a
+     * winner on insert, so "not found" and "claimed twice" are one lookup with two
+     * outcomes: there is nowhere for a first-claim-wins fallback to hide. A ref two
+     * records claim is unaddressable and reported; both records stay in the game. */
+    const claims = new Map();
+    records.forEach((record, i) => {
+        const key = recordKey(file, record, spec);
+        if (key === null)
+            return; // unkeyable record: stays in the game, not addressable
+        const ref = `${providerId}:${key}`;
+        const at = claims.get(ref);
+        if (at)
+            at.push(i);
+        else
+            claims.set(ref, [i]);
+    });
+    const removed = new Set();
+    const reject = (pid, kind, ref, why) => {
+        problems.push(`${pid}: ${file} ${OP_VERB[kind]} "${ref}", but ${why}`);
+    };
+    /** Resolve a ref to a live index, or report why it cannot be touched. */
+    const resolve = (pack, kind, ref) => {
+        const pid = pack.manifest.id;
+        const claimants = claims.get(ref) ?? [];
+        if (claimants.length > 1) {
+            reject(pid, kind, ref, `${claimants.length} ${file} records share that identity (${keyDescription(file)}), so it cannot be addressed - patch a record with a unique identity instead`);
+            return null;
+        }
+        const at = claimants[0];
+        if (at === undefined) {
+            reject(pid, kind, ref, `no such record exists in ${file} (identity is ${keyDescription(file)})`);
+            return null;
+        }
+        if (removed.has(at)) {
+            reject(pid, kind, ref, "an earlier pack already removed it");
+            return null;
+        }
+        if (!mayModify(pack.manifest, ownerOf(ref))) {
+            reject(pid, kind, ref, `${pid} does not declare ${ownerOf(ref)} as a dependency`);
+            return null;
+        }
+        return at;
+    };
+    for (const pack of ordered) {
+        const contrib = pack.files[file];
+        if (!contrib)
+            continue;
+        for (const [ref, body] of Object.entries(contrib.patches ?? {})) {
+            const at = resolve(pack, "patch", ref);
+            if (at === null)
+                continue;
+            working[at] = mergePatch(working[at], body);
+        }
+        for (const [ref, body] of Object.entries(contrib.replaces ?? {})) {
+            const at = resolve(pack, "replace", ref);
+            if (at === null)
+                continue;
+            working[at] = body;
+        }
+        for (const [ref, ops] of Object.entries(contrib.fieldPatches ?? {})) {
+            const at = resolve(pack, "fieldPatch", ref);
+            if (at === null)
+                continue;
+            working[at] = applyFieldPatch(working[at], ops);
+        }
+        for (const ref of contrib.removes ?? []) {
+            const at = resolve(pack, "remove", ref);
+            if (at === null)
+                continue;
+            removed.add(at);
+        }
+    }
+    const out = [];
+    working.forEach((r, i) => {
+        if (!removed.has(i))
+            out.push(r === null ? records[i] : r);
+    });
+    return out;
+}
+/** Whether a passthrough file's records are name-keyed after all (mod-only file). */
+function recordsKeyedByName(records) {
+    return records.some((r) => isNamedRecord(r));
+}
+/**
+ * Compose a set of loaded packs into merged per-file record arrays. With a
+ * single pack (the base game alone) the output is record-identical to the
+ * input: every record object is preserved by reference and its order is
+ * unchanged, so routing the base game through this path is a no-op.
+ */
+export function composeContentPacks(packs) {
+    const ordered = orderPacks(packs);
+    const problems = [];
+    const fileNames = new Set();
+    for (const p of ordered) {
+        for (const f of Object.keys(p.files))
+            fileNames.add(f);
+    }
+    // Classify each file: per-record composable, or whole-file passthrough.
+    const composable = new Set();
+    for (const f of fileNames) {
+        let ok = true;
+        for (const p of ordered) {
+            const contrib = p.files[f];
+            if (contrib?.records && !recordsComposable(contrib.records)) {
+                ok = false;
+                break;
+            }
+        }
+        if (ok)
+            composable.add(f);
+    }
+    const contents = ordered.map((p) => {
+        const files = {};
+        for (const [f, contrib] of Object.entries(p.files)) {
+            if (composable.has(f))
+                files[f] = contrib;
+        }
+        return { manifest: p.manifest, files };
+    });
+    const game = composePacks(contents);
+    const out = {};
+    for (const [file, table] of game) {
+        out[file] = [...table.values()].map((r) => r.value);
+    }
+    /* Passthrough files, in two phases (see the header): the last provider in load
+     * order wins the whole file, then every pack's per-record ops apply on top. */
+    for (const f of fileNames) {
+        if (composable.has(f))
+            continue;
+        let providerId = "";
+        for (const p of ordered) {
+            const contrib = p.files[f];
+            if (!contrib?.records)
+                continue;
+            if (providerId !== "") {
+                /* Whole-file replacement is destructive and used to be invisible: the
+                 * previous provider's records simply vanished. Say so. */
+                problems.push(`${p.manifest.id}: ${f} replaces the whole file, discarding ${out[f].length} record(s) from ${providerId} - ${f} records are not name-keyed, so a whole file is the only thing that can be added to it`);
+            }
+            out[f] = [...contrib.records];
+            providerId = p.manifest.id;
+        }
+        if (providerId === "") {
+            /* SAFETY NET, not a live path. A file is only classified passthrough
+             * because some pack's `records` for it are not name-keyed, and such a pack
+             * is by definition a provider - so today providerId is never "" here. The
+             * equivalent case for a COMPOSABLE file (a mod patches a file nobody
+             * supplies records for) is loud already: composePacks throws
+             * "patch target ... does not exist". This branch is kept, cordoned and
+             * documented rather than deleted, because if the classification ever
+             * changes its absence would be a silent drop - the exact failure this file
+             * exists to prevent. Covered by loader.test.ts only through the composable
+             * counterpart. */
+            for (const p of ordered) {
+                const contrib = p.files[f];
+                if (!contrib)
+                    continue;
+                for (const { kind, ref } of perRecordOps(contrib)) {
+                    problems.push(`${p.manifest.id}: ${f} ${OP_VERB[kind]} "${ref}", but no pack supplies any ${f} records`);
+                }
+            }
+            continue;
+        }
+        out[f] = applyPassthroughOps(f, out[f], ordered, providerId, problems);
+    }
+    return {
+        records: out,
+        composedFiles: [...composable].sort(),
+        passthroughFiles: [...fileNames].filter((f) => !composable.has(f)).sort(),
+        problems,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Pack manifests: identity, versioning, and dependencies.
+ *
+ * Every pack - the base game included - carries a manifest. Load order,
+ * record composition, and savefile provenance all key off it.
+ */
+/** Pack identifiers are namespaced: "<pack>:<id>", e.g. "core:kobold". */
+export type PackRef = `${string}:${string}`;
+/** The three pack shapes (docs/MODS.md). */
+export type PackShape = "content" | "tiles" | "plugin";
+/** Every shape, for validation and for iterating the facet vocabulary. */
+export declare const PACK_SHAPES: readonly PackShape[];
+/**
+ * WHAT A PACK CONTRIBUTES, as a SET rather than one exclusive kind.
+ *
+ * `shape` was exclusive, and the two halves of the loader gated on opposite
+ * values: code loaded only for `shape: "plugin"` (web/src/mod-code.ts) and
+ * records composed only for `shape: "content"` (web/src/pack.ts). So the folder
+ * layout the plugin documentation promises -
+ *
+ *     my-mod/  manifest.json  plugin.js  monster.json  tiles/orc.png
+ *
+ * - could never work: declaring "plugin" dropped monster.json from composition,
+ * and declaring "content" refused the code. Each half had tests and each half
+ * passed; nothing asserted the two together. A mod that adds a monster AND gives
+ * it behaviour is the ordinary case, not an exotic one.
+ *
+ * `facets` is that set. `shape` stays REQUIRED and remains the pack's primary
+ * kind - it is what the manager displays and what every existing manifest
+ * already carries - and when `facets` is present it must CONTAIN `shape`, so the
+ * two fields cannot contradict each other. A hybrid declares:
+ *
+ *     { "shape": "content", "facets": ["content", "plugin"] }
+ *
+ * The consent property is unchanged and is why `facets` is a declaration rather
+ * than something inferred from the folder's contents: shipping plugin.js without
+ * naming the `plugin` facet is still a REFUSAL, because running code must be
+ * something a mod states rather than something a file listing implies.
+ */
+export declare function packFacets(manifest: Pick<PackManifest, "shape" | "facets">): ReadonlySet<PackShape>;
+/** Whether a pack contributes `facet` (its shape, or any declared facet). */
+export declare function hasFacet(manifest: Pick<PackManifest, "shape" | "facets">, facet: PackShape): boolean;
+/**
+ * One player-toggleable "rule" a pack contributes: a flag name the pack owns,
+ * plus the human-facing label / description / default the in-app "Fixes &
+ * tweaks" menu renders.
+ *
+ * WHAT THIS USED TO BE, AND WHY IT IS NOT THAT ANY MORE. The first design made
+ * this a registry of CORE flags: the corrected behaviour lived in ported core as
+ * an off-by-default branch guarded by `if (modRuleEnabled(state, flag))`, the
+ * host applied the resolved choices to GameState.modRules, and no mod code ran.
+ * That design was deleted on 2026-07-29 because a flag-gated fix is not excluded
+ * from core - core shipped the fix body AND the mod's flag name, so deleting the
+ * mod folder would not have deleted a line of it. `modRuleEnabled` is GONE
+ * (packages/core/src/game/context.ts, where its removal is recorded), and
+ * `GameState.modRules` still exists but is OPAQUE to core: core stores it because
+ * a save has to record which patches a character was played with, and never
+ * branches on it (`context.ts`, the modRules doc comment).
+ *
+ * WHAT A RULE IS NOW: an input to the MOD's own code. Mods do run code. A mod
+ * that changes behaviour ships `hooks.ts` next to its manifest, default-exporting
+ * `(flags: Readonly<Record<string, boolean>>) => ModHooks`. The host discovers it
+ * (packages/web/src/mod-hooks.ts), calls it once per ENABLED mod in load order
+ * with only THAT mod's resolved flags (`choices[flag] ?? rule.default` for the
+ * rules its own manifest declares, so one mod cannot read another's toggles), and
+ * folds the results into the single ModHooks core holds via `composeModHooks`
+ * (packages/core/src/mod/hooks.ts). Each fix body lives in its mod's folder; what
+ * core contains is the generic seam, not any mod's name.
+ *
+ * A disabled mod's patches DO NOT EXIST rather than existing and reading false:
+ * its entry point is never called, it contributes no hook, composeModHooks
+ * returns undefined, and GameState.modHooks stays absent - so core runs the
+ * faithful 4.2.6 path, which is the only path compiled into the branch.
+ *
+ * A rules-only pack is still a plain `content` pack requesting no capabilities;
+ * `rules` remains pure declaration, and this manifest still holds no behaviour.
+ */
+export interface PackRule {
+    /**
+     * The flag this rule toggles (e.g. "qol.autoDig"). Namespaced by convention to
+     * the owning pack, because the pack's own hooks.ts is what reads it; the host
+     * also records the resolved value on GameState.modRules as save state.
+     */
+    flag: string;
+    /** Short menu label (e.g. "Auto-dig"). */
+    title: string;
+    /** One- or two-line description shown under the toggle in the menu. */
+    description: string;
+    /** Whether the rule is ON by default when the mod is enabled. */
+    default: boolean;
+}
+/**
+ * A capability a scripted plugin requests (MOD_LIFECYCLE section 4). The
+ * runtime grants only what a `shape: plugin` pack declares and the user
+ * approves; content and tile packs request none. The vocabulary
+ * ("command:add", "event:turn-start", "state:*.read", "network:<host>", ...)
+ * is enforced by the capability model (P7 phase 5); the manifest only records
+ * the request, so any string is accepted here.
+ */
+export type Capability = string;
+/**
+ * One graphics mode a `tiles`-facet pack contributes.
+ *
+ * This was read loosely off the raw JSON for a long time and was NOT in the
+ * validated schema, which the moddability measurement recorded as a gap
+ * (docs/modding/MOD_REACH.md). The consequence was specific rather than
+ * theoretical: a typo in `grafID` or `path` produced no error anywhere - the entry
+ * was silently skipped, and a mod author saw a Graphics row that simply never
+ * appeared. Declaring it here means the manifest is refused at the edge, with the
+ * mod's id and the offending field named.
+ */
+export interface PackTilePack {
+    /**
+     * The list.txt serial number this mode renders as. A `tilesheet` pack must claim
+     * one the core catalog already knows (it borrows that row's cell size, atlas
+     * filename and pref file); a `linoleum` pack carries its own metadata and may
+     * claim a new id - use >= 100 to stay clear of upstream's numbering.
+     */
+    grafID: number;
+    /**
+     * The pack's directory INSIDE THE MOD FOLDER (`original-tiles`,
+     * `tiles/my-set`), or absent for a pack that is the mod folder itself.
+     *
+     * Mod-relative, not a site path. A mod cannot know where a host serves it from,
+     * and two of the three sources serve it from nowhere: a folder the player picked
+     * has no URL for its files until their bytes are wrapped in a blob:, and a mod
+     * installed from a repository lives in IndexedDB. The host composes this with
+     * the mod's own asset resolver.
+     */
+    path?: string;
+    /**
+     * Which renderer draws it: `tilesheet` (or absent) for upstream's own scheme -
+     * one atlas PNG addressed by row/column - and `linoleum` for a loose pack, a
+     * directory of individually named PNGs. This is the PACK's renderer; the
+     * manifest's top-level `engine` is the game version the mod targets.
+     */
+    engine?: "tilesheet" | "linoleum";
+    /**
+     * The Graphics row's label. Required in effect for a mode the core catalog does
+     * not have, since there would be nothing to name the row; a pack re-skinning a
+     * catalogued mode may omit it and borrow that row's name.
+     */
+    menuname?: string;
+}
+export interface PackManifest {
+    /**
+     * The pack's namespace: lowercase kebab-case, unique among loaded
+     * packs. "core" is reserved for the base game.
+     */
+    id: string;
+    /** Human-readable title. */
+    name: string;
+    /** Semantic version of the pack itself. */
+    version: string;
+    /**
+     * The pack's primary kind, and what the mod manager displays. When `facets` is
+     * absent this is the pack's only facet.
+     */
+    shape: PackShape;
+    /**
+     * Everything this pack contributes, when it contributes more than one kind -
+     * a mod shipping both `plugin.js` and record JSON declares
+     * `["content", "plugin"]`. Must contain `shape`. See packFacets().
+     */
+    facets?: readonly PackShape[];
+    /**
+     * Engine version range the pack requires (semver range, e.g. ">=0.5.0
+     * <0.7.0"). A save refuses to load on an incompatible engine.
+     */
+    engine?: string;
+    /**
+     * Packs this one depends on, by id. A pack may only patch, replace,
+     * or remove records owned by packs it declares here. Values are
+     * version constraints; "*" accepts any version.
+     */
+    dependencies?: Record<string, string>;
+    /**
+     * Soft dependencies: if the named pack is present it loads first and may
+     * be modified, but its absence is not an error (MOD_LIFECYCLE section 2).
+     */
+    optionalDependencies?: Record<string, string>;
+    /** Load-order hints (MOD_LIFECYCLE section 3): follow / precede these ids. */
+    loadAfter?: string[];
+    loadBefore?: string[];
+    /**
+     * The pack's own save-block schema version. The engine hands a mod its
+     * old `mod:<id>` bag and asks it to migrate from this number on update.
+     */
+    saveSchema?: number;
+    /** Capabilities a `shape: plugin` pack requests (see Capability). */
+    capabilities?: Capability[];
+    /**
+     * The mod-plugin ABI version this pack's `plugin.js` was written against, and
+     * REQUIRED of any pack that ships one. Separate from `engine` on purpose: the
+     * engine version and the ABI a mod's code compiles against diverge immediately
+     * - a patch release changes the former and not the latter.
+     *
+     * Declared here, in the MANIFEST, rather than only inside plugin.js, so the
+     * host can refuse an incompatible plugin BEFORE importing it. A version check
+     * that lives inside the module can only run after the module's top-level code
+     * has already executed, which is the wrong order for player-supplied code.
+     *
+     * An exact integer, matched exactly, because the ABI is explicitly unstable
+     * until 1.0: every change to it bumps this number and every mod must
+     * republish. A semver range would imply a compatibility promise that does not
+     * exist yet.
+     */
+    modApi?: number;
+    /**
+     * Player-toggleable flags this pack owns (see PackRule). The bundled qol /
+     * bug-fixes mods use this to declare their fixes/tweaks for the in-app "Fixes
+     * & tweaks" menu; the host resolves (choice ?? default), hands each mod its own
+     * slice when it calls that mod's hooks.ts, and records the result on
+     * GameState.modRules as save state. Absent for a pack with nothing to toggle.
+     */
+    rules?: PackRule[];
+    /**
+     * Graphics modes this pack contributes (see PackTilePack). Only read for a pack
+     * with the `tiles` facet; a content pack that declares them contributes none.
+     */
+    tilePacks?: PackTilePack[];
+    /**
+     * Declares the pack deliberately nondeterministic (a wall-clock event, an
+     * external agent, live multiplayer). Trips the save's determinism ratchet
+     * once, irreversibly (MOD_LIFECYCLE section 4, decision 4/18).
+     */
+    nondeterministic?: boolean;
+    /** Declares a gameplay change that permanently makes an enabled save non-scoring. */
+    affectsGameplay?: boolean;
+    /**
+     * What the pack does, in the author's own words, for a human deciding whether
+     * to enable it. Prose, not a tagline: the in-app mod manager wraps it to fill
+     * the detail pane of the highlighted row, and a marketplace listing would show
+     * the same text. Absent is allowed but leaves a player with only the id/shape
+     * to go on.
+     */
+    description?: string;
+    /** Free-form author credit. */
+    author?: string;
+    /** SPDX license expression for the pack's own content. */
+    license?: string;
+    /** Source repository URL (installer provenance). */
+    repository?: string;
+    /** Path to the changelog within the pack. */
+    changelog?: string;
+    /** Paths to screenshot assets within the pack (marketplace preview). */
+    screenshots?: string[];
+}
+export declare class ManifestError extends Error {
+}
+/** Validate a parsed manifest object; throws ManifestError. */
+export declare function validateManifest(value: unknown): PackManifest;
+/**
+ * Slug a record name into the id segment of a PackRef: lowercase, runs
+ * of non-alphanumerics collapse to single hyphens ("Farmer Maggot" ->
+ * "farmer-maggot"). Stable: this is a savefile-visible identity.
+ */
+export declare function slugify(name: string): string;
+/** Build a namespaced record reference. */
+export declare function packRef(packId: string, name: string): PackRef;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}