@rpgm-tools/neo-angband-core 0.18.0 → 0.19.0

package/dist/obj/randart-vectors.js

@@ -0,0 +1,311 @@
+/**
+ * Golden vectors for RANDOM ARTIFACT construction: MOD_REACH gap 14.
+ *
+ * WHY THIS EXISTS. Four closed `switch` statements build every random artifact
+ * in the game, and they are the largest dispatch left in the tree:
+ *
+ *   - `addAbilityAux`  (randart-build.ts, keyed on the `ART_IDX` ability, 87
+ *     cases) - what "add this ability" actually does to the artifact.
+ *   - `artifactPrep`   (randart-build.ts, keyed on the base item's tval, 15) -
+ *     the starting to-hit / to-dam / AC an item class is given.
+ *   - the item-class census (randart-data.ts, keyed on tval, 14) - which
+ *     `data.*Total` bucket a standard artifact counts toward, which feeds the
+ *     frequency table the design loop spends.
+ *   - the redundancy test (randart-build.ts, keyed on the `EFPROP` kind, 9) -
+ *     whether an activation only duplicates something the artifact already has.
+ *
+ * Converting them into keyed registries so a mod can define a NEW ability, or a
+ * new item class, is a refactor of the most RNG-dense code in the port. What has
+ * to be proven is not "the randart tests still pass" but "the same seed still
+ * produces the same artifacts, drawn in the same order".
+ *
+ * WHY THE EXISTING TESTS ARE NOT THAT. `randart.test.ts` asserts do_randart is
+ * deterministic by running it TWICE IN ONE PROCESS and comparing. That is a real
+ * property and it catches real bugs - but it cannot fail across a refactor,
+ * because a change that moves every artifact moves both runs identically.
+ * Agreement is symmetric; a fixture recorded on disk is not.
+ *
+ * THE PROBE IS THE POINT, AND IT NEEDED A SEAM TO EXIST. `doRandart` owns its
+ * Rng internally, so the whole-set family below has no probe: what defends it is
+ * that all ~130 artifacts come off ONE stream in sequence, so a changed draw
+ * count anywhere but after the final draw moves everything downstream of it. The
+ * blind spot that leaves - a draw added at the very end - is closed by the
+ * per-arm families, which drive `artifactPrep` and `addAbilityAux` with an Rng
+ * this module owns and probe it afterwards. That is also what makes those two
+ * families per-ARM coverage rather than aggregate: a vector per `ART_IDX` fails
+ * naming the ability that moved.
+ *
+ * Fixtures are INJECTED rather than loaded here, so this module pulls in no
+ * node:fs and no content pack, and can be imported from anywhere.
+ *
+ * Regenerate with `node packages/core/scripts/gen-randart-vectors.mjs` - which
+ * OVERWRITES the evidence, so only do it when artifact generation is
+ * deliberately changing, and say so in the commit.
+ */
+import { FLAG_START, NO_FLAG } from "../bitflag.js";
+import { ART_IDX, TV } from "../generated/index.js";
+import { Rng } from "../rng.js";
+import { addAbilityAux, artifactPrep, getBaseItem } from "./randart-build.js";
+import { collectArtifactData } from "./randart-data.js";
+import { cloneArtifact, doRandart } from "./randart.js";
+/** The seeds the whole-set family runs. Three, because a set is expensive. */
+export const RANDART_VECTOR_SEEDS = [1, 4242, 999999];
+/** The seeds the cheap per-arm families run, on both sides of a coin flip. */
+export const RANDART_ARM_SEEDS = [7, 31337];
+/**
+ * The target powers the ability family runs at, and the second one is not
+ * decoration. `ART_IDX.WEAPON_AGGR` / `NONWEAPON_AGGR` only grant AGGRAVATE
+ * when `targetPower > AGGR_POWER` (300, obj-randart.h L47), so a family run at
+ * one low power records those two arms doing NOTHING - indistinguishable from
+ * the `*_SUPER` frequency-table indices that genuinely have no case. The first
+ * recording of these vectors had exactly that hole. This is the same failure
+ * the glyph work found the expensive way: a scenario grid that never reaches
+ * the arm it was written to defend.
+ */
+export const RANDART_TARGET_POWERS = [100, 500];
+/**
+ * Every tval `artifactPrep`'s switch names, plus RING, AMULET and LIGHT -
+ * which it does NOT name and which therefore take its default arm. A vector
+ * that only covers the listed cases cannot tell a missing default from a
+ * present one.
+ */
+const PREP_TVALS = [
+    ["BOW", TV.BOW],
+    ["DIGGING", TV.DIGGING],
+    ["HAFTED", TV.HAFTED],
+    ["SWORD", TV.SWORD],
+    ["POLEARM", TV.POLEARM],
+    ["BOOTS", TV.BOOTS],
+    ["GLOVES", TV.GLOVES],
+    ["HELM", TV.HELM],
+    ["CROWN", TV.CROWN],
+    ["SHIELD", TV.SHIELD],
+    ["CLOAK", TV.CLOAK],
+    ["SOFT_ARMOR", TV.SOFT_ARMOR],
+    ["HARD_ARMOR", TV.HARD_ARMOR],
+    ["DRAG_ARMOR", TV.DRAG_ARMOR],
+    ["RING", TV.RING],
+    ["AMULET", TV.AMULET],
+    ["LIGHT", TV.LIGHT],
+];
+/** ART_IDX names in index order, so a vector names the ability that moved. */
+function abilityNames() {
+    const byIndex = [];
+    for (const [name, value] of Object.entries(ART_IDX)) {
+        if (typeof value !== "number" || name === "MAX")
+            continue;
+        byIndex[value] = name;
+    }
+    return byIndex;
+}
+/**
+ * The flags actually SET, as a list of indices.
+ *
+ * `FlagSet` has no toString and the default one produces "[object Object]" - a
+ * field that is identical for every artifact in the file and therefore cannot
+ * disagree. That is not hypothetical: the first recording of these vectors
+ * carried exactly that string in all 644 rows, which would have let an ability
+ * stop granting its flag without moving a single vector.
+ */
+function flagList(set) {
+    const on = [];
+    for (let f = set.next(FLAG_START); f !== NO_FLAG; f = set.next(f + 1)) {
+        on.push(f);
+    }
+    return on;
+}
+/**
+ * Everything observable about one artifact. Deliberately EVERY field of the
+ * struct rather than the handful `randart.test.ts`'s fingerprint uses: an
+ * ability that stops granting a curse, a brand or an activation would otherwise
+ * move nothing this file can see.
+ */
+function fingerprint(a) {
+    if (!a)
+        return "null";
+    return JSON.stringify({
+        name: a.name,
+        tval: a.tval,
+        sval: a.sval,
+        toH: a.toH,
+        toD: a.toD,
+        toA: a.toA,
+        ac: a.ac,
+        dd: a.dd,
+        ds: a.ds,
+        weight: a.weight,
+        cost: a.cost,
+        level: a.level,
+        alloc: [a.allocProb, a.allocMin, a.allocMax],
+        flags: flagList(a.flags),
+        mods: a.modifiers,
+        el: a.elInfo.map((e) => [e.resLevel, e.flags]),
+        brands: a.brands ? a.brands.map((b) => (b ? 1 : 0)) : null,
+        slays: a.slays ? a.slays.map((s) => (s ? 1 : 0)) : null,
+        curses: a.curses,
+        act: a.activation ? a.activation.name : null,
+        altMsg: a.altMsg,
+        time: [a.time.base, a.time.dice, a.time.sides, a.time.mBonus],
+    });
+}
+/* ------------------------------------------------------------------ *
+ * Family 1: whole sets, end to end.
+ * ------------------------------------------------------------------ */
+/** do_randart at each seed, one vector per generated artifact. */
+export function computeSetVectors(fixtures) {
+    const constants = fixtures.constants();
+    const out = [];
+    for (const seed of RANDART_VECTOR_SEEDS) {
+        /* A fresh registry per seed: do_randart is asserted elsewhere not to mutate
+         * the standard artifacts, and this file must not be the thing that would
+         * hide it if that stopped being true. */
+        const arts = doRandart(fixtures.registry(), constants, seed, false);
+        arts.forEach((art, i) => {
+            out.push({
+                kind: "set",
+                subject: art ? art.name : `#${String(i)}`,
+                scenario: `seed=${String(seed)} aidx=${String(i)}`,
+                out: fingerprint(art),
+            });
+        });
+    }
+    return out;
+}
+/* ------------------------------------------------------------------ *
+ * Family 2 and 3: the per-arm families, with a probe.
+ * ------------------------------------------------------------------ */
+/**
+ * A prepped artifact to start an arm from. Cloned from a standard artifact,
+ * which is the same object shape `doRandart`'s design loop mutates - derived
+ * from the real producer rather than hand-built, so the vector cannot pass
+ * against a struct production never sees.
+ */
+function seedArtifact(reg) {
+    const src = reg.artifacts.find((a) => a !== null);
+    if (!src)
+        throw new Error("randart-vectors: the pack has no artifacts");
+    return cloneArtifact(src);
+}
+/** artifact_prep per item class, with the RNG position afterwards. */
+export function computePrepVectors(fixtures) {
+    const reg = fixtures.registry();
+    const constants = fixtures.constants();
+    const data = collectArtifactData(reg, constants, reg.artifacts, new Rng(11));
+    const out = [];
+    for (const [name, tval] of PREP_TVALS) {
+        for (const seed of RANDART_ARM_SEEDS) {
+            const rng = new Rng(seed);
+            const art = seedArtifact(reg);
+            const kind = getBaseItem(reg, tval, rng);
+            artifactPrep(reg, art, kind, data, rng);
+            out.push({
+                kind: "prep",
+                subject: name,
+                scenario: `tval=${name} seed=${String(seed)}`,
+                out: fingerprint(art),
+                probe: rng.randint0(1 << 24),
+            });
+        }
+    }
+    return out;
+}
+/** add_ability_aux per ART_IDX, with the RNG position afterwards. */
+export function computeAbilityVectors(fixtures) {
+    const reg = fixtures.registry();
+    const constants = fixtures.constants();
+    const data = collectArtifactData(reg, constants, reg.artifacts, new Rng(11));
+    const names = abilityNames();
+    const out = [];
+    for (let r = 0; r < names.length; r++) {
+        const name = names[r] ?? `ART_IDX_${String(r)}`;
+        for (const seed of RANDART_ARM_SEEDS) {
+            for (const power of RANDART_TARGET_POWERS) {
+                /* A SWORD base, because most abilities are reachable on a weapon and
+                 * the ones that are not still have to be recorded doing nothing. */
+                const rng = new Rng(seed);
+                const art = seedArtifact(reg);
+                artifactPrep(reg, art, getBaseItem(reg, TV.SWORD, rng), data, rng);
+                /* Re-seed AFTER the prep so the probe measures this ability's draws
+                 * alone, not the base item's. */
+                const abilityRng = new Rng(seed + 1);
+                addAbilityAux(reg, art, r, power, data, abilityRng);
+                out.push({
+                    kind: "ability",
+                    subject: name,
+                    scenario: `r=${String(r)} seed=${String(seed)} power=${String(power)}`,
+                    out: fingerprint(art),
+                    probe: abilityRng.randint0(1 << 24),
+                });
+            }
+        }
+    }
+    return out;
+}
+/* ------------------------------------------------------------------ *
+ * Family 4: the item-class census the frequency table rests on.
+ * ------------------------------------------------------------------ */
+/** collect_artifact_data over the standard set: every scalar it produces. */
+export function computeDataVectors(fixtures) {
+    const reg = fixtures.registry();
+    const rng = new Rng(11);
+    const data = collectArtifactData(reg, fixtures.constants(), reg.artifacts, rng);
+    return [
+        {
+            kind: "data",
+            subject: "totals",
+            scenario: "standard set, seed=11",
+            out: JSON.stringify({
+                bow: data.bowTotal,
+                melee: data.meleeTotal,
+                boot: data.bootTotal,
+                glove: data.gloveTotal,
+                headgear: data.headgearTotal,
+                shield: data.shieldTotal,
+                cloak: data.cloakTotal,
+                armor: data.armorTotal,
+                other: data.otherTotal,
+                total: data.total,
+                negPower: data.negPowerTotal,
+            }),
+            probe: rng.randint0(1 << 24),
+        },
+        {
+            kind: "data",
+            subject: "power-profile",
+            scenario: "standard set, seed=11",
+            out: JSON.stringify({
+                hitIncrement: data.hitIncrement,
+                damIncrement: data.damIncrement,
+                hitStartval: data.hitStartval,
+                damStartval: data.damStartval,
+                acStartval: data.acStartval,
+                acIncrement: data.acIncrement,
+                maxPower: data.maxPower,
+                minPower: data.minPower,
+                avgPower: data.avgPower,
+                varPower: data.varPower,
+            }),
+        },
+        {
+            kind: "data",
+            subject: "frequencies",
+            scenario: "standard set, seed=11",
+            out: JSON.stringify({
+                artProbs: data.artProbs,
+                tvProbs: data.tvProbs,
+                tvNum: data.tvNum,
+                tvFreq: data.tvFreq,
+            }),
+        },
+    ];
+}
+/** Every family, in a stable order. */
+export function computeRandartVectors(fixtures) {
+    return [
+        ...computeDataVectors(fixtures),
+        ...computePrepVectors(fixtures),
+        ...computeAbilityVectors(fixtures),
+        ...computeSetVectors(fixtures),
+    ];
+}
+//# sourceMappingURL=randart-vectors.js.map

