@12ui/design 0.2.72 → 0.2.73

package/dist/slate-browser-host-script.js

@@ -0,0 +1,125 @@
+/**
+ * The host shim of the browser workspace: the half of the MCP Apps bridge the screen expects to find on the other side
+ * of `postMessage`, implemented by the page that frames it.
+ *
+ * It answers `ui/initialize` with a host context (the theme from `prefers-color-scheme`, the display mode), delivers the
+ * workspace as the `ui/notifications/tool-result` the screen waits for (so a reload restores the workspace from disk,
+ * as the MCP host's re-render does), turns `tools/call` into `POST /api/call` and `ui/message` into `POST /api/message`,
+ * and lays the frame out: the whole window in `fullscreen`, its reported height in `inline` (`?mode=inline`). The
+ * session token is the one in this page's own URL; the frame never sees it.
+ *
+ * String.raw so escapes reach the browser unchanged: no backtick and no dollar-brace inside.
+ */
+export const SLATE_BROWSER_HOST_SCRIPT = String.raw `
+"use strict";
+(function () {
+  var PROTOCOL = "2026-01-26";
+  var query = new URLSearchParams(location.search);
+  var token = query.get("t") || "";
+  var frame = document.getElementById("screen");
+  var over = document.getElementById("over");
+  var overTitle = document.getElementById("over-title");
+  var overNote = document.getElementById("over-note");
+  var startInline = query.get("mode") === "inline";
+  var mode = startInline ? "inline" : "fullscreen";
+  var modes = startInline ? ["inline", "fullscreen"] : ["fullscreen"];
+  var scheme = window.matchMedia("(prefers-color-scheme: dark)");
+  // Set once the person's decision has been sent and the command is to end: nothing that fails after that is news.
+  var finished = false;
+
+  function theme() { return scheme.matches ? "dark" : "light"; }
+  function context() {
+    return { theme: theme(), displayMode: mode, availableDisplayModes: modes, platform: "web", locale: navigator.language || "en-US" };
+  }
+  function layout() {
+    document.documentElement.style.colorScheme = theme();
+    frame.className = mode;
+    if (mode === "fullscreen") frame.style.removeProperty("height");
+  }
+
+  // ---- JSON-RPC to the frame ----
+  function send(message) { if (frame.contentWindow) frame.contentWindow.postMessage(message, "*"); }
+  function reply(id, result) { send({ jsonrpc: "2.0", id: id, result: result }); }
+  function refuse(id, code, text) { send({ jsonrpc: "2.0", id: id, error: { code: code, message: text } }); }
+  function notify(method, params) { send({ jsonrpc: "2.0", method: method, params: params }); }
+
+  // ---- the session ----
+  function say(title, note) {
+    overTitle.textContent = title;
+    overNote.textContent = note;
+    over.classList.remove("hidden");
+  }
+  function api(path, body) {
+    return fetch(path, {
+      method: "POST",
+      headers: { "content-type": "application/json", "x-12ui-token": token },
+      body: JSON.stringify(body)
+    }).then(function (res) {
+      return res.json().then(function (data) {
+        if (!res.ok) throw new Error((data && data.error && data.error.message) || ("The session answered " + res.status + "."));
+        return data;
+      });
+    }, function () {
+      if (!finished) say("The session ended", "Run the command again to reopen the workspace.");
+      throw new Error("The 12ui session is not running.");
+    });
+  }
+  function decided(out) {
+    if (!out.ending || !out.decided) return;
+    finished = true;
+    say(out.decided === "select" ? "Choice sent" : "Request sent", "Your agent has it. You can close this tab.");
+  }
+  function showWorkspace() {
+    api("/api/call", { name: "design.slate.show", arguments: {} }).then(function (out) {
+      notify("ui/notifications/tool-result", out.result);
+    }, function (err) {
+      notify("ui/notifications/tool-result", { isError: true, content: [{ type: "text", text: err.message }] });
+    });
+  }
+
+  window.addEventListener("message", function (event) {
+    if (event.source !== frame.contentWindow) return;
+    var m = event.data;
+    if (!m || m.jsonrpc !== "2.0" || typeof m.method !== "string") return;
+    var id = m.id;
+    var params = m.params || {};
+    if (m.method === "ui/initialize") {
+      reply(id, { protocolVersion: PROTOCOL, hostInfo: { name: "12ui-browser", version: "1" }, hostCapabilities: {}, hostContext: context() });
+    } else if (m.method === "ui/notifications/initialized") {
+      showWorkspace();
+    } else if (m.method === "tools/call") {
+      api("/api/call", { name: params.name, arguments: params.arguments }).then(function (out) {
+        reply(id, out.result);
+        decided(out);
+      }, function (err) { refuse(id, -32000, err.message); });
+    } else if (m.method === "ui/message") {
+      var block = params.content && params.content[0];
+      api("/api/message", { text: block && typeof block.text === "string" ? block.text : "" }).then(function () { reply(id, {}); }, function (err) { refuse(id, -32000, err.message); });
+    } else if (m.method === "ui/update-model-context") {
+      // Nothing reads it here: the decision reaches the agent as the command's result.
+      reply(id, {});
+    } else if (m.method === "ui/request-display-mode") {
+      if (modes.indexOf(params.mode) >= 0 && params.mode !== mode) {
+        mode = params.mode;
+        layout();
+        notify("ui/notifications/host-context-changed", { displayMode: mode });
+      }
+      reply(id, { mode: mode });
+    } else if (m.method === "ui/notifications/size-changed") {
+      if (mode === "inline" && params.height > 0) frame.style.height = Math.ceil(params.height) + "px";
+    } else if (id !== undefined) {
+      refuse(id, -32601, "Method not found: " + m.method);
+    }
+  });
+
+  scheme.addEventListener("change", function () {
+    layout();
+    notify("ui/notifications/host-context-changed", { theme: theme() });
+  });
+
+  layout();
+  // The listener is on; only now can the screen's first message arrive.
+  frame.src = "/screen?t=" + encodeURIComponent(token);
+})();
+`;
+//# sourceMappingURL=slate-browser-host-script.js.map

