@metamask/client-mcp-core 0.1.0

package/dist/launcher/extension-id-resolver.cjs

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EXTENSION_ID_CONFIG = void 0;
+exports.resolveExtensionId = resolveExtensionId;
+/**
+ * Default configuration that matches "MetaMask" extension.
+ */
+exports.DEFAULT_EXTENSION_ID_CONFIG = {
+    extensionNamePattern: 'MetaMask',
+};
+/**
+ * Resolve the extension ID by checking service worker or chrome://extensions page.
+ *
+ * @param deps - Dependencies including browser context and logger
+ * @param config - Configuration for extension name pattern matching
+ * @returns The extension ID if found, undefined otherwise
+ */
+async function resolveExtensionId(deps, config = exports.DEFAULT_EXTENSION_ID_CONFIG) {
+    const { context, log } = deps;
+    const fromWorker = await getExtensionIdFromServiceWorker(context, log);
+    if (fromWorker) {
+        return fromWorker;
+    }
+    log.info('Service worker discovery failed, falling back to chrome://extensions');
+    return getExtensionIdFromExtensionsPage(context, log, config);
+}
+/**
+ * Extract the extension ID from a chrome-extension:// URL.
+ *
+ * @param url - The URL to extract the extension ID from
+ * @returns The 32-character extension ID if found, undefined otherwise
+ */
+function extractExtensionIdFromUrl(url) {
+    const match = url.match(/chrome-extension:\/\/([a-z]{32})\//u);
+    return match ? match[1] : undefined;
+}
+/**
+ * Attempt to resolve extension ID from existing or new service worker.
+ *
+ * @param context - The browser context to search for service workers
+ * @param log - Logger for debug information
+ * @returns The extension ID if found, undefined otherwise
+ */
+async function getExtensionIdFromServiceWorker(context, log) {
+    try {
+        const existingWorkers = context.serviceWorkers();
+        for (const worker of existingWorkers) {
+            const extensionId = extractExtensionIdFromUrl(worker.url());
+            if (extensionId) {
+                log.info(`Found extension ID from existing service worker: ${extensionId}`);
+                return extensionId;
+            }
+        }
+        const worker = await Promise.race([
+            context.waitForEvent('serviceworker', { timeout: 10000 }),
+            new Promise((resolve) => setTimeout(() => resolve(null), 10000)),
+        ]);
+        if (worker && typeof worker !== 'number') {
+            const extensionId = extractExtensionIdFromUrl(worker.url());
+            if (extensionId) {
+                log.info(`Found extension ID from new service worker: ${extensionId}`);
+                return extensionId;
+            }
+        }
+    }
+    catch (error) {
+        log.warn('Service worker extension ID discovery failed:', error);
+    }
+    return undefined;
+}
+/**
+ * Resolve extension ID by navigating to chrome://extensions and matching name pattern.
+ *
+ * @param context - The browser context to use for navigation
+ * @param log - Logger for debug information
+ * @param config - Configuration with extension name pattern to match
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @returns The extension ID if found, undefined otherwise
+ */
+async function getExtensionIdFromExtensionsPage(context, log, config, maxRetries = 3) {
+    const page = await ensurePage(context);
+    const { extensionNamePattern } = config;
+    const patternString = extensionNamePattern instanceof RegExp
+        ? extensionNamePattern.source
+        : extensionNamePattern;
+    const isRegex = extensionNamePattern instanceof RegExp;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            await page.goto('chrome://extensions');
+            await page.waitForLoadState('domcontentloaded');
+            await waitForExtensionsPageReady(page);
+            const extensionId = await page.evaluate(({ pattern, useRegex, }) => {
+                const extensionsManager = document.querySelector('extensions-manager');
+                if (!extensionsManager?.shadowRoot) {
+                    return undefined;
+                }
+                const itemList = extensionsManager.shadowRoot.querySelector('extensions-item-list');
+                if (!itemList?.shadowRoot) {
+                    return undefined;
+                }
+                const items = itemList.shadowRoot.querySelectorAll('extensions-item');
+                for (const item of Array.from(items)) {
+                    const nameEl = item.shadowRoot?.querySelector('#name');
+                    const name = nameEl?.textContent ?? '';
+                    const matches = useRegex
+                        ? new RegExp(pattern, 'u').test(name)
+                        : name.includes(pattern);
+                    if (matches) {
+                        return item.getAttribute('id') ?? undefined;
+                    }
+                }
+                return undefined;
+            }, { pattern: patternString, useRegex: isRegex });
+            if (extensionId) {
+                return extensionId;
+            }
+            if (attempt < maxRetries) {
+                log.warn(`Extension not found (attempt ${attempt}/${maxRetries}), retrying...`);
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+        }
+        catch (error) {
+            if (attempt < maxRetries) {
+                log.warn(`Error getting extension ID (attempt ${attempt}/${maxRetries}):`, error);
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+            else {
+                throw new Error(`Failed to get extension ID after ${maxRetries} attempts. ` +
+                    'Ensure the extension is built at the configured extension path.');
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Wait for the chrome://extensions page to fully load and render extensions.
+ *
+ * @param page - The page to wait for
+ * @param maxAttempts - Maximum number of polling attempts (default: 20)
+ */
+async function waitForExtensionsPageReady(page, maxAttempts = 20) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const isReady = await page.evaluate(() => {
+            const extensionsManager = document.querySelector('extensions-manager');
+            if (!extensionsManager?.shadowRoot) {
+                return false;
+            }
+            const itemList = extensionsManager.shadowRoot.querySelector('extensions-item-list');
+            if (!itemList?.shadowRoot) {
+                return false;
+            }
+            const items = itemList.shadowRoot.querySelectorAll('extensions-item');
+            return items.length > 0;
+        });
+        if (isReady) {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new Error(`chrome://extensions page did not load extensions within ${maxAttempts * 100}ms. ` +
+        'The shadow DOM structure was not fully populated. ' +
+        'This may indicate a Chrome version incompatibility or slow system.');
+}
+/**
+ * Get an existing page or create a new one for the browser context.
+ *
+ * @param context - The browser context to get or create a page for
+ * @returns An existing page or a newly created page
+ */
+async function ensurePage(context) {
+    const pages = context.pages();
+    if (pages[0]) {
+        return pages[0];
+    }
+    return context.newPage();
+}
+//# sourceMappingURL=extension-id-resolver.cjs.map

package/dist/launcher/extension-id-resolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-id-resolver.cjs","sourceRoot":"","sources":["../../src/launcher/extension-id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BrowserContext, Page } from '@playwright/test';\n\nexport type ExtensionIdResolverDeps = {\n  context: BrowserContext;\n  log: {\n    info: (message: string) => void;\n    warn: (message: string, error?: unknown) => void;\n  };\n};\n\n/**\n * Configuration for extension ID resolution.\n * Allows different extensions to specify their own identification criteria.\n */\nexport type ExtensionIdResolverConfig = {\n  /**\n   * Name pattern to match the extension in chrome://extensions page.\n   * Can be a string (partial match) or RegExp.\n   */\n  extensionNamePattern: string | RegExp;\n};\n\n/**\n * Default configuration that matches \"MetaMask\" extension.\n */\nexport const DEFAULT_EXTENSION_ID_CONFIG: ExtensionIdResolverConfig = {\n  extensionNamePattern: 'MetaMask',\n};\n\n/**\n * Resolve the extension ID by checking service worker or chrome://extensions page.\n *\n * @param deps - Dependencies including browser context and logger\n * @param config - Configuration for extension name pattern matching\n * @returns The extension ID if found, undefined otherwise\n */\nexport async function resolveExtensionId(\n  deps: ExtensionIdResolverDeps,\n  config: ExtensionIdResolverConfig = DEFAULT_EXTENSION_ID_CONFIG,\n): Promise<string | undefined> {\n  const { context, log } = deps;\n\n  const fromWorker = await getExtensionIdFromServiceWorker(context, log);\n  if (fromWorker) {\n    return fromWorker;\n  }\n\n  log.info(\n    'Service worker discovery failed, falling back to chrome://extensions',\n  );\n  return getExtensionIdFromExtensionsPage(context, log, config);\n}\n\n/**\n * Extract the extension ID from a chrome-extension:// URL.\n *\n * @param url - The URL to extract the extension ID from\n * @returns The 32-character extension ID if found, undefined otherwise\n */\nfunction extractExtensionIdFromUrl(url: string): string | undefined {\n  const match = url.match(/chrome-extension:\\/\\/([a-z]{32})\\//u);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Attempt to resolve extension ID from existing or new service worker.\n *\n * @param context - The browser context to search for service workers\n * @param log - Logger for debug information\n * @returns The extension ID if found, undefined otherwise\n */\nasync function getExtensionIdFromServiceWorker(\n  context: BrowserContext,\n  log: ExtensionIdResolverDeps['log'],\n): Promise<string | undefined> {\n  try {\n    const existingWorkers = context.serviceWorkers();\n    for (const worker of existingWorkers) {\n      const extensionId = extractExtensionIdFromUrl(worker.url());\n      if (extensionId) {\n        log.info(\n          `Found extension ID from existing service worker: ${extensionId}`,\n        );\n        return extensionId;\n      }\n    }\n\n    const worker = await Promise.race([\n      context.waitForEvent('serviceworker', { timeout: 10000 }),\n      new Promise<null>((resolve) => setTimeout(() => resolve(null), 10000)),\n    ]);\n\n    if (worker && typeof worker !== 'number') {\n      const extensionId = extractExtensionIdFromUrl(worker.url());\n      if (extensionId) {\n        log.info(`Found extension ID from new service worker: ${extensionId}`);\n        return extensionId;\n      }\n    }\n  } catch (error) {\n    log.warn('Service worker extension ID discovery failed:', error);\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve extension ID by navigating to chrome://extensions and matching name pattern.\n *\n * @param context - The browser context to use for navigation\n * @param log - Logger for debug information\n * @param config - Configuration with extension name pattern to match\n * @param maxRetries - Maximum number of retry attempts (default: 3)\n * @returns The extension ID if found, undefined otherwise\n */\nasync function getExtensionIdFromExtensionsPage(\n  context: BrowserContext,\n  log: ExtensionIdResolverDeps['log'],\n  config: ExtensionIdResolverConfig,\n  maxRetries = 3,\n): Promise<string | undefined> {\n  const page = await ensurePage(context);\n  const { extensionNamePattern } = config;\n\n  const patternString =\n    extensionNamePattern instanceof RegExp\n      ? extensionNamePattern.source\n      : extensionNamePattern;\n  const isRegex = extensionNamePattern instanceof RegExp;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      await page.goto('chrome://extensions');\n      await page.waitForLoadState('domcontentloaded');\n      await waitForExtensionsPageReady(page);\n\n      const extensionId = await page.evaluate(\n        ({\n          pattern,\n          useRegex,\n        }: {\n          /**\n           * The extension name pattern to match\n           */\n          pattern: string;\n          /**\n           * Whether the pattern should be treated as a regular expression\n           */\n          useRegex: boolean;\n        }) => {\n          const extensionsManager =\n            document.querySelector('extensions-manager');\n          if (!extensionsManager?.shadowRoot) {\n            return undefined;\n          }\n\n          const itemList = extensionsManager.shadowRoot.querySelector(\n            'extensions-item-list',\n          );\n          if (!itemList?.shadowRoot) {\n            return undefined;\n          }\n\n          const items = itemList.shadowRoot.querySelectorAll('extensions-item');\n\n          for (const item of Array.from(items)) {\n            const nameEl = item.shadowRoot?.querySelector('#name');\n            const name = nameEl?.textContent ?? '';\n\n            const matches = useRegex\n              ? new RegExp(pattern, 'u').test(name)\n              : name.includes(pattern);\n\n            if (matches) {\n              return item.getAttribute('id') ?? undefined;\n            }\n          }\n\n          return undefined;\n        },\n        { pattern: patternString, useRegex: isRegex },\n      );\n\n      if (extensionId) {\n        return extensionId;\n      }\n\n      if (attempt < maxRetries) {\n        log.warn(\n          `Extension not found (attempt ${attempt}/${maxRetries}), retrying...`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, 1000));\n      }\n    } catch (error) {\n      if (attempt < maxRetries) {\n        log.warn(\n          `Error getting extension ID (attempt ${attempt}/${maxRetries}):`,\n          error,\n        );\n        await new Promise((resolve) => setTimeout(resolve, 1000));\n      } else {\n        throw new Error(\n          `Failed to get extension ID after ${maxRetries} attempts. ` +\n            'Ensure the extension is built at the configured extension path.',\n        );\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Wait for the chrome://extensions page to fully load and render extensions.\n *\n * @param page - The page to wait for\n * @param maxAttempts - Maximum number of polling attempts (default: 20)\n */\nasync function waitForExtensionsPageReady(\n  page: Page,\n  maxAttempts = 20,\n): Promise<void> {\n  for (let i = 0; i < maxAttempts; i++) {\n    const isReady = await page.evaluate(() => {\n      const extensionsManager = document.querySelector('extensions-manager');\n      if (!extensionsManager?.shadowRoot) {\n        return false;\n      }\n\n      const itemList = extensionsManager.shadowRoot.querySelector(\n        'extensions-item-list',\n      );\n      if (!itemList?.shadowRoot) {\n        return false;\n      }\n\n      const items = itemList.shadowRoot.querySelectorAll('extensions-item');\n      return items.length > 0;\n    });\n\n    if (isReady) {\n      return;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 100));\n  }\n\n  throw new Error(\n    `chrome://extensions page did not load extensions within ${maxAttempts * 100}ms. ` +\n      'The shadow DOM structure was not fully populated. ' +\n      'This may indicate a Chrome version incompatibility or slow system.',\n  );\n}\n\n/**\n * Get an existing page or create a new one for the browser context.\n *\n * @param context - The browser context to get or create a page for\n * @returns An existing page or a newly created page\n */\nasync function ensurePage(context: BrowserContext): Promise<Page> {\n  const pages = context.pages();\n  if (pages[0]) {\n    return pages[0];\n  }\n\n  return context.newPage();\n}\n"]}

package/dist/launcher/extension-id-resolver.d.cts

@@ -0,0 +1,32 @@
+import type { BrowserContext } from "@playwright/test";
+export type ExtensionIdResolverDeps = {
+    context: BrowserContext;
+    log: {
+        info: (message: string) => void;
+        warn: (message: string, error?: unknown) => void;
+    };
+};
+/**
+ * Configuration for extension ID resolution.
+ * Allows different extensions to specify their own identification criteria.
+ */
+export type ExtensionIdResolverConfig = {
+    /**
+     * Name pattern to match the extension in chrome://extensions page.
+     * Can be a string (partial match) or RegExp.
+     */
+    extensionNamePattern: string | RegExp;
+};
+/**
+ * Default configuration that matches "MetaMask" extension.
+ */
+export declare const DEFAULT_EXTENSION_ID_CONFIG: ExtensionIdResolverConfig;
+/**
+ * Resolve the extension ID by checking service worker or chrome://extensions page.
+ *
+ * @param deps - Dependencies including browser context and logger
+ * @param config - Configuration for extension name pattern matching
+ * @returns The extension ID if found, undefined otherwise
+ */
+export declare function resolveExtensionId(deps: ExtensionIdResolverDeps, config?: ExtensionIdResolverConfig): Promise<string | undefined>;
+//# sourceMappingURL=extension-id-resolver.d.cts.map

package/dist/launcher/extension-id-resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-id-resolver.d.cts","sourceRoot":"","sources":["../../src/launcher/extension-id-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAQ,yBAAyB;AAE7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;KAClD,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAEzC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,GAAE,yBAAuD,GAC9D,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/dist/launcher/extension-id-resolver.d.mts

@@ -0,0 +1,32 @@
+import type { BrowserContext } from "@playwright/test";
+export type ExtensionIdResolverDeps = {
+    context: BrowserContext;
+    log: {
+        info: (message: string) => void;
+        warn: (message: string, error?: unknown) => void;
+    };
+};
+/**
+ * Configuration for extension ID resolution.
+ * Allows different extensions to specify their own identification criteria.
+ */
+export type ExtensionIdResolverConfig = {
+    /**
+     * Name pattern to match the extension in chrome://extensions page.
+     * Can be a string (partial match) or RegExp.
+     */
+    extensionNamePattern: string | RegExp;
+};
+/**
+ * Default configuration that matches "MetaMask" extension.
+ */
+export declare const DEFAULT_EXTENSION_ID_CONFIG: ExtensionIdResolverConfig;
+/**
+ * Resolve the extension ID by checking service worker or chrome://extensions page.
+ *
+ * @param deps - Dependencies including browser context and logger
+ * @param config - Configuration for extension name pattern matching
+ * @returns The extension ID if found, undefined otherwise
+ */
+export declare function resolveExtensionId(deps: ExtensionIdResolverDeps, config?: ExtensionIdResolverConfig): Promise<string | undefined>;
+//# sourceMappingURL=extension-id-resolver.d.mts.map

package/dist/launcher/extension-id-resolver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-id-resolver.d.mts","sourceRoot":"","sources":["../../src/launcher/extension-id-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAQ,yBAAyB;AAE7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;KAClD,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAEzC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,GAAE,yBAAuD,GAC9D,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/dist/launcher/extension-id-resolver.mjs

@@ -0,0 +1,173 @@
+/**
+ * Default configuration that matches "MetaMask" extension.
+ */
+export const DEFAULT_EXTENSION_ID_CONFIG = {
+    extensionNamePattern: 'MetaMask',
+};
+/**
+ * Resolve the extension ID by checking service worker or chrome://extensions page.
+ *
+ * @param deps - Dependencies including browser context and logger
+ * @param config - Configuration for extension name pattern matching
+ * @returns The extension ID if found, undefined otherwise
+ */
+export async function resolveExtensionId(deps, config = DEFAULT_EXTENSION_ID_CONFIG) {
+    const { context, log } = deps;
+    const fromWorker = await getExtensionIdFromServiceWorker(context, log);
+    if (fromWorker) {
+        return fromWorker;
+    }
+    log.info('Service worker discovery failed, falling back to chrome://extensions');
+    return getExtensionIdFromExtensionsPage(context, log, config);
+}
+/**
+ * Extract the extension ID from a chrome-extension:// URL.
+ *
+ * @param url - The URL to extract the extension ID from
+ * @returns The 32-character extension ID if found, undefined otherwise
+ */
+function extractExtensionIdFromUrl(url) {
+    const match = url.match(/chrome-extension:\/\/([a-z]{32})\//u);
+    return match ? match[1] : undefined;
+}
+/**
+ * Attempt to resolve extension ID from existing or new service worker.
+ *
+ * @param context - The browser context to search for service workers
+ * @param log - Logger for debug information
+ * @returns The extension ID if found, undefined otherwise
+ */
+async function getExtensionIdFromServiceWorker(context, log) {
+    try {
+        const existingWorkers = context.serviceWorkers();
+        for (const worker of existingWorkers) {
+            const extensionId = extractExtensionIdFromUrl(worker.url());
+            if (extensionId) {
+                log.info(`Found extension ID from existing service worker: ${extensionId}`);
+                return extensionId;
+            }
+        }
+        const worker = await Promise.race([
+            context.waitForEvent('serviceworker', { timeout: 10000 }),
+            new Promise((resolve) => setTimeout(() => resolve(null), 10000)),
+        ]);
+        if (worker && typeof worker !== 'number') {
+            const extensionId = extractExtensionIdFromUrl(worker.url());
+            if (extensionId) {
+                log.info(`Found extension ID from new service worker: ${extensionId}`);
+                return extensionId;
+            }
+        }
+    }
+    catch (error) {
+        log.warn('Service worker extension ID discovery failed:', error);
+    }
+    return undefined;
+}
+/**
+ * Resolve extension ID by navigating to chrome://extensions and matching name pattern.
+ *
+ * @param context - The browser context to use for navigation
+ * @param log - Logger for debug information
+ * @param config - Configuration with extension name pattern to match
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @returns The extension ID if found, undefined otherwise
+ */
+async function getExtensionIdFromExtensionsPage(context, log, config, maxRetries = 3) {
+    const page = await ensurePage(context);
+    const { extensionNamePattern } = config;
+    const patternString = extensionNamePattern instanceof RegExp
+        ? extensionNamePattern.source
+        : extensionNamePattern;
+    const isRegex = extensionNamePattern instanceof RegExp;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            await page.goto('chrome://extensions');
+            await page.waitForLoadState('domcontentloaded');
+            await waitForExtensionsPageReady(page);
+            const extensionId = await page.evaluate(({ pattern, useRegex, }) => {
+                const extensionsManager = document.querySelector('extensions-manager');
+                if (!extensionsManager?.shadowRoot) {
+                    return undefined;
+                }
+                const itemList = extensionsManager.shadowRoot.querySelector('extensions-item-list');
+                if (!itemList?.shadowRoot) {
+                    return undefined;
+                }
+                const items = itemList.shadowRoot.querySelectorAll('extensions-item');
+                for (const item of Array.from(items)) {
+                    const nameEl = item.shadowRoot?.querySelector('#name');
+                    const name = nameEl?.textContent ?? '';
+                    const matches = useRegex
+                        ? new RegExp(pattern, 'u').test(name)
+                        : name.includes(pattern);
+                    if (matches) {
+                        return item.getAttribute('id') ?? undefined;
+                    }
+                }
+                return undefined;
+            }, { pattern: patternString, useRegex: isRegex });
+            if (extensionId) {
+                return extensionId;
+            }
+            if (attempt < maxRetries) {
+                log.warn(`Extension not found (attempt ${attempt}/${maxRetries}), retrying...`);
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+        }
+        catch (error) {
+            if (attempt < maxRetries) {
+                log.warn(`Error getting extension ID (attempt ${attempt}/${maxRetries}):`, error);
+                await new Promise((resolve) => setTimeout(resolve, 1000));
+            }
+            else {
+                throw new Error(`Failed to get extension ID after ${maxRetries} attempts. ` +
+                    'Ensure the extension is built at the configured extension path.');
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Wait for the chrome://extensions page to fully load and render extensions.
+ *
+ * @param page - The page to wait for
+ * @param maxAttempts - Maximum number of polling attempts (default: 20)
+ */
+async function waitForExtensionsPageReady(page, maxAttempts = 20) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const isReady = await page.evaluate(() => {
+            const extensionsManager = document.querySelector('extensions-manager');
+            if (!extensionsManager?.shadowRoot) {
+                return false;
+            }
+            const itemList = extensionsManager.shadowRoot.querySelector('extensions-item-list');
+            if (!itemList?.shadowRoot) {
+                return false;
+            }
+            const items = itemList.shadowRoot.querySelectorAll('extensions-item');
+            return items.length > 0;
+        });
+        if (isReady) {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new Error(`chrome://extensions page did not load extensions within ${maxAttempts * 100}ms. ` +
+        'The shadow DOM structure was not fully populated. ' +
+        'This may indicate a Chrome version incompatibility or slow system.');
+}
+/**
+ * Get an existing page or create a new one for the browser context.
+ *
+ * @param context - The browser context to get or create a page for
+ * @returns An existing page or a newly created page
+ */
+async function ensurePage(context) {
+    const pages = context.pages();
+    if (pages[0]) {
+        return pages[0];
+    }
+    return context.newPage();
+}
+//# sourceMappingURL=extension-id-resolver.mjs.map

package/dist/launcher/extension-id-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-id-resolver.mjs","sourceRoot":"","sources":["../../src/launcher/extension-id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BrowserContext, Page } from '@playwright/test';\n\nexport type ExtensionIdResolverDeps = {\n  context: BrowserContext;\n  log: {\n    info: (message: string) => void;\n    warn: (message: string, error?: unknown) => void;\n  };\n};\n\n/**\n * Configuration for extension ID resolution.\n * Allows different extensions to specify their own identification criteria.\n */\nexport type ExtensionIdResolverConfig = {\n  /**\n   * Name pattern to match the extension in chrome://extensions page.\n   * Can be a string (partial match) or RegExp.\n   */\n  extensionNamePattern: string | RegExp;\n};\n\n/**\n * Default configuration that matches \"MetaMask\" extension.\n */\nexport const DEFAULT_EXTENSION_ID_CONFIG: ExtensionIdResolverConfig = {\n  extensionNamePattern: 'MetaMask',\n};\n\n/**\n * Resolve the extension ID by checking service worker or chrome://extensions page.\n *\n * @param deps - Dependencies including browser context and logger\n * @param config - Configuration for extension name pattern matching\n * @returns The extension ID if found, undefined otherwise\n */\nexport async function resolveExtensionId(\n  deps: ExtensionIdResolverDeps,\n  config: ExtensionIdResolverConfig = DEFAULT_EXTENSION_ID_CONFIG,\n): Promise<string | undefined> {\n  const { context, log } = deps;\n\n  const fromWorker = await getExtensionIdFromServiceWorker(context, log);\n  if (fromWorker) {\n    return fromWorker;\n  }\n\n  log.info(\n    'Service worker discovery failed, falling back to chrome://extensions',\n  );\n  return getExtensionIdFromExtensionsPage(context, log, config);\n}\n\n/**\n * Extract the extension ID from a chrome-extension:// URL.\n *\n * @param url - The URL to extract the extension ID from\n * @returns The 32-character extension ID if found, undefined otherwise\n */\nfunction extractExtensionIdFromUrl(url: string): string | undefined {\n  const match = url.match(/chrome-extension:\\/\\/([a-z]{32})\\//u);\n  return match ? match[1] : undefined;\n}\n\n/**\n * Attempt to resolve extension ID from existing or new service worker.\n *\n * @param context - The browser context to search for service workers\n * @param log - Logger for debug information\n * @returns The extension ID if found, undefined otherwise\n */\nasync function getExtensionIdFromServiceWorker(\n  context: BrowserContext,\n  log: ExtensionIdResolverDeps['log'],\n): Promise<string | undefined> {\n  try {\n    const existingWorkers = context.serviceWorkers();\n    for (const worker of existingWorkers) {\n      const extensionId = extractExtensionIdFromUrl(worker.url());\n      if (extensionId) {\n        log.info(\n          `Found extension ID from existing service worker: ${extensionId}`,\n        );\n        return extensionId;\n      }\n    }\n\n    const worker = await Promise.race([\n      context.waitForEvent('serviceworker', { timeout: 10000 }),\n      new Promise<null>((resolve) => setTimeout(() => resolve(null), 10000)),\n    ]);\n\n    if (worker && typeof worker !== 'number') {\n      const extensionId = extractExtensionIdFromUrl(worker.url());\n      if (extensionId) {\n        log.info(`Found extension ID from new service worker: ${extensionId}`);\n        return extensionId;\n      }\n    }\n  } catch (error) {\n    log.warn('Service worker extension ID discovery failed:', error);\n  }\n\n  return undefined;\n}\n\n/**\n * Resolve extension ID by navigating to chrome://extensions and matching name pattern.\n *\n * @param context - The browser context to use for navigation\n * @param log - Logger for debug information\n * @param config - Configuration with extension name pattern to match\n * @param maxRetries - Maximum number of retry attempts (default: 3)\n * @returns The extension ID if found, undefined otherwise\n */\nasync function getExtensionIdFromExtensionsPage(\n  context: BrowserContext,\n  log: ExtensionIdResolverDeps['log'],\n  config: ExtensionIdResolverConfig,\n  maxRetries = 3,\n): Promise<string | undefined> {\n  const page = await ensurePage(context);\n  const { extensionNamePattern } = config;\n\n  const patternString =\n    extensionNamePattern instanceof RegExp\n      ? extensionNamePattern.source\n      : extensionNamePattern;\n  const isRegex = extensionNamePattern instanceof RegExp;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      await page.goto('chrome://extensions');\n      await page.waitForLoadState('domcontentloaded');\n      await waitForExtensionsPageReady(page);\n\n      const extensionId = await page.evaluate(\n        ({\n          pattern,\n          useRegex,\n        }: {\n          /**\n           * The extension name pattern to match\n           */\n          pattern: string;\n          /**\n           * Whether the pattern should be treated as a regular expression\n           */\n          useRegex: boolean;\n        }) => {\n          const extensionsManager =\n            document.querySelector('extensions-manager');\n          if (!extensionsManager?.shadowRoot) {\n            return undefined;\n          }\n\n          const itemList = extensionsManager.shadowRoot.querySelector(\n            'extensions-item-list',\n          );\n          if (!itemList?.shadowRoot) {\n            return undefined;\n          }\n\n          const items = itemList.shadowRoot.querySelectorAll('extensions-item');\n\n          for (const item of Array.from(items)) {\n            const nameEl = item.shadowRoot?.querySelector('#name');\n            const name = nameEl?.textContent ?? '';\n\n            const matches = useRegex\n              ? new RegExp(pattern, 'u').test(name)\n              : name.includes(pattern);\n\n            if (matches) {\n              return item.getAttribute('id') ?? undefined;\n            }\n          }\n\n          return undefined;\n        },\n        { pattern: patternString, useRegex: isRegex },\n      );\n\n      if (extensionId) {\n        return extensionId;\n      }\n\n      if (attempt < maxRetries) {\n        log.warn(\n          `Extension not found (attempt ${attempt}/${maxRetries}), retrying...`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, 1000));\n      }\n    } catch (error) {\n      if (attempt < maxRetries) {\n        log.warn(\n          `Error getting extension ID (attempt ${attempt}/${maxRetries}):`,\n          error,\n        );\n        await new Promise((resolve) => setTimeout(resolve, 1000));\n      } else {\n        throw new Error(\n          `Failed to get extension ID after ${maxRetries} attempts. ` +\n            'Ensure the extension is built at the configured extension path.',\n        );\n      }\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Wait for the chrome://extensions page to fully load and render extensions.\n *\n * @param page - The page to wait for\n * @param maxAttempts - Maximum number of polling attempts (default: 20)\n */\nasync function waitForExtensionsPageReady(\n  page: Page,\n  maxAttempts = 20,\n): Promise<void> {\n  for (let i = 0; i < maxAttempts; i++) {\n    const isReady = await page.evaluate(() => {\n      const extensionsManager = document.querySelector('extensions-manager');\n      if (!extensionsManager?.shadowRoot) {\n        return false;\n      }\n\n      const itemList = extensionsManager.shadowRoot.querySelector(\n        'extensions-item-list',\n      );\n      if (!itemList?.shadowRoot) {\n        return false;\n      }\n\n      const items = itemList.shadowRoot.querySelectorAll('extensions-item');\n      return items.length > 0;\n    });\n\n    if (isReady) {\n      return;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 100));\n  }\n\n  throw new Error(\n    `chrome://extensions page did not load extensions within ${maxAttempts * 100}ms. ` +\n      'The shadow DOM structure was not fully populated. ' +\n      'This may indicate a Chrome version incompatibility or slow system.',\n  );\n}\n\n/**\n * Get an existing page or create a new one for the browser context.\n *\n * @param context - The browser context to get or create a page for\n * @returns An existing page or a newly created page\n */\nasync function ensurePage(context: BrowserContext): Promise<Page> {\n  const pages = context.pages();\n  if (pages[0]) {\n    return pages[0];\n  }\n\n  return context.newPage();\n}\n"]}

package/dist/launcher/extension-readiness.cjs

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EXTENSION_READINESS_CONFIG = void 0;
+exports.waitForExtensionUiReady = waitForExtensionUiReady;
+const path_1 = __importDefault(require("path"));
+/**
+ * Default MetaMask extension readiness configuration.
+ */
+exports.DEFAULT_EXTENSION_READINESS_CONFIG = {
+    readySelectors: [
+        '[data-testid="unlock-password"]',
+        '[data-testid="onboarding-create-wallet"]',
+        '[data-testid="onboarding-import-wallet"]',
+        '[data-testid="account-menu-icon"]',
+        '[data-testid="get-started"]',
+        '[data-testid="onboarding-terms-checkbox"]',
+        '[data-testid="onboarding-privacy-policy"]',
+    ],
+    expectedStatesDescription: 'unlock page, onboarding page, or home page',
+};
+/**
+ * Wait for the extension UI to be ready by checking for expected selectors.
+ *
+ * @param deps - Dependencies including page, screenshot directory, and logger
+ * @param config - Configuration with ready selectors to wait for
+ * @param timeout - Maximum time to wait in milliseconds (default: 30000)
+ */
+async function waitForExtensionUiReady(deps, config = exports.DEFAULT_EXTENSION_READINESS_CONFIG, timeout = 30000) {
+    const { page, screenshotDir, log } = deps;
+    const { readySelectors, expectedStatesDescription } = config;
+    try {
+        await Promise.race(readySelectors.map(async (selector) => page.waitForSelector(selector, { timeout })));
+        log.info('Extension UI is ready');
+    }
+    catch {
+        const currentUrl = page.url();
+        const screenshotPath = path_1.default.join(screenshotDir, `ui-ready-failure-${Date.now()}.png`);
+        await page.screenshot({ path: screenshotPath, fullPage: true });
+        log.error(`Debug screenshot saved: ${screenshotPath}`);
+        const expectedStates = expectedStatesDescription ?? 'one of the expected ready states';
+        throw new Error(`Extension UI did not reach expected state within ${timeout}ms. ` +
+            `Current URL: ${currentUrl}. ` +
+            `Expected: ${expectedStates}. ` +
+            `Debug screenshot saved to: ${screenshotPath}`);
+    }
+}
+//# sourceMappingURL=extension-readiness.cjs.map

package/dist/launcher/extension-readiness.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-readiness.cjs","sourceRoot":"","sources":["../../src/launcher/extension-readiness.ts"],"names":[],"mappings":";;;;;;AAmDA,0DAkCC;AApFD,gDAAwB;AA2BxB;;GAEG;AACU,QAAA,kCAAkC,GAA6B;IAC1E,cAAc,EAAE;QACd,iCAAiC;QACjC,0CAA0C;QAC1C,0CAA0C;QAC1C,mCAAmC;QACnC,6BAA6B;QAC7B,2CAA2C;QAC3C,2CAA2C;KAC5C;IACD,yBAAyB,EAAE,4CAA4C;CACxE,CAAC;AAEF;;;;;;GAMG;AACI,KAAK,UAAU,uBAAuB,CAC3C,IAA4B,EAC5B,SAAmC,0CAAkC,EACrE,OAAO,GAAG,KAAK;IAEf,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,EAAE,cAAc,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAChB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CACpC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAC5C,CACF,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,cAAI,CAAC,IAAI,CAC9B,aAAa,EACb,oBAAoB,IAAI,CAAC,GAAG,EAAE,MAAM,CACrC,CAAC;QACF,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,2BAA2B,cAAc,EAAE,CAAC,CAAC;QAEvD,MAAM,cAAc,GAClB,yBAAyB,IAAI,kCAAkC,CAAC;QAElE,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,MAAM;YAC/D,gBAAgB,UAAU,IAAI;YAC9B,aAAa,cAAc,IAAI;YAC/B,8BAA8B,cAAc,EAAE,CACjD,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { Page } from '@playwright/test';\nimport path from 'path';\n\nexport type ExtensionReadinessDeps = {\n  page: Page;\n  screenshotDir: string;\n  log: {\n    info: (message: string) => void;\n    error: (message: string) => void;\n  };\n};\n\n/**\n * Configuration for extension readiness detection.\n * Allows different extensions to specify their own UI ready selectors.\n */\nexport type ExtensionReadinessConfig = {\n  /**\n   * CSS selectors that indicate the extension UI is ready.\n   * The function waits for ANY of these selectors to appear.\n   */\n  readySelectors: string[];\n  /**\n   * Human-readable description of expected states for error messages.\n   */\n  expectedStatesDescription?: string;\n};\n\n/**\n * Default MetaMask extension readiness configuration.\n */\nexport const DEFAULT_EXTENSION_READINESS_CONFIG: ExtensionReadinessConfig = {\n  readySelectors: [\n    '[data-testid=\"unlock-password\"]',\n    '[data-testid=\"onboarding-create-wallet\"]',\n    '[data-testid=\"onboarding-import-wallet\"]',\n    '[data-testid=\"account-menu-icon\"]',\n    '[data-testid=\"get-started\"]',\n    '[data-testid=\"onboarding-terms-checkbox\"]',\n    '[data-testid=\"onboarding-privacy-policy\"]',\n  ],\n  expectedStatesDescription: 'unlock page, onboarding page, or home page',\n};\n\n/**\n * Wait for the extension UI to be ready by checking for expected selectors.\n *\n * @param deps - Dependencies including page, screenshot directory, and logger\n * @param config - Configuration with ready selectors to wait for\n * @param timeout - Maximum time to wait in milliseconds (default: 30000)\n */\nexport async function waitForExtensionUiReady(\n  deps: ExtensionReadinessDeps,\n  config: ExtensionReadinessConfig = DEFAULT_EXTENSION_READINESS_CONFIG,\n  timeout = 30000,\n): Promise<void> {\n  const { page, screenshotDir, log } = deps;\n  const { readySelectors, expectedStatesDescription } = config;\n\n  try {\n    await Promise.race(\n      readySelectors.map(async (selector) =>\n        page.waitForSelector(selector, { timeout }),\n      ),\n    );\n    log.info('Extension UI is ready');\n  } catch {\n    const currentUrl = page.url();\n    const screenshotPath = path.join(\n      screenshotDir,\n      `ui-ready-failure-${Date.now()}.png`,\n    );\n    await page.screenshot({ path: screenshotPath, fullPage: true });\n    log.error(`Debug screenshot saved: ${screenshotPath}`);\n\n    const expectedStates =\n      expectedStatesDescription ?? 'one of the expected ready states';\n\n    throw new Error(\n      `Extension UI did not reach expected state within ${timeout}ms. ` +\n        `Current URL: ${currentUrl}. ` +\n        `Expected: ${expectedStates}. ` +\n        `Debug screenshot saved to: ${screenshotPath}`,\n    );\n  }\n}\n"]}

package/dist/launcher/extension-readiness.d.cts

@@ -0,0 +1,37 @@
+import type { Page } from "@playwright/test";
+export type ExtensionReadinessDeps = {
+    page: Page;
+    screenshotDir: string;
+    log: {
+        info: (message: string) => void;
+        error: (message: string) => void;
+    };
+};
+/**
+ * Configuration for extension readiness detection.
+ * Allows different extensions to specify their own UI ready selectors.
+ */
+export type ExtensionReadinessConfig = {
+    /**
+     * CSS selectors that indicate the extension UI is ready.
+     * The function waits for ANY of these selectors to appear.
+     */
+    readySelectors: string[];
+    /**
+     * Human-readable description of expected states for error messages.
+     */
+    expectedStatesDescription?: string;
+};
+/**
+ * Default MetaMask extension readiness configuration.
+ */
+export declare const DEFAULT_EXTENSION_READINESS_CONFIG: ExtensionReadinessConfig;
+/**
+ * Wait for the extension UI to be ready by checking for expected selectors.
+ *
+ * @param deps - Dependencies including page, screenshot directory, and logger
+ * @param config - Configuration with ready selectors to wait for
+ * @param timeout - Maximum time to wait in milliseconds (default: 30000)
+ */
+export declare function waitForExtensionUiReady(deps: ExtensionReadinessDeps, config?: ExtensionReadinessConfig, timeout?: number): Promise<void>;
+//# sourceMappingURL=extension-readiness.d.cts.map

package/dist/launcher/extension-readiness.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-readiness.d.cts","sourceRoot":"","sources":["../../src/launcher/extension-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,yBAAyB;AAG7C,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,wBAWhD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,MAAM,GAAE,wBAA6D,EACrE,OAAO,SAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/launcher/extension-readiness.d.mts

@@ -0,0 +1,37 @@
+import type { Page } from "@playwright/test";
+export type ExtensionReadinessDeps = {
+    page: Page;
+    screenshotDir: string;
+    log: {
+        info: (message: string) => void;
+        error: (message: string) => void;
+    };
+};
+/**
+ * Configuration for extension readiness detection.
+ * Allows different extensions to specify their own UI ready selectors.
+ */
+export type ExtensionReadinessConfig = {
+    /**
+     * CSS selectors that indicate the extension UI is ready.
+     * The function waits for ANY of these selectors to appear.
+     */
+    readySelectors: string[];
+    /**
+     * Human-readable description of expected states for error messages.
+     */
+    expectedStatesDescription?: string;
+};
+/**
+ * Default MetaMask extension readiness configuration.
+ */
+export declare const DEFAULT_EXTENSION_READINESS_CONFIG: ExtensionReadinessConfig;
+/**
+ * Wait for the extension UI to be ready by checking for expected selectors.
+ *
+ * @param deps - Dependencies including page, screenshot directory, and logger
+ * @param config - Configuration with ready selectors to wait for
+ * @param timeout - Maximum time to wait in milliseconds (default: 30000)
+ */
+export declare function waitForExtensionUiReady(deps: ExtensionReadinessDeps, config?: ExtensionReadinessConfig, timeout?: number): Promise<void>;
+//# sourceMappingURL=extension-readiness.d.mts.map

package/dist/launcher/extension-readiness.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-readiness.d.mts","sourceRoot":"","sources":["../../src/launcher/extension-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,yBAAyB;AAG7C,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC,EAAE,wBAWhD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,sBAAsB,EAC5B,MAAM,GAAE,wBAA6D,EACrE,OAAO,SAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CA8Bf"}