@efectoapp/mcp-studio 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# @efectoapp/mcp-studio
+
+MCP server for **Efecto Studio** — give AI agents the full power of Studio's web design tools.
+
+Every tool is first-class. No proxy pattern, no session ID juggling. Create a session, and all 33 design tools are immediately available.
+
+## Install
+
+```bash
+npx @efectoapp/mcp-studio install
+```
+
+This registers the MCP server in `~/.claude.json` and installs the Studio skill file. Restart Claude Code after installing.
+
+## Uninstall
+
+```bash
+npx @efectoapp/mcp-studio uninstall
+```
+
+## How It Works
+
+1. Agent calls `create_session` → gets a Studio URL
+2. User opens the URL in their browser
+3. Agent uses any of the 36 tools directly — they execute in the browser in real-time
+4. User sees every change live as the agent builds the design
+
+## Tools (36 total)
+
+### Session (3)
+
+| Tool | Description |
+|------|-------------|
+| `create_session` | Create a session, returns URL for the user |
+| `session_status` | Check browser connection status |
+| `close_session` | Close session and clean up |
+
+### Reading State (4)
+
+| Tool | Description |
+|------|-------------|
+| `get_document` | Get full document as JSX markup |
+| `list_artboards` | List all artboards with metadata |
+| `find_nodes` | Search nodes by name/type/class |
+| `get_node_tree` | Get JSX for one node/artboard subtree (faster than full doc) |
+
+### Creating Content (4)
+
+| Tool | Description |
+|------|-------------|
+| `create_artboard` | Create a new artboard |
+| `add_section` | Add complex layouts from JSX (preferred) |
+| `add_node` | Add a single node |
+| `replace_section` | Replace a node with new JSX |
+
+### Modifying Content (4)
+
+| Tool | Description |
+|------|-------------|
+| `update_node` | Update any node property |
+| `update_class` | Update only className |
+| `update_artboard` | Update artboard properties |
+| `batch_update` | Bulk update multiple nodes |
+
+### Organizing Structure (6)
+
+| Tool | Description |
+|------|-------------|
+| `move_node` | Reparent or reorder |
+| `duplicate_node` | Clone a node |
+| `duplicate_artboard` | Clone an artboard |
+| `group_nodes` | Wrap nodes in a frame |
+| `ungroup_node` | Unwrap a group container |
+| `reorder_node` | Z-order (front/back) |
+
+### Display & Deletion (5)
+
+| Tool | Description |
+|------|-------------|
+| `select_nodes` | Highlight nodes for the user |
+| `deselect_all` | Clear the selection |
+| `set_visibility` | Show/hide nodes |
+| `delete_nodes` | Delete nodes |
+| `delete_artboard` | Delete an artboard |
+
+### Alignment & Distribution (2)
+
+| Tool | Description |
+|------|-------------|
+| `align_nodes` | Align nodes (left/center/right/top/middle/bottom) |
+| `distribute_nodes` | Distribute evenly (horizontal/vertical) |
+
+### History (2)
+
+| Tool | Description |
+|------|-------------|
+| `undo` | Undo last action |
+| `redo` | Redo last undone action |
+
+### Viewport & Document (5)
+
+| Tool | Description |
+|------|-------------|
+| `zoom_to_artboard` | Zoom to show an artboard |
+| `zoom_to_fit` | Zoom to fit all artboards |
+| `set_viewport` | Set zoom level and pan position |
+| `rename_document` | Rename the document |
+| `new_document` | Start a new blank document |
+
+### Canvas (1)
+
+| Tool | Description |
+|------|-------------|
+| `move_artboard` | Reposition artboard on canvas for multi-screen flows |
+
+## Auto-Session
+
+The MCP process holds the active session in memory. After `create_session`, all design tools automatically use it — no need to pass `sessionId`. For multi-session edge cases, every tool accepts an optional `sessionId` override.
+
+## Links
+
+- **Docs**: https://efecto.app/docs/studio
+- **App**: https://efecto.app/studio
+- **GitHub**: https://github.com/pablostanley/efecto-app

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Efecto Studio MCP CLI
+ *
+ * Simple commands:
+ *   npx @efectoapp/mcp-studio install   - Add Efecto Studio to Claude Code
+ *   npx @efectoapp/mcp-studio uninstall - Remove Efecto Studio from Claude Code
+ */
+export declare function runCLI(): boolean;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAwPH,wBAAgB,MAAM,IAAI,OAAO,CAoBhC"}

package/dist/cli.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Efecto Studio MCP CLI
+ *
+ * Simple commands:
+ *   npx @efectoapp/mcp-studio install   - Add Efecto Studio to Claude Code
+ *   npx @efectoapp/mcp-studio uninstall - Remove Efecto Studio from Claude Code
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCLI = runCLI;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ANSI colors for pretty output
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+// The MCP server config we add
+const EFECTOSTUDIO_CONFIG = {
+    command: 'npx',
+    args: ['-y', '@efectoapp/mcp-studio'],
+};
+const SERVER_KEY = 'efectostudio';
+const SKILLS_DIR_NAME = 'efectostudio';
+// Get the path to ~/.claude.json
+function getClaudeConfigPath() {
+    return path.join(os.homedir(), '.claude.json');
+}
+// Read ~/.claude.json file
+function readClaudeConfig(filePath) {
+    try {
+        if (fs.existsSync(filePath)) {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Invalid JSON, return empty
+    }
+    return {};
+}
+// Write ~/.claude.json file
+function writeClaudeConfig(filePath, config) {
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+}
+// Check if Claude Code is installed
+function isClaudeCodeInstalled() {
+    const claudeDir = path.join(os.homedir(), '.claude');
+    return fs.existsSync(claudeDir);
+}
+// Get the path to the bundled skills directory
+function getSkillsSourceDir() {
+    return path.join(__dirname, '..', 'skills');
+}
+// Get the target directory for skills (~/.claude/skills/efectostudio/)
+function getSkillsTargetDir() {
+    return path.join(os.homedir(), '.claude', 'skills', SKILLS_DIR_NAME);
+}
+// Install the design skill files
+function installSkills() {
+    const sourceDir = getSkillsSourceDir();
+    const targetDir = getSkillsTargetDir();
+    const skillFile = path.join(sourceDir, 'STUDIO-SKILL.md');
+    if (!fs.existsSync(skillFile)) {
+        return false;
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    const files = ['STUDIO-SKILL.md'];
+    for (const file of files) {
+        const src = path.join(sourceDir, file);
+        const dest = path.join(targetDir, file);
+        if (fs.existsSync(src)) {
+            fs.copyFileSync(src, dest);
+        }
+    }
+    return true;
+}
+// Remove the design skill files
+function uninstallSkills() {
+    const targetDir = getSkillsTargetDir();
+    if (fs.existsSync(targetDir)) {
+        const files = ['STUDIO-SKILL.md'];
+        for (const file of files) {
+            const filePath = path.join(targetDir, file);
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        try {
+            fs.rmdirSync(targetDir);
+            const skillsDir = path.dirname(targetDir);
+            fs.rmdirSync(skillsDir);
+        }
+        catch {
+            // Directory not empty, that's fine
+        }
+    }
+}
+// Install
+function install() {
+    console.log('');
+    console.log(bold('  🎨 Efecto Studio MCP Installer'));
+    console.log(dim('  ────────────────────────────────'));
+    console.log('');
+    if (!isClaudeCodeInstalled()) {
+        console.log(red('  ✗ Claude Code not found'));
+        console.log('');
+        console.log('  Make sure Claude Code is installed:');
+        console.log(cyan('  https://claude.ai/code'));
+        console.log('');
+        process.exit(1);
+    }
+    const configPath = getClaudeConfigPath();
+    const config = readClaudeConfig(configPath);
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+        config.mcpServers = {};
+    }
+    const mcpServers = config.mcpServers;
+    if (mcpServers[SERVER_KEY]) {
+        console.log(yellow('  ⚠ Efecto Studio is already installed'));
+        console.log('');
+        console.log(dim(`  Config: ${configPath}`));
+        console.log('');
+        console.log('  To reinstall, run:');
+        console.log(cyan('  npx @efectoapp/mcp-studio uninstall'));
+        console.log(cyan('  npx @efectoapp/mcp-studio install'));
+        console.log('');
+        process.exit(0);
+    }
+    mcpServers[SERVER_KEY] = EFECTOSTUDIO_CONFIG;
+    writeClaudeConfig(configPath, config);
+    console.log(green('  ✓ MCP server installed'));
+    const skillsInstalled = installSkills();
+    if (skillsInstalled) {
+        console.log(green('  ✓ Studio skill installed'));
+        console.log(dim(`    → ${getSkillsTargetDir()}`));
+    }
+    console.log('');
+    console.log(dim(`  Config: ${configPath}`));
+    console.log('');
+    console.log(bold('  Next steps:'));
+    console.log('');
+    console.log('  1. Restart Claude Code');
+    console.log('');
+    console.log('  2. Try it out! Just ask Claude:');
+    console.log(cyan('     "Design a landing page in Efecto Studio"'));
+    console.log(cyan('     "Create a mobile app screen with a dark theme"'));
+    console.log(cyan('     "Build a pricing page for my SaaS product"'));
+    console.log('');
+    console.log(dim('  Docs: https://efecto.app/docs/studio'));
+    console.log('');
+}
+// Uninstall
+function uninstall() {
+    console.log('');
+    console.log(bold('  🎨 Efecto Studio MCP Uninstaller'));
+    console.log(dim('  ────────────────────────────────'));
+    console.log('');
+    const configPath = getClaudeConfigPath();
+    if (!fs.existsSync(configPath)) {
+        console.log(yellow('  ⚠ No Claude Code config found'));
+        console.log('');
+        console.log('  Nothing to uninstall.');
+        console.log('');
+        process.exit(0);
+    }
+    const config = readClaudeConfig(configPath);
+    const mcpServers = config.mcpServers;
+    if (!mcpServers || !mcpServers[SERVER_KEY]) {
+        console.log(yellow('  ⚠ Efecto Studio is not installed'));
+        console.log('');
+        console.log('  Nothing to uninstall.');
+        console.log('');
+        process.exit(0);
+    }
+    delete mcpServers[SERVER_KEY];
+    if (Object.keys(mcpServers).length === 0) {
+        delete config.mcpServers;
+    }
+    writeClaudeConfig(configPath, config);
+    uninstallSkills();
+    console.log(green('  ✓ Efecto Studio uninstalled'));
+    console.log('');
+    console.log(dim(`  Config: ${configPath}`));
+    console.log('');
+    console.log('  Restart Claude Code to apply changes.');
+    console.log('');
+    console.log('  To reinstall later:');
+    console.log(cyan('  npx @efectoapp/mcp-studio install'));
+    console.log('');
+}
+// Show help
+function showHelp() {
+    console.log('');
+    console.log(bold('  🎨 Efecto Studio MCP'));
+    console.log(dim('  ────────────────────'));
+    console.log('');
+    console.log('  Design web pages with AI. Create artboards, add sections,');
+    console.log('  style with Tailwind CSS — all from Claude Code.');
+    console.log('');
+    console.log(bold('  Commands:'));
+    console.log('');
+    console.log(`  ${cyan('npx @efectoapp/mcp-studio install')}`);
+    console.log('      Add Efecto Studio to Claude Code');
+    console.log('');
+    console.log(`  ${cyan('npx @efectoapp/mcp-studio uninstall')}`);
+    console.log('      Remove Efecto Studio from Claude Code');
+    console.log('');
+    console.log(bold('  After installing:'));
+    console.log('');
+    console.log('  1. Restart Claude Code');
+    console.log('  2. Ask Claude to create something:');
+    console.log(cyan('     "Design a landing page in Studio"'));
+    console.log('');
+    console.log(dim('  Docs: https://efecto.app/docs/studio'));
+    console.log('');
+}
+// Main CLI entry point
+function runCLI() {
+    const args = process.argv.slice(2);
+    const command = args[0]?.toLowerCase();
+    switch (command) {
+        case 'install':
+            install();
+            return true;
+        case 'uninstall':
+        case 'remove':
+            uninstall();
+            return true;
+        case 'help':
+        case '--help':
+        case '-h':
+            showHelp();
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Efecto Studio MCP Server
+ *
+ * Gives AI agents the full power of Efecto Studio's design tools.
+ * Every tool is first-class — no proxy pattern, no session ID juggling.
+ *
+ * INSTALL:
+ *   npx @efectoapp/mcp-studio install
+ *
+ * UNINSTALL:
+ *   npx @efectoapp/mcp-studio uninstall
+ *
+ * Then restart Claude Code and ask:
+ *   "Design a landing page in Efecto Studio"
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Efecto Studio MCP Server
+ *
+ * Gives AI agents the full power of Efecto Studio's design tools.
+ * Every tool is first-class — no proxy pattern, no session ID juggling.
+ *
+ * INSTALL:
+ *   npx @efectoapp/mcp-studio install
+ *
+ * UNINSTALL:
+ *   npx @efectoapp/mcp-studio uninstall
+ *
+ * Then restart Claude Code and ask:
+ *   "Design a landing page in Efecto Studio"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_js_1 = require("./cli.js");
+// Check if this is a CLI command (install, uninstall, help)
+if ((0, cli_js_1.runCLI)()) {
+    process.exit(0);
+}
+// Otherwise, run as MCP server
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const session_js_1 = require("./tools/session.js");
+const studio_js_1 = require("./tools/studio.js");
+// Combine all tools
+const allTools = [...session_js_1.sessionTools, ...studio_js_1.studioTools];
+// Create server instance
+const server = new index_js_1.Server({
+    name: 'efectostudio-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool listing
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools: allTools };
+});
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        // Session tools
+        if (session_js_1.sessionTools.some(t => t.name === name)) {
+            return await (0, session_js_1.handleSessionTool)(name, args);
+        }
+        // Studio design tools
+        if (studio_js_1.studioTools.some(t => t.name === name)) {
+            return await (0, studio_js_1.handleStudioTool)(name, args);
+        }
+        return {
+            content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+            isError: true,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Efecto Studio MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;GAcG;;AAEH,qCAAiC;AAEjC,4DAA4D;AAC5D,IAAI,IAAA,eAAM,GAAE,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,+BAA+B;AAC/B,wEAAkE;AAClE,wEAAgF;AAChF,iEAG2C;AAE3C,mDAAoE;AACpE,iDAAiE;AAEjE,oBAAoB;AACpB,MAAM,QAAQ,GAAG,CAAC,GAAG,yBAAY,EAAE,GAAG,uBAAW,CAAC,CAAA;AAElD,yBAAyB;AACzB,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB;IACE,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAA;AAED,sBAAsB;AACtB,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;AAC5B,CAAC,CAAC,CAAA;AAEF,oBAAoB;AACpB,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAA;IAEhD,IAAI,CAAC;QACH,gBAAgB;QAChB,IAAI,yBAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO,MAAM,IAAA,8BAAiB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC5C,CAAC;QAED,sBAAsB;QACtB,IAAI,uBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,IAAA,4BAAgB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC3C,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;iBAC3E;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/tools/session.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Studio Session Tools
+ *
+ * Manages the lifecycle of a Studio session. The MCP process holds
+ * the active session ID in memory so agents don't have to pass it around.
+ *
+ * - create_session: Create a new session, store internally, return URL
+ * - session_status: Check browser connection + pending calls
+ * - close_session: Close session, clear internal state
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/** Get the active session ID (used by studio tools) */
+export declare function getActiveSessionId(): string | null;
+export declare const sessionTools: Tool[];
+export declare function handleSessionTool(name: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAW9D,uDAAuD;AACvD,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAMD,eAAO,MAAM,YAAY,EAAE,IAAI,EAiD9B,CAAA;AAMD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiO7D"}