package/dist/obj/randart-vectors.js.map

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

package/dist/obj/randart.d.ts

@@ -35,14 +35,20 @@
  *   (game.ts:2511-2514) - so the in-game randart names draw faithfully too.
  *   randNameFallback (a local syllable table) is retained only as a defensive
  *   guard for callers that pass no corpus (it never runs on the wired paths).
- * - Spoiler file (DEFERRED): upstream do_randart optionally writes randart.txt
- *   (create_file / write_randart_entry, obj-randart.c L3057-L3215) and always
- *   writes randart.log. Both are spoiler/log dumps that never affect any
- *   artifact field or RNG draw; they are dropped. do_randart therefore takes
- *   no create_file argument and returns the artifact array directly. Noted as
- *   a deferral. The second measurement pass upstream runs after generation
- *   (store_base_power/parse_frequencies on the finished set, L3184-L3187) exists
- *   only to populate the log and consumes no RNG, so it is dropped too.
+ * - randart.log (PORT_TODO 5.5): PORTED bar one line. do_randart opens and
+ *   closes it through the host; the maintainer's disposition on 2026-08-04 was
+ *   pursue parity, so the "it never affects an artifact field" argument the old
+ *   note made here was never a reason to omit it. What is and is not written is
+ *   MEASURED by obj/randart-log.census.test.ts rather than claimed in prose,
+ *   including the one site the census's span filter cannot see. See
+ *   randart-log.ts for the sink and the reason it is a module-level static.
+ * - randart.txt: PORTED. obj/randart-file.ts, gated by do_randart's create_file
+ *   (obj-randart.c L3195-L3215), which is a required parameter here.
+ * - The second measurement pass upstream runs after generation
+ *   (store_base_power/parse_frequencies on the finished set, L3181-L3186):
+ *   PORTED. It exists only to populate the log's closing statistics, and the
+ *   set it measures is a parameter here because this port does not overwrite
+ *   the a_info global the way upstream does.
  * - copy_artifact activation/alt_msg quirk (FAITHFUL): upstream copy_artifact
  *   memcpy's the whole struct and then explicitly nulls a_dst->activation and
  *   a_dst->alt_msg (obj-randart.c L2689-L2690). copyArtifact reproduces this:
