foresthouse 1.0.0-dev.13 → 1.0.0-dev.15

package/README.md

@@ -65,9 +65,12 @@ src/main.ts
 `react` command:
 
 - `foresthouse react <path>`: print a React usage tree from an entry file
+- `foresthouse react --nextjs`: infer Next.js page entries from `app/`, `pages/`, `src/app/`, and `src/pages/`
 - `--cwd <path>`: working directory for resolving the entry file and config
 - `--config <path>`: use a specific `tsconfig.json` or `jsconfig.json`
-- `--filter <component|hook>`: limit the output to a specific React symbol kind
+- `--nextjs`: allow omitting the explicit React entry file and discover Next.js page entries relative to `--cwd` or the current directory
+- `--filter <component|hook|builtin>`: limit the output to a specific React symbol kind
+- `--builtin`: include built-in HTML nodes such as `button` and `div`
 - `--no-workspaces`: stop at sibling workspace package boundaries instead of expanding them
 - `--project-only`: restrict traversal to the active `tsconfig.json` or `jsconfig.json` project
 - `--json`: print a JSON tree instead of ASCII output

package/dist/cli.mjs

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-import { c as analyzeReactUsage, i as printDependencyTree, l as analyzeDependencies, n as graphToSerializableTree, r as printReactUsageTree, t as graphToSerializableReactTree } from "./react-a7ugf8JN.mjs";
+import { c as analyzeReactUsage, i as printDependencyTree, l as analyzeDependencies, n as graphToSerializableTree, r as printReactUsageTree, t as graphToSerializableReactTree, u as isSourceCodeFile } from "./react-B0frvTuH.mjs";
 import { createRequire } from "node:module";
+import path from "node:path";
+import fs from "node:fs";
 import process$1 from "node:process";
 import { cac } from "cac";
 //#region src/commands/base.ts
@@ -46,10 +48,71 @@ var ImportCommand = class extends BaseCommand {
 	}
 };
 //#endregion
