@lukawi/toporealm 0.1.0

package/dist/module-sdk/registry.js

@@ -0,0 +1,294 @@
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import * as YAML from "yaml";
+import { CoreError } from "../core/index.js";
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function deepFreeze(value) {
+    if (value && typeof value === "object") {
+        for (const child of Object.values(value))
+            deepFreeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+function safeId(id) {
+    return Boolean(id) && id !== "." && id !== ".." && !/[\\/:]/.test(id);
+}
+function parseFile(path) {
+    try {
+        return YAML.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new CoreError({
+            code: "INVALID_MODULE_FILE",
+            message: `无法读取模块文件：${path}`,
+            details: { cause: error instanceof Error ? error.message : String(error) },
+        });
+    }
+}
+function validateManifest(value, path) {
+    if (!value || typeof value !== "object")
+        throw new CoreError({ code: "INVALID_MODULE_MANIFEST", message: `模块清单不是对象：${path}` });
+    const manifest = value;
+    if (manifest.format !== "toporealm.module/v1" ||
+        typeof manifest.id !== "string" ||
+        typeof manifest.namespace !== "string" ||
+        typeof manifest.version !== "string" ||
+        !manifest.supports ||
+        !Array.isArray(manifest.supports.schemas)) {
+        throw new CoreError({ code: "INVALID_MODULE_MANIFEST", message: `模块清单缺少身份或 supports.schemas：${path}` });
+    }
+    if (!safeId(manifest.id) || !safeId(manifest.namespace))
+        throw new CoreError({ code: "INVALID_MODULE_MANIFEST", message: `模块 id/namespace 无效：${path}` });
+    return clone(manifest);
+}
+function parseVersion(value) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(value.trim());
+    return match ? [Number(match[1] ?? 0), Number(match[2] ?? 0), Number(match[3] ?? 0)] : undefined;
+}
+function compareVersion(left, right) {
+    for (let index = 0; index < 3; index += 1) {
+        const leftPart = left[index] ?? 0;
+        const rightPart = right[index] ?? 0;
+        if (leftPart !== rightPart)
+            return leftPart - rightPart;
+    }
+    return 0;
+}
+export function satisfiesVersion(version, range) {
+    const actual = parseVersion(version);
+    if (!actual || !range.trim())
+        return false;
+    for (const token of range.trim().split(/\s+/)) {
+        const match = /^(>=|<=|>|<|=)?\s*(\d+\.\d+\.\d+)/.exec(token);
+        if (!match)
+            continue;
+        const expected = parseVersion(`${match[2]}.0`);
+        if (!expected)
+            return false;
+        const comparison = compareVersion(actual, expected);
+        const operator = match[1] ?? "=";
+        if (operator === ">=" && comparison < 0)
+            return false;
+        if (operator === ">" && comparison <= 0)
+            return false;
+        if (operator === "<=" && comparison > 0)
+            return false;
+        if (operator === "<" && comparison >= 0)
+            return false;
+        if (operator === "=" && comparison !== 0)
+            return false;
+    }
+    return true;
+}
+export class WorkspaceModuleResolver {
+    workspaceRoot;
+    globalHome;
+    constructor(workspaceRoot, options = {}) {
+        this.workspaceRoot = resolve(workspaceRoot);
+        this.globalHome = resolve(options.globalHome ?? process.env.TOPOREALM_HOME ?? join(homedir(), ".toporealm"));
+    }
+    readBindings() {
+        const path = join(this.workspaceRoot, ".toporealm", "modules.yaml");
+        if (!existsSync(path))
+            return { bindings: {} };
+        const parsed = parseFile(path);
+        return parsed && typeof parsed === "object" && parsed.bindings ? parsed : { bindings: {} };
+    }
+    resolve(moduleId) {
+        const binding = this.readBindings().bindings?.[moduleId];
+        if (!binding)
+            return { status: "unavailable", id: moduleId, reason: "工作区没有显式模块绑定。" };
+        let root;
+        try {
+            if (binding.source === "global") {
+                if (!binding.version)
+                    return { status: "unavailable", id: moduleId, source: binding.source, reason: "global 绑定缺少准确 version。" };
+                root = join(this.globalHome, "modules", moduleId, binding.version);
+            }
+            else {
+                if (!binding.path)
+                    return { status: "unavailable", id: moduleId, source: binding.source, reason: `${binding.source} 绑定缺少 path。` };
+                root = binding.source === "workspace" || !isAbsolute(binding.path)
+                    ? resolve(join(this.workspaceRoot, ".toporealm", binding.path))
+                    : resolve(binding.path);
+            }
+        }
+        catch (error) {
+            return { status: "unavailable", id: moduleId, source: binding.source, reason: error instanceof Error ? error.message : String(error) };
+        }
+        root = existsSync(root) ? realpathSync.native(root) : root;
+        const manifestPath = join(root, "module.yaml");
+        if (!existsSync(manifestPath))
+            return { status: "unavailable", id: moduleId, source: binding.source, root, reason: `找不到 module.yaml：${manifestPath}` };
+        try {
+            const manifest = validateManifest(parseFile(manifestPath), manifestPath);
+            if (manifest.id !== moduleId)
+                return { status: "unavailable", id: moduleId, source: binding.source, root, reason: `模块清单 id=${manifest.id} 与绑定 ${moduleId} 不一致。` };
+            if (binding.version && manifest.version !== binding.version)
+                return { status: "unavailable", id: moduleId, source: binding.source, root, reason: `绑定版本 ${binding.version} 与清单版本 ${manifest.version} 不一致。` };
+            return { status: "available", id: moduleId, source: binding.source, root, manifest };
+        }
+        catch (error) {
+            return { status: "unavailable", id: moduleId, source: binding.source, root, reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    resolveMany(moduleIds) {
+        return moduleIds.map((id) => this.resolve(id));
+    }
+}
+export class GraphActivator {
+    resolver;
+    constructor(resolver) {
+        this.resolver = resolver;
+    }
+    activate(graph) {
+        const refs = graph.manifest.modules ?? [];
+        const resolved = new Map(refs.map((ref) => [ref.id, this.resolver.resolve(ref.id)]));
+        const modules = [];
+        const objectKinds = [];
+        const relationKinds = [];
+        const capabilities = [];
+        const validators = [];
+        const operations = [];
+        const ui = {};
+        for (const ref of refs) {
+            const candidate = resolved.get(ref.id);
+            if (!candidate || candidate.status === "unavailable") {
+                modules.push({ id: ref.id, namespace: ref.namespace, status: "unavailable", reason: candidate?.reason ?? "模块解析失败。" });
+                continue;
+            }
+            let reason;
+            if (candidate.manifest.namespace !== ref.namespace)
+                reason = `命名空间不匹配：图声明 ${ref.namespace}，模块声明 ${candidate.manifest.namespace}。`;
+            else if (!candidate.manifest.supports.schemas.includes(ref.schema))
+                reason = `模块不支持图模式 ${ref.schema}。`;
+            if (!reason) {
+                for (const dependency of candidate.manifest.requires?.modules ?? []) {
+                    const dependencyRef = refs.find((item) => item.id === dependency.id);
+                    const dependencyModule = resolved.get(dependency.id);
+                    if (!dependencyRef || !dependencyModule || dependencyModule.status === "unavailable") {
+                        reason = `硬依赖 ${dependency.id} 未在图中可用。`;
+                        break;
+                    }
+                    if (!satisfiesVersion(dependencyModule.manifest.version, dependency.version)) {
+                        reason = `硬依赖 ${dependency.id}@${dependencyModule.manifest.version} 不满足 ${dependency.version}。`;
+                        break;
+                    }
+                }
+            }
+            if (reason) {
+                modules.push({ id: ref.id, namespace: ref.namespace, status: "unavailable", source: candidate.source, version: candidate.manifest.version, reason });
+                continue;
+            }
+            try {
+                const contributions = this.readContributions(candidate);
+                objectKinds.push(...contributions.objectKinds);
+                relationKinds.push(...contributions.relationKinds);
+                capabilities.push(...contributions.capabilities);
+                validators.push(...contributions.validators);
+                operations.push(...contributions.operations);
+                if (contributions.ui !== undefined)
+                    ui[candidate.manifest.id] = contributions.ui;
+                const status = { id: ref.id, namespace: ref.namespace, status: "available", source: candidate.source, version: candidate.manifest.version };
+                modules.push(status);
+            }
+            catch (error) {
+                modules.push({ id: ref.id, namespace: ref.namespace, status: "unavailable", source: candidate.source, version: candidate.manifest.version, reason: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        return deepFreeze({
+            registryRevision: graph.revision,
+            modules,
+            objectKinds,
+            relationKinds,
+            capabilities,
+            validators,
+            operations,
+            ui,
+        });
+    }
+    readContributions(module) {
+        const contributes = module.manifest.contributes ?? {};
+        const readRefs = (refs) => (refs ?? []).map((ref) => {
+            if (!ref.id || !ref.declaration)
+                throw new CoreError({ code: "INVALID_MODULE_CONTRIBUTION", message: `模块 ${module.id} 的贡献 ${ref.id} 缺少 declaration。` });
+            const path = this.modulePath(module.root, ref.declaration);
+            if (!existsSync(path))
+                throw new CoreError({ code: "INVALID_MODULE_CONTRIBUTION", message: `找不到模块贡献文件：${path}` });
+            const value = parseFile(path);
+            const contribution = { id: ref.id, fullId: `${module.manifest.namespace}.${ref.id}`, moduleId: module.id };
+            contribution.declaration = value;
+            return contribution;
+        });
+        let ui;
+        if (module.manifest.ui?.contribution) {
+            const path = this.modulePath(module.root, module.manifest.ui.contribution);
+            if (!existsSync(path))
+                throw new CoreError({ code: "INVALID_MODULE_UI", message: `找不到模块 UI 贡献：${path}` });
+            ui = parseFile(path);
+        }
+        return {
+            objectKinds: readRefs(contributes.object_kinds),
+            relationKinds: readRefs(contributes.relation_kinds),
+            capabilities: readRefs(contributes.capabilities),
+            validators: readRefs(contributes.validators),
+            operations: readRefs(contributes.operations),
+            ui,
+        };
+    }
+    modulePath(root, relativePath) {
+        const path = resolve(root, relativePath);
+        const escaped = relative(root, path).startsWith("..") || isAbsolute(relative(root, path));
+        if (escaped)
+            throw new CoreError({ code: "MODULE_PATH_ESCAPE", message: `模块路径越出模块目录：${relativePath}` });
+        return path;
+    }
+}
+export function discoverActions(registry, target) {
+    return registry.operations.map((operation) => {
+        const declaration = operation.declaration && typeof operation.declaration === "object" ? operation.declaration : {};
+        const reference = { operation: operation.fullId, registryRevision: registry.registryRevision };
+        if (target !== undefined)
+            reference.target = target;
+        if (typeof declaration.input_schema === "string")
+            reference.inputSchema = declaration.input_schema;
+        if (declaration.input_template !== undefined)
+            reference.inputTemplate = clone(declaration.input_template);
+        return reference;
+    });
+}
+function moduleForKind(kind) {
+    const separator = kind.indexOf(".");
+    return separator > 0 ? kind.slice(0, separator) : undefined;
+}
+export function validateMutationPlan(registry, plan) {
+    const statuses = new Map();
+    for (const module of registry.modules) {
+        statuses.set(module.id, module);
+        if (module.namespace)
+            statuses.set(module.namespace, module);
+    }
+    for (const mutation of plan.mutations) {
+        const kind = mutation.op === "upsert_object" ? mutation.object.kind : mutation.op === "upsert_relation" ? mutation.relation.kind : undefined;
+        const moduleId = kind ? moduleForKind(kind) : undefined;
+        if (!moduleId)
+            continue;
+        const module = statuses.get(moduleId);
+        if (!module || module.status !== "available") {
+            throw new CoreError({ code: "MODULE_UNAVAILABLE", message: `无法编辑 ${kind}：所属模块不可用。`, details: { moduleId } });
+        }
+        const contributions = mutation.op === "upsert_object" ? registry.objectKinds : registry.relationKinds;
+        if (!contributions.some((contribution) => contribution.fullId === kind)) {
+            throw new CoreError({ code: "CONTRIBUTION_NOT_FOUND", message: `模块已加载，但没有登记贡献 ${kind}。`, details: { moduleId, kind } });
+        }
+    }
+}
+export function applyRegisteredPlan(store, registry, plan) {
+    validateMutationPlan(registry, plan);
+    return store.apply(plan);
+}
+//# sourceMappingURL=registry.js.map

package/dist/module-sdk/registry.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,14 @@
+import { type Server } from "node:http";
+import { GraphStore } from "../core/index.js";
+import type { ModuleActionRuntime } from "../module-sdk/index.js";
+export declare const serverSurface: {
+    readonly name: "server";
+    readonly coreFormat: "toporealm.graph/v1";
+};
+export interface ToporealmServerOptions {
+    runtimes?: Readonly<Record<string, ModuleActionRuntime>>;
+}
+/** A small HTTP adapter for the same Core store used by CLI and MCP. */
+export declare function createToporealmServer(store: GraphStore, options?: ToporealmServerOptions): Server;
+export declare function listenToporealmServer(store: GraphStore, port?: number, host?: string, options?: ToporealmServerOptions): Promise<Server>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAA0D,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAGrH,OAAO,EAAa,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;CAC1D;AAsBD,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAoHrG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,SAAI,EAAE,IAAI,SAAc,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5I"}

package/dist/server/index.js

@@ -0,0 +1,168 @@
+import { coreSurface } from "../core/index.js";
+import { createServer as createHttpServer } from "node:http";
+import { readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { CoreError, GraphStore, validateGraph } from "../core/index.js";
+import { ActionExecutor, GraphActivator, WorkspaceModuleResolver } from "../module-sdk/index.js";
+import { readWebAsset, renderWebShell } from "../web/index.js";
+export const serverSurface = {
+    name: "server",
+    coreFormat: coreSurface.graphFormat,
+};
+function sendJson(response, status, value) {
+    const body = JSON.stringify(value);
+    response.statusCode = status;
+    response.setHeader("content-type", "application/json; charset=utf-8");
+    response.end(body);
+}
+function readBody(request) {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        request.setEncoding("utf8");
+        request.on("data", (chunk) => {
+            body += chunk;
+            if (body.length > 1_000_000)
+                reject(new Error("请求体过大"));
+        });
+        request.on("end", () => resolve(body));
+        request.on("error", reject);
+    });
+}
+/** A small HTTP adapter for the same Core store used by CLI and MCP. */
+export function createToporealmServer(store, options = {}) {
+    let activeStore = store;
+    const workspaceRoot = dirname(dirname(dirname(store.graphRoot)));
+    const graphSummary = (candidate) => {
+        const snapshot = candidate.read();
+        return {
+            id: snapshot.manifest.id,
+            label: snapshot.manifest.label,
+            revision: snapshot.revision,
+            objectCount: snapshot.objects.length,
+            relationCount: snapshot.relations.length,
+        };
+    };
+    const listGraphs = () => {
+        const graphsRoot = join(workspaceRoot, ".toporealm", "graphs");
+        try {
+            return readdirSync(graphsRoot, { withFileTypes: true })
+                .filter((entry) => entry.isDirectory())
+                .flatMap((entry) => {
+                try {
+                    return [graphSummary(GraphStore.fromWorkspace(workspaceRoot, entry.name))];
+                }
+                catch {
+                    return [];
+                }
+            })
+                .sort((left, right) => left.id.localeCompare(right.id));
+        }
+        catch {
+            return [];
+        }
+    };
+    const activeRegistry = () => new GraphActivator(new WorkspaceModuleResolver(workspaceRoot)).activate(activeStore.read());
+    const runtimes = options.runtimes ?? {};
+    return createHttpServer(async (request, response) => {
+        try {
+            const url = new URL(request.url ?? "/", "http://toporealm.local");
+            if (request.method === "GET" && (url.pathname === "/" || url.pathname === "/index.html")) {
+                response.statusCode = 200;
+                response.setHeader("content-type", "text/html; charset=utf-8");
+                response.end(renderWebShell());
+                return;
+            }
+            if (request.method === "GET" && (url.pathname === "/graph" || url.pathname === "/api/graph")) {
+                sendJson(response, 200, activeStore.read());
+                return;
+            }
+            if (request.method === "GET" && (url.pathname === "/graphs" || url.pathname === "/api/graphs")) {
+                sendJson(response, 200, { currentId: activeStore.read().manifest.id, graphs: listGraphs() });
+                return;
+            }
+            if (request.method === "GET" && (url.pathname === "/history" || url.pathname === "/api/history")) {
+                sendJson(response, 200, activeStore.historyStatus());
+                return;
+            }
+            if (request.method === "GET" && (url.pathname === "/validate" || url.pathname === "/api/validate")) {
+                const snapshot = activeStore.read();
+                sendJson(response, 200, url.searchParams.get("mode") === "complete" ? validateGraph(snapshot, activeRegistry()) : validateGraph(snapshot));
+                return;
+            }
+            if (request.method === "GET" && (url.pathname === "/modules" || url.pathname === "/api/modules")) {
+                const registry = activeRegistry();
+                sendJson(response, 200, { registryRevision: registry.registryRevision, modules: registry.modules, ui: registry.ui, operations: registry.operations });
+                return;
+            }
+            if (request.method === "GET" && !url.pathname.startsWith("/api/")) {
+                const asset = readWebAsset(url.pathname);
+                if (asset) {
+                    response.statusCode = 200;
+                    response.setHeader("content-type", asset.contentType);
+                    response.end(asset.body);
+                    return;
+                }
+            }
+            if (request.method === "POST") {
+                const body = JSON.parse((await readBody(request)) || "{}");
+                if (url.pathname === "/graph/switch" || url.pathname === "/api/graph/switch") {
+                    if (typeof body.id !== "string")
+                        throw new CoreError({ code: "INVALID_GRAPH_ID", message: "图切换需要字符串 graph ID。" });
+                    const next = GraphStore.fromWorkspace(workspaceRoot, body.id);
+                    const snapshot = next.read();
+                    activeStore = next;
+                    sendJson(response, 200, { snapshot, history: activeStore.historyStatus(), graph: graphSummary(activeStore) });
+                    return;
+                }
+                if (url.pathname === "/actions" || url.pathname === "/api/actions") {
+                    const registry = activeRegistry();
+                    if (typeof body.operation !== "string")
+                        throw new CoreError({ code: "INVALID_OPERATION", message: "动作请求需要 operation。" });
+                    const reference = {
+                        operation: body.operation,
+                        registryRevision: typeof body.registryRevision === "number" ? body.registryRevision : registry.registryRevision,
+                    };
+                    if (typeof body.target === "string")
+                        reference.target = body.target;
+                    const input = body.input && typeof body.input === "object" && !Array.isArray(body.input) ? body.input : {};
+                    const result = await new ActionExecutor(activeStore, registry, runtimes).execute(reference, input);
+                    sendJson(response, 200, result);
+                    return;
+                }
+                if (url.pathname === "/mutations" || url.pathname === "/api/mutations") {
+                    sendJson(response, 200, activeStore.apply(body));
+                    return;
+                }
+                if (url.pathname === "/undo" || url.pathname === "/api/undo") {
+                    sendJson(response, 200, activeStore.undo(typeof body.expectedRevision === "number" ? body.expectedRevision : undefined));
+                    return;
+                }
+                if (url.pathname === "/redo" || url.pathname === "/api/redo") {
+                    sendJson(response, 200, activeStore.redo(typeof body.expectedRevision === "number" ? body.expectedRevision : undefined));
+                    return;
+                }
+            }
+            sendJson(response, 404, { error: { code: "NOT_FOUND", message: "没有这个 TopoRealm 接口。" } });
+        }
+        catch (error) {
+            if (error instanceof CoreError) {
+                sendJson(response, error.code === "REVISION_CONFLICT" ? 409 : 400, {
+                    error: { code: error.code, message: error.message, details: error.details },
+                });
+                return;
+            }
+            sendJson(response, 400, { error: { code: "BAD_REQUEST", message: error instanceof Error ? error.message : String(error) } });
+        }
+    });
+}
+export function listenToporealmServer(store, port = 0, host = "127.0.0.1", options = {}) {
+    const server = createToporealmServer(store, options);
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, host, () => {
+            server.off("error", reject);
+            resolve(server);
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/dist/web/index.d.ts

@@ -0,0 +1,26 @@
+import type { GraphPatch, GraphSnapshot } from "../core/index.js";
+export declare const webSurface: {
+    readonly name: "web";
+    readonly coreFormat: "toporealm.graph/v1";
+};
+/** Client-side projection that consumes the same revisioned patches returned by Core. */
+export declare class WebGraphModel {
+    private current;
+    constructor(snapshot: GraphSnapshot);
+    get snapshot(): GraphSnapshot;
+    applyPatch(patch: GraphPatch): GraphSnapshot;
+}
+export interface UiExtensionResult<T> {
+    enabled: boolean;
+    value: T;
+    error?: string;
+}
+/** One extension failing must leave the generic surface usable. */
+export declare function withUiErrorBoundary<T>(extension: () => T, fallback: () => T): UiExtensionResult<T>;
+/** Reads a built Web UI asset without allowing paths outside web-ui/dist. */
+export declare function readWebAsset(pathname: string, webRoot?: string): {
+    body: Buffer;
+    contentType: string;
+} | undefined;
+export declare function renderWebShell(webRoot?: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAgC,MAAM,kBAAkB,CAAC;AAEhG,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX,yFAAyF;AACzF,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;gBAEnB,QAAQ,EAAE,aAAa;IAInC,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa;CAwB7C;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAMlG;AAmBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAW5H;AAMD,wBAAgB,cAAc,CAAC,OAAO,SAAmB,GAAG,MAAM,CAcjE"}