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

package/dist/manifest.js

@@ -0,0 +1,264 @@
+/**
+ * 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.
+ */
+/** Every shape, for validation and for iterating the facet vocabulary. */
+export const PACK_SHAPES = ["content", "tiles", "plugin"];
+/**
+ * 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 function packFacets(manifest) {
+    return new Set(manifest.facets ?? [manifest.shape]);
+}
+/** Whether a pack contributes `facet` (its shape, or any declared facet). */
+export function hasFacet(manifest, facet) {
+    return packFacets(manifest).has(facet);
+}
+const ID_RE = /^[a-z][a-z0-9-]*$/;
+const VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+export class ManifestError extends Error {
+}
+/** Validate a parsed manifest object; throws ManifestError. */
+export function validateManifest(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new ManifestError("manifest must be an object");
+    }
+    const m = value;
+    if (typeof m["id"] !== "string" || !ID_RE.test(m["id"])) {
+        throw new ManifestError(`manifest id must be lowercase kebab-case: ${String(m["id"])}`);
+    }
+    if (typeof m["name"] !== "string" || m["name"].length === 0) {
+        throw new ManifestError(`manifest ${m["id"]}: name is required`);
+    }
+    if (typeof m["version"] !== "string" || !VERSION_RE.test(m["version"])) {
+        throw new ManifestError(`manifest ${m["id"]}: version must be semver, got ${String(m["version"])}`);
+    }
+    if (!PACK_SHAPES.includes(m["shape"])) {
+        throw new ManifestError(`manifest ${m["id"]}: shape must be one of ${PACK_SHAPES.join(", ")}`);
+    }
+    const id = m["id"];
+    validateFacets(m["facets"], id, m["shape"]);
+    validateDepMap(m["dependencies"], id, "dependencies");
+    validateDepMap(m["optionalDependencies"], id, "optionalDependencies");
+    validateIdList(m["loadAfter"], id, "loadAfter");
+    validateIdList(m["loadBefore"], id, "loadBefore");
+    if (m["saveSchema"] !== undefined) {
+        const s = m["saveSchema"];
+        if (typeof s !== "number" || !Number.isInteger(s) || s < 0) {
+            throw new ManifestError(`manifest ${id}: saveSchema must be a non-negative integer`);
+        }
+    }
+    if (m["capabilities"] !== undefined) {
+        if (!Array.isArray(m["capabilities"]) ||
+            m["capabilities"].some((c) => typeof c !== "string")) {
+            throw new ManifestError(`manifest ${id}: capabilities must be strings`);
+        }
+    }
+    if (m["modApi"] !== undefined) {
+        const a = m["modApi"];
+        if (typeof a !== "number" || !Number.isInteger(a) || a < 1) {
+            throw new ManifestError(`manifest ${id}: modApi must be a positive integer (the mod-plugin ABI version)`);
+        }
+    }
+    if (m["nondeterministic"] !== undefined &&
+        typeof m["nondeterministic"] !== "boolean") {
+        throw new ManifestError(`manifest ${id}: nondeterministic must be a boolean`);
+    }
+    if (m["affectsGameplay"] !== undefined &&
+        typeof m["affectsGameplay"] !== "boolean") {
+        throw new ManifestError(`manifest ${id}: affectsGameplay must be a boolean`);
+    }
+    validateRules(m["rules"], id);
+    validateTilePacks(m["tilePacks"], id);
+    for (const key of [
+        "engine",
+        "repository",
+        "changelog",
+        "description",
+        "author",
+        "license",
+    ]) {
+        if (m[key] !== undefined && typeof m[key] !== "string") {
+            throw new ManifestError(`manifest ${id}: ${key} must be a string`);
+        }
+    }
+    return m;
+}
+/** Validate an optional id->constraint map field (dependencies-shaped). */
+function validateDepMap(deps, id, field) {
+    if (deps === undefined)
+        return;
+    if (typeof deps !== "object" || deps === null || Array.isArray(deps)) {
+        throw new ManifestError(`manifest ${id}: ${field} must be a map`);
+    }
+    for (const [dep, constraint] of Object.entries(deps)) {
+        if (!ID_RE.test(dep)) {
+            throw new ManifestError(`manifest ${id}: bad ${field} id ${dep}`);
+        }
+        if (typeof constraint !== "string") {
+            throw new ManifestError(`manifest ${id}: ${field} ${dep} constraint must be a string`);
+        }
+    }
+}
+/** Validate the optional `rules` array (PackRule[]); throws ManifestError. */
+function validateRules(value, id) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value)) {
+        throw new ManifestError(`manifest ${id}: rules must be an array`);
+    }
+    const seen = new Set();
+    for (const entry of value) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            throw new ManifestError(`manifest ${id}: each rule must be an object`);
+        }
+        const r = entry;
+        if (typeof r["flag"] !== "string" || r["flag"].length === 0) {
+            throw new ManifestError(`manifest ${id}: rule flag must be a non-empty string`);
+        }
+        if (seen.has(r["flag"])) {
+            throw new ManifestError(`manifest ${id}: duplicate rule flag ${r["flag"]}`);
+        }
+        seen.add(r["flag"]);
+        if (typeof r["title"] !== "string" || r["title"].length === 0) {
+            throw new ManifestError(`manifest ${id}: rule ${r["flag"]} title must be a non-empty string`);
+        }
+        if (typeof r["description"] !== "string") {
+            throw new ManifestError(`manifest ${id}: rule ${r["flag"]} description must be a string`);
+        }
+        if (typeof r["default"] !== "boolean") {
+            throw new ManifestError(`manifest ${id}: rule ${r["flag"]} default must be a boolean`);
+        }
+    }
+}
+/** The pack renderers a tilePacks entry may name. */
+const TILE_ENGINES = ["tilesheet", "linoleum"];
+/**
+ * Validate the optional `tilePacks` array (PackTilePack[]); throws ManifestError.
+ *
+ * `path` is checked for being MOD-RELATIVE, and that check is the point rather than
+ * tidiness. It used to be a site-root-relative URL base, which only a bundled mod
+ * could ever get right; a manifest carrying the old form would resolve to
+ * `mods/<id>/mods/<id>/…` and 404 into ASCII with nothing said. An absolute path, a
+ * scheme, or a `..` escape is refused for the same reason a pack's code files are
+ * read by pack-relative path: the host decides where a mod's bytes live.
+ */
+function validateTilePacks(value, id) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value)) {
+        throw new ManifestError(`manifest ${id}: tilePacks must be an array`);
+    }
+    for (const entry of value) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            throw new ManifestError(`manifest ${id}: each tilePacks entry must be an object`);
+        }
+        const p = entry;
+        const graf = p["grafID"];
+        if (typeof graf !== "number" || !Number.isInteger(graf) || graf < 0) {
+            throw new ManifestError(`manifest ${id}: tilePacks grafID must be a non-negative integer, got ${String(graf)}`);
+        }
+        if (p["engine"] !== undefined && !TILE_ENGINES.includes(p["engine"])) {
+            throw new ManifestError(`manifest ${id}: tilePacks engine must be one of ${TILE_ENGINES.join(", ")}, got ${String(p["engine"])}`);
+        }
+        if (p["menuname"] !== undefined && typeof p["menuname"] !== "string") {
+            throw new ManifestError(`manifest ${id}: tilePacks menuname must be a string`);
+        }
+        if (p["path"] === undefined)
+            continue;
+        const path = p["path"];
+        if (typeof path !== "string") {
+            throw new ManifestError(`manifest ${id}: tilePacks path must be a string`);
+        }
+        if (/^([a-z][a-z0-9+.-]*:)?\//iu.test(path) || path.startsWith("\\")) {
+            throw new ManifestError(`manifest ${id}: tilePacks path "${path}" must be relative to the mod folder, not a site or absolute path`);
+        }
+        if (path.split(/[/\\]/u).includes("..")) {
+            throw new ManifestError(`manifest ${id}: tilePacks path "${path}" must stay inside the mod folder`);
+        }
+    }
+}
+/** Validate an optional array-of-pack-ids field (loadAfter/loadBefore). */
+function validateIdList(value, id, field) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value)) {
+        throw new ManifestError(`manifest ${id}: ${field} must be an array`);
+    }
+    for (const entry of value) {
+        if (typeof entry !== "string" || !ID_RE.test(entry)) {
+            throw new ManifestError(`manifest ${id}: bad ${field} id ${String(entry)}`);
+        }
+    }
+}
+/**
+ * Validate the optional `facets` list against the pack's `shape`.
+ *
+ * `shape` must appear in `facets`. Without that rule the two fields could
+ * disagree - `{shape: "content", facets: ["plugin"]}` - and every consumer would
+ * have to decide which one it trusted, which is how the exclusive `shape`
+ * produced a folder layout the documentation promised and the loader refused.
+ * One source of truth, checked once, at the edge.
+ */
+function validateFacets(value, id, shape) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new ManifestError(`manifest ${id}: facets must be a non-empty array of ${PACK_SHAPES.join(", ")}`);
+    }
+    const seen = new Set();
+    for (const entry of value) {
+        if (typeof entry !== "string" || !PACK_SHAPES.includes(entry)) {
+            throw new ManifestError(`manifest ${id}: facet must be one of ${PACK_SHAPES.join(", ")}, got ${String(entry)}`);
+        }
+        if (seen.has(entry)) {
+            throw new ManifestError(`manifest ${id}: facet "${entry}" is listed twice`);
+        }
+        seen.add(entry);
+    }
+    if (!seen.has(shape)) {
+        throw new ManifestError(`manifest ${id}: facets ${JSON.stringify(value)} must include its shape "${shape}"`);
+    }
+}
+/**
+ * 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 function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/** Build a namespaced record reference. */
+export function packRef(packId, name) {
+    return `${packId}:${slugify(name)}`;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/patch.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Field-level patch composition (MOD_LIFECYCLE section 3, P7 phase 3).
+ *
+ * The coarse `patches` path in compose.ts deep-merges whole record bodies:
+ * simple, but two mods touching one record always look like they collide even
+ * when they change unrelated fields. The field-level model fixes that. A patch
+ * is an ordered list of field operations - `set`, `merge`, `addFlag`,
+ * `removeFlag`, `add`, `mul` - each addressing a dot-path into the record.
+ * Patches from different packs apply in load order; two packs that touch
+ * DIFFERENT fields compose with zero conflict, and only a genuine same-field
+ * collision is reported (then load order decides who wins, and the app says
+ * so). This is the finer lever the ratified design calls for, and it is the
+ * data the conflict report (phase 6) reads.
+ *
+ * Pure and deterministic: given a base record and an ordered patch list the
+ * output and the conflict set are fully determined.
+ */
+import type { JsonRecord, JsonValue } from "./compose.js";
+export declare class PatchError extends Error {
+}
+/** One field operation, addressing `path` (a dot-path into the record). */
+export type FieldOp = 
+/** Replace the value at path outright. */
+{
+    op: "set";
+    path: string;
+    value: JsonValue;
+}
+/** Deep-merge an object value into the object at path (compose.mergePatch). */
+ | {
+    op: "merge";
+    path: string;
+    value: JsonRecord;
+}
+/** Ensure `flag` is present in the string array at path (set union). */
+ | {
+    op: "addFlag";
+    path: string;
+    flag: string;
+}
+/** Remove `flag` from the string array at path, if present. */
+ | {
+    op: "removeFlag";
+    path: string;
+    flag: string;
+}
+/** Add a number to the numeric value at path (missing = 0). */
+ | {
+    op: "add";
+    path: string;
+    value: number;
+}
+/** Multiply the numeric value at path (missing = 0). */
+ | {
+    op: "mul";
+    path: string;
+    value: number;
+};
+/** An ordered list of field operations - one pack's patch of one record. */
+export type FieldPatch = FieldOp[];
+/** Apply one field patch to a record, returning a new record (pure). */
+export declare function applyFieldPatch(record: JsonRecord, ops: FieldPatch): JsonRecord;
+/** One same-field collision between two or more packs. */
+export interface FieldConflict {
+    /** The dot-path both packs wrote. */
+    path: string;
+    /** The packs that wrote it, in load order (last one wins the value). */
+    owners: string[];
+}
+/** The result of composing several packs' patches over one base record. */
+export interface ComposedPatch {
+    /** The merged record (all patches applied in load order). */
+    value: JsonRecord;
+    /** Same-field collisions, empty when every pack touched distinct fields. */
+    conflicts: FieldConflict[];
+}
+/**
+ * Compose several packs' field patches over a base record, applying them in
+ * the given (load) order and reporting same-field collisions. A field is a
+ * conflict when two or more distinct packs write it with an order-dependent op
+ * (set / merge / add / mul); pure flag ops (addFlag / removeFlag) compose as
+ * set operations and never conflict on their own.
+ */
+export declare function composeFieldPatches(base: JsonRecord, patches: ReadonlyArray<{
+    owner: string;
+    ops: FieldPatch;
+}>): ComposedPatch;
+/** The set of dot-paths a patch writes (for external conflict analysis). */
+export declare function touchedFields(ops: FieldPatch): Set<string>;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1D,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,2EAA2E;AAC3E,MAAM,MAAM,OAAO;AACjB,0CAA0C;AACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE;AAC/C,+EAA+E;GAC7E;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE;AAClD,wEAAwE;GACtE;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC/C,+DAA+D;GAC7D;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAClD,+DAA+D;GAC7D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC5C,wDAAwD;GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,OAAO,EAAE,CAAC;AA2FnC,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU,CAI/E;AAgED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC;IAClB,4EAA4E;IAC5E,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CAAC,GACzD,aAAa,CAwBf;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAI1D"}

package/dist/patch.js

@@ -0,0 +1,195 @@
+/**
+ * Field-level patch composition (MOD_LIFECYCLE section 3, P7 phase 3).
+ *
+ * The coarse `patches` path in compose.ts deep-merges whole record bodies:
+ * simple, but two mods touching one record always look like they collide even
+ * when they change unrelated fields. The field-level model fixes that. A patch
+ * is an ordered list of field operations - `set`, `merge`, `addFlag`,
+ * `removeFlag`, `add`, `mul` - each addressing a dot-path into the record.
+ * Patches from different packs apply in load order; two packs that touch
+ * DIFFERENT fields compose with zero conflict, and only a genuine same-field
+ * collision is reported (then load order decides who wins, and the app says
+ * so). This is the finer lever the ratified design calls for, and it is the
+ * data the conflict report (phase 6) reads.
+ *
+ * Pure and deterministic: given a base record and an ordered patch list the
+ * output and the conflict set are fully determined.
+ */
+import { mergePatch } from "./compose.js";
+export class PatchError extends Error {
+}
+/** The flag ops compose as set operations; the rest are order-dependent. */
+function isCommutative(op) {
+    return op === "addFlag" || op === "removeFlag";
+}
+/* ------------------------------------------------------------------ *
+ * Dot-path access.
+ *
+ * A path segment that is a run of digits indexes an ARRAY ("level-max.0.value").
+ * Array traversal is not a convenience: a great deal of upstream gamedata is
+ * label/value lists rather than objects - every section of constants.json, a
+ * store's owner list, a body's slot list, the visuals flicker table - so without
+ * it a fieldPatch into those files could not address anything. Worse, the first
+ * version of setPath treated an existing array as an unusable intermediate and
+ * REPLACED it with a fresh object, which turned `set level-max.0.value` into
+ * silent destruction of the whole list. Objects still win when the container is
+ * an object, so a literal "0" key is unaffected.
+ * ------------------------------------------------------------------ */
+/** A path segment as an array index, or null when it is a plain object key. */
+function arrayIndex(part) {
+    return /^(?:0|[1-9][0-9]*)$/.test(part) ? Number(part) : null;
+}
+/** One step down a path, through either an object key or an array index. */
+function childOf(cur, part) {
+    if (Array.isArray(cur)) {
+        const at = arrayIndex(part);
+        return at === null ? undefined : cur[at];
+    }
+    if (typeof cur === "object" && cur !== null)
+        return cur[part];
+    return undefined;
+}
+function getPath(record, path) {
+    let cur = record;
+    for (const part of path.split(".")) {
+        cur = childOf(cur, part);
+        if (cur === undefined)
+            return undefined;
+    }
+    return cur;
+}
+/** Write one slot of an object or an array container. */
+function assignAt(container, part, value) {
+    if (Array.isArray(container)) {
+        const at = arrayIndex(part);
+        if (at === null) {
+            throw new PatchError(`patch: "${part}" is not an array index, and the value at that point is an array`);
+        }
+        container[at] = value;
+        return;
+    }
+    container[part] = value;
+}
+/**
+ * Set a value at a dot-path, creating intermediate containers as needed. A
+ * created container is an array when the next segment is an index and an object
+ * otherwise, so `set a.0.b` on a record with no `a` builds `{a:[{b:...}]}`.
+ */
+function setPath(record, path, value) {
+    const parts = path.split(".");
+    let cur = record;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        const next = childOf(cur, part);
+        if (typeof next !== "object" || next === null) {
+            const fresh = arrayIndex(parts[i + 1]) === null ? {} : [];
+            assignAt(cur, part, fresh);
+            cur = fresh;
+        }
+        else {
+            cur = next;
+        }
+    }
+    assignAt(cur, parts[parts.length - 1], value);
+}
+/* ------------------------------------------------------------------ *
+ * Applying a single patch.
+ * ------------------------------------------------------------------ */
+/** Apply one field patch to a record, returning a new record (pure). */
+export function applyFieldPatch(record, ops) {
+    const out = structuredJsonClone(record);
+    for (const op of ops)
+        applyOp(out, op);
+    return out;
+}
+function applyOp(record, op) {
+    switch (op.op) {
+        case "set":
+            setPath(record, op.path, op.value);
+            return;
+        case "merge": {
+            const cur = getPath(record, op.path);
+            const base = typeof cur === "object" && cur !== null && !Array.isArray(cur)
+                ? cur
+                : {};
+            setPath(record, op.path, mergePatch(base, op.value));
+            return;
+        }
+        case "addFlag": {
+            const list = asFlagList(getPath(record, op.path), op.path);
+            if (!list.includes(op.flag))
+                list.push(op.flag);
+            setPath(record, op.path, list);
+            return;
+        }
+        case "removeFlag": {
+            const list = asFlagList(getPath(record, op.path), op.path);
+            setPath(record, op.path, list.filter((f) => f !== op.flag));
+            return;
+        }
+        case "add": {
+            const cur = getPath(record, op.path);
+            const n = typeof cur === "number" ? cur : 0;
+            setPath(record, op.path, n + op.value);
+            return;
+        }
+        case "mul": {
+            const cur = getPath(record, op.path);
+            const n = typeof cur === "number" ? cur : 0;
+            setPath(record, op.path, n * op.value);
+            return;
+        }
+    }
+}
+/** A flag field must be a string array (or absent, treated as empty). */
+function asFlagList(value, path) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.some((v) => typeof v !== "string")) {
+        throw new PatchError(`patch: field ${path} is not a flag list (string[])`);
+    }
+    return [...value];
+}
+/** A structural JSON clone (no Date.now/Math.random dependence). */
+function structuredJsonClone(record) {
+    return JSON.parse(JSON.stringify(record));
+}
+/**
+ * Compose several packs' field patches over a base record, applying them in
+ * the given (load) order and reporting same-field collisions. A field is a
+ * conflict when two or more distinct packs write it with an order-dependent op
+ * (set / merge / add / mul); pure flag ops (addFlag / removeFlag) compose as
+ * set operations and never conflict on their own.
+ */
+export function composeFieldPatches(base, patches) {
+    let value = structuredJsonClone(base);
+    /* path -> the owners who wrote it, and whether any write was order-dependent. */
+    const writers = new Map();
+    for (const { owner, ops } of patches) {
+        value = applyFieldPatch(value, ops);
+        for (const op of ops) {
+            const entry = writers.get(op.path) ?? { owners: [], ordered: false };
+            if (entry.owners[entry.owners.length - 1] !== owner) {
+                entry.owners.push(owner);
+            }
+            if (!isCommutative(op.op))
+                entry.ordered = true;
+            writers.set(op.path, entry);
+        }
+    }
+    const conflicts = [];
+    for (const [path, entry] of writers) {
+        if (entry.ordered && entry.owners.length > 1) {
+            conflicts.push({ path, owners: entry.owners });
+        }
+    }
+    return { value, conflicts };
+}
+/** The set of dot-paths a patch writes (for external conflict analysis). */
+export function touchedFields(ops) {
+    const out = new Set();
+    for (const op of ops)
+        out.add(op.path);
+    return out;
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

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