+//#region src/app/react-entry-files.ts
+const NEXT_JS_ENTRY_ROOTS = [
+	"pages",
+	"app",
+	path.join("src", "pages"),
+	path.join("src", "app")
+];
+function resolveReactEntryFiles(options) {
+	if (options.entryFile !== void 0) return [options.entryFile];
+	if (!options.nextjs) throw new Error("Missing React entry file. Use `foresthouse react <entry-file>` or `foresthouse react --nextjs`.");
+	return discoverNextJsPageEntries(options.cwd);
+}
+function discoverNextJsPageEntries(cwd) {
+	const effectiveCwd = path.resolve(cwd ?? process.cwd());
+	const entries = /* @__PURE__ */ new Set();
+	collectPagesRouterEntries(path.join(effectiveCwd, "pages"), effectiveCwd, entries);
+	collectAppRouterEntries(path.join(effectiveCwd, "app"), effectiveCwd, entries);
+	collectPagesRouterEntries(path.join(effectiveCwd, "src", "pages"), effectiveCwd, entries);
+	collectAppRouterEntries(path.join(effectiveCwd, "src", "app"), effectiveCwd, entries);
+	const resolvedEntries = [...entries].sort();
+	if (resolvedEntries.length > 0) return resolvedEntries;
+	const searchedRoots = NEXT_JS_ENTRY_ROOTS.map((root) => `\`${root}/\``).join(", ");
+	throw new Error(`No Next.js page entries found. Searched ${searchedRoots} relative to ${effectiveCwd}.`);
+}
+function collectPagesRouterEntries(rootDirectory, cwd, entries) {
+	walkDirectory(rootDirectory, (filePath, relativePath) => {
+		if (!isSourceCodeFile(filePath) || filePath.endsWith(".d.ts")) return;
+		if (relativePath.split(path.sep)[0] === "api") return;
+		if (path.basename(filePath).startsWith("_")) return;
+		entries.add(path.relative(cwd, filePath));
+	});
+}
+function collectAppRouterEntries(rootDirectory, cwd, entries) {
+	walkDirectory(rootDirectory, (filePath) => {
+		if (!isSourceCodeFile(filePath) || filePath.endsWith(".d.ts")) return;
+		const extension = path.extname(filePath);
+		if (path.basename(filePath, extension) !== "page") return;
+		entries.add(path.relative(cwd, filePath));
+	});
+}
+function walkDirectory(rootDirectory, visitor) {
+	if (!fs.existsSync(rootDirectory)) return;
+	const stack = [rootDirectory];
+	while (stack.length > 0) {
+		const directory = stack.pop();
+		if (directory === void 0) continue;
+		const directoryEntries = fs.readdirSync(directory, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
+		for (let index = directoryEntries.length - 1; index >= 0; index -= 1) {
+			const entry = directoryEntries[index];
+			if (entry === void 0) continue;
+			const entryPath = path.join(directory, entry.name);
+			if (entry.isDirectory()) {
+				stack.push(entryPath);
+				continue;
+			}
+			if (!entry.isFile()) continue;
+			visitor(entryPath, path.relative(rootDirectory, entryPath));
+		}
+	}
+}
+//#endregion
 //#region src/commands/react.ts
 var ReactCommand = class extends BaseCommand {
 	analyze() {
-		return analyzeReactUsage(this.options.entryFile, this.getAnalyzeOptions());
+		return analyzeReactUsage(resolveReactEntryFiles(this.options), this.getAnalyzeOptions());
 	}
 	serialize(graph) {
 		return graphToSerializableReactTree(graph, { filter: this.getFilter() });
@@ -60,6 +123,12 @@ var ReactCommand = class extends BaseCommand {
 			filter: this.getFilter()
 		});
 	}
+	getAnalyzeOptions() {
+		return {
+			...super.getAnalyzeOptions(),
+			includeBuiltins: this.options.includeBuiltins
+		};
+	}
 	getFilter() {
 		return this.options.filter;
 	}
@@ -111,7 +180,7 @@ var CliMain = class {
 		cli.command("import [entry-file]", "Analyze an entry file and print its dependency tree.").usage("import <entry-file> [options]").option("--entry <path>", "Entry file to analyze.").option("--cwd <path>", "Working directory used for relative paths.").option("--config <path>", "Explicit tsconfig.json or jsconfig.json path.").option("--include-externals", "Include packages and Node built-ins in the tree.").option("--no-workspaces", "Do not expand sibling workspace packages into source subtrees.").option("--project-only", "Restrict traversal to the active tsconfig.json or jsconfig.json project.").option("--no-unused", "Omit imports that are never referenced.").option("--json", "Print the dependency tree as JSON.").action((entryFile, rawOptions) => {
 			runCli(normalizeImportCliOptions(entryFile, rawOptions));
 		});
-		cli.command("react <entry-file>", "Analyze React usage from an entry file.").usage("react <entry-file> [options]").option("--cwd <path>", "Working directory used for relative paths.").option("--config <path>", "Explicit tsconfig.json or jsconfig.json path.").option("--filter <mode>", "Limit output to `component` or `hook` usages.").option("--no-workspaces", "Do not expand sibling workspace packages into source subtrees.").option("--project-only", "Restrict traversal to the active tsconfig.json or jsconfig.json project.").option("--json", "Print the React usage tree as JSON.").action((entryFile, rawOptions) => {
+		cli.command("react [entry-file]", "Analyze React usage from an entry file.").usage("react [entry-file] [options]").option("--cwd <path>", "Working directory used for relative paths.").option("--config <path>", "Explicit tsconfig.json or jsconfig.json path.").option("--nextjs", "Infer Next.js page entries from app/ and pages/ when no entry is provided.").option("--filter <mode>", "Limit output to `component`, `hook`, or `builtin` usages.").option("--builtin", "Include built-in HTML nodes in the React tree.").option("--no-workspaces", "Do not expand sibling workspace packages into source subtrees.").option("--project-only", "Restrict traversal to the active tsconfig.json or jsconfig.json project.").option("--json", "Print the React usage tree as JSON.").action((entryFile, rawOptions) => {
 			runCli(normalizeReactCliOptions(entryFile, rawOptions));
 		});
 		cli.help();
@@ -151,13 +220,15 @@ function normalizeImportCliOptions(entryFile, options) {
 function normalizeReactCliOptions(entryFile, options) {
 	return {
 		command: "react",
-		entryFile,
+		entryFile: resolveReactEntryFile(entryFile, options.nextjs),
 		cwd: options.cwd,
 		configPath: options.config,
 		expandWorkspaces: options.workspaces !== false,
 		projectOnly: options.projectOnly === true,
 		json: options.json === true,
-		filter: normalizeReactFilter(options.filter)
+		filter: normalizeReactFilter(options.filter),
+		nextjs: options.nextjs === true,
+		includeBuiltins: options.builtin === true
 	};
 }
 function resolveImportEntryFile(positionalEntryFile, optionEntryFile) {
@@ -168,9 +239,14 @@ function resolveImportEntryFile(positionalEntryFile, optionEntryFile) {
 }
 function normalizeReactFilter(filter) {
 	if (filter === void 0) return "all";
-	if (filter === "component" || filter === "hook") return filter;
+	if (filter === "component" || filter === "hook" || filter === "builtin") return filter;
 	throw new Error(`Unknown React filter: ${filter}`);
 }
+function resolveReactEntryFile(entryFile, nextjs) {
+	if (entryFile !== void 0) return entryFile;
+	if (nextjs === true) return;
+	throw new Error("Missing React entry file. Use `foresthouse react <entry-file>` or `foresthouse react --nextjs`.");
+}
 //#endregion
 //#region src/cli.ts
 const { version } = createRequire(import.meta.url)("../package.json");

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":["process"],"sources":["../src/commands/base.ts","../src/commands/import.ts","../src/commands/react.ts","../src/app/run.ts","../src/app/cli.ts","../src/cli.ts"],"sourcesContent":["import type { CliOptions } from '../app/args.js'\nimport type { AnalyzeOptions } from '../types/analyze-options.js'\n\nexport abstract class BaseCommand<\n  TGraph,\n  TOptions extends CliOptions = CliOptions,\n> {\n  constructor(protected readonly options: TOptions) {}\n\n  run(): void {\n    const graph = this.analyze()\n\n    if (this.isJsonMode()) {\n      process.stdout.write(\n        `${JSON.stringify(this.serialize(graph), null, 2)}\\n`,\n      )\n      return\n    }\n\n    process.stdout.write(`${this.render(graph)}\\n`)\n  }\n\n  protected isJsonMode(): boolean {\n    return this.options.json\n  }\n\n  protected getAnalyzeOptions(): AnalyzeOptions {\n    return {\n      ...(this.options.cwd === undefined ? {} : { cwd: this.options.cwd }),\n      ...(this.options.configPath === undefined\n        ? {}\n        : { configPath: this.options.configPath }),\n      expandWorkspaces: this.options.expandWorkspaces,\n      projectOnly: this.options.projectOnly,\n    }\n  }\n\n  protected abstract analyze(): TGraph\n  protected abstract serialize(graph: TGraph): object\n  protected abstract render(graph: TGraph): string\n}\n","import { analyzeDependencies } from '../analyzers/import/index.js'\nimport type { ImportCliOptions } from '../app/args.js'\nimport { printDependencyTree } from '../output/ascii/import.js'\nimport { graphToSerializableTree } from '../output/json/import.js'\nimport type { DependencyGraph } from '../types/dependency-graph.js'\nimport { BaseCommand } from './base.js'\n\nexport class ImportCommand extends BaseCommand<\n  DependencyGraph,\n  ImportCliOptions\n> {\n  protected analyze(): DependencyGraph {\n    return analyzeDependencies(this.options.entryFile, this.getAnalyzeOptions())\n  }\n\n  protected serialize(graph: DependencyGraph): object {\n    return graphToSerializableTree(graph, {\n      omitUnused: this.options.omitUnused,\n    })\n  }\n\n  protected render(graph: DependencyGraph): string {\n    return printDependencyTree(graph, {\n      cwd: this.options.cwd ?? graph.cwd,\n      includeExternals: this.options.includeExternals,\n      omitUnused: this.options.omitUnused,\n    })\n  }\n}\n","import { analyzeReactUsage } from '../analyzers/react/index.js'\nimport type { ReactCliOptions } from '../app/args.js'\nimport { printReactUsageTree } from '../output/ascii/react.js'\nimport { graphToSerializableReactTree } from '../output/json/react.js'\nimport type { ReactUsageFilter } from '../types/react-usage-filter.js'\nimport type { ReactUsageGraph } from '../types/react-usage-graph.js'\nimport { BaseCommand } from './base.js'\n\nexport class ReactCommand extends BaseCommand<\n  ReactUsageGraph,\n  ReactCliOptions\n> {\n  protected analyze(): ReactUsageGraph {\n    return analyzeReactUsage(this.options.entryFile, this.getAnalyzeOptions())\n  }\n\n  protected serialize(graph: ReactUsageGraph): object {\n    return graphToSerializableReactTree(graph, {\n      filter: this.getFilter(),\n    })\n  }\n\n  protected render(graph: ReactUsageGraph): string {\n    return printReactUsageTree(graph, {\n      cwd: this.options.cwd ?? graph.cwd,\n      filter: this.getFilter(),\n    })\n  }\n\n  private getFilter(): ReactUsageFilter {\n    return this.options.filter\n  }\n}\n","import { ImportCommand } from '../commands/import.js'\nimport { ReactCommand } from '../commands/react.js'\nimport type { CliOptions } from './args.js'\n\nexport function runCli(options: CliOptions): void {\n  new CliApplication(options).run()\n}\n\nclass CliApplication {\n  constructor(private readonly options: CliOptions) {}\n\n  run(): void {\n    this.createCommand().run()\n  }\n\n  private createCommand(): {\n    run(): void\n  } {\n    if (this.options.command === 'react') {\n      return new ReactCommand(this.options)\n    }\n\n    return new ImportCommand(this.options)\n  }\n}\n","import process from 'node:process'\n\nimport { cac } from 'cac'\n\nimport type { ReactUsageFilter } from '../types/react-usage-filter.js'\nimport type { ImportCliOptions, ReactCliOptions } from './args.js'\nimport { runCli } from './run.js'\n\nexport function main(version: string, argv = process.argv.slice(2)): void {\n  new CliMain(version, argv).run()\n}\n\nclass CliMain {\n  constructor(\n    private readonly version: string,\n    private readonly argv: string[],\n  ) {}\n\n  run(): void {\n    try {\n      const cli = this.createCli()\n\n      if (this.argv.length === 0) {\n        cli.outputHelp()\n        return\n      }\n\n      this.validateCommandSyntax()\n      cli.parse(this.toProcessArgv())\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : 'Unknown error occurred.'\n      process.stderr.write(`foresthouse: ${message}\\n`)\n      process.exitCode = 1\n    }\n  }\n\n  private createCli() {\n    const cli = cac('foresthouse')\n\n    cli\n      .command(\n        'import [entry-file]',\n        'Analyze an entry file and print its dependency tree.',\n      )\n      .usage('import <entry-file> [options]')\n      .option('--entry <path>', 'Entry file to analyze.')\n      .option('--cwd <path>', 'Working directory used for relative paths.')\n      .option(\n        '--config <path>',\n        'Explicit tsconfig.json or jsconfig.json path.',\n      )\n      .option(\n        '--include-externals',\n        'Include packages and Node built-ins in the tree.',\n      )\n      .option(\n        '--no-workspaces',\n        'Do not expand sibling workspace packages into source subtrees.',\n      )\n      .option(\n        '--project-only',\n        'Restrict traversal to the active tsconfig.json or jsconfig.json project.',\n      )\n      .option('--no-unused', 'Omit imports that are never referenced.')\n      .option('--json', 'Print the dependency tree as JSON.')\n      .action(\n        (entryFile: string | undefined, rawOptions: ParsedImportCliOptions) => {\n          runCli(normalizeImportCliOptions(entryFile, rawOptions))\n        },\n      )\n\n    cli\n      .command('react <entry-file>', 'Analyze React usage from an entry file.')\n      .usage('react <entry-file> [options]')\n      .option('--cwd <path>', 'Working directory used for relative paths.')\n      .option(\n        '--config <path>',\n        'Explicit tsconfig.json or jsconfig.json path.',\n      )\n      .option(\n        '--filter <mode>',\n        'Limit output to `component` or `hook` usages.',\n      )\n      .option(\n        '--no-workspaces',\n        'Do not expand sibling workspace packages into source subtrees.',\n      )\n      .option(\n        '--project-only',\n        'Restrict traversal to the active tsconfig.json or jsconfig.json project.',\n      )\n      .option('--json', 'Print the React usage tree as JSON.')\n      .action((entryFile: string, rawOptions: ParsedReactCliOptions) => {\n        runCli(normalizeReactCliOptions(entryFile, rawOptions))\n      })\n\n    cli.help()\n    cli.version(this.version)\n\n    return cli\n  }\n\n  private validateCommandSyntax(): void {\n    if (this.argv.length === 0) {\n      return\n    }\n\n    const firstArgument = this.argv[0]\n\n    if (firstArgument === undefined) {\n      return\n    }\n\n    if (firstArgument === '--react' || firstArgument.startsWith('--react=')) {\n      throw new Error('Unknown option `--react`')\n    }\n\n    if (firstArgument.startsWith('-')) {\n      return\n    }\n\n    if (firstArgument === 'import' || firstArgument === 'react') {\n      return\n    }\n\n    throw new Error(`Unknown command \\`${firstArgument}\\``)\n  }\n\n  private toProcessArgv(): string[] {\n    return ['node', 'foresthouse', ...this.argv]\n  }\n}\n\ninterface ParsedBaseCliOptions {\n  readonly cwd?: string\n  readonly config?: string\n  readonly workspaces?: boolean\n  readonly projectOnly?: boolean\n  readonly json?: boolean\n}\n\ninterface ParsedImportCliOptions extends ParsedBaseCliOptions {\n  readonly entry?: string\n  readonly includeExternals?: boolean\n  readonly unused?: boolean\n}\n\ninterface ParsedReactCliOptions extends ParsedBaseCliOptions {\n  readonly filter?: string\n}\n\nfunction normalizeImportCliOptions(\n  entryFile: string | undefined,\n  options: ParsedImportCliOptions,\n): ImportCliOptions {\n  return {\n    command: 'import',\n    entryFile: resolveImportEntryFile(entryFile, options.entry),\n    cwd: options.cwd,\n    configPath: options.config,\n    expandWorkspaces: options.workspaces !== false,\n    projectOnly: options.projectOnly === true,\n    includeExternals: options.includeExternals === true,\n    omitUnused: options.unused === false,\n    json: options.json === true,\n  }\n}\n\nfunction normalizeReactCliOptions(\n  entryFile: string,\n  options: ParsedReactCliOptions,\n): ReactCliOptions {\n  return {\n    command: 'react',\n    entryFile,\n    cwd: options.cwd,\n    configPath: options.config,\n    expandWorkspaces: options.workspaces !== false,\n    projectOnly: options.projectOnly === true,\n    json: options.json === true,\n    filter: normalizeReactFilter(options.filter),\n  }\n}\n\nfunction resolveImportEntryFile(\n  positionalEntryFile: string | undefined,\n  optionEntryFile: string | undefined,\n): string {\n  if (\n    positionalEntryFile !== undefined &&\n    optionEntryFile !== undefined &&\n    positionalEntryFile !== optionEntryFile\n  ) {\n    throw new Error(\n      'Provide the import entry only once, either as `foresthouse import <entry-file>` or `foresthouse import --entry <path>`.',\n    )\n  }\n\n  const resolvedEntryFile = positionalEntryFile ?? optionEntryFile\n\n  if (resolvedEntryFile === undefined) {\n    throw new Error(\n      'Missing import entry file. Use `foresthouse import <entry-file>` or `foresthouse import --entry <path>`.',\n    )\n  }\n\n  return resolvedEntryFile\n}\n\nfunction normalizeReactFilter(\n  filter: ParsedReactCliOptions['filter'],\n): ReactUsageFilter {\n  if (filter === undefined) {\n    return 'all'\n  }\n\n  if (filter === 'component' || filter === 'hook') {\n    return filter\n  }\n\n  throw new Error(`Unknown React filter: ${filter}`)\n}\n","#!/usr/bin/env node\n\nimport { createRequire } from 'node:module'\n\nimport { main } from './app/cli.js'\n\nconst require = createRequire(import.meta.url)\nconst { version } = require('../package.json') as { version: string }\n\nmain(version)\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":["process"],"sources":["../src/commands/base.ts","../src/commands/import.ts","../src/app/react-entry-files.ts","../src/commands/react.ts","../src/app/run.ts","../src/app/cli.ts","../src/cli.ts"],"sourcesContent":["import type { CliOptions } from '../app/args.js'\nimport type { AnalyzeOptions } from '../types/analyze-options.js'\n\nexport abstract class BaseCommand<\n  TGraph,\n  TOptions extends CliOptions = CliOptions,\n> {\n  constructor(protected readonly options: TOptions) {}\n\n  run(): void {\n    const graph = this.analyze()\n\n    if (this.isJsonMode()) {\n      process.stdout.write(\n        `${JSON.stringify(this.serialize(graph), null, 2)}\\n`,\n      )\n      return\n    }\n\n    process.stdout.write(`${this.render(graph)}\\n`)\n  }\n\n  protected isJsonMode(): boolean {\n    return this.options.json\n  }\n\n  protected getAnalyzeOptions(): AnalyzeOptions {\n    return {\n      ...(this.options.cwd === undefined ? {} : { cwd: this.options.cwd }),\n      ...(this.options.configPath === undefined\n        ? {}\n        : { configPath: this.options.configPath }),\n      expandWorkspaces: this.options.expandWorkspaces,\n      projectOnly: this.options.projectOnly,\n    }\n  }\n\n  protected abstract analyze(): TGraph\n  protected abstract serialize(graph: TGraph): object\n  protected abstract render(graph: TGraph): string\n}\n","import { analyzeDependencies } from '../analyzers/import/index.js'\nimport type { ImportCliOptions } from '../app/args.js'\nimport { printDependencyTree } from '../output/ascii/import.js'\nimport { graphToSerializableTree } from '../output/json/import.js'\nimport type { DependencyGraph } from '../types/dependency-graph.js'\nimport { BaseCommand } from './base.js'\n\nexport class ImportCommand extends BaseCommand<\n  DependencyGraph,\n  ImportCliOptions\n> {\n  protected analyze(): DependencyGraph {\n    return analyzeDependencies(this.options.entryFile, this.getAnalyzeOptions())\n  }\n\n  protected serialize(graph: DependencyGraph): object {\n    return graphToSerializableTree(graph, {\n      omitUnused: this.options.omitUnused,\n    })\n  }\n\n  protected render(graph: DependencyGraph): string {\n    return printDependencyTree(graph, {\n      cwd: this.options.cwd ?? graph.cwd,\n      includeExternals: this.options.includeExternals,\n      omitUnused: this.options.omitUnused,\n    })\n  }\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { isSourceCodeFile } from '../utils/is-source-code-file.js'\nimport type { ReactCliOptions } from './args.js'\n\nconst NEXT_JS_ENTRY_ROOTS = [\n  'pages',\n  'app',\n  path.join('src', 'pages'),\n  path.join('src', 'app'),\n]\n\nexport function resolveReactEntryFiles(options: ReactCliOptions): string[] {\n  if (options.entryFile !== undefined) {\n    return [options.entryFile]\n  }\n\n  if (!options.nextjs) {\n    throw new Error(\n      'Missing React entry file. Use `foresthouse react <entry-file>` or `foresthouse react --nextjs`.',\n    )\n  }\n\n  return discoverNextJsPageEntries(options.cwd)\n}\n\nexport function discoverNextJsPageEntries(cwd?: string): string[] {\n  const effectiveCwd = path.resolve(cwd ?? process.cwd())\n  const entries = new Set<string>()\n\n  collectPagesRouterEntries(\n    path.join(effectiveCwd, 'pages'),\n    effectiveCwd,\n    entries,\n  )\n  collectAppRouterEntries(path.join(effectiveCwd, 'app'), effectiveCwd, entries)\n  collectPagesRouterEntries(\n    path.join(effectiveCwd, 'src', 'pages'),\n    effectiveCwd,\n    entries,\n  )\n  collectAppRouterEntries(\n    path.join(effectiveCwd, 'src', 'app'),\n    effectiveCwd,\n    entries,\n  )\n\n  const resolvedEntries = [...entries].sort()\n  if (resolvedEntries.length > 0) {\n    return resolvedEntries\n  }\n\n  const searchedRoots = NEXT_JS_ENTRY_ROOTS.map((root) => `\\`${root}/\\``).join(\n    ', ',\n  )\n  throw new Error(\n    `No Next.js page entries found. Searched ${searchedRoots} relative to ${effectiveCwd}.`,\n  )\n}\n\nfunction collectPagesRouterEntries(\n  rootDirectory: string,\n  cwd: string,\n  entries: Set<string>,\n): void {\n  walkDirectory(rootDirectory, (filePath, relativePath) => {\n    if (!isSourceCodeFile(filePath) || filePath.endsWith('.d.ts')) {\n      return\n    }\n\n    const segments = relativePath.split(path.sep)\n    if (segments[0] === 'api') {\n      return\n    }\n\n    const baseName = path.basename(filePath)\n    if (baseName.startsWith('_')) {\n      return\n    }\n\n    entries.add(path.relative(cwd, filePath))\n  })\n}\n\nfunction collectAppRouterEntries(\n  rootDirectory: string,\n  cwd: string,\n  entries: Set<string>,\n): void {\n  walkDirectory(rootDirectory, (filePath) => {\n    if (!isSourceCodeFile(filePath) || filePath.endsWith('.d.ts')) {\n      return\n    }\n\n    const extension = path.extname(filePath)\n    const baseName = path.basename(filePath, extension)\n    if (baseName !== 'page') {\n      return\n    }\n\n    entries.add(path.relative(cwd, filePath))\n  })\n}\n\nfunction walkDirectory(\n  rootDirectory: string,\n  visitor: (filePath: string, relativePath: string) => void,\n): void {\n  if (!fs.existsSync(rootDirectory)) {\n    return\n  }\n\n  const stack = [rootDirectory]\n\n  while (stack.length > 0) {\n    const directory = stack.pop()\n    if (directory === undefined) {\n      continue\n    }\n\n    const directoryEntries = fs\n      .readdirSync(directory, { withFileTypes: true })\n      .sort((left, right) => left.name.localeCompare(right.name))\n\n    for (let index = directoryEntries.length - 1; index >= 0; index -= 1) {\n      const entry = directoryEntries[index]\n      if (entry === undefined) {\n        continue\n      }\n\n      const entryPath = path.join(directory, entry.name)\n      if (entry.isDirectory()) {\n        stack.push(entryPath)\n        continue\n      }\n\n      if (!entry.isFile()) {\n        continue\n      }\n\n      visitor(entryPath, path.relative(rootDirectory, entryPath))\n    }\n  }\n}\n","import { analyzeReactUsage } from '../analyzers/react/index.js'\nimport type { ReactCliOptions } from '../app/args.js'\nimport { resolveReactEntryFiles } from '../app/react-entry-files.js'\nimport { printReactUsageTree } from '../output/ascii/react.js'\nimport { graphToSerializableReactTree } from '../output/json/react.js'\nimport type { AnalyzeOptions } from '../types/analyze-options.js'\nimport type { ReactUsageFilter } from '../types/react-usage-filter.js'\nimport type { ReactUsageGraph } from '../types/react-usage-graph.js'\nimport { BaseCommand } from './base.js'\n\nexport class ReactCommand extends BaseCommand<\n  ReactUsageGraph,\n  ReactCliOptions\n> {\n  protected analyze(): ReactUsageGraph {\n    return analyzeReactUsage(\n      resolveReactEntryFiles(this.options),\n      this.getAnalyzeOptions(),\n    )\n  }\n\n  protected serialize(graph: ReactUsageGraph): object {\n    return graphToSerializableReactTree(graph, {\n      filter: this.getFilter(),\n    })\n  }\n\n  protected render(graph: ReactUsageGraph): string {\n    return printReactUsageTree(graph, {\n      cwd: this.options.cwd ?? graph.cwd,\n      filter: this.getFilter(),\n    })\n  }\n\n  protected getAnalyzeOptions(): AnalyzeOptions {\n    return {\n      ...super.getAnalyzeOptions(),\n      includeBuiltins: this.options.includeBuiltins,\n    }\n  }\n\n  private getFilter(): ReactUsageFilter {\n    return this.options.filter\n  }\n}\n","import { ImportCommand } from '../commands/import.js'\nimport { ReactCommand } from '../commands/react.js'\nimport type { CliOptions } from './args.js'\n\nexport function runCli(options: CliOptions): void {\n  new CliApplication(options).run()\n}\n\nclass CliApplication {\n  constructor(private readonly options: CliOptions) {}\n\n  run(): void {\n    this.createCommand().run()\n  }\n\n  private createCommand(): {\n    run(): void\n  } {\n    if (this.options.command === 'react') {\n      return new ReactCommand(this.options)\n    }\n\n    return new ImportCommand(this.options)\n  }\n}\n","import process from 'node:process'\n\nimport { cac } from 'cac'\n\nimport type { ReactUsageFilter } from '../types/react-usage-filter.js'\nimport type { ImportCliOptions, ReactCliOptions } from './args.js'\nimport { runCli } from './run.js'\n\nexport function main(version: string, argv = process.argv.slice(2)): void {\n  new CliMain(version, argv).run()\n}\n\nclass CliMain {\n  constructor(\n    private readonly version: string,\n    private readonly argv: string[],\n  ) {}\n\n  run(): void {\n    try {\n      const cli = this.createCli()\n\n      if (this.argv.length === 0) {\n        cli.outputHelp()\n        return\n      }\n\n      this.validateCommandSyntax()\n      cli.parse(this.toProcessArgv())\n    } catch (error) {\n      const message =\n        error instanceof Error ? error.message : 'Unknown error occurred.'\n      process.stderr.write(`foresthouse: ${message}\\n`)\n      process.exitCode = 1\n    }\n  }\n\n  private createCli() {\n    const cli = cac('foresthouse')\n\n    cli\n      .command(\n        'import [entry-file]',\n        'Analyze an entry file and print its dependency tree.',\n      )\n      .usage('import <entry-file> [options]')\n      .option('--entry <path>', 'Entry file to analyze.')\n      .option('--cwd <path>', 'Working directory used for relative paths.')\n      .option(\n        '--config <path>',\n        'Explicit tsconfig.json or jsconfig.json path.',\n      )\n      .option(\n        '--include-externals',\n        'Include packages and Node built-ins in the tree.',\n      )\n      .option(\n        '--no-workspaces',\n        'Do not expand sibling workspace packages into source subtrees.',\n      )\n      .option(\n        '--project-only',\n        'Restrict traversal to the active tsconfig.json or jsconfig.json project.',\n      )\n      .option('--no-unused', 'Omit imports that are never referenced.')\n      .option('--json', 'Print the dependency tree as JSON.')\n      .action(\n        (entryFile: string | undefined, rawOptions: ParsedImportCliOptions) => {\n          runCli(normalizeImportCliOptions(entryFile, rawOptions))\n        },\n      )\n\n    cli\n      .command('react [entry-file]', 'Analyze React usage from an entry file.')\n      .usage('react [entry-file] [options]')\n      .option('--cwd <path>', 'Working directory used for relative paths.')\n      .option(\n        '--config <path>',\n        'Explicit tsconfig.json or jsconfig.json path.',\n      )\n      .option(\n        '--nextjs',\n        'Infer Next.js page entries from app/ and pages/ when no entry is provided.',\n      )\n      .option(\n        '--filter <mode>',\n        'Limit output to `component`, `hook`, or `builtin` usages.',\n      )\n      .option('--builtin', 'Include built-in HTML nodes in the React tree.')\n      .option(\n        '--no-workspaces',\n        'Do not expand sibling workspace packages into source subtrees.',\n      )\n      .option(\n        '--project-only',\n        'Restrict traversal to the active tsconfig.json or jsconfig.json project.',\n      )\n      .option('--json', 'Print the React usage tree as JSON.')\n      .action(\n        (entryFile: string | undefined, rawOptions: ParsedReactCliOptions) => {\n          runCli(normalizeReactCliOptions(entryFile, rawOptions))\n        },\n      )\n\n    cli.help()\n    cli.version(this.version)\n\n    return cli\n  }\n\n  private validateCommandSyntax(): void {\n    if (this.argv.length === 0) {\n      return\n    }\n\n    const firstArgument = this.argv[0]\n\n    if (firstArgument === undefined) {\n      return\n    }\n\n    if (firstArgument === '--react' || firstArgument.startsWith('--react=')) {\n      throw new Error('Unknown option `--react`')\n    }\n\n    if (firstArgument.startsWith('-')) {\n      return\n    }\n\n    if (firstArgument === 'import' || firstArgument === 'react') {\n      return\n    }\n\n    throw new Error(`Unknown command \\`${firstArgument}\\``)\n  }\n\n  private toProcessArgv(): string[] {\n    return ['node', 'foresthouse', ...this.argv]\n  }\n}\n\ninterface ParsedBaseCliOptions {\n  readonly cwd?: string\n  readonly config?: string\n  readonly workspaces?: boolean\n  readonly projectOnly?: boolean\n  readonly json?: boolean\n}\n\ninterface ParsedImportCliOptions extends ParsedBaseCliOptions {\n  readonly entry?: string\n  readonly includeExternals?: boolean\n  readonly unused?: boolean\n}\n\ninterface ParsedReactCliOptions extends ParsedBaseCliOptions {\n  readonly filter?: string\n  readonly nextjs?: boolean\n  readonly builtin?: boolean\n}\n\nfunction normalizeImportCliOptions(\n  entryFile: string | undefined,\n  options: ParsedImportCliOptions,\n): ImportCliOptions {\n  return {\n    command: 'import',\n    entryFile: resolveImportEntryFile(entryFile, options.entry),\n    cwd: options.cwd,\n    configPath: options.config,\n    expandWorkspaces: options.workspaces !== false,\n    projectOnly: options.projectOnly === true,\n    includeExternals: options.includeExternals === true,\n    omitUnused: options.unused === false,\n    json: options.json === true,\n  }\n}\n\nfunction normalizeReactCliOptions(\n  entryFile: string | undefined,\n  options: ParsedReactCliOptions,\n): ReactCliOptions {\n  return {\n    command: 'react',\n    entryFile: resolveReactEntryFile(entryFile, options.nextjs),\n    cwd: options.cwd,\n    configPath: options.config,\n    expandWorkspaces: options.workspaces !== false,\n    projectOnly: options.projectOnly === true,\n    json: options.json === true,\n    filter: normalizeReactFilter(options.filter),\n    nextjs: options.nextjs === true,\n    includeBuiltins: options.builtin === true,\n  }\n}\n\nfunction resolveImportEntryFile(\n  positionalEntryFile: string | undefined,\n  optionEntryFile: string | undefined,\n): string {\n  if (\n    positionalEntryFile !== undefined &&\n    optionEntryFile !== undefined &&\n    positionalEntryFile !== optionEntryFile\n  ) {\n    throw new Error(\n      'Provide the import entry only once, either as `foresthouse import <entry-file>` or `foresthouse import --entry <path>`.',\n    )\n  }\n\n  const resolvedEntryFile = positionalEntryFile ?? optionEntryFile\n\n  if (resolvedEntryFile === undefined) {\n    throw new Error(\n      'Missing import entry file. Use `foresthouse import <entry-file>` or `foresthouse import --entry <path>`.',\n    )\n  }\n\n  return resolvedEntryFile\n}\n\nfunction normalizeReactFilter(\n  filter: ParsedReactCliOptions['filter'],\n): ReactUsageFilter {\n  if (filter === undefined) {\n    return 'all'\n  }\n\n  if (filter === 'component' || filter === 'hook' || filter === 'builtin') {\n    return filter\n  }\n\n  throw new Error(`Unknown React filter: ${filter}`)\n}\n\nfunction resolveReactEntryFile(\n  entryFile: string | undefined,\n  nextjs: boolean | undefined,\n): string | undefined {\n  if (entryFile !== undefined) {\n    return entryFile\n  }\n\n  if (nextjs === true) {\n    return undefined\n  }\n\n  throw new Error(\n    'Missing React entry file. Use `foresthouse react <entry-file>` or `foresthouse react --nextjs`.',\n  )\n}\n","#!/usr/bin/env node\n\nimport { createRequire } from 'node:module'\n\nimport { main } from './app/cli.js'\n\nconst require = createRequire(import.meta.url)\nconst { version } = require('../package.json') as { version: string }\n\nmain(version)\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -4,6 +4,7 @@ interface AnalyzeOptions {
   readonly configPath?: string;
   readonly expandWorkspaces?: boolean;
   readonly projectOnly?: boolean;
+  readonly includeBuiltins?: boolean;
 }
 //#endregion
 //#region src/types/dependency-kind.d.ts
@@ -55,7 +56,7 @@ interface ReactUsageEntry {
 }
 //#endregion
 //#region src/types/react-symbol-kind.d.ts
-type ReactSymbolKind = 'component' | 'hook';
+type ReactSymbolKind = 'component' | 'hook' | 'builtin';
 //#endregion
 //#region src/types/react-usage-edge-kind.d.ts
 type ReactUsageEdgeKind = 'render' | 'hook-call';
@@ -81,12 +82,13 @@ interface ReactUsageNode {
 interface ReactUsageGraph {
   readonly cwd: string;
   readonly entryId: string;
+  readonly entryIds: readonly string[];
   readonly nodes: ReadonlyMap<string, ReactUsageNode>;
   readonly entries: readonly ReactUsageEntry[];
 }
 //#endregion
 //#region src/analyzers/react/index.d.ts
-declare function analyzeReactUsage(entryFile: string, options?: AnalyzeOptions): ReactUsageGraph;
+declare function analyzeReactUsage(entryFile: string | readonly string[], options?: AnalyzeOptions): ReactUsageGraph;
 //#endregion
 //#region src/types/react-usage-filter.d.ts
 type ReactUsageFilter = 'all' | ReactSymbolKind;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/analyze-options.ts","../src/types/dependency-kind.ts","../src/types/reference-kind.ts","../src/types/dependency-edge.ts","../src/types/source-module-node.ts","../src/types/dependency-graph.ts","../src/analyzers/import/index.ts","../src/types/react-usage-location.ts","../src/types/react-usage-entry.ts","../src/types/react-symbol-kind.ts","../src/types/react-usage-edge-kind.ts","../src/types/react-usage-edge.ts","../src/types/react-usage-node.ts","../src/types/react-usage-graph.ts","../src/analyzers/react/index.ts","../src/types/react-usage-filter.ts","../src/analyzers/react/queries.ts","../src/types/color-mode.ts","../src/types/print-tree-options.ts","../src/output/ascii/import.ts","../src/types/print-react-tree-options.ts","../src/output/ascii/react.ts","../src/output/json/import.ts","../src/output/json/react.ts"],"mappings":";UAAiB,cAAA;EAAA,SACN,GAAA;EAAA,SACA,UAAA;EAAA,SACA,gBAAA;EAAA,SACA,WAAA;AAAA;;;KCJC,cAAA;;;KCAA,aAAA;;;UCGK,cAAA;EAAA,SACN,SAAA;EAAA,SACA,aAAA,EAAe,aAAA;EAAA,SACf,UAAA;EAAA,SACA,MAAA;EAAA,SACA,IAAA,EAAM,cAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA;AAAA;;;UCRM,gBAAA;EAAA,SACN,EAAA;EAAA,SACA,YAAA,WAAuB,cAAA;AAAA;;;UCFjB,eAAA;EAAA,SACN,GAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA,EAAO,WAAA,SAAoB,gBAAA;EAAA,SAC3B,UAAA;AAAA;;;iBCGK,mBAAA,CACd,SAAA,UACA,OAAA,GAAS,cAAA,GACR,eAAA;;;UCZc,kBAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;AAAA;;;UCDM,eAAA;EAAA,SACN,MAAA;EAAA,SACA,aAAA;EAAA,SACA,QAAA,EAAU,kBAAA;AAAA;;;KCLT,eAAA;;;KCAA,kBAAA;;;UCEK,cAAA;EAAA,SACN,IAAA,EAAM,kBAAA;EAAA,SACN,MAAA;EAAA,SACA,aAAA;AAAA;;;UCFM,cAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,IAAA,EAAM,eAAA;EAAA,SACN,QAAA;EAAA,SACA,WAAA;EAAA,SACA,MAAA,WAAiB,cAAA;AAAA;;;UCNX,eAAA;EAAA,SACN,GAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA,EAAO,WAAA,SAAoB,cAAA;EAAA,SAC3B,OAAA,WAAkB,eAAA;AAAA;;;iBCcb,iBAAA,CACd,SAAA,UACA,OAAA,GAAS,cAAA,GACR,eAAA;;;KCtBS,gBAAA,WAA2B,eAAA;;;iBCKvB,oBAAA,CACd,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA,GACP,eAAA;AAAA,iBAOa,kBAAA,CACd,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA;AAAA,iBAsCM,iBAAA,CACd,IAAA,EAAM,cAAA,EACN,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA,GACP,cAAA;;;KC7DS,SAAA;;;UCEK,gBAAA;EAAA,SACN,GAAA;EAAA,SACA,gBAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,GAAQ,SAAA;AAAA;;;iBCAH,mBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA,GAAS,gBAAA;;;UCLM,qBAAA;EAAA,SACN,GAAA;EAAA,SACA,MAAA,GAAS,gBAAA;EAAA,SACT,KAAA,GAAQ,SAAA;AAAA;;;iBCaH,mBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA,GAAS,qBAAA;;;iBCjBK,uBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA;EAAA,SACW,UAAA;AAAA;;;iBC8BG,4BAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA;EAAA,SACW,MAAA,GAAS,gBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/analyze-options.ts","../src/types/dependency-kind.ts","../src/types/reference-kind.ts","../src/types/dependency-edge.ts","../src/types/source-module-node.ts","../src/types/dependency-graph.ts","../src/analyzers/import/index.ts","../src/types/react-usage-location.ts","../src/types/react-usage-entry.ts","../src/types/react-symbol-kind.ts","../src/types/react-usage-edge-kind.ts","../src/types/react-usage-edge.ts","../src/types/react-usage-node.ts","../src/types/react-usage-graph.ts","../src/analyzers/react/index.ts","../src/types/react-usage-filter.ts","../src/analyzers/react/queries.ts","../src/types/color-mode.ts","../src/types/print-tree-options.ts","../src/output/ascii/import.ts","../src/types/print-react-tree-options.ts","../src/output/ascii/react.ts","../src/output/json/import.ts","../src/output/json/react.ts"],"mappings":";UAAiB,cAAA;EAAA,SACN,GAAA;EAAA,SACA,UAAA;EAAA,SACA,gBAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA;AAAA;;;KCLC,cAAA;;;KCAA,aAAA;;;UCGK,cAAA;EAAA,SACN,SAAA;EAAA,SACA,aAAA,EAAe,aAAA;EAAA,SACf,UAAA;EAAA,SACA,MAAA;EAAA,SACA,IAAA,EAAM,cAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA;AAAA;;;UCRM,gBAAA;EAAA,SACN,EAAA;EAAA,SACA,YAAA,WAAuB,cAAA;AAAA;;;UCFjB,eAAA;EAAA,SACN,GAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA,EAAO,WAAA,SAAoB,gBAAA;EAAA,SAC3B,UAAA;AAAA;;;iBCGK,mBAAA,CACd,SAAA,UACA,OAAA,GAAS,cAAA,GACR,eAAA;;;UCZc,kBAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;AAAA;;;UCDM,eAAA;EAAA,SACN,MAAA;EAAA,SACA,aAAA;EAAA,SACA,QAAA,EAAU,kBAAA;AAAA;;;KCLT,eAAA;;;KCAA,kBAAA;;;UCEK,cAAA;EAAA,SACN,IAAA,EAAM,kBAAA;EAAA,SACN,MAAA;EAAA,SACA,aAAA;AAAA;;;UCFM,cAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,IAAA,EAAM,eAAA;EAAA,SACN,QAAA;EAAA,SACA,WAAA;EAAA,SACA,MAAA,WAAiB,cAAA;AAAA;;;UCNX,eAAA;EAAA,SACN,GAAA;EAAA,SACA,OAAA;EAAA,SACA,QAAA;EAAA,SACA,KAAA,EAAO,WAAA,SAAoB,cAAA;EAAA,SAC3B,OAAA,WAAkB,eAAA;AAAA;;;iBCgBb,iBAAA,CACd,SAAA,8BACA,OAAA,GAAS,cAAA,GACR,eAAA;;;KCzBS,gBAAA,WAA2B,eAAA;;;iBCKvB,oBAAA,CACd,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA,GACP,eAAA;AAAA,iBAOa,kBAAA,CACd,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA;AAAA,iBAsCM,iBAAA,CACd,IAAA,EAAM,cAAA,EACN,KAAA,EAAO,eAAA,EACP,MAAA,GAAQ,gBAAA,GACP,cAAA;;;KC7DS,SAAA;;;UCEK,gBAAA;EAAA,SACN,GAAA;EAAA,SACA,gBAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA,GAAQ,SAAA;AAAA;;;iBCAH,mBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA,GAAS,gBAAA;;;UCLM,qBAAA;EAAA,SACN,GAAA;EAAA,SACA,MAAA,GAAS,gBAAA;EAAA,SACT,KAAA,GAAQ,SAAA;AAAA;;;iBCaH,mBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA,GAAS,qBAAA;;;iBCjBK,uBAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA;EAAA,SACW,UAAA;AAAA;;;iBC8BG,4BAAA,CACd,KAAA,EAAO,eAAA,EACP,OAAA;EAAA,SACW,MAAA,GAAS,gBAAA;AAAA"}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as getFilteredUsages, c as analyzeReactUsage, i as printDependencyTree, l as analyzeDependencies, n as graphToSerializableTree, o as getReactUsageEntries, r as printReactUsageTree, s as getReactUsageRoots, t as graphToSerializableReactTree } from "./react-a7ugf8JN.mjs";
+import { a as getFilteredUsages, c as analyzeReactUsage, i as printDependencyTree, l as analyzeDependencies, n as graphToSerializableTree, o as getReactUsageEntries, r as printReactUsageTree, s as getReactUsageRoots, t as graphToSerializableReactTree } from "./react-B0frvTuH.mjs";
 export { analyzeDependencies, analyzeReactUsage, getFilteredUsages, getReactUsageEntries, getReactUsageRoots, graphToSerializableReactTree, graphToSerializableTree, printDependencyTree, printReactUsageTree };

package/dist/{react-a7ugf8JN.mjs → react-B0frvTuH.mjs}

@@ -617,6 +617,10 @@ function getComponentReferenceName(node) {
 	const name = getJsxName(node.openingElement.name);
 	return name !== void 0 && isComponentName(name) ? name : void 0;
 }
+function getBuiltinReferenceName(node) {
+	const name = getJsxName(node.openingElement.name);
+	return name !== void 0 && isIntrinsicElementName(name) ? name : void 0;
+}
 function getHookReferenceName(node) {
 	const calleeName = getIdentifierName(node.callee);
 	return calleeName !== void 0 && isHookName(calleeName) ? calleeName : void 0;
@@ -633,6 +637,9 @@ function isHookName(name) {
 function isComponentName(name) {
 	return /^[A-Z]/.test(name);
 }
+function isIntrinsicElementName(name) {
+	return /^[a-z]/.test(name);
+}
 function returnsReactElement(declaration) {
 	if (declaration.type === "ArrowFunctionExpression" && declaration.expression) return containsReactElementLikeExpression(declaration.body);
 	const body = declaration.body;
@@ -668,17 +675,17 @@ function unwrapExpression(expression) {
 }
 //#endregion
 //#region src/analyzers/react/entries.ts
-function collectEntryUsages(program, filePath, sourceText) {
+function collectEntryUsages(program, filePath, sourceText, includeBuiltins) {
 	const entries = /* @__PURE__ */ new Map();
 	program.body.forEach((statement) => {
-		collectStatementEntryUsages(statement, filePath, sourceText, entries);
+		collectStatementEntryUsages(statement, filePath, sourceText, entries, includeBuiltins);
 	});
 	return [...entries.values()].sort(comparePendingReactUsageEntries);
 }
-function collectStatementEntryUsages(statement, filePath, sourceText, entries) {
-	collectNodeEntryUsages(statement, filePath, sourceText, entries, false);
+function collectStatementEntryUsages(statement, filePath, sourceText, entries, includeBuiltins) {
+	collectNodeEntryUsages(statement, filePath, sourceText, entries, includeBuiltins, false);
 }
-function collectNodeEntryUsages(node, filePath, sourceText, entries, hasComponentAncestor) {
+function collectNodeEntryUsages(node, filePath, sourceText, entries, includeBuiltins, hasComponentAncestor) {
 	if (FUNCTION_NODE_TYPES.has(node.type)) return;
 	let nextHasComponentAncestor = hasComponentAncestor;
 	if (node.type === "JSXElement") {
@@ -686,6 +693,12 @@ function collectNodeEntryUsages(node, filePath, sourceText, entries, hasComponen
 		if (referenceName !== void 0) {
 			if (!hasComponentAncestor) addPendingReactUsageEntry(entries, referenceName, "component", createReactUsageLocation(filePath, sourceText, node.start));
 			nextHasComponentAncestor = true;
+		} else if (includeBuiltins) {
+			const builtinName = getBuiltinReferenceName(node);
+			if (builtinName !== void 0) {
+				if (!hasComponentAncestor) addPendingReactUsageEntry(entries, builtinName, "builtin", createReactUsageLocation(filePath, sourceText, node.start));
+				nextHasComponentAncestor = true;
+			}
 		}
 	} else if (node.type === "CallExpression") {
 		const hookReference = getHookReferenceName(node);
@@ -700,18 +713,18 @@ function collectNodeEntryUsages(node, filePath, sourceText, entries, hasComponen
 	if (keys === void 0) return;
 	keys.forEach((key) => {
 		const value = node[key];
-		collectEntryUsageChild(value, filePath, sourceText, entries, nextHasComponentAncestor);
+		collectEntryUsageChild(value, filePath, sourceText, entries, includeBuiltins, nextHasComponentAncestor);
 	});
 }
-function collectEntryUsageChild(value, filePath, sourceText, entries, hasComponentAncestor) {
+function collectEntryUsageChild(value, filePath, sourceText, entries, includeBuiltins, hasComponentAncestor) {
 	if (Array.isArray(value)) {
 		value.forEach((entry) => {
-			collectEntryUsageChild(entry, filePath, sourceText, entries, hasComponentAncestor);
+			collectEntryUsageChild(entry, filePath, sourceText, entries, includeBuiltins, hasComponentAncestor);
 		});
 		return;
 	}
 	if (!isNode(value)) return;
-	collectNodeEntryUsages(value, filePath, sourceText, entries, hasComponentAncestor);
+	collectNodeEntryUsages(value, filePath, sourceText, entries, includeBuiltins, hasComponentAncestor);
 }
 function addPendingReactUsageEntry(entries, referenceName, kind, location) {
 	const key = `${location.filePath}:${location.line}:${location.column}:${kind}:${referenceName}`;
@@ -800,18 +813,23 @@ function createPendingSymbol(filePath, name, kind, declaration) {
 		declaration,
 		exportNames: /* @__PURE__ */ new Set(),
 		componentReferences: /* @__PURE__ */ new Set(),
-		hookReferences: /* @__PURE__ */ new Set()
+		hookReferences: /* @__PURE__ */ new Set(),
+		builtinReferences: /* @__PURE__ */ new Set()
 	};
 }
 //#endregion
 //#region src/analyzers/react/usage.ts
-function analyzeSymbolUsages(symbol) {
+function analyzeSymbolUsages(symbol, includeBuiltins) {
 	const root = symbol.declaration.type === "ArrowFunctionExpression" ? symbol.declaration.body : symbol.declaration.body;
 	if (root === null) return;
 	walkReactUsageTree(root, (node) => {
 		if (node.type === "JSXElement") {
 			const name = getComponentReferenceName(node);
 			if (name !== void 0) symbol.componentReferences.add(name);
+			if (includeBuiltins) {
+				const builtinName = getBuiltinReferenceName(node);
+				if (builtinName !== void 0) symbol.builtinReferences.add(builtinName);
+			}
 			return;
 		}
 		if (node.type === "CallExpression") {
@@ -824,7 +842,7 @@ function analyzeSymbolUsages(symbol) {
 }
 //#endregion
 //#region src/analyzers/react/file.ts
-function analyzeReactFile(program, filePath, sourceText, includeNestedRenderEntries, sourceDependencies) {
+function analyzeReactFile(program, filePath, sourceText, includeNestedRenderEntries, sourceDependencies, includeBuiltins) {
 	const symbolsByName = /* @__PURE__ */ new Map();
 	program.body.forEach((statement) => {
 		collectTopLevelReactSymbols(statement, filePath, symbolsByName);
@@ -833,12 +851,12 @@ function analyzeReactFile(program, filePath, sourceText, includeNestedRenderEntr
 	const exportsByName = /* @__PURE__ */ new Map();
 	const reExportBindingsByName = /* @__PURE__ */ new Map();
 	const exportAllBindings = [];
-	const directEntryUsages = includeNestedRenderEntries ? collectEntryUsages(program, filePath, sourceText) : [];
+	const directEntryUsages = includeNestedRenderEntries ? collectEntryUsages(program, filePath, sourceText, includeBuiltins) : [];
 	program.body.forEach((statement) => {
 		collectImportsAndExports(statement, sourceDependencies, symbolsByName, importsByLocalName, exportsByName, reExportBindingsByName, exportAllBindings);
 	});
 	symbolsByName.forEach((symbol) => {
-		analyzeSymbolUsages(symbol);
+		analyzeSymbolUsages(symbol, includeBuiltins);
 	});
 	return {
 		filePath,
@@ -866,6 +884,7 @@ function collectComponentDeclarationEntryUsages(symbolsByName, sourceText) {
 //#endregion
 //#region src/analyzers/react/references.ts
 function resolveReactReference(fileAnalysis, fileAnalyses, name, kind) {
+	if (kind === "builtin") return getBuiltinNodeId(name);
 	const localSymbol = fileAnalysis.symbolsByName.get(name);
 	if (localSymbol !== void 0 && localSymbol.kind === kind) return localSymbol.id;
 	const importBinding = fileAnalysis.importsByLocalName.get(name);
@@ -909,6 +928,21 @@ function addExternalHookNodes(fileAnalyses, nodes) {
 		if (!nodes.has(externalNode.id)) nodes.set(externalNode.id, externalNode);
 	});
 }
+function addBuiltinNodes(fileAnalyses, nodes) {
+	for (const fileAnalysis of fileAnalyses.values()) {
+		fileAnalysis.entryUsages.forEach((entry) => {
+			if (entry.kind !== "builtin") return;
+			const builtinNode = createBuiltinNode(entry.referenceName);
+			if (!nodes.has(builtinNode.id)) nodes.set(builtinNode.id, builtinNode);
+		});
+		fileAnalysis.symbolsById.forEach((symbol) => {
+			symbol.builtinReferences.forEach((name) => {
+				const builtinNode = createBuiltinNode(name);
+				if (!nodes.has(builtinNode.id)) nodes.set(builtinNode.id, builtinNode);
+			});
+		});
+	}
+}
 function createExternalHookNode(binding, localName) {
 	const name = getExternalHookName(binding, localName);
 	return {
@@ -920,9 +954,22 @@ function createExternalHookNode(binding, localName) {
 		usages: []
 	};
 }
+function createBuiltinNode(name) {
+	return {
+		id: getBuiltinNodeId(name),
+		name,
+		kind: "builtin",
+		filePath: "html",
+		exportNames: [],
+		usages: []
+	};
+}
 function getExternalHookNodeId(binding, localName) {
 	return `external:${binding.sourceSpecifier}#hook:${getExternalHookName(binding, localName)}`;
 }
+function getBuiltinNodeId(name) {
+	return `builtin:${name}`;
+}
 function getExternalHookName(binding, localName) {
 	return binding.importedName === "default" ? localName : binding.importedName;
 }
@@ -941,11 +988,19 @@ function compareReactNodes(left, right) {
 //#endregion
 //#region src/analyzers/react/index.ts
 function analyzeReactUsage(entryFile, options = {}) {
-	return new ReactAnalyzer(entryFile, options).analyze();
+	return new ReactAnalyzer(normalizeEntryFiles(entryFile), options).analyze();
 }
 var ReactAnalyzer = class extends BaseAnalyzer {
+	constructor(entryFiles, options) {
+		const [firstEntryFile] = entryFiles;
+		if (firstEntryFile === void 0) throw new Error("At least one React entry file is required.");
+		super(firstEntryFile, options);
+		this.entryFiles = entryFiles;
+	}
 	doAnalyze() {
-		const dependencyGraph = analyzeDependencies(this.entryFile, this.options);
+		const dependencyGraphs = this.entryFiles.map((entryFile) => analyzeDependencies(entryFile, this.options));
+		const dependencyGraph = mergeDependencyGraphs(dependencyGraphs);
+		const entryIds = dependencyGraphs.map((graph) => graph.entryId);
 		const fileAnalyses = this.collectFileAnalyses(dependencyGraph);
 		const nodes = this.createNodes(fileAnalyses);
 		this.attachUsages(fileAnalyses, nodes);
@@ -953,12 +1008,13 @@ var ReactAnalyzer = class extends BaseAnalyzer {
 		return {
 			cwd: dependencyGraph.cwd,
 			entryId: dependencyGraph.entryId,
+			entryIds,
 			nodes,
 			entries
 		};
 	}
 	collectFileAnalyses(dependencyGraph) {
-		const reachableFiles = new Set([dependencyGraph.entryId, ...dependencyGraph.nodes.keys()]);
+		const reachableFiles = new Set([...dependencyGraph.entryIds, ...dependencyGraph.nodes.keys()]);
 		const fileAnalyses = /* @__PURE__ */ new Map();
 		for (const filePath of [...reachableFiles].sort()) {
 			if (!isSourceCodeFile(filePath) || filePath.endsWith(".d.ts")) continue;
@@ -972,7 +1028,7 @@ var ReactAnalyzer = class extends BaseAnalyzer {
 			dependencyNode?.dependencies.forEach((dependency) => {
 				if (dependency.kind === "source") sourceDependencies.set(dependency.specifier, dependency.target);
 			});
-			fileAnalyses.set(filePath, analyzeReactFile(parseResult.program, filePath, sourceText, filePath === dependencyGraph.entryId, sourceDependencies));
+			fileAnalyses.set(filePath, analyzeReactFile(parseResult.program, filePath, sourceText, dependencyGraph.entryIds.includes(filePath), sourceDependencies, this.options.includeBuiltins === true));
 		}
 		return fileAnalyses;
 	}
@@ -987,6 +1043,7 @@ var ReactAnalyzer = class extends BaseAnalyzer {
 			usages: []
 		});
 		addExternalHookNodes(fileAnalyses, nodes);
+		if (this.options.includeBuiltins === true) addBuiltinNodes(fileAnalyses, nodes);
 		return nodes;
 	}
 	attachUsages(fileAnalyses, nodes) {
@@ -1008,6 +1065,14 @@ var ReactAnalyzer = class extends BaseAnalyzer {
 					referenceName
 				});
 			});
+			if (this.options.includeBuiltins === true) symbol.builtinReferences.forEach((referenceName) => {
+				const targetId = getBuiltinNodeId(referenceName);
+				usages.set(`render:${targetId}:${referenceName}`, {
+					kind: "render",
+					target: targetId,
+					referenceName
+				});
+			});
 			const node = nodes.get(symbol.id);
 			if (node === void 0) continue;
 			const sortedUsages = [...usages.values()].sort((left, right) => compareReactNodeIds(left.target, right.target, nodes));
@@ -1032,6 +1097,27 @@ var ReactAnalyzer = class extends BaseAnalyzer {
 		return [...entriesByKey.values()].sort((left, right) => compareReactUsageEntries(left, right, nodes));
 	}
 };
+function normalizeEntryFiles(entryFile) {
+	const entryFiles = Array.isArray(entryFile) ? entryFile : [entryFile];
+	const dedupedEntryFiles = [...new Set(entryFiles)];
+	if (dedupedEntryFiles.length === 0) throw new Error("At least one React entry file is required.");
+	return dedupedEntryFiles;
+}
+function mergeDependencyGraphs(graphs) {
+	const firstGraph = graphs[0];
+	if (firstGraph === void 0) throw new Error("At least one dependency graph is required.");
+	const nodes = /* @__PURE__ */ new Map();
+	for (const graph of graphs) for (const [nodeId, node] of graph.nodes) if (!nodes.has(nodeId)) nodes.set(nodeId, node);
+	const uniqueConfigPaths = [...new Set(graphs.map((graph) => graph.configPath))];
+	const configPath = uniqueConfigPaths.length === 1 ? uniqueConfigPaths[0] : void 0;
+	return {
+		cwd: firstGraph.cwd,
+		entryId: firstGraph.entryId,
+		entryIds: graphs.map((graph) => graph.entryId),
+		nodes,
+		...configPath === void 0 ? {} : { configPath }
+	};
+}
 //#endregion
 //#region src/analyzers/react/queries.ts
 function getReactUsageEntries(graph, filter = "all") {
@@ -1076,6 +1162,7 @@ function matchesReactFilter(node, filter) {
 const ANSI_RESET = "\x1B[0m";
 const ANSI_COMPONENT = "\x1B[36m";
 const ANSI_HOOK = "\x1B[35m";
+const ANSI_BUILTIN = "\x1B[34m";
 const ANSI_MUTED = "\x1B[38;5;244m";
 const ANSI_UNUSED = "\x1B[38;5;214m";
 function resolveColorSupport(mode = "auto", options = {}) {
@@ -1096,7 +1183,9 @@ function formatReactSymbolLabel(name, kind, enabled) {
 	return `${getReactSymbolColor(kind)}${label}${ANSI_RESET}`;
 }
 function formatReactSymbolName(name, kind) {
-	return kind === "component" ? `<${name} />` : `${name}()`;
+	if (kind === "component") return `<${name} />`;
+	if (kind === "hook") return `${name}()`;
+	return `<${name}>`;
 }
 function colorizeReactLabel(text, kind, enabled) {
 	if (!enabled) return text;
@@ -1107,7 +1196,9 @@ function colorizeMuted(text, enabled) {
 	return `${ANSI_MUTED}${text}${ANSI_RESET}`;
 }
 function getReactSymbolColor(kind) {
-	return kind === "component" ? ANSI_COMPONENT : ANSI_HOOK;
+	if (kind === "component") return ANSI_COMPONENT;
+	if (kind === "hook") return ANSI_HOOK;
+	return ANSI_BUILTIN;
 }
 //#endregion
 //#region src/utils/to-display-path.ts
@@ -1229,11 +1320,14 @@ function renderUsage(usage, graph, cwd, filter, color, visited, prefix, isLast)
 	return childLines;
 }
 function formatReactNodeLabel(node, cwd, color, referenceName) {
-	return `${referenceName !== void 0 && referenceName !== node.name ? `${colorizeReactLabel(formatReactSymbolName(node.name, node.kind), node.kind, color)} ${colorizeMuted(`as ${referenceName}`, color)} ${colorizeReactLabel(`[${node.kind}]`, node.kind, color)}` : formatReactSymbolLabel(node.name, node.kind, color)} (${toDisplayPath(node.filePath, cwd)})`;
+	return `${referenceName !== void 0 && referenceName !== node.name ? `${colorizeReactLabel(formatReactSymbolName(node.name, node.kind), node.kind, color)} ${colorizeMuted(`as ${referenceName}`, color)} ${colorizeReactLabel(`[${node.kind}]`, node.kind, color)}` : formatReactSymbolLabel(node.name, node.kind, color)} (${formatReactNodeFilePath$1(node, cwd)})`;
 }
 function formatReactEntryLabel(entry, cwd) {
 	return `${toDisplayPath(entry.location.filePath, cwd)}:${entry.location.line}:${entry.location.column}`;
 }
+function formatReactNodeFilePath$1(node, cwd) {
+	return node.kind === "builtin" ? "html" : toDisplayPath(node.filePath, cwd);
+}
 //#endregion
 //#region src/output/json/import.ts
 function graphToSerializableTree(graph, options = {}) {
@@ -1311,7 +1405,7 @@ function serializeReactUsageNode(nodeId, graph, filter, visited) {
 		id: node.id,
 		name: node.name,
 		symbolKind: "circular",
-		filePath: toDisplayPath(node.filePath, graph.cwd),
+		filePath: formatReactNodeFilePath(node.filePath, node.kind, graph.cwd),
 		exportNames: node.exportNames,
 		usages: []
 	};
@@ -1321,7 +1415,7 @@ function serializeReactUsageNode(nodeId, graph, filter, visited) {
 		id: node.id,
 		name: node.name,
 		symbolKind: node.kind,
-		filePath: toDisplayPath(node.filePath, graph.cwd),
+		filePath: formatReactNodeFilePath(node.filePath, node.kind, graph.cwd),
 		exportNames: node.exportNames,
 		usages: getFilteredUsages(node, graph, filter).map((usage) => ({
 			kind: usage.kind,
@@ -1341,7 +1435,10 @@ function serializeReactUsageEntry(entry, graph, filter) {
 		node: serializeReactUsageNode(entry.target, graph, filter, /* @__PURE__ */ new Set())
 	};
 }
+function formatReactNodeFilePath(filePath, kind, cwd) {
+	return kind === "builtin" ? "html" : toDisplayPath(filePath, cwd);
+}
 //#endregion
-export { getFilteredUsages as a, analyzeReactUsage as c, printDependencyTree as i, analyzeDependencies as l, graphToSerializableTree as n, getReactUsageEntries as o, printReactUsageTree as r, getReactUsageRoots as s, graphToSerializableReactTree as t };
+export { getFilteredUsages as a, analyzeReactUsage as c, printDependencyTree as i, analyzeDependencies as l, graphToSerializableTree as n, getReactUsageEntries as o, printReactUsageTree as r, getReactUsageRoots as s, graphToSerializableReactTree as t, isSourceCodeFile as u };
 
-//# sourceMappingURL=react-a7ugf8JN.mjs.map
+//# sourceMappingURL=react-B0frvTuH.mjs.map