@metamask-previews/messenger-cli 0.1.0-preview-3f6f27f → 0.1.0-preview-b6a517f5e

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `messenger-docs` CLI binary for generating Messenger API documentation
+
 ## [0.1.0]
 
 ### Added

package/dist/docs/cli.cjs

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+"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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const execa_1 = __importDefault(require("execa/index.js"));
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const yargs_1 = __importDefault(require("yargs"));
+const generate_1 = require("./generate.cjs");
+/**
+ * Resolve the path to the docusaurus CLI binary and the node_modules
+ * directory that contains the Docusaurus packages.
+ *
+ * @returns The docusaurus binary path and the node_modules directory.
+ */
+function resolveDocusaurus() {
+    const bin = require.resolve('@docusaurus/core/bin/docusaurus.mjs');
+    const coreDir = path.dirname(path.dirname(bin));
+    const nodeModules = path.dirname(path.dirname(coreDir));
+    return { bin, nodeModules };
+}
+/**
+ * Run a Docusaurus command.
+ *
+ * @param command - The docusaurus command (start, build, serve).
+ * @param cwd - The site directory.
+ */
+async function runDocusaurus(command, cwd) {
+    const { bin, nodeModules } = resolveDocusaurus();
+    await (0, execa_1.default)(process.execPath, [bin, command], {
+        cwd,
+        stdio: 'inherit',
+        // eslint-disable-next-line n/no-process-env
+        env: { ...process.env, NODE_PATH: nodeModules },
+    });
+}
+/**
+ * Copy template files into the output directory using fs.cp with filtering.
+ *
+ * @param outDir - The output directory to set up.
+ */
+async function setupSite(outDir) {
+    const templateDir = path.resolve(__dirname, '..', '..', 'template');
+    const skip = new Set(['node_modules', 'docs']);
+    console.log(`\nSetting up Docusaurus site in ${outDir}...`);
+    await copyDir(templateDir, outDir, skip);
+    // Write a minimal package.json so Docusaurus doesn't warn about a missing one
+    const pkgJsonPath = path.join(outDir, 'package.json');
+    try {
+        await fs.access(pkgJsonPath);
+    }
+    catch {
+        await fs.writeFile(pkgJsonPath, JSON.stringify({ name: 'messenger-docs-site', private: true }, null, 2));
+    }
+}
+/**
+ * Resolve scanDirs from CLI args, package.json config, or default.
+ *
+ * @param projectPath - The project root path.
+ * @param cliScanDirs - Scan dirs provided via CLI flags.
+ * @returns Resolved scan directories.
+ */
+async function resolveScanDirs(projectPath, cliScanDirs) {
+    if (cliScanDirs.length > 0) {
+        return cliScanDirs;
+    }
+    try {
+        const pkgRaw = await fs.readFile(path.join(projectPath, 'package.json'), 'utf8');
+        const pkg = JSON.parse(pkgRaw);
+        const config = pkg['messenger-docs'];
+        if (Array.isArray(config?.scanDirs)) {
+            return config.scanDirs;
+        }
+    }
+    catch {
+        // No package.json or invalid — use default.
+    }
+    return ['src'];
+}
+/**
+ * Main CLI entry point.
+ */
+async function main() {
+    const argv = await (0, yargs_1.default)(process.argv.slice(2))
+        .command('$0 [project-path]', 'Generate Messenger API documentation for MetaMask controller packages', (yargsInstance) => {
+        yargsInstance.positional('project-path', {
+            type: 'string',
+            description: 'Path to the project to scan',
+            default: '.',
+        });
+    })
+        .option('build', {
+        type: 'boolean',
+        description: 'Generate docs and build static site',
+        default: false,
+    })
+        .option('serve', {
+        type: 'boolean',
+        description: 'Generate docs, build, and serve static site',
+        default: false,
+    })
+        .option('dev', {
+        type: 'boolean',
+        description: 'Generate docs and start dev server with hot reload',
+        default: false,
+    })
+        .option('scan-dir', {
+        type: 'string',
+        array: true,
+        description: 'Source directory to scan (repeatable)',
+        default: [],
+    })
+        .option('output', {
+        type: 'string',
+        description: 'Output directory',
+    })
+        .epilogue('Source directories can also be configured in package.json:\n  "messenger-docs": { "scanDirs": ["app", "src"] }')
+        .help().argv;
+    const projectPathArg = argv['project-path'];
+    const resolvedProjectPath = path.resolve(typeof projectPathArg === 'string' ? projectPathArg : '.');
+    const resolvedOutputDir = path.resolve(argv.output ?? path.join(resolvedProjectPath, '.messenger-docs'));
+    const scanDirs = await resolveScanDirs(resolvedProjectPath, argv['scan-dir']);
+    // Step 1: Generate docs
+    await (0, generate_1.generate)({
+        projectPath: resolvedProjectPath,
+        outputDir: resolvedOutputDir,
+        scanDirs,
+    });
+    // Step 2: If --build, --serve, or --dev, set up and run Docusaurus
+    if (argv.build || argv.serve || argv.dev) {
+        await setupSite(resolvedOutputDir);
+        if (argv.dev) {
+            console.log('\nStarting dev server...');
+            await runDocusaurus('start', resolvedOutputDir);
+        }
+        else if (argv.build || argv.serve) {
+            console.log('\nBuilding static site...');
+            await runDocusaurus('build', resolvedOutputDir);
+            if (argv.serve) {
+                console.log('\nServing static site...');
+                await runDocusaurus('serve', resolvedOutputDir);
+            }
+        }
+    }
+}
+/**
+ * Recursively copy a directory, skipping specified directory names.
+ *
+ * @param src - Source directory.
+ * @param dest - Destination directory.
+ * @param skip - Set of directory names to skip.
+ */
+async function copyDir(src, dest, skip) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (skip.has(entry.name)) {
+            continue;
+        }
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath, skip);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/docs/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sourceRoot":"","sources":["../../src/docs/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport execa from 'execa';\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport yargs from 'yargs';\n\nimport { generate } from './generate';\n\n/**\n * Resolve the path to the docusaurus CLI binary and the node_modules\n * directory that contains the Docusaurus packages.\n *\n * @returns The docusaurus binary path and the node_modules directory.\n */\nfunction resolveDocusaurus(): { bin: string; nodeModules: string } {\n  const bin = require.resolve('@docusaurus/core/bin/docusaurus.mjs');\n  const coreDir = path.dirname(path.dirname(bin));\n  const nodeModules = path.dirname(path.dirname(coreDir));\n  return { bin, nodeModules };\n}\n\n/**\n * Run a Docusaurus command.\n *\n * @param command - The docusaurus command (start, build, serve).\n * @param cwd - The site directory.\n */\nasync function runDocusaurus(command: string, cwd: string): Promise<void> {\n  const { bin, nodeModules } = resolveDocusaurus();\n  await execa(process.execPath, [bin, command], {\n    cwd,\n    stdio: 'inherit',\n    // eslint-disable-next-line n/no-process-env\n    env: { ...process.env, NODE_PATH: nodeModules },\n  });\n}\n\n/**\n * Copy template files into the output directory using fs.cp with filtering.\n *\n * @param outDir - The output directory to set up.\n */\nasync function setupSite(outDir: string): Promise<void> {\n  const templateDir = path.resolve(__dirname, '..', '..', 'template');\n  const skip = new Set(['node_modules', 'docs']);\n\n  console.log(`\\nSetting up Docusaurus site in ${outDir}...`);\n\n  await copyDir(templateDir, outDir, skip);\n\n  // Write a minimal package.json so Docusaurus doesn't warn about a missing one\n  const pkgJsonPath = path.join(outDir, 'package.json');\n  try {\n    await fs.access(pkgJsonPath);\n  } catch {\n    await fs.writeFile(\n      pkgJsonPath,\n      JSON.stringify({ name: 'messenger-docs-site', private: true }, null, 2),\n    );\n  }\n}\n\n/**\n * Resolve scanDirs from CLI args, package.json config, or default.\n *\n * @param projectPath - The project root path.\n * @param cliScanDirs - Scan dirs provided via CLI flags.\n * @returns Resolved scan directories.\n */\nasync function resolveScanDirs(\n  projectPath: string,\n  cliScanDirs: string[],\n): Promise<string[]> {\n  if (cliScanDirs.length > 0) {\n    return cliScanDirs;\n  }\n\n  try {\n    const pkgRaw = await fs.readFile(\n      path.join(projectPath, 'package.json'),\n      'utf8',\n    );\n    const pkg = JSON.parse(pkgRaw) as Record<string, unknown>;\n    const config = pkg['messenger-docs'] as { scanDirs?: string[] } | undefined;\n    if (Array.isArray(config?.scanDirs)) {\n      return config.scanDirs;\n    }\n  } catch {\n    // No package.json or invalid — use default.\n  }\n\n  return ['src'];\n}\n\n/**\n * Main CLI entry point.\n */\nasync function main(): Promise<void> {\n  const argv = await yargs(process.argv.slice(2))\n    .command(\n      '$0 [project-path]',\n      'Generate Messenger API documentation for MetaMask controller packages',\n      (yargsInstance) => {\n        yargsInstance.positional('project-path', {\n          type: 'string',\n          description: 'Path to the project to scan',\n          default: '.',\n        });\n      },\n    )\n    .option('build', {\n      type: 'boolean',\n      description: 'Generate docs and build static site',\n      default: false,\n    })\n    .option('serve', {\n      type: 'boolean',\n      description: 'Generate docs, build, and serve static site',\n      default: false,\n    })\n    .option('dev', {\n      type: 'boolean',\n      description: 'Generate docs and start dev server with hot reload',\n      default: false,\n    })\n    .option('scan-dir', {\n      type: 'string',\n      array: true,\n      description: 'Source directory to scan (repeatable)',\n      default: [] as string[],\n    })\n    .option('output', {\n      type: 'string',\n      description: 'Output directory',\n    })\n    .epilogue(\n      'Source directories can also be configured in package.json:\\n  \"messenger-docs\": { \"scanDirs\": [\"app\", \"src\"] }',\n    )\n    .help().argv;\n\n  const projectPathArg = argv['project-path'];\n  const resolvedProjectPath = path.resolve(\n    typeof projectPathArg === 'string' ? projectPathArg : '.',\n  );\n  const resolvedOutputDir = path.resolve(\n    argv.output ?? path.join(resolvedProjectPath, '.messenger-docs'),\n  );\n  const scanDirs = await resolveScanDirs(resolvedProjectPath, argv['scan-dir']);\n\n  // Step 1: Generate docs\n  await generate({\n    projectPath: resolvedProjectPath,\n    outputDir: resolvedOutputDir,\n    scanDirs,\n  });\n\n  // Step 2: If --build, --serve, or --dev, set up and run Docusaurus\n  if (argv.build || argv.serve || argv.dev) {\n    await setupSite(resolvedOutputDir);\n\n    if (argv.dev) {\n      console.log('\\nStarting dev server...');\n      await runDocusaurus('start', resolvedOutputDir);\n    } else if (argv.build || argv.serve) {\n      console.log('\\nBuilding static site...');\n      await runDocusaurus('build', resolvedOutputDir);\n\n      if (argv.serve) {\n        console.log('\\nServing static site...');\n        await runDocusaurus('serve', resolvedOutputDir);\n      }\n    }\n  }\n}\n\n/**\n * Recursively copy a directory, skipping specified directory names.\n *\n * @param src - Source directory.\n * @param dest - Destination directory.\n * @param skip - Set of directory names to skip.\n */\nasync function copyDir(\n  src: string,\n  dest: string,\n  skip: Set<string>,\n): Promise<void> {\n  await fs.mkdir(dest, { recursive: true });\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    if (skip.has(entry.name)) {\n      continue;\n    }\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath, skip);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nmain().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\n});\n"]}

package/dist/docs/cli.d.cts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.cts","sourceRoot":"","sources":["../../src/docs/cli.ts"],"names":[],"mappings":""}

package/dist/docs/cli.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.mts.map

package/dist/docs/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","sourceRoot":"","sources":["../../src/docs/cli.ts"],"names":[],"mappings":""}

package/dist/docs/cli.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+import { createRequire as $createRequire } from "module";
+const $require = $createRequire(import.meta.url);
+function $__filename(fileUrl) {
+    const url = new URL(fileUrl);
+    return url.pathname.replace(/^\/([a-zA-Z]:)/u, "$1");
+}
+function $getDirname(path) {
+    const sanitisedPath = path.toString().replace(/\\/gu, "/").replace(/\/$/u, "");
+    const index = sanitisedPath.lastIndexOf("/");
+    if (index === -1) {
+        return path;
+    }
+    if (index === 0) {
+        return "/";
+    }
+    return sanitisedPath.slice(0, index);
+}
+function $__dirname(url) {
+    return $getDirname($__filename(url));
+}
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import $execa from "execa/index.js";
+const execa = $importDefault($execa);
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import yargs from "yargs";
+import { generate } from "./generate.mjs";
+/**
+ * Resolve the path to the docusaurus CLI binary and the node_modules
+ * directory that contains the Docusaurus packages.
+ *
+ * @returns The docusaurus binary path and the node_modules directory.
+ */
+function resolveDocusaurus() {
+    const bin = $require.resolve('@docusaurus/core/bin/docusaurus.mjs');
+    const coreDir = path.dirname(path.dirname(bin));
+    const nodeModules = path.dirname(path.dirname(coreDir));
+    return { bin, nodeModules };
+}
+/**
+ * Run a Docusaurus command.
+ *
+ * @param command - The docusaurus command (start, build, serve).
+ * @param cwd - The site directory.
+ */
+async function runDocusaurus(command, cwd) {
+    const { bin, nodeModules } = resolveDocusaurus();
+    await execa(process.execPath, [bin, command], {
+        cwd,
+        stdio: 'inherit',
+        // eslint-disable-next-line n/no-process-env
+        env: { ...process.env, NODE_PATH: nodeModules },
+    });
+}
+/**
+ * Copy template files into the output directory using fs.cp with filtering.
+ *
+ * @param outDir - The output directory to set up.
+ */
+async function setupSite(outDir) {
+    const templateDir = path.resolve($__dirname(import.meta.url), '..', '..', 'template');
+    const skip = new Set(['node_modules', 'docs']);
+    console.log(`\nSetting up Docusaurus site in ${outDir}...`);
+    await copyDir(templateDir, outDir, skip);
+    // Write a minimal package.json so Docusaurus doesn't warn about a missing one
+    const pkgJsonPath = path.join(outDir, 'package.json');
+    try {
+        await fs.access(pkgJsonPath);
+    }
+    catch {
+        await fs.writeFile(pkgJsonPath, JSON.stringify({ name: 'messenger-docs-site', private: true }, null, 2));
+    }
+}
+/**
+ * Resolve scanDirs from CLI args, package.json config, or default.
+ *
+ * @param projectPath - The project root path.
+ * @param cliScanDirs - Scan dirs provided via CLI flags.
+ * @returns Resolved scan directories.
+ */
+async function resolveScanDirs(projectPath, cliScanDirs) {
+    if (cliScanDirs.length > 0) {
+        return cliScanDirs;
+    }
+    try {
+        const pkgRaw = await fs.readFile(path.join(projectPath, 'package.json'), 'utf8');
+        const pkg = JSON.parse(pkgRaw);
+        const config = pkg['messenger-docs'];
+        if (Array.isArray(config?.scanDirs)) {
+            return config.scanDirs;
+        }
+    }
+    catch {
+        // No package.json or invalid — use default.
+    }
+    return ['src'];
+}
+/**
+ * Main CLI entry point.
+ */
+async function main() {
+    const argv = await yargs(process.argv.slice(2))
+        .command('$0 [project-path]', 'Generate Messenger API documentation for MetaMask controller packages', (yargsInstance) => {
+        yargsInstance.positional('project-path', {
+            type: 'string',
+            description: 'Path to the project to scan',
+            default: '.',
+        });
+    })
+        .option('build', {
+        type: 'boolean',
+        description: 'Generate docs and build static site',
+        default: false,
+    })
+        .option('serve', {
+        type: 'boolean',
+        description: 'Generate docs, build, and serve static site',
+        default: false,
+    })
+        .option('dev', {
+        type: 'boolean',
+        description: 'Generate docs and start dev server with hot reload',
+        default: false,
+    })
+        .option('scan-dir', {
+        type: 'string',
+        array: true,
+        description: 'Source directory to scan (repeatable)',
+        default: [],
+    })
+        .option('output', {
+        type: 'string',
+        description: 'Output directory',
+    })
+        .epilogue('Source directories can also be configured in package.json:\n  "messenger-docs": { "scanDirs": ["app", "src"] }')
+        .help().argv;
+    const projectPathArg = argv['project-path'];
+    const resolvedProjectPath = path.resolve(typeof projectPathArg === 'string' ? projectPathArg : '.');
+    const resolvedOutputDir = path.resolve(argv.output ?? path.join(resolvedProjectPath, '.messenger-docs'));
+    const scanDirs = await resolveScanDirs(resolvedProjectPath, argv['scan-dir']);
+    // Step 1: Generate docs
+    await generate({
+        projectPath: resolvedProjectPath,
+        outputDir: resolvedOutputDir,
+        scanDirs,
+    });
+    // Step 2: If --build, --serve, or --dev, set up and run Docusaurus
+    if (argv.build || argv.serve || argv.dev) {
+        await setupSite(resolvedOutputDir);
+        if (argv.dev) {
+            console.log('\nStarting dev server...');
+            await runDocusaurus('start', resolvedOutputDir);
+        }
+        else if (argv.build || argv.serve) {
+            console.log('\nBuilding static site...');
+            await runDocusaurus('build', resolvedOutputDir);
+            if (argv.serve) {
+                console.log('\nServing static site...');
+                await runDocusaurus('serve', resolvedOutputDir);
+            }
+        }
+    }
+}
+/**
+ * Recursively copy a directory, skipping specified directory names.
+ *
+ * @param src - Source directory.
+ * @param dest - Destination directory.
+ * @param skip - Set of directory names to skip.
+ */
+async function copyDir(src, dest, skip) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (skip.has(entry.name)) {
+            continue;
+        }
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath, skip);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.mjs.map

package/dist/docs/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sourceRoot":"","sources":["../../src/docs/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,OAAO,MAAK,uBAAc;;AAC1B,OAAO,KAAK,EAAE,yBAAyB;AACvC,OAAO,KAAK,IAAI,kBAAkB;AAClC,OAAO,KAAK,cAAc;AAE1B,OAAO,EAAE,QAAQ,EAAE,uBAAmB;AAEtC;;;;;GAKG;AACH,SAAS,iBAAiB;IACxB,MAAM,GAAG,oBAAmB,qCAAqC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,GAAW;IACvD,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACjD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE;QAC5C,GAAG;QACH,KAAK,EAAE,SAAS;QAChB,4CAA4C;QAC5C,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,SAAS,CAAC,MAAc;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,8BAAY,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/C,OAAO,CAAC,GAAG,CAAC,mCAAmC,MAAM,KAAK,CAAC,CAAC;IAE5D,MAAM,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAEzC,8EAA8E;IAC9E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,SAAS,CAChB,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe,CAC5B,WAAmB,EACnB,WAAqB;IAErB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAC9B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EACtC,MAAM,CACP,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;QAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAwC,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC5C,OAAO,CACN,mBAAmB,EACnB,uEAAuE,EACvE,CAAC,aAAa,EAAE,EAAE;QAChB,aAAa,CAAC,UAAU,CAAC,cAAc,EAAE;YACvC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6BAA6B;YAC1C,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;IACL,CAAC,CACF;SACA,MAAM,CAAC,OAAO,EAAE;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,6CAA6C;QAC1D,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,uCAAuC;QACpD,OAAO,EAAE,EAAc;KACxB,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kBAAkB;KAChC,CAAC;SACD,QAAQ,CACP,gHAAgH,CACjH;SACA,IAAI,EAAE,CAAC,IAAI,CAAC;IAEf,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CACtC,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAC1D,CAAC;IACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CACpC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CACjE,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,mBAAmB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE9E,wBAAwB;IACxB,MAAM,QAAQ,CAAC;QACb,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;QAC5B,QAAQ;KACT,CAAC,CAAC;IAEH,mEAAmE;IACnE,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAEnC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACxC,MAAM,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,MAAM,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAEhD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,MAAM,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,OAAO,CACpB,GAAW,EACX,IAAY,EACZ,IAAiB;IAEjB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport execa from 'execa';\nimport * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport yargs from 'yargs';\n\nimport { generate } from './generate';\n\n/**\n * Resolve the path to the docusaurus CLI binary and the node_modules\n * directory that contains the Docusaurus packages.\n *\n * @returns The docusaurus binary path and the node_modules directory.\n */\nfunction resolveDocusaurus(): { bin: string; nodeModules: string } {\n  const bin = require.resolve('@docusaurus/core/bin/docusaurus.mjs');\n  const coreDir = path.dirname(path.dirname(bin));\n  const nodeModules = path.dirname(path.dirname(coreDir));\n  return { bin, nodeModules };\n}\n\n/**\n * Run a Docusaurus command.\n *\n * @param command - The docusaurus command (start, build, serve).\n * @param cwd - The site directory.\n */\nasync function runDocusaurus(command: string, cwd: string): Promise<void> {\n  const { bin, nodeModules } = resolveDocusaurus();\n  await execa(process.execPath, [bin, command], {\n    cwd,\n    stdio: 'inherit',\n    // eslint-disable-next-line n/no-process-env\n    env: { ...process.env, NODE_PATH: nodeModules },\n  });\n}\n\n/**\n * Copy template files into the output directory using fs.cp with filtering.\n *\n * @param outDir - The output directory to set up.\n */\nasync function setupSite(outDir: string): Promise<void> {\n  const templateDir = path.resolve(__dirname, '..', '..', 'template');\n  const skip = new Set(['node_modules', 'docs']);\n\n  console.log(`\\nSetting up Docusaurus site in ${outDir}...`);\n\n  await copyDir(templateDir, outDir, skip);\n\n  // Write a minimal package.json so Docusaurus doesn't warn about a missing one\n  const pkgJsonPath = path.join(outDir, 'package.json');\n  try {\n    await fs.access(pkgJsonPath);\n  } catch {\n    await fs.writeFile(\n      pkgJsonPath,\n      JSON.stringify({ name: 'messenger-docs-site', private: true }, null, 2),\n    );\n  }\n}\n\n/**\n * Resolve scanDirs from CLI args, package.json config, or default.\n *\n * @param projectPath - The project root path.\n * @param cliScanDirs - Scan dirs provided via CLI flags.\n * @returns Resolved scan directories.\n */\nasync function resolveScanDirs(\n  projectPath: string,\n  cliScanDirs: string[],\n): Promise<string[]> {\n  if (cliScanDirs.length > 0) {\n    return cliScanDirs;\n  }\n\n  try {\n    const pkgRaw = await fs.readFile(\n      path.join(projectPath, 'package.json'),\n      'utf8',\n    );\n    const pkg = JSON.parse(pkgRaw) as Record<string, unknown>;\n    const config = pkg['messenger-docs'] as { scanDirs?: string[] } | undefined;\n    if (Array.isArray(config?.scanDirs)) {\n      return config.scanDirs;\n    }\n  } catch {\n    // No package.json or invalid — use default.\n  }\n\n  return ['src'];\n}\n\n/**\n * Main CLI entry point.\n */\nasync function main(): Promise<void> {\n  const argv = await yargs(process.argv.slice(2))\n    .command(\n      '$0 [project-path]',\n      'Generate Messenger API documentation for MetaMask controller packages',\n      (yargsInstance) => {\n        yargsInstance.positional('project-path', {\n          type: 'string',\n          description: 'Path to the project to scan',\n          default: '.',\n        });\n      },\n    )\n    .option('build', {\n      type: 'boolean',\n      description: 'Generate docs and build static site',\n      default: false,\n    })\n    .option('serve', {\n      type: 'boolean',\n      description: 'Generate docs, build, and serve static site',\n      default: false,\n    })\n    .option('dev', {\n      type: 'boolean',\n      description: 'Generate docs and start dev server with hot reload',\n      default: false,\n    })\n    .option('scan-dir', {\n      type: 'string',\n      array: true,\n      description: 'Source directory to scan (repeatable)',\n      default: [] as string[],\n    })\n    .option('output', {\n      type: 'string',\n      description: 'Output directory',\n    })\n    .epilogue(\n      'Source directories can also be configured in package.json:\\n  \"messenger-docs\": { \"scanDirs\": [\"app\", \"src\"] }',\n    )\n    .help().argv;\n\n  const projectPathArg = argv['project-path'];\n  const resolvedProjectPath = path.resolve(\n    typeof projectPathArg === 'string' ? projectPathArg : '.',\n  );\n  const resolvedOutputDir = path.resolve(\n    argv.output ?? path.join(resolvedProjectPath, '.messenger-docs'),\n  );\n  const scanDirs = await resolveScanDirs(resolvedProjectPath, argv['scan-dir']);\n\n  // Step 1: Generate docs\n  await generate({\n    projectPath: resolvedProjectPath,\n    outputDir: resolvedOutputDir,\n    scanDirs,\n  });\n\n  // Step 2: If --build, --serve, or --dev, set up and run Docusaurus\n  if (argv.build || argv.serve || argv.dev) {\n    await setupSite(resolvedOutputDir);\n\n    if (argv.dev) {\n      console.log('\\nStarting dev server...');\n      await runDocusaurus('start', resolvedOutputDir);\n    } else if (argv.build || argv.serve) {\n      console.log('\\nBuilding static site...');\n      await runDocusaurus('build', resolvedOutputDir);\n\n      if (argv.serve) {\n        console.log('\\nServing static site...');\n        await runDocusaurus('serve', resolvedOutputDir);\n      }\n    }\n  }\n}\n\n/**\n * Recursively copy a directory, skipping specified directory names.\n *\n * @param src - Source directory.\n * @param dest - Destination directory.\n * @param skip - Set of directory names to skip.\n */\nasync function copyDir(\n  src: string,\n  dest: string,\n  skip: Set<string>,\n): Promise<void> {\n  await fs.mkdir(dest, { recursive: true });\n  const entries = await fs.readdir(src, { withFileTypes: true });\n\n  for (const entry of entries) {\n    if (skip.has(entry.name)) {\n      continue;\n    }\n    const srcPath = path.join(src, entry.name);\n    const destPath = path.join(dest, entry.name);\n\n    if (entry.isDirectory()) {\n      await copyDir(srcPath, destPath, skip);\n    } else {\n      await fs.copyFile(srcPath, destPath);\n    }\n  }\n}\n\nmain().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\n});\n"]}

package/dist/docs/discovery.cjs

@@ -0,0 +1,93 @@
+"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.findDtsFiles = exports.findTsFiles = void 0;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    '__tests__',
+    'tests',
+    'test',
+    '__mocks__',
+]);
+const SKIP_SUFFIXES = ['.test.ts', '.test-d.ts', '.spec.ts', '.d.ts'];
+/**
+ * Find all non-test TypeScript source files in a directory.
+ * Skips node_modules, dist, test directories, and declaration files.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+async function findTsFiles(dir) {
+    const results = [];
+    async function walk(directory) {
+        const entries = await fs.readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name)) {
+                    await walk(fullPath);
+                }
+            }
+            else if (entry.name.endsWith('.ts') &&
+                !SKIP_SUFFIXES.some((suffix) => entry.name.endsWith(suffix))) {
+                results.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    return results;
+}
+exports.findTsFiles = findTsFiles;
+/**
+ * Find all `.d.cts` declaration files in a directory.
+ * Skips nested node_modules subdirectories.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+async function findDtsFiles(dir) {
+    const results = [];
+    async function walk(directory) {
+        const entries = await fs.readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name !== 'node_modules') {
+                    await walk(fullPath);
+                }
+            }
+            else if (entry.name.endsWith('.d.cts')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    return results;
+}
+exports.findDtsFiles = findDtsFiles;
+//# sourceMappingURL=discovery.cjs.map

package/dist/docs/discovery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.cjs","sourceRoot":"","sources":["../../src/docs/discovery.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAuC;AACvC,gDAAkC;AAElC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc;IACd,MAAM;IACN,WAAW;IACX,OAAO;IACP,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAEtE;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,IAAI,CAAC,SAAiB;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IACL,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC1B,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC5D,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAtBD,kCAsBC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,IAAI,CAAC,SAAiB;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAnBD,oCAmBC","sourcesContent":["import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\n\nconst SKIP_DIRS = new Set([\n  'node_modules',\n  'dist',\n  '__tests__',\n  'tests',\n  'test',\n  '__mocks__',\n]);\n\nconst SKIP_SUFFIXES = ['.test.ts', '.test-d.ts', '.spec.ts', '.d.ts'];\n\n/**\n * Find all non-test TypeScript source files in a directory.\n * Skips node_modules, dist, test directories, and declaration files.\n *\n * @param dir - The directory to search.\n * @returns A promise that resolves to an array of absolute file paths.\n */\nexport async function findTsFiles(dir: string): Promise<string[]> {\n  const results: string[] = [];\n\n  async function walk(directory: string): Promise<void> {\n    const entries = await fs.readdir(directory, { withFileTypes: true });\n    for (const entry of entries) {\n      const fullPath = path.join(directory, entry.name);\n      if (entry.isDirectory()) {\n        if (!SKIP_DIRS.has(entry.name)) {\n          await walk(fullPath);\n        }\n      } else if (\n        entry.name.endsWith('.ts') &&\n        !SKIP_SUFFIXES.some((suffix) => entry.name.endsWith(suffix))\n      ) {\n        results.push(fullPath);\n      }\n    }\n  }\n\n  await walk(dir);\n  return results;\n}\n\n/**\n * Find all `.d.cts` declaration files in a directory.\n * Skips nested node_modules subdirectories.\n *\n * @param dir - The directory to search.\n * @returns A promise that resolves to an array of absolute file paths.\n */\nexport async function findDtsFiles(dir: string): Promise<string[]> {\n  const results: string[] = [];\n\n  async function walk(directory: string): Promise<void> {\n    const entries = await fs.readdir(directory, { withFileTypes: true });\n    for (const entry of entries) {\n      const fullPath = path.join(directory, entry.name);\n      if (entry.isDirectory()) {\n        if (entry.name !== 'node_modules') {\n          await walk(fullPath);\n        }\n      } else if (entry.name.endsWith('.d.cts')) {\n        results.push(fullPath);\n      }\n    }\n  }\n\n  await walk(dir);\n  return results;\n}\n"]}

package/dist/docs/discovery.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Find all non-test TypeScript source files in a directory.
+ * Skips node_modules, dist, test directories, and declaration files.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+export declare function findTsFiles(dir: string): Promise<string[]>;
+/**
+ * Find all `.d.cts` declaration files in a directory.
+ * Skips nested node_modules subdirectories.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+export declare function findDtsFiles(dir: string): Promise<string[]>;
+//# sourceMappingURL=discovery.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.cts","sourceRoot":"","sources":["../../src/docs/discovery.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjE"}

package/dist/docs/discovery.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Find all non-test TypeScript source files in a directory.
+ * Skips node_modules, dist, test directories, and declaration files.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+export declare function findTsFiles(dir: string): Promise<string[]>;
+/**
+ * Find all `.d.cts` declaration files in a directory.
+ * Skips nested node_modules subdirectories.
+ *
+ * @param dir - The directory to search.
+ * @returns A promise that resolves to an array of absolute file paths.
+ */
+export declare function findDtsFiles(dir: string): Promise<string[]>;
+//# sourceMappingURL=discovery.d.mts.map

package/dist/docs/discovery.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.mts","sourceRoot":"","sources":["../../src/docs/discovery.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjE"}