execbro 0.0.1-reserve → 1.10.13

package/build/core/componentTree.js

@@ -0,0 +1,275 @@
+import { executeInApp } from "./jsExecute.js";
+function formatTreeToTonl(node, indent = 0) {
+    const prefix = "  ".repeat(indent);
+    let result = `${prefix}${node.component}`;
+    // Add props inline if present
+    if (node.props && Object.keys(node.props).length > 0) {
+        const propsStr = Object.entries(node.props)
+            .map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`)
+            .join(",");
+        result += ` (${propsStr})`;
+    }
+    // Add layout inline if present
+    if (node.layout && Object.keys(node.layout).length > 0) {
+        const layoutStr = Object.entries(node.layout)
+            .map(([k, v]) => `${k}:${v}`)
+            .join(",");
+        result += ` [${layoutStr}]`;
+    }
+    result += "\n";
+    // Recurse children
+    if (node.children && node.children.length > 0) {
+        for (const child of node.children) {
+            result += formatTreeToTonl(child, indent + 1);
+        }
+    }
+    return result;
+}
+// Ultra-compact structure-only tree format (just component names, indented)
+function formatTreeStructureOnly(node, indent = 0) {
+    const prefix = "  ".repeat(indent);
+    let result = `${prefix}${node.component}\n`;
+    if (node.children && node.children.length > 0) {
+        for (const child of node.children) {
+            result += formatTreeStructureOnly(child, indent + 1);
+        }
+    }
+    return result;
+}
+export async function getComponentTree(options = {}) {
+    const { includeProps = false, includeStyles = false, hideInternals = true, format = "tonl", structureOnly = false, focusedOnly = false, device, timeoutMs } = options;
+    // Use lower default depth for structureOnly to keep output compact (~2-5KB)
+    // Full mode uses higher depth since TONL format handles it better
+    // focusedOnly mode uses moderate depth since we're already filtering to active screen
+    const maxDepth = options.maxDepth ?? 5000;
+    const expression = `
+        (function() {
+            const hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+            if (!hook) return { error: 'React DevTools hook not found. Make sure you are running a development build.' };
+
+            // Try to get fiber roots (renderer ID is usually 1)
+            let roots = [];
+            if (hook.getFiberRoots) {
+                roots = [...(hook.getFiberRoots(1) || [])];
+            }
+            if (roots.length === 0 && hook.renderers) {
+                // Try all renderers
+                for (const [id] of hook.renderers) {
+                    const r = hook.getFiberRoots ? [...(hook.getFiberRoots(id) || [])] : [];
+                    if (r.length > 0) {
+                        roots = r;
+                        break;
+                    }
+                }
+            }
+            if (roots.length === 0) return { error: 'No fiber roots found. The app may not have rendered yet.' };
+
+            const maxDepth = ${maxDepth};
+            const includeProps = ${includeProps};
+            const includeStyles = ${includeStyles};
+            const hideInternals = ${hideInternals};
+            const focusedOnly = ${focusedOnly};
+
+            // Internal RN components to hide
+            const internalPatterns = /^(RCT|RNS|Animated\\(|AnimatedComponent|VirtualizedList|CellRenderer|ScrollViewContext|PerformanceLoggerContext|RootTagContext|HeaderShownContext|HeaderHeightContext|HeaderBackContext|SafeAreaFrameContext|SafeAreaInsetsContext|VirtualizedListContext|VirtualizedListCellContextProvider|StaticContainer|DelayedFreeze|Freeze|Suspender|DebugContainer|MaybeNestedStack|SceneView|NavigationContent|PreventRemoveProvider|EnsureSingleNavigator)/;
+
+            // Screen component patterns - user's actual screens (strict matching)
+            // Only match *Screen and *Page to avoid false positives like BottomTabView
+            const screenPatterns = /^[A-Z][a-zA-Z0-9]*(Screen|Page)$/;
+
+            // Navigation/internal screen patterns to SKIP (these look like screens but are framework components)
+            const internalScreenPatterns = /^(MaybeScreen|Screen$|ScreenContainer|ScreenStack|SceneView|Background$)/;
+
+            // Provider/wrapper patterns to skip when finding focused screen
+            const wrapperPatterns = /^(App|AppContainer|Provider|Context|SafeArea|Gesture|Theme|Redux|Root|Navigator|Stack|Tab|Drawer|Navigation|Container|Wrapper|Layout|ErrorBoundary|Suspense|PersistGate|LinkingContext|AppState|View|Fragment|NativeStack|BottomTab|Screen$)/i;
+
+            // Global overlay patterns - stop traversing into these subtrees
+            // Be specific to avoid blocking BottomSheetDrawer, PortalProvider, etc.
+            const overlayPatterns = /^(BottomSheet$|BottomSheetGlobal|Modal$|Toast$|Snackbar$|Dialog$|Overlay$|Popup$|MyToast$|PaywallModal$|FullScreenBannerModal$)/i;
+
+            // Navigation container patterns - skip traversing into these (screens inside are nav screens, not focused content)
+            const navContainerPatterns = /^(RootNavigation|NativeStackNavigator|BottomTabNavigator|DrawerNavigator|TabNavigator|StackNavigator)/;
+
+            function getComponentName(fiber) {
+                if (!fiber || !fiber.type) return null;
+                if (typeof fiber.type === 'string') return fiber.type; // Host component (View, Text, etc.)
+                return fiber.type.displayName || fiber.type.name || null;
+            }
+
+            function shouldHide(name) {
+                if (!hideInternals || !name) return false;
+                return internalPatterns.test(name);
+            }
+
+            function extractLayoutStyles(style) {
+                try {
+                    if (!style) return null;
+                    const merged = Array.isArray(style)
+                        ? Object.assign({}, ...style.filter(Boolean).map(s => {
+                            try { return typeof s === 'object' ? s : {}; }
+                            catch { return {}; }
+                        }))
+                        : (typeof style === 'object' ? style : {});
+
+                    const layout = {};
+                    const layoutKeys = [
+                        'padding', 'paddingTop', 'paddingBottom', 'paddingLeft', 'paddingRight',
+                        'paddingHorizontal', 'paddingVertical',
+                        'margin', 'marginTop', 'marginBottom', 'marginLeft', 'marginRight',
+                        'marginHorizontal', 'marginVertical',
+                        'width', 'height', 'minWidth', 'minHeight', 'maxWidth', 'maxHeight',
+                        'flex', 'flexDirection', 'flexWrap', 'flexGrow', 'flexShrink',
+                        'justifyContent', 'alignItems', 'alignSelf', 'alignContent',
+                        'position', 'top', 'bottom', 'left', 'right',
+                        'gap', 'rowGap', 'columnGap',
+                        'borderWidth', 'borderTopWidth', 'borderBottomWidth', 'borderLeftWidth', 'borderRightWidth'
+                    ];
+
+                    for (const key of layoutKeys) {
+                        if (merged[key] !== undefined) layout[key] = merged[key];
+                    }
+                    return Object.keys(layout).length > 0 ? layout : null;
+                } catch { return null; }
+            }
+
+            function walkFiber(fiber, depth) {
+                if (!fiber || depth > maxDepth) return null;
+
+                const name = getComponentName(fiber);
+
+                // Skip anonymous/internal components unless they have meaningful children
+                if (!name || shouldHide(name)) {
+                    // Still traverse children
+                    let child = fiber.child;
+                    const children = [];
+                    while (child) {
+                        const childResult = walkFiber(child, depth);
+                        if (childResult) children.push(childResult);
+                        child = child.sibling;
+                    }
+                    // Return first meaningful child or null
+                    return children.length === 1 ? children[0] : (children.length > 1 ? { component: '(Fragment)', children } : null);
+                }
+
+                const node = { component: name };
+
+                // Include props if requested (excluding children and style for cleaner output)
+                if (includeProps && fiber.memoizedProps) {
+                    const props = {};
+                    for (const key of Object.keys(fiber.memoizedProps)) {
+                        if (key === 'children' || key === 'style') continue;
+                        try {
+                            const val = fiber.memoizedProps[key];
+                            if (typeof val === 'function') {
+                                props[key] = '[Function]';
+                            } else if (typeof val === 'object' && val !== null) {
+                                props[key] = Array.isArray(val) ? '[Array]' : '[Object]';
+                            } else {
+                                props[key] = val;
+                            }
+                        } catch {
+                            props[key] = '[Animated Value]';
+                        }
+                    }
+                    if (Object.keys(props).length > 0) node.props = props;
+                }
+
+                // Include layout styles if requested
+                try {
+                    if (includeStyles && fiber.memoizedProps?.style) {
+                        const layout = extractLayoutStyles(fiber.memoizedProps.style);
+                        if (layout) node.layout = layout;
+                    }
+                } catch { /* animated style — skip */ }
+
+                // Traverse children
+                let child = fiber.child;
+                const children = [];
+                while (child) {
+                    const childResult = walkFiber(child, depth + 1);
+                    if (childResult) children.push(childResult);
+                    child = child.sibling;
+                }
+                if (children.length > 0) node.children = children;
+
+                return node;
+            }
+
+            // Find focused screen if requested
+            function findFocusedScreen(fiber, depth = 0) {
+                if (!fiber || depth > 5000) return null;
+
+                const name = getComponentName(fiber);
+
+                // Skip overlays (BottomSheet, Modal, Toast, etc.) - don't traverse into them
+                if (name && overlayPatterns.test(name)) {
+                    return null;
+                }
+
+                // Skip navigation containers - screens inside are nav screens, not focused content
+                if (name && navContainerPatterns.test(name)) {
+                    return null;
+                }
+
+                // Check if this is a user's screen component (not framework internals)
+                if (name && screenPatterns.test(name) && !wrapperPatterns.test(name) && !internalScreenPatterns.test(name)) {
+                    return fiber;
+                }
+
+                // Search children
+                let child = fiber.child;
+                while (child) {
+                    const found = findFocusedScreen(child, depth + 1);
+                    if (found) return found;
+                    child = child.sibling;
+                }
+
+                return null;
+            }
+
+            let startFiber = roots[0].current;
+            let focusedScreenName = null;
+
+            if (focusedOnly) {
+                const focused = findFocusedScreen(roots[0].current);
+                if (focused) {
+                    startFiber = focused;
+                    focusedScreenName = getComponentName(focused);
+                }
+            }
+
+            const tree = walkFiber(startFiber, 0);
+
+            if (focusedOnly && focusedScreenName) {
+                return { focusedScreen: focusedScreenName, tree };
+            }
+            return { tree };
+        })()
+    `;
+    // Use a longer timeout for component tree traversal — large apps can exceed 10s
+    const result = await executeInApp(expression, false, { timeoutMs: timeoutMs ?? 30000, originatingToolName: "get_component_tree" }, device);
+    // Apply formatting if requested
+    if (result.success && result.result) {
+        try {
+            const parsed = JSON.parse(result.result);
+            if (parsed.tree) {
+                const prefix = parsed.focusedScreen ? `Focused: ${parsed.focusedScreen}\n\n` : "";
+                // Structure-only mode: ultra-compact format with just component names
+                if (structureOnly) {
+                    const structure = formatTreeStructureOnly(parsed.tree);
+                    return { success: true, result: prefix + structure };
+                }
+                // TONL format: compact with props/layout
+                if (format === "tonl") {
+                    const tonl = formatTreeToTonl(parsed.tree);
+                    return { success: true, result: prefix + tonl };
+                }
+            }
+        }
+        catch {
+            // If parsing fails, return original result
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=componentTree.js.map

package/build/core/componentTree.js.map

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

package/build/core/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolution order:
+ * 1. EXECBRO_API_URL env var (if set)
+ * 2. config.json apiUrl (if set)
+ * 3. --http flag → localhost:3000
+ * 4. Default → production URL
+ */
+export declare const API_BASE_URL: string;
+//# sourceMappingURL=config.d.ts.map

package/build/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AA0BA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,MAC8D,CAAC"}

package/build/core/config.js

@@ -0,0 +1,28 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { CONFIG_DIR } from "./paths.js";
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const IS_DEV = process.argv.includes("--http");
+const PRODUCTION_URL = "https://execbro.com";
+const LOCAL_URL = "http://localhost:3000";
+function loadConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return {};
+    try {
+        const raw = readFileSync(CONFIG_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+const config = loadConfig();
+/**
+ * Resolution order:
+ * 1. EXECBRO_API_URL env var (if set)
+ * 2. config.json apiUrl (if set)
+ * 3. --http flag → localhost:3000
+ * 4. Default → production URL
+ */
+export const API_BASE_URL = process.env.EXECBRO_API_URL ?? config.apiUrl ?? (IS_DEV ? LOCAL_URL : PRODUCTION_URL);
+//# sourceMappingURL=config.js.map

package/build/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAE/C,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAM1C,SAAS,UAAU;IACf,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GACrB,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC"}

package/build/core/connection.d.ts

@@ -0,0 +1,102 @@
+import WebSocket from "ws";
+import { DeviceInfo, RemoteObject, ConnectedApp, ConnectOptions, EnsureConnectionResult, ConnectionCheckResult } from "./types.js";
+/**
+ * Suppress auto-reconnection for all current connections.
+ * Used by disconnect_metro to prevent close handlers from re-connecting.
+ */
+export declare function suppressReconnection(): void;
+/**
+ * Suppress auto-reconnection for a specific connection key.
+ * Used by disconnect_metro with device targeting.
+ */
+export declare function suppressReconnectionForKey(appKey: string): void;
+/**
+ * Clear reconnection suppression (called when user explicitly reconnects via scan_metro).
+ */
+export declare function clearReconnectionSuppression(): void;
+/**
+ * Creates a WebSocket connection with Origin header fallback.
+ * RN 0.85+ Metro requires the Origin header, but Expo SDK 55 Bridgeless
+ * rejects connections that include one. The rejection can manifest as:
+ *   - Connection refused before open (error/close before open event)
+ *   - Immediate close after open (open fires, then close with code 1006)
+ * Tries with Origin first, falls back to without on quick failure.
+ */
+export declare function createWebSocketWithOriginFallback(url: string, timeoutMs?: number): Promise<WebSocket>;
+export declare function getWebSocketStateName(state: number): string;
+/**
+ * Purge stale connections for scanned ports.
+ * When Metro restarts with a different app, /json returns new device IDs.
+ * Old connections keyed by the previous device IDs remain in connectedApps.
+ * This function removes connections on scanned ports whose device IDs
+ * are no longer present in the fresh device list from Metro.
+ */
+export declare function purgeStaleConnectionsForPorts(freshDevicesByPort: Map<number, DeviceInfo[]>): string[];
+export declare function formatRemoteObject(result: RemoteObject): string;
+export declare function handleCDPMessage(message: Record<string, unknown>, device: DeviceInfo, ws?: WebSocket): void;
+export declare function connectToDevice(device: DeviceInfo, port: number, options?: ConnectOptions): Promise<string>;
+export declare function getConnectedApps(): Array<{
+    key: string;
+    app: ConnectedApp;
+    isConnected: boolean;
+}>;
+export declare function getFirstConnectedApp(): ConnectedApp | null;
+/**
+ * Find the connected RN app running on a specific iOS simulator (by UDID).
+ * Returns null if no connected app matches — caller should skip any CDP-based
+ * enrichment to avoid pulling data from a different simulator's app.
+ */
+export declare function getConnectedAppBySimulatorUdid(udid: string): ConnectedApp | null;
+/**
+ * Find the connected RN app running on a specific Android device.
+ * Falls back to the sole connected Android app when `deviceId` is not provided
+ * or cannot be resolved via deviceName substring match — this keeps the common
+ * single-device case working while preventing cross-device data leakage when
+ * multiple Android apps are connected.
+ */
+export declare function getConnectedAppByAndroidDeviceId(deviceId?: string): ConnectedApp | null;
+export declare function getConnectedAppByDevice(device?: string): ConnectedApp | null;
+export declare function hasConnectedApp(): boolean;
+/**
+ * Run a quick health check to verify the page context is responsive
+ * Returns true if the context can execute code, false otherwise
+ */
+export declare function runQuickHealthCheck(app: ConnectedApp): Promise<boolean>;
+export interface LogPipelineResult {
+    ok: boolean;
+    recovered: boolean;
+    message: string | null;
+}
+/**
+ * End-to-end log pipeline verification with automatic recovery.
+ *
+ * 1. Injects a sentinel console.log via CDP and verifies it appears in the buffer.
+ * 2. If the marker doesn't arrive, attempts recovery:
+ *    a. Re-sends Runtime.enable + Log.enable (fixes missing domain subscription)
+ *    b. Retries the marker once
+ * 3. If still broken, force-reconnects via ensureConnection and retries.
+ *
+ * Returns { ok, recovered, message } — the caller decides what to show.
+ */
+export declare function verifyLogPipeline(app: ConnectedApp): Promise<LogPipelineResult>;
+/**
+ * Check if a log message is a health check marker (for filtering from output).
+ */
+export declare function isHealthCheckMarker(message: string): boolean;
+/**
+ * Ensure a healthy connection to a React Native app
+ * This will verify or establish a connection, optionally running a health check
+ */
+export declare function ensureConnection(options?: {
+    port?: number;
+    healthCheck?: boolean;
+    forceRefresh?: boolean;
+}): Promise<EnsureConnectionResult>;
+export interface PassiveConnectionStatus {
+    connected: boolean;
+    needsPing: boolean;
+    reason: "ok" | "no_connection" | "context_stale" | "no_activity" | "activity_stale";
+}
+export declare function getPassiveConnectionStatus(targetAppKey?: string): PassiveConnectionStatus;
+export declare function checkAndEnsureConnection(device?: string): Promise<ConnectionCheckResult>;
+//# sourceMappingURL=connection.d.ts.map

package/build/core/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/core/connection.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAoB,YAAY,EAAkB,cAAc,EAAsB,sBAAsB,EAAmB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAkH1M;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAYD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA6DnG;AAaD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CACzC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,GAC9C,MAAM,EAAE,CAoCV;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA4B/D;AA2RD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAoW3G;AAGD,wBAAsB,eAAe,CACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAoTjB;AA8FD,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,YAAY,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC,CAMD;AAGD,wBAAgB,oBAAoB,IAAI,YAAY,GAAG,IAAI,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWhF;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAuBvF;AAYD,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAmD5E;AAGD,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CA4C7E;AAqCD,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsErF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAUD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmLvC;AAED,MAAM,WAAW,uBAAuB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;CACvF;AAED,wBAAgB,0BAA0B,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAmDzF;AAED,wBAAsB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgD9F"}