browser-devtools-mcp 0.0.1 → 0.0.2

package/README.md

@@ -23,10 +23,9 @@ Browser DevTools MCP exposes a Playwright-powered browser runtime to AI agents,
 ## Features
 
 ### Content Tools
-- **Screenshots**: Capture full page or specific elements (PNG/JPEG)
-- **ARIA Snapshots**: Accessibility tree capture for understanding page structure
-- **HTML/Text Extraction**: Get page content in various formats
-- **PDF Export**: Save pages as PDF documents
+- **Screenshots**: Capture full page or specific elements (PNG/JPEG) with image data
+- **HTML/Text Extraction**: Get page content with filtering, cleaning, and minification options
+- **PDF Export**: Save pages as PDF documents with customizable format and margins
 
 ### Interaction Tools
 - **Click**: Click elements by CSS selector
@@ -46,6 +45,10 @@ Browser DevTools MCP exposes a Playwright-powered browser runtime to AI agents,
 - **Console Messages**: Capture and filter browser console logs with advanced filtering (level, search, timestamp, sequence number)
 - **HTTP Requests**: Monitor network traffic with detailed request/response data, filtering by resource type, status code, and more
 
+### Accessibility (A11Y) Tools
+- **ARIA Snapshots**: Capture semantic structure and accessibility roles in YAML format
+- **AX Tree Snapshots**: Combine Chromium's Accessibility tree with runtime visual diagnostics (bounding boxes, visibility, occlusion detection, computed styles)
+
 ## Prerequisites
 
 - Node.js 18+
@@ -370,7 +373,7 @@ The server can be configured using environment variables:
 Takes a screenshot of the current page or a specific element.
 
 **Parameters:**
-- `outputPath` (string, required): Directory path where screenshot will be saved
+- `outputPath` (string, optional): Directory path where screenshot will be saved (default: OS temp directory)
 - `name` (string, optional): Screenshot name (default: "screenshot")
 - `selector` (string, optional): CSS selector for element to capture
 - `fullPage` (boolean, optional): Capture full scrollable page (default: false)
@@ -378,41 +381,43 @@ Takes a screenshot of the current page or a specific element.
 
 **Returns:**
 - `filePath` (string): Full path of the saved screenshot file
-
-#### `content_take-aria-snapshot`
-Captures an ARIA (accessibility) snapshot of the current page or a specific element.
-
-**Parameters:**
-- `selector` (string, optional): CSS selector for element to snapshot
-
-**Returns:**
-- `output` (string): YAML-formatted accessibility tree with page URL and title
+- `image` (object): Screenshot image data with mimeType
 
 #### `content_get-as-html`
 Retrieves the HTML content of the current page or a specific element.
 
 **Parameters:**
-- `selector` (string, optional): CSS selector for element
+- `selector` (string, optional): CSS selector to limit the HTML content to a specific container
+- `removeScripts` (boolean, optional): Remove all script tags from the HTML (default: true)
+- `removeComments` (boolean, optional): Remove all HTML comments (default: false)
+- `removeStyles` (boolean, optional): Remove all style tags from the HTML (default: false)
+- `removeMeta` (boolean, optional): Remove all meta tags from the HTML (default: false)
+- `cleanHtml` (boolean, optional): Perform comprehensive HTML cleaning (default: false)
+- `minify` (boolean, optional): Minify the HTML output (default: false)
+- `maxLength` (number, optional): Maximum number of characters to return (default: 50000)
 
 **Returns:**
-- `html` (string): HTML content
+- `output` (string): The requested HTML content of the page
 
 #### `content_get-as-text`
-Retrieves the text content of the current page or a specific element.
+Retrieves the visible text content of the current page or a specific element.
 
 **Parameters:**
-- `selector` (string, optional): CSS selector for element
+- `selector` (string, optional): CSS selector to limit the text content to a specific container
+- `maxLength` (number, optional): Maximum number of characters to return (default: 50000)
 
 **Returns:**
-- `text` (string): Text content
+- `output` (string): The requested text content of the page
 
 #### `content_save-as-pdf`
 Saves the current page as a PDF document.
 
 **Parameters:**
-- `outputPath` (string, required): Directory path where PDF will be saved
+- `outputPath` (string, optional): Directory path where PDF will be saved (default: OS temp directory)
 - `name` (string, optional): PDF name (default: "page")
-- Additional PDF options (format, margin, etc.)
+- `format` (enum, optional): Page format - "Letter", "Legal", "Tabloid", "Ledger", "A0" through "A6" (default: "A4")
+- `printBackground` (boolean, optional): Whether to print background graphics (default: false)
+- `margin` (object, optional): Page margins with top, right, bottom, left (default: "1cm" for each)
 
 **Returns:**
 - `filePath` (string): Full path of the saved PDF file
