@sattori/touhou-replay-parser 0.1.0

package/dist/games/th18.d.ts

@@ -0,0 +1,4 @@
+import { type ParsedReplay } from "../types.js";
+/** t18r (東方虹龍洞, UM) decoder. Ported from Read_t18r in threplay. */
+export declare function parseTh18(original: Uint8Array): ParsedReplay;
+//# sourceMappingURL=th18.d.ts.map

package/dist/games/th18.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"th18.d.ts","sourceRoot":"","sources":["../../src/games/th18.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4C,KAAK,YAAY,EAAyB,MAAM,aAAa,CAAC;AAIjH,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,YAAY,CAwD5D"}

package/dist/games/th18.js

@@ -0,0 +1,58 @@
+import { ByteReader } from "../byte-reader.js";
+import { readBufferedUint32LE } from "../lzss.js";
+import { readModernUserdata } from "../userdata.js";
+import { emptySplit, normalizeText, resourceCount } from "../types.js";
+import { REPLAY_GAME_TITLES } from "../game-ids.js";
+import { decodeModernBody } from "./modern-body.js";
+/** t18r (東方虹龍洞, UM) decoder. Ported from Read_t18r in threplay. */
+export function parseTh18(original) {
+    const decodedata = decodeModernBody(original, { blockSize: 0x400, base: 0x5c, add: 0xe1 }, { blockSize: 0x100, base: 0x7d, add: 0x3a });
+    const splits = [];
+    let stageOffset = 0xc8;
+    let frameCount = 0;
+    const stageCount = Math.min(decodedata[0xa8] ?? 0, 6);
+    for (let i = 0; i < stageCount; i++) {
+        const split = emptySplit();
+        split.stage = decodedata[stageOffset] ?? null;
+        split.score = readBufferedUint32LE(decodedata, stageOffset + 0x88) * 10;
+        split.power = (readBufferedUint32LE(decodedata, stageOffset + 0xc4) / 100).toFixed(2);
+        split.piv = readBufferedUint32LE(decodedata, stageOffset + 0xbc);
+        const lives = decodedata[stageOffset + 0xd4] ?? 0;
+        const livePieces = decodedata[stageOffset + 0xd8] ?? 0;
+        const bombs = decodedata[stageOffset + 0xe4] ?? 0;
+        const bombPieces = decodedata[stageOffset + 0xe8] ?? 0;
+        const cards = [];
+        for (let cardByteOffset = 0x160; cardByteOffset < 1376; cardByteOffset += 4) {
+            const cardId = readBufferedUint32LE(decodedata, stageOffset + cardByteOffset);
+            if (cardId === 0xffffffff)
+                break;
+            cards.push(cardId);
+        }
+        const active = readBufferedUint32LE(decodedata, stageOffset + 2400);
+        split.additional = { cards, active };
+        split.lives = resourceCount(lives, livePieces, 3);
+        split.graze = 0;
+        split.bombs = resourceCount(bombs, bombPieces, 3);
+        const stageFrameCount = readBufferedUint32LE(decodedata, stageOffset + 0x4);
+        split.frameCount = stageFrameCount;
+        splits.push(split);
+        frameCount += stageFrameCount;
+        stageOffset += readBufferedUint32LE(decodedata, stageOffset + 0x8) + 0x126c;
+    }
+    const userdata = readModernUserdata(new ByteReader(original));
+    return {
+        game: "th18",
+        gameTitle: REPLAY_GAME_TITLES.th18,
+        formatVersion: null,
+        player: normalizeText(userdata.name),
+        date: normalizeText(userdata.date),
+        character: normalizeText(userdata.character),
+        difficulty: normalizeText(userdata.difficulty),
+        stage: normalizeText(userdata.stage),
+        score: userdata.score,
+        cleared: userdata.stage.includes("Clear"),
+        splits,
+        frameCount: stageCount > 0 ? frameCount : null,
+    };
+}
+//# sourceMappingURL=th18.js.map

package/dist/games/th18.js.map

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

package/dist/games/th20.d.ts

@@ -0,0 +1,22 @@
+import { type ParsedReplay } from "../types.js";
+/**
+ * t20r (東方錦上京, FW) decoder.
+ *
+ * threplay (raviddog/threplay, the upstream this package was ported from)
+ * only covers up to th18; th20 is implemented based on this package's own
+ * investigation. The USER section layout (player name, date, character,
+ * difficulty, stage, score after JumpToUser(12)) has been confirmed to be
+ * identical to th10-th18 by cross-checking real replays
+ * (`touhou-recorder/games/th20/replay/*.rpy`) against screenshots.
+ *
+ * On the other hand, the "per-stage breakdown via XOR decoding + LZSS
+ * decompression using the length/dlength at header offset 0x1c/0x20" present
+ * in th10-th18 does not appear to carry the same meaning in th20: across all
+ * 3 samples on hand, the decompressed size stays constant (256 bytes)
+ * regardless of progress (likely because a format change moved that data
+ * elsewhere). Since the stage-breakdown structure has not been analyzed yet,
+ * `splits` always returns an empty array (name/date/character/difficulty/stage/score
+ * can still be obtained).
+ */
+export declare function parseTh20(original: Uint8Array): ParsedReplay;
+//# sourceMappingURL=th20.d.ts.map

package/dist/games/th20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"th20.d.ts","sourceRoot":"","sources":["../../src/games/th20.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,YAAY,CAiB5D"}

package/dist/games/th20.js

@@ -0,0 +1,41 @@
+import { ByteReader } from "../byte-reader.js";
+import { readModernUserdata } from "../userdata.js";
+import { normalizeText } from "../types.js";
+import { REPLAY_GAME_TITLES } from "../game-ids.js";
+/**
+ * t20r (東方錦上京, FW) decoder.
+ *
+ * threplay (raviddog/threplay, the upstream this package was ported from)
+ * only covers up to th18; th20 is implemented based on this package's own
+ * investigation. The USER section layout (player name, date, character,
+ * difficulty, stage, score after JumpToUser(12)) has been confirmed to be
+ * identical to th10-th18 by cross-checking real replays
+ * (`touhou-recorder/games/th20/replay/*.rpy`) against screenshots.
+ *
+ * On the other hand, the "per-stage breakdown via XOR decoding + LZSS
+ * decompression using the length/dlength at header offset 0x1c/0x20" present
+ * in th10-th18 does not appear to carry the same meaning in th20: across all
+ * 3 samples on hand, the decompressed size stays constant (256 bytes)
+ * regardless of progress (likely because a format change moved that data
+ * elsewhere). Since the stage-breakdown structure has not been analyzed yet,
+ * `splits` always returns an empty array (name/date/character/difficulty/stage/score
+ * can still be obtained).
+ */
+export function parseTh20(original) {
+    const userdata = readModernUserdata(new ByteReader(original));
+    return {
+        game: "th20",
+        gameTitle: REPLAY_GAME_TITLES.th20,
+        formatVersion: null,
+        player: normalizeText(userdata.name),
+        date: normalizeText(userdata.date),
+        character: normalizeText(userdata.character),
+        difficulty: normalizeText(userdata.difficulty),
+        stage: normalizeText(userdata.stage),
+        score: userdata.score,
+        cleared: userdata.stage.includes("Clear"),
+        splits: [],
+        frameCount: null,
+    };
+}
+//# sourceMappingURL=th20.js.map

package/dist/games/th20.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"th20.js","sourceRoot":"","sources":["../../src/games/th20.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE9D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,kBAAkB,CAAC,IAAI;QAClC,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC5C,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC9C,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { ReplayParseResult } from "./types.js";
+export * from "./game-ids.js";
+export * from "./types.js";
+export { ReplayCorruptError } from "./errors.js";
+export declare function parseReplay(data: Uint8Array): ReplayParseResult;
+//# 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":"AAkBA,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA6BjD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAyB/D"}

package/dist/index.js

@@ -0,0 +1,70 @@
+import { ReplayCorruptError } from "./errors.js";
+import { parseTh06 } from "./games/th06.js";
+import { parseTh07 } from "./games/th07.js";
+import { parseTh08 } from "./games/th08.js";
+import { parseTh09 } from "./games/th09.js";
+import { parseTh095 } from "./games/th095.js";
+import { parseTh125 } from "./games/th125.js";
+import { parseTh128 } from "./games/th128.js";
+import { parseTh143Family } from "./games/th143.js";
+import { parseTh10 } from "./games/th10.js";
+import { parseTh11 } from "./games/th11.js";
+import { parseTh12 } from "./games/th12.js";
+import { parseTh1314 } from "./games/th13-14.js";
+import { parseTh15 } from "./games/th15.js";
+import { parseTh16 } from "./games/th16.js";
+import { parseTh17 } from "./games/th17.js";
+import { parseTh18 } from "./games/th18.js";
+import { parseTh20 } from "./games/th20.js";
+export * from "./game-ids.js";
+export * from "./types.js";
+export { ReplayCorruptError } from "./errors.js";
+function magicOf(buffer) {
+    return Array.from(buffer.subarray(0, 4), (b) => String.fromCharCode(b)).join("");
+}
+const DECODERS = {
+    T6RP: parseTh06,
+    T7RP: parseTh07,
+    T8RP: parseTh08,
+    T9RP: parseTh09,
+    t95r: parseTh095,
+    t125: parseTh125,
+    "128r": parseTh128,
+    t143: (buffer) => parseTh143Family(buffer, "th143"),
+    t156: (buffer) => parseTh143Family(buffer, "th165"),
+    t10r: parseTh10,
+    t11r: parseTh11,
+    t12r: parseTh12,
+    t13r: parseTh1314,
+    t15r: parseTh15,
+    t16r: parseTh16,
+    t17r: parseTh17,
+    t18r: parseTh18,
+    t20r: parseTh20,
+};
+export function parseReplay(data) {
+    if (data.length < 4) {
+        return { ok: false, error: { code: "too_short", message: "file is shorter than the 4-byte magic header" } };
+    }
+    const magic = magicOf(data);
+    const decode = DECODERS[magic];
+    if (!decode) {
+        return {
+            ok: false,
+            error: { code: "unknown_magic", message: `unrecognized replay magic: ${JSON.stringify(magic)}` },
+        };
+    }
+    try {
+        const replay = decode(data);
+        return { ok: true, replay };
+    }
+    catch (error) {
+        if (error instanceof ReplayCorruptError) {
+            return { ok: false, error: { code: "corrupt", message: error.message } };
+        }
+        // Fail safe on unknown exceptions too — never throw.
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: { code: "corrupt", message: `unexpected error while parsing: ${message}` } };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lzss.d.ts

@@ -0,0 +1,16 @@
+export declare function assertSaneAllocSize(n: number, what: string): void;
+/**
+ * An LZSS-family decompressor (13-bit dictionary / 4-bit run length) ported
+ * from decompress() in threp (https://github.com/Fluorohydride/threp/blob/master/common.cpp).
+ * `length` is the input (compressed) byte count, `outLength` is the expected decompressed byte count.
+ */
+export declare function decompress(buffer: Uint8Array, length: number, outLength: number): Uint8Array;
+/**
+ * Ported from threp's decode() (block-wise XOR deobfuscation).
+ * Rewrites the first `length` bytes of `buffer` in place.
+ */
+export declare function xorBlockDecode(buffer: Uint8Array, length: number, blockSizeInit: number, baseInit: number, add: number): void;
+/** Decodes the simple additive-key scheme used by the older format (th06-09). */
+export declare function additiveKeyDecode(buffer: Uint8Array, start: number, initialKey: number, increment: number): void;
+export declare function readBufferedUint32LE(buffer: Uint8Array, offset: number): number;
+//# sourceMappingURL=lzss.d.ts.map

package/dist/lzss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzss.d.ts","sourceRoot":"","sources":["../src/lzss.ts"],"names":[],"mappings":"AASA,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIjE;AAoCD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CA0C5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAqC7H;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAMhH;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO/E"}

package/dist/lzss.js

@@ -0,0 +1,147 @@
+import { ReplayCorruptError } from "./errors.js";
+/**
+ * Upper bound (64MiB) used to sanity-check decompressed sizes.
+ * The header's length/dlength fields are untrusted external input, so
+ * without this guard an invalid huge value would attempt an unbounded allocation.
+ */
+const MAX_ALLOC_BYTES = 64 * 1024 * 1024;
+export function assertSaneAllocSize(n, what) {
+    if (!Number.isFinite(n) || n < 0 || n > MAX_ALLOC_BYTES) {
+        throw new ReplayCorruptError(`implausible ${what}: ${n}`);
+    }
+}
+function getBit(buffer, length, cursor, bitLength) {
+    // https://github.com/Fluorohydride/thprac/blob/master/common.cpp (ported from get_bit in common.cpp)
+    let result = 0;
+    for (let i = 0; i < bitLength; i++) {
+        result <<= 1;
+        if (cursor.pointer >= length) {
+            // The original implementation can read past the buffer boundary, but this
+            // is harmless because the caller immediately checks `pointer >= length`
+            // and stops. Here we fail safe by zero-filling.
+            cursor.filter >>= 1;
+            if (cursor.filter === 0) {
+                cursor.pointer++;
+                cursor.filter = 0x80;
+            }
+            continue;
+        }
+        const current = buffer[cursor.pointer];
+        if ((current & cursor.filter) !== 0) {
+            result |= 1;
+        }
+        cursor.filter >>= 1;
+        if (cursor.filter === 0) {
+            cursor.pointer++;
+            cursor.filter = 0x80;
+        }
+    }
+    return result >>> 0;
+}
+/**
+ * An LZSS-family decompressor (13-bit dictionary / 4-bit run length) ported
+ * from decompress() in threp (https://github.com/Fluorohydride/threp/blob/master/common.cpp).
+ * `length` is the input (compressed) byte count, `outLength` is the expected decompressed byte count.
+ */
+export function decompress(buffer, length, outLength) {
+    assertSaneAllocSize(outLength, "decompressed length");
+    // length is an untrusted value read from the header. A value exceeding the
+    // buffer's actual size indicates corrupt data, and using it as-is would let
+    // the loop run for an unreasonably long time relative to the actual data
+    // size (a potential DoS), so we clamp it here to a physically possible value.
+    const boundedLength = Math.min(length, buffer.length);
+    const decoded = new Uint8Array(outLength);
+    const dict = new Uint8Array(0x2010);
+    const cursor = { pointer: 0, filter: 0x80 };
+    let dest = 0;
+    while (cursor.pointer < boundedLength && dest < outLength) {
+        const flag = getBit(buffer, boundedLength, cursor, 1);
+        if (cursor.pointer >= boundedLength)
+            break;
+        if (flag !== 0) {
+            const byte = getBit(buffer, boundedLength, cursor, 8);
+            if (cursor.pointer >= boundedLength)
+                break;
+            decoded[dest] = byte;
+            dict[dest & 0x1fff] = byte;
+            dest++;
+        }
+        else {
+            const indexBits = getBit(buffer, boundedLength, cursor, 13);
+            if (cursor.pointer >= boundedLength)
+                break;
+            const index = indexBits - 1;
+            let runLength = getBit(buffer, boundedLength, cursor, 4);
+            if (cursor.pointer >= boundedLength)
+                break;
+            runLength += 3;
+            for (let i = 0; i < runLength && dest < outLength; i++) {
+                // index can be negative or out of range for invalid input, but
+                // out-of-range TypedArray read/write does not throw and is
+                // coerced to undefined -> 0, so this is safe.
+                const value = dict[(index + i) & 0x1fff] ?? 0;
+                dict[dest & 0x1fff] = value;
+                decoded[dest] = value;
+                dest++;
+            }
+        }
+    }
+    return decoded;
+}
+/**
+ * Ported from threp's decode() (block-wise XOR deobfuscation).
+ * Rewrites the first `length` bytes of `buffer` in place.
+ */
+export function xorBlockDecode(buffer, length, blockSizeInit, baseInit, add) {
+    assertSaneAllocSize(length, "xorBlockDecode length");
+    if (length > buffer.length) {
+        throw new ReplayCorruptError(`xorBlockDecode: length ${length} exceeds buffer size ${buffer.length}`);
+    }
+    const tbuf = buffer.slice(0, length);
+    let blockSize = blockSizeInit;
+    let p = 0;
+    let left = length;
+    if (left % blockSize < Math.floor(blockSize / 4)) {
+        left -= left % blockSize;
+    }
+    left -= length & 1;
+    let base = baseInit & 0xff;
+    while (left !== 0) {
+        if (left < blockSize)
+            blockSize = left;
+        let tp1 = p + blockSize - 1;
+        let tp2 = p + blockSize - 2;
+        let half = (blockSize + (blockSize & 1)) >> 1;
+        for (let i = 0; i < half; i++, p++) {
+            if (tp1 >= 0 && tp1 < buffer.length && p < tbuf.length) {
+                buffer[tp1] = (tbuf[p] ^ base) & 0xff;
+            }
+            base = (base + add) & 0xff;
+            tp1 -= 2;
+        }
+        half = blockSize >> 1;
+        for (let i = 0; i < half; i++, p++) {
+            if (tp2 >= 0 && tp2 < buffer.length && p < tbuf.length) {
+                buffer[tp2] = (tbuf[p] ^ base) & 0xff;
+            }
+            base = (base + add) & 0xff;
+            tp2 -= 2;
+        }
+        left -= blockSize;
+    }
+}
+/** Decodes the simple additive-key scheme used by the older format (th06-09). */
+export function additiveKeyDecode(buffer, start, initialKey, increment) {
+    let key = initialKey & 0xff;
+    for (let i = start; i < buffer.length; i++) {
+        buffer[i] = (buffer[i] - key) & 0xff;
+        key = (key + increment) & 0xff;
+    }
+}
+export function readBufferedUint32LE(buffer, offset) {
+    if (offset < 0 || offset + 4 > buffer.length) {
+        throw new ReplayCorruptError(`readBufferedUint32LE out of range at ${offset} (length ${buffer.length})`);
+    }
+    return ((buffer[offset] | (buffer[offset + 1] << 8) | (buffer[offset + 2] << 16) | (buffer[offset + 3] << 24)) >>> 0);
+}
+//# sourceMappingURL=lzss.js.map

package/dist/lzss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzss.js","sourceRoot":"","sources":["../src/lzss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;GAIG;AACH,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,CAAS,EAAE,IAAY;IACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC;QACxD,MAAM,IAAI,kBAAkB,CAAC,eAAe,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAOD,SAAS,MAAM,CAAC,MAAkB,EAAE,MAAc,EAAE,MAAiB,EAAE,SAAiB;IACtF,qGAAqG;IACrG,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,KAAK,CAAC,CAAC;QACb,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,0EAA0E;YAC1E,wEAAwE;YACxE,gDAAgD;YAChD,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;YACpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAE,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QACD,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB,EAAE,MAAc,EAAE,SAAiB;IAC9E,mBAAmB,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACtD,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,8EAA8E;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,GAAc,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,MAAM,CAAC,OAAO,GAAG,aAAa,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,OAAO,IAAI,aAAa;YAAE,MAAM;QAE3C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,OAAO,IAAI,aAAa;gBAAE,MAAM;YAC3C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC;YAC3B,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,OAAO,IAAI,aAAa;gBAAE,MAAM;YAC3C,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;YAC5B,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,OAAO,IAAI,aAAa;gBAAE,MAAM;YAC3C,SAAS,IAAI,CAAC,CAAC;YACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvD,+DAA+D;gBAC/D,2DAA2D;gBAC3D,8CAA8C;gBAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;gBACtB,IAAI,EAAE,CAAC;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,MAAc,EAAE,aAAqB,EAAE,QAAgB,EAAE,GAAW;IACrH,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAAC,0BAA0B,MAAM,wBAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,SAAS,GAAG,aAAa,CAAC;IAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;QACjD,IAAI,IAAI,IAAI,GAAG,SAAS,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;IAEnB,IAAI,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QAClB,IAAI,IAAI,GAAG,SAAS;YAAE,SAAS,GAAG,IAAI,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACzC,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;YAC3B,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QACD,IAAI,GAAG,SAAS,IAAI,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;YACzC,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;YAC3B,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,SAAS,CAAC;IACpB,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,MAAkB,EAAE,KAAa,EAAE,UAAkB,EAAE,SAAiB;IACxG,IAAI,GAAG,GAAG,UAAU,GAAG,IAAI,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;QACtC,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAkB,EAAE,MAAc;IACrE,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,kBAAkB,CAAC,wCAAwC,MAAM,YAAY,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,CACL,CAAC,MAAM,CAAC,MAAM,CAAE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CACjH,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+import type { ReplayGameId } from "./game-ids.js";
+/**
+ * A resource count made up of a "whole unit count" plus "fragments toward the
+ * next unit," as used for lives, bombs, etc. `pieces`/`maxPieces` are null for
+ * games without a fragment system, or when the data cannot be obtained for
+ * that game.
+ *
+ * Exception: th128 (妖精大戦争, GFW) uses this field as a percentage gauge —
+ * `count` holds the percentage (0-100+), `maxPieces` is always 100, and
+ * `pieces` is always null (see the comments in that file).
+ */
+export interface ReplayResourceCount {
+    /** The whole unit count (or a percentage, for th128 only). */
+    count: number;
+    /** Number of fragments collected toward the next unit. */
+    pieces: number | null;
+    /** The fragment maximum (denominator). Null if it cannot be determined. */
+    maxPieces: number | null;
+}
+/**
+ * A per-stage record. Games track different fields, so fields not tracked by
+ * a given game are null.
+ */
+export interface ReplayStageSplit {
+    /**
+     * Stage number (null if it cannot be determined). Most games record this
+     * as a snapshot taken "at the start of the stage," so fields like `score`
+     * effectively reflect the value "at the end of the previous stage"
+     * (this matches the value shown on the "Stage N" line of the original
+     * game's replay selection screen).
+     */
+    stage: number | null;
+    /** Score at the time of this snapshot. */
+    score: number | null;
+    /** Power (kept as a string since notation differs by game, e.g. "1.00", "128"). */
+    power: string | null;
+    /** Game-specific score metric such as PIV (Point of Item Value). */
+    piv: number | null;
+    /** Lives. */
+    lives: ReplayResourceCount | null;
+    /** Bomb count. */
+    bombs: ReplayResourceCount | null;
+    /** Graze count. */
+    graze: number | null;
+    /**
+     * Game-specific extra info such as UFO color, trance, season, etc. Key
+     * names and value shapes differ by game (see the comments in each game's
+     * decoder implementation). Null for games without such data.
+     */
+    additional: Record<string, number | string | (number | string)[]> | null;
+    /**
+     * Number of in-game frames played during this stage/segment (i.e. from
+     * this checkpoint up to the next one, or to the end of the replay for the
+     * last split). See `ParsedReplay.frameCount` for the fixed-60fps
+     * conversion to seconds and the games this is currently populated for.
+     * Null for games where this package does not (yet) know how to locate the
+     * per-frame input log.
+     */
+    frameCount: number | null;
+}
+/**
+ * The full set of information extractable from a `.rpy` file. `ReplayInfo` in
+ * `packages/shared` corresponds to a subset of this type (only the fields
+ * needed for Sattori's recording metadata display).
+ */
+export interface ParsedReplay {
+    game: ReplayGameId;
+    gameTitle: string;
+    /**
+     * The raw format/version byte read from the header (its meaning and offset
+     * differ by game). Can be used as a clue to identify replays recorded with
+     * an incompatible version of the original game (used by Sattori for #16
+     * detection). Null for games where this cannot be determined.
+     */
+    formatVersion: number | null;
+    player: string | null;
+    /** Recording date/time, kept verbatim as it appears in the source data (e.g. "25/12/31"). */
+    date: string | null;
+    character: string | null;
+    difficulty: string | null;
+    /** The reached/recorded stage or scene notation (e.g. "Stage 6", "Extra"). */
+    stage: string | null;
+    score: number | null;
+    /**
+     * True/false only when a full clear (equivalent to "Player Wins") could be
+     * detected. Null for games/replay types with no way to determine this.
+     */
+    cleared: boolean | null;
+    /** Per-stage records (empty array for games where this cannot be determined). */
+    splits: ReplayStageSplit[];
+    /**
+     * Total number of in-game frames the replay plays back (all recorded
+     * stages/segments summed). The main-series games run gameplay logic at a
+     * fixed 60 frames/sec, so dividing by 60 gives the playback duration in
+     * seconds. This is the number of frames the game itself will replay, and
+     * does not include any recording-pipeline overhead (menu automation,
+     * end-of-replay detection lag, etc.) on top of that.
+     * Null for games/replay types where this package does not (yet) know how
+     * to locate the per-frame input log.
+     */
+    frameCount: number | null;
+}
+export type ReplayParseErrorCode = 
+/** The file is too short to even read the magic bytes. */
+"too_short"
+/** The first 4 bytes don't match any known Touhou replay magic. */
+ | "unknown_magic"
+/** The magic is a known format, but the data that follows is invalid and cannot be safely parsed further. */
+ | "corrupt";
+export interface ReplayParseError {
+    code: ReplayParseErrorCode;
+    message: string;
+}
+export type ReplayParseResult = {
+    ok: true;
+    replay: ParsedReplay;
+} | {
+    ok: false;
+    error: ReplayParseError;
+};
+/** Strips padding whitespace from fixed-length fields. An empty string is treated as null. */
+export declare function normalizeText(value: string): string | null;
+export declare function emptySplit(): ReplayStageSplit;
+export declare function resourceCount(count: number, pieces?: number | null, maxPieces?: number | null): ReplayResourceCount;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,kBAAkB;IAClB,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,mBAAmB;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACzE;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6FAA6F;IAC7F,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,iFAAiF;IACjF,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;;;;;OASG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB;AAC9B,0DAA0D;AACxD,WAAW;AACb,mEAAmE;GACjE,eAAe;AACjB,6GAA6G;GAC3G,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE5G,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAY7C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,mBAAmB,CAE/H"}

package/dist/types.js

@@ -0,0 +1,22 @@
+/** Strips padding whitespace from fixed-length fields. An empty string is treated as null. */
+export function normalizeText(value) {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function emptySplit() {
+    return {
+        stage: null,
+        score: null,
+        power: null,
+        piv: null,
+        lives: null,
+        bombs: null,
+        graze: null,
+        additional: null,
+        frameCount: null,
+    };
+}
+export function resourceCount(count, pieces = null, maxPieces = null) {
+    return { count, pieces, maxPieces };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyHA,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAM,GAAkB,IAAI,EAAE,SAAS,GAAkB,IAAI;IACxG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACtC,CAAC"}

package/dist/userdata.d.ts

@@ -0,0 +1,24 @@
+import { ByteReader } from "./byte-reader.js";
+/**
+ * Equivalent to JumpToUser in threplay. Reads the 4-byte offset value at
+ * `pointerFieldOffset`, confirms a "USER" marker exists at that position, and
+ * then advances the cursor just past it.
+ */
+export declare function jumpToUser(reader: ByteReader, pointerFieldOffset: number): void;
+/** Equivalent to `long.TryParse(text + "0", ...)`. Restores the omitted trailing digit before converting to a number. */
+export declare function parseScoreWithTrailingZero(text: string): number | null;
+export declare function parseIntStrict(text: string): number | null;
+export interface CommonUserdataFields {
+    name: string;
+    date: string;
+    character: string;
+    difficulty: string;
+    stage: string;
+    score: number | null;
+}
+/**
+ * The USER section layout shared by th10 (東方風神録, MoF) through
+ * th18 (東方虹龍洞, UM) (ported from threplay's `Read_Userdata`).
+ */
+export declare function readModernUserdata(reader: ByteReader): CommonUserdataFields;
+//# sourceMappingURL=userdata.d.ts.map

package/dist/userdata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.d.ts","sourceRoot":"","sources":["../src/userdata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAQ/E;AAED,yHAAyH;AACzH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1D;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,oBAAoB,CAkB3E"}