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

package/dist/semver.js

@@ -0,0 +1,212 @@
+/**
+ * A small, dependency-free semver range matcher.
+ *
+ * This package bundles into a browser build, so it cannot pull in the
+ * `semver` npm package; this file implements just enough of the range
+ * grammar for pack manifests (MOD_LIFECYCLE.md section 3):
+ *
+ *  - `*` or `x` (any case): matches any version.
+ *  - an exact version, `1.2.3`: matches only that version.
+ *  - a partial version used bare, `1.2` or `1`: matches any version with
+ *    that prefix (`1.2` matches `1.2.0`..`1.2.x`; `1` matches `1.0.0`..`1.x.x`).
+ *  - caret ranges, `^1.2.3`: compatible-with, following npm's rule that the
+ *    leftmost nonzero component may not change (`^1.2.3` allows up to but
+ *    not including `2.0.0`; `^0.2.3` allows up to but not including `0.3.0`;
+ *    `^0.0.3` allows only `0.0.3`).
+ *  - tilde ranges, `~1.2.3`: patch-level allowed (up to but not including
+ *    `1.3.0`); `~1.2` is the same; `~1` allows up to but not including `2.0.0`.
+ *  - comparator sets: `>=`, `>`, `<=`, `<`, `=`, combined with spaces and
+ *    ANDed together, e.g. `>=1.0.0 <2.0.0`.
+ *
+ * Limitation (documented, not fixed): prerelease tags (`1.0.0-beta.2`) are
+ * compared naively as a single lexicographic string once the numeric
+ * major.minor.patch triple is equal, rather than the full dot-separated,
+ * numeric-vs-alphanumeric identifier comparison the semver spec defines.
+ * A version with no prerelease is always treated as newer than one with a
+ * prerelease at the same major.minor.patch, matching the spec; the ordering
+ * among different prerelease strings themselves does not. Pack authors who
+ * need exact prerelease ordering should not rely on it here.
+ */
+export class SemverError extends Error {
+}
+const PARTIAL_RE = /^(\d+|[xX*])(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?$/;
+function isWildcardToken(s) {
+    return s === "x" || s === "X" || s === "*";
+}
+/** Parse a (possibly partial, possibly wildcarded) version-shaped string. */
+function parsePartial(s) {
+    const match = PARTIAL_RE.exec(s);
+    if (!match) {
+        throw new SemverError(`malformed version: ${s}`);
+    }
+    const [, majorStr, minorStr, patchStr, prerelease] = match;
+    const major = majorStr === undefined || isWildcardToken(majorStr) ? null : Number(majorStr);
+    const minor = minorStr === undefined || isWildcardToken(minorStr) ? null : Number(minorStr);
+    const patch = patchStr === undefined || isWildcardToken(patchStr) ? null : Number(patchStr);
+    return { major, minor, patch, prerelease: prerelease ?? null };
+}
+/** Parse a full, exact version (all three components required); throws SemverError. */
+function parseVersion(s) {
+    const p = parsePartial(s);
+    if (p.major === null || p.minor === null || p.patch === null) {
+        throw new SemverError(`expected a full major.minor.patch version, got: ${s}`);
+    }
+    return { major: p.major, minor: p.minor, patch: p.patch, prerelease: p.prerelease };
+}
+/** -1 if a < b, 0 if equal, 1 if a > b. See the prerelease limitation above. */
+function compareVersions(a, b) {
+    if (a.major !== b.major)
+        return a.major - b.major < 0 ? -1 : 1;
+    if (a.minor !== b.minor)
+        return a.minor - b.minor < 0 ? -1 : 1;
+    if (a.patch !== b.patch)
+        return a.patch - b.patch < 0 ? -1 : 1;
+    if (a.prerelease === b.prerelease)
+        return 0;
+    if (a.prerelease === null)
+        return 1; // no prerelease outranks any prerelease
+    if (b.prerelease === null)
+        return -1;
+    return a.prerelease < b.prerelease ? -1 : 1;
+}
+/** Fill an absent minor/patch with 0, e.g. for comparator/caret/tilde bounds. */
+function fullFromPartial(p, major) {
+    return {
+        major,
+        minor: p.minor ?? 0,
+        patch: p.patch ?? 0,
+        prerelease: p.prerelease,
+    };
+}
+function caretChecker(p, major) {
+    const lower = fullFromPartial(p, major);
+    let upper;
+    if (major > 0) {
+        upper = { major: major + 1, minor: 0, patch: 0, prerelease: null };
+    }
+    else if (lower.minor > 0) {
+        upper = { major: 0, minor: lower.minor + 1, patch: 0, prerelease: null };
+    }
+    else {
+        upper = { major: 0, minor: 0, patch: lower.patch + 1, prerelease: null };
+    }
+    return (v) => compareVersions(v, lower) >= 0 && compareVersions(v, upper) < 0;
+}
+function tildeChecker(p, major) {
+    const lower = fullFromPartial(p, major);
+    const upper = p.minor === null
+        ? { major: major + 1, minor: 0, patch: 0, prerelease: null }
+        : { major, minor: lower.minor + 1, patch: 0, prerelease: null };
+    return (v) => compareVersions(v, lower) >= 0 && compareVersions(v, upper) < 0;
+}
+function comparatorChecker(op, p, major) {
+    const bound = fullFromPartial(p, major);
+    switch (op) {
+        case ">=":
+            return (v) => compareVersions(v, bound) >= 0;
+        case ">":
+            return (v) => compareVersions(v, bound) > 0;
+        case "<=":
+            return (v) => compareVersions(v, bound) <= 0;
+        case "<":
+            return (v) => compareVersions(v, bound) < 0;
+        case "=":
+            return (v) => compareVersions(v, bound) === 0;
+        default:
+            // Unreachable: parseToken only dispatches here with a known operator.
+            throw new SemverError(`unknown comparator: ${op}`);
+    }
+}
+/** A bare token with no operator: an exact version, or a wildcard prefix. */
+function bareChecker(p, major) {
+    if (p.minor === null) {
+        const lower = { major, minor: 0, patch: 0, prerelease: null };
+        const upper = { major: major + 1, minor: 0, patch: 0, prerelease: null };
+        return (v) => compareVersions(v, lower) >= 0 && compareVersions(v, upper) < 0;
+    }
+    if (p.patch === null) {
+        const lower = { major, minor: p.minor, patch: 0, prerelease: null };
+        const upper = {
+            major,
+            minor: p.minor + 1,
+            patch: 0,
+            prerelease: null,
+        };
+        return (v) => compareVersions(v, lower) >= 0 && compareVersions(v, upper) < 0;
+    }
+    const exact = { major, minor: p.minor, patch: p.patch, prerelease: p.prerelease };
+    return (v) => compareVersions(v, exact) === 0;
+}
+/** Parse one whitespace-delimited comparator token into a checker function. */
+function parseToken(token) {
+    if (token === "*" || token.toLowerCase() === "x") {
+        return () => true;
+    }
+    let op = "";
+    let rest = token;
+    if (rest.startsWith(">=")) {
+        op = ">=";
+        rest = rest.slice(2);
+    }
+    else if (rest.startsWith("<=")) {
+        op = "<=";
+        rest = rest.slice(2);
+    }
+    else if (rest.startsWith("^")) {
+        op = "^";
+        rest = rest.slice(1);
+    }
+    else if (rest.startsWith("~")) {
+        op = "~";
+        rest = rest.slice(1);
+    }
+    else if (rest.startsWith(">")) {
+        op = ">";
+        rest = rest.slice(1);
+    }
+    else if (rest.startsWith("<")) {
+        op = "<";
+        rest = rest.slice(1);
+    }
+    else if (rest.startsWith("=")) {
+        op = "=";
+        rest = rest.slice(1);
+    }
+    const partial = parsePartial(rest);
+    if (partial.major === null) {
+        // A wildcard major combined with an operator ("^x", ">=x") degrades to
+        // "any version"; there is no meaningful bound to compute.
+        return () => true;
+    }
+    switch (op) {
+        case "^":
+            return caretChecker(partial, partial.major);
+        case "~":
+            return tildeChecker(partial, partial.major);
+        case ">=":
+        case ">":
+        case "<=":
+        case "<":
+        case "=":
+            return comparatorChecker(op, partial, partial.major);
+        default:
+            return bareChecker(partial, partial.major);
+    }
+}
+/**
+ * Does `version` satisfy `range`? Throws SemverError if either string is
+ * malformed (an unparseable version, or a range with an unparseable token).
+ */
+export function satisfies(version, range) {
+    const trimmed = range.trim();
+    if (trimmed.length === 0) {
+        throw new SemverError("empty version range");
+    }
+    if (trimmed === "*" || trimmed.toLowerCase() === "x") {
+        return true;
+    }
+    const v = parseVersion(version);
+    const tokens = trimmed.split(/\s+/);
+    return tokens.every((token) => parseToken(token)(v));
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@rpgm-tools/neo-angband-mod-sdk",
+  "version": "0.10.0",
+  "description": "Pack schemas, validation, and tooling for Neo Angband mods (content packs, tile packs, scripted plugins)",
+  "license": "GPL-2.0-only",
+  "author": "neostryder (RPGM Tools)",
+  "homepage": "https://github.com/neostryder/neo-angband/blob/master/docs/MODS.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neostryder/neo-angband.git",
+    "directory": "packages/mod-sdk"
+  },
+  "bugs": "https://github.com/neostryder/neo-angband/issues",
+  "keywords": [
+    "angband",
+    "neo-angband",
+    "modding",
+    "mod-sdk",
+    "roguelike"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.test.ts",
+    "!**/*.test.js",
+    "!**/*.test.js.map",
+    "!**/*.test.d.ts",
+    "!**/*.test.d.ts.map",
+    "!**/*.tsbuildinfo",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "//publishConfig": [
+    "provenance is deliberately absent - trusted publishing attaches it with no flag,",
+    "and the flag would break the one manual publish a new package needs. The long",
+    "version is in packages/core/package.json and docs/RELEASING.md step 4."
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/src/capabilities.ts

@@ -0,0 +1,205 @@
+/**
+ * Capability model for scripted plugins (MOD_LIFECYCLE.md section 4, P7
+ * phase 5).
+ *
+ * Only `shape: plugin` packs may request capabilities; content and tile
+ * packs are validated data that cannot execute, so they request none
+ * (docs/MODS.md trust tiers). A plugin's `capabilities` list in its
+ * manifest is the consent surface: the installer shows each one in plain
+ * language, the user approves, and the runtime grants exactly that set -
+ * nothing a plugin did not ask for and the user did not see. The
+ * perceive/act facades (a later P7 phase) call `CapabilitySet.check()`
+ * before honoring a request; an ungranted capability throws a clear
+ * author-facing error rather than silently doing nothing or diverging.
+ *
+ * Vocabulary (four forms, MOD_LIFECYCLE section 4 / the frost example in
+ * section 2):
+ *  - "command:add"          - register commands on the act facade.
+ *  - "event:<name>"         - subscribe to an engine event, e.g.
+ *                             "event:turn-start".
+ *  - "state:<domain>.read"  - read one perceive-facade domain, e.g.
+ *                             "state:party.read"; or the wildcard
+ *                             "state:*.read" for any domain.
+ *  - "network:<host>"       - outbound network to one host; or "network:*"
+ *                             for any host. Not in the section-4 examples
+ *                             verbatim, but named there ("network access to
+ *                             api.example.com"); "*" is this module's
+ *                             extension for a plugin that genuinely needs
+ *                             unrestricted egress, and reads the same way
+ *                             the other wildcards do.
+ *  - "registry:<domain>"    - override a game SYSTEM registry from a TRUSTED
+ *                             in-process plugin (W2.2, core/mod/registry-host.ts):
+ *                             "registry:effect" | "registry:room" |
+ *                             "registry:command" | "registry:monster" |
+ *                             "registry:vocab"; or the wildcard "registry:*"
+ *                             for all of them. "registry:vocab" (W2.3) declares
+ *                             NEW vocabulary (flags/stats/any kind). Distinct
+ *                             from "command:add": that adds a command via the
+ *                             act facade, this replaces what a command DOES (and
+ *                             the effect/room/AI logic behind the game).
+ *                             (The named-core-rule flags the bundled qol /
+ *                             bug-fixes mods use, GameState.modRules, are a
+ *                             DECLARATIVE manifest field - PackManifest.rules -
+ *                             applied by the host, so they need no capability.)
+ *
+ * This module only surfaces `nondeterministic` from the manifest. The
+ * save's determinism ratchet itself - flipping a save from DETERMINISTIC to
+ * NONDETERMINISTIC the first time such a mod is enabled, once and
+ * irreversibly - lives in core/save (decisions 4/18/22), not here.
+ */
+
+import { hasFacet, type PackManifest } from "./manifest.js";
+
+export class CapabilityError extends Error {}
+
+/** A capability string parsed into its structured form. */
+export type ParsedCapability =
+  | { kind: "command"; action: "add" }
+  | { kind: "event"; name: string }
+  | { kind: "state"; domain: string; access: "read" }
+  | { kind: "network"; host: string }
+  | { kind: "registry"; domain: string };
+
+const EVENT_RE = /^event:([a-z][a-z0-9-]*)$/;
+const STATE_RE = /^state:(\*|[a-z][a-z0-9-]*)\.read$/;
+const NETWORK_RE = /^network:(\*|[a-zA-Z0-9.-]+)$/;
+/** The override domains ModRegistryHost gates, plus the "*" wildcard. */
+const REGISTRY_RE = /^registry:(\*|effect|room|command|monster|vocab)$/;
+
+/**
+ * Parse and validate a capability string against the vocabulary above,
+ * returning its structured form. Throws CapabilityError on anything
+ * malformed or outside the recognized patterns - an unknown capability is
+ * a hard error, not a silent no-op, since a typo'd request should fail
+ * loudly at install rather than quietly never matching a grant.
+ */
+export function parseCapability(cap: string): ParsedCapability {
+  if (cap === "command:add") {
+    return { kind: "command", action: "add" };
+  }
+  const event = EVENT_RE.exec(cap);
+  if (event) {
+    return { kind: "event", name: event[1] as string };
+  }
+  const state = STATE_RE.exec(cap);
+  if (state) {
+    return { kind: "state", domain: state[1] as string, access: "read" };
+  }
+  const network = NETWORK_RE.exec(cap);
+  if (network) {
+    return { kind: "network", host: network[1] as string };
+  }
+  const registry = REGISTRY_RE.exec(cap);
+  if (registry) {
+    return { kind: "registry", domain: registry[1] as string };
+  }
+  throw new CapabilityError(`unrecognized capability: "${cap}"`);
+}
+
+/**
+ * True if `grant` covers `request`. Exact match for command/event, plus the
+ * two documented wildcards: a "state:*.read" grant covers a read of any
+ * domain, and a "network:*" grant covers egress to any host.
+ */
+function grantCovers(grant: ParsedCapability, request: ParsedCapability): boolean {
+  switch (request.kind) {
+    case "command":
+      return grant.kind === "command";
+    case "event":
+      return grant.kind === "event" && grant.name === request.name;
+    case "state":
+      return (
+        grant.kind === "state" &&
+        grant.access === request.access &&
+        (grant.domain === "*" || grant.domain === request.domain)
+      );
+    case "network":
+      return (
+        grant.kind === "network" &&
+        (grant.host === "*" || grant.host === request.host)
+      );
+    case "registry":
+      return (
+        grant.kind === "registry" &&
+        (grant.domain === "*" || grant.domain === request.domain)
+      );
+  }
+}
+
+/**
+ * The capabilities a plugin was granted, built from its manifest. Facades
+ * hold one of these per loaded plugin and call `check()` before honoring
+ * any request that touches commands, events, state reads, or the network.
+ */
+export class CapabilitySet {
+  private readonly grants: readonly ParsedCapability[];
+  private readonly nondeterministic: boolean;
+  private readonly affectsGameplay: boolean;
+
+  private constructor(
+    grants: readonly ParsedCapability[],
+    nondeterministic: boolean,
+    affectsGameplay: boolean,
+  ) {
+    this.grants = grants;
+    this.nondeterministic = nondeterministic;
+    this.affectsGameplay = affectsGameplay;
+  }
+
+  /**
+   * Build a CapabilitySet from a pack manifest. Only `shape: plugin` packs
+   * may request capabilities (MOD_LIFECYCLE section 4): a content or tile
+   * pack with a non-empty `capabilities` list throws CapabilityError, since
+   * that shape cannot execute and so has nothing to grant capabilities to -
+   * the request signals author confusion or an upstream validation bug,
+   * not something to silently ignore.
+   */
+  static fromManifest(manifest: PackManifest): CapabilitySet {
+    const requested = manifest.capabilities ?? [];
+    if (!hasFacet(manifest, "plugin") && requested.length > 0) {
+      throw new CapabilityError(
+        `pack ${manifest.id}: only shape "plugin" packs may request capabilities ` +
+          `(this pack is shape "${manifest.shape}")`,
+      );
+    }
+    const grants = requested.map((cap) => parseCapability(cap));
+    return new CapabilitySet(
+      grants,
+      manifest.nondeterministic ?? false,
+      manifest.affectsGameplay ?? false,
+    );
+  }
+
+  /**
+   * True if `cap` is covered by a grant in this set, honoring the
+   * "state:*.read" and "network:*" wildcards. Throws CapabilityError if
+   * `cap` itself is not a recognized capability string.
+   */
+  has(cap: string): boolean {
+    const request = parseCapability(cap);
+    return this.grants.some((grant) => grantCovers(grant, request));
+  }
+
+  /**
+   * Throws CapabilityError, naming the missing capability and how to fix
+   * it, unless `cap` is granted. This is the guard the perceive/act facades
+   * call before honoring a plugin's request - an author-facing error, not
+   * a silent divergence.
+   */
+  check(cap: string): void {
+    if (this.has(cap)) return;
+    throw new CapabilityError(
+      `this plugin needs capability "${cap}"; add it to pack.json capabilities`,
+    );
+  }
+
+  /** True if the manifest declared `nondeterministic: true` (section 4). */
+  isNondeterministic(): boolean {
+    return this.nondeterministic;
+  }
+
+  /** True if the manifest declared `affectsGameplay: true`. */
+  isAffectsGameplay(): boolean {
+    return this.affectsGameplay;
+  }
+}

package/src/compose.ts

@@ -0,0 +1,186 @@
+/**
+ * Record composition: how a stack of packs becomes one game.
+ *
+ * Every record in the composed game is identified by a PackRef
+ * ("<owner-pack>:<slug>"). Packs may:
+ *  - add records (they become the owner),
+ *  - patch records owned by packs they declare as dependencies
+ *    (deep merge: objects merge per key, arrays and scalars replace,
+ *    an explicit null deletes the key),
+ *  - replace such records wholesale, or
+ *  - remove them.
+ *
+ * The base game is pack zero ("core") and gets no special treatment:
+ * a total conversion is just a pack that replaces or removes core
+ * records. Composition is deterministic given the resolved load order,
+ * and every record carries provenance (owner plus every pack that
+ * modified it) for savefiles and debugging.
+ */
+
+import type { PackManifest, PackRef } from "./manifest.js";
+import { packRef } from "./manifest.js";
+import { applyFieldPatch } from "./patch.js";
+import type { FieldPatch } from "./patch.js";
+
+export type JsonValue =
+  | null
+  | boolean
+  | number
+  | string
+  | JsonValue[]
+  | { [key: string]: JsonValue };
+export type JsonRecord = { [key: string]: JsonValue };
+
+/** One pack's contribution to one record file (e.g. "monster"). */
+export interface FileContribution {
+  /** New records; this pack becomes their owner. Each needs a name. */
+  records?: JsonRecord[];
+  /** Deep-merge patches onto records owned by declared dependencies. */
+  patches?: Record<string, JsonRecord>;
+  /** Wholesale replacements (owner and ref are preserved). */
+  replaces?: Record<string, JsonRecord>;
+  /** Refs to delete from the composed game. */
+  removes?: string[];
+  /**
+   * Field-level patches (see patch.ts): ordered field ops per target ref.
+   * composePacks applies these in load order after the coarse `patches`/
+   * `replaces` for the same pack (each pack's ops fold onto the running
+   * value, which is identical to composeFieldPatches over the ordered
+   * list). The pre-launch conflict report (P7 phase 6) reads the same data
+   * to find same-field collisions without the false-positive whole-record
+   * conflicts `patches` produces.
+   */
+  fieldPatches?: Record<string, FieldPatch>;
+}
+
+export interface PackContent {
+  manifest: PackManifest;
+  /** Contributions keyed by record file: "monster", "object", ... */
+  files: Record<string, FileContribution>;
+}
+
+export interface ComposedRecord {
+  ref: PackRef;
+  /** The pack that added the record. */
+  owner: string;
+  /** Every pack that patched or replaced it, in load order. */
+  modifiedBy: string[];
+  value: JsonRecord;
+}
+
+export class ComposeError extends Error {}
+
+/** Deep merge per the pack patch rules. Returns a new object. */
+export function mergePatch(base: JsonRecord, patch: JsonRecord): JsonRecord {
+  const out: JsonRecord = { ...base };
+  for (const [key, val] of Object.entries(patch)) {
+    if (val === null) {
+      delete out[key];
+    } else if (
+      typeof val === "object" &&
+      !Array.isArray(val) &&
+      typeof out[key] === "object" &&
+      out[key] !== null &&
+      !Array.isArray(out[key])
+    ) {
+      out[key] = mergePatch(out[key] as JsonRecord, val as JsonRecord);
+    } else {
+      out[key] = val;
+    }
+  }
+  return out;
+}
+
+function mayModify(m: PackManifest, ownerPack: string): boolean {
+  return ownerPack === m.id || (m.dependencies ?? {})[ownerPack] !== undefined;
+}
+
+function ownerOf(ref: string): string {
+  const at = ref.indexOf(":");
+  return at === -1 ? "" : ref.slice(0, at);
+}
+
+/**
+ * Compose packs (already in resolved load order) into per-file record
+ * maps. Iteration order of each map is deterministic: records appear
+ * in the order their owning packs added them.
+ */
+export function composePacks(
+  packs: readonly PackContent[],
+): Map<string, Map<PackRef, ComposedRecord>> {
+  const game = new Map<string, Map<PackRef, ComposedRecord>>();
+
+  for (const pack of packs) {
+    const pid = pack.manifest.id;
+    for (const [file, contrib] of Object.entries(pack.files)) {
+      let table = game.get(file);
+      if (!table) {
+        table = new Map();
+        game.set(file, table);
+      }
+
+      for (const rec of contrib.records ?? []) {
+        const name = rec["name"];
+        if (typeof name !== "string" || name.length === 0) {
+          throw new ComposeError(`${pid}/${file}: record without a name`);
+        }
+        const ref = packRef(pid, name);
+        if (table.has(ref)) {
+          throw new ComposeError(`${pid}/${file}: duplicate record ${ref}`);
+        }
+        table.set(ref, { ref, owner: pid, modifiedBy: [], value: rec });
+      }
+
+      for (const kind of ["patches", "replaces"] as const) {
+        for (const [refStr, body] of Object.entries(contrib[kind] ?? {})) {
+          const ref = refStr as PackRef;
+          const existing = table.get(ref);
+          if (!existing) {
+            const verb = kind === "patches" ? "patch" : "replace";
+            throw new ComposeError(`${pid}/${file}: ${verb} target ${ref} does not exist`);
+          }
+          if (!mayModify(pack.manifest, ownerOf(ref))) {
+            throw new ComposeError(
+              `${pid}/${file}: cannot modify ${ref} without declaring ${ownerOf(ref)} as a dependency`,
+            );
+          }
+          existing.value =
+            kind === "patches" ? mergePatch(existing.value, body) : body;
+          existing.modifiedBy.push(pid);
+        }
+      }
+
+      for (const [refStr, ops] of Object.entries(contrib.fieldPatches ?? {})) {
+        const ref = refStr as PackRef;
+        const existing = table.get(ref);
+        if (!existing) {
+          throw new ComposeError(
+            `${pid}/${file}: fieldPatch target ${ref} does not exist`,
+          );
+        }
+        if (!mayModify(pack.manifest, ownerOf(ref))) {
+          throw new ComposeError(
+            `${pid}/${file}: cannot modify ${ref} without declaring ${ownerOf(ref)} as a dependency`,
+          );
+        }
+        existing.value = applyFieldPatch(existing.value, ops);
+        existing.modifiedBy.push(pid);
+      }
+
+      for (const refStr of contrib.removes ?? []) {
+        const ref = refStr as PackRef;
+        if (!table.has(ref)) {
+          throw new ComposeError(`${pid}/${file}: remove target ${ref} does not exist`);
+        }
+        if (!mayModify(pack.manifest, ownerOf(ref))) {
+          throw new ComposeError(
+            `${pid}/${file}: cannot remove ${ref} without declaring ${ownerOf(ref)} as a dependency`,
+          );
+        }
+        table.delete(ref);
+      }
+    }
+  }
+
+  return game;
+}