@metamask-previews/messenger-cli 0.0.0-preview-4a2a8e8f6 → 0.1.0-preview-e19d3725e

package/dist/docs/extraction.cjs

@@ -0,0 +1,569 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFromFile = void 0;
+const node_1 = require("@metamask/utils/node");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const typescript_1 = require("typescript");
+/**
+ * Extract string constants from top-level variable declarations in a source file.
+ * Only looks at top-level `const x = 'string'` or `const x = 'string' as const`.
+ *
+ * @param sourceFile - The TypeScript source file to extract constants from.
+ * @returns A map of constant name to string value.
+ */
+function extractStringConstants(sourceFile) {
+    const names = new Map();
+    for (const statement of sourceFile.statements) {
+        if (!(0, typescript_1.isVariableStatement)(statement)) {
+            continue;
+        }
+        for (const decl of statement.declarationList.declarations) {
+            if (!(0, typescript_1.isIdentifier)(decl.name)) {
+                continue;
+            }
+            if (decl.initializer) {
+                const init = decl.initializer;
+                if ((0, typescript_1.isStringLiteral)(init)) {
+                    names.set(decl.name.text, init.text);
+                }
+                else if ((0, typescript_1.isAsExpression)(init) && (0, typescript_1.isStringLiteral)(init.expression)) {
+                    names.set(decl.name.text, init.expression.text);
+                }
+            }
+            // Handle `declare const x: "value"` (common in .d.cts files)
+            if (!decl.initializer &&
+                decl.type &&
+                (0, typescript_1.isLiteralTypeNode)(decl.type) &&
+                (0, typescript_1.isStringLiteral)(decl.type.literal)) {
+                names.set(decl.name.text, decl.type.literal.text);
+            }
+        }
+    }
+    return names;
+}
+/**
+ * Resolve the value of `controllerName` (or similar constant) defined in the
+ * same file or imported from a local `./constants*` module (single-hop only).
+ *
+ * @param sourceFile - The TypeScript source file to search.
+ * @param filePath - The absolute path of the source file on disk.
+ * @returns A promise that resolves to a map of constant name to resolved string value.
+ */
+async function resolveControllerName(sourceFile, filePath) {
+    const names = extractStringConstants(sourceFile);
+    // Chase single-hop local imports (no further recursion):
+    //   import { BRIDGE_CONTROLLER_NAME } from './constants/bridge';
+    for (const statement of sourceFile.statements) {
+        if (!(0, typescript_1.isImportDeclaration)(statement) ||
+            !statement.moduleSpecifier ||
+            !(0, typescript_1.isStringLiteral)(statement.moduleSpecifier)) {
+            continue;
+        }
+        const spec = statement.moduleSpecifier.text;
+        if (!spec.startsWith('.')) {
+            continue;
+        }
+        const dir = path.dirname(filePath);
+        const isDts = filePath.endsWith('.d.cts') || filePath.endsWith('.d.ts');
+        // Strip .cjs/.js extension from specifier for .d.cts resolution
+        const bareSpec = spec.replace(/\.(c|m)?js$/u, '');
+        const candidates = isDts
+            ? [
+                path.join(dir, `${bareSpec}.d.cts`),
+                path.join(dir, bareSpec, 'index.d.cts'),
+                path.join(dir, `${bareSpec}.d.ts`),
+                path.join(dir, bareSpec, 'index.d.ts'),
+            ]
+            : [path.join(dir, `${spec}.ts`), path.join(dir, spec, 'index.ts')];
+        for (const candidate of candidates) {
+            if (!(await (0, node_1.fileExists)(candidate))) {
+                continue;
+            }
+            const content = await fs.readFile(candidate, 'utf8');
+            const sf = (0, typescript_1.createSourceFile)(candidate, content, typescript_1.ScriptTarget.Latest, true);
+            // Only extract constants — do NOT follow further imports
+            const imported = extractStringConstants(sf);
+            if (statement.importClause?.namedBindings &&
+                (0, typescript_1.isNamedImports)(statement.importClause.namedBindings)) {
+                for (const element of statement.importClause.namedBindings.elements) {
+                    const importedName = (element.propertyName ?? element.name).text;
+                    const localName = element.name.text;
+                    const value = imported.get(importedName);
+                    if (value !== undefined) {
+                        names.set(localName, value);
+                    }
+                }
+            }
+            break;
+        }
+    }
+    return names;
+}
+/**
+ * Resolve a template-literal or string-literal `type` property to its string
+ * value. Returns null if unresolvable.
+ *
+ * @param node - The expression node to resolve.
+ * @param constants - A map of known constant names to their string values.
+ * @returns The resolved string value, or null if unresolvable.
+ */
+function resolveTypeString(node, constants) {
+    if ((0, typescript_1.isStringLiteral)(node) || (0, typescript_1.isNoSubstitutionTemplateLiteral)(node)) {
+        return node.text;
+    }
+    if ((0, typescript_1.isTemplateExpression)(node)) {
+        let result = node.head.text;
+        for (const span of node.templateSpans) {
+            // typeof X  →  resolve X
+            if ((0, typescript_1.isTypeOfExpression)(span.expression)) {
+                if ((0, typescript_1.isIdentifier)(span.expression.expression)) {
+                    const val = constants.get(span.expression.expression.text);
+                    if (val === undefined) {
+                        return null;
+                    }
+                    result += val;
+                }
+                else {
+                    return null;
+                }
+            }
+            else if ((0, typescript_1.isIdentifier)(span.expression)) {
+                const val = constants.get(span.expression.text);
+                if (val === undefined) {
+                    return null;
+                }
+                result += val;
+            }
+            else {
+                return null;
+            }
+            result += span.literal.text;
+        }
+        return result;
+    }
+    return null;
+}
+/**
+ * Resolve a TemplateLiteralTypeNode (used in type positions like
+ * `type: \`${typeof controllerName}:name\``) to its string value.
+ *
+ * @param node - The template literal type node to resolve.
+ * @param constants - A map of known constant names to their string values.
+ * @returns The resolved string value, or null if unresolvable.
+ */
+function resolveTemplateLiteralType(node, constants) {
+    let result = node.head.text;
+    for (const span of node.templateSpans) {
+        // In type position, `typeof X` is a TypeQueryNode
+        if ((0, typescript_1.isTypeQueryNode)(span.type) && (0, typescript_1.isIdentifier)(span.type.exprName)) {
+            const val = constants.get(span.type.exprName.text);
+            if (val === undefined) {
+                return null;
+            }
+            result += val;
+        }
+        else if ((0, typescript_1.isLiteralTypeNode)(span.type) &&
+            (0, typescript_1.isStringLiteral)(span.type.literal)) {
+            result += span.type.literal.text;
+        }
+        else {
+            return null;
+        }
+        result += span.literal.text;
+    }
+    return result;
+}
+/**
+ * Extract cleaned JSDoc body text from a node.
+ *
+ * @param node - The AST node to extract JSDoc from.
+ * @param sourceFile - The source file containing the node.
+ * @returns The cleaned JSDoc text, or empty string if none.
+ */
+function extractJsDocText(node, sourceFile) {
+    const jsDocs = (0, typescript_1.getJSDocCommentsAndTags)(node);
+    if (jsDocs.length === 0) {
+        return '';
+    }
+    const jsDoc = jsDocs[0];
+    if (!(0, typescript_1.isJSDoc)(jsDoc)) {
+        return '';
+    }
+    const fullText = sourceFile.getFullText();
+    const raw = fullText.substring(jsDoc.getFullStart(), jsDoc.getEnd()).trim();
+    // Handle single-line JSDoc: /** Gets the current state. */
+    const singleLineMatch = raw.match(/^\/\*\*\s*(.*?)\s*\*\/$/u);
+    if (singleLineMatch) {
+        const text = singleLineMatch[1].replace(/^\*\s*/u, '');
+        return text || '';
+    }
+    // Strip comment delimiters, leading asterisks, and @param/@returns/@see tags
+    const lines = raw.split('\n');
+    const cleaned = [];
+    const skippedTags = [
+        '@param',
+        '@returns',
+        '@see',
+        '@throws',
+        '@template',
+        '@example',
+    ];
+    let currentTag = null;
+    let deprecatedParts = [];
+    for (const rawLine of lines) {
+        let trimmed = rawLine.trim();
+        if (trimmed === '/**' || trimmed === '*/') {
+            continue;
+        }
+        if (trimmed.startsWith('* ')) {
+            trimmed = trimmed.slice(2);
+        }
+        else if (trimmed === '*') {
+            trimmed = '';
+        }
+        else if (trimmed.startsWith('*')) {
+            trimmed = trimmed.slice(1);
+        }
+        // Check if this line starts a new tag
+        if (trimmed.startsWith('@')) {
+            // Flush any accumulated deprecated text
+            if (currentTag === 'deprecated' && deprecatedParts.length > 0) {
+                cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);
+                deprecatedParts = [];
+            }
+            if (trimmed.startsWith('@deprecated')) {
+                currentTag = 'deprecated';
+                const depText = trimmed.slice('@deprecated'.length).trim();
+                if (depText) {
+                    deprecatedParts.push(depText);
+                }
+                continue;
+            }
+            currentTag = skippedTags.some((tag) => trimmed.startsWith(tag))
+                ? 'skip'
+                : null;
+            if (currentTag === 'skip') {
+                continue;
+            }
+        }
+        else if (currentTag === 'skip') {
+            if (trimmed === '') {
+                currentTag = null;
+            }
+            else {
+                continue;
+            }
+        }
+        else if (currentTag === 'deprecated') {
+            if (trimmed === '') {
+                // End of deprecated tag
+                if (deprecatedParts.length > 0) {
+                    cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);
+                    deprecatedParts = [];
+                }
+                currentTag = null;
+            }
+            else {
+                deprecatedParts.push(trimmed);
+                continue;
+            }
+        }
+        cleaned.push(trimmed);
+    }
+    // Flush any remaining deprecated text
+    if (deprecatedParts.length > 0) {
+        cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);
+    }
+    let result = cleaned.join('\n').trim();
+    // Convert JSDoc {@link X} references to markdown backtick code
+    result = result.replace(/\{@link\s+([^}]+)\}/gu, '`$1`');
+    // Escape remaining curly braces for MDX safety (but not inside backtick code spans)
+    result = result.replace(/`[^`]*`|(\{)|(\})/gu, (match, open, close) => {
+        if (open) {
+            return '\\{';
+        }
+        if (close) {
+            return '\\}';
+        }
+        return match; // preserve content inside backticks
+    });
+    return result;
+}
+/**
+ * Check whether a node has an `@deprecated` JSDoc tag.
+ *
+ * @param node - The AST node to check.
+ * @returns True if the node has an `@deprecated` tag.
+ */
+function isDeprecated(node) {
+    const tags = (0, typescript_1.getJSDocTags)(node);
+    return tags.some((tag) => tag.tagName.text === 'deprecated');
+}
+/**
+ * Collect method info from all class declarations in a source file.
+ * Returns a map keyed by "ClassName.methodName".
+ *
+ * @param sourceFile - The TypeScript source file to scan.
+ * @returns A map of "ClassName.methodName" to method info.
+ */
+function collectClassMethods(sourceFile) {
+    const methods = new Map();
+    for (const statement of sourceFile.statements) {
+        if (!(0, typescript_1.isClassDeclaration)(statement) || !statement.name) {
+            continue;
+        }
+        const className = statement.name.text;
+        for (const member of statement.members) {
+            if (!(0, typescript_1.isMethodDeclaration)(member) ||
+                !member.name ||
+                !(0, typescript_1.isIdentifier)(member.name)) {
+                continue;
+            }
+            const methodName = member.name.text;
+            // Build parameter list
+            const params = member.parameters
+                .map((param) => {
+                const paramName = param.name.getText(sourceFile);
+                const optional = param.questionToken ? '?' : '';
+                const paramType = param.type
+                    ? param.type.getText(sourceFile)
+                    : 'unknown';
+                return `${paramName}${optional}: ${paramType}`;
+            })
+                .join(', ');
+            // Get return type
+            const returnType = member.type ? member.type.getText(sourceFile) : 'void';
+            // For async methods, the declared return type already includes Promise<>,
+            // so we don't need to wrap again.
+            const methodSignature = `(${params}) => ${returnType}`;
+            const jsDoc = extractJsDocText(member, sourceFile);
+            methods.set(`${className}.${methodName}`, {
+                jsDoc,
+                signature: methodSignature,
+            });
+        }
+    }
+    return methods;
+}
+/**
+ * If `handlerText` matches `ClassName['methodName']`, look it up in classMethodInfo
+ * and return the resolved signature. Otherwise return the original text.
+ *
+ * @param handlerText - The raw handler text to resolve.
+ * @param classMethods - A map of class methods collected from the source file.
+ * @returns An object with the resolved signature and any associated JSDoc.
+ */
+function resolveHandler(handlerText, classMethods) {
+    const match = handlerText.match(/^(\w+)\['(\w+)'\]$/u);
+    if (match) {
+        const key = `${match[1]}.${match[2]}`;
+        const info = classMethods.get(key);
+        if (info) {
+            return { signature: info.signature, methodJsDoc: info.jsDoc };
+        }
+    }
+    return { signature: handlerText, methodJsDoc: '' };
+}
+/**
+ * Get the raw source text for a property value inside a type literal.
+ *
+ * @param members - The type literal members to search.
+ * @param propName - The property name to find.
+ * @param sourceFile - The source file for getText calls.
+ * @returns The raw text of the property type, or empty string if not found.
+ */
+function getPropertyText(members, propName, sourceFile) {
+    for (const member of members) {
+        if ((0, typescript_1.isPropertySignature)(member) &&
+            member.name &&
+            (0, typescript_1.isIdentifier)(member.name) &&
+            member.name.text === propName &&
+            member.type) {
+            return member.type.getText(sourceFile).trim();
+        }
+    }
+    return '';
+}
+// ---------------------------------------------------------------------------
+// Main extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract messenger action/event type definitions from a single TypeScript file.
+ *
+ * @param filePath - The absolute path to the TypeScript file.
+ * @param relBase - Base path for computing relative source paths.
+ * @returns A promise that resolves to an array of extracted messenger item docs.
+ */
+async function extractFromFile(filePath, relBase) {
+    const content = await fs.readFile(filePath, 'utf8');
+    const sourceFile = (0, typescript_1.createSourceFile)(filePath, content, typescript_1.ScriptTarget.Latest, true);
+    const constants = await resolveControllerName(sourceFile, filePath);
+    const classMethods = collectClassMethods(sourceFile);
+    const items = [];
+    const relPath = path.relative(relBase, filePath);
+    // Type aliases and interfaces are always top-level statements
+    for (const statement of sourceFile.statements) {
+        // ---------------------------------------------------------------
+        // Pattern 1: { type: '...'; handler/payload: ... }
+        // Matches both:
+        //   type X = { type: '...'; handler: ... }   (type alias with literal body)
+        //   interface X { type: '...'; handler: ... } (interface declaration)
+        // ---------------------------------------------------------------
+        let inlineNode;
+        let inlineMembers;
+        if ((0, typescript_1.isTypeAliasDeclaration)(statement) &&
+            (0, typescript_1.isTypeLiteralNode)(statement.type)) {
+            inlineNode = statement;
+            inlineMembers = statement.type.members;
+        }
+        else if ((0, typescript_1.isInterfaceDeclaration)(statement)) {
+            inlineNode = statement;
+            inlineMembers = statement.members;
+        }
+        if (inlineNode && inlineMembers) {
+            const typeName = inlineNode.name.text;
+            const line = sourceFile.getLineAndCharacterOfPosition(inlineNode.getStart()).line +
+                1;
+            // Find `type` property
+            let typeString = null;
+            for (const member of inlineMembers) {
+                if ((0, typescript_1.isPropertySignature)(member) &&
+                    member.name &&
+                    (0, typescript_1.isIdentifier)(member.name) &&
+                    member.name.text === 'type' &&
+                    member.type) {
+                    if ((0, typescript_1.isLiteralTypeNode)(member.type)) {
+                        typeString = resolveTypeString(member.type.literal, constants);
+                    }
+                    else if ((0, typescript_1.isTemplateLiteralTypeNode)(member.type)) {
+                        typeString = resolveTemplateLiteralType(member.type, constants);
+                    }
+                }
+            }
+            if (typeString?.includes(':')) {
+                const handlerText = getPropertyText(inlineMembers, 'handler', sourceFile);
+                const payloadText = getPropertyText(inlineMembers, 'payload', sourceFile);
+                if (handlerText || payloadText) {
+                    const kind = handlerText ? 'action' : 'event';
+                    // For actions, resolve ClassName['methodName'] to actual signature + JSDoc
+                    let resolvedHandler = handlerText || payloadText;
+                    let typeAliasJsDoc = extractJsDocText(inlineNode, sourceFile);
+                    if (handlerText) {
+                        const resolved = resolveHandler(handlerText, classMethods);
+                        resolvedHandler = resolved.signature;
+                        // If the type alias has no JSDoc, use the method's JSDoc
+                        if (!typeAliasJsDoc && resolved.methodJsDoc) {
+                            typeAliasJsDoc = resolved.methodJsDoc;
+                        }
+                    }
+                    items.push({
+                        typeName,
+                        typeString,
+                        kind,
+                        jsDoc: typeAliasJsDoc,
+                        handlerOrPayload: resolvedHandler,
+                        sourceFile: relPath,
+                        line,
+                        deprecated: isDeprecated(inlineNode),
+                    });
+                }
+            }
+        }
+        // -------------------------------------------------------------------
+        // Patterns 2 & 3 only apply to type aliases (generic type references)
+        // -------------------------------------------------------------------
+        if (!(0, typescript_1.isTypeAliasDeclaration)(statement)) {
+            continue;
+        }
+        const node = statement;
+        const typeName = node.name.text;
+        const line = sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;
+        // -------------------------------------------------------------------
+        // Pattern 2: ControllerGetStateAction<typeof cn, State>
+        // -------------------------------------------------------------------
+        if ((0, typescript_1.isTypeReferenceNode)(node.type) &&
+            (0, typescript_1.isIdentifier)(node.type.typeName) &&
+            node.type.typeName.text === 'ControllerGetStateAction' &&
+            node.type.typeArguments &&
+            node.type.typeArguments.length >= 2) {
+            const firstArg = node.type.typeArguments[0];
+            const stateArg = node.type.typeArguments[1];
+            let namespace = null;
+            if ((0, typescript_1.isTypeQueryNode)(firstArg) && (0, typescript_1.isIdentifier)(firstArg.exprName)) {
+                namespace = constants.get(firstArg.exprName.text) ?? null;
+            }
+            if ((0, typescript_1.isLiteralTypeNode)(firstArg) && (0, typescript_1.isStringLiteral)(firstArg.literal)) {
+                namespace = firstArg.literal.text;
+            }
+            if (namespace) {
+                items.push({
+                    typeName,
+                    typeString: `${namespace}:getState`,
+                    kind: 'action',
+                    jsDoc: extractJsDocText(node, sourceFile),
+                    handlerOrPayload: `() => ${stateArg.getText(sourceFile)}`,
+                    sourceFile: relPath,
+                    line,
+                    deprecated: isDeprecated(node),
+                });
+            }
+        }
+        // -------------------------------------------------------------------
+        // Pattern 3: ControllerStateChangeEvent<typeof cn, State>
+        // -------------------------------------------------------------------
+        if ((0, typescript_1.isTypeReferenceNode)(node.type) &&
+            (0, typescript_1.isIdentifier)(node.type.typeName) &&
+            node.type.typeName.text === 'ControllerStateChangeEvent' &&
+            node.type.typeArguments &&
+            node.type.typeArguments.length >= 2) {
+            const firstArg = node.type.typeArguments[0];
+            const stateArg = node.type.typeArguments[1];
+            let namespace = null;
+            if ((0, typescript_1.isTypeQueryNode)(firstArg) && (0, typescript_1.isIdentifier)(firstArg.exprName)) {
+                namespace = constants.get(firstArg.exprName.text) ?? null;
+            }
+            if ((0, typescript_1.isLiteralTypeNode)(firstArg) && (0, typescript_1.isStringLiteral)(firstArg.literal)) {
+                namespace = firstArg.literal.text;
+            }
+            if (namespace) {
+                items.push({
+                    typeName,
+                    typeString: `${namespace}:stateChange`,
+                    kind: 'event',
+                    jsDoc: extractJsDocText(node, sourceFile),
+                    handlerOrPayload: `[${stateArg.getText(sourceFile)}, Patch[]]`,
+                    sourceFile: relPath,
+                    line,
+                    deprecated: isDeprecated(node),
+                });
+            }
+        }
+    }
+    return items;
+}
+exports.extractFromFile = extractFromFile;
+//# sourceMappingURL=extraction.cjs.map

package/dist/docs/extraction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.cjs","sourceRoot":"","sources":["../../src/docs/extraction.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAkD;AAClD,qDAAuC;AACvC,gDAAkC;AAClC,2CAyBoB;AAepB;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,UAAsB;IACpD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;gBAC9B,IAAI,IAAA,4BAAe,EAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvC,CAAC;qBAAM,IAAI,IAAA,2BAAc,EAAC,IAAI,CAAC,IAAI,IAAA,4BAAe,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBACpE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAED,6DAA6D;YAC7D,IACE,CAAC,IAAI,CAAC,WAAW;gBACjB,IAAI,CAAC,IAAI;gBACT,IAAA,8BAAiB,EAAC,IAAI,CAAC,IAAI,CAAC;gBAC5B,IAAA,4BAAe,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAClC,CAAC;gBACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,qBAAqB,CAClC,UAAsB,EACtB,QAAgB;IAEhB,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEjD,yDAAyD;IACzD,iEAAiE;IACjE,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,IACE,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC;YAC/B,CAAC,SAAS,CAAC,eAAe;YAC1B,CAAC,IAAA,4BAAe,EAAC,SAAS,CAAC,eAAe,CAAC,EAC3C,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxE,gEAAgE;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,KAAK;YACtB,CAAC,CAAC;gBACE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,QAAQ,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,OAAO,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC;aACvC;YACH,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAErE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,MAAM,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,EAAE,GAAG,IAAA,6BAAgB,EACzB,SAAS,EACT,OAAO,EACP,yBAAY,CAAC,MAAM,EACnB,IAAI,CACL,CAAC;YACF,yDAAyD;YACzD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;YAE5C,IACE,SAAS,CAAC,YAAY,EAAE,aAAa;gBACrC,IAAA,2BAAc,EAAC,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC,EACpD,CAAC;gBACD,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;oBACpE,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;oBACjE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;oBACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iBAAiB,CACxB,IAAgB,EAChB,SAA8B;IAE9B,IAAI,IAAA,4BAAe,EAAC,IAAI,CAAC,IAAI,IAAA,4CAA+B,EAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,IAAA,iCAAoB,EAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACtC,yBAAyB;YACzB,IAAI,IAAA,+BAAkB,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,IAAI,IAAA,yBAAY,EAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;wBACtB,OAAO,IAAI,CAAC;oBACd,CAAC;oBACD,MAAM,IAAI,GAAG,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;iBAAM,IAAI,IAAA,yBAAY,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,0BAA0B,CACjC,IAAyB,EACzB,SAA8B;IAE9B,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACtC,kDAAkD;QAClD,IAAI,IAAA,4BAAe,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;aAAM,IACL,IAAA,8BAAiB,EAAC,IAAI,CAAC,IAAI,CAAC;YAC5B,IAAA,4BAAe,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAClC,CAAC;YACD,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,IAAY,EAAE,UAAsB;IAC5D,MAAM,MAAM,GAAG,IAAA,oCAAuB,EAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,IAAA,oBAAO,EAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5E,2DAA2D;IAC3D,MAAM,eAAe,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9D,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,6EAA6E;IAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG;QAClB,QAAQ;QACR,UAAU;QACV,MAAM;QACN,SAAS;QACT,WAAW;QACX,UAAU;KACX,CAAC;IACF,IAAI,UAAU,GAAiC,IAAI,CAAC;IACpD,IAAI,eAAe,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YAC3B,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,sCAAsC;QACtC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,wCAAwC;YACxC,IAAI,UAAU,KAAK,YAAY,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9D,OAAO,CAAC,IAAI,CAAC,mBAAmB,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC7D,eAAe,GAAG,EAAE,CAAC;YACvB,CAAC;YAED,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtC,UAAU,GAAG,YAAY,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC3D,IAAI,OAAO,EAAE,CAAC;oBACZ,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBACD,SAAS;YACX,CAAC;YAED,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YACjC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACnB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,SAAS;YACX,CAAC;QACH,CAAC;aAAM,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YACvC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACnB,wBAAwB;gBACxB,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CAAC,mBAAmB,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC7D,eAAe,GAAG,EAAE,CAAC;gBACvB,CAAC;gBACD,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,sCAAsC;IACtC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,mBAAmB,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,+DAA+D;IAC/D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAEzD,oFAAoF;IACpF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpE,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,oCAAoC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,IAAI,GAAG,IAAA,yBAAY,EAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,UAAsB;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE9C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAA,+BAAkB,EAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAEtC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACvC,IACE,CAAC,IAAA,gCAAmB,EAAC,MAAM,CAAC;gBAC5B,CAAC,MAAM,CAAC,IAAI;gBACZ,CAAC,IAAA,yBAAY,EAAC,MAAM,CAAC,IAAI,CAAC,EAC1B,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAEpC,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU;iBAC7B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;oBAC1B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;oBAChC,CAAC,CAAC,SAAS,CAAC;gBACd,OAAO,GAAG,SAAS,GAAG,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjD,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,kBAAkB;YAClB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAE1E,0EAA0E;YAC1E,kCAAkC;YAClC,MAAM,eAAe,GAAG,IAAI,MAAM,QAAQ,UAAU,EAAE,CAAC;YAEvD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEnD,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,UAAU,EAAE,EAAE;gBACxC,KAAK;gBACL,SAAS,EAAE,eAAe;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CACrB,WAAmB,EACnB,YAAqC;IAErC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CACtB,OAA+B,EAC/B,QAAgB,EAChB,UAAsB;IAEtB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IACE,IAAA,gCAAmB,EAAC,MAAM,CAAC;YAC3B,MAAM,CAAC,IAAI;YACX,IAAA,yBAAY,EAAC,MAAM,CAAC,IAAI,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC7B,MAAM,CAAC,IAAI,EACX,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;GAMG;AACI,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAA,6BAAgB,EACjC,QAAQ,EACR,OAAO,EACP,yBAAY,CAAC,MAAM,EACnB,IAAI,CACL,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEjD,8DAA8D;IAC9D,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9C,kEAAkE;QAClE,mDAAmD;QACnD,gBAAgB;QAChB,4EAA4E;QAC5E,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,UAAmE,CAAC;QACxE,IAAI,aAAiD,CAAC;QAEtD,IACE,IAAA,mCAAsB,EAAC,SAAS,CAAC;YACjC,IAAA,8BAAiB,EAAC,SAAS,CAAC,IAAI,CAAC,EACjC,CAAC;YACD,UAAU,GAAG,SAAS,CAAC;YACvB,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,CAAC;aAAM,IAAI,IAAA,mCAAsB,EAAC,SAAS,CAAC,EAAE,CAAC;YAC7C,UAAU,GAAG,SAAS,CAAC;YACvB,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC;QACpC,CAAC;QAED,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACtC,MAAM,IAAI,GACR,UAAU,CAAC,6BAA6B,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI;gBACpE,CAAC,CAAC;YAEJ,uBAAuB;YACvB,IAAI,UAAU,GAAkB,IAAI,CAAC;YACrC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,IACE,IAAA,gCAAmB,EAAC,MAAM,CAAC;oBAC3B,MAAM,CAAC,IAAI;oBACX,IAAA,yBAAY,EAAC,MAAM,CAAC,IAAI,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;oBAC3B,MAAM,CAAC,IAAI,EACX,CAAC;oBACD,IAAI,IAAA,8BAAiB,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnC,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;oBACjE,CAAC;yBAAM,IAAI,IAAA,sCAAyB,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;wBAClD,UAAU,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,WAAW,GAAG,eAAe,CACjC,aAAa,EACb,SAAS,EACT,UAAU,CACX,CAAC;gBACF,MAAM,WAAW,GAAG,eAAe,CACjC,aAAa,EACb,SAAS,EACT,UAAU,CACX,CAAC;gBAEF,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;oBAC/B,MAAM,IAAI,GAAuB,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAElE,2EAA2E;oBAC3E,IAAI,eAAe,GAAG,WAAW,IAAI,WAAW,CAAC;oBACjD,IAAI,cAAc,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;oBAE9D,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;wBAC3D,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC;wBACrC,yDAAyD;wBACzD,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;4BAC5C,cAAc,GAAG,QAAQ,CAAC,WAAW,CAAC;wBACxC,CAAC;oBACH,CAAC;oBAED,KAAK,CAAC,IAAI,CAAC;wBACT,QAAQ;wBACR,UAAU;wBACV,IAAI;wBACJ,KAAK,EAAE,cAAc;wBACrB,gBAAgB,EAAE,eAAe;wBACjC,UAAU,EAAE,OAAO;wBACnB,IAAI;wBACJ,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC;qBACrC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,sEAAsE;QACtE,sEAAsE;QACtE,IAAI,CAAC,IAAA,mCAAsB,EAAC,SAAS,CAAC,EAAE,CAAC;YACvC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,MAAM,IAAI,GACR,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAErE,sEAAsE;QACtE,wDAAwD;QACxD,sEAAsE;QACtE,IACE,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,0BAA0B;YACtD,IAAI,CAAC,IAAI,CAAC,aAAa;YACvB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,EACnC,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,SAAS,GAAkB,IAAI,CAAC;YAEpC,IAAI,IAAA,4BAAe,EAAC,QAAQ,CAAC,IAAI,IAAA,yBAAY,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjE,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YAC5D,CAAC;YACD,IAAI,IAAA,8BAAiB,EAAC,QAAQ,CAAC,IAAI,IAAA,4BAAe,EAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrE,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YACpC,CAAC;YAED,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ;oBACR,UAAU,EAAE,GAAG,SAAS,WAAW;oBACnC,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC;oBACzC,gBAAgB,EAAE,SAAS,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;oBACzD,UAAU,EAAE,OAAO;oBACnB,IAAI;oBACJ,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,0DAA0D;QAC1D,sEAAsE;QACtE,IACE,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,IAAA,yBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,4BAA4B;YACxD,IAAI,CAAC,IAAI,CAAC,aAAa;YACvB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,EACnC,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,SAAS,GAAkB,IAAI,CAAC;YAEpC,IAAI,IAAA,4BAAe,EAAC,QAAQ,CAAC,IAAI,IAAA,yBAAY,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjE,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YAC5D,CAAC;YACD,IAAI,IAAA,8BAAiB,EAAC,QAAQ,CAAC,IAAI,IAAA,4BAAe,EAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrE,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YACpC,CAAC;YAED,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ;oBACR,UAAU,EAAE,GAAG,SAAS,cAAc;oBACtC,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC;oBACzC,gBAAgB,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY;oBAC9D,UAAU,EAAE,OAAO;oBACnB,IAAI;oBACJ,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AA5LD,0CA4LC","sourcesContent":["import { fileExists } from '@metamask/utils/node';\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport {\n  createSourceFile,\n  getJSDocCommentsAndTags,\n  getJSDocTags,\n  isAsExpression,\n  isClassDeclaration,\n  isIdentifier,\n  isImportDeclaration,\n  isInterfaceDeclaration,\n  isJSDoc,\n  isLiteralTypeNode,\n  isMethodDeclaration,\n  isNamedImports,\n  isNoSubstitutionTemplateLiteral,\n  isPropertySignature,\n  isStringLiteral,\n  isTemplateExpression,\n  isTemplateLiteralTypeNode,\n  isTypeAliasDeclaration,\n  isTypeLiteralNode,\n  isTypeOfExpression,\n  isTypeQueryNode,\n  isTypeReferenceNode,\n  isVariableStatement,\n  ScriptTarget,\n} from 'typescript';\nimport type {\n  Expression,\n  InterfaceDeclaration,\n  Node as TsNode,\n  NodeArray,\n  SourceFile,\n  TemplateLiteralTypeNode as TemplateLiteralType,\n  TypeAliasDeclaration,\n  TypeElement,\n} from 'typescript';\n\nimport type { MessengerItemDoc, MethodInfo } from './types';\n\n\n/**\n * Extract string constants from top-level variable declarations in a source file.\n * Only looks at top-level `const x = 'string'` or `const x = 'string' as const`.\n *\n * @param sourceFile - The TypeScript source file to extract constants from.\n * @returns A map of constant name to string value.\n */\nfunction extractStringConstants(sourceFile: SourceFile): Map<string, string> {\n  const names = new Map<string, string>();\n\n  for (const statement of sourceFile.statements) {\n    if (!isVariableStatement(statement)) {\n      continue;\n    }\n    for (const decl of statement.declarationList.declarations) {\n      if (!isIdentifier(decl.name)) {\n        continue;\n      }\n\n      if (decl.initializer) {\n        const init = decl.initializer;\n        if (isStringLiteral(init)) {\n          names.set(decl.name.text, init.text);\n        } else if (isAsExpression(init) && isStringLiteral(init.expression)) {\n          names.set(decl.name.text, init.expression.text);\n        }\n      }\n\n      // Handle `declare const x: \"value\"` (common in .d.cts files)\n      if (\n        !decl.initializer &&\n        decl.type &&\n        isLiteralTypeNode(decl.type) &&\n        isStringLiteral(decl.type.literal)\n      ) {\n        names.set(decl.name.text, decl.type.literal.text);\n      }\n    }\n  }\n\n  return names;\n}\n\n/**\n * Resolve the value of `controllerName` (or similar constant) defined in the\n * same file or imported from a local `./constants*` module (single-hop only).\n *\n * @param sourceFile - The TypeScript source file to search.\n * @param filePath - The absolute path of the source file on disk.\n * @returns A promise that resolves to a map of constant name to resolved string value.\n */\nasync function resolveControllerName(\n  sourceFile: SourceFile,\n  filePath: string,\n): Promise<Map<string, string>> {\n  const names = extractStringConstants(sourceFile);\n\n  // Chase single-hop local imports (no further recursion):\n  //   import { BRIDGE_CONTROLLER_NAME } from './constants/bridge';\n  for (const statement of sourceFile.statements) {\n    if (\n      !isImportDeclaration(statement) ||\n      !statement.moduleSpecifier ||\n      !isStringLiteral(statement.moduleSpecifier)\n    ) {\n      continue;\n    }\n\n    const spec = statement.moduleSpecifier.text;\n    if (!spec.startsWith('.')) {\n      continue;\n    }\n\n    const dir = path.dirname(filePath);\n    const isDts = filePath.endsWith('.d.cts') || filePath.endsWith('.d.ts');\n    // Strip .cjs/.js extension from specifier for .d.cts resolution\n    const bareSpec = spec.replace(/\\.(c|m)?js$/u, '');\n    const candidates = isDts\n      ? [\n          path.join(dir, `${bareSpec}.d.cts`),\n          path.join(dir, bareSpec, 'index.d.cts'),\n          path.join(dir, `${bareSpec}.d.ts`),\n          path.join(dir, bareSpec, 'index.d.ts'),\n        ]\n      : [path.join(dir, `${spec}.ts`), path.join(dir, spec, 'index.ts')];\n\n    for (const candidate of candidates) {\n      if (!(await fileExists(candidate))) {\n        continue;\n      }\n\n      const content = await fs.readFile(candidate, 'utf8');\n      const sf = createSourceFile(\n        candidate,\n        content,\n        ScriptTarget.Latest,\n        true,\n      );\n      // Only extract constants — do NOT follow further imports\n      const imported = extractStringConstants(sf);\n\n      if (\n        statement.importClause?.namedBindings &&\n        isNamedImports(statement.importClause.namedBindings)\n      ) {\n        for (const element of statement.importClause.namedBindings.elements) {\n          const importedName = (element.propertyName ?? element.name).text;\n          const localName = element.name.text;\n          const value = imported.get(importedName);\n          if (value !== undefined) {\n            names.set(localName, value);\n          }\n        }\n      }\n      break;\n    }\n  }\n\n  return names;\n}\n\n/**\n * Resolve a template-literal or string-literal `type` property to its string\n * value. Returns null if unresolvable.\n *\n * @param node - The expression node to resolve.\n * @param constants - A map of known constant names to their string values.\n * @returns The resolved string value, or null if unresolvable.\n */\nfunction resolveTypeString(\n  node: Expression,\n  constants: Map<string, string>,\n): string | null {\n  if (isStringLiteral(node) || isNoSubstitutionTemplateLiteral(node)) {\n    return node.text;\n  }\n\n  if (isTemplateExpression(node)) {\n    let result = node.head.text;\n    for (const span of node.templateSpans) {\n      // typeof X  →  resolve X\n      if (isTypeOfExpression(span.expression)) {\n        if (isIdentifier(span.expression.expression)) {\n          const val = constants.get(span.expression.expression.text);\n          if (val === undefined) {\n            return null;\n          }\n          result += val;\n        } else {\n          return null;\n        }\n      } else if (isIdentifier(span.expression)) {\n        const val = constants.get(span.expression.text);\n        if (val === undefined) {\n          return null;\n        }\n        result += val;\n      } else {\n        return null;\n      }\n      result += span.literal.text;\n    }\n    return result;\n  }\n\n  return null;\n}\n\n/**\n * Resolve a TemplateLiteralTypeNode (used in type positions like\n * `type: \\`${typeof controllerName}:name\\``) to its string value.\n *\n * @param node - The template literal type node to resolve.\n * @param constants - A map of known constant names to their string values.\n * @returns The resolved string value, or null if unresolvable.\n */\nfunction resolveTemplateLiteralType(\n  node: TemplateLiteralType,\n  constants: Map<string, string>,\n): string | null {\n  let result = node.head.text;\n\n  for (const span of node.templateSpans) {\n    // In type position, `typeof X` is a TypeQueryNode\n    if (isTypeQueryNode(span.type) && isIdentifier(span.type.exprName)) {\n      const val = constants.get(span.type.exprName.text);\n      if (val === undefined) {\n        return null;\n      }\n      result += val;\n    } else if (\n      isLiteralTypeNode(span.type) &&\n      isStringLiteral(span.type.literal)\n    ) {\n      result += span.type.literal.text;\n    } else {\n      return null;\n    }\n    result += span.literal.text;\n  }\n\n  return result;\n}\n\n/**\n * Extract cleaned JSDoc body text from a node.\n *\n * @param node - The AST node to extract JSDoc from.\n * @param sourceFile - The source file containing the node.\n * @returns The cleaned JSDoc text, or empty string if none.\n */\nfunction extractJsDocText(node: TsNode, sourceFile: SourceFile): string {\n  const jsDocs = getJSDocCommentsAndTags(node);\n  if (jsDocs.length === 0) {\n    return '';\n  }\n\n  const jsDoc = jsDocs[0];\n  if (!isJSDoc(jsDoc)) {\n    return '';\n  }\n\n  const fullText = sourceFile.getFullText();\n  const raw = fullText.substring(jsDoc.getFullStart(), jsDoc.getEnd()).trim();\n\n  // Handle single-line JSDoc: /** Gets the current state. */\n  const singleLineMatch = raw.match(/^\\/\\*\\*\\s*(.*?)\\s*\\*\\/$/u);\n  if (singleLineMatch) {\n    const text = singleLineMatch[1].replace(/^\\*\\s*/u, '');\n    return text || '';\n  }\n\n  // Strip comment delimiters, leading asterisks, and @param/@returns/@see tags\n  const lines = raw.split('\\n');\n  const cleaned: string[] = [];\n  const skippedTags = [\n    '@param',\n    '@returns',\n    '@see',\n    '@throws',\n    '@template',\n    '@example',\n  ];\n  let currentTag: 'skip' | 'deprecated' | null = null;\n  let deprecatedParts: string[] = [];\n\n  for (const rawLine of lines) {\n    let trimmed = rawLine.trim();\n    if (trimmed === '/**' || trimmed === '*/') {\n      continue;\n    }\n    if (trimmed.startsWith('* ')) {\n      trimmed = trimmed.slice(2);\n    } else if (trimmed === '*') {\n      trimmed = '';\n    } else if (trimmed.startsWith('*')) {\n      trimmed = trimmed.slice(1);\n    }\n\n    // Check if this line starts a new tag\n    if (trimmed.startsWith('@')) {\n      // Flush any accumulated deprecated text\n      if (currentTag === 'deprecated' && deprecatedParts.length > 0) {\n        cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);\n        deprecatedParts = [];\n      }\n\n      if (trimmed.startsWith('@deprecated')) {\n        currentTag = 'deprecated';\n        const depText = trimmed.slice('@deprecated'.length).trim();\n        if (depText) {\n          deprecatedParts.push(depText);\n        }\n        continue;\n      }\n\n      currentTag = skippedTags.some((tag) => trimmed.startsWith(tag))\n        ? 'skip'\n        : null;\n      if (currentTag === 'skip') {\n        continue;\n      }\n    } else if (currentTag === 'skip') {\n      if (trimmed === '') {\n        currentTag = null;\n      } else {\n        continue;\n      }\n    } else if (currentTag === 'deprecated') {\n      if (trimmed === '') {\n        // End of deprecated tag\n        if (deprecatedParts.length > 0) {\n          cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);\n          deprecatedParts = [];\n        }\n        currentTag = null;\n      } else {\n        deprecatedParts.push(trimmed);\n        continue;\n      }\n    }\n\n    cleaned.push(trimmed);\n  }\n\n  // Flush any remaining deprecated text\n  if (deprecatedParts.length > 0) {\n    cleaned.push(`**Deprecated:** ${deprecatedParts.join(' ')}`);\n  }\n\n  let result = cleaned.join('\\n').trim();\n\n  // Convert JSDoc {@link X} references to markdown backtick code\n  result = result.replace(/\\{@link\\s+([^}]+)\\}/gu, '`$1`');\n\n  // Escape remaining curly braces for MDX safety (but not inside backtick code spans)\n  result = result.replace(/`[^`]*`|(\\{)|(\\})/gu, (match, open, close) => {\n    if (open) {\n      return '\\\\{';\n    }\n    if (close) {\n      return '\\\\}';\n    }\n    return match; // preserve content inside backticks\n  });\n\n  return result;\n}\n\n/**\n * Check whether a node has an `@deprecated` JSDoc tag.\n *\n * @param node - The AST node to check.\n * @returns True if the node has an `@deprecated` tag.\n */\nfunction isDeprecated(node: TsNode): boolean {\n  const tags = getJSDocTags(node);\n  return tags.some((tag) => tag.tagName.text === 'deprecated');\n}\n\n/**\n * Collect method info from all class declarations in a source file.\n * Returns a map keyed by \"ClassName.methodName\".\n *\n * @param sourceFile - The TypeScript source file to scan.\n * @returns A map of \"ClassName.methodName\" to method info.\n */\nfunction collectClassMethods(sourceFile: SourceFile): Map<string, MethodInfo> {\n  const methods = new Map<string, MethodInfo>();\n\n  for (const statement of sourceFile.statements) {\n    if (!isClassDeclaration(statement) || !statement.name) {\n      continue;\n    }\n\n    const className = statement.name.text;\n\n    for (const member of statement.members) {\n      if (\n        !isMethodDeclaration(member) ||\n        !member.name ||\n        !isIdentifier(member.name)\n      ) {\n        continue;\n      }\n\n      const methodName = member.name.text;\n\n      // Build parameter list\n      const params = member.parameters\n        .map((param) => {\n          const paramName = param.name.getText(sourceFile);\n          const optional = param.questionToken ? '?' : '';\n          const paramType = param.type\n            ? param.type.getText(sourceFile)\n            : 'unknown';\n          return `${paramName}${optional}: ${paramType}`;\n        })\n        .join(', ');\n\n      // Get return type\n      const returnType = member.type ? member.type.getText(sourceFile) : 'void';\n\n      // For async methods, the declared return type already includes Promise<>,\n      // so we don't need to wrap again.\n      const methodSignature = `(${params}) => ${returnType}`;\n\n      const jsDoc = extractJsDocText(member, sourceFile);\n\n      methods.set(`${className}.${methodName}`, {\n        jsDoc,\n        signature: methodSignature,\n      });\n    }\n  }\n\n  return methods;\n}\n\n/**\n * If `handlerText` matches `ClassName['methodName']`, look it up in classMethodInfo\n * and return the resolved signature. Otherwise return the original text.\n *\n * @param handlerText - The raw handler text to resolve.\n * @param classMethods - A map of class methods collected from the source file.\n * @returns An object with the resolved signature and any associated JSDoc.\n */\nfunction resolveHandler(\n  handlerText: string,\n  classMethods: Map<string, MethodInfo>,\n): { signature: string; methodJsDoc: string } {\n  const match = handlerText.match(/^(\\w+)\\['(\\w+)'\\]$/u);\n  if (match) {\n    const key = `${match[1]}.${match[2]}`;\n    const info = classMethods.get(key);\n    if (info) {\n      return { signature: info.signature, methodJsDoc: info.jsDoc };\n    }\n  }\n  return { signature: handlerText, methodJsDoc: '' };\n}\n\n/**\n * Get the raw source text for a property value inside a type literal.\n *\n * @param members - The type literal members to search.\n * @param propName - The property name to find.\n * @param sourceFile - The source file for getText calls.\n * @returns The raw text of the property type, or empty string if not found.\n */\nfunction getPropertyText(\n  members: NodeArray<TypeElement>,\n  propName: string,\n  sourceFile: SourceFile,\n): string {\n  for (const member of members) {\n    if (\n      isPropertySignature(member) &&\n      member.name &&\n      isIdentifier(member.name) &&\n      member.name.text === propName &&\n      member.type\n    ) {\n      return member.type.getText(sourceFile).trim();\n    }\n  }\n  return '';\n}\n\n// ---------------------------------------------------------------------------\n// Main extraction\n// ---------------------------------------------------------------------------\n\n/**\n * Extract messenger action/event type definitions from a single TypeScript file.\n *\n * @param filePath - The absolute path to the TypeScript file.\n * @param relBase - Base path for computing relative source paths.\n * @returns A promise that resolves to an array of extracted messenger item docs.\n */\nexport async function extractFromFile(\n  filePath: string,\n  relBase: string,\n): Promise<MessengerItemDoc[]> {\n  const content = await fs.readFile(filePath, 'utf8');\n  const sourceFile = createSourceFile(\n    filePath,\n    content,\n    ScriptTarget.Latest,\n    true,\n  );\n\n  const constants = await resolveControllerName(sourceFile, filePath);\n  const classMethods = collectClassMethods(sourceFile);\n  const items: MessengerItemDoc[] = [];\n  const relPath = path.relative(relBase, filePath);\n\n  // Type aliases and interfaces are always top-level statements\n  for (const statement of sourceFile.statements) {\n    // ---------------------------------------------------------------\n    // Pattern 1: { type: '...'; handler/payload: ... }\n    // Matches both:\n    //   type X = { type: '...'; handler: ... }   (type alias with literal body)\n    //   interface X { type: '...'; handler: ... } (interface declaration)\n    // ---------------------------------------------------------------\n    let inlineNode: TypeAliasDeclaration | InterfaceDeclaration | undefined;\n    let inlineMembers: NodeArray<TypeElement> | undefined;\n\n    if (\n      isTypeAliasDeclaration(statement) &&\n      isTypeLiteralNode(statement.type)\n    ) {\n      inlineNode = statement;\n      inlineMembers = statement.type.members;\n    } else if (isInterfaceDeclaration(statement)) {\n      inlineNode = statement;\n      inlineMembers = statement.members;\n    }\n\n    if (inlineNode && inlineMembers) {\n      const typeName = inlineNode.name.text;\n      const line =\n        sourceFile.getLineAndCharacterOfPosition(inlineNode.getStart()).line +\n        1;\n\n      // Find `type` property\n      let typeString: string | null = null;\n      for (const member of inlineMembers) {\n        if (\n          isPropertySignature(member) &&\n          member.name &&\n          isIdentifier(member.name) &&\n          member.name.text === 'type' &&\n          member.type\n        ) {\n          if (isLiteralTypeNode(member.type)) {\n            typeString = resolveTypeString(member.type.literal, constants);\n          } else if (isTemplateLiteralTypeNode(member.type)) {\n            typeString = resolveTemplateLiteralType(member.type, constants);\n          }\n        }\n      }\n\n      if (typeString?.includes(':')) {\n        const handlerText = getPropertyText(\n          inlineMembers,\n          'handler',\n          sourceFile,\n        );\n        const payloadText = getPropertyText(\n          inlineMembers,\n          'payload',\n          sourceFile,\n        );\n\n        if (handlerText || payloadText) {\n          const kind: 'action' | 'event' = handlerText ? 'action' : 'event';\n\n          // For actions, resolve ClassName['methodName'] to actual signature + JSDoc\n          let resolvedHandler = handlerText || payloadText;\n          let typeAliasJsDoc = extractJsDocText(inlineNode, sourceFile);\n\n          if (handlerText) {\n            const resolved = resolveHandler(handlerText, classMethods);\n            resolvedHandler = resolved.signature;\n            // If the type alias has no JSDoc, use the method's JSDoc\n            if (!typeAliasJsDoc && resolved.methodJsDoc) {\n              typeAliasJsDoc = resolved.methodJsDoc;\n            }\n          }\n\n          items.push({\n            typeName,\n            typeString,\n            kind,\n            jsDoc: typeAliasJsDoc,\n            handlerOrPayload: resolvedHandler,\n            sourceFile: relPath,\n            line,\n            deprecated: isDeprecated(inlineNode),\n          });\n        }\n      }\n    }\n\n    // -------------------------------------------------------------------\n    // Patterns 2 & 3 only apply to type aliases (generic type references)\n    // -------------------------------------------------------------------\n    if (!isTypeAliasDeclaration(statement)) {\n      continue;\n    }\n    const node = statement;\n    const typeName = node.name.text;\n    const line =\n      sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1;\n\n    // -------------------------------------------------------------------\n    // Pattern 2: ControllerGetStateAction<typeof cn, State>\n    // -------------------------------------------------------------------\n    if (\n      isTypeReferenceNode(node.type) &&\n      isIdentifier(node.type.typeName) &&\n      node.type.typeName.text === 'ControllerGetStateAction' &&\n      node.type.typeArguments &&\n      node.type.typeArguments.length >= 2\n    ) {\n      const firstArg = node.type.typeArguments[0];\n      const stateArg = node.type.typeArguments[1];\n      let namespace: string | null = null;\n\n      if (isTypeQueryNode(firstArg) && isIdentifier(firstArg.exprName)) {\n        namespace = constants.get(firstArg.exprName.text) ?? null;\n      }\n      if (isLiteralTypeNode(firstArg) && isStringLiteral(firstArg.literal)) {\n        namespace = firstArg.literal.text;\n      }\n\n      if (namespace) {\n        items.push({\n          typeName,\n          typeString: `${namespace}:getState`,\n          kind: 'action',\n          jsDoc: extractJsDocText(node, sourceFile),\n          handlerOrPayload: `() => ${stateArg.getText(sourceFile)}`,\n          sourceFile: relPath,\n          line,\n          deprecated: isDeprecated(node),\n        });\n      }\n    }\n\n    // -------------------------------------------------------------------\n    // Pattern 3: ControllerStateChangeEvent<typeof cn, State>\n    // -------------------------------------------------------------------\n    if (\n      isTypeReferenceNode(node.type) &&\n      isIdentifier(node.type.typeName) &&\n      node.type.typeName.text === 'ControllerStateChangeEvent' &&\n      node.type.typeArguments &&\n      node.type.typeArguments.length >= 2\n    ) {\n      const firstArg = node.type.typeArguments[0];\n      const stateArg = node.type.typeArguments[1];\n      let namespace: string | null = null;\n\n      if (isTypeQueryNode(firstArg) && isIdentifier(firstArg.exprName)) {\n        namespace = constants.get(firstArg.exprName.text) ?? null;\n      }\n      if (isLiteralTypeNode(firstArg) && isStringLiteral(firstArg.literal)) {\n        namespace = firstArg.literal.text;\n      }\n\n      if (namespace) {\n        items.push({\n          typeName,\n          typeString: `${namespace}:stateChange`,\n          kind: 'event',\n          jsDoc: extractJsDocText(node, sourceFile),\n          handlerOrPayload: `[${stateArg.getText(sourceFile)}, Patch[]]`,\n          sourceFile: relPath,\n          line,\n          deprecated: isDeprecated(node),\n        });\n      }\n    }\n  }\n\n  return items;\n}\n"]}

package/dist/docs/extraction.d.cts

@@ -0,0 +1,10 @@
+import type { MessengerItemDoc } from "./types.cjs";
+/**
+ * Extract messenger action/event type definitions from a single TypeScript file.
+ *
+ * @param filePath - The absolute path to the TypeScript file.
+ * @param relBase - Base path for computing relative source paths.
+ * @returns A promise that resolves to an array of extracted messenger item docs.
+ */
+export declare function extractFromFile(filePath: string, relBase: string): Promise<MessengerItemDoc[]>;
+//# sourceMappingURL=extraction.d.cts.map

package/dist/docs/extraction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.cts","sourceRoot":"","sources":["../../src/docs/extraction.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,gBAAgB,EAAc,oBAAgB;AAwc5D;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyL7B"}