@react-grab/cli 0.1.46 → 0.1.47-dev.d5e8fc8

package/README.md

@@ -67,6 +67,94 @@ npx grab@latest configure --mode hold --hold-duration 500
 npx grab@latest configure
 ```
 
+## Node API
+
+`@react-grab/cli/api` exposes the same primitives that power the CLI, so you can build your own installer or wrap React Grab setup inside another tool. Importing it runs no code, unlike the CLI entry (`.`), which parses `argv` on import.
+
+### `installReactGrab(options?)`
+
+A high-level, non-interactive orchestrator. It detects the project, installs `react-grab` with the detected package manager, and applies the framework-specific development-only setup. It returns a structured result instead of printing or exiting.
+
+```ts
+import { installReactGrab } from "@react-grab/cli/api";
+
+const result = await installReactGrab({ cwd: process.cwd() });
+
+console.log(result.framework); // "next" | "vite" | "tanstack" | "webpack"
+console.log(result.didInstallPackage); // whether react-grab was added to deps
+console.log(result.didChangeFile); // whether an entry file was modified
+console.log(result.transform.filePath); // the file that was (or would be) edited
+```
+
+| Option                  | Type                                                     | Description                                                                                                             |
+| ----------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `cwd`                   | `string`                                                 | Project directory (default: `process.cwd()`)                                                                            |
+| `framework`             | `Framework`                                              | Override framework detection                                                                                            |
+| `nextRouterType`        | `NextRouterType`                                         | Override Next.js router detection (`app` / `pages`)                                                                     |
+| `packageManager`        | `PackageManager`                                         | Override package-manager detection                                                                                      |
+| `skipPackageInstall`    | `boolean`                                                | Skip installing the `react-grab` npm package                                                                            |
+| `skipTransform`         | `boolean`                                                | Skip editing the framework entry file                                                                                   |
+| `dryRun`                | `boolean`                                                | Compute the changes without installing or writing                                                                       |
+| `installPackageOptions` | `Omit<InstallPackageOptions, "cwd" \| "packageManager">` | Passed through to `installPackages` (e.g. `silent`, `isDev`); `cwd`/`packageManager` are controlled by the orchestrator |
+
+Failures throw a `ReactGrabInstallError` whose `code` identifies the cause, with the original error preserved on `error.cause`:
+
+- `unsupported-framework`: framework has no automatic setup (Remix, Astro, SvelteKit, Gatsby)
+- `unknown-framework`: no supported framework detected
+- `transform-failed`: entry file could not be located or edited
+- `install-failed`: package manager failed to install `react-grab`
+- `write-failed`: edited file could not be written
+
+`installReactGrab` configures a single project at `cwd` and does not walk a monorepo. Point `cwd` at the app you want to set up, or call `findReactProjects` first to locate the apps in a workspace.
+
+By default the call mutates your project: it runs the package manager and edits a framework entry file. Pass `dryRun: true` to compute the change set (returned on `result.transform`) without installing or writing.
+
+### Low-level building blocks
+
+If you want full control, compose the same functions the orchestrator uses:
+
+```ts
+import {
+  detectProject,
+  previewTransform,
+  applyTransform,
+  installPackages,
+  getPackagesToInstall,
+  installSkill,
+} from "@react-grab/cli/api";
+
+const project = await detectProject(process.cwd());
+const transform = previewTransform(
+  project.projectRoot,
+  project.framework,
+  project.nextRouterType,
+  project.isReactGrabConfigured,
+);
+```
+
+Install the package only when it's missing, then write the previewed edit. `previewTransform` sets `noChanges` when React Grab is already wired up, so guard on it before calling `applyTransform`, which writes `transform.newContent` to `transform.filePath`:
+
+```ts
+if (!project.hasReactGrab) {
+  await installPackages(getPackagesToInstall(), {
+    cwd: project.projectRoot,
+    packageManager: project.packageManager,
+  });
+}
+
+if (transform.success && transform.newContent && !transform.noChanges) {
+  applyTransform(transform);
+}
+
+await installSkill({ cwd: project.projectRoot });
+```
+
+The full export surface, each with its TypeScript types:
+
+- Detection: `detectProject`, `detectFramework`, `detectPackageManager`, `detectNextRouterType`, `detectReactGrab`, `detectReactGrabConfigured`, `detectUnsupportedFramework`, `findReactProjects`
+- Transforms: `previewTransform`, `previewOptionsTransform`, `previewCdnTransform`, `applyTransform`, `hasFrameworkEntryPoint`
+- Installation: `installPackages`, `getPackagesToInstall`, `installSkill`, `removeSkill`
+
 ## Supported Frameworks
 
 The CLI currently configures:

package/dist/api.cjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_install = require("./install-DlD3sLtm.cjs");
+let node_path = require("node:path");
+//#region src/utils/install-react-grab.ts
+var ReactGrabInstallError = class extends Error {
+	code;
+	constructor(message, code, options) {
+		super(message, options);
+		this.name = "ReactGrabInstallError";
+		this.code = code;
+	}
+};
+const installReactGrab = async (options = {}) => {
+	const project = await require_install.detectProject((0, node_path.resolve)(options.cwd ?? process.cwd()));
+	const framework = options.framework ?? project.framework;
+	const packageManager = options.packageManager ?? project.packageManager;
+	if (project.unsupportedFramework && !options.framework) throw new ReactGrabInstallError(`${project.unsupportedFramework} is not supported by automatic setup.`, "unsupported-framework");
+	if (framework === "unknown") throw new ReactGrabInstallError("Could not detect a supported framework. Pass `framework` explicitly to override detection.", "unknown-framework");
+	const nextRouterType = options.nextRouterType ?? (framework === "next" && project.nextRouterType === "unknown" ? require_install.detectNextRouterType(project.projectRoot) : project.nextRouterType);
+	const alreadyConfigured = project.isReactGrabConfigured;
+	const transform = require_install.previewTransform(project.projectRoot, framework, nextRouterType, alreadyConfigured);
+	if (!transform.success && !options.skipTransform) throw new ReactGrabInstallError(transform.message, "transform-failed");
+	const didInstallPackage = !options.skipPackageInstall && !options.dryRun && !project.hasReactGrab;
+	if (didInstallPackage) try {
+		await require_install.installPackages(require_install.getPackagesToInstall(), {
+			...options.installPackageOptions,
+			cwd: project.projectRoot,
+			packageManager
+		});
+	} catch (error) {
+		throw new ReactGrabInstallError(error instanceof Error ? error.message : "Failed to install the react-grab package.", "install-failed", { cause: error });
+	}
+	const didChangeFile = !transform.noChanges && Boolean(transform.newContent) && !options.skipTransform && !options.dryRun;
+	if (didChangeFile) {
+		const writeResult = require_install.applyTransform(transform);
+		if (!writeResult.success) throw new ReactGrabInstallError(writeResult.error ?? `Failed to write to ${transform.filePath}`, "write-failed");
+	}
+	return {
+		projectRoot: project.projectRoot,
+		framework,
+		nextRouterType,
+		packageManager,
+		alreadyConfigured,
+		didInstallPackage,
+		didChangeFile,
+		dryRun: Boolean(options.dryRun),
+		transform
+	};
+};
+//#endregion
+exports.ReactGrabInstallError = ReactGrabInstallError;
+exports.applyTransform = require_install.applyTransform;
+exports.detectFramework = require_install.detectFramework;
+exports.detectNextRouterType = require_install.detectNextRouterType;
+exports.detectPackageManager = require_install.detectPackageManager;
+exports.detectProject = require_install.detectProject;
+exports.detectReactGrab = require_install.detectReactGrab;
+exports.detectReactGrabConfigured = require_install.detectReactGrabConfigured;
+exports.detectUnsupportedFramework = require_install.detectUnsupportedFramework;
+exports.findReactProjects = require_install.findReactProjects;
+exports.getPackagesToInstall = require_install.getPackagesToInstall;
+exports.hasFrameworkEntryPoint = require_install.hasFrameworkEntryPoint;
+exports.installPackages = require_install.installPackages;
+exports.installReactGrab = installReactGrab;
+exports.installSkill = require_install.installSkill;
+exports.previewCdnTransform = require_install.previewCdnTransform;
+exports.previewOptionsTransform = require_install.previewOptionsTransform;
+exports.previewTransform = require_install.previewTransform;
+exports.removeSkill = require_install.removeSkill;

package/dist/api.d.cts

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { SkillAgentType, add } from "agent-install/skill";
+
+//#region src/utils/detect.d.ts
+type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
+type Framework = "next" | "vite" | "tanstack" | "webpack" | "unknown";
+type NextRouterType = "app" | "pages" | "unknown";
+type UnsupportedFramework = "remix" | "astro" | "sveltekit" | "gatsby" | null;
+interface ProjectInfo {
+  packageManager: PackageManager;
+  framework: Framework;
+  nextRouterType: NextRouterType;
+  isMonorepo: boolean;
+  projectRoot: string;
+  hasReactGrab: boolean;
+  isReactGrabConfigured: boolean;
+  reactGrabVersion: string | null;
+  unsupportedFramework: UnsupportedFramework;
+}
+declare const detectPackageManager: (projectRoot: string) => Promise<PackageManager>;
+declare const detectFramework: (projectRoot: string) => Framework;
+declare const detectNextRouterType: (projectRoot: string) => NextRouterType;
+interface WorkspaceProject {
+  name: string;
+  path: string;
+  framework: Framework;
+}
+declare const findReactProjects: (projectRoot: string) => WorkspaceProject[];
+declare const detectReactGrabConfigured: (projectRoot: string) => boolean;
+declare const detectReactGrab: (projectRoot: string) => boolean;
+declare const detectUnsupportedFramework: (projectRoot: string) => UnsupportedFramework;
+declare const detectProject: (projectRoot?: string) => Promise<ProjectInfo>;
+//#endregion
+//#region src/utils/transform.d.ts
+interface TransformResult {
+  success: boolean;
+  filePath: string;
+  message: string;
+  originalContent?: string;
+  newContent?: string;
+  noChanges?: boolean;
+}
+interface ReactGrabOptions {
+  activationKey?: string;
+  activationMode?: "toggle" | "hold";
+  keyHoldDuration?: number;
+  allowActivationInsideInput?: boolean;
+  maxContextLines?: number;
+}
+declare const hasFrameworkEntryPoint: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType) => boolean;
+declare const previewTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, reactGrabAlreadyConfigured?: boolean) => TransformResult;
+declare const applyTransform: (result: TransformResult) => {
+  success: boolean;
+  error?: string;
+};
+declare const previewOptionsTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, options: ReactGrabOptions) => TransformResult;
+declare const previewCdnTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, targetCdnDomain: string) => TransformResult;
+//#endregion
+//#region src/utils/install.d.ts
+interface InstallPackageOptions {
+  cwd?: string;
+  isDev?: boolean;
+  silent?: boolean;
+  packageManager?: PackageManager;
+  preferOffline?: boolean;
+  additionalArgs?: string[];
+}
+declare const installPackages: (packages: string[], options?: InstallPackageOptions) => Promise<void>;
+declare const getPackagesToInstall: (includeReactGrab?: boolean) => string[];
+//#endregion
+//#region src/utils/install-react-grab.d.ts
+type ReactGrabInstallErrorCode = "unsupported-framework" | "unknown-framework" | "transform-failed" | "install-failed" | "write-failed";
+declare class ReactGrabInstallError extends Error {
+  readonly code: ReactGrabInstallErrorCode;
+  constructor(message: string, code: ReactGrabInstallErrorCode, options?: ErrorOptions);
+}
+interface InstallReactGrabOptions {
+  cwd?: string;
+  framework?: Framework;
+  nextRouterType?: NextRouterType;
+  packageManager?: PackageManager;
+  skipPackageInstall?: boolean;
+  skipTransform?: boolean;
+  dryRun?: boolean;
+  installPackageOptions?: Omit<InstallPackageOptions, "cwd" | "packageManager">;
+}
+interface InstallReactGrabResult {
+  projectRoot: string;
+  framework: Framework;
+  nextRouterType: NextRouterType;
+  packageManager: PackageManager;
+  alreadyConfigured: boolean;
+  didInstallPackage: boolean;
+  didChangeFile: boolean;
+  dryRun: boolean;
+  transform: TransformResult;
+}
+declare const installReactGrab: (options?: InstallReactGrabOptions) => Promise<InstallReactGrabResult>;
+//#endregion
+//#region src/utils/install-skill.d.ts
+interface InstallSkillOptions {
+  agents?: SkillAgentType[];
+  global?: boolean;
+  cwd?: string;
+}
+declare const installSkill: ({
+  agents,
+  global,
+  cwd
+}?: InstallSkillOptions) => Promise<Awaited<ReturnType<typeof add>>>;
+interface RemoveSkillOptions {
+  cwd?: string;
+  global?: boolean;
+}
+declare const removeSkill: ({
+  cwd,
+  global
+}?: RemoveSkillOptions) => Promise<SkillAgentType[]>;
+//#endregion
+export { type Framework, type InstallPackageOptions, type InstallReactGrabOptions, type InstallReactGrabResult, type InstallSkillOptions, type NextRouterType, type PackageManager, type ProjectInfo, ReactGrabInstallError, type ReactGrabInstallErrorCode, type ReactGrabOptions, type TransformResult, type UnsupportedFramework, type WorkspaceProject, applyTransform, detectFramework, detectNextRouterType, detectPackageManager, detectProject, detectReactGrab, detectReactGrabConfigured, detectUnsupportedFramework, findReactProjects, getPackagesToInstall, hasFrameworkEntryPoint, installPackages, installReactGrab, installSkill, previewCdnTransform, previewOptionsTransform, previewTransform, removeSkill };
+//# sourceMappingURL=api.d.cts.map

package/dist/api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.cts","names":[],"sources":["../src/utils/detect.ts","../src/utils/transform.ts","../src/utils/install.ts","../src/utils/install-react-grab.ts","../src/utils/install-skill.ts"],"mappings":"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"}

package/dist/api.d.ts

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { SkillAgentType, add } from "agent-install/skill";
+
+//#region src/utils/detect.d.ts
+type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
+type Framework = "next" | "vite" | "tanstack" | "webpack" | "unknown";
+type NextRouterType = "app" | "pages" | "unknown";
+type UnsupportedFramework = "remix" | "astro" | "sveltekit" | "gatsby" | null;
+interface ProjectInfo {
+  packageManager: PackageManager;
+  framework: Framework;
+  nextRouterType: NextRouterType;
+  isMonorepo: boolean;
+  projectRoot: string;
+  hasReactGrab: boolean;
+  isReactGrabConfigured: boolean;
+  reactGrabVersion: string | null;
+  unsupportedFramework: UnsupportedFramework;
+}
+declare const detectPackageManager: (projectRoot: string) => Promise<PackageManager>;
+declare const detectFramework: (projectRoot: string) => Framework;
+declare const detectNextRouterType: (projectRoot: string) => NextRouterType;
+interface WorkspaceProject {
+  name: string;
+  path: string;
+  framework: Framework;
+}
+declare const findReactProjects: (projectRoot: string) => WorkspaceProject[];
+declare const detectReactGrabConfigured: (projectRoot: string) => boolean;
+declare const detectReactGrab: (projectRoot: string) => boolean;
+declare const detectUnsupportedFramework: (projectRoot: string) => UnsupportedFramework;
+declare const detectProject: (projectRoot?: string) => Promise<ProjectInfo>;
+//#endregion
+//#region src/utils/transform.d.ts
+interface TransformResult {
+  success: boolean;
+  filePath: string;
+  message: string;
+  originalContent?: string;
+  newContent?: string;
+  noChanges?: boolean;
+}
+interface ReactGrabOptions {
+  activationKey?: string;
+  activationMode?: "toggle" | "hold";
+  keyHoldDuration?: number;
+  allowActivationInsideInput?: boolean;
+  maxContextLines?: number;
+}
+declare const hasFrameworkEntryPoint: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType) => boolean;
+declare const previewTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, reactGrabAlreadyConfigured?: boolean) => TransformResult;
+declare const applyTransform: (result: TransformResult) => {
+  success: boolean;
+  error?: string;
+};
+declare const previewOptionsTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, options: ReactGrabOptions) => TransformResult;
+declare const previewCdnTransform: (projectRoot: string, framework: Framework, nextRouterType: NextRouterType, targetCdnDomain: string) => TransformResult;
+//#endregion
+//#region src/utils/install.d.ts
+interface InstallPackageOptions {
+  cwd?: string;
+  isDev?: boolean;
+  silent?: boolean;
+  packageManager?: PackageManager;
+  preferOffline?: boolean;
+  additionalArgs?: string[];
+}
+declare const installPackages: (packages: string[], options?: InstallPackageOptions) => Promise<void>;
+declare const getPackagesToInstall: (includeReactGrab?: boolean) => string[];
+//#endregion
+//#region src/utils/install-react-grab.d.ts
+type ReactGrabInstallErrorCode = "unsupported-framework" | "unknown-framework" | "transform-failed" | "install-failed" | "write-failed";
+declare class ReactGrabInstallError extends Error {
+  readonly code: ReactGrabInstallErrorCode;
+  constructor(message: string, code: ReactGrabInstallErrorCode, options?: ErrorOptions);
+}
+interface InstallReactGrabOptions {
+  cwd?: string;
+  framework?: Framework;
+  nextRouterType?: NextRouterType;
+  packageManager?: PackageManager;
+  skipPackageInstall?: boolean;
+  skipTransform?: boolean;
+  dryRun?: boolean;
+  installPackageOptions?: Omit<InstallPackageOptions, "cwd" | "packageManager">;
+}
+interface InstallReactGrabResult {
+  projectRoot: string;
+  framework: Framework;
+  nextRouterType: NextRouterType;
+  packageManager: PackageManager;
+  alreadyConfigured: boolean;
+  didInstallPackage: boolean;
+  didChangeFile: boolean;
+  dryRun: boolean;
+  transform: TransformResult;
+}
+declare const installReactGrab: (options?: InstallReactGrabOptions) => Promise<InstallReactGrabResult>;
+//#endregion
+//#region src/utils/install-skill.d.ts
+interface InstallSkillOptions {
+  agents?: SkillAgentType[];
+  global?: boolean;
+  cwd?: string;
+}
+declare const installSkill: ({
+  agents,
+  global,
+  cwd
+}?: InstallSkillOptions) => Promise<Awaited<ReturnType<typeof add>>>;
+interface RemoveSkillOptions {
+  cwd?: string;
+  global?: boolean;
+}
+declare const removeSkill: ({
+  cwd,
+  global
+}?: RemoveSkillOptions) => Promise<SkillAgentType[]>;
+//#endregion
+export { type Framework, type InstallPackageOptions, type InstallReactGrabOptions, type InstallReactGrabResult, type InstallSkillOptions, type NextRouterType, type PackageManager, type ProjectInfo, ReactGrabInstallError, type ReactGrabInstallErrorCode, type ReactGrabOptions, type TransformResult, type UnsupportedFramework, type WorkspaceProject, applyTransform, detectFramework, detectNextRouterType, detectPackageManager, detectProject, detectReactGrab, detectReactGrabConfigured, detectUnsupportedFramework, findReactProjects, getPackagesToInstall, hasFrameworkEntryPoint, installPackages, installReactGrab, installSkill, previewCdnTransform, previewOptionsTransform, previewTransform, removeSkill };
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","names":[],"sources":["../src/utils/detect.ts","../src/utils/transform.ts","../src/utils/install.ts","../src/utils/install-react-grab.ts","../src/utils/install-skill.ts"],"mappings":"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"}

package/dist/api.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { _ as detectReactGrabConfigured, a as previewCdnTransform, f as detectFramework, g as detectReactGrab, h as detectProject, i as hasFrameworkEntryPoint, l as installSkill, m as detectPackageManager, n as installPackages, o as previewOptionsTransform, p as detectNextRouterType, r as applyTransform, s as previewTransform, t as getPackagesToInstall, u as removeSkill, v as detectUnsupportedFramework, y as findReactProjects } from "./install-Car5vKPk.js";
+import { resolve } from "node:path";
+//#region src/utils/install-react-grab.ts
+var ReactGrabInstallError = class extends Error {
+	code;
+	constructor(message, code, options) {
+		super(message, options);
+		this.name = "ReactGrabInstallError";
+		this.code = code;
+	}
+};
+const installReactGrab = async (options = {}) => {
+	const project = await detectProject(resolve(options.cwd ?? process.cwd()));
+	const framework = options.framework ?? project.framework;
+	const packageManager = options.packageManager ?? project.packageManager;
+	if (project.unsupportedFramework && !options.framework) throw new ReactGrabInstallError(`${project.unsupportedFramework} is not supported by automatic setup.`, "unsupported-framework");
+	if (framework === "unknown") throw new ReactGrabInstallError("Could not detect a supported framework. Pass `framework` explicitly to override detection.", "unknown-framework");
+	const nextRouterType = options.nextRouterType ?? (framework === "next" && project.nextRouterType === "unknown" ? detectNextRouterType(project.projectRoot) : project.nextRouterType);
+	const alreadyConfigured = project.isReactGrabConfigured;
+	const transform = previewTransform(project.projectRoot, framework, nextRouterType, alreadyConfigured);
+	if (!transform.success && !options.skipTransform) throw new ReactGrabInstallError(transform.message, "transform-failed");
+	const didInstallPackage = !options.skipPackageInstall && !options.dryRun && !project.hasReactGrab;
+	if (didInstallPackage) try {
+		await installPackages(getPackagesToInstall(), {
+			...options.installPackageOptions,
+			cwd: project.projectRoot,
+			packageManager
+		});
+	} catch (error) {
+		throw new ReactGrabInstallError(error instanceof Error ? error.message : "Failed to install the react-grab package.", "install-failed", { cause: error });
+	}
+	const didChangeFile = !transform.noChanges && Boolean(transform.newContent) && !options.skipTransform && !options.dryRun;
+	if (didChangeFile) {
+		const writeResult = applyTransform(transform);
+		if (!writeResult.success) throw new ReactGrabInstallError(writeResult.error ?? `Failed to write to ${transform.filePath}`, "write-failed");
+	}
+	return {
+		projectRoot: project.projectRoot,
+		framework,
+		nextRouterType,
+		packageManager,
+		alreadyConfigured,
+		didInstallPackage,
+		didChangeFile,
+		dryRun: Boolean(options.dryRun),
+		transform
+	};
+};
+//#endregion
+export { ReactGrabInstallError, applyTransform, detectFramework, detectNextRouterType, detectPackageManager, detectProject, detectReactGrab, detectReactGrabConfigured, detectUnsupportedFramework, findReactProjects, getPackagesToInstall, hasFrameworkEntryPoint, installPackages, installReactGrab, installSkill, previewCdnTransform, previewOptionsTransform, previewTransform, removeSkill };
+
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":[],"sources":["../src/utils/install-react-grab.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport {\n  detectNextRouterType,\n  detectProject,\n  type Framework,\n  type NextRouterType,\n  type PackageManager,\n} from \"./detect.js\";\nimport { getPackagesToInstall, installPackages, type InstallPackageOptions } from \"./install.js\";\nimport { applyTransform, previewTransform, type TransformResult } from \"./transform.js\";\n\nexport type ReactGrabInstallErrorCode =\n  | \"unsupported-framework\"\n  | \"unknown-framework\"\n  | \"transform-failed\"\n  | \"install-failed\"\n  | \"write-failed\";\n\nexport class ReactGrabInstallError extends Error {\n  readonly code: ReactGrabInstallErrorCode;\n\n  constructor(message: string, code: ReactGrabInstallErrorCode, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"ReactGrabInstallError\";\n    this.code = code;\n  }\n}\n\nexport interface InstallReactGrabOptions {\n  cwd?: string;\n  framework?: Framework;\n  nextRouterType?: NextRouterType;\n  packageManager?: PackageManager;\n  skipPackageInstall?: boolean;\n  skipTransform?: boolean;\n  dryRun?: boolean;\n  installPackageOptions?: Omit<InstallPackageOptions, \"cwd\" | \"packageManager\">;\n}\n\nexport interface InstallReactGrabResult {\n  projectRoot: string;\n  framework: Framework;\n  nextRouterType: NextRouterType;\n  packageManager: PackageManager;\n  alreadyConfigured: boolean;\n  didInstallPackage: boolean;\n  didChangeFile: boolean;\n  dryRun: boolean;\n  transform: TransformResult;\n}\n\nexport const installReactGrab = async (\n  options: InstallReactGrabOptions = {},\n): Promise<InstallReactGrabResult> => {\n  const cwd = resolve(options.cwd ?? process.cwd());\n  const project = await detectProject(cwd);\n\n  const framework = options.framework ?? project.framework;\n  const packageManager = options.packageManager ?? project.packageManager;\n\n  if (project.unsupportedFramework && !options.framework) {\n    throw new ReactGrabInstallError(\n      `${project.unsupportedFramework} is not supported by automatic setup.`,\n      \"unsupported-framework\",\n    );\n  }\n\n  if (framework === \"unknown\") {\n    throw new ReactGrabInstallError(\n      \"Could not detect a supported framework. Pass `framework` explicitly to override detection.\",\n      \"unknown-framework\",\n    );\n  }\n\n  // Detection only resolves the router type when the *detected* framework is\n  // Next.js, so derive it ourselves when the caller overrides to Next.\n  const nextRouterType =\n    options.nextRouterType ??\n    (framework === \"next\" && project.nextRouterType === \"unknown\"\n      ? detectNextRouterType(project.projectRoot)\n      : project.nextRouterType);\n\n  const alreadyConfigured = project.isReactGrabConfigured;\n\n  const transform = previewTransform(\n    project.projectRoot,\n    framework,\n    nextRouterType,\n    alreadyConfigured,\n  );\n\n  if (!transform.success && !options.skipTransform) {\n    throw new ReactGrabInstallError(transform.message, \"transform-failed\");\n  }\n\n  const didInstallPackage = !options.skipPackageInstall && !options.dryRun && !project.hasReactGrab;\n\n  if (didInstallPackage) {\n    try {\n      await installPackages(getPackagesToInstall(), {\n        ...options.installPackageOptions,\n        cwd: project.projectRoot,\n        packageManager,\n      });\n    } catch (error) {\n      throw new ReactGrabInstallError(\n        error instanceof Error ? error.message : \"Failed to install the react-grab package.\",\n        \"install-failed\",\n        { cause: error },\n      );\n    }\n  }\n\n  // Mirrors applyTransform's own write guard (it does not require originalContent),\n  // so an empty source file still receives the injected setup.\n  const hasPendingFileChange = !transform.noChanges && Boolean(transform.newContent);\n  const didChangeFile = hasPendingFileChange && !options.skipTransform && !options.dryRun;\n\n  if (didChangeFile) {\n    const writeResult = applyTransform(transform);\n    if (!writeResult.success) {\n      throw new ReactGrabInstallError(\n        writeResult.error ?? `Failed to write to ${transform.filePath}`,\n        \"write-failed\",\n      );\n    }\n  }\n\n  return {\n    projectRoot: project.projectRoot,\n    framework,\n    nextRouterType,\n    packageManager,\n    alreadyConfigured,\n    didInstallPackage,\n    didChangeFile,\n    dryRun: Boolean(options.dryRun),\n    transform,\n  };\n};\n"],"mappings":";;;;AAkBA,IAAa,wBAAb,cAA2C,MAAM;CAC/C;CAEA,YAAY,SAAiB,MAAiC,SAAwB;AACpF,QAAM,SAAS,QAAQ;AACvB,OAAK,OAAO;AACZ,OAAK,OAAO;;;AA2BhB,MAAa,mBAAmB,OAC9B,UAAmC,EAAE,KACD;CAEpC,MAAM,UAAU,MAAM,cADV,QAAQ,QAAQ,OAAO,QAAQ,KAAK,CACT,CAAC;CAExC,MAAM,YAAY,QAAQ,aAAa,QAAQ;CAC/C,MAAM,iBAAiB,QAAQ,kBAAkB,QAAQ;AAEzD,KAAI,QAAQ,wBAAwB,CAAC,QAAQ,UAC3C,OAAM,IAAI,sBACR,GAAG,QAAQ,qBAAqB,wCAChC,wBACD;AAGH,KAAI,cAAc,UAChB,OAAM,IAAI,sBACR,8FACA,oBACD;CAKH,MAAM,iBACJ,QAAQ,mBACP,cAAc,UAAU,QAAQ,mBAAmB,YAChD,qBAAqB,QAAQ,YAAY,GACzC,QAAQ;CAEd,MAAM,oBAAoB,QAAQ;CAElC,MAAM,YAAY,iBAChB,QAAQ,aACR,WACA,gBACA,kBACD;AAED,KAAI,CAAC,UAAU,WAAW,CAAC,QAAQ,cACjC,OAAM,IAAI,sBAAsB,UAAU,SAAS,mBAAmB;CAGxE,MAAM,oBAAoB,CAAC,QAAQ,sBAAsB,CAAC,QAAQ,UAAU,CAAC,QAAQ;AAErF,KAAI,kBACF,KAAI;AACF,QAAM,gBAAgB,sBAAsB,EAAE;GAC5C,GAAG,QAAQ;GACX,KAAK,QAAQ;GACb;GACD,CAAC;UACK,OAAO;AACd,QAAM,IAAI,sBACR,iBAAiB,QAAQ,MAAM,UAAU,6CACzC,kBACA,EAAE,OAAO,OAAO,CACjB;;CAOL,MAAM,gBADuB,CAAC,UAAU,aAAa,QAAQ,UAAU,WAAW,IACpC,CAAC,QAAQ,iBAAiB,CAAC,QAAQ;AAEjF,KAAI,eAAe;EACjB,MAAM,cAAc,eAAe,UAAU;AAC7C,MAAI,CAAC,YAAY,QACf,OAAM,IAAI,sBACR,YAAY,SAAS,sBAAsB,UAAU,YACrD,eACD;;AAIL,QAAO;EACL,aAAa,QAAQ;EACrB;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ,QAAQ,QAAQ,OAAO;EAC/B;EACD"}