@yunzai-ng/core 0.1.0

package/dist/adapter/host.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 模块职责：`AdapterHost` 实现 —— 内核给每个账号的宿主能力面
+ * 依赖方向：依赖类型包、plugin/hooks 的 `ServerSink`、util/*；**不认识任何适配器实现**
+ * 生命周期：一个账号一个实例；随账号断开而回收（`DisposalRegistry` 逆序）
+ * 注意事项：适配器插件只拿到这个对象，拿不到内核内部。它解决三件事：
+ *
+ *          **事件投递的闸门。** `BotDriver` 的契约写明「内核会在卸载时调 `disconnect()`，并断言
+ *          其后不再有事件投递进来」。这条断言由此处兑现：`signal` 一经 abort，`submit()` 立即开始
+ *          丢弃并计数 —— 不能指望适配器一定彻底停掉自己的 socket 回调，否则热重载后会收到重复回复。
+ *
+ *          **服务器晚绑定。** HTTP 服务器装配得比适配器插件晚，故 `server` 是 getter、`ServerSink`
+ *          是取值函数：适配器在 `createBot()` 里存下 host，真要挂 webhook 时读到的是当时的实际状态。
+ *          服务器没开时 `info.enabled` 为 false，适配器据此告知使用者「该模式需要内置服务器」。
+ *
+ *          **资源回收。** `route` / `websocket` / `createCache` / `onDispose` 全部登记进账号自己的
+ *          `DisposalRegistry`，账号一断开即全部回收，适配器不必自行记录。
+ *
+ *          工厂分两层是刻意的：内核装配时绑定一次全局依赖，账号管理器每次连接只补「该账号」专属
+ *          的几项 —— 于是账号管理器不必认识分发器与服务器，`adapter` 层也不会反向依赖 `pipeline`。
+ */
+import type { AccountRecord, AccountStatus, AdapterHost, BotApi, IncomingEvent, KvNamespace, Logger, PolicyView } from "@yunzai-ng/types";
+import type { ServerSink } from "../plugin/hooks.js";
+import type { DisposalRegistry } from "../util/dispose.js";
+/** 状态上报的附加信息 */
+export interface StatusDetail {
+    /** 错误消息 */
+    error?: string;
+    /** 账号昵称 */
+    nickname?: string;
+}
+/** 宿主工厂的全局依赖（内核装配时绑定一次） */
+export interface AdapterHostDeps {
+    /**
+     * 基础日志器
+     *
+     * 工厂会自己派生带 `adapter`/`account` 字段的 child —— `AdapterHost.logger`
+     * 的契约是"已带这两个字段"，由这里兑现而不是靠调用方记得。
+     */
+    readonly logger: Logger;
+    /**
+     * 适配器数据的 KV 根命名空间
+     *
+     * 每个账号取得的是 `<root>/<adapterId>/<accountId>`：两个账号即使运行同一个
+     * 适配器亦不会相互覆写键，而同一账号重连后仍可读回其此前写入的数据
+     *（NapCat 的 `echo` 序号与登录态缓存均依赖该机制）。
+     */
+    readonly kv: KvNamespace;
+    /** 内核策略视图 */
+    readonly policy: PolicyView;
+    /**
+     * 取当前的服务器登记面
+     *
+     * 取函数而非直接传值：服务器子系统装好之前 `hooks.server` 是"不可用"占位，
+     * 之后会被整体替换掉。见文件头第 2 点。
+     */
+    readonly server: () => ServerSink;
+    /**
+     * 把事件送进管线
+     *
+     * 由内核注入（最终指向 `EventDispatcher.submit`）。宿主不认识分发器，
+     * 否则 adapter 层就反过来依赖 pipeline 层了。
+     * @param event 通用事件
+     * @param bot 收到该事件的 Bot
+     */
+    readonly dispatch: (event: IncomingEvent, bot: BotApi) => void;
+}
+/** 单次连接的账号侧参数 */
+export interface AdapterHostParams {
+    /** 账号记录 */
+    readonly record: AccountRecord;
+    /** 本次连接的取消信号源 */
+    readonly controller: AbortController;
+    /** 本次连接的回收登记簿 */
+    readonly registry: DisposalRegistry;
+    /**
+     * 上报账号状态
+     * @param status 新状态
+     * @param detail 附加信息
+     */
+    readonly setStatus: (status: AccountStatus, detail?: StatusDetail) => void;
+}
+/** 宿主句柄：`host` 交给适配器，其余留给账号管理器 */
+export interface AdapterHostHandle {
+    /** 交给 `createBot()` 的宿主对象 */
+    readonly host: AdapterHost;
+    /**
+     * 绑定事件归属的 Bot
+     *
+     * 必须在 `createBot()` 返回、门面建好之后调用。宿主先于驱动存在
+     * （驱动是靠宿主创建出来的），所以这个槽位只能后填。
+     * @param bot Bot 门面
+     */
+    attach(bot: BotApi): void;
+    /** 解绑：此后事件一律丢弃 */
+    detach(): void;
+    /** 被丢弃的事件数（诊断用：非 0 说明适配器停止不彻底） */
+    readonly dropped: number;
+}
+/** 宿主工厂 */
+export type AdapterHostFactory = (params: AdapterHostParams) => AdapterHostHandle;
+/**
+ * 绑定全局依赖，得到宿主工厂
+ * @param deps 全局依赖
+ * @returns 宿主工厂
+ */
+export declare function createAdapterHostFactory(deps: AdapterHostDeps): AdapterHostFactory;
+/**
+ * 创建一个账号宿主
+ * @param deps 全局依赖
+ * @param params 账号侧参数
+ * @returns 宿主句柄
+ */
+export declare function createAdapterHost(deps: AdapterHostDeps, params: AdapterHostParams): AdapterHostHandle;
+//# sourceMappingURL=host.d.ts.map

package/dist/adapter/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/adapter/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,MAAM,EAIN,aAAa,EACb,WAAW,EACX,MAAM,EACN,UAAU,EAMX,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAG1D,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAA;IACxB,aAAa;IACb,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,UAAU,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/D;AAED,iBAAiB;AACjB,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,iBAAiB;IACjB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CAC3E;AAED,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,kBAAkB;IAClB,MAAM,IAAI,IAAI,CAAA;IACd,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,WAAW;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,iBAAiB,CAAA;AAEjF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAoFrG"}

package/dist/adapter/host.js

@@ -0,0 +1,90 @@
+import { createCache } from "../util/lru.js";
+/**
+ * 绑定全局依赖，得到宿主工厂
+ * @param deps 全局依赖
+ * @returns 宿主工厂
+ */
+export function createAdapterHostFactory(deps) {
+    return params => createAdapterHost(deps, params);
+}
+/**
+ * 创建一个账号宿主
+ * @param deps 全局依赖
+ * @param params 账号侧参数
+ * @returns 宿主句柄
+ */
+export function createAdapterHost(deps, params) {
+    const { record, registry, setStatus } = params;
+    const adapterId = record.adapterId;
+    const accountId = record.id;
+    const signal = params.controller.signal;
+    const logger = deps.logger.child({ adapter: adapterId, account: accountId });
+    /** 路由挂载前缀 */
+    const scope = `/adapter/${adapterId}`;
+    /** 事件归属的 Bot；`createBot()` 之后才有 */
+    let bot;
+    /** 丢弃的事件数 */
+    let dropped = 0;
+    /** 是否已就"投递到无主宿主"提醒过 */
+    let warnedNoBot = false;
+    const host = {
+        logger,
+        signal,
+        policy: deps.policy,
+        kv: deps.kv.sub(adapterId).sub(accountId),
+        // 快照 + 复制 config：适配器往 config 上随手写字段是常事，
+        // 若给的是原对象，那些临时字段会被账号管理器一并持久化下去，
+        // 下次启动时又被当成用户配置读回来
+        account: { ...record, config: { ...record.config } },
+        // getter：服务器可能在适配器加载之后才启动，见文件头第 2 点
+        get server() {
+            return deps.server().info;
+        },
+        submit: (event) => {
+            // 闸门一：账号已停用 / 插件已卸载。这是 BotDriver 契约里
+            // "断开后不再有事件投递进来"的兑现处
+            if (signal.aborted) {
+                dropped++;
+                return;
+            }
+            // 闸门二：尚未绑定 Bot。适配器在 connect() 完成前即收到事件，
+            // 此时不存在可用于回复的对象，继续处理只会在管线中抛错
+            if (bot === undefined) {
+                dropped++;
+                if (!warnedNoBot) {
+                    warnedNoBot = true;
+                    logger.warn("在 Bot 就绪前收到事件，已丢弃：请在 connect() 解析之后再开始投递事件");
+                }
+                return;
+            }
+            deps.dispatch(event, bot);
+        },
+        route: (method, path, handler, routeOpts) => 
+        // 登记进账号的回收簿：账号一断开，webhook 端点必须跟着消失，
+        // 否则平台还在往一个没人接的地址推事件
+        registry.add(deps.server().route(scope, method, path, handler, routeOpts), `route:${method} ${scope}${path}`),
+        websocket: (path, handler, wsOpts) => registry.add(deps.server().websocket(scope, path, handler, wsOpts), `ws:${scope}${path}`),
+        createCache: (cacheOpts) => {
+            const cache = createCache(cacheOpts);
+            // clear 而不是置 undefined：适配器可能还握着这个缓存对象的引用，
+            // 清空能立刻把内存还回去，之后即使被误用也只是全部 miss
+            registry.add(() => cache.clear(), "cache");
+            return cache;
+        },
+        onDispose: (fn) => void registry.add(fn, "adapter:onDispose"),
+        setStatus: (status, detail) => setStatus(status, detail)
+    };
+    return {
+        host,
+        attach: (next) => {
+            bot = next;
+        },
+        detach: () => {
+            bot = undefined;
+        },
+        get dropped() {
+            return dropped;
+        }
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/adapter/host.js.map

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

package/dist/adapter/login.d.ts

@@ -0,0 +1,174 @@
+/**
+ * 模块职责：交互式登录会话（实现 `LoginSession`）与登录会话管理器
+ * 依赖方向：依赖类型包与 util/*；通过注入的回调创建账号，**不认识账号管理器**
+ * 生命周期：一次登录一个会话；成功/失败/取消后短暂留存供 WebUI 展示结果，然后自毁
+ * 注意事项：内核不知道扫码、短信验证码、填 token 有什么区别，只提供两个原语：**推一步给用户看**
+ *          （`push`）与**等用户答一次**（`ask`）。扫码是 push(qrcode) + push(progress)，短信是
+ *          ask(手机号) + ask(验证码) —— 故前端不必为每个新平台改一行代码。三处必须做对：
+ *
+ *          **`start()` 同步返回。** 登录要等用户操作、动辄几十秒，HTTP 请求不能挂在那儿，故
+ *          `login()` 在后台跑，前端拿会话 id 去轮询或订阅。
+ *
+ *          **`ask` 带序号。** 用户连点两次提交或网络重发时，迟到的那次答复不能拿去满足**下一个**
+ *          问题（把手机号填进验证码框），故 `answer()` 必须带 `seq`，对不上就拒绝。
+ *
+ *          **一切都有上限**：步骤数、每次提问的超时、整个会话的 TTL，结束即自毁 —— 一个人点开
+ *          登录页就走开，不该留下一个永远挂着的 promise 和一张常驻内存的二维码。
+ */
+import type { AccountRecord, AdapterRegistryView, LoginPrompt, LoginStep, Logger } from "@yunzai-ng/types";
+/** 单次提问的缺省超时（毫秒），与 `LoginPrompt.timeout` 文档一致 */
+export declare const DEFAULT_LOGIN_PROMPT_TIMEOUT = 180000;
+/** 整个登录会话的硬上限（毫秒）：扫码最多两三分钟，十分钟足够宽裕 */
+export declare const DEFAULT_LOGIN_TTL = 600000;
+/** 登录会话状态 */
+export type LoginStatus = "running" | "done" | "failed" | "cancelled";
+/** 正在等待用户回答的提问 */
+export interface PendingPrompt {
+    /** 提问序号，回答时必须带回 */
+    readonly seq: number;
+    /** 提问内容 */
+    readonly prompt: LoginPrompt;
+    /** 超时时刻（毫秒时间戳），前端据此显示倒计时 */
+    readonly deadline: number;
+}
+/** 登录会话快照，WebUI 的唯一数据来源 */
+export interface LoginSnapshot {
+    /** 会话 id */
+    readonly id: string;
+    /** 适配器 id */
+    readonly adapterId: string;
+    /** 登录方式 id */
+    readonly mode: string;
+    /** 当前状态 */
+    readonly status: LoginStatus;
+    /** 已推送的步骤，按时间顺序 */
+    readonly steps: readonly LoginStep[];
+    /** 正在等待的提问；没有则 undefined */
+    readonly pending: PendingPrompt | undefined;
+    /** 失败原因 */
+    readonly error: string | undefined;
+    /** 成功时创建出的账号记录 id */
+    readonly accountId: string | undefined;
+    /** 开始时刻（毫秒时间戳） */
+    readonly startedAt: number;
+    /** 最后变化时刻（毫秒时间戳），前端据此判断是否需要重绘 */
+    readonly updatedAt: number;
+}
+/** 登录管理器构造参数 */
+export interface LoginManagerOptions {
+    /** 日志器 */
+    readonly logger: Logger;
+    /** 适配器注册表视图 */
+    readonly adapters: AdapterRegistryView;
+    /**
+     * 登录成功后落账号
+     *
+     * 注入而非直接依赖账号管理器：否则 login → accounts → login 就绕成环了。
+     * @param adapterId 适配器 id
+     * @param config 登录产出的账号配置
+     * @param label 账号备注名
+     * @returns 新建的账号记录
+     */
+    readonly createAccount: (adapterId: string, config: Record<string, unknown>, label?: string) => Promise<AccountRecord>;
+    /** 会话硬上限，缺省 `DEFAULT_LOGIN_TTL` */
+    readonly ttl?: number;
+}
+/** 会话内部状态 */
+interface SessionState {
+    /** 会话 id */
+    readonly id: string;
+    /** 适配器 id */
+    readonly adapterId: string;
+    /** 登录方式 */
+    readonly mode: string;
+    /** 账号备注名 */
+    readonly label: string | undefined;
+    /** 取消信号源 */
+    readonly controller: AbortController;
+    /** 已推送步骤 */
+    readonly steps: LoginStep[];
+    /** 当前状态 */
+    status: LoginStatus;
+    /** 正在等待的提问 */
+    pending: PendingPrompt | undefined;
+    /** 交付答复 */
+    resolveAsk: ((value: unknown) => void) | undefined;
+    /** 终止等待 */
+    rejectAsk: ((err: Error) => void) | undefined;
+    /** 会话 TTL 定时器 */
+    ttlTimer: NodeJS.Timeout | undefined;
+    /** 结束后自毁定时器 */
+    reapTimer: NodeJS.Timeout | undefined;
+    /** 提问序号发号器 */
+    seq: number;
+    /** 失败原因 */
+    error: string | undefined;
+    /** 成功创建的账号 id */
+    accountId: string | undefined;
+    /** 开始时刻 */
+    readonly startedAt: number;
+    /** 最后变化时刻 */
+    updatedAt: number;
+}
+/**
+ * 交互式登录会话管理器
+ *
+ * WebUI 侧的用法：`start()` 拿到 id → 轮询/订阅 `snapshot(id)` → 遇到
+ * `pending` 就渲染输入框，用户提交后 `answer(id, seq, value)` → 直到
+ * `status` 不再是 `running`。
+ */
+export declare class LoginManager {
+    #private;
+    /**
+     * @param opts 构造参数
+     */
+    constructor(opts: LoginManagerOptions);
+    /** 进行中的会话数 */
+    get running(): number;
+    /**
+     * 开始一次交互式登录
+     *
+     * **同步返回**，登录流程在后台跑，见文件头第 1 点。
+     * @param adapterId 适配器 id
+     * @param mode 登录方式 id
+     * @param label 账号备注名
+     * @returns 初始快照
+     * @throws 适配器不存在、不支持交互式登录、或方式 id 无效时
+     */
+    start(adapterId: string, mode: string, label?: string): LoginSnapshot;
+    /**
+     * 读一个会话的快照
+     * @param id 会话 id
+     * @returns 快照；会话不存在（或已自毁）时 undefined
+     */
+    snapshot(id: string): LoginSnapshot | undefined;
+    /**
+     * 列出全部会话
+     * @returns 快照数组，按开始时间
+     */
+    list(): LoginSnapshot[];
+    /**
+     * 提交用户的答复
+     * @param id 会话 id
+     * @param seq 提问序号，必须与 `pending.seq` 一致
+     * @param value 用户输入
+     * @returns 是否被接受
+     */
+    answer(id: string, seq: number, value: unknown): boolean;
+    /**
+     * 取消一个会话
+     * @param id 会话 id
+     * @returns 是否取消成功（会话不存在或已结束时 false）
+     */
+    cancel(id: string): boolean;
+    /** 取消全部会话并清理（停机时调用） */
+    stop(): void;
+    /**
+     * 生成快照
+     * @param state 会话状态
+     * @returns 快照
+     */
+    snapshotOf(state: SessionState): LoginSnapshot;
+}
+export {};
+//# sourceMappingURL=login.d.ts.map

package/dist/adapter/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/adapter/login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EAEX,SAAS,EACT,MAAM,EACP,MAAM,kBAAkB,CAAA;AAIzB,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,SAAU,CAAA;AAEnD,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,SAAU,CAAA;AAQxC,aAAa;AACb,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAA;AAErE,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,WAAW;IACX,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAA;IAC3C,WAAW;IACX,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,kBAAkB;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,UAAU;IACV,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,eAAe;IACf,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IACtH,mCAAmC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,aAAa;AACb,UAAU,YAAY;IACpB,YAAY;IACZ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,YAAY;IACZ,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,YAAY;IACZ,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAA;IAC3B,WAAW;IACX,MAAM,EAAE,WAAW,CAAA;IACnB,cAAc;IACd,OAAO,EAAE,aAAa,GAAG,SAAS,CAAA;IAClC,WAAW;IACX,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAClD,WAAW;IACX,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IAC7C,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAA;IACpC,eAAe;IACf,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAA;IACrC,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,WAAW;IACX,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,WAAW;IACX,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,aAAa;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAWD;;;;;;GAMG;AACH,qBAAa,YAAY;;IAYvB;;OAEG;gBACS,IAAI,EAAE,mBAAmB;IAOrC,cAAc;IACd,IAAI,OAAO,IAAI,MAAM,CAIpB;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa;IAuDrE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAK/C;;;OAGG;IACH,IAAI,IAAI,aAAa,EAAE;IAIvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAcxD;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B,uBAAuB;IACvB,IAAI,IAAI,IAAI;IASZ;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;CAyK/C"}