rpgmaker-mz-mcp 1.0.0

package/dist/tools/tileTransparency.js

@@ -0,0 +1,156 @@
+/**
+ * Tools-layer bridge for tile transparency: loads a tileset sheet PNG (cached by
+ * path + mtime, failing soft when the image is missing/unreadable) and answers
+ * "does this raw tile id need an opaque base beneath it?" — plus a base-aware
+ * paint warning that fires when a transparent tile lands with the map's void
+ * showing through.
+ *
+ * The pixel work is pure (`../tiles/transparency`, `../tiles/png`); this module
+ * only does the I/O, the raw-id → (sheet, role, local index) resolution, and the
+ * per-map layer scan.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { decodePng } from '../tiles/png.js';
+import { tileTransparentFraction, needsBase } from '../tiles/transparency.js';
+import { BASE_KIND } from '../tiles/tilegeom.js';
+import { decodeTile } from '../tiles/tileCodec.js';
+import { tileIndex } from './mapTools.js';
+/** `tilesetNames` slot index for each sheet role. */
+const SLOT_INDEX = {
+    A1: 0,
+    A2: 1,
+    A3: 2,
+    A4: 3,
+    A5: 4,
+    B: 5,
+    C: 6,
+    D: 7,
+    E: 8,
+};
+/** In-process cache of decoded sheets, keyed by file path. `img: null` = a load that failed. */
+const sheetCache = new Map();
+/**
+ * Decode a tileset sheet PNG from `img/tilesets/<name>.png`, cached by mtime.
+ * Returns `undefined` (never throws) when the sheet name is empty or the file is
+ * missing/undecodable — transparency is simply unknown for that sheet.
+ */
+async function loadSheetImage(projectPath, sheetName) {
+    if (!sheetName)
+        return undefined;
+    const path = join(projectPath, 'img', 'tilesets', `${sheetName}.png`);
+    let mtimeMs;
+    try {
+        mtimeMs = (await stat(path)).mtimeMs;
+    }
+    catch {
+        return undefined;
+    }
+    const cached = sheetCache.get(path);
+    if (cached && cached.mtimeMs === mtimeMs)
+        return cached.img ?? undefined;
+    try {
+        const img = decodePng(await readFile(path));
+        sheetCache.set(path, { mtimeMs, img });
+        return img;
+    }
+    catch {
+        sheetCache.set(path, { mtimeMs, img: null });
+        return undefined;
+    }
+}
+/** Resolve a raw tile id to its sheet role + local index within that sheet, or null. */
+function tileSlot(tileId) {
+    const d = decodeTile(tileId);
+    if (d.empty || !d.sheet)
+        return null;
+    if (d.autotile) {
+        const role = d.sheet;
+        return { role, localIndex: d.kind - BASE_KIND[role] };
+    }
+    return { role: d.sheet, localIndex: d.sheetIndex };
+}
+/**
+ * Whether a raw tile id is transparent enough to need an opaque base beneath it.
+ * `undefined` = unknown (empty tile, or the sheet PNG couldn't be read). A small
+ * `cache` map memoises results within one operation so a big fill doesn't
+ * reclassify the same id repeatedly.
+ */
+export async function isTileTransparent(projectPath, tileset, tileId, cache) {
+    if (cache?.has(tileId))
+        return cache.get(tileId);
+    const result = await classify(projectPath, tileset, tileId);
+    cache?.set(tileId, result);
+    return result;
+}
+async function classify(projectPath, tileset, tileId) {
+    return (await tileTransparencyDetail(projectPath, tileset, tileId))?.transparent;
+}
+/**
+ * The transparency reading for one tile: whether it needs a base and the percent
+ * of its sample that is transparent (for `describe_tile`). `undefined` when the
+ * tile is empty or the sheet PNG can't be read.
+ */
+export async function tileTransparencyDetail(projectPath, tileset, tileId) {
+    const slot = tileSlot(tileId);
+    if (!slot)
+        return undefined;
+    const img = await loadSheetImage(projectPath, tileset.tilesetNames[SLOT_INDEX[slot.role]]);
+    if (!img)
+        return undefined;
+    const fraction = tileTransparentFraction(img, slot.role, slot.localIndex);
+    return { transparent: needsBase(fraction), transparentPercent: Math.round(fraction * 100) };
+}
+/**
+ * Set each catalog entry's `transparent` flag by inspecting its tileset sheet
+ * (in place). Entries whose sheet PNG can't be read are left unset (unknown).
+ * Only worth calling on a bounded entry list (one sheet, or `find_tile` matches).
+ */
+export async function annotateTransparency(projectPath, tileset, entries) {
+    const cache = new Map();
+    for (const entry of entries) {
+        const transparent = await isTileTransparent(projectPath, tileset, entry.tileId, cache);
+        if (transparent !== undefined)
+            entry.transparent = transparent;
+    }
+}
+/**
+ * Scan painted cells for the transparent-tile-without-a-base footgun: a
+ * transparent tile on layer L with no *opaque* tile on any lower layer in the
+ * same cell will show the map's void through its see-through areas. Returns a
+ * single aggregated warning (or `undefined`) so a large fill doesn't spam one
+ * line per cell. Fails soft — cells whose transparency can't be read are ignored.
+ */
+export async function baseAwareTransparencyWarning(projectPath, map, tileset, cells) {
+    const cache = new Map();
+    const offenders = [];
+    for (const cell of cells) {
+        if (cell.tileId === 0)
+            continue;
+        const transparent = await isTileTransparent(projectPath, tileset, cell.tileId, cache);
+        if (transparent !== true)
+            continue; // opaque or unknown — no footgun
+        let hasBase = false;
+        for (let z = 0; z < cell.layer; z++) {
+            const below = map.data[tileIndex(map.width, map.height, cell.x, cell.y, z)];
+            if (below === 0)
+                continue;
+            if ((await isTileTransparent(projectPath, tileset, below, cache)) === false) {
+                hasBase = true; // an opaque tile beneath covers the void
+                break;
+            }
+        }
+        if (!hasBase)
+            offenders.push({ x: cell.x, y: cell.y, layer: cell.layer });
+    }
+    if (offenders.length === 0)
+        return undefined;
+    const first = offenders[0];
+    const where = offenders.length === 1
+        ? `(${first.x}, ${first.y})`
+        : `${offenders.length} cells (e.g. (${first.x}, ${first.y}))`;
+    return (`${where} paint a transparent tile on layer ${first.layer} with no opaque base beneath — ` +
+        `its see-through areas will show the map's void. Paint an opaque ground tile on a lower layer ` +
+        `first (layer 0), or place this on an upper tile layer over existing ground.`);
+}
+//# sourceMappingURL=tileTransparency.js.map