@@ -524,6 +529,57 @@ Retrieves HTTP requests from the browser with detailed filtering.
 **Returns:**
 - `requests` (array): Array of HTTP requests with URL, method, headers, body, response, timing, and metadata
 
+### Accessibility (A11Y) Tools
+
+#### `a11y_take-aria-snapshot`
+Captures an ARIA (accessibility) snapshot of the current page or a specific element.
+
+**Parameters:**
+- `selector` (string, optional): CSS selector for element to snapshot
+
+**Returns:**
+- `output` (string): Includes the page URL, title, and a YAML-formatted accessibility tree
+
+**Usage:**
+- Use in combination with `accessibility_take-ax-tree-snapshot` for comprehensive UI analysis
+- Provides semantic structure and accessibility roles
+- Helps identify accessibility issues and page hierarchy problems
+
+#### `accessibility_take-ax-tree-snapshot`
+Captures a UI-focused snapshot by combining Chromium's Accessibility (AX) tree with runtime visual diagnostics.
+
+**Parameters:**
+- `roles` (array, optional): Optional role allowlist (button, link, textbox, checkbox, radio, combobox, switch, tab, menuitem, dialog, heading, listbox, listitem, option). If omitted, a built-in set of interactive roles is used
+- `includeStyles` (boolean, optional): Whether to include computed CSS styles for each node (default: true)
+- `includeRuntimeVisual` (boolean, optional): Whether to compute runtime visual information (bounding box, visibility, viewport) (default: true)
+- `checkOcclusion` (boolean, optional): If true, checks whether each element is visually occluded by another element using elementFromPoint() sampled at multiple points (default: false)
+- `onlyVisible` (boolean, optional): If true, only visually visible nodes are returned (default: false)
+- `onlyInViewport` (boolean, optional): If true, only nodes intersecting the viewport are returned (default: false)
+- `textPreviewMaxLength` (number, optional): Maximum length of the text preview extracted from each element (default: 80)
+- `styleProperties` (array, optional): List of CSS computed style properties to extract (default: includes display, visibility, opacity, position, z-index, colors, fonts, etc.)
+
+**Returns:**
+- `url` (string): The current page URL at the time the AX snapshot was captured
+- `title` (string): The document title of the page at the time of the snapshot
+- `axNodeCount` (number): Total number of nodes returned by Chromium Accessibility.getFullAXTree before filtering
+- `candidateCount` (number): Number of DOM-backed AX nodes that passed role filtering before enrichment
+- `enrichedCount` (number): Number of nodes included in the final enriched snapshot output
+- `truncatedBySafetyCap` (boolean): Indicates whether the result set was truncated by an internal safety cap
+- `nodes` (array): List of enriched DOM-backed AX nodes combining accessibility metadata with visual diagnostics, including:
+  - `axNodeId`, `parentAxNodeId`, `childAxNodeIds`: Tree structure
+  - `role`, `name`, `ignored`: Accessibility properties
+  - `backendDOMNodeId`, `domNodeId`, `frameId`: DOM references
+  - `localName`, `id`, `className`, `selectorHint`: Element identification
+  - `textPreview`: Short preview of rendered text content
+  - `styles`: Computed CSS styles (if includeStyles is true)
+  - `runtime`: Visual diagnostics including boundingBox, isVisible, isInViewport, and optional occlusion data
+
+**Usage:**
+- Use to detect UI issues like elements that exist semantically but are visually hidden or off-screen
+- Identify wrong layout/geometry, styling issues, and overlap/stacking/occlusion problems
+- ALWAYS use `checkOcclusion: true` when investigating UI/layout problems
+- Use alongside `a11y_take-aria-snapshot` tool for complete UI analysis
+
 ## Architecture
 
 ### Session Management
@@ -585,28 +641,6 @@ npm run build
 - `npm run lint:check` - Check code formatting
 - `npm run lint:format` - Format code
 
-### Project Structure
-
-```
-src/
-├── browser.ts          # Browser instance management
-├── config.ts           # Configuration and environment variables
-├── context.ts          # MCP session context with monitoring
-├── index.ts            # Entry point (CLI)
-├── logger.ts           # Logging utilities
-├── server.ts           # MCP server creation and tool registration
-├── server-info.ts      # Server metadata and instructions
-├── types.ts            # TypeScript type definitions
-├── utils.ts            # Utility functions
-└── tools/              # Tool implementations
-    ├── content/        # Content extraction tools
-    ├── interaction/    # User interaction tools
-    ├── monitoring/     # Monitoring and debugging tools
-    ├── navigation/     # Navigation tools
-    ├── tool-executor.ts # Tool execution engine
-    └── types.ts        # Tool type definitions
-```
-
 ## Use Cases
 
 ### For AI Coding Assistants
