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

package/dist/conflicts.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The pre-launch conflict report (MOD_LIFECYCLE section 3, P7 phase 6).
+ *
+ * Before a session starts, the app shows the player every record touched
+ * by more than one pack: which fields each pack wrote, who wins, and a
+ * plain-language line for anything that actually collides. Nothing is
+ * silent, nothing is a surprise at runtime.
+ *
+ * Two kinds of "touch" feed the report:
+ *  - Field patches (patch.ts) and the coarse whole-record `patches` merge
+ *    (compose.ts) both write specific fields. A record is contested when
+ *    two or more distinct packs write it this way; a field is a collision
+ *    only when two or more of those packs write the SAME field with an
+ *    order-dependent op (composeFieldPatches decides that - reused here,
+ *    not reimplemented).
+ *  - A whole-record `replaces` or `removes` is always worth reporting,
+ *    regardless of how many other packs touched the record: it overrides
+ *    whatever the owning pack (and any patches) established, and that is
+ *    exactly the kind of surprise this report exists to surface.
+ *
+ * Pure and deterministic: given the same (already load-ordered) pack list,
+ * the report is always the same value.
+ */
+import type { PackContent } from "./compose.js";
+import type { FieldConflict } from "./patch.js";
+/** One field a contested record's contributing packs wrote. */
+export interface FieldTouch {
+    /** The dot-path written (as used by FieldOp / touchedFields). */
+    path: string;
+    /** Packs that wrote this field, in load order. */
+    owners: string[];
+    /** The pack whose write wins: the last one in load order. */
+    winner: string;
+}
+/** A later pack overriding a record's entire body outright. */
+export interface RecordOverride {
+    /** The pack that performed the override (last one, if more than one did). */
+    pack: string;
+    kind: "replace" | "remove";
+}
+/** One contested record: touched by more than one pack. */
+export interface RecordConflict {
+    /** The record reference, e.g. "core:kobold". */
+    ref: string;
+    /** The file the record lives in, e.g. "monster". */
+    file: string;
+    /**
+     * Every pack that contributed a field patch, coarse patch, replace, or
+     * remove to this record, in load order. Does not include the owning
+     * pack unless the owner is itself one of those contributors.
+     */
+    contributingPacks: string[];
+    /**
+     * Every field any contributing pack wrote (via fieldPatches, or a
+     * top-level key of a coarse `patches` body), with who wrote it and who
+     * wins. Empty when the record was only touched by a whole-record
+     * replace/remove.
+     */
+    fields: FieldTouch[];
+    /** Same-field collisions among `fields` - empty when none collided. */
+    collisions: FieldConflict[];
+    /** Present when a pack replaced or removed the record outright. */
+    override?: RecordOverride;
+    /** One plain-language line per collision and per override. */
+    humanLines: string[];
+}
+/** The full pre-launch conflict report: contested records only. */
+export interface ConflictReport {
+    records: RecordConflict[];
+}
+/**
+ * Compute the pre-launch conflict report over an already load-ordered pack
+ * list (see resolveLoadOrder). Only contested records get an entry:
+ * additive changes - distinct records, or a single pack touching a record -
+ * produce none.
+ */
+export declare function computeConflictReport(packs: readonly PackContent[]): ConflictReport;
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflicts.d.ts","sourceRoot":"","sources":["../src/conflicts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAgC,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,YAAY,CAAC;AAG5D,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,uEAAuE;IACvE,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAmFD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,cAAc,CA6EnF"}

package/dist/conflicts.js

@@ -0,0 +1,160 @@
+/**
+ * The pre-launch conflict report (MOD_LIFECYCLE section 3, P7 phase 6).
+ *
+ * Before a session starts, the app shows the player every record touched
+ * by more than one pack: which fields each pack wrote, who wins, and a
+ * plain-language line for anything that actually collides. Nothing is
+ * silent, nothing is a surprise at runtime.
+ *
+ * Two kinds of "touch" feed the report:
+ *  - Field patches (patch.ts) and the coarse whole-record `patches` merge
+ *    (compose.ts) both write specific fields. A record is contested when
+ *    two or more distinct packs write it this way; a field is a collision
+ *    only when two or more of those packs write the SAME field with an
+ *    order-dependent op (composeFieldPatches decides that - reused here,
+ *    not reimplemented).
+ *  - A whole-record `replaces` or `removes` is always worth reporting,
+ *    regardless of how many other packs touched the record: it overrides
+ *    whatever the owning pack (and any patches) established, and that is
+ *    exactly the kind of surprise this report exists to surface.
+ *
+ * Pure and deterministic: given the same (already load-ordered) pack list,
+ * the report is always the same value.
+ */
+import { composeFieldPatches, touchedFields } from "./patch.js";
+/** The pack id a ref's "<owner>:<slug>" prefix names. */
+function ownerOf(ref) {
+    const at = ref.indexOf(":");
+    return at === -1 ? "" : ref.slice(0, at);
+}
+/**
+ * Turn a coarse whole-record patch body into field ops, one per top-level
+ * key, so it runs through the same field-conflict engine as fieldPatches:
+ * nested objects merge (mirroring mergePatch), everything else - including
+ * an explicit null delete - is a straight `set` for reporting purposes.
+ */
+function coarsePatchOps(body) {
+    const ops = [];
+    for (const [key, value] of Object.entries(body)) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            ops.push({ op: "merge", path: key, value });
+        }
+        else {
+            ops.push({ op: "set", path: key, value });
+        }
+    }
+    return ops;
+}
+function entryFor(byFile, file, ref) {
+    let table = byFile.get(file);
+    if (!table) {
+        table = new Map();
+        byFile.set(file, table);
+    }
+    let entry = table.get(ref);
+    if (!entry) {
+        entry = { fieldContribs: [], modifiers: new Set(), overrides: [] };
+        table.set(ref, entry);
+    }
+    return entry;
+}
+/** For every field any contributing pack wrote: who wrote it, who wins. */
+function fieldBreakdown(contribs) {
+    const writers = new Map();
+    for (const { owner, ops } of contribs) {
+        for (const path of touchedFields(ops)) {
+            const owners = writers.get(path) ?? [];
+            if (owners[owners.length - 1] !== owner)
+                owners.push(owner);
+            writers.set(path, owners);
+        }
+    }
+    const out = [];
+    for (const [path, owners] of writers) {
+        out.push({ path, owners, winner: owners[owners.length - 1] });
+    }
+    return out;
+}
+/** Two, or several, pack names joined for a human sentence. */
+function joinOwners(owners) {
+    if (owners.length <= 1)
+        return owners.join("");
+    if (owners.length === 2)
+        return `${owners[0]} and ${owners[1]}`;
+    return `${owners.slice(0, -1).join(", ")} and ${owners[owners.length - 1]}`;
+}
+/** The record name half of a ref, for readable human lines ("core:kobold" -> "kobold"). */
+function refName(ref) {
+    const at = ref.indexOf(":");
+    return at === -1 ? ref : ref.slice(at + 1);
+}
+/**
+ * Compute the pre-launch conflict report over an already load-ordered pack
+ * list (see resolveLoadOrder). Only contested records get an entry:
+ * additive changes - distinct records, or a single pack touching a record -
+ * produce none.
+ */
+export function computeConflictReport(packs) {
+    const byFile = new Map();
+    for (const pack of packs) {
+        const pid = pack.manifest.id;
+        for (const [file, contrib] of Object.entries(pack.files)) {
+            for (const [ref, ops] of Object.entries(contrib.fieldPatches ?? {})) {
+                const entry = entryFor(byFile, file, ref);
+                entry.fieldContribs.push({ owner: pid, ops });
+                entry.modifiers.add(pid);
+            }
+            for (const [ref, body] of Object.entries(contrib.patches ?? {})) {
+                const entry = entryFor(byFile, file, ref);
+                entry.fieldContribs.push({ owner: pid, ops: coarsePatchOps(body) });
+                entry.modifiers.add(pid);
+            }
+            for (const [ref] of Object.entries(contrib.replaces ?? {})) {
+                const entry = entryFor(byFile, file, ref);
+                entry.modifiers.add(pid);
+                entry.overrides.push({ pack: pid, kind: "replace" });
+            }
+            for (const ref of contrib.removes ?? []) {
+                const entry = entryFor(byFile, file, ref);
+                entry.modifiers.add(pid);
+                entry.overrides.push({ pack: pid, kind: "remove" });
+            }
+        }
+    }
+    const records = [];
+    for (const [file, table] of byFile) {
+        for (const [ref, entry] of table) {
+            const hasOverride = entry.overrides.length > 0;
+            if (entry.modifiers.size < 2 && !hasOverride)
+                continue; // additive: not contested
+            const { conflicts } = composeFieldPatches({}, entry.fieldContribs);
+            const fields = fieldBreakdown(entry.fieldContribs);
+            const humanLines = [];
+            for (const conflict of conflicts) {
+                const winner = conflict.owners[conflict.owners.length - 1];
+                const verb = conflict.owners.length === 2 ? "both set" : "all set";
+                humanLines.push(`${joinOwners(conflict.owners)} ${verb} ${refName(ref)}.${conflict.path}; ${winner} wins - drag to reorder.`);
+            }
+            let override;
+            if (hasOverride) {
+                const last = entry.overrides[entry.overrides.length - 1];
+                override = { pack: last.pack, kind: last.kind };
+                const verb = last.kind === "replace" ? "replaces" : "removes";
+                humanLines.push(`${last.pack} ${verb} ${refName(ref)} outright, overriding ${ownerOf(ref)}'s original.`);
+            }
+            const record = {
+                ref,
+                file,
+                contributingPacks: [...entry.modifiers],
+                fields,
+                collisions: conflicts,
+                humanLines,
+            };
+            if (override)
+                record.override = override;
+            records.push(record);
+        }
+    }
+    return { records };
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/conflicts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @rpgm-tools/neo-angband-mod-sdk - schemas and tooling for the mod ecosystem.
+ *
+ * Three pack shapes, one loading pipeline (see docs/MODS.md):
+ * - content packs: schema-validated declarative JSON (safe by construction)
+ * - tile packs: Linoleum-style manifests with individual images and
+ *   exact named targets, honest glyph fallback for uncovered targets
+ * - scripted plugins: capability-scoped sandboxed scripts (escape hatch)
+ *
+ * This package holds the pack-agnostic machinery: manifests, the
+ * deterministic load-order resolver, and the record composition engine
+ * (add/patch/replace/remove with ownership rules and provenance). The
+ * base game composes through this exact pipeline as pack zero.
+ */
+export { hasFacet, ManifestError, PACK_SHAPES, packFacets, packRef, slugify, validateManifest, } from "./manifest.js";
+export type { Capability, PackManifest, PackRef, PackRule, PackShape, PackTilePack, } from "./manifest.js";
+export { ResolveError, resolveLoadOrder } from "./resolve.js";
+export { satisfies, SemverError } from "./semver.js";
+export { ComposeError, composePacks, mergePatch } from "./compose.js";
+export { composeContentPacks } from "./loader.js";
+export type { ComposedContent, LoadedPack } from "./loader.js";
+export { KEYED_RECORD_FILES, keyDescription, keySpecFor, RECORD_KEY_SPECS, recordKey, } from "./record-key.js";
+export type { RecordKeySpec } from "./record-key.js";
+export type { ComposedRecord, FileContribution, JsonRecord, JsonValue, PackContent, } from "./compose.js";
+export { applyFieldPatch, composeFieldPatches, PatchError, touchedFields, } from "./patch.js";
+export type { ComposedPatch, FieldConflict, FieldOp, FieldPatch, } from "./patch.js";
+export { computeConflictReport } from "./conflicts.js";
+export type { ConflictReport, FieldTouch, RecordConflict, RecordOverride, } from "./conflicts.js";
+export { CapabilityError, CapabilitySet, parseCapability } from "./capabilities.js";
+export type { ParsedCapability } from "./capabilities.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,OAAO,EACP,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,aAAa,EACb,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @rpgm-tools/neo-angband-mod-sdk - schemas and tooling for the mod ecosystem.
+ *
+ * Three pack shapes, one loading pipeline (see docs/MODS.md):
+ * - content packs: schema-validated declarative JSON (safe by construction)
+ * - tile packs: Linoleum-style manifests with individual images and
+ *   exact named targets, honest glyph fallback for uncovered targets
+ * - scripted plugins: capability-scoped sandboxed scripts (escape hatch)
+ *
+ * This package holds the pack-agnostic machinery: manifests, the
+ * deterministic load-order resolver, and the record composition engine
+ * (add/patch/replace/remove with ownership rules and provenance). The
+ * base game composes through this exact pipeline as pack zero.
+ */
+export { hasFacet, ManifestError, PACK_SHAPES, packFacets, packRef, slugify, validateManifest, } from "./manifest.js";
+export { ResolveError, resolveLoadOrder } from "./resolve.js";
+export { satisfies, SemverError } from "./semver.js";
+export { ComposeError, composePacks, mergePatch } from "./compose.js";
+export { composeContentPacks } from "./loader.js";
+export { KEYED_RECORD_FILES, keyDescription, keySpecFor, RECORD_KEY_SPECS, recordKey, } from "./record-key.js";
+export { applyFieldPatch, composeFieldPatches, PatchError, touchedFields, } from "./patch.js";
+export { computeConflictReport } from "./conflicts.js";
+export { CapabilityError, CapabilitySet, parseCapability } from "./capabilities.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,OAAO,EACP,gBAAgB,GACjB,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,SAAS,GACV,MAAM,iBAAiB,CAAC;AASzB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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 type { PackManifest } from "./manifest.js";
+import type { FileContribution } from "./compose.js";
+/**
+ * One pack as the host loaded it: its manifest plus its per-file contributions.
+ * The base game is the degenerate case where every file is records-only.
+ */
+export interface LoadedPack {
+    manifest: PackManifest;
+    /** fileName -> that file's contribution (records / patches / ...). */
+    files: Record<string, FileContribution>;
+}
+/** The merged content: per-file record arrays, in deterministic order. */
+export interface ComposedContent {
+    /** fileName -> composed record array. */
+    records: Record<string, unknown[]>;
+    /** Files merged per-record through the full FileContribution model. */
+    composedFiles: string[];
+    /** Files whose `records` pass through last-wins (nameless or name-colliding). */
+    passthroughFiles: string[];
+    /**
+     * Every mod-facing operation that could NOT be honoured, in one line each,
+     * naming the pack, the file, the op and the record. Empty for a clean set.
+     * A host shows these next to the pack-reading problems it already collects.
+     */
+    problems: string[];
+}
+/**
+ * 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 declare function composeContentPacks(packs: readonly LoadedPack[]): ComposedContent;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,cAAc,CAAC;AAI9E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACzC;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,uEAAuE;IACvE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoND;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,eAAe,CA0FjB"}