foresthouse 1.0.0-dev.9 → 1.0.0

package/README.md

@@ -1,35 +1,65 @@
-# foresthouse
+# foresthouse 🌲🏠
 
-`foresthouse` is a modern TypeScript-first Node.js CLI that starts from an entry file, follows local JavaScript and TypeScript imports, and prints the result as a dependency tree.
+[![npm version](https://img.shields.io/npm/v/foresthouse.svg?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/foresthouse)
+[![codecov](https://img.shields.io/codecov/c/github/async3619/foresthouse?style=flat&colorA=000000&colorB=000000)](https://codecov.io/gh/async3619/foresthouse)
+[![license](https://img.shields.io/npm/l/foresthouse?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/foresthouse)
 
-## Stack
+`foresthouse` is a modern TypeScript-first Node.js CLI that can print source import trees, React usage trees, and package-manifest dependency trees.
 
-- Node.js 24.14.0 LTS
-- TypeScript 5.9
-- `tsx` for fast TypeScript execution in development
-- `tsdown` for fast ESM builds
-- `Biome` for linting and formatting
-- `Vitest` for tests
-- `semantic-release` for automated pre-releases and releases
-- npm publishing through `semantic-release` on GitHub Actions
+## Installation
+
+```bash
+npm install -g foresthouse
+```
+
+You can also run it without a global install:
+
+```bash
+npx foresthouse --help
+pnpm dlx foresthouse --help
+yarn dlx foresthouse --help
+bunx foresthouse --help
+```
 
 ## What it does
 
-- Reads a JavaScript/TypeScript entry file (`.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs`, `.mts`, `.cts`)
+- Analyzes source import trees from JavaScript and TypeScript entry files (`.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs`, `.mts`, `.cts`)
 - Resolves local imports, re-exports, `require()`, and string-literal dynamic `import()`
 - Honors the nearest `tsconfig.json` or `jsconfig.json`, including `baseUrl` and `paths`
-- Prints a tree by default, or JSON with `--json`
+- Expands sibling workspace packages by default, including their own `tsconfig` alias rules
+- Analyzes React component and hook usage trees from explicit entry files or inferred Next.js app and pages routes
+- Reads `package.json` manifests to show package-level dependency trees for single packages and monorepos
+- Shows dependency-tree changes relative to a Git ref or range with `foresthouse deps --diff`
+- Prints an ASCII tree by default, or JSON with `--json`
 - Colorizes ASCII output automatically when the terminal supports ANSI colors
 
 ## Usage
 
-```bash
-corepack enable
-pnpm install
-pnpm run build
-node dist/cli.mjs import src/index.ts
+```text
+Usage:
+  $ foresthouse <command> [options]
+
+Commands:
+  deps <directory>     Analyze package.json dependencies from a package directory.
+  import [entry-file]  Analyze an entry file and print its dependency tree.
+  react [entry-file]   Analyze React usage from an entry file.
+
+For more info, run any command with the `--help` flag:
+  $ foresthouse deps --help
+  $ foresthouse import --help
+  $ foresthouse react --help
+
+Options:
+  -h, --help     Display this message
+  -v, --version  Display version number
 ```
 
+### Commands
+
+- `foresthouse import <entry-file>`: analyzes a JavaScript or TypeScript entry file and prints a dependency tree by following imports, re-exports, `require()`, and dynamic `import()`.
+- `foresthouse react [entry-file]`: analyzes React component, hook, and render relationships and prints a React usage tree. It also supports automatic Next.js entry discovery with `--nextjs`.
+- `foresthouse deps <directory>`: reads `package.json` manifests and workspace structure from a package directory and prints a package dependency tree. Use `--diff` to show only changes relative to a Git ref or range.
+
 ### Example
 
 ```bash
@@ -47,40 +77,79 @@ src/main.ts
 │  └─ [dynamic] src/widgets/chart.ts
 ```
 
-### Options
+### `foresthouse import --help`
 
-`import` command:
+Analyzes a source dependency tree from a single entry file. You can provide the entry with either a positional argument or `--entry`, and use `--json` for machine-readable output.
 
-- `foresthouse import <path>`: analyze an entry file by positional argument
-- `foresthouse import --entry <path>`: analyze an entry file by explicit option
-- `--cwd <path>`: working directory for resolving the entry file and config
-- `--config <path>`: use a specific `tsconfig.json` or `jsconfig.json`
-- `--include-externals`: include packages and Node built-ins in the output
-- `--no-unused`: omit imports that are never referenced
-- `--json`: print a JSON tree instead of ASCII output
+```text
+Usage:
+  $ foresthouse import <entry-file> [options]
+
+Options:
+  --entry <path>       Entry file to analyze.
+  --cwd <path>         Working directory used for relative paths.
+  --config <path>      Explicit tsconfig.json or jsconfig.json path.
+  --include-externals  Include packages and Node built-ins in the tree.
+  --no-workspaces      Do not expand sibling workspace packages into source subtrees. (default: true)
+  --project-only       Restrict traversal to the active tsconfig.json or jsconfig.json project.
+  --no-unused          Omit imports that are never referenced. (default: true)
+  --json               Print the dependency tree as JSON.
+  -h, --help           Display this message
+```
+
+### `foresthouse react --help`
 
-`react` command:
+Analyzes React component and hook usage relationships. You can provide an entry file directly, or use `--nextjs` to discover Next.js route entries automatically.
 
-- `foresthouse react <path>`: print a React usage tree from an entry file
-- `--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
-- `--json`: print a JSON tree instead of ASCII output
+```text
+Usage:
+  $ foresthouse react [entry-file] [options]
+
+Options:
+  --cwd <path>     Working directory used for relative paths.
+  --config <path>  Explicit tsconfig.json or jsconfig.json path.
+  --nextjs         Infer Next.js page entries from app/ and pages/ when no entry is provided.
+  --filter <mode>  Limit output to `component`, `hook`, or `builtin` usages.
+  --builtin        Include built-in HTML nodes in the React tree.
+  --no-workspaces  Do not expand sibling workspace packages into source subtrees. (default: true)
+  --project-only   Restrict traversal to the active tsconfig.json or jsconfig.json project.
+  --json           Print the React usage tree as JSON.
+  -h, --help       Display this message
+```
+
+### `foresthouse deps --help`
+
+Analyzes package-level dependency trees for both single-package projects and monorepos. Use `--diff` to show only dependency changes relative to a Git ref or range.
+
+```text
+Usage:
+  $ foresthouse deps <directory> [options]
+
+Options:
+  --diff <git-ref-or-range>  Show only dependency-tree changes relative to a Git revision or range.
+  --json                     Print the package tree as JSON.
+  -h, --help                 Display this message
+```
+
+Common examples:
+
+- `foresthouse import src/main.ts`
+- `foresthouse import --entry src/main.ts --cwd test/fixtures/basic`
+- `foresthouse react src/App.tsx`
+- `foresthouse react --nextjs --cwd .`
+- `foresthouse deps .`
+- `foresthouse deps ./packages/a`
+- `foresthouse deps . --diff origin/dev...HEAD`
 
 ## Development
 
 ```bash
 corepack enable
 pnpm install
+pnpm run test:unit
+pnpm run test:e2e
 pnpm run check
 ```
 
-## Collaboration And Release Flow
-
-- `dev` is the pre-release branch and publishes `-dev.N` builds through `semantic-release`
-- `main` is the stable release branch
-- every code change starts from a GitHub issue and lands through a pull request
-- all commits must follow Conventional Commits
-- Biome is the only formatter and linter in this repository
-- CI runs lint, typecheck, build, and release automation
-- npm publishing is configured through `semantic-release` with `NPM_TOKEN` and GitHub Actions provenance
+- Unit tests live next to source files as `src/**/*.spec.ts`.
+- End-to-end command tests live under `e2e/`.

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-BHPy_fw5.mjs";
+import { a as printReactUsageTree, c as printPackageDependencyTree, f as analyzeReactUsage, g as analyzePackageDependencies, h as analyzePackageDependencyDiff, i as graphToSerializablePackageTree, m as isSourceCodeFile, n as graphToSerializableTree, o as printDependencyTree, p as analyzeDependencies, r as diffGraphToSerializablePackageTree, s as printPackageDependencyDiffTree, t as graphToSerializableReactTree } from "./react-Fqrly1Yw.mjs";
 import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
 import process$1 from "node:process";
 import { cac } from "cac";
 //#region src/commands/base.ts
@@ -22,11 +24,32 @@ var BaseCommand = class {
 	getAnalyzeOptions() {
 		return {
 			...this.options.cwd === void 0 ? {} : { cwd: this.options.cwd },
-			...this.options.configPath === void 0 ? {} : { configPath: this.options.configPath }
+			...this.options.configPath === void 0 ? {} : { configPath: this.options.configPath },
+			expandWorkspaces: this.options.expandWorkspaces,
+			projectOnly: this.options.projectOnly
 		};
 	}
 };
 //#endregion
+//#region src/commands/deps.ts
+var DepsCommand = class extends BaseCommand {
+	analyze() {
+		if (this.options.diff !== void 0) return analyzePackageDependencyDiff(this.options.directory, this.options.diff);
+		return analyzePackageDependencies(this.options.directory);
+	}
+	serialize(graph) {
+		if (isPackageDependencyDiffGraph(graph)) return diffGraphToSerializablePackageTree(graph);
+		return graphToSerializablePackageTree(graph);
+	}
+	render(graph) {
+		if (isPackageDependencyDiffGraph(graph)) return printPackageDependencyDiffTree(graph);
+		return printPackageDependencyTree(graph);
+	}
+};
+function isPackageDependencyDiffGraph(graph) {
+	return "root" in graph;
+}
+//#endregion
 //#region src/commands/import.ts
 var ImportCommand = class extends BaseCommand {
 	analyze() {
@@ -44,10 +67,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() });
@@ -58,6 +142,12 @@ var ReactCommand = class extends BaseCommand {
 			filter: this.getFilter()
 		});
 	}
+	getAnalyzeOptions() {
+		return {
+			...super.getAnalyzeOptions(),
+			includeBuiltins: this.options.includeBuiltins
+		};
+	}
 	getFilter() {
 		return this.options.filter;
 	}
@@ -75,6 +165,7 @@ var CliApplication = class {
 		this.createCommand().run();
 	}
 	createCommand() {
+		if (this.options.command === "deps") return new DepsCommand(this.options);
 		if (this.options.command === "react") return new ReactCommand(this.options);
 		return new ImportCommand(this.options);
 	}
@@ -106,10 +197,13 @@ var CliMain = class {
 	}
 	createCli() {
 		const cli = cac("foresthouse");
-		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-unused", "Omit imports that are never referenced.").option("--json", "Print the dependency tree as JSON.").action((entryFile, rawOptions) => {
+		cli.command("deps <directory>", "Analyze package.json dependencies from a package directory.").usage("deps <directory> [options]").option("--diff <git-ref-or-range>", "Show only dependency-tree changes relative to a Git revision or range.").option("--json", "Print the package tree as JSON.").action((directory, rawOptions) => {
+			runCli(normalizeDepsCliOptions(directory, rawOptions));
+		});
+		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("--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();
@@ -122,7 +216,7 @@ var CliMain = class {
 		if (firstArgument === void 0) return;
 		if (firstArgument === "--react" || firstArgument.startsWith("--react=")) throw new Error("Unknown option `--react`");
 		if (firstArgument.startsWith("-")) return;
-		if (firstArgument === "import" || firstArgument === "react") return;
+		if (firstArgument === "deps" || firstArgument === "import" || firstArgument === "react") return;
 		throw new Error(`Unknown command \`${firstArgument}\``);
 	}
 	toProcessArgv() {
@@ -133,12 +227,26 @@ var CliMain = class {
 		];
 	}
 };
+function normalizeDepsCliOptions(directory, options) {
+	return {
+		command: "deps",
+		directory,
+		diff: options.diff,
+		cwd: void 0,
+		configPath: void 0,
+		expandWorkspaces: true,
+		projectOnly: false,
+		json: options.json === true
+	};
+}
 function normalizeImportCliOptions(entryFile, options) {
 	return {
 		command: "import",
 		entryFile: resolveImportEntryFile(entryFile, options.entry),
 		cwd: options.cwd,
 		configPath: options.config,
+		expandWorkspaces: options.workspaces !== false,
+		projectOnly: options.projectOnly === true,
 		includeExternals: options.includeExternals === true,
 		omitUnused: options.unused === false,
 		json: options.json === true
@@ -147,11 +255,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) {
@@ -162,9 +274,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    }\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('--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('--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 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    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    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/deps.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 { analyzePackageDependencyDiff } from '../analyzers/deps/diff.js'\nimport { analyzePackageDependencies } from '../analyzers/deps/index.js'\nimport type { DepsCliOptions } from '../app/args.js'\nimport {\n  printPackageDependencyDiffTree,\n  printPackageDependencyTree,\n} from '../output/ascii/deps.js'\nimport {\n  diffGraphToSerializablePackageTree,\n  graphToSerializablePackageTree,\n} from '../output/json/deps.js'\nimport type { PackageDependencyDiffGraph } from '../types/package-dependency-diff-graph.js'\nimport type { PackageDependencyGraph } from '../types/package-dependency-graph.js'\nimport { BaseCommand } from './base.js'\n\nexport class DepsCommand extends BaseCommand<\n  PackageDependencyGraph | PackageDependencyDiffGraph,\n  DepsCliOptions\n> {\n  protected analyze(): PackageDependencyGraph | PackageDependencyDiffGraph {\n    if (this.options.diff !== undefined) {\n      return analyzePackageDependencyDiff(\n        this.options.directory,\n        this.options.diff,\n      )\n    }\n\n    return analyzePackageDependencies(this.options.directory)\n  }\n\n  protected serialize(\n    graph: PackageDependencyGraph | PackageDependencyDiffGraph,\n  ): object {\n    if (isPackageDependencyDiffGraph(graph)) {\n      return diffGraphToSerializablePackageTree(graph)\n    }\n\n    return graphToSerializablePackageTree(graph)\n  }\n\n  protected render(\n    graph: PackageDependencyGraph | PackageDependencyDiffGraph,\n  ): string {\n    if (isPackageDependencyDiffGraph(graph)) {\n      return printPackageDependencyDiffTree(graph)\n    }\n\n    return printPackageDependencyTree(graph)\n  }\n}\n\nfunction isPackageDependencyDiffGraph(\n  graph: PackageDependencyGraph | PackageDependencyDiffGraph,\n): graph is PackageDependencyDiffGraph {\n  return 'root' in graph\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 { DepsCommand } from '../commands/deps.js'\nimport { 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 === 'deps') {\n      return new DepsCommand(this.options)\n    }\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 {\n  DepsCliOptions,\n  ImportCliOptions,\n  ReactCliOptions,\n} 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        'deps <directory>',\n        'Analyze package.json dependencies from a package directory.',\n      )\n      .usage('deps <directory> [options]')\n      .option(\n        '--diff <git-ref-or-range>',\n        'Show only dependency-tree changes relative to a Git revision or range.',\n      )\n      .option('--json', 'Print the package tree as JSON.')\n      .action((directory: string, rawOptions: ParsedDepsCliOptions) => {\n        runCli(normalizeDepsCliOptions(directory, rawOptions))\n      })\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 (\n      firstArgument === 'deps' ||\n      firstArgument === 'import' ||\n      firstArgument === 'react'\n    ) {\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 ParsedDepsCliOptions {\n  readonly diff?: string\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 normalizeDepsCliOptions(\n  directory: string,\n  options: ParsedDepsCliOptions,\n): DepsCliOptions {\n  return {\n    command: 'deps',\n    directory,\n    diff: options.diff,\n    cwd: undefined,\n    configPath: undefined,\n    expandWorkspaces: true,\n    projectOnly: false,\n    json: options.json === true,\n  }\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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"}