@@ -617,8 +651,9 @@ This server enables AI assistants to:
 2. **Monitor Network Activity**: Track API calls, analyze request/response patterns
 3. **Test User Flows**: Automate navigation and interactions
 4. **Visual Verification**: Compare visual states, verify UI changes
-5. **Accessibility Analysis**: Use ARIA snapshots to understand page structure
-6. **Performance Analysis**: Monitor HTTP request timing and failures
+5. **Content Extraction**: Get HTML/text content with filtering and cleaning options
+6. **Accessibility Analysis**: Use ARIA and AX tree snapshots to understand page structure and detect UI issues
+7. **Performance Analysis**: Monitor HTTP request timing and failures
 
 ### Example Workflow
 
@@ -626,9 +661,10 @@ This server enables AI assistants to:
 2. Take a screenshot with `content_take-screenshot` to see the current state
 3. Check console messages with `monitoring_get-console-messages` for errors
 4. Monitor HTTP requests with `monitoring_get-http-requests` to see API calls
-5. Interact with elements using `interaction_click`, `interaction_fill`, etc.
-6. Capture ARIA snapshot with `content_take-aria-snapshot` to understand structure
+5. Capture accessibility snapshots with `a11y_take-aria-snapshot` and `accessibility_take-ax-tree-snapshot` to understand page structure
+6. Interact with elements using `interaction_click`, `interaction_fill`, etc.
 7. Extract content using `content_get-as-html` or `content_get-as-text`
+8. Save the page as PDF using `content_save-as-pdf` for documentation
 
 ## Contributing
 

package/dist/context.js