package/dist/tools/tileTransparency.js.map

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

package/dist/tools/tilesetTools.d.ts

@@ -0,0 +1,23 @@
+import { ToolDefinition } from '../registry.js';
+import { Tileset } from '../utils/types.js';
+/**
+ * List every tileset with its id, name, mode, and the image sheets it uses
+ * (`tilesetNames`, labelled by slot; empty slots omitted). The paint / catalog /
+ * flag tools all need a `tilesetId`, and `list_names('tilesets')` gives id→name,
+ * but this also exposes which sheets a tileset is built from — so a caller can
+ * pick the right tileset and know which `find_tile`/`get_tile_catalog` sheets
+ * apply. Read-only.
+ */
+export declare function getTilesets(projectPath: string): Promise<{
+    count: number;
+    tilesets: Array<{
+        id: number;
+        name: string;
+        mode: number;
+        sheets: Record<string, string>;
+    }>;
+}>;
+/** Load one tileset from the project's data/Tilesets.json (1-indexed, slot 0 null). */
+export declare function getTileset(projectPath: string, tilesetId: number): Promise<Tileset>;
+export declare const tilesetToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=tilesetTools.d.ts.map

package/dist/tools/tilesetTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tilesetTools.d.ts","sourceRoot":"","sources":["../../src/tools/tilesetTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAW,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA+BrD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;CAC7F,CAAC,CAeD;AAED,uFAAuF;AACvF,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASzF;AAuCD,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAoIlD,CAAC"}

