x-m32-mcp-server 3.0.0 → 3.2.0

package/README.md

@@ -1,36 +1,51 @@
-# X/M32 MCP Server
+# X32/M32 MCP Server
 
-A Model Context Protocol (MCP) server for controlling Behringer X32/M32 digital mixing consoles via OSC protocol.
+A comprehensive Model Context Protocol (MCP) server for controlling Behringer X32/M32 digital mixing consoles via OSC protocol.
 
 ## Overview
 
-This MCP server enables AI assistants to control X32/M32 digital mixing consoles through semantic, task-based tools. It implements the OSC (Open Sound Control) protocol to communicate with the mixer over the network, providing intuitive channel control, routing, and configuration
-capabilities.
+This MCP server enables AI assistants to control X32/M32 digital mixing consoles through semantic, task-based tools. It implements the OSC (Open Sound Control) protocol to communicate with the mixer over the network, providing intuitive control of channels, buses, effects, and
+routing with a focus on type safety and developer experience.
 
 ## Features
 
-### 🎛️ Channel Control
+### Connection Management
 
-- **Volume Control**: Set channel faders with support for both linear (0.0-1.0) and dB values (-90 to +10 dB)
+- Connect and disconnect from X32/M32 mixers over network
+- Retrieve mixer information (model, firmware version)
+- Monitor connection status and network configuration
+- Auto-discovery support for standard X32 port (10023)
+
+### Channel Control
+
+- **Volume Control**: Set channel faders with both linear (0.0-1.0) and dB values (-90 to +10 dB)
 - **Gain Control**: Adjust preamp gain for input channels
 - **Mute/Solo**: Control channel mute and solo states
 - **Pan Control**: Set stereo positioning with multiple input formats (percentage, LR notation, linear)
 - **EQ Control**: Configure 4-band parametric EQ per channel
+- **Channel Configuration**: Set custom names (max 12 characters) and colors (16 color options)
+
+### Bus/Aux Control
+
+- **Bus Volume**: Set mix bus fader levels with linear or dB values
+- **Bus Mute**: Mute/unmute mix buses
+- **Channel Sends**: Control channel send levels to buses
+- **Bus State**: Retrieve complete bus configuration and status
 
-### 🎨 Channel Configuration
+### Effects Processing
 
-- **Naming**: Set custom channel names (max 12 characters)
-- **Colors**: Assign channel strip colors for visual organization (16 colors including inverted variants)
+- **Parameter Control**: Set effects parameters on 8 FX racks
+- **Bypass Control**: Bypass or enable effects processing
+- **State Retrieval**: Get complete effects rack state and configuration
 
-### 🔌 Connection Management
+### Main/Monitor Outputs
 
-- **Connect/Disconnect**: Establish and manage connections to X32/M32 mixers
-- **Status Monitoring**: Get connection status and mixer information
-- **Auto-discovery**: Support for standard X32 port (10023)
+- **Main Output**: Control main stereo output volume and mute
+- **Monitor Control**: Set monitor output levels
 
-### 🔧 Low-Level Access
+### Low-Level Access
 
-- **Parameter Control**: Direct access to any OSC parameter for advanced users
+- **Parameter Tools**: Direct access to any OSC parameter for advanced users
 - **Generic Get/Set**: Read and write any mixer parameter by OSC address
 
 ## Installation
@@ -92,34 +107,61 @@ connection_connect with host: "192.168.1.100" and port: 10023
 
 ## Available Tools
 
-### Connection Tools
+Complete reference of all 21 tools organized by domain:
+
+### Connection Tools (4 tools)
+
+| Tool                    | Description                                    | Parameters                                   |
+| ----------------------- | ---------------------------------------------- | -------------------------------------------- |
+| `connection_connect`    | Connect to X32/M32 mixer via OSC               | `host` (IP address), `port` (default: 10023) |
+| `connection_disconnect` | Disconnect from mixer                          | None                                         |
+| `connection_get_info`   | Get mixer model and firmware information       | None                                         |
+| `connection_get_status` | Get current connection status and network info | None                                         |
+
+### Channel Tools (8 tools)
 
