Method processPublicApi

src/index-cli.ts:301–403

* Process public API exports from dist folder or API markdown files

(
        distPath: string,
        sourceRoot: string,
    )

     * Process public API exports from dist folder or API markdown files
     */
    private async processPublicApi(
        distPath: string,
        sourceRoot: string,
    ): Promise<void> {
        logger.info("Processing public API exports");

        try {
            // First, try to parse API markdown files from the source root
            logger.info("Checking for *.api.md files in source root");
            const apiMarkdownExports =
                await parseApiMarkdownExports(sourceRoot);

            if (
                apiMarkdownExports.apiMdFiles.size > 0 &&
                apiMarkdownExports.symbolToFiles.size > 0
            ) {
                logger.info(
                    `Found ${apiMarkdownExports.apiMdFiles.size} relevant *.api.md file(s) with ${apiMarkdownExports.symbolToFiles.size} symbol(s)`,
                );

                // Map symbols from API markdown files directly to source files
                const symbolToSourceFiles = new Map<string, Set<string>>();

                for (const [symbolName] of apiMarkdownExports.symbolToFiles) {
                    const sourceFiles = new Set<string>();

                    // Find the corresponding source file for this symbol
                    const sourceFile = this.findSourceFileForSymbol(
                        symbolName,
                        sourceRoot,
                    );
                    if (sourceFile) {
                        sourceFiles.add(sourceFile);
                    }

                    if (sourceFiles.size > 0) {
                        symbolToSourceFiles.set(symbolName, sourceFiles);
                        logger.debug(
                            `Public API symbol: ${symbolName} -> ${Array.from(sourceFiles).join(", ")}`,
                        );
                    }
                }

                // Store in configuration
                Configuration.mainData.publicApiExports = symbolToSourceFiles;

                logger.info(
                    `Loaded ${symbolToSourceFiles.size} public API symbol(s) from ${apiMarkdownExports.apiMdFiles.size} *.api.md file(s) (using API Markdown parser)`,
                );
            } else {
                // Fall back to index.d.ts parsing
                logger.info(
                    "No relevant *.api.md files found, falling back to index.d.ts parsing",
                );

                const publicApiExports = await parsePublicApi(distPath);

                if (publicApiExports.symbolToFiles.size === 0) {