package/dist/tools/tilesetTools.js

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import { getDataPath, readJsonFile } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { getMap, tileIndex } from './mapTools.js';
+import { decodeFlags, encodeFlags, layeredPassability, layeredTerrainTag, } from '../tiles/tileFlags.js';
+import { AUTOTILE_SLOTS_PER_KIND, decodeTile, getAutotileKind, isAutotile, makeAutotileId, } from '../tiles/tileCodec.js';
+/**
+ * Tools over a tileset's `flags[]` array (read side + passability
+ * editing) — the bit-packed per-tile-id metadata the editor sets and the engine
+ * reads for movement. `get_tile_flags` decodes one tile's flag word;
+ * `check_passability` reproduces the engine's *layered* passage logic for a real
+ * map cell (the stacked tiles decide, upper layer first); `set_tile_flags`
+ * writes the passability/terrain/behaviour flags back. Independent of the paint
+ * pipeline.
+ */
+/** Slot labels for `Tileset.tilesetNames[9]` — the 9 image sheets in fixed order. */
+const SHEET_SLOTS = ['A1', 'A2', 'A3', 'A4', 'A5', 'B', 'C', 'D', 'E'];
+/**
+ * List every tileset with its id, name, mode, and the image sheets it uses
+ * (`tilesetNames`, labelled by slot; empty slots omitted). The paint / catalog /
+ * flag tools all need a `tilesetId`, and `list_names('tilesets')` gives id→name,
+ * but this also exposes which sheets a tileset is built from — so a caller can
+ * pick the right tileset and know which `find_tile`/`get_tile_catalog` sheets
+ * apply. Read-only.
+ */
+export async function getTilesets(projectPath) {
+    const tilesets = await readJsonFile(getDataPath(projectPath, 'Tilesets.json'));
+    const entries = tilesets
+        .filter((t) => t != null)
+        .map((t) => {
+        const sheets = {};
+        SHEET_SLOTS.forEach((label, i) => {
+            const name = t.tilesetNames[i];
+            if (name)
+                sheets[label] = name;
+        });
+        return { id: t.id, name: t.name, mode: t.mode, sheets };
+    });
+    return { count: entries.length, tilesets: entries };
+}
+/** Load one tileset from the project's data/Tilesets.json (1-indexed, slot 0 null). */
+export async function getTileset(projectPath, tilesetId) {
+    const tilesets = await readJsonFile(getDataPath(projectPath, 'Tilesets.json'));
+    const tileset = tilesets[tilesetId];
+    if (!tileset) {
+        throw new Error(`Tileset ${tilesetId} not found`);
+    }
+    return tileset;
+}
+/** Collect the caller's supplied flag fields into a FlagUpdate (omitting untouched ones). */
+function flagUpdateFromArgs(args) {
+    const update = {};
+    if (args.passage !== undefined)
+        update.passage = args.passage;
+    if (args.star !== undefined)
+        update.star = args.star;
+    if (args.ladder !== undefined)
+        update.ladder = args.ladder;
+    if (args.bush !== undefined)
+        update.bush = args.bush;
+    if (args.counter !== undefined)
+        update.counter = args.counter;
+    if (args.damage !== undefined)
+        update.damage = args.damage;
+    if (args.terrainTag !== undefined)
+        update.terrainTag = args.terrainTag;
+    return update;
+}
+/**
+ * The tile ids a `set_tile_flags` write should touch. For a flat tile it's just
+ * the tile itself; for an autotile it's every shape slot of the kind (so painting
+ * any border shape keeps the same passability) unless the caller opts out.
+ */
+function flagTargetIds(tileId, applyToKind) {
+    if (applyToKind && isAutotile(tileId)) {
+        const kind = getAutotileKind(tileId);
+        return Array.from({ length: AUTOTILE_SLOTS_PER_KIND }, (_, shape) => makeAutotileId(kind, shape));
+    }
+    return [tileId];
+}
+/** The four stacked tile ids at a cell, upper layer first (z 3,2,1,0) — the engine's `layeredTiles` order. */
+function layeredTileIds(map, x, y) {
+    const ids = [];
+    for (let z = 3; z >= 0; z--) {
+        ids.push(map.data[tileIndex(map.width, map.height, x, y, z)] || 0);
+    }
+    return ids;
+}
+export const tilesetToolDefinitions = [
+    {
+        name: 'get_tilesets',
+        description: 'List every tileset in the project with its id, name, mode (0 world / 1 area), and the image sheets it uses (labelled A1–A4, A5, B–E; empty slots omitted). Use this to discover valid tilesetId values (needed by find_tile, get_tile_catalog, paint_tiles, fill_area, place_object, get_tile_flags, set_tile_flags, check_passability) and to see which sheets each tileset is built from. For a plain id→name list, list_names(type:"tilesets") is even cheaper. Read-only.',
+        inputSchema: {},
+        handler: (ctx) => getTilesets(ctx.projectPath),
+    },
+    {
+        name: 'get_tile_flags',
+        description: "Decode a tileset's flag word for a single tile id into a legible view: 4-direction passability (down/left/right/up — true = walkable that way), the [*] 'star' overlay bit, ladder/bush/counter/damage-floor flags, and terrain tag (0–7). Read-only inspection of data/Tilesets.json flags[]. Note passability here is for the tile in isolation; a real cell's passability layers its stacked tiles — use check_passability for that. Returns { tilesetId, tileId, tile, flags }.",
+        inputSchema: {
+            tilesetId: z.number().int().positive().describe('Tileset id (from Tilesets.json / the map)'),
+            tileId: z.number().int().nonnegative().describe('The raw tile id whose flags to decode'),
+        },
+        handler: async (ctx, args) => {
+            const tileset = await getTileset(ctx.projectPath, args.tilesetId);
+            const flag = tileset.flags[args.tileId] ?? 0;
+            return {
+                tilesetId: args.tilesetId,
+                tilesetName: tileset.name,
+                tileId: args.tileId,
+                tile: decodeTile(args.tileId),
+                flags: decodeFlags(flag),
+            };
+        },
+    },
+    {
+        name: 'check_passability',
+        description: "Check whether a map cell can be walked onto, reproducing the engine's layered passage rule: the stacked tiles at (x, y) are examined upper-layer first, and the first non-[*] tile decides each direction. Reads the map's tileset flags. Returns per-direction passability (down/left/right/up — true = a character can walk off the cell that way), the cell's terrain tag, the stacked tile ids, and — when `direction` is given — a single `passable` boolean for that direction. Read-only.",
+        inputSchema: {
+            mapId: z.number().int().positive().describe('The map id to inspect'),
+            x: z.number().int().nonnegative().describe('Tile x coordinate'),
+            y: z.number().int().nonnegative().describe('Tile y coordinate'),
+            direction: z
+                .enum(['down', 'left', 'right', 'up'])
+                .optional()
+                .describe('Optional: also report a single passable boolean for this direction'),
+        },
+        handler: async (ctx, args) => {
+            const map = await getMap(ctx.projectPath, args.mapId);
+            if (args.x < 0 || args.x >= map.width || args.y < 0 || args.y >= map.height) {
+                throw new Error(`Position (${args.x}, ${args.y}) is out of map bounds (${map.width}x${map.height})`);
+            }
+            const tileset = await getTileset(ctx.projectPath, map.tilesetId);
+            const stack = layeredTileIds(map, args.x, args.y);
+            const stackFlags = stack.map((id) => tileset.flags[id] ?? 0);
+            const passable = layeredPassability(stackFlags);
+            return {
+                mapId: args.mapId,
+                x: args.x,
+                y: args.y,
+                tilesetId: map.tilesetId,
+                stack,
+                passable,
+                terrainTag: layeredTerrainTag(stackFlags),
+                ...(args.direction
+                    ? {
+                        direction: args.direction,
+                        passableInDirection: passable[args.direction],
+                    }
+                    : {}),
+            };
+        },
+    },
+    {
+        name: 'set_tile_flags',
+        mutates: true,
+        description: "Edit a tile's passability/terrain/behaviour flags in a tileset's flags[] array (the write side of get_tile_flags). Only the fields you pass change — everything else on the tile is preserved (a non-destructive merge onto the current flag word). `passage` is walkability (down/left/right/up, true = a character can walk off that way). Also settable: star ([*] overlay), ladder, bush, counter, damage (damage floor), and terrainTag (0–7). For an autotile id (A1–A4) the change is applied to all 48 shape slots of its kind by default (set applyToAutotileKind:false to touch only the exact id) so painting any border shape keeps the same passability. Writes data/Tilesets.json through the commit choke point (dry-run/diff). Returns { tilesetId, tileId, appliedTileCount, before, after }.",
+        inputSchema: {
+            tilesetId: z.number().int().positive().describe('Tileset id (from Tilesets.json / the map)'),
+            tileId: z.number().int().nonnegative().describe('The raw tile id whose flags to edit'),
+            passage: z
+                .object({
+                down: z.boolean().optional(),
+                left: z.boolean().optional(),
+                right: z.boolean().optional(),
+                up: z.boolean().optional(),
+            })
+                .optional()
+                .describe('Walkability per direction (true = walkable). Only the given directions change.'),
+            star: z.boolean().optional().describe('[*] overlay: tile drawn above the character.'),
+            ladder: z.boolean().optional(),
+            bush: z.boolean().optional(),
+            counter: z.boolean().optional(),
+            damage: z.boolean().optional().describe('Damage floor (standing on it hurts).'),
+            terrainTag: z.number().int().min(0).max(7).optional().describe('Terrain tag 0–7 (0 = none).'),
+            applyToAutotileKind: z
+                .boolean()
+                .optional()
+                .describe('When the tile is an autotile (A1–A4), apply the change to all 48 shape slots of its kind (default true). Ignored for flat tiles.'),
+        },
+        handler: async (ctx, args) => {
+            const update = flagUpdateFromArgs(args);
+            if (Object.keys(update).length === 0) {
+                throw new Error('No flag fields to update — pass at least one of passage/star/ladder/bush/counter/damage/terrainTag');
+            }
+            const path = getDataPath(ctx.projectPath, 'Tilesets.json');
+            const tilesets = await readJsonFile(path);
+            const tileset = tilesets[args.tilesetId];
+            if (!tileset) {
+                throw new Error(`Tileset ${args.tilesetId} not found`);
+            }
+            const targetIds = flagTargetIds(args.tileId, args.applyToAutotileKind ?? true);
+            const before = decodeFlags(tileset.flags[args.tileId] ?? 0);
+            for (const id of targetIds) {
+                tileset.flags[id] = encodeFlags(tileset.flags[id] ?? 0, update);
+            }
+            const after = decodeFlags(tileset.flags[args.tileId] ?? 0);
+            await commitChange(path, tilesets);
+            return {
+                tilesetId: args.tilesetId,
+                tilesetName: tileset.name,
+                tileId: args.tileId,
+                appliedTileCount: targetIds.length,
+                before,
+                after,
+            };
+        },
+    },
+];
+//# sourceMappingURL=tilesetTools.js.map

