uesp-eso-build-wrapper 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 srtomy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# uesp-eso-build-wrapper
+
+A Node.js/TypeScript wrapper around the [UESP ESO Build Editor](https://github.com/uesp/uesp-esochardata) math engine.
+
+Calculate Elder Scrolls Online **Computed Character Statistics** — Health, Magicka, Stamina, mitigation, crit chance, regeneration, and 200+ more — using UESP's own formulas. No formula reimplementation. No database.
+
+## Features
+
+- ✅ **100% UESP formulas** — same engine powering [esobuilds.uesp.net](https://esobuilds.uesp.net)
+- ✅ **221 computed stats** — all `Computed Character Statistics` from the build editor
+- ✅ **Zero runtime dependencies** — pure Node.js
+- ✅ **Full TypeScript types** — typed inputs and outputs
+- ✅ **Singleton loader** — loads the engine once per process, fast on subsequent calls
+
+## Installation
+
+```bash
+npm install uesp-eso-build-wrapper
+```
+
+## Quick Start
+
+```ts
+import { initEsoEngine, calculateBuild } from 'uesp-eso-build-wrapper';
+
+// Initialize once — resolves bundled vendor files automatically
+initEsoEngine();
+
+const stats = calculateBuild({
+  character: {
+    race: 'High Elf',
+    class: 'Sorcerer',
+    level: 50,
+    attributes: { health: 0, magicka: 64, stamina: 0 },
+  },
+});
+
+console.log(stats.Health);       // 16000
+console.log(stats.Magicka);      // 19104
+console.log(stats.MagickaRegen); // 514
+console.log(stats.SpellDamage);  // 1000
+```
+
+## With Equipped Items
+
+Items are passed directly as returned by the [UESP public item API](https://esolog.uesp.net/exportJson.php?table=minedItem&id=70&level=50&quality=5).
+
+```ts
+// 1. Fetch item data from UESP API
+const res = await fetch(
+  'https://esolog.uesp.net/exportJson.php?table=minedItem&id=70&level=50&quality=5'
+);
+const data = await res.json();
+const item = data.minedItem[0]; // pick the variant you want
+
+// 2. Pass it directly — no mapping needed
+const stats = calculateBuild({
+  character: {
+    race: 'Nord',
+    class: 'Dragonknight',
+    level: 50,
+    attributes: { health: 64, magicka: 0, stamina: 0 },
+  },
+  items: {
+    Chest: item,
+  },
+});
+
+console.log(stats.Health); // includes item enchant + set bonus
+```
+
+## API
+
+### `initEsoEngine(resourcesPath?, initDataPath?)`
+
+Initializes the UESP math engine. **Must be called once** before `calculateBuild()`.
+
+Safe to call multiple times — only executes on the first call.
+
+| Param | Type | Default | Description |
+|---|---|---|---|
+| `resourcesPath` | `string` | bundled vendor | Path to `esoEditBuild.js` and `esobuilddata.js` |
+| `initDataPath` | `string` | bundled vendor | Path to `uesp-init-data.json` with game formulas |
+
+### `calculateBuild(input: BuildInput): ComputedStats`
+
+Runs the UESP engine and returns the computed stats.
+
+#### `BuildInput`
+
+```ts
+interface BuildInput {
+  character: {
+    race: string;             // "High Elf" | "Nord" | "Breton" | "Khajiit" | ...
+    class: string;            // "Sorcerer" | "Dragonknight" | "Nightblade" | ...
+    level: number;            // 1–50
+    attributes: {
+      health: number;         // attribute points (max 64 total)
+      magicka: number;
+      stamina: number;
+    };
+    mundusStone?: string;     // "The Thief" | "The Apprentice" | ...
+    cyrodiil?: boolean;       // Battle Spirit (PvP)
+    vampireStage?: number;    // 0–4
+    werewolfStage?: number;   // 0 or 1
+    championPoints?: number;  // 0–3600
+    rulesVersion?: string;    // "Live" (default) | "PTS"
+  };
+  items?: Partial<Record<EquipSlot, UespItemApiData>>;
+}
+```
+
+#### `EquipSlot`
+
+```
+Head | Shoulders | Chest | Hands | Legs | Waist | Feet |
+Neck | Ring1 | Ring2 |
+MainHand1 | OffHand1 | MainHand2 | OffHand2 |
+Poison1 | Poison2 | Food | Potion
+```
+
+#### `ComputedStats`
+
+Key stats returned (see [`types.ts`](src/lib/eso-engine/types.ts) for full list):
+
+| Property | Description |
+|---|---|
+| `Health` / `Magicka` / `Stamina` | Maximum resource pools |
+| `HealthRegen` / `MagickaRegen` / `StaminaRegen` | Out-of-combat regeneration |
+| `WeaponDamage` / `SpellDamage` | Base damage |
+| `WeaponCrit` / `SpellCrit` | Critical chance |
+| `PhysicalResist` / `SpellResist` / `CritResist` | Resistances |
+| `PhysicalPenetration` / `SpellPenetration` | Armor penetration |
+| `DefensePhysicalMitigation` / `DefenseSpellMitigation` | Effective mitigation % |
+| `HealingDone` / `HealingTaken` | Healing modifiers |
+| `RunSpeed` / `SprintSpeed` | Movement speed |
+| `raw` | All 221 stats as `Record<string, number>` |
+
+> All stat IDs match `g_EsoComputedStats` from the UESP engine (version 49+).
+
+## Updating Formulas After a New ESO Patch
+
+When ZeniMax releases a new patch or DLC, the formulas may change. To update:
+
+```bash
+# 1. Update the UESP submodule
+cd vendor/uesp-esochardata
+git fetch upstream && git merge upstream/master
+cd ../..
+
+# 2. Re-extract the formulas from the UESP website
+#    Open https://esobuilds.uesp.net in a browser
+#    Run vendor/uesp-data/browser-extract.js in DevTools Console
+#    Save the result to vendor/uesp-data/uesp-init-data.json
+
+# 3. Run tests to verify
+npm test
+```
+
+## License
+
+MIT © srtomy
+
+This package bundles files from [uesp/uesp-esochardata](https://github.com/uesp/uesp-esochardata) (MIT).
+See [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for details.
+
+Elder Scrolls Online is a trademark of ZeniMax Media Inc. This project is not affiliated with or endorsed by ZeniMax Media Inc.

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,39 @@
+Third-Party Notices
+===================
+
+This package bundles portions of the following open-source project:
+
+--------------------------------------------------------------------------------
+uesp/uesp-esochardata
+https://github.com/uesp/uesp-esochardata
+
+MIT License
+
+Copyright (c) UESP (Unofficial Elder Scrolls Pages)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+--------------------------------------------------------------------------------
+
+Bundled files from uesp/uesp-esochardata:
+  - vendor/uesp-esochardata/resources/esoEditBuild.js
+  - vendor/uesp-esochardata/resources/esobuilddata.js
+  - vendor/uesp-data/uesp-init-data.json (formulas extracted from the UESP website)
+
+Elder Scrolls Online is a trademark of ZeniMax Media Inc. This project is not
+affiliated with or endorsed by ZeniMax Media Inc. or Bethesda Softworks.

package/dist/lib/eso-engine/calculator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Motor de cálculo de builds do ESO.
+ *
+ * Implementa a ideia central da arquitetura:
+ *
+ *   1. Injetar dados do personagem nos elementos mock do DOM
+ *      (jQuery vai ler via $("#esotbRace").val(), etc.)
+ *
+ *   2. Injetar dados dos itens DIRETAMENTE em g_EsoBuildItemData[slot]
+ *      — sem precisar mockar jQuery para cada campo de item.
+ *      Os campos vêm exatamente no formato da API pública da UESP:
+ *      GET https://esolog.uesp.net/exportJson.php?table=minedItem&id=<id>&level=<lv>&quality=<q>
+ *
+ *   3. Chamar UpdateEsoComputedStatsList_Real(null, true)
+ *      — o parâmetro `noUpdate=true` faz o motor calcular tudo mas pular
+ *      as atualizações de DOM (DisplayEsoAllComputedStats, UpdateReadOnlyStats, etc.)
+ *
+ *   4. Ler os resultados de g_EsoComputedStats[statId].value
+ */
+import type { BuildInput, ComputedStats } from './types';
+/**
+ * Calcula os Computed Character Statistics para a build fornecida.
+ *
+ * @example
+ * ```ts
+ * import { calculateBuild } from './src/lib/eso-engine';
+ *
+ * const stats = calculateBuild({
+ *   character: { race: 'High Elf', class: 'Sorcerer', level: 50,
+ *                attributes: { health: 0, magicka: 64, stamina: 0 } },
+ *   items: {
+ *     Chest: chestItemFromUespApi,  // objeto retornado por esolog.uesp.net/exportJson.php
+ *   },
+ * });
+ * console.log(stats.MaxMagicka, stats.SpellDamage);
+ * ```
+ */
+export declare function calculateBuild(input: BuildInput): ComputedStats;
+//# sourceMappingURL=calculator.d.ts.map

package/dist/lib/eso-engine/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../src/lib/eso-engine/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAa,MAAM,SAAS,CAAC;AAuBpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAyJ/D"}

package/dist/lib/eso-engine/calculator.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Motor de cálculo de builds do ESO.
+ *
+ * Implementa a ideia central da arquitetura:
+ *
+ *   1. Injetar dados do personagem nos elementos mock do DOM
+ *      (jQuery vai ler via $("#esotbRace").val(), etc.)
+ *
+ *   2. Injetar dados dos itens DIRETAMENTE em g_EsoBuildItemData[slot]
+ *      — sem precisar mockar jQuery para cada campo de item.
+ *      Os campos vêm exatamente no formato da API pública da UESP:
+ *      GET https://esolog.uesp.net/exportJson.php?table=minedItem&id=<id>&level=<lv>&quality=<q>
+ *
+ *   3. Chamar UpdateEsoComputedStatsList_Real(null, true)
+ *      — o parâmetro `noUpdate=true` faz o motor calcular tudo mas pular
+ *      as atualizações de DOM (DisplayEsoAllComputedStats, UpdateReadOnlyStats, etc.)
+ *
+ *   4. Ler os resultados de g_EsoComputedStats[statId].value
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateBuild = calculateBuild;
+const env_setup_1 = require("./env-setup");
+const ALL_SLOTS = [
+    'Head', 'Shoulders', 'Chest', 'Hands', 'Legs', 'Waist', 'Feet',
+    'Neck', 'Ring1', 'Ring2',
+    'MainHand1', 'OffHand1', 'MainHand2', 'OffHand2',
+    'Poison1', 'Poison2', 'Food', 'Potion',
+];
+/**
+ * Normaliza os dados de um item garantindo que todos os campos opcionais
+ * existam com defaults seguros. Sem isso, o motor lança TypeError ao tentar
+ * chamar .includes() em campos de set bonus undefined (setBonusDesc5..12).
+ */
+function normalizeItemData(item) {
+    const defaults = {};
+    for (let i = 1; i <= 12; i++) {
+        defaults[`setBonusCount${i}`] = item[`setBonusCount${i}`] ?? '-1';
+        defaults[`setBonusDesc${i}`] = item[`setBonusDesc${i}`] ?? '';
+    }
+    return { ...defaults, ...item };
+}
+/**
+ * Calcula os Computed Character Statistics para a build fornecida.
+ *
+ * @example
+ * ```ts
+ * import { calculateBuild } from './src/lib/eso-engine';
+ *
+ * const stats = calculateBuild({
+ *   character: { race: 'High Elf', class: 'Sorcerer', level: 50,
+ *                attributes: { health: 0, magicka: 64, stamina: 0 } },
+ *   items: {
+ *     Chest: chestItemFromUespApi,  // objeto retornado por esolog.uesp.net/exportJson.php
+ *   },
+ * });
+ * console.log(stats.MaxMagicka, stats.SpellDamage);
+ * ```
+ */
+function calculateBuild(input) {
+    // -------------------------------------------------------------------------
+    // PASSO 1: Injeta stats do personagem nos elementos mock do DOM.
+    // O motor lê esses valores via jQuery: $("#esotbRace").val(), etc.
+    // -------------------------------------------------------------------------
+    (0, env_setup_1.resetDomValues)();
+    const { character, items } = input;
+    (0, env_setup_1.setDomValue)('esotbRace', character.race);
+    (0, env_setup_1.setDomValue)('esotbClass', character.class);
+    (0, env_setup_1.setDomValue)('esotbLevel', String(Math.min(character.level, 50)));
+    (0, env_setup_1.setDomValue)('esotbAttrHea', String(character.attributes.health ?? 0));
+    (0, env_setup_1.setDomValue)('esotbAttrMag', String(character.attributes.magicka ?? 0));
+    (0, env_setup_1.setDomValue)('esotbAttrSta', String(character.attributes.stamina ?? 0));
+    // Mundus Stone (pedra de Mundus)
+    if (character.mundusStone) {
+        (0, env_setup_1.setDomValue)('esotbMundus', character.mundusStone);
+    }
+    // PvP Cyrodiil (Battle Spirit)
+    if (character.cyrodiil) {
+        (0, env_setup_1.setDomValue)('esotbCyrodiil', 'true'); // prop("checked") retorna true quando valor é "true"
+    }
+    // Vampiro / Lobisomem
+    if (character.vampireStage != null)
+        (0, env_setup_1.setDomValue)('esotbVampireStage', String(character.vampireStage));
+    if (character.werewolfStage != null)
+        (0, env_setup_1.setDomValue)('esotbWerewolfStage', String(character.werewolfStage));
+    // Champion Points
+    if (character.championPoints != null) {
+        (0, env_setup_1.setDomValue)('esotbCPTotalPoints', String(character.championPoints));
+    }
+    // Versão das regras (padrão: Live)
+    (0, env_setup_1.setDomValue)('esotbRulesVersion', character.rulesVersion ?? 'Live');
+    // Campos obrigatórios com defaults seguros
+    (0, env_setup_1.setDomValue)('esotbMountSpeedBonus', '0');
+    (0, env_setup_1.setDomValue)('esotbBaseWalkSpeed', '3.0');
+    (0, env_setup_1.setDomValue)('esotbBuildDescription', '');
+    (0, env_setup_1.setDomValue)('esotbUsePtsRules', 'false');
+    (0, env_setup_1.setDomValue)('esotbEnableRaceAutoPurchase', 'false');
+    (0, env_setup_1.setDomValue)('esotbTargetResistance', '0');
+    // -------------------------------------------------------------------------
+    // PASSO 2: Injeta dados de itens DIRETAMENTE em g_EsoBuildItemData[slot].
+    //
+    // Esta é a ideia central: em vez de mockar jQuery para cada campo de item,
+    // populamos a variável global que o motor lê nativamente.
+    // Os dados vêm exatamente no formato da API pública da UESP — sem adaptação.
+    // -------------------------------------------------------------------------
+    const itemData = global.g_EsoBuildItemData;
+    const enchantData = global.g_EsoBuildEnchantData;
+    // Reseta todos os slots (evita dados de chamada anterior)
+    for (const slot of ALL_SLOTS) {
+        itemData[slot] = {};
+        if (enchantData)
+            enchantData[slot] = {};
+    }
+    // Injeta os itens fornecidos (normalizados com defaults seguros)
+    if (items) {
+        for (const [slot, item] of Object.entries(items)) {
+            if (item && item.itemId) {
+                itemData[slot] = normalizeItemData(item);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // PASSO 3: Executa o cálculo.
+    //
+    // UpdateEsoComputedStatsList_Real(keepSaveResults, noUpdate)
+    //   - keepSaveResults = null  → reseta os resultados salvos (comportamento padrão)
+    //   - noUpdate = true         → pula DisplayEsoAllComputedStats e UpdateReadOnlyStats
+    //                               (operações de DOM que não precisamos)
+    // -------------------------------------------------------------------------
+    const updateFn = global.UpdateEsoComputedStatsList_Real;
+    if (typeof updateFn !== 'function') {
+        throw new Error('[eso-engine] UpdateEsoComputedStatsList_Real não está disponível. ' +
+            'Certifique-se de chamar initEsoEngine() antes de calculateBuild().');
+    }
+    updateFn(null, true);
+    // -------------------------------------------------------------------------
+    // PASSO 4: Lê os resultados de g_EsoComputedStats[statId].value
+    // -------------------------------------------------------------------------
+    const computedStats = global.g_EsoComputedStats ?? {};
+    const raw = {};
+    for (const statId of Object.keys(computedStats)) {
+        const stat = computedStats[statId];
+        if (stat && typeof stat === 'object' && typeof stat.value === 'number') {
+            raw[statId] = stat.value;
+        }
+    }
+    return {
+        // Atributos máximos
+        Health: raw['Health'] ?? 0,
+        Magicka: raw['Magicka'] ?? 0,
+        Stamina: raw['Stamina'] ?? 0,
+        // Regeneração
+        HealthRegen: raw['HealthRegen'] ?? 0,
+        MagickaRegen: raw['MagickaRegen'] ?? 0,
+        StaminaRegen: raw['StaminaRegen'] ?? 0,
+        // Dano
+        WeaponDamage: raw['WeaponDamage'] ?? 0,
+        SpellDamage: raw['SpellDamage'] ?? 0,
+        // Crítico
+        WeaponCrit: raw['WeaponCrit'] ?? 0,
+        SpellCrit: raw['SpellCrit'] ?? 0,
+        SpellCritDamage: raw['SpellCritDamage'] ?? 0,
+        WeaponCritDamage: raw['WeaponCritDamage'] ?? 0,
+        // Resistências
+        PhysicalResist: raw['PhysicalResist'] ?? 0,
+        SpellResist: raw['SpellResist'] ?? 0,
+        CritResist: raw['CritResist'] ?? 0,
+        // Penetração
+        PhysicalPenetration: raw['PhysicalPenetration'] ?? 0,
+        SpellPenetration: raw['SpellPenetration'] ?? 0,
+        // Poder efetivo
+        EffectiveSpellPower: raw['EffectiveSpellPower'] ?? 0,
+        EffectiveWeaponPower: raw['EffectiveWeaponPower'] ?? 0,
+        EffectivePower: raw['EffectivePower'] ?? 0,
+        // Cura
+        HealingDone: raw['HealingDone'] ?? 0,
+        HealingTaken: raw['HealingTaken'] ?? 0,
+        // Velocidade
+        RunSpeed: raw['RunSpeed'] ?? 0,
+        SprintSpeed: raw['SprintSpeed'] ?? 0,
+        // Mitigação
+        AttackSpellMitigation: raw['AttackSpellMitigation'] ?? 0,
+        AttackPhysicalMitigation: raw['AttackPhysicalMitigation'] ?? 0,
+        DefenseSpellMitigation: raw['DefenseSpellMitigation'] ?? 0,
+        DefensePhysicalMitigation: raw['DefensePhysicalMitigation'] ?? 0,
+        raw,
+    };
+}
+//# sourceMappingURL=calculator.js.map

package/dist/lib/eso-engine/calculator.js.map

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

package/dist/lib/eso-engine/env-setup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Configura o ambiente global do Node.js para simular o browser.
+ *
+ * O motor da UESP (esoEditBuild.js) foi escrito para rodar no browser e usa:
+ *   - window.* — para variáveis e funções globais
+ *   - document.getElementById / $ — para ler/escrever valores do DOM
+ *   - navigator — verificação de agente
+ *
+ * Esta camada cria mocks controlados desses objetos ANTES de carregar
+ * o script da UESP, de forma que:
+ *   1. O script inicia sem erros (jQuery mock chainável)
+ *   2. Nosso código pode injetar valores de entrada (race, class, level, etc.)
+ *      via setDomValue() antes de chamar o cálculo
+ *   3. O motor lê esses valores normalmente via $("#elementId").val()
+ */
+/** Armazena os valores que o jQuery vai "ler" como se fossem campos HTML */
+export declare const domValueStore: Map<string, string>;
+/** Define o valor de um elemento mock (equivale a preencher um campo HTML) */
+export declare function setDomValue(id: string, value: string): void;
+/** Lê o valor de um elemento mock */
+export declare function getDomValue(id: string): string;
+/** Reseta todos os valores do DOM mock */
+export declare function resetDomValues(): void;
+export declare function setupNodeEnvironment(): void;
+//# sourceMappingURL=env-setup.d.ts.map

package/dist/lib/eso-engine/env-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-setup.d.ts","sourceRoot":"","sources":["../../../src/lib/eso-engine/env-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,IAAI,CAErC;AA8JD,wBAAgB,oBAAoB,IAAI,IAAI,CA2C3C"}