@yaebal/morda 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 neverlane
+
+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,13 @@
+# @yaebal/morda
+
+context inside a dialog: the base context plus the navigation control.
+
+## install
+
+```sh
+pnpm add @yaebal/morda
+```
+
+---
+
+part of [**yaebal**](https://github.com/neverlane/yaebal) — a type-safe, runtime-agnostic Telegram Bot API framework. MIT.

package/lib/index.d.ts

@@ -0,0 +1,69 @@
+import type { Context, Plugin } from "@yaebal/core";
+import { type StorageAdapter } from "@yaebal/session";
+/** context inside a dialog: the base context plus the navigation control. */
+export type DialogContext = Context & {
+    dialog: DialogControl;
+};
+/** a single button. `onClick` may navigate via `ctx.dialog`. */
+export interface Button {
+    id: string;
+    label: string;
+    onClick?: (ctx: DialogContext) => unknown;
+}
+/** what a window renders to: a message text and rows of buttons. */
+export interface WindowView {
+    text: string;
+    keyboard?: Button[][];
+}
+/** a window is rendered on demand, so its text/buttons can depend on context. */
+export type WindowRender = (ctx: DialogContext) => WindowView | Promise<WindowView>;
+/** a dialog is a flat map of named windows. */
+export type DialogDef = Record<string, WindowRender>;
+/** navigation control exposed as `ctx.dialog`. */
+export interface DialogControl {
+    /** open a window in a fresh message + stack. */
+    start(windowId: string): Promise<void>;
+    /** push a window onto the stack and edit the message. */
+    push(windowId: string): Promise<void>;
+    /** replace the top window and edit the message. */
+    replace(windowId: string): Promise<void>;
+    /** pop the stack; closing the dialog (deleting the message) at the root. */
+    back(): Promise<void>;
+    /** re-render the current window in place (after mutating external state). */
+    rerender(): Promise<void>;
+}
+/** persisted per-chat navigation state. */
+export interface DialogState {
+    stack: string[];
+    messageId: number;
+    chatId: number;
+}
+export interface DialogsOptions {
+    /** where to persist navigation state. defaults to in-memory (lost on restart). */
+    storage?: StorageAdapter<DialogState>;
+    /** fired when a window leaves the stack (popped, replaced, or dialog restarted).
+     *  the JSX layer uses this to drop a window's hook state so it re-mounts fresh. */
+    onLeave?: (chatId: number, windowId: string) => void;
+}
+/** A button that navigates to another window. */
+export declare function switchTo(label: string, windowId: string): Button;
+/** A button that pops the stack. */
+export declare function back(label?: string): Button;
+/** A plain action button. */
+export declare function button(label: string, opts: {
+    id: string;
+    onClick?: (ctx: DialogContext) => unknown;
+}): Button;
+/**
+ * Dialogs plugin. Renders declarative windows, routes button presses by stable
+ * id, and maintains a per-chat navigation stack — no manual `editMessageText`
+ * or callback_data wrangling.
+ *
+ * ponytail: builder-API has no auto re-render on state change — call
+ * `ctx.dialog.rerender()` after mutating data a window reads. The JSX/hooks
+ * layer (M2b) automates this via `useState`.
+ */
+export declare function dialogs(def: DialogDef, options?: DialogsOptions): Plugin<Context, {
+    dialog: DialogControl;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAEhE,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;CAC1C;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB;AAED,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEpF,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,yDAAyD;IACzD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,4EAA4E;IAC5E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,kFAAkF;IAClF,OAAO,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACtC;uFACmF;IACnF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,oCAAoC;AACpC,wBAAgB,IAAI,CAAC,KAAK,SAAY,GAAG,MAAM,CAE9C;AAED,6BAA6B;AAC7B,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAA;CAAE,GAC7D,MAAM,CAER;AASD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACtB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,cAAmB,GAC1B,MAAM,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAqH5C"}

package/lib/index.js

@@ -0,0 +1,156 @@
+import { callbackData } from "@yaebal/callback-data";
+import { InlineKeyboard } from "@yaebal/keyboard";
+import { MemoryStorage } from "@yaebal/session";
+/** A button that navigates to another window. */
+export function switchTo(label, windowId) {
+    return { id: `to:${windowId}`, label, onClick: (ctx) => ctx.dialog.push(windowId) };
+}
+/** A button that pops the stack. */
+export function back(label = "← Назад") {
+    return { id: "back", label, onClick: (ctx) => ctx.dialog.back() };
+}
+/** A plain action button. */
+export function button(label, opts) {
+    return { id: opts.id, label, onClick: opts.onClick };
+}
+function findButton(view, id) {
+    for (const row of view.keyboard ?? []) {
+        for (const b of row)
+            if (b.id === id)
+                return b;
+    }
+    return undefined;
+}
+/**
+ * Dialogs plugin. Renders declarative windows, routes button presses by stable
+ * id, and maintains a per-chat navigation stack — no manual `editMessageText`
+ * or callback_data wrangling.
+ *
+ * ponytail: builder-API has no auto re-render on state change — call
+ * `ctx.dialog.rerender()` after mutating data a window reads. The JSX/hooks
+ * layer (M2b) automates this via `useState`.
+ */
+export function dialogs(def, options = {}) {
+    const storage = options.storage ?? new MemoryStorage();
+    const cd = callbackData("dlg", { w: String, b: String });
+    const renderKeyboard = (windowId, view) => {
+        const kb = new InlineKeyboard();
+        for (const row of view.keyboard ?? []) {
+            for (const b of row)
+                kb.text(b.label, cd.pack({ w: windowId, b: b.id }));
+            kb.row();
+        }
+        return kb.build();
+    };
+    const renderWindow = async (w, ctx) => {
+        const window = def[w];
+        if (!window)
+            throw new Error(`morda: unknown window "${w}"`);
+        return window(ctx);
+    };
+    const control = (ctx) => {
+        const dctx = ctx;
+        const chatId = ctx.chat?.id;
+        const key = chatId?.toString();
+        const load = async () => key === undefined ? undefined : storage.get(key);
+        const edit = async (st) => {
+            const w = st.stack[st.stack.length - 1];
+            if (w === undefined || key === undefined)
+                return;
+            const view = await renderWindow(w, dctx);
+            await ctx.api.call("editMessageText", {
+                chat_id: st.chatId,
+                message_id: st.messageId,
+                text: view.text,
+                reply_markup: renderKeyboard(w, view),
+            });
+            await storage.set(key, st);
+        };
+        return {
+            async start(w) {
+                if (chatId === undefined || key === undefined) {
+                    throw new Error("morda: start() requires a chat");
+                }
+                const old = await storage.get(key);
+                if (old)
+                    for (const win of old.stack)
+                        options.onLeave?.(chatId, win);
+                const view = await renderWindow(w, dctx);
+                const msg = await ctx.send(view.text, { reply_markup: renderKeyboard(w, view) });
+                await storage.set(key, { stack: [w], messageId: msg.message_id, chatId });
+            },
+            async push(w) {
+                const st = await load();
+                if (!st)
+                    throw new Error("morda: push() with no active dialog");
+                st.stack.push(w);
+                await edit(st);
+            },
+            async replace(w) {
+                const st = await load();
+                if (!st)
+                    throw new Error("morda: replace() with no active dialog");
+                const oldTop = st.stack[st.stack.length - 1];
+                if (oldTop !== undefined && chatId !== undefined)
+                    options.onLeave?.(chatId, oldTop);
+                st.stack[st.stack.length - 1] = w;
+                await edit(st);
+            },
+            async back() {
+                const st = await load();
+                if (!st || key === undefined)
+                    return;
+                const popped = st.stack.pop();
+                if (popped !== undefined && chatId !== undefined)
+                    options.onLeave?.(chatId, popped);
+                if (st.stack.length === 0) {
+                    await ctx.api.call("deleteMessage", {
+                        chat_id: st.chatId,
+                        message_id: st.messageId,
+                    });
+                    await storage.delete(key);
+                    return;
+                }
+                await edit(st);
+            },
+            async rerender() {
+                const st = await load();
+                if (st)
+                    await edit(st);
+            },
+        };
+    };
+    // the Out type flows from `derive`, so no unsafe plugin cast is needed
+    const plugin = (composer) => composer
+        // expose ctx.dialog on every update
+        .derive((ctx) => ({ dialog: control(ctx) }))
+        // route dialog button presses; pass through everything else
+        .use(async (ctx, next) => {
+        const data = ctx.callbackQuery?.data;
+        if (data === undefined || !cd.filter(data))
+            return next();
+        const payload = cd.unpack(data);
+        if (!payload)
+            return next();
+        // clear the loading spinner; harmless if onClick answers again below
+        const answer = () => ctx.answerCallbackQuery().catch(() => { });
+        // stale-press guard: ignore presses whose window isn't the live stack top
+        // (e.g. a double-tap on an old keyboard before the edit landed).
+        const key = ctx.chat?.id?.toString();
+        const state = key === undefined ? undefined : await storage.get(key);
+        if (!state || state.stack[state.stack.length - 1] !== payload.w) {
+            await answer();
+            return;
+        }
+        const window = def[payload.w];
+        if (window) {
+            const view = await window(ctx);
+            const btn = findButton(view, payload.b);
+            if (btn?.onClick)
+                await btn.onClick(ctx);
+        }
+        await answer();
+    });
+    return plugin;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/lib/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/lib/index.test.js

@@ -0,0 +1,136 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Composer, Context } from "@yaebal/core";
+import { MemoryStorage } from "@yaebal/session";
+import { back, button, dialogs, switchTo } from "./index.js";
+const noop = async () => { };
+const entry = (c) => c.toMiddleware();
+function fakeApi() {
+    const calls = [];
+    let nextId = 100;
+    const api = {
+        sendMessage(params) {
+            calls.push({ method: "sendMessage", params });
+            return Promise.resolve({ message_id: nextId++ });
+        },
+        answerCallbackQuery(params) {
+            calls.push({ method: "answerCallbackQuery", params });
+            return Promise.resolve(true);
+        },
+        call(method, params) {
+            calls.push({ method, params });
+            return Promise.resolve(true);
+        },
+    };
+    return { api, calls };
+}
+const msgCtx = (api, text, chatId) => new Context({
+    api,
+    update: {
+        update_id: 1,
+        message: {
+            message_id: 1,
+            date: 0,
+            chat: { id: chatId, type: "private" },
+            from: { id: chatId, is_bot: false, first_name: "u" },
+            text,
+        },
+    },
+    updateType: "message",
+});
+const cbCtx = (api, data, chatId, messageId) => new Context({
+    api,
+    update: {
+        update_id: 1,
+        callback_query: {
+            id: "cb",
+            from: { id: chatId, is_bot: false, first_name: "u" },
+            message: { message_id: messageId, date: 0, chat: { id: chatId, type: "private" } },
+            data,
+        },
+    },
+    updateType: "callback_query",
+});
+const def = {
+    main: () => ({
+        text: "main",
+        keyboard: [
+            [switchTo("settings →", "settings")],
+            [button("ping", { id: "ping", onClick: (c) => c.answerCallbackQuery({ text: "pong" }) })],
+        ],
+    }),
+    settings: () => ({ text: "Settings", keyboard: [[back("← Back")]] }),
+};
+// read a button's callback_data straight from a recorded keyboard — no coupling
+// to morda's internal encoding.
+// biome-ignore lint/suspicious/noExplicitAny: reaching into recorded params
+const dataAt = (params, row, col) => params.reply_markup.inline_keyboard[row][col].callback_data;
+test("start → push(settings) → back navigates and edits in place", async () => {
+    const { api, calls } = fakeApi();
+    const storage = new MemoryStorage();
+    const mw = entry(new Composer()
+        .install(dialogs(def, { storage }))
+        .command("go", (ctx) => ctx.dialog.start("main")));
+    await mw(msgCtx(api, "/go", 1), noop);
+    const sent = calls.find((c) => c.method === "sendMessage");
+    assert.equal(sent?.params.text, "main");
+    const state = await storage.get("1");
+    assert.deepEqual(state?.stack, ["main"]);
+    // press "settings →"
+    calls.length = 0;
+    await mw(cbCtx(api, dataAt(sent?.params, 0, 0), 1, state?.messageId ?? 0), noop);
+    const edit1 = calls.find((c) => c.method === "editMessageText");
+    assert.equal(edit1?.params.text, "Settings");
+    assert.deepEqual((await storage.get("1"))?.stack, ["main", "settings"]);
+    // press "← back"
+    calls.length = 0;
+    await mw(cbCtx(api, dataAt(edit1?.params, 0, 0), 1, state?.messageId ?? 0), noop);
+    const edit2 = calls.find((c) => c.method === "editMessageText");
+    assert.equal(edit2?.params.text, "main");
+    assert.deepEqual((await storage.get("1"))?.stack, ["main"]);
+});
+test("onClick runs without navigating", async () => {
+    const { api, calls } = fakeApi();
+    const storage = new MemoryStorage();
+    const mw = entry(new Composer()
+        .install(dialogs(def, { storage }))
+        .command("go", (ctx) => ctx.dialog.start("main")));
+    await mw(msgCtx(api, "/go", 1), noop);
+    const sent = calls.find((c) => c.method === "sendMessage");
+    calls.length = 0;
+    // press "ping" (row 1)
+    await mw(cbCtx(api, dataAt(sent?.params, 1, 0), 1, 100), noop);
+    assert.ok(calls.some((c) => c.method === "answerCallbackQuery" && c.params.text === "pong"));
+    assert.equal(calls.find((c) => c.method === "editMessageText"), undefined);
+    assert.deepEqual((await storage.get("1"))?.stack, ["main"]); // unchanged
+});
+test("a press whose window is not the stack top is ignored", async () => {
+    const { api, calls } = fakeApi();
+    const storage = new MemoryStorage();
+    const mw = entry(new Composer()
+        .install(dialogs(def, { storage }))
+        .command("go", (ctx) => ctx.dialog.start("main")));
+    await mw(msgCtx(api, "/go", 1), noop);
+    const sent = calls.find((c) => c.method === "sendMessage");
+    // navigate to settings → stack top is now "settings"
+    await mw(cbCtx(api, dataAt(sent?.params, 0, 0), 1, 100), noop);
+    calls.length = 0;
+    // press the OLD "ping" button from main (payload.w = "main") while on "settings"
+    await mw(cbCtx(api, dataAt(sent?.params, 1, 0), 1, 100), noop);
+    assert.equal(calls.some((c) => c.method === "answerCallbackQuery" && c.params.text === "pong"), false);
+    assert.deepEqual((await storage.get("1"))?.stack, ["main", "settings"]); // unchanged
+});
+test("back() at the root closes the dialog", async () => {
+    const { api, calls } = fakeApi();
+    const storage = new MemoryStorage();
+    const mw = entry(new Composer()
+        .install(dialogs(def, { storage }))
+        .command("go", (ctx) => ctx.dialog.start("main"))
+        .command("close", (ctx) => ctx.dialog.back()));
+    await mw(msgCtx(api, "/go", 2), noop);
+    calls.length = 0;
+    await mw(msgCtx(api, "/close", 2), noop);
+    assert.ok(calls.some((c) => c.method === "deleteMessage"));
+    assert.equal(await storage.get("2"), undefined);
+});
+//# sourceMappingURL=index.test.js.map

package/lib/index.test.js.map

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

package/lib/jsx/index.d.ts

@@ -0,0 +1,48 @@
+import type { Context, Plugin, User } from "@yaebal/core";
+import { type DialogControl, type DialogsOptions } from "../index.js";
+import { type VNode } from "./jsx-runtime.js";
+export type { VNode } from "./jsx-runtime.js";
+/** a screen is a component: a zero-arg function returning a `<Screen>` tree. */
+export type ScreenComponent = () => VNode;
+export interface ButtonProps {
+    id: string;
+    onClick?: () => unknown;
+    children?: unknown;
+}
+export declare function Screen(props: {
+    children?: unknown;
+}): VNode;
+export declare function ButtonRow(props: {
+    children?: unknown;
+}): VNode;
+export declare function Button(props: ButtonProps): VNode;
+/** per-frame state. `setState` re-renders the screen in place and resolves when the edit lands. */
+export declare function useState<T>(initial: T | (() => T)): [T, (next: T | ((prev: T) => T)) => Promise<void>];
+/**
+ * run an effect after the screen renders. `deps` gate re-runs.
+ * prefer passing `deps` — the no-deps form fires on every *internal* render
+ * (a button press renders once to route and again to commit), not once per tap.
+ */
+export declare function useEffect(fn: () => unknown, deps?: unknown[]): void;
+export interface Navigation {
+    push(target: ScreenComponent | string): Promise<void>;
+    replace(target: ScreenComponent | string): Promise<void>;
+    back(): Promise<void>;
+}
+/** navigate by screen component (or window id). */
+export declare function useNavigation(): Navigation;
+/** the telegram user behind the current update. */
+export declare function useUser(): User | undefined;
+/** the session session (requires `@yaebal/session` installed before the dialog). */
+export declare function useSession<S>(): S;
+export interface Translation {
+    t(key: string, ...args: unknown[]): string;
+    changeLanguage(language: string): unknown;
+}
+/** i18n helpers (requires `@yaebal/i18n` installed before the dialog). */
+export declare function useTranslation(): Translation;
+/** install a set of JSX screens as a dialog. `bot.install(jsxDialogs({ main, settings }))`. */
+export declare function jsxDialogs(screens: Record<string, ScreenComponent>, options?: DialogsOptions): Plugin<Context, {
+    dialog: DialogControl;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/lib/jsx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAEN,KAAK,aAAa,EAElB,KAAK,cAAc,EAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE/D,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAE3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAE9D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAEhD;AAmBD,mGAAmG;AACnG,wBAAgB,QAAQ,CAAC,CAAC,EACzB,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GACpB,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAkBpD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CASnE;AAOD,MAAM,WAAW,UAAU;IAC1B,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,mDAAmD;AACnD,wBAAgB,aAAa,IAAI,UAAU,CAkB1C;AAED,mDAAmD;AACnD,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAE1C;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,KAAK,CAAC,CAEjC;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,WAAW,CAQ5C;AA0JD,+FAA+F;AAC/F,wBAAgB,UAAU,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxC,OAAO,CAAC,EAAE,cAAc,GACtB,MAAM,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAkB5C"}