@@ -56,7 +62,9 @@
  *   artifact. In the standard set the quest artifacts are last and contiguous,
  *   so this is unobservable, but it is reproduced exactly. Noted.
  */
+import type { HostIo } from "../host/io.js";
 import { Rng } from "../rng.js";
+import type { Constants } from "../constants.js";
 import type { ObjRegistry } from "./bind.js";
 import { type NameProbs } from "./randname.js";
 import { makeBad } from "./randart-build.js";
@@ -77,6 +85,18 @@ export declare const RANDNAME_TOLKIEN = 1;
  * copied. dst keeps its own identity so array references stay valid.
  */
 export declare function copyArtifact(src: Artifact, dst: Artifact): void;
+/**
+ * A full deep copy of an artifact, preserving activation and alt_msg. Used to
+ * snapshot the registry's standard artifacts into a mutable working set so
+ * do_randart never mutates ObjRegistry.artifacts. This is NOT copy_artifact
+ * (which deliberately drops activation/alt_msg); it is the honest clone the
+ * working array needs.
+ *
+ * EXPORTED so a test harness can start from the same object shape production
+ * mutates - a hand-built Artifact would be the harness asserting what the
+ * struct looks like rather than measuring it.
+ */
+export declare function cloneArtifact(src: Artifact): Artifact;
 /**
  * artifact_gen_name (obj-randart.c L2713): generate a random artifact name.
  * Faithful to upstream: draw a Markov word from the RANDNAME_TOLKIEN corpus via
@@ -101,7 +121,7 @@ export declare function artifactGenName(rng: Rng, probs: NameProbs | null): stri
  * (or, for a cursed artifact, curses) added until its power lands between 19/20
  * and 23/20 of the target.
  */