package/dist/tools/tilesetTools.js.map

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

package/dist/tools/validationTools.d.ts

@@ -0,0 +1,50 @@
+import { ToolDefinition } from '../registry.js';
+import { ValidationWarning } from '../validation/eventCommands.js';
+import { ReferenceWarning } from '../validation/references.js';
+import { AssetWarning } from '../validation/assets.js';
+/**
+ * Validate a single event's command lists against the known-command table.
+ * Warn-by-default: this reports problems, it never modifies anything.
+ */
+export declare function validateEventTool(projectPath: string, mapId: number, eventId: number): Promise<{
+    mapId: number;
+    eventId: number;
+    ok: boolean;
+    warnings: ValidationWarning[];
+}>;
+/**
+ * Validate the event command lists of every map in the project. Aggregates each
+ * map's warnings, tagging them with the map ID so callers can locate them.
+ */
+export declare function validateProjectTool(projectPath: string): Promise<{
+    ok: boolean;
+    mapsChecked: number;
+    warnings: Array<ValidationWarning & {
+        mapId: number;
+    }>;
+}>;
+/**
+ * Cross-file reference-integrity audit for the whole project. Read-only and
+ * warn-by-default: reports dangling/cyclic references (a Transfer Player to a
+ * missing map, a skill effect adding a non-existent state, a troop member for a
+ * deleted enemy, a cyclic map tree, …) without changing anything. Complements
+ * `validate_project`, which only checks event-command *shape*.
+ */
+export declare function validateReferencesTool(projectPath: string): Promise<{
+    ok: boolean;
+    warnings: ReferenceWarning[];
+}>;
+/**
+ * Project-wide asset-*filename* audit (read-only, warn-by-default). Scans every
+ * asset-name field across the database, maps, and system against the files that
+ * actually exist on disk, reporting each dangling reference — the systematic
+ * complement to the per-record create-time warnings (a `battlerName` typo would
+ * otherwise only surface as a runtime "Failed to load …" error). The *id*-
+ * integrity sibling is `validate_references`.
+ */
+export declare function validateAssetsTool(projectPath: string): Promise<{
+    ok: boolean;
+    warnings: AssetWarning[];
+}>;
+export declare const validationToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=validationTools.d.ts.map

package/dist/tools/validationTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationTools.d.ts","sourceRoot":"","sources":["../../src/tools/validationTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAiC,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAElG,OAAO,EAAgC,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAIL,YAAY,EACb,MAAM,yBAAyB,CAAC;AAajC;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC,CAOzF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACtE,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,iBAAiB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,CAAC,CAuBD;AAgED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAIxD;AAwED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAOpD;AAED,eAAO,MAAM,yBAAyB,EAAE,cAAc,EAgCrD,CAAC"}