@@ -157,6 +157,9 @@ class McpSessionContext {
     }
     async _toHttpRequest(req, sequenceNumber) {
         const res = await req.response();
+        const isRedirect = res
+            ? res.status() >= 300 && res.status() < 400
+            : false;
         return {
             url: req.url(),
             method: req.method(),
@@ -170,7 +173,9 @@ class McpSessionContext {
                     status: res.status(),
                     statusText: res.statusText(),
                     headers: res.headers(),
-                    body: (await res.body()).toString(),
+                    body: isRedirect
+                        ? undefined
+                        : (await res.body()).toString(),
                 }
                 : undefined,
             ok: res ? res.ok() : false,

package/dist/context.js.map

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

package/dist/server-info.js

@@ -1,32 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVER_VERSION = exports.SERVER_NAME = void 0;
+exports.UI_DEBUGGING_POLICY = exports.SERVER_INSTRUCTIONS = exports.SERVER_VERSION = exports.SERVER_NAME = void 0;
 exports.getServerInstructions = getServerInstructions;
 exports.SERVER_NAME = 'browser-devtools-mcp';
 exports.SERVER_VERSION = require('../package.json').version;
-const SERVER_INSTRUCTIONS = `
-This MCP server exposes a Playwright-powered browser runtime to AI agents, enabling deep, bidirectional debugging and interaction with live web pages.
+exports.SERVER_INSTRUCTIONS = `
+This MCP server exposes a Playwright-powered browser runtime to AI agents, 
+enabling deep, bidirectional debugging and interaction with live web pages.
 
-It supports both visual understanding and code-level inspection of browser state, similar to existing Playwright and Chrome DevTools–based MCP servers, with a focus on AI-driven exploration, diagnosis, and action.
+It supports both visual understanding and code-level inspection of browser state, 
+similar to existing Playwright and Chrome DevTools–based MCP servers, with a focus on AI-driven exploration, diagnosis, and action.
 
 Core capabilities include:
-
-- Visual inspection of pages, layout, geometry, visibility, and styles
+- Visual inspection of pages, layout, geometry, visibility, stacking, and styles
 - DOM and code-level debugging, including attributes, computed styles, and accessibility data
-- Correlation between rendered visuals and underlying DOM structure
-- JavaScript evaluation in page context
+- Correlation between rendered visuals and underlying DOM / accessibility structure
+- JavaScript evaluation in page context for advanced diagnostics
 - Browser control and automation (navigation, input, scrolling, viewport control)
 - Long-lived, session-based debugging backed by real Playwright browser instances
 - Streamable responses and server-initiated notifications for interactive analysis
 - Clean lifecycle management and teardown on connection close
 
-This server is designed for AI coding assistants, visual debugging agents, and automated analysis tools that need to reason about what a page looks like, how it is structured, and how it behaves — all through a single MCP interface.
+UI debugging guidance for AI agents:
+- Prefer Accessibility (AX) and ARIA snapshots over raw DOM dumps when diagnosing UI problems.
+  These snapshots provide higher-signal, semantically meaningful anchors (roles, names, states) that
+  map more reliably to what users perceive and what assistive tech can interact with.
+- Use the AX Tree Snapshot tool to correlate interactive semantics with runtime visual truth:
+  bounding boxes, visibility, viewport intersection, and (optionally) computed styles.
+- If a UI control appears present but interactions fail (e.g., clicks do nothing), suspect overlap/occlusion.
+  In such cases, enable occlusion checking ("elementFromPoint") to identify which element is actually on top.
+- Use ARIA snapshots to reason about accessibility roles/states and to validate that the intended
+  semantics (labels, roles, disabled state, focusability) match the visible UI.
+
+This server is designed for AI coding assistants, visual debugging agents, and automated analysis tools 
+that need to reason about what a page looks like, how it is structured, and how it behaves — all through a single MCP interface.
 
 It treats the browser as a queryable, inspectable, and controllable execution environment rather than a static screenshot source.
 `;
+exports.UI_DEBUGGING_POLICY = `
+<ui_debugging_policy>
+When asked to check for UI problems, layout issues, or visual bugs, ALWAYS follow this policy:
+
+1. **Visual Inspection**: Take screenshot for general aesthetics and layout overview
+2. **Accessibility Tree Analysis**: Call "a11y_take-ax-tree-snapshot" tool with "checkOcclusion:true"
+   - Provides precise bounding boxes, runtime visual data, and occlusion detection
+   - Best for detecting overlaps and measuring exact positions
+3. **ARIA Snapshot**: Call "a11y_take-aria-snapshot" tool (full page or specific selector)
+   - Provides semantic structure and accessibility roles
+   - Best for understanding page hierarchy and accessibility issues
+4. **Manual Verification**: Calculate bounding box overlaps:
+   - Horizontal: (element1.x + element1.width) ≤ element2.x
+   - Vertical: (element1.y + element1.height) ≤ element2.y
+5. **Report ALL findings**: aesthetic issues, overlaps, spacing problems, alignment issues, 
+   accessibility problems, semantic structure issues
+
+**Why both tools?**
+- AX tree: Technical measurements, occlusion, precise positioning
+- ARIA snapshot: Semantic understanding, accessibility structure, role hierarchy
+
+Never assume "looks good visually" = "no problems". Overlaps and accessibility issues 
+can be functionally broken while appearing visually correct.
+</ui_debugging_policy>
+`;
 function getServerInstructions() {
     const parts = [];
-    parts.push(SERVER_INSTRUCTIONS);
+    parts.push(exports.SERVER_INSTRUCTIONS);
     const result = parts.join('\n\n');
     return result.trim();
 }

package/dist/server-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-info.js","sourceRoot":"","sources":["../src/server-info.ts"],"names":[],"mappings":";;;AAwBA,sDAOC;AA/BY,QAAA,WAAW,GAAG,sBAAsB,CAAC;AAC1B,sBAAc,GAAK,OAAO,CAAC,iBAAiB,CAAC,SAAC;AAEtE,MAAM,mBAAmB,GAAW;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEF,SAAgB,qBAAqB;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAW,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"server-info.js","sourceRoot":"","sources":["../src/server-info.ts"],"names":[],"mappings":";;;AA+DA,sDAOC;AAtEY,QAAA,WAAW,GAAG,sBAAsB,CAAC;AAC1B,sBAAc,GAAK,OAAO,CAAC,iBAAiB,CAAC,SAAC;AAEzD,QAAA,mBAAmB,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC1C,CAAC;AAEW,QAAA,mBAAmB,GAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwB1C,CAAC;AAEF,SAAgB,qBAAqB;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,2BAAmB,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAW,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/server.js

@@ -41,6 +41,48 @@ const logger = __importStar(require("./logger"));
 const server_info_1 = require("./server-info");
 const tools_1 = require("./tools");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+function _getImage(response) {
+    if ('image' in response &&
+        response.image !== null &&
+        typeof response.image === 'object' &&
+        'data' in response.image &&
+        'mimeType' in response.image &&
+        Buffer.isBuffer(response.image.data) &&
+        typeof response.image.mimeType === 'string') {
+        const image = response.image;
+        delete response.image;
+        return image;
+    }
+}
+function _toResponse(response) {
+    const image = _getImage(response);
+    const contents = [];
+    contents.push({
+        type: 'text',
+        text: JSON.stringify(response, null, 2),
+    });
+    if (image) {
+        if (image.mimeType === 'image/svg+xml') {
+            contents.push({
+                type: 'text',
+                text: image.data.toString(),
+                mimeType: image.mimeType,
+            });
+        }
+        else {
+            contents.push({
+                type: 'image',
+                data: image.data.toString('base64'),
+                mimeType: image.mimeType,
+            });
+        }
+    }
+    return {
+        content: contents,
+        structuredContent: response,
+        isError: false,
+    };
+}
 async function _createSessionContext(sessionIdProvider) {
     const browser = await (0, browser_1.getBrowser)();
     const browserContext = await (0, browser_1.newBrowserContext)(browser);
@@ -59,16 +101,13 @@ async function createServer(opts) {
         instructions: (0, server_info_1.getServerInstructions)(),
     });
     const messages = [];
-    // TODO Add policies as prompts here
-    /*
     messages.push({
         role: 'user',
         content: {
             type: 'text',
-            text: <POLICY>,
+            text: server_info_1.UI_DEBUGGING_POLICY,
         },
     });
-    */
     server.registerPrompt('default_system', {
         title: 'Default System Prompt',
         description: 'General behavior for the AI assistant',
@@ -81,16 +120,7 @@ async function createServer(opts) {
         return async (args) => {
             try {
                 const response = await toolExecutor.executeTool(tool, args);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(response, null, 2),
-                        },
-                    ],
-                    structuredContent: response,
-                    isError: false,
-                };
+                return _toResponse(response);
             }
             catch (error) {
                 return {

package/dist/server.js.map

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

package/dist/tools/a11y/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tools = void 0;
+const take_aria_snapshot_1 = require("./take-aria-snapshot");
+const take_ax_tree_snapshot_1 = require("./take-ax-tree-snapshot");
+exports.tools = [new take_aria_snapshot_1.TakeAriaSnapshot(), new take_ax_tree_snapshot_1.TakeAxTreeSnapshot()];
+//# sourceMappingURL=index.js.map

package/dist/tools/a11y/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/a11y/index.ts"],"names":[],"mappings":";;;AACA,6DAAwD;AACxD,mEAA6D;AAEhD,QAAA,KAAK,GAAW,CAAC,IAAI,qCAAgB,EAAE,EAAE,IAAI,0CAAkB,EAAE,CAAC,CAAC"}

package/dist/tools/{content → a11y}/take-aria-snapshot.js

@@ -4,13 +4,18 @@ exports.TakeAriaSnapshot = void 0;
 const zod_1 = require("zod");
 class TakeAriaSnapshot {
     name() {
-        return 'content_take-aria-snapshot';
+        return 'a11y_take-aria-snapshot';
     }
     description() {
         return `
 Captures an ARIA (accessibility) snapshot of the current page or a specific element.
 If a selector is provided, the snapshot is scoped to that element; otherwise, the entire page is captured.
 The output includes the page URL, title, and a YAML-formatted accessibility tree.
+
+**UI Debugging Usage:**
+- Use in combination with "a11y_take-ax-tree-snapshot" tool for comprehensive UI analysis
+- Provides semantic structure and accessibility roles
+- Helps identify accessibility issues and page hierarchy problems
         `;
     }
     inputSchema() {

package/dist/tools/a11y/take-aria-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-aria-snapshot.js","sourceRoot":"","sources":["../../../src/tools/a11y/take-aria-snapshot.ts"],"names":[],"mappings":";;;AASA,6BAAwB;AAUxB,MAAa,gBAAgB;IACzB,IAAI;QACA,OAAO,yBAAyB,CAAC;IACrC,CAAC;IAED,WAAW;QACP,OAAO;;;;;;;;;SASN,CAAC;IACN,CAAC;IAED,WAAW;QACP,OAAO;YACH,QAAQ,EAAE,OAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CAAC,4CAA4C,CAAC;iBACtD,QAAQ,EAAE;SAClB,CAAC;IACN,CAAC;IAED,YAAY;QACR,OAAO;YACH,MAAM,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACL,wEAAwE,CAC3E;SACR,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CACR,OAA0B,EAC1B,IAAuB;QAEvB,MAAM,QAAQ,GAAW,MAAM,OAAO,CAAC,IAAI;aACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC;aAChC,YAAY,EAAE,CAAC;QACpB,MAAM,MAAM,GAAW;cACjB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBAChB,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE;;;EAGxC,QAAQ;;SAED,CAAC,IAAI,EAAE,CAAC;QACT,OAAO;YACH,MAAM;SACT,CAAC;IACN,CAAC;CACJ;AAxDD,4CAwDC"}