-| Tool                    | Description                       |
-| ----------------------- | --------------------------------- |
-| `connection_connect`    | Connect to X32/M32 mixer          |
-| `connection_disconnect` | Disconnect from mixer             |
-| `connection_get_info`   | Get mixer model and firmware info |
-| `connection_get_status` | Get current connection status     |
+| Tool                  | Description             | Parameters                                                   |
+| --------------------- | ----------------------- | ------------------------------------------------------------ |
+| `channel_set_volume`  | Set channel fader level | `channel` (1-32), `value`, `unit` (linear/db)                |
+| `channel_set_gain`    | Set preamp gain         | `channel` (1-32), `gain` (0.0-1.0)                           |
+| `channel_mute`        | Mute/unmute channel     | `channel` (1-32), `muted` (boolean)                          |
+| `channel_solo`        | Solo/unsolo channel     | `channel` (1-32), `solo` (boolean)                           |
+| `channel_set_name`    | Set channel name/label  | `channel` (1-32), `name` (max 12 chars)                      |
+| `channel_set_color`   | Set channel strip color | `channel` (1-32), `color` (name or 0-15)                     |
+| `channel_set_pan`     | Set stereo pan position | `channel` (1-32), `pan` (percentage/LR/linear)               |
+| `channel_set_eq_band` | Configure EQ band       | `channel` (1-32), `band` (1-4), `parameter` (f/g/q), `value` |
 
-### Channel Tools
+### Bus Tools (4 tools)
 
-| Tool                  | Description         | Parameters                              |
-| --------------------- | ------------------- | --------------------------------------- |
-| `channel_set_volume`  | Set channel fader   | `channel`, `value`, `unit` (linear/db)  |
-| `channel_set_gain`    | Set preamp gain     | `channel`, `gain`                       |
-| `channel_mute`        | Mute/unmute channel | `channel`, `muted`                      |
-| `channel_solo`        | Solo/unsolo channel | `channel`, `solo`                       |
-| `channel_set_name`    | Set channel name    | `channel`, `name`                       |
-| `channel_set_color`   | Set channel color   | `channel`, `color`                      |
-| `channel_set_pan`     | Set stereo position | `channel`, `pan`                        |
-| `channel_set_eq_band` | Configure EQ band   | `channel`, `band`, `parameter`, `value` |
+| Tool             | Description                   | Parameters                                                  |
+| ---------------- | ----------------------------- | ----------------------------------------------------------- |
+| `bus_set_volume` | Set bus fader level           | `bus` (1-16), `value`, `unit` (linear/db)                   |
+| `bus_mute`       | Mute/unmute bus               | `bus` (1-16), `muted` (boolean)                             |
+| `bus_set_send`   | Set channel send level to bus | `channel` (1-32), `bus` (1-16), `value`, `unit` (linear/db) |
+| `bus_get_state`  | Get complete bus state        | `bus` (1-16)                                                |
 
-### Low-Level Tools
+### FX Tools (3 tools)
 
-| Tool            | Description                      |
-| --------------- | -------------------------------- |
-| `get_parameter` | Get any parameter by OSC address |
-| `set_parameter` | Set any parameter by OSC address |
+| Tool               | Description                 | Parameters                                        |
+| ------------------ | --------------------------- | ------------------------------------------------- |
+| `fx_set_parameter` | Set effects parameter value | `fx` (1-8), `parameter` (1-64), `value` (0.0-1.0) |
+| `fx_get_state`     | Get effects rack state      | `fx` (1-8)                                        |
+| `fx_bypass`        | Bypass/enable effect        | `fx` (1-8), `bypass` (boolean)                    |
+
+### Main/Monitor Tools (3 tools)
+
+| Tool                | Description                   | Parameters                  |
+| ------------------- | ----------------------------- | --------------------------- |
+| `main_set_volume`   | Set main stereo output volume | `value`, `unit` (linear/db) |
+| `main_mute`         | Mute/unmute main output       | `muted` (boolean)           |
+| `monitor_set_level` | Set monitor output level      | `value`, `unit` (linear/db) |
+
+### Low-Level Tools (2 tools)
+
+| Tool            | Description                      | Parameters                    |
+| --------------- | -------------------------------- | ----------------------------- |
+| `get_parameter` | Get any parameter by OSC address | `address` (OSC path)          |
+| `set_parameter` | Set any parameter by OSC address | `address` (OSC path), `value` |
 
 ## Usage Examples
 
@@ -151,7 +193,7 @@ await channel_set_volume({ channel: 1, value: -10, unit: 'db' });
 // Using linear values (0.0 to 1.0)
 await channel_set_volume({ channel: 1, value: 0.75, unit: 'linear' });
 
-// Unity gain (0 dB)
+// Unity gain (0 dB = 0.75 linear)
 await channel_set_volume({ channel: 1, value: 0, unit: 'db' });
 ```
 
@@ -170,6 +212,48 @@ await channel_set_pan({ channel: 1, pan: 'R75' }); // 75% right
 await channel_set_pan({ channel: 1, pan: 0.5 }); // Center
 ```
 