-export declare function designArtifact(reg: ObjRegistry, arts: (Artifact | null)[], data: ArtifactSetData, tv: number, aidx: number, rng: Rng, nameProbs: NameProbs | null): number;
+export declare function designArtifact(reg: ObjRegistry, constants: Constants, arts: (Artifact | null)[], data: ArtifactSetData, tv: number, aidx: number, rng: Rng, nameProbs: NameProbs | null): number;
 /**
  * create_artifact_set (obj-randart.c L2954): design a full set of random
  * artifacts into `arts`. The resulting set has at least 80% as many artifacts
@@ -110,7 +130,7 @@ export declare function designArtifact(reg: ObjRegistry, arts: (Artifact | null)
  * artifacts. The final slot (index arts.length - 1) is left as the original,
  * matching the upstream `aidx < z_info->a_max - 1` bound.
  */
-export declare function createArtifactSet(reg: ObjRegistry, arts: (Artifact | null)[], data: ArtifactSetData, rng: Rng, nameProbs: NameProbs | null): void;
+export declare function createArtifactSet(reg: ObjRegistry, constants: Constants, arts: (Artifact | null)[], data: ArtifactSetData, rng: Rng, nameProbs: NameProbs | null): void;
 /**
  * do_randart (obj-randart.c L3154): generate a full random artifact set from a
  * seed and return it as a fresh (Artifact|null)[] array (index 0 null),
@@ -119,10 +139,28 @@ export declare function createArtifactSet(reg: ObjRegistry, arts: (Artifact | nu
  * Upstream seeds the "quick" LCRNG (Rand_value = seed, Rand_quick = true), so
  * this port creates its Rng in quick mode and draws in upstream order:
  * measure the standard set (store_base_power + parse_frequencies via
- * collectArtifactData), then design every artifact (create_artifact_set). The
- * upstream log file, the post-generation measurement pass, and the optional
- * spoiler file (create_file / write_randart_entry) are all dropped as they
- * never affect an artifact field or an RNG draw (see module note).
+ * collectArtifactData), design every artifact (create_artifact_set), then
+ * measure the finished set the same way. The log file (randart.log), the
+ * post-generation measurement pass and the optional spoiler file (create_file /
+ * write_randart_entry) are all ported (PORT_TODO 5.5); none of them affects an
+ * artifact field or an RNG draw.
+ */
+/** path_build(ANGBAND_DIR_USER, "randart.log") (obj-randart.c L3165). */
+export declare const RANDART_LOG = "randart.log";
+export declare function doRandart(reg: ObjRegistry, 
+/**
+ * z_info / the player constants object_prep reads. Upstream reaches them as
+ * globals; the port passes them, and they arrive here because artifact_power
+ * builds a real fake object through make_fake_artifact.
+ */
+constants: Constants, randartSeed: number, 
+/**
+ * do_randart's `create_file` (obj-randart.c:3154). True writes randart.txt
+ * beside randart.log; upstream passes true from birth, from loading a save
+ * and from the spoiler generator, and false from the statistics harnesses.
+ *
+ * REQUIRED, with no default: the two callers that want it differ from the
+ * many that do not, and a default would silently pick one of them.
  */
-export declare function doRandart(reg: ObjRegistry, randartSeed: number, tolkienWords?: readonly string[], extras?: Pick<ArtifactSetData, "timedFoil" | "activationSummarize">): (Artifact | null)[];
+createFile: boolean, tolkienWords?: readonly string[], extras?: Pick<ArtifactSetData, "timedFoil" | "activationSummarize">, io?: HostIo, onLogError?: (message: string) => void): (Artifact | null)[];
 //# sourceMappingURL=randart.d.ts.map

package/dist/obj/randart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"randart.d.ts","sourceRoot":"","sources":["../../src/obj/randart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAKL,OAAO,EAGR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,EAAE,OAAO,EAAE,CAAC;AAanB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAMlC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CA6B/D;AAiFD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAQzE;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EACzB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,MAAM,CAkKR;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EACzB,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,IAAI,CA8BN;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,EAChC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,qBAAqB,CAAC,GAClE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAkCrB"}
+{"version":3,"file":"randart.d.ts","sourceRoot":"","sources":["../../src/obj/randart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAKL,OAAO,EAGR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,EAAE,OAAO,EAAE,CAAC;AAanB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAMlC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CA6B/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CA6BrD;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAQzE;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EACzB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,MAAM,CAwMR;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EACzB,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,GAAG,IAAI,GAC1B,IAAI,CAuCN;AAMD;;;;;;;;;;;;;GAaG;AACH,yEAAyE;AACzE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,wBAAgB,SAAS,CACvB,GAAG,EAAE,WAAW;AAChB;;;;GAIG;AACH,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM;AACnB;;;;;;;GAOG;AACH,UAAU,EAAE,OAAO,EACnB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,EAChC,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,qBAAqB,CAAC,EACnE,EAAE,GAAE,MAAe,EACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAuHrB"}