@yunzai-ng/core 0.1.0

package/dist/plugin/context.js

@@ -0,0 +1,573 @@
+/**
+ * 模块职责：构造插件上下文（`ctx`）——"一切皆可为插件"的落地实现
+ * 依赖方向：依赖 plugin/{hooks,events,services}、util/*、类型包；**不依赖任何子系统实现**
+ * 生命周期：每个插件实例一个 ctx，随插件卸载整体失效
+ * 注意事项：三条硬规则 ——
+ *
+ *          **零全局变量。** 全部能力须经 ctx 上的具名方法获取，故「某插件用了哪些能力」
+ *          可枚举，卸载时可确定性回收。
+ *
+ *          **每个注册型方法都把 disposer 登记进 DisposalRegistry。** 插件作者无从遗漏清理 ——
+ *          否则改十次代码就有十份定时器同时在跑。
+ *
+ *          **路径不做算术。** `ctx.resource()` 与模板根由内核依据插件根计算，`safeJoin` 拦
+ *          `../` 越界；手工拼相对路径会在目录层级一变时给出空白页面。
+ */
+import { join } from "node:path";
+import { DisposalRegistry } from "../util/dispose.js";
+import { parseDuration } from "../util/duration.js";
+import { safeJoin } from "../util/fs.js";
+import { LruCache } from "../util/lru.js";
+/** 插件内的模板目录名 */
+const TEMPLATE_DIR = "templates";
+/** 插件内的静态资源目录名 */
+const RESOURCE_DIR = "resources";
+/** 渲染输出格式对应的 MIME */
+const IMAGE_MIME = {
+    jpeg: "image/jpeg",
+    png: "image/png",
+    webp: "image/webp"
+};
+/**
+ * 链式命令构造器
+ *
+ * 每一环都在改同一份 `CommandRegistration`，路由器持有该对象引用，
+ * 因此 `.desc()` / `.master()` 这类不影响索引键的改动无需通知路由器；
+ * 只有 `.alias()` 改了索引键才调 `reindex`。
+ */
+class ChainedCommand {
+    /** 登记内容 */
+    #reg;
+    /** 命令路由 */
+    #sink;
+    /** 注销句柄（已登记进 registry） */
+    #undo;
+    /** 日志器，用于提示可疑用法 */
+    #logger;
+    /**
+     * @param reg 登记内容
+     * @param sink 命令路由
+     * @param undo 注销句柄
+     * @param logger 日志器
+     */
+    constructor(reg, sink, undo, logger) {
+        this.#reg = reg;
+        this.#sink = sink;
+        this.#undo = undo;
+        this.#logger = logger;
+    }
+    /**
+     * 绑定处理函数
+     * @param fn 处理函数
+     * @returns 自身
+     */
+    action(fn) {
+        if (this.#reg.handler) {
+            // 覆盖 action 几乎总是复制粘贴的产物：静默覆盖会让人以为前一个还在生效
+            this.#logger.warn(`命令 ${describePatterns(this.#reg.patterns)} 的 action 被重复设置，后者生效`);
+        }
+        this.#reg.handler = fn;
+        return this;
+    }
+    /**
+     * 追加别名
+     * @param patterns 别名模式
+     * @returns 自身
+     */
+    alias(...patterns) {
+        if (patterns.length === 0)
+            return this;
+        this.#reg.patterns.push(...patterns);
+        this.#sink.reindex(this.#reg);
+        return this;
+    }
+    /**
+     * 设置说明
+     * @param text 说明文案
+     * @returns 自身
+     */
+    desc(text) {
+        this.#reg.options.desc = text;
+        return this;
+    }
+    /**
+     * 限定场景
+     * @param scenes 允许的场景
+     * @returns 自身
+     */
+    scene(...scenes) {
+        this.#reg.options.scene = scenes;
+        return this;
+    }
+    /**
+     * 限定仅主人可用
+     * @returns 自身
+     */
+    master() {
+        this.#reg.options.master = true;
+        return this;
+    }
+    /**
+     * 限定仅群管可用
+     * @returns 自身
+     */
+    admin() {
+        this.#reg.options.admin = true;
+        return this;
+    }
+    /**
+     * 设置冷却
+     * @param spec 冷却时长
+     * @param scope 作用域
+     * @returns 自身
+     */
+    cooldown(spec, scope) {
+        this.#reg.options.cooldown = spec;
+        if (scope)
+            this.#reg.options.cooldownScope = scope;
+        return this;
+    }
+    /**
+     * 设置优先级
+     * @param value 数值，小者优先
+     * @returns 自身
+     */
+    priority(value) {
+        this.#reg.options.priority = value;
+        return this;
+    }
+    /** 注销该命令 */
+    dispose() {
+        this.#undo();
+    }
+}
+/**
+ * 把模式数组渲染成可读文本
+ * @param patterns 模式数组
+ * @returns 可读字符串
+ */
+export function describePatterns(patterns) {
+    return patterns.map(p => (typeof p === "string" ? p : p.source)).join(" | ");
+}
+/**
+ * 把两条渲染通路的实参归一为一次调用描述
+ *
+ * `render()` 有两种形态：`render(page, opts)` 与 `render(template, data, opts)`。
+ * 以第一参是否为字符串判别 —— `RenderablePage` 是对象，二者不可能混淆。
+ * 判别只做这一处，两个调用点（`ctx.render` 与 `e.render`）共用同一份语义。
+ * @param first 页面或模板相对路径
+ * @param second 模板数据（字符串通路）或渲染选项（TSX 通路）
+ * @param third 渲染选项（字符串通路）
+ * @returns 归一化后的调用描述
+ */
+export function splitRenderArgs(first, second, third) {
+    if (typeof first === "string") {
+        return { template: first, data: second ?? {}, opts: third ?? {} };
+    }
+    return { template: first.name, data: {}, html: first.html, opts: second ?? {} };
+}
+/**
+ * 插件上下文实现
+ *
+ * 每个成员都对应 `PluginContext` 的一项能力；除 `resource()` 这类纯计算外，
+ * 所有注册都经过 `#own()` 登记回收。
+ */
+class Context {
+    /** 依赖 */
+    #deps;
+    /** 计数 */
+    #counters;
+    /** 已打开的 SQL 库，按库名缓存（含进行中的打开操作） */
+    #sqlCache = new Map();
+    /** URL 作用域，如 `/plugin/mhy-game` */
+    #scope;
+    /** 插件名 */
+    name;
+    /** 插件版本 */
+    version;
+    /** 插件安装目录 */
+    root;
+    /** 插件数据目录 */
+    dataDir;
+    /** 插件日志器 */
+    logger;
+    /** 插件 KV 命名空间 */
+    kv;
+    /** 插件配置句柄 */
+    config;
+    /** 应用只读视图 */
+    app;
+    /** HTTP 客户端 */
+    http;
+    /** 卸载信号 */
+    signal;
+    /**
+     * @param deps 依赖
+     * @param counters 计数对象（与宿主共享同一引用）
+     */
+    constructor(deps, counters) {
+        this.#deps = deps;
+        this.#counters = counters;
+        this.#scope = `/plugin/${deps.name}`;
+        this.name = deps.name;
+        this.version = deps.version;
+        this.root = deps.root;
+        this.dataDir = deps.dataDir;
+        this.logger = deps.logger;
+        this.kv = deps.kv;
+        this.config = deps.config;
+        this.app = deps.app;
+        this.http = deps.http;
+        this.signal = deps.signal;
+    }
+    /**
+     * 声明一条命令
+     * @param pattern 触发模式
+     * @param opts 命令选项
+     * @returns 链式构造器
+     */
+    command(pattern, opts = {}) {
+        const patterns = [pattern];
+        if (opts.alias)
+            patterns.push(...(Array.isArray(opts.alias) ? opts.alias : [opts.alias]));
+        // options 拷一份：插件可能复用同一个 options 字面量声明多条命令，
+        // 而链式方法会就地改它
+        const reg = {
+            plugin: this.name,
+            patterns,
+            options: { ...opts },
+            handler: undefined
+        };
+        const undo = this.#deps.hooks.commands.register(reg);
+        this.#counters.commands++;
+        const disposer = this.#own(() => {
+            this.#counters.commands--;
+            undo();
+        }, `command:${describePatterns(patterns)}`);
+        return new ChainedCommand(reg, this.#deps.hooks.commands, disposer, this.logger);
+    }
+    /**
+     * 注册中间件
+     * @param fn 中间件函数
+     * @param opts 注册选项
+     * @returns 注销句柄
+     */
+    middleware(fn, opts = {}) {
+        const undo = this.#deps.hooks.middlewares.register({ plugin: this.name, fn, options: opts });
+        this.#counters.middlewares++;
+        return this.#own(() => {
+            this.#counters.middlewares--;
+            undo();
+        }, "middleware");
+    }
+    /**
+     * 监听内核事件
+     * @param event 事件名
+     * @param handler 处理函数
+     * @returns 注销句柄
+     */
+    on(event, handler) {
+        return this.#own(this.#deps.events.on(event, handler, this.name), `on:${String(event)}`);
+    }
+    /**
+     * 注册 cron 定时任务
+     * @param expression cron 表达式
+     * @param fn 任务体
+     * @param opts 任务选项
+     * @returns 注销句柄
+     */
+    cron(expression, fn, opts = {}) {
+        return this.#task("cron", expression, fn, opts);
+    }
+    /**
+     * 注册固定间隔任务
+     * @param interval 间隔
+     * @param fn 任务体
+     * @param opts 任务选项
+     * @returns 注销句柄
+     * @throws 间隔小于 1 秒时（几乎总是写错了单位）
+     */
+    every(interval, fn, opts = {}) {
+        const ms = parseDuration(interval, 0);
+        if (ms < 1000) {
+            throw new Error(`插件 ${this.name} 的间隔任务周期 ${ms}ms 过短：最小 1s，请确认单位是否写错`);
+        }
+        return this.#task("interval", ms, fn, opts);
+    }
+    /**
+     * 对外提供服务
+     * @param key 服务键
+     * @param value 服务实例
+     * @returns 注销句柄
+     * @throws 键名非法或已被占用时
+     */
+    provide(key, value) {
+        const undo = this.#deps.services.provide(key, value, this.name);
+        this.#counters.services++;
+        return this.#own(() => {
+            this.#counters.services--;
+            undo();
+        }, `provide:${key}`);
+    }
+    /**
+     * 取用其他插件提供的服务
+     * @param key 服务键
+     * @returns 服务实例；未提供时 undefined
+     */
+    inject(key) {
+        return this.#deps.services.get(key);
+    }
+    /**
+     * 取用服务，缺失即抛错
+     * @param key 服务键
+     * @returns 服务实例
+     * @throws 服务未注册时
+     */
+    require(key) {
+        return this.#deps.services.require(key, this.name);
+    }
+    /**
+     * 等待某服务就绪
+     *
+     * 插件被卸载时立刻以 undefined 结束等待：否则一个等不到的服务会把
+     * 已卸载插件的闭包一直挂在内存里。
+     * @param key 服务键
+     * @param timeout 等待超时，缺省 30s
+     * @returns 服务实例；超时或插件已卸载时 undefined
+     */
+    async waitFor(key, timeout) {
+        if (this.signal.aborted)
+            return undefined;
+        const ready = this.#deps.services.get(key);
+        if (ready !== undefined)
+            return ready;
+        return new Promise(resolve => {
+            let settled = false;
+            /** 只兑现一次 */
+            const finish = (value) => {
+                if (settled)
+                    return;
+                settled = true;
+                this.signal.removeEventListener("abort", onAbort);
+                resolve(value);
+            };
+            /** 卸载时放弃等待 */
+            function onAbort() {
+                finish(undefined);
+            }
+            this.signal.addEventListener("abort", onAbort, { once: true });
+            void this.#deps.services.waitFor(key, timeout).then(finish, () => finish(undefined));
+        });
+    }
+    /**
+     * 注册 HTTP 路由
+     * @param method HTTP 方法
+     * @param path 路径
+     * @param handler 处理函数
+     * @param opts 选项
+     * @returns 注销句柄
+     * @throws 服务器未启用时
+     */
+    route(method, path, handler, opts) {
+        const undo = this.#deps.hooks.server.route(this.#scope, method, path, handler, opts);
+        this.#counters.routes++;
+        return this.#own(() => {
+            this.#counters.routes--;
+            undo();
+        }, `route:${method} ${path}`);
+    }
+    /**
+     * 注册 WebSocket 路径
+     * @param path 路径
+     * @param handler 连接处理函数
+     * @param opts 选项
+     * @returns 注销句柄
+     * @throws 服务器未启用时
+     */
+    websocket(path, handler, opts) {
+        const undo = this.#deps.hooks.server.websocket(this.#scope, path, handler, opts);
+        this.#counters.routes++;
+        return this.#own(() => {
+            this.#counters.routes--;
+            undo();
+        }, `ws:${path}`);
+    }
+    /**
+     * 挂载静态目录
+     * @param urlPath URL 前缀
+     * @param dir 本地目录绝对路径
+     * @returns 注销句柄
+     * @throws 服务器未启用时
+     */
+    static(urlPath, dir) {
+        return this.#own(this.#deps.hooks.server.static(this.#scope, urlPath, dir), `static:${urlPath}`);
+    }
+    /**
+     * 接管站点根路径，替换内置面板
+     *
+     * 不经过 `this.#scope`：接管面板的意义就在于占据 `/`，挂在
+     * `/plugin/<插件名>` 之下的页面无法成为默认入口。归属标识写成
+     * `plugin:<插件名>`，`claimant("/")` 因此能回答"面板由谁提供"。
+     * 根路径已被占用时抛错，不静默覆盖 —— 见 types 里的说明。
+     * @param dir 单页应用产物目录（绝对路径）
+     * @returns 注销句柄
+     * @throws 服务器未启用、或根路径已被占用时
+     */
+    panel(dir) {
+        const undo = this.#deps.hooks.server.panel(`plugin:${this.name}`, dir);
+        this.#deps.logger.info(`已接管面板根路径：${dir}`);
+        return this.#own(undo, "panel:/");
+    }
+    /**
+     * 注册适配器
+     * @param provider 适配器实现
+     * @returns 注销句柄
+     */
+    registerAdapter(provider) {
+        return this.#own(this.#deps.hooks.adapters.register(provider, this.name), `adapter:${provider.id}`);
+    }
+    /**
+     * 注册渲染器
+     * @param provider 渲染器实现
+     * @returns 注销句柄
+     */
+    registerRenderer(provider) {
+        return this.#own(this.#deps.hooks.render.register(provider, this.name), `renderer:${provider.id}`);
+    }
+    /**
+     * 注册 KV 驱动
+     * @param driver 驱动实现
+     * @returns 注销句柄
+     */
+    registerKvDriver(driver) {
+        return this.#own(this.#deps.hooks.kvDrivers.register(driver, this.name), `kv-driver:${driver.id}`);
+    }
+    /**
+     * 渲染实现
+     * @param first 页面或模板相对路径
+     * @param second 模板数据（字符串通路）或渲染选项（TSX 通路）
+     * @param third 渲染选项（字符串通路）
+     * @returns 图片段；分页时为数组
+     * @throws 无可用渲染器、渲染失败或渲染器返回空结果时
+     */
+    async render(first, second, third) {
+        const call = splitRenderArgs(first, second, third);
+        const result = await this.#deps.hooks.render.render({
+            ...call.opts,
+            ...(call.html !== undefined ? { html: call.html } : {}),
+            template: call.template,
+            data: call.data,
+            templateRoot: join(this.root, TEMPLATE_DIR),
+            resourceRoot: join(this.root, RESOURCE_DIR),
+            origin: this.name
+        });
+        if (result.images.length === 0) {
+            throw new Error(`渲染器 ${result.renderer} 处理模板 ${call.template} 后没有产出图片`);
+        }
+        const type = call.opts.type ?? "jpeg";
+        const mime = IMAGE_MIME[type] ?? "image/jpeg";
+        const segments = result.images.map((bytes, index) => ({
+            type: "image",
+            // buffer 直传：渲染器刚出的图就在内存里，转 base64 只是白占一倍内存
+            file: { kind: "buffer", data: bytes, name: `${this.name}-${index}.${type}`, mime }
+        }));
+        return segments.length === 1 ? segments[0] : segments;
+    }
+    /**
+     * 打开本插件专属的 SQLite 库
+     *
+     * 同名库只打开一次：插件在多处 `await ctx.sql()` 拿到的是同一个连接，
+     * 否则 WAL 下多连接互相等锁，症状是"偶发变慢"，极难定位。
+     * @param name 库名，缺省 `"main"`
+     * @returns SQL 句柄
+     * @throws better-sqlite3 不可用时
+     */
+    async sql(name = "main") {
+        const cached = this.#sqlCache.get(name);
+        if (cached)
+            return cached;
+        const opening = this.#deps.hooks.sql.open(this.name, name);
+        this.#sqlCache.set(name, opening);
+        // 打开失败不留下坏缓存，否则重试永远拿到同一个已拒绝的 promise
+        opening.catch(() => this.#sqlCache.delete(name));
+        if (this.#sqlCache.size === 1) {
+            this.#own(() => void this.#deps.hooks.sql.close(this.name), "sql:close");
+        }
+        return opening;
+    }
+    /**
+     * 创建 LRU + TTL 缓存
+     * @param opts 缓存参数
+     * @returns 缓存实例，随插件卸载自动清空
+     */
+    cache(opts) {
+        const cache = new LruCache(opts);
+        this.#own(() => cache.clear(), "cache");
+        return cache;
+    }
+    /**
+     * 拼出插件内资源的绝对路径
+     *
+     * 走 `safeJoin`：插件传入 `"../../../etc/passwd"` 会被拒绝。参数很可能来自
+     * 用户消息（如"看某个模板"），不挡住就是任意文件读。
+     * @param parts 相对插件根的路径片段
+     * @returns 绝对路径
+     * @throws 结果越出插件根目录时
+     */
+    resource(...parts) {
+        return safeJoin(this.root, join(...parts));
+    }
+    /**
+     * 注册清理回调
+     * @param fn 清理函数
+     */
+    onDispose(fn) {
+        this.#deps.registry.add(fn, "onDispose");
+    }
+    /**
+     * 选一个可用账号
+     * @param bot 账号记录 id 或平台 selfId
+     * @returns Bot；无可用账号时 undefined
+     */
+    pickBot(bot) {
+        return this.#deps.hooks.bots.pick(bot);
+    }
+    /**
+     * 登记定时任务
+     * @param kind 任务类型
+     * @param schedule cron 表达式或间隔毫秒
+     * @param fn 任务体
+     * @param opts 任务选项
+     * @returns 注销句柄
+     */
+    #task(kind, schedule, fn, opts) {
+        const undo = this.#deps.hooks.tasks.register({ plugin: this.name, kind, schedule, fn, options: opts });
+        this.#counters.tasks++;
+        return this.#own(() => {
+            this.#counters.tasks--;
+            undo();
+        }, `task:${opts.name ?? schedule}`);
+    }
+    /**
+     * 把一个 disposer 登记进本插件的回收簿
+     *
+     * 插件卸载后仍然发生的注册（异步 setup 慢一步）会被立即回收 ——
+     * 这是 `DisposalRegistry.add` 的既有行为，此处依赖它。
+     * @param fn 回收函数
+     * @param label 标签
+     * @returns 提前回收的句柄
+     */
+    #own(fn, label) {
+        return this.#deps.registry.add(fn, label);
+    }
+}
+/**
+ * 构造插件上下文
+ * @param deps 依赖
+ * @returns 上下文与计数对象
+ */
+export function createPluginContext(deps) {
+    const counters = { commands: 0, middlewares: 0, tasks: 0, routes: 0, services: 0 };
+    return { ctx: new Context(deps, counters), counters };
+}
+//# sourceMappingURL=context.js.map

package/dist/plugin/context.js.map

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

package/dist/plugin/define.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 模块职责：`definePlugin()` —— 插件的声明入口与配置类型推导
+ * 依赖方向：依赖 config/schema、类型包
+ * 生命周期：模块加载期执行一次（纯校验，无副作用）
+ * 注意事项：两个设计要点 ——
+ *
+ *          1) **配置类型自动推导**。`configSchema: s.object({ cookie: s.string() })`
+ *             之后，`ctx.config.get().cookie` 就是 `string`，写错字段名编译期报错。
+ *             类型包为保持叶子（不许依赖任何工作区包）故把 `configSchema` 声明为
+ *             `unknown`，推导只能在这里做 —— 这也是插件必须从 `@yunzai-ng/core`
+ *             导入 `definePlugin` 而不是自己拼对象的原因。
+ *
+ *          2) **在声明期就校验元信息**。插件名会被当作配置文件名、KV 命名空间、
+ *             URL 前缀和日志 scope 使用，非法名字必须在 `import` 的那一刻就报错，
+ *             而不是等到写文件时抛一个看不出所以然的 ENOENT。
+ */
+import type { Awaitable, Disposer, PluginContext, PluginDefinition, PluginMeta } from "@yunzai-ng/types";
+import type { Schema } from "../config/schema.js";
+/** 标记"这是 definePlugin 的产物"，用于加载时校验默认导出 */
+declare const BRAND: unique symbol;
+/**
+ * 从 schema 推出配置类型
+ *
+ * 未声明 schema 时给出 `Record<string, never>`：`ctx.config.get()` 仍可调用，
+ * 但读取任何字段均会在编译期报错，以提示作者"尚未声明配置"。
+ */
+export type ConfigOf<S> = S extends Schema<infer T> ? T : Record<string, never>;
+/** `definePlugin` 的入参 */
+export interface DefinePluginInput<S extends Schema<unknown> | undefined = undefined> extends PluginMeta {
+    /**
+     * 配置 schema
+     *
+     * 用 `s.object({...})` 构造。内核据此生成带中文注释的 YAML、
+     * 渲染 WebUI 表单、校验用户输入 —— 三处共用一份声明，永不脱节。
+     */
+    configSchema?: S;
+    /**
+     * 插件入口
+     *
+     * 在这里注册命令、中间件、定时任务等。**不要**在这里做耗时的网络请求：
+     * 内核对 setup 有超时（默认 30s），超时会把插件标记为加载失败。
+     * 需要预热的资源请注册 `ctx.on("app/ready", ...)` 或用 `ctx.cron`。
+     * @param ctx 注入的上下文
+     * @returns 可选的清理函数，等价于在里面调 `ctx.onDispose`
+     */
+    setup(ctx: PluginContext<ConfigOf<S>>): Awaitable<void | Disposer>;
+}
+/** 带品牌标记的插件定义（内核内部使用） */
+export interface BrandedPluginDefinition<C = unknown> extends PluginDefinition<C> {
+    /** 品牌标记 */
+    readonly [BRAND]: true;
+}
+/**
+ * 声明一个插件
+ *
+ * @param input 插件定义
+ * @returns 供内核加载的插件定义（已冻结）
+ * @throws 插件名缺失/非法、`setup` 不是函数、依赖项写法错误时
+ * @example
+ * ```ts
+ * export default definePlugin({
+ *   name: "mhy-game",
+ *   configSchema: s.object({ cookie: s.string().default("") }),
+ *   setup(ctx) {
+ *     ctx.command("#体力").desc("查询实时便笺").action(async e => {
+ *       await e.reply(ctx.config.get().cookie ? "查询中" : "请先配置 cookie")
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export declare function definePlugin<S extends Schema<unknown> | undefined = undefined>(input: DefinePluginInput<S>): PluginDefinition<ConfigOf<S>>;
+/**
+ * 判断一个值是否 `definePlugin` 的产物
+ *
+ * 加载器用它区分"插件写错了默认导出"和"插件确实是插件"，
+ * 从而给出"请用 definePlugin 包一层"这种能直接照做的提示。
+ * @param value 待判定值
+ * @returns 是否为插件定义
+ */
+export declare function isPluginDefinition(value: unknown): value is BrandedPluginDefinition;
+/**
+ * 宽松判定：像插件定义但可能没走 `definePlugin`
+ *
+ * 允许手写对象（如测试里的假插件、compat 插件动态生成的定义），
+ * 只要有 name 与 setup 就接受，但加载器会记一条 debug 提示。
+ * @param value 待判定值
+ * @returns 是否可当作插件定义使用
+ */
+export declare function looksLikePlugin(value: unknown): value is PluginDefinition;
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dist/plugin/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/plugin/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACxG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAWjD,0CAA0C;AAC1C,QAAA,MAAM,KAAK,eAAiC,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAE/E,yBAAyB;AACzB,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,CAAE,SAAQ,UAAU;IACtG;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,CAAA;IAEhB;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAA;CACnE;AAED,yBAAyB;AACzB,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC/E,WAAW;IACX,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,EAC5E,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC1B,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CA2B/B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAEnF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAIzE"}