+### Bus Routing and Mixing
+
+```javascript
+// Set bus 1 volume
+await bus_set_volume({ bus: 1, value: -6, unit: 'db' });
+
+// Send channel 5 to bus 1 (aux send)
+await bus_set_send({ channel: 5, bus: 1, value: 0.8, unit: 'linear' });
+
+// Mute bus 2
+await bus_mute({ bus: 2, muted: true });
+
+// Get complete bus state
+await bus_get_state({ bus: 1 });
+```
+
+### Effects Control
+
+```javascript
+// Set reverb time (example - parameter 01 on FX rack 1)
+await fx_set_parameter({ fx: 1, parameter: 1, value: 0.7 });
+
+// Bypass FX rack 2
+await fx_bypass({ fx: 2, bypass: true });
+
+// Get FX rack state
+await fx_get_state({ fx: 1 });
+```
+
+### Main Output Control
+
+```javascript
+// Set main output to -3 dB
+await main_set_volume({ value: -3, unit: 'db' });
+
+// Mute main output (emergency mute)
+await main_mute({ muted: true });
+
+// Set monitor level
+await monitor_set_level({ value: 0.6, unit: 'linear' });
+```
+
 ## Technical Details
 
 ### Architecture
@@ -191,54 +275,99 @@ X32/M32 Mixer
 ```
 X32-MCP/
 ├── src/
-│   ├── index.ts           # Entry point
-│   ├── server.ts           # Server configuration
-│   ├── mcp/                # MCP protocol implementation
-│   ├── tools/              # Domain-based tool implementations
-│   │   ├── channel.ts     # Channel control tools
-│   │   ├── connection.ts  # Connection management tools
-│   │   └── parameter.ts   # Low-level parameter tools
-│   ├── services/           # Business logic
-│   │   └── x32-connection.ts  # X32 OSC communication
-│   ├── types/              # TypeScript type definitions
-│   └── utils/              # Utility functions
-│       ├── db-converter.ts    # dB/linear conversion
+│   ├── index.ts              # Entry point
+│   ├── server.ts             # Server configuration
+│   ├── mcp/                  # MCP protocol implementation
+│   ├── tools/                # Domain-based tool implementations
+│   │   ├── connection.ts     # Connection management (4 tools)
+│   │   ├── channel.ts        # Channel control (8 tools)
+│   │   ├── bus.ts            # Bus/aux control (4 tools)
+│   │   ├── fx.ts             # Effects control (3 tools)
+│   │   ├── main.ts           # Main/monitor outputs (3 tools)
+│   │   └── parameter.ts      # Low-level parameter access (2 tools)
+│   ├── services/             # Business logic
+│   │   ├── x32-connection.ts # X32 OSC communication
+│   │   └── __mocks__/        # Mock implementations for testing
+│   ├── types/                # TypeScript type definitions
+│   └── utils/                # Utility functions
+│       ├── db-converter.ts   # dB/linear conversion
 │       ├── color-converter.ts # Color mapping
-│       └── pan-converter.ts   # Pan value conversion
-└── docs/                   # Documentation
-    └── OSC-Protocol.md     # X32 OSC protocol reference
+│       └── pan-converter.ts  # Pan value conversion
+├── docs/                     # Documentation
+│   └── OSC-Protocol.md       # X32 OSC protocol reference
+└── package.json              # Project metadata (v3.1.0)
 ```
 
 ### OSC Protocol Implementation
 
-The server implements the X32/M32 OSC protocol for:
+The server implements the X32/M32 OSC protocol for comprehensive mixer control:
 
-- Channel parameters (`/ch/XX/...`)
-- Bus routing (`/bus/XX/...`)
-- Effects (`/fx/XX/...`)
-- Main mix (`/main/...`)
-- Configuration (`/config/...`)
+- **Channel parameters** (`/ch/XX/...`) - 32 input channels with full processing control
+- **Bus routing** (`/bus/XX/...`) - 16 mix buses for aux sends and monitor mixes
+- **Effects** (`/fx/XX/...`) - 8 FX racks with full parameter control
+- **Main mix** (`/main/...`) - Main stereo output and monitoring
+- **Configuration** (`/config/...`) - Naming, colors, and system settings
 
 See `docs/OSC-Protocol.md` for detailed protocol documentation.
 
+### Value Conversions
+
+The server handles automatic conversions between different value formats:
+
+- **dB to Linear**: Fader values use non-linear mapping (-90 dB to +10 dB → 0.0 to 1.0)
+- **Pan Values**: Supports percentage (-100 to +100), LR notation (L50/C/R75), and linear (0.0-1.0)
+- **Color Mapping**: Named colors (red, green, blue, etc.) mapped to numeric values (0-15)
+
 ## Development
 
 ### Running Tests
 
 ```bash
+# Run all tests
 npm test
+
+# Run specific test file
+npx jest src/tools/channel.test.ts
+
+# Run tests matching pattern
+npx jest -t "channel_set_volume"
 ```
 
+### Testing Infrastructure
+
+The project includes a comprehensive mock testing infrastructure:
+
+- **MockX32Connection**: Full OSC protocol simulation without hardware
+- **Unit Tests**: Tests for all utility functions (db-converter, color-converter, pan-converter)
+- **Integration Tests**: Domain tool tests verifying complete workflows
+- **Type Safety**: Strict TypeScript checking with 100% type coverage
+
+Test coverage includes:
+
+- Channel operations (volume, gain, mute, solo, EQ, pan, name, color)
+- Bus routing and mixing
+- Effects parameter control
+- Error handling and validation
+- State management across multiple channels/buses
+
 ### Building
 
 ```bash
+# Production build
 npm run build
+
+# Watch mode for development
+npm run build:watch
 ```
 
 ### Linting
 
 ```bash
+# Check code style
 npm run lint
+
+# Fix issues automatically
+npm run lint:fix
 ```
 
 ## Testing with X32 Emulator
@@ -247,7 +376,24 @@ For development without physical hardware, you can use the X32 emulator:
 
 1. Download the X32 emulator from the Behringer website
 2. Run the emulator (default port: 10023)
-3. Connect using `connection_connect` with host: `10.69.6.254`
+3. Connect using `connection_connect` with host: `127.0.0.1` or emulator IP
+
+Alternatively, use the built-in mock testing infrastructure for unit testing without any hardware.
+
+## Color Reference
+
+Available channel/bus colors:
+
+| Color   | Value | Inverted         |
+| ------- | ----- | ---------------- |
+| Off     | 0     | -                |
+| Red     | 1     | red-inv (9)      |
+| Green   | 2     | green-inv (10)   |
+| Yellow  | 3     | yellow-inv (11)  |
+| Blue    | 4     | blue-inv (12)    |
+| Magenta | 5     | magenta-inv (13) |
+| Cyan    | 6     | cyan-inv (14)    |
+| White   | 7     | white-inv (15)   |
 
 ## Contributing
 
@@ -265,6 +411,25 @@ Contributions are welcome! Please:
 - Keep tools focused on single responsibilities
 - Include comprehensive JSDoc comments
 - Follow TypeScript strict mode requirements
+- Maintain 100% type coverage for public APIs
+- Add unit tests for all new functionality
+
+### Tool Design Principles
+
+When adding new tools, follow these principles:
+
+- **Task-based**: Tools represent user intentions, not API endpoints
+- **Domain-focused**: Group related operations by domain (channel, bus, fx, etc.)
+- **Type-safe**: Use domain-specific parameters, not raw OSC addresses
+- **Self-documenting**: Clear names, descriptions, and parameter definitions
+
+See `CLAUDE.md` for detailed MCP tool design guidelines.
+
+## Version History
+
+- **v3.1.0** (Current) - Added bus, FX, and main/monitor tools, comprehensive testing infrastructure
+- **v2.0.0** - ESM-only architecture, improved type safety
+- **v1.0.0** - Initial release with channel and connection tools
 
 ## License
 
@@ -279,3 +444,9 @@ MIT
 ## Support
 
 For issues, questions, or contributions, please visit: https://github.com/GoBeromsu/X32-MCP
+
+## Related Resources
+
+- [X32/M32 OSC Protocol Documentation](docs/OSC-Protocol.md)
+- [Model Context Protocol Specification](https://modelcontextprotocol.io)
+- [Behringer X32 Official Documentation](https://www.behringer.com/product.html?modelCode=P0ASF)

package/dist/index.js

@@ -2,7 +2,7 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { X32Connection } from './services/x32-connection.js';
-import { registerConnectionTools, registerChannelTools, registerParameterTools } from './tools/index.js';
+import { registerConnectionTools, registerChannelTools, registerBusTools, registerFxTools, registerMainTools, registerParameterTools } from './tools/index.js';
 /**
  * X32 MCP Server
  * Model Context Protocol server for X32/M32 mixer control
@@ -24,6 +24,9 @@ async function main() {
     // Register all domain tools
     registerConnectionTools(server, connection);
     registerChannelTools(server, connection);
+    registerBusTools(server, connection);
+    registerFxTools(server, connection);
+    registerMainTools(server, connection);
     registerParameterTools(server, connection);
     // Setup connection event handlers
     connection.on('connected', () => {
@@ -57,6 +60,22 @@ async function main() {
     console.error('  - channel_set_pan: Set stereo position');
     console.error('  - channel_set_eq_band: Configure EQ');
     console.error('');
+    console.error('Bus tools:');
+    console.error('  - bus_set_volume: Set bus volume (linear or dB)');
+    console.error('  - bus_mute: Mute/unmute bus');
+    console.error('  - bus_set_send: Set channel send level to bus');
+    console.error('  - bus_get_state: Get complete bus state');
+    console.error('');
+    console.error('FX tools:');
+    console.error('  - fx_set_parameter: Set effects parameter');
+    console.error('  - fx_get_state: Get effects state');
+    console.error('  - fx_bypass: Bypass/enable effect');
+    console.error('');
+    console.error('Main/Monitor tools:');
+    console.error('  - main_set_volume: Set main stereo output volume (linear or dB)');
+    console.error('  - main_mute: Mute/unmute main output');
+    console.error('  - monitor_set_level: Set monitor output level (linear or dB)');
+    console.error('');
     console.error('Low-level tools:');
     console.error('  - get_parameter: Get any parameter by OSC address');
     console.error('  - set_parameter: Set any parameter by OSC address');

package/dist/index.js.map

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

package/dist/services/__mocks__/mock-x32-connection.d.ts

@@ -0,0 +1,87 @@
+import { EventEmitter } from 'events';
+import { X32ConnectionConfig, X32InfoResponse, X32StatusResponse, OscMessage } from '../../types/index.js';
+/**
+ * Mock X32 Connection for Testing
+ * Simulates X32/M32 mixer responses without requiring actual hardware
+ */
+export declare class MockX32Connection extends EventEmitter {
+    private isConnected;
+    private config;
+    private parameterStore;
+    private readonly DEFAULT_INFO;
+    private readonly DEFAULT_STATUS;
+    constructor();
+    /**
+     * Initialize default parameter values
+     */
+    private initializeDefaultParameters;
+    /**
+     * Mock connection to X32/M32 mixer
+     */
+    connect(config: X32ConnectionConfig): Promise<void>;
+    /**
+     * Mock disconnection from X32/M32 mixer
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Mock send OSC message
+     */
+    sendMessage(address: string, args?: unknown[], waitForReply?: boolean): Promise<OscMessage | null>;
+    /**
+     * Infer OSC type from value
+     */
+    private inferOscType;
+    /**
+     * Mock get X32/M32 info
+     */
+    getInfo(): Promise<X32InfoResponse>;
+    /**
+     * Mock get X32/M32 status
+     */
+    getStatus(): Promise<X32StatusResponse>;
+    /**
+     * Check if connected
+     */
+    get connected(): boolean;
+    /**
+     * Get connection config
+     */
+    getConfig(): X32ConnectionConfig | null;
+    /**
+     * Mock get parameter value
+     */
+    getParameter<T = unknown>(address: string): Promise<T>;
+    /**
+     * Mock set parameter value
+     */
+    setParameter(address: string, value: unknown): Promise<void>;
+    /**
+     * Mock get channel parameter
+     */
+    getChannelParameter<T = unknown>(channel: number, param: string): Promise<T>;
+    /**
+     * Mock set channel parameter
+     */
+    setChannelParameter(channel: number, param: string, value: unknown): Promise<void>;
+    /**
+     * Mock get bus parameter
+     */
+    getBusParameter<T = unknown>(bus: number, param: string): Promise<T>;
+    /**
+     * Mock set bus parameter
+     */
+    setBusParameter(bus: number, param: string, value: unknown): Promise<void>;
+    /**
+     * Reset mock to initial state
+     */
+    reset(): void;
+    /**
+     * Set custom parameter value for testing
+     */
+    setMockParameter(address: string, value: unknown): void;
+    /**
+     * Get all stored parameters (for debugging)
+     */
+    getMockParameters(): Map<string, unknown>;
+}
+//# sourceMappingURL=mock-x32-connection.d.ts.map

package/dist/services/__mocks__/mock-x32-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-x32-connection.d.ts","sourceRoot":"","sources":["../../../src/services/__mocks__/mock-x32-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE3G;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAK3B;IACF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;;IAOF;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA2BnC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,EAAO,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA6BlH;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAWzC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAW7C;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,IAAI;IAIvC;;OAEG;IACG,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ5D;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE;;OAEG;IACG,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQlF;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxF;;OAEG;IACG,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ1E;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhF;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIvD;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;CAG5C"}