package/dist/slate-browser-host-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-host-script.js","sourceRoot":"","sources":["../src/slate-browser-host-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GlD,CAAC"}

package/dist/slate-browser-host.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The page the browser workspace opens: a frame for the screen (built from the same modules the MCP plugin serves, with
+ * target `browser`) and the shim that stands in for an MCP Apps host. The frame is sandboxed to scripts only, so the
+ * screen has no origin of its own to reach this server with, and its policy allows no network at all.
+ *
+ * Self-contained, like the screen: no external script, stylesheet, font or URL.
+ */
+export declare const buildSlateBrowserHostHtml: () => string;
+//# sourceMappingURL=slate-browser-host.d.ts.map

package/dist/slate-browser-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-host.d.ts","sourceRoot":"","sources":["../src/slate-browser-host.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAAO,MA2B5C,CAAC"}

package/dist/slate-browser-host.js

@@ -0,0 +1,37 @@
+import { SLATE_BROWSER_HOST_SCRIPT } from './slate-browser-host-script.js';
+/**
+ * The page the browser workspace opens: a frame for the screen (built from the same modules the MCP plugin serves, with
+ * target `browser`) and the shim that stands in for an MCP Apps host. The frame is sandboxed to scripts only, so the
+ * screen has no origin of its own to reach this server with, and its policy allows no network at all.
+ *
+ * Self-contained, like the screen: no external script, stylesheet, font or URL.
+ */
+export const buildSlateBrowserHostHtml = () => `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>Design workspace</title>
+<style>
+  :root { --bg: #ffffff; --fg: #17181c; --muted: #5b5f6a; --card: #ffffff; --line: #d9dce3; }
+  @media (prefers-color-scheme: dark) { :root { --bg: #16171b; --fg: #f1f2f5; --muted: #a3a7b3; --card: #1f2126; --line: #34363d; } }
+  html, body { margin: 0; height: 100%; background: var(--bg); color: var(--fg); font: 16px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; }
+  #screen { display: block; border: 0; width: 100%; background: transparent; }
+  #screen.fullscreen { height: 100vh; height: 100dvh; }
+  #screen.inline { max-width: 720px; margin: 0 auto; }
+  .hidden { display: none !important; }
+  #over { position: fixed; inset: 0; display: flex; align-items: center; justify-content: center; padding: 16px; background: color-mix(in srgb, var(--bg) 82%, transparent); }
+  #over .box { max-width: 420px; padding: 24px; border: 1px solid var(--line); border-radius: 12px; background: var(--card); text-align: center; }
+  #over h1 { margin: 0 0 8px; font-size: 20px; }
+  #over p { margin: 0; color: var(--muted); }
+</style>
+</head>
+<body>
+<iframe id="screen" title="Design workspace" sandbox="allow-scripts"></iframe>
+<div id="over" class="hidden" role="status"><div class="box"><h1 id="over-title"></h1><p id="over-note"></p></div></div>
+<script>${SLATE_BROWSER_HOST_SCRIPT}</script>
+</body>
+</html>
+`;
+//# sourceMappingURL=slate-browser-host.js.map

package/dist/slate-browser-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-host.js","sourceRoot":"","sources":["../src/slate-browser-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAW,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;UAwB7C,yBAAyB;;;CAGlC,CAAC"}

package/dist/slate-browser-server.d.ts

@@ -0,0 +1,37 @@
+import { type SlateBrowserDecision } from './slate-browser-decision.js';
+import { type SlateToolContext } from './mcp-slate-tools.js';
+/**
+ * The design workspace as a web page, for the agents that do not have the workspace's MCP tools.
+ *
+ * One session serves one run directory on 127.0.0.1 and nothing else, and every route needs the session's random token
+ * (in the URL the command prints), so another page in the user's browser cannot drive it: a request with no token, a
+ * `Host` other than the loopback name, or a cross-origin `Origin` is refused before anything is read. The page is a
+ * host for the screen the MCP plugin serves (the same modules, built with target `browser`) inside a sandboxed frame; the
+ * frame never talks to this server, only to the page's shim, which turns the screen's `tools/call` into
+ * `POST /api/call`, and that dispatches to the same slate tool handlers `12ui mcp` uses, app-only tools included,
+ * confined to the session's run directory.
+ */
+export type SlateBrowserServerOptions = {
+    /** The finished draft run to serve (already resolved). */
+    runDir: string;
+    /** 0 picks a free port. */
+    port?: number;
+    /** Set by tests; a session normally makes its own. */
+    token?: string;
+    /** What the tool handlers need from their host (corpus, state root, runner launcher); tests inject fixtures. */
+    context?: SlateToolContext;
+    /** After a decision, how long to wait for the screen's own message before reporting it. */
+    messageGraceMs?: number;
+    /** Whether the page should say the session is over after a decision (`--wait`). */
+    ending?: boolean;
+    onDecision: (decision: SlateBrowserDecision) => void;
+};
+export type SlateBrowserServer = {
+    url: string;
+    port: number;
+    token: string;
+    runDir: string;
+    close: () => Promise<void>;
+};
+export declare const startSlateBrowserServer: (options: SlateBrowserServerOptions) => Promise<SlateBrowserServer>;
+//# sourceMappingURL=slate-browser-server.d.ts.map

package/dist/slate-browser-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-browser-server.d.ts","sourceRoot":"","sources":["../src/slate-browser-server.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuD,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG7H,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGrF;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,yBAAyB,GAAG;IACtC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AA2CF,eAAO,MAAM,uBAAuB,GAAU,SAAS,yBAAyB,KAAG,OAAO,CAAC,kBAAkB,CAgI5G,CAAC"}

package/dist/slate-browser-server.js

@@ -0,0 +1,186 @@
+import { randomBytes, timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+import { realpath } from 'node:fs/promises';
+import { buildSlateBrowserHostHtml } from './slate-browser-host.js';
+import { decidedBy, finishDecision } from './slate-browser-decision.js';
+import { buildSlateUiHtml } from './mcp-slate-ui.js';
+import { SLATE_DATA_TOOL, SLATE_OPEN_TOOL, SLATE_SHOW_TOOL, SLATE_TOOL_NAMES } from './mcp-slate-names.js';
+import { createSlateToolHandler } from './mcp-slate-tools.js';
+import { errorResult } from './slate-runtime.js';
+const HOST_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; connect-src 'self'; frame-src 'self'; base-uri 'none'; form-action 'none'; frame-ancestors 'none'";
+const SCREEN_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; base-uri 'none'; form-action 'none'; frame-ancestors 'self'";
+const MAX_BODY_BYTES = 1_000_000;
+const MAX_MESSAGES = 50;
+const MAX_MESSAGE_CHARS = 4_000;
+class HttpError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+const sameToken = (given, token) => {
+    if (given === undefined)
+        return false;
+    const a = Buffer.from(given);
+    const b = Buffer.from(token);
+    return a.length === b.length && timingSafeEqual(a, b);
+};
+const readBody = async (request) => {
+    if (!/^application\/json(\s*;.*)?$/iu.test(request.headers['content-type'] ?? '')) {
+        throw new HttpError(415, 'json_required', 'The request must be JSON.');
+    }
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of request) {
+        size += chunk.length;
+        if (size > MAX_BODY_BYTES)
+            throw new HttpError(413, 'too_large', 'The request is too large.');
+        chunks.push(chunk);
+    }
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        throw new HttpError(400, 'json_invalid', 'The request is not valid JSON.');
+    }
+};
+const record = (value) => (value && typeof value === 'object' && !Array.isArray(value) ? value : {});
+export const startSlateBrowserServer = async (options) => {
+    const token = options.token ?? randomBytes(24).toString('base64url');
+    const runDir = await realpath(options.runDir);
+    const handler = createSlateToolHandler(options.context ?? {});
+    const screenHtml = buildSlateUiHtml({ target: 'browser' });
+    const hostHtml = buildSlateBrowserHostHtml();
+    const graceMs = options.messageGraceMs ?? 1_500;
+    let port = 0;
+    // A decision is reported once the screen's own message for it has arrived, or after a short grace when it does not.
+    let pending;
+    const report = () => {
+        const current = pending;
+        if (!current)
+            return;
+        pending = undefined;
+        clearTimeout(current.timer);
+        void finishDecision(current.decided, current.messages).then(options.onDecision);
+    };
+    const decide = (decided) => {
+        if (pending)
+            report();
+        pending = { decided, messages: [], timer: setTimeout(report, graceMs) };
+    };
+    const confine = async (name, input) => {
+        // show and data are the agent's tools and take no run here; the session's run is the only one there is.
+        if (name === SLATE_SHOW_TOOL || name === SLATE_DATA_TOOL || name === SLATE_OPEN_TOOL)
+            return { runDir };
+        const given = input.runDir;
+        const resolved = typeof given === 'string' && given.trim() ? await realpath(given.trim()).catch(() => undefined) : undefined;
+        if (resolved !== runDir)
+            throw new HttpError(403, 'wrong_run', 'This session serves one run directory and this call named another.');
+        return input;
+    };
+    const call = async (body) => {
+        const { name, arguments: args } = record(body);
+        if (typeof name !== 'string' || !SLATE_TOOL_NAMES.includes(name)) {
+            throw new HttpError(404, 'unknown_tool', 'That is not a design workspace tool.');
+        }
+        const input = await confine(name, record(args));
+        const result = await handler(name === SLATE_OPEN_TOOL ? SLATE_SHOW_TOOL : name, input);
+        const decided = decidedBy(name, result);
+        if (decided)
+            decide(decided);
+        return { result, decided: decided?.decision ?? null, ending: options.ending === true };
+    };
+    const message = async (body) => {
+        const { text } = record(body);
+        if (typeof text !== 'string')
+            throw new HttpError(400, 'invalid_input', 'text must be a string.');
+        if (pending && pending.messages.length < MAX_MESSAGES)
+            pending.messages.push(text.slice(0, MAX_MESSAGE_CHARS));
+        return {};
+    };
+    const authorized = (request, url) => {
+        const host = request.headers.host;
+        if (host !== `127.0.0.1:${port}` && host !== `localhost:${port}`) {
+            throw new HttpError(403, 'host_refused', 'This page is only served to the address it was opened at.');
+        }
+        const origin = request.headers.origin;
+        if (origin !== undefined && origin !== `http://${host}`)
+            throw new HttpError(403, 'origin_refused', 'Cross-origin requests are refused.');
+        const given = request.method === 'POST' ? request.headers['x-12ui-token'] : url.searchParams.get('t') ?? undefined;
+        if (!sameToken(typeof given === 'string' ? given : undefined, token)) {
+            throw new HttpError(401, 'token_required', 'Open the address that `12ui workspace open` printed: it carries this session\'s token.');
+        }
+    };
+    const send = (response, status, type, csp, body) => {
+        response.writeHead(status, {
+            'content-type': type,
+            'cache-control': 'no-store',
+            'referrer-policy': 'no-referrer',
+            'x-content-type-options': 'nosniff',
+            'cross-origin-resource-policy': 'same-origin',
+            ...(csp ? { 'content-security-policy': csp } : {}),
+        });
+        response.end(body);
+    };
+    const route = async (request, response) => {
+        const url = new URL(request.url ?? '/', 'http://127.0.0.1');
+        if (request.method === 'GET' && url.pathname === '/favicon.ico') {
+            response.writeHead(204);
+            response.end();
+            return;
+        }
+        authorized(request, url);
+        if (request.method === 'GET' && url.pathname === '/')
+            return send(response, 200, 'text/html; charset=utf-8', HOST_CSP, hostHtml);
+        if (request.method === 'GET' && url.pathname === '/screen')
+            return send(response, 200, 'text/html; charset=utf-8', SCREEN_CSP, screenHtml);
+        if (request.method === 'POST' && url.pathname === '/api/call')
+            return send(response, 200, 'application/json', undefined, JSON.stringify(await call(await readBody(request))));
+        if (request.method === 'POST' && url.pathname === '/api/message') {
+            const result = await message(await readBody(request));
+            send(response, 200, 'application/json', undefined, JSON.stringify(result));
+            // The screen sends its message right after the call that recorded the decision.
+            if (pending)
+                setImmediate(report);
+            return;
+        }
+        throw new HttpError(404, 'not_found', 'Not found.');
+    };
+    const server = createServer((request, response) => {
+        route(request, response).catch((error) => {
+            if (response.headersSent) {
+                response.end();
+                return;
+            }
+            if (error instanceof HttpError) {
+                send(response, error.status, 'application/json', undefined, JSON.stringify({ error: { code: error.code, message: error.message } }));
+                return;
+            }
+            // A tool that throws is an error result the screen shows, as over MCP.
+            const result = errorResult(error);
+            send(response, 200, 'application/json', undefined, JSON.stringify({ result, decided: null, ending: false }));
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(options.port ?? 0, '127.0.0.1', () => { server.off('error', reject); resolve(); });
+    });
+    port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/?t=${token}`,
+        port,
+        token,
+        runDir,
+        close: () => new Promise((resolve) => {
+            if (pending)
+                clearTimeout(pending.timer);
+            pending = undefined;
+            server.close(() => { resolve(); });
+            server.closeAllConnections();
+        }),
+    };
+};
+//# sourceMappingURL=slate-browser-server.js.map

package/dist/slate-browser-server.js.map

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

package/dist/slate-commit.d.ts

@@ -0,0 +1,28 @@
+import { type SlateWorkAction } from './slate-actions.js';
+import type { SlateOp, SlateWorkspace } from './slate-workspace-types.js';
+/**
+ * The commit critical section. Inside ONE workspace lock this does the op-id
+ * lookup, the intent lookup, the busy check, index and label allocation, the
+ * frozen selection and reference skip list, the edit's parent copy and
+ * annotated image, the approval write, and the op, round and option appends.
+ * Everything decided here is stored in `op.params` and is never recomputed by
+ * the runner or by `resume`.
+ */
+/** The dedupe key for one intent: the workspace and the normalized action, no op id. */
+export declare const intentDigestOf: (workspaceId: string, action: SlateWorkAction) => string;
+/** References earlier rounds used, sorted, so a searching round meets ones it has not shown before. */
+export declare const referenceSkipList: (workspace: SlateWorkspace) => string[];
+/** Option `i` of a round draws from the selected reference `i mod n`. */
+export declare const optionReferences: (selected: readonly string[], count: number) => string[];
+export type CommitResult = {
+    op: SlateOp;
+    created: boolean;
+};
+export declare const commitAction: (args: {
+    root: string;
+    stateRoot: string;
+    opId: string;
+    action: SlateWorkAction;
+    now?: () => Date;
+}) => Promise<CommitResult>;
+//# sourceMappingURL=slate-commit.d.ts.map

package/dist/slate-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slate-commit.d.ts","sourceRoot":"","sources":["../src/slate-commit.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW7F,OAAO,KAAK,EAEV,OAAO,EAGP,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;GAOG;AAEH,wFAAwF;AACxF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE,QAAQ,eAAe,KAAG,MAA2C,CAAC;AAE1H,uGAAuG;AACvG,eAAO,MAAM,iBAAiB,GAAI,WAAW,cAAc,KAAG,MAAM,EAEnE,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,GAAI,UAAU,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM,KAAG,MAAM,EAEnF,CAAC;AAsHF,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D,eAAO,MAAM,YAAY,GAAU,MAAM;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,KAAG,OAAO,CAAC,YAAY,CAiFa,CAAC"}