@alexgorbatchev/dotfiles 0.0.1

package/schemas.d.ts

@@ -0,0 +1,2730 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { z } from 'zod';
+
+type Resolvable<TParams, TReturn> = TReturn | ((params: TParams) => TReturn) | ((params: TParams) => Promise<TReturn>);
+/**
+ * Strips common leading whitespace from all lines in a string.
+ * This is useful for cleaning up template literals that are indented for readability.
+ *
+ * @param str - The string to dedent
+ * @returns The dedented string with common leading whitespace removed
+ *
+ * @example
+ * ```typescript
+ * const indented = `
+ *   function hello() {
+ *     echo "Hello World"
+ *   }
+ * `;
+ *
+ * const dedented = dedentString(indented);
+ * // Result:
+ * // function hello() {
+ * //   echo "Hello World"
+ * // }
+ * ```
+ */
+export declare function dedentString(str: string): string;
+/**
+ * Processes a template string by removing common indentation and replacing placeholders with values.
+ *
+ * This function:
+ * - Removes common leading whitespace using the dedent function
+ * - Replaces standalone placeholders (e.g., {key}) with properly indented multiline values
+ * - Replaces inline placeholders within text with their corresponding values
+ *
+ * @param template - The template string containing placeholders in the format {key}
+ * @param values - An object mapping placeholder keys to their replacement values
+ * @returns The processed string with proper indentation and replaced placeholders
+ */
+export declare function dedentTemplate(template: string, values: Record<string, string>): string;
+interface IFileSystem {
+	/**
+	 * Reads the entire content of a file.
+	 * @param path - A path to a file.
+	 * @param encoding - The encoding to use.
+	 * @returns A promise that resolves with the file content as a string.
+	 */
+	readFile(path: string, encoding?: BufferEncoding): Promise<string>;
+	/**
+	 * Reads the entire content of a file.
+	 * @param path - A path to a file.
+	 * @returns A promise that resolves with the file content as a Buffer.
+	 */
+	readFileBuffer(path: string): Promise<Buffer>;
+	/**
+	 * Asynchronously writes data to a file, replacing the file if it already exists.
+	 * @param path - A path to a file.
+	 * @param content - The content to write.
+	 * @param encoding - The encoding to use.
+	 * @returns A promise that resolves when the file has been written.
+	 */
+	writeFile(path: string, content: string | NodeJS.ArrayBufferView, encoding?: BufferEncoding): Promise<void>;
+	/**
+	 * Checks if a file or directory exists.
+	 * @param path - A path to a file or directory.
+	 * @returns A promise that resolves with `true` if the path exists, `false` otherwise.
+	 */
+	exists(path: string): Promise<boolean>;
+	/**
+	 * Asynchronously creates a directory.
+	 * @param path - A path to a directory.
+	 * @param options - Options for creating the directory.
+	 * @returns A promise that resolves when the directory has been created.
+	 */
+	mkdir(path: string, options?: {
+		recursive?: boolean;
+	}): Promise<void>;
+	/**
+	 * Reads the contents of a directory.
+	 * @param path - A path to a directory.
+	 * @returns A promise that resolves with an array of file and directory names.
+	 */
+	readdir(path: string): Promise<string[]>;
+	/**
+	 * Removes a file or directory.
+	 * @param path - A path to a file or directory.
+	 * @param options - Options for removal.
+	 * @returns A promise that resolves when the file or directory has been removed.
+	 */
+	rm(path: string, options?: {
+		recursive?: boolean;
+		force?: boolean;
+	}): Promise<void>;
+	/**
+	 * Asynchronously removes a directory.
+	 * @param path - A path to a directory.
+	 * @param options - Options for removing the directory.
+	 * @returns A promise that resolves when the directory has been removed.
+	 * @deprecated Use {@link IFileSystem.rm} with `recursive: true` instead.
+	 */
+	rmdir(path: string, options?: {
+		recursive?: boolean;
+	}): Promise<void>;
+	/**
+	 * Gets file or directory stats.
+	 * @param path - A path to a file or directory.
+	 * @returns A promise that resolves with the {@link NodeStats} object.
+	 */
+	stat(path: string): Promise<NodeStats>;
+	/**
+	 * Gets file or directory stats without following symbolic links.
+	 * @param path - A path to a file or directory.
+	 * @returns A promise that resolves with the {@link NodeStats} object for the link itself.
+	 */
+	lstat(path: string): Promise<NodeStats>;
+	/**
+	 * Creates a symbolic link.
+	 * @param target - A path the symbolic link will point to.
+	 * @param path - A path where the symbolic link will be created.
+	 * @param type - The type of symbolic link ('file', 'dir', or 'junction').
+	 * @returns A promise that resolves when the symbolic link has been created.
+	 */
+	symlink(target: string, path: string, type?: "file" | "dir" | "junction"): Promise<void>;
+	/**
+	 * Reads the value of a symbolic link.
+	 * @param path - A path to a symbolic link.
+	 * @returns A promise that resolves with the target path as a string.
+	 */
+	readlink(path: string): Promise<string>;
+	/**
+	 * Changes the permissions of a file or directory.
+	 * @param path - A path to a file or directory.
+	 * @param mode - The permissions mode (e.g., `0o755`).
+	 * @returns A promise that resolves when the permissions have been changed.
+	 */
+	chmod(path: string, mode: number | string): Promise<void>;
+	/**
+	 * Asynchronously copies a file.
+	 * @param src - The source file path.
+	 * @param dest - The destination file path.
+	 * @param flags - Optional flags for the copy operation.
+	 * @returns A promise that resolves when the file has been copied.
+	 */
+	copyFile(src: string, dest: string, flags?: number): Promise<void>;
+	/**
+	 * Asynchronously renames a file or directory.
+	 * @param oldPath - The current path.
+	 * @param newPath - The new path.
+	 * @returns A promise that resolves when the rename operation is complete.
+	 */
+	rename(oldPath: string, newPath: string): Promise<void>;
+	/**
+	 * Ensures that a directory exists. If the directory structure does not exist, it is created.
+	 * @param path - A path of the directory.
+	 * @returns A promise that resolves when the directory exists.
+	 */
+	ensureDir(path: string): Promise<void>;
+}
+type ReplaceInFileMode = "file" | "line";
+type ReplaceCapture = string | undefined;
+type ReplaceGroups = Record<string, string>;
+interface IReplaceInFileMatch {
+	substring: string;
+	captures: ReplaceCapture[];
+	offset: number;
+	input: string;
+	groups?: ReplaceGroups;
+}
+type ReplaceInFileReplacer = Resolvable<IReplaceInFileMatch, string>;
+type ReplaceInFilePattern = RegExp | string;
+declare const projectConfigSchema: z.ZodObject<{
+	paths: z.ZodDefault<z.ZodObject<{
+		homeDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		dotfilesDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		targetDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		generatedDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		toolConfigsDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		shellScriptsDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		binariesDir: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+	}, z.core.$strict>>;
+	system: z.ZodDefault<z.ZodObject<{
+		sudoPrompt: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+	}, z.core.$strict>>;
+	logging: z.ZodDefault<z.ZodObject<{
+		debug: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+	}, z.core.$strict>>;
+	updates: z.ZodDefault<z.ZodObject<{
+		checkOnRun: z.ZodNonOptional<z.ZodDefault<z.ZodBoolean>>;
+		checkInterval: z.ZodNonOptional<z.ZodDefault<z.ZodNumber>>;
+	}, z.core.$strict>>;
+	github: z.ZodDefault<z.ZodObject<{
+		host: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		cache: z.ZodNonOptional<z.ZodDefault<z.ZodObject<{
+			enabled: z.ZodDefault<z.ZodBoolean>;
+			ttl: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strict>>>;
+		token: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+		userAgent: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+	}, z.core.$strict>>;
+	cargo: z.ZodDefault<z.ZodObject<{
+		cratesIo: z.ZodNonOptional<z.ZodDefault<z.ZodObject<{
+			host: z.ZodDefault<z.ZodString>;
+			cache: z.ZodDefault<z.ZodObject<{
+				enabled: z.ZodDefault<z.ZodBoolean>;
+				ttl: z.ZodDefault<z.ZodNumber>;
+			}, z.core.$strict>>;
+			token: z.ZodDefault<z.ZodString>;
+			userAgent: z.ZodDefault<z.ZodString>;
+		}, z.core.$strict>>>;
+		githubRaw: z.ZodNonOptional<z.ZodDefault<z.ZodObject<{
+			host: z.ZodDefault<z.ZodString>;
+			cache: z.ZodDefault<z.ZodObject<{
+				enabled: z.ZodDefault<z.ZodBoolean>;
+				ttl: z.ZodDefault<z.ZodNumber>;
+			}, z.core.$strict>>;
+			token: z.ZodDefault<z.ZodString>;
+			userAgent: z.ZodDefault<z.ZodString>;
+		}, z.core.$strict>>>;
+		githubRelease: z.ZodNonOptional<z.ZodDefault<z.ZodObject<{
+			host: z.ZodDefault<z.ZodString>;
+			cache: z.ZodDefault<z.ZodObject<{
+				enabled: z.ZodDefault<z.ZodBoolean>;
+				ttl: z.ZodDefault<z.ZodNumber>;
+			}, z.core.$strict>>;
+			token: z.ZodDefault<z.ZodString>;
+			userAgent: z.ZodDefault<z.ZodString>;
+		}, z.core.$strict>>>;
+		userAgent: z.ZodNonOptional<z.ZodDefault<z.ZodString>>;
+	}, z.core.$strict>>;
+	downloader: z.ZodDefault<z.ZodObject<{
+		timeout: z.ZodNonOptional<z.ZodDefault<z.ZodNumber>>;
+		retryCount: z.ZodNonOptional<z.ZodDefault<z.ZodNumber>>;
+		retryDelay: z.ZodNonOptional<z.ZodDefault<z.ZodNumber>>;
+		cache: z.ZodNonOptional<z.ZodDefault<z.ZodObject<{
+			enabled: z.ZodDefault<z.ZodBoolean>;
+			ttl: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strict>>>;
+	}, z.core.$strict>>;
+	features: z.ZodDefault<z.ZodObject<{
+		catalog: z.ZodDefault<z.ZodObject<{
+			generate: z.ZodDefault<z.ZodBoolean>;
+			filePath: z.ZodDefault<z.ZodString>;
+		}, z.core.$strict>>;
+		shellInstall: z.ZodOptional<z.ZodObject<{
+			zsh: z.ZodOptional<z.ZodString>;
+			bash: z.ZodOptional<z.ZodString>;
+			powershell: z.ZodOptional<z.ZodString>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	platform: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		match: z.ZodArray<z.ZodUnion<readonly [
+			z.ZodObject<{
+				os: z.ZodEnum<{
+					linux: "linux";
+					macos: "macos";
+					windows: "windows";
+				}>;
+				arch: z.ZodOptional<z.ZodEnum<{
+					arm64: "arm64";
+					x86_64: "x86_64";
+				}>>;
+			}, z.core.$strict>,
+			z.ZodObject<{
+				os: z.ZodOptional<z.ZodEnum<{
+					linux: "linux";
+					macos: "macos";
+					windows: "windows";
+				}>>;
+				arch: z.ZodEnum<{
+					arm64: "arm64";
+					x86_64: "x86_64";
+				}>;
+			}, z.core.$strict>
+		]>>;
+		config: z.ZodObject<{
+			paths: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				homeDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				dotfilesDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				targetDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				generatedDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				toolConfigsDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				shellScriptsDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				binariesDir: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+			}, z.core.$strict>>>;
+			system: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				sudoPrompt: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+			}, z.core.$strict>>>;
+			logging: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				debug: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+			}, z.core.$strict>>>;
+			updates: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				checkOnRun: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+				checkInterval: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+			}, z.core.$strict>>>;
+			github: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				host: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				cache: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					enabled: z.ZodDefault<z.ZodBoolean>;
+					ttl: z.ZodDefault<z.ZodNumber>;
+				}, z.core.$strict>>>;
+				token: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+				userAgent: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+			}, z.core.$strict>>>;
+			cargo: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				cratesIo: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					host: z.ZodDefault<z.ZodString>;
+					cache: z.ZodDefault<z.ZodObject<{
+						enabled: z.ZodDefault<z.ZodBoolean>;
+						ttl: z.ZodDefault<z.ZodNumber>;
+					}, z.core.$strict>>;
+					token: z.ZodDefault<z.ZodString>;
+					userAgent: z.ZodDefault<z.ZodString>;
+				}, z.core.$strict>>>;
+				githubRaw: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					host: z.ZodDefault<z.ZodString>;
+					cache: z.ZodDefault<z.ZodObject<{
+						enabled: z.ZodDefault<z.ZodBoolean>;
+						ttl: z.ZodDefault<z.ZodNumber>;
+					}, z.core.$strict>>;
+					token: z.ZodDefault<z.ZodString>;
+					userAgent: z.ZodDefault<z.ZodString>;
+				}, z.core.$strict>>>;
+				githubRelease: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					host: z.ZodDefault<z.ZodString>;
+					cache: z.ZodDefault<z.ZodObject<{
+						enabled: z.ZodDefault<z.ZodBoolean>;
+						ttl: z.ZodDefault<z.ZodNumber>;
+					}, z.core.$strict>>;
+					token: z.ZodDefault<z.ZodString>;
+					userAgent: z.ZodDefault<z.ZodString>;
+				}, z.core.$strict>>>;
+				userAgent: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+			}, z.core.$strict>>>;
+			downloader: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+				retryCount: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+				retryDelay: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+				cache: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					enabled: z.ZodDefault<z.ZodBoolean>;
+					ttl: z.ZodDefault<z.ZodNumber>;
+				}, z.core.$strict>>>;
+			}, z.core.$strict>>>;
+			features: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+				catalog: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+					generate: z.ZodDefault<z.ZodBoolean>;
+					filePath: z.ZodDefault<z.ZodString>;
+				}, z.core.$strict>>>;
+				shellInstall: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+					zsh: z.ZodOptional<z.ZodString>;
+					bash: z.ZodOptional<z.ZodString>;
+					powershell: z.ZodOptional<z.ZodString>;
+				}, z.core.$strict>>>;
+			}, z.core.$strict>>>;
+		}, z.core.$strict>;
+	}, z.core.$strict>>>;
+}, z.core.$strict>;
+type ProjectConfigPartial = PartialDeep<ProjectConfig>;
+declare const privateProjectConfigFields: z.ZodObject<{
+	configFilePath: z.ZodString;
+	configFileDir: z.ZodString;
+}, z.core.$strip>;
+type ProjectConfig = z.infer<typeof projectConfigSchema> & z.infer<typeof privateProjectConfigFields>;
+/**
+ * Represents operating system platforms using a bitwise enum, allowing for
+ * combinations of multiple platforms.
+ *
+ * @example
+ * ```typescript
+ * const supported = Platform.Linux | Platform.MacOS;
+ * if (supported & Platform.Linux) {
+ *   // Supported on Linux
+ * }
+ * ```
+ */
+export declare enum Platform {
+	/** Represents no specific platform. */
+	None = 0,
+	/** The Linux operating system. */
+	Linux = 1,
+	/** The macOS operating system. */
+	MacOS = 2,
+	/** The Windows operating system. */
+	Windows = 4,
+	/** A combination of Unix-like systems (Linux and macOS). */
+	Unix = 3,
+	/** A combination of all supported platforms. */
+	All = 7
+}
+/**
+ * Represents CPU architectures using a bitwise enum, allowing for combinations.
+ *
+ * @example
+ * ```typescript
+ * const supported = Architecture.X86_64 | Architecture.Arm64;
+ * if (supported & Architecture.Arm64) {
+ *   // Supported on ARM64
+ * }
+ * ```
+ */
+export declare enum Architecture {
+	/** Represents no specific architecture. */
+	None = 0,
+	/** The 64-bit x86 architecture (also known as AMD64). */
+	X86_64 = 1,
+	/** The 64-bit ARM architecture. */
+	Arm64 = 2,
+	/** A combination of all supported architectures. */
+	All = 3
+}
+/**
+ * Represents essential system information used for architecture detection and compatibility checks.
+ * This information is typically derived from the operating system's properties.
+ * It is used as input, for example, to `getArchitectureRegex` for testability via Dependency Injection.
+ */
+interface ISystemInfo {
+	/**
+	 * The operating system platform.
+	 */
+	platform: Platform;
+	/**
+	 * The CPU architecture.
+	 */
+	arch: Architecture;
+	/**
+	 * The user's home directory path.
+	 * Corresponds to the value returned by `os.homedir()` in Node.js.
+	 * Used for expanding tilde (~) in file paths.
+	 */
+	homeDir: string;
+	/**
+	 * The machine hostname.
+	 * Corresponds to the value returned by `os.hostname()` in Node.js.
+	 * Used for hostname-based tool filtering.
+	 */
+	hostname: string;
+}
+interface IToolLog {
+	/**
+	 * Log a trace-level message (most verbose).
+	 * @param message - The message to log
+	 */
+	trace(message: string): void;
+	/**
+	 * Log a debug-level message.
+	 * @param message - The message to log
+	 */
+	debug(message: string): void;
+	/**
+	 * Log an info-level message.
+	 * @param message - The message to log
+	 */
+	info(message: string): void;
+	/**
+	 * Log a warning-level message.
+	 * @param message - The message to log
+	 */
+	warn(message: string): void;
+	/**
+	 * Log an error-level message.
+	 * @param message - The message to log
+	 * @param error - Optional error object to include in the log output
+	 */
+	error(message: string, error?: unknown): void;
+}
+interface IBoundReplaceInFileOptions {
+	/** Optional. Defaults to `'file'` when not provided. */
+	mode?: ReplaceInFileMode;
+	/**
+	 * Optional error message to log if no replacements were made.
+	 *
+	 * When provided and no matches are found, an error is logged with the tool name prefix:
+	 * `[toolName] <errorMessage>`
+	 *
+	 * This is useful for detecting when expected patterns aren't found in config files.
+	 *
+	 * @example
+	 * ```ts
+	 * await ctx.replaceInFile(
+	 *   `${ctx.installedDir}/config.toml`,
+	 *   /theme = ".*"/,
+	 *   'theme = "dark"',
+	 *   { errorMessage: 'Could not find theme setting in config.toml' }
+	 * );
+	 * ```
+	 */
+	errorMessage?: string;
+}
+type BoundReplaceInFile = (filePath: string, from: ReplaceInFilePattern, to: ReplaceInFileReplacer, options?: IBoundReplaceInFileOptions) => Promise<boolean>;
+type BoundResolve = (pattern: string) => string;
+interface IBaseToolContext {
+	/**
+	 * The user's parsed application configuration from the main `config.ts` file.
+	 */
+	projectConfig: ProjectConfig;
+	/**
+	 * Information about the system on which the installation is occurring
+	 * (e.g., platform, architecture).
+	 */
+	systemInfo: ISystemInfo;
+	/**
+	 * The name of the tool currently being processed.
+	 */
+	toolName: string;
+	/**
+	 * Absolute path to the directory containing the tool's `.tool.ts` file.
+	 *
+	 * This is the **tool configuration directory**. It is the reference point for all
+	 * relative paths in `.tool.ts` files (for example `./config.toml`, `./themes/`, etc.).
+	 *
+	 * This value is derived from the path to the `.tool.ts` file itself.
+	 *
+	 * @example
+	 * If your tool config is located at:
+	 * `"${projectConfig.paths.toolConfigsDir}/fzf/fzf.tool.ts"`
+	 * then:
+	 * `toolDir === "${projectConfig.paths.toolConfigsDir}/fzf"`
+	 *
+	 * @example
+	 * Use `toolDir` to reference a file next to the tool config:
+	 * `"${toolDir}/shell/key-bindings.zsh"`
+	 */
+	toolDir: string;
+	/**
+	 * Absolute path to the tool's stable "current" directory.
+	 *
+	 * This is always the path where the installer will create the `current` symlink:
+	 * `"${projectConfig.paths.binariesDir}/${toolName}/current"`.
+	 *
+	 * Lifecycle note:
+	 * - This path is always present on the context.
+	 * - The directory/symlink on disk typically only exists **after a successful install**
+	 *   (i.e. from post-install hooks onward).
+	 * - Hooks that run before installation must not assume it exists.
+	 */
+	currentDir: string;
+	/**
+	 * Performs a regex-based replacement within a file.
+	 *
+	 * Pre-bound with the resolved file system. See {@link BoundReplaceInFile} for full documentation.
+	 *
+	 * @returns `true` if replacements were made, `false` if no matches found
+	 *
+	 * @example
+	 * ```ts
+	 * // Replace all occurrences of 'foo' with 'bar'
+	 * const wasReplaced = await ctx.replaceInFile('/path/to/file', /foo/, 'bar');
+	 *
+	 * // Line-by-line replacement with callback
+	 * await ctx.replaceInFile('~/config.txt', /version=(\d+)/, (match) => {
+	 *   return `version=${Number(match.captures[0]) + 1}`;
+	 * }, { mode: 'line' });
+	 *
+	 * // Log error if pattern not found
+	 * await ctx.replaceInFile(
+	 *   '~/config.txt',
+	 *   /theme = ".*"/,
+	 *   'theme = "dark"',
+	 *   { errorMessage: 'Could not find theme setting' }
+	 * );
+	 * ```
+	 */
+	replaceInFile: BoundReplaceInFile;
+	/**
+	 * A user-facing logger for logging messages from tool configurations and hooks.
+	 *
+	 * All log messages are automatically prefixed with `[toolName]` to identify which
+	 * tool produced the output.
+	 *
+	 * @example
+	 * ```ts
+	 * export default defineTool((install, ctx) =>
+	 *   install('github-release', { repo: 'sharkdp/bat' })
+	 *     .bin('bat')
+	 *     .hook('after-install', async () => {
+	 *       ctx.log.info('Running post-install setup...');
+	 *       ctx.log.debug('Checking configuration files');
+	 *     })
+	 * );
+	 * ```
+	 */
+	log: IToolLog;
+	/**
+	 * Resolves a glob pattern to a single path.
+	 *
+	 * Use this when you need to reference a file or directory with a flexible name
+	 * (e.g., versioned directories, platform-specific binaries) and expect exactly
+	 * one match.
+	 *
+	 * The pattern is resolved relative to `toolDir` unless it's an absolute path.
+	 * Returns the absolute path of the matched file or directory.
+	 *
+	 * **Throws** if zero matches or multiple matches are found (stops tool processing).
+	 *
+	 * @param pattern - Glob pattern to match
+	 * @returns The resolved absolute path
+	 *
+	 * @example
+	 * ```ts
+	 * // Resolve a versioned directory
+	 * const versionDir = ctx.resolve('ripgrep-*-x86_64-*');
+	 *
+	 * // Use in shell configuration
+	 * export default defineTool((install, ctx) =>
+	 *   install('github-release', { repo: 'owner/tool' })
+	 *     .bin('tool')
+	 *     .zsh((shell) =>
+	 *       shell.always(`source "${ctx.resolve('completions/*.zsh')}"`))
+	 * );
+	 * ```
+	 */
+	resolve: BoundResolve;
+}
+interface IExtractResult {
+	/** An array of absolute paths to all files that were successfully extracted. */
+	extractedFiles: string[];
+	/**
+	 * An array of absolute paths to files that were identified as executables
+	 * and had their permissions set accordingly.
+	 */
+	executables: string[];
+}
+interface IGitHubReleaseAsset {
+	/** The name of the asset file (e.g., `mytool-linux-amd64.tar.gz`). */
+	name: string;
+	/** The direct URL for downloading the asset. */
+	browser_download_url: string;
+	/** The size of the asset in bytes. */
+	size: number;
+	/** The MIME type of the asset (e.g., `application/gzip`). */
+	content_type: string;
+	/** The state of the asset, typically 'uploaded'. */
+	state: "uploaded" | "open";
+	/** The number of times this asset has been downloaded. */
+	download_count: number;
+	/** An ISO 8601 timestamp string for when the asset was created. */
+	created_at: string;
+	/** An ISO 8601 timestamp string for when the asset was last updated. */
+	updated_at: string;
+}
+interface IGitHubRelease {
+	/** The unique identifier for the release. */
+	id: number;
+	/** The tag name associated with the release (e.g., `v1.0.0`). */
+	tag_name: string;
+	/** The display name of the release (e.g., `Version 1.0.0`). */
+	name: string;
+	/** `true` if the release is a draft (unpublished); `false` otherwise. */
+	draft: boolean;
+	/** `true` if the release is marked as a pre-release; `false` otherwise. */
+	prerelease: boolean;
+	/** An ISO 8601 timestamp string for when the release was created. */
+	created_at: string;
+	/** An ISO 8601 timestamp string for when the release was published. Can be `null` for drafts. */
+	published_at: string;
+	/** An array of {@link IGitHubReleaseAsset} objects associated with this release. */
+	assets: IGitHubReleaseAsset[];
+	/** The release notes or description, often in Markdown format. */
+	body?: string;
+	/** The URL to view this release on the GitHub website. */
+	html_url: string;
+}
+interface ShellResult {
+	/** Exit code of the process */
+	code: number;
+	/** Stdout as string */
+	stdout: string;
+	/** Stderr as string */
+	stderr: string;
+}
+interface ShellCommand extends PromiseLike<ShellResult> {
+	/** Set working directory */
+	cwd(path: string): ShellCommand;
+	/** Set/merge environment variables */
+	env(vars: Record<string, string | undefined>): ShellCommand;
+	/** Suppress output logging (command still logged) */
+	quiet(): ShellCommand;
+	/** Don't throw on non-zero exit code, return result with code instead */
+	noThrow(): ShellCommand;
+	/** Get stdout as trimmed string */
+	text(): Promise<string>;
+	/** Parse stdout as JSON */
+	json<T = unknown>(): Promise<T>;
+	/** Get stdout as array of lines */
+	lines(): Promise<string[]>;
+	/** Get stdout as bytes */
+	bytes(): Promise<Uint8Array>;
+}
+interface Shell {
+	(strings: TemplateStringsArray, ...values: unknown[]): ShellCommand;
+	(command: string): ShellCommand;
+}
+interface IEnvContext {
+	/** Project configuration with paths and settings */
+	projectConfig: ProjectConfig;
+	/**
+	 * The absolute path to the temporary staging directory for this installation attempt.
+	 * After successful installation, the entire directory is renamed to the versioned path.
+	 */
+	stagingDir: string;
+}
+interface IInstallBaseContext extends IBaseToolContext {
+	/**
+	 * The full tool configuration being processed.
+	 *
+	 * This is the resolved `ToolConfig` for the current tool, including any platform-specific overrides.
+	 */
+	toolConfig: ToolConfig;
+	/**
+	 * A timestamp for the current installation attempt.
+	 *
+	 * Used as a stable identifier for this run and as a fallback version label when a version
+	 * cannot be resolved.
+	 *
+	 * @example
+	 * `timestamp === "2025-12-23-09-41-12"`
+	 */
+	timestamp: string;
+	/**
+	 * Bun's shell executor for running shell commands that inherit the current environment.
+	 *
+	 * Use the `$` tagged template literal to execute shell commands within hooks.
+	 * The working directory can be changed using `cd` commands or `process.chdir()`.
+	 */
+	$: Shell;
+	/**
+	 * An instance of the file system for performing file operations.
+	 */
+	fileSystem: IFileSystem;
+	/**
+	 * The installation environment variables.
+	 *
+	 * This includes the recursion guard and modified PATH for the current installation.
+	 * Used internally by HookExecutor to create shells with output streaming while
+	 * preserving the installation environment.
+	 */
+	installEnv?: Record<string, string | undefined>;
+}
+interface IInstallContext extends IInstallBaseContext {
+	/**
+	 * Per-attempt staging directory for this installation attempt.
+	 *
+	 * This is a transient workspace for download/extract/build steps and may be removed or renamed
+	 * after installation. Do not persist references to this directory.
+	 *
+	 * For successful managed installs, this directory is typically renamed to `installedDir`.
+	 *
+	 * @example
+	 * `stagingDir === "${projectConfig.paths.binariesDir}/${toolName}/<uuid>"`
+	 */
+	stagingDir: string;
+}
+interface IDownloadContext extends IInstallContext {
+	/**
+	 * The path to the downloaded file or archive.
+	 *
+	 * This is the on-disk artifact produced by the download step (e.g., a `.tar.gz`, `.zip`, or
+	 * standalone binary) stored under the current `stagingDir`.
+	 *
+	 * @example
+	 * `downloadPath === "${stagingDir}/downloads/tool.tar.gz"`
+	 */
+	downloadPath: string;
+}
+interface IExtractContext extends IDownloadContext {
+	/**
+	 * The path to the directory where the archive contents were extracted.
+	 *
+	 * This is a transient directory under `stagingDir` containing the extracted payload.
+	 * Hooks commonly move binaries out of this directory into a stable layout under `stagingDir`
+	 * before the installer finalizes the installation.
+	 *
+	 * @example
+	 * `extractDir === "${stagingDir}/extracted"`
+	 */
+	extractDir: string;
+	/**
+	 * The result of the archive extraction process.
+	 *
+	 * Contains extraction metadata such as which files were extracted.
+	 */
+	extractResult: IExtractResult;
+}
+interface IAfterInstallContext extends IInstallBaseContext {
+	/**
+	 * The final installation directory.
+	 *
+	 * For managed installers, this is versioned when a version is known.
+	 * For externally managed installers (e.g., Homebrew), this is typically the tool's
+	 * managed directory under the tool root (e.g., `external`).
+	 *
+	 * `currentDir` is repointed to this directory after a successful install.
+	 *
+	 * @example
+	 * Managed: `installedDir === "${projectConfig.paths.binariesDir}/${toolName}/1.2.3"`
+	 *
+	 * @example
+	 * External: `installedDir === "${projectConfig.paths.binariesDir}/${toolName}/external"`
+	 */
+	installedDir: string;
+	/**
+	 * Absolute paths to installed binaries.
+	 *
+	 * These paths point at the *real* installed executables for this successful install.
+	 * For multi-binary tools, this can include multiple entries.
+	 *
+	 * If you need a single “primary” binary, use `binaryPaths[0]`.
+	 *
+	 * @example
+	 * Single binary: `binaryPaths === ["${installedDir}/rg"]`
+	 *
+	 * @example
+	 * Multi-binary: `binaryPaths === ["${installedDir}/node", "${installedDir}/npm", "${installedDir}/npx"]`
+	 */
+	binaryPaths: string[];
+	/**
+	 * The version of the installed tool.
+	 *
+	 * This is populated when the installer can determine a version (e.g., from a release tag
+	 * or an installer-specific version source). For externally managed installers, or when
+	 * the version cannot be resolved, this may be `undefined`.
+	 *
+	 * @example
+	 * `version === "1.2.3"`
+	 */
+	version?: string;
+}
+type AsyncInstallHook<T extends IInstallBaseContext = IInstallContext> = {
+	bivarianceHack(context: T): Promise<void>;
+}["bivarianceHack"];
+type OnceScript = {
+	readonly kind: "once";
+	readonly value: string;
+};
+type AlwaysScript = {
+	readonly kind: "always";
+	readonly value: string;
+};
+type RawScript = {
+	readonly kind: "raw";
+	readonly value: string;
+};
+type ShellScript = OnceScript | AlwaysScript | RawScript;
+type Primitive = string | number | bigint | boolean | symbol | undefined | null;
+type DeepPartialArray<T extends readonly unknown[]> = number extends T["length"] ? readonly PartialDeep<T[number]>[] : {
+	[K in keyof T]?: PartialDeep<T[K]>;
+};
+type DeepPartialSet<T> = T extends Set<infer TValue> ? Set<PartialDeep<TValue>> : T extends ReadonlySet<infer TValue> ? ReadonlySet<PartialDeep<TValue>> : never;
+type DeepPartialMap<T> = T extends Map<infer TKey, infer TValue> ? Map<TKey, PartialDeep<TValue>> : T extends ReadonlyMap<infer TKey, infer TValue> ? ReadonlyMap<TKey, PartialDeep<TValue>> : never;
+type DeepPartialObject<T extends object> = {
+	[K in keyof T]?: PartialDeep<T[K]>;
+};
+type PartialDeep<T> = T extends Primitive ? T : T extends (...args: infer TArgs) => infer TResult ? (...args: TArgs) => TResult : T extends Promise<infer TValue> ? Promise<PartialDeep<TValue>> : T extends readonly unknown[] ? DeepPartialArray<T> : T extends Set<unknown> | ReadonlySet<unknown> ? DeepPartialSet<T> : T extends Map<unknown, unknown> | ReadonlyMap<unknown, unknown> ? DeepPartialMap<T> : T extends object ? DeepPartialObject<T> : Partial<T>;
+/**
+ * Registry of plugin install parameter types - plugins extend this interface via module augmentation
+ *
+ * @example
+ * ```typescript
+ * // In your plugin file
+ * declare module '@dotfiles/core' {
+ *   interface IInstallParamsRegistry {
+ *     'github-release': GithubReleaseInstallParams;
+ *   }
+ * }
+ * ```
+ */
+interface IInstallParamsRegistry {
+}
+interface IToolConfigRegistry {
+}
+type ToolConfig = IToolConfigRegistry extends Record<string, never> ? never : IToolConfigRegistry[keyof IToolConfigRegistry];
+interface ICompletionContext {
+	/**
+	 * The installed version of the tool.
+	 *
+	 * Only available after `dotfiles install` completes successfully.
+	 * Contains the actual resolved version (e.g., `'15.1.0'`), not the configured
+	 * version which may be `'latest'`.
+	 *
+	 * @example
+	 * '15.1.0'
+	 * 'v0.26.1'
+	 */
+	version: string;
+}
+interface IShellCompletionConfigBase {
+	/**
+	 * Binary name for shell-specific completion filename.
+	 *
+	 * Applies naming conventions: `_bin` for zsh, `bin.bash` for bash.
+	 * Use when tool name differs from binary name.
+	 *
+	 * Equivalent bash:
+	 * ```bash
+	 * # bin: 'fnm' → output filename
+	 * # zsh:  _fnm
+	 * # bash: fnm.bash
+	 * ```
+	 *
+	 * @example 'fnm' → '_fnm' for zsh
+	 */
+	bin?: string;
+}
+interface IShellCompletionSourceConfig extends IShellCompletionConfigBase {
+	/**
+	 * Path to an existing completion file.
+	 *
+	 * - **Relative** (e.g., `_tool.zsh`) → resolved from `toolDir` (next to `.tool.ts`)
+	 * - **Absolute** (e.g., `${ctx.currentDir}/completions/_tool`) → used as-is
+	 *
+	 * For files extracted from archives, use `ctx.currentDir` to build the absolute path.
+	 *
+	 * Equivalent bash:
+	 * ```bash
+	 * # Relative: '_tool.zsh' resolves to toolDir (next to .tool.ts)
+	 * ln -s ${ctx.toolDir}/_tool.zsh ${ctx.projectConfig.paths.shellScriptsDir}/{shell}/completions/_mytool
+	 *
+	 * # Extracted archive: ctx.currentDir = ${ctx.projectConfig.paths.installDir}/mytool/1.0.0
+	 * ln -s ${ctx.currentDir}/completions/_tool ${ctx.projectConfig.paths.shellScriptsDir}/{shell}/completions/_mytool
+	 * ```
+	 *
+	 * @example
+	 * '_tool.zsh'
+	 * `${ctx.currentDir}/completions/_tool`
+	 */
+	source: string;
+}
+interface IShellCompletionCmdConfig extends IShellCompletionConfigBase {
+	/**
+	 * Command to generate completion content dynamically.
+	 *
+	 * Executes in the tool's installation directory during shell script generation.
+	 * The tool must be installed before this command can run.
+	 *
+	 * Equivalent bash:
+	 * ```bash
+	 * cd ${ctx.projectConfig.paths.installDir}/mytool/1.0.0
+	 * ./bin/tool completion zsh > ${ctx.projectConfig.paths.shellScriptsDir}/{shell}/completions/_tool
+	 * ```
+	 *
+	 * @example
+	 * 'tool completion zsh'
+	 * 'fnm completions --shell zsh'
+	 */
+	cmd: string;
+}
+interface IShellCompletionUrlConfig extends IShellCompletionConfigBase {
+	/**
+	 * URL to download the completion file or archive from.
+	 *
+	 * Supports both:
+	 * - Direct completion files (e.g., `_tool.zsh`, `tool.bash`)
+	 * - Archives (e.g., `.tar.gz`, `.zip`) which are automatically extracted
+	 *
+	 * The file/archive is downloaded to `ctx.currentDir`.
+	 *
+	 * Equivalent bash (archive):
+	 * ```bash
+	 * curl -fsSL "https://github.com/user/repo/releases/download/v1.0.0/completions.tar.gz" \
+	 *   -o ${ctx.projectConfig.paths.installDir}/mytool/1.0.0/completions.tar.gz
+	 * tar -xzf completions.tar.gz -C ${ctx.projectConfig.paths.installDir}/mytool/1.0.0/
+	 * ```
+	 *
+	 * Equivalent bash (direct file):
+	 * ```bash
+	 * curl -fsSL "https://raw.githubusercontent.com/user/repo/main/completions/_tool" \
+	 *   -o ${ctx.projectConfig.paths.installDir}/mytool/1.0.0/_tool
+	 * ```
+	 *
+	 * @example 'https://github.com/user/repo/releases/download/v1.0.0/completions.tar.gz'
+	 * @example 'https://raw.githubusercontent.com/user/repo/main/completions/_tool'
+	 */
+	url: string;
+	/**
+	 * Path to the completion file.
+	 *
+	 * For archives: absolute path to the completion file within the extracted archive.
+	 * For direct files: optional - if omitted, the filename is derived from the URL.
+	 *
+	 * The archive is extracted to `ctx.currentDir`, so use that to build the path.
+	 *
+	 * Equivalent bash (archive - source required):
+	 * ```bash
+	 * ln -s ${ctx.currentDir}/completions/_tool ${ctx.projectConfig.paths.shellScriptsDir}/{shell}/completions/_tool
+	 * ```
+	 *
+	 * Equivalent bash (direct file - source omitted):
+	 * ```bash
+	 * # Filename '_tool' derived from URL
+	 * ln -s ${ctx.currentDir}/_tool ${ctx.projectConfig.paths.shellScriptsDir}/{shell}/completions/_tool
+	 * ```
+	 *
+	 * @example `${ctx.currentDir}/completions/_tool` - for archives
+	 * @example undefined - for direct files (filename derived from URL)
+	 */
+	source?: string;
+}
+type ShellCompletionConfigValue = string | IShellCompletionSourceConfig | IShellCompletionCmdConfig | IShellCompletionUrlConfig;
+type ShellCompletionConfigInput = Resolvable<ICompletionContext, ShellCompletionConfigValue>;
+interface IShellConfigurator<KnownFunctions extends string = never> {
+	/**
+	 * Sets environment variables for the shell.
+	 *
+	 * **Note**: To modify PATH, use `shell.path()` instead. Setting PATH via
+	 * env() is prohibited to ensure proper deduplication.
+	 *
+	 * @param values - A record of environment variable names and values.
+	 */
+	env<T extends Record<string, string>>(values: "PATH" extends keyof T ? [
+		"ERROR: Use shell.path() to modify PATH"
+	] : T): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Sets shell aliases.
+	 * @param values - A record of alias names and their commands.
+	 */
+	aliases(values: Record<string, string>): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Sources a script file during shell initialization.
+	 *
+	 * - **Relative paths** → resolve to `toolDir` (directory containing `.tool.ts`)
+	 * - **Absolute paths** → used as-is
+	 * - **Files from downloaded archives** (GitHub releases, tarballs) are extracted to
+	 *   `ctx.currentDir`. Use this to build an absolute path: `${ctx.currentDir}/init.sh`
+	 *
+	 * Equivalent bash:
+	 * ```bash
+	 * # Relative: 'init.sh' resolves to toolDir (next to .tool.ts)
+	 * source ${ctx.toolDir}/init.sh
+	 *
+	 * # Extracted archive: ctx.currentDir = ${ctx.projectConfig.paths.installDir}/mytool/1.0.0
+	 * source ${ctx.currentDir}/init.sh
+	 * ```
+	 *
+	 * @param relativePath - Path to the script file relative to the tool directory.
+	 *
+	 * @example
+	 * shell.sourceFile('init.zsh')
+	 * shell.sourceFile(`${ctx.currentDir}/shell/init.sh`)
+	 */
+	sourceFile(relativePath: string): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Sources the output of a shell function defined via `functions()`.
+	 * The function must be defined before this call via `.functions({ fnName: '...' })`.
+	 *
+	 * **Important**: When a function is used with `sourceFunction()`, its body must
+	 * **output shell code to stdout**. This output is then sourced (executed) in the
+	 * current shell. Common tools like `fnm`, `pyenv`, `rbenv`, and `zoxide` have
+	 * commands that print shell code for this purpose.
+	 *
+	 * Unlike `sourceFile()`, this does NOT check if the output exists and is NOT wrapped
+	 * in a subshell. It emits: `source <(fnName)`
+	 *
+	 * @param functionName - Name of a function defined via `.functions()`.
+	 *
+	 * @example
+	 * // fnm env --use-on-cd PRINTS shell code like:
+	 * // export FNM_DIR="/Users/me/.fnm"
+	 * // export PATH="...fnm/bin:$PATH"
+	 * shell.functions({ initFnm: 'fnm env --use-on-cd' })
+	 * shell.sourceFunction('initFnm')
+	 * // Generates: source <(initFnm)
+	 */
+	sourceFunction(functionName: KnownFunctions): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Sources the output of inline shell code by wrapping it in a temporary function.
+	 * The content must **output shell code to stdout** - this output is then sourced.
+	 *
+	 * This is useful when you need to source the output of a command inline without
+	 * defining a named function via `functions()`.
+	 *
+	 * @param content - Shell code that **prints** shell code to stdout
+	 *
+	 * @example
+	 * // Content outputs "export MY_VAR=value" which gets sourced
+	 * shell.source('echo "export MY_VAR=value"')
+	 * // Generates:
+	 * // __dotfiles_source_toolname_0() {
+	 * //   echo "export MY_VAR=value"
+	 * // }
+	 * // source <(__dotfiles_source_toolname_0)
+	 * // unset -f __dotfiles_source_toolname_0
+	 *
+	 * @example
+	 * // fnm env prints shell code like "export PATH=..." which gets sourced
+	 * shell.source('fnm env --use-on-cd')
+	 */
+	source(content: string): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Configures shell completions from static files or generated dynamically.
+	 *
+	 * **Lifecycle**: All completions are generated only after the tool is installed.
+	 * This ensures cmd-based completions can execute the installed binary and callbacks
+	 * receive the actual installed version in `ctx.version`.
+	 *
+	 * - **Relative paths** → resolve to `toolDir` (directory containing `.tool.ts`)
+	 * - **Files from downloaded archives** (GitHub releases, tarballs) are extracted to
+	 *   `ctx.currentDir`. Use this to build an absolute path.
+	 * - **Dynamic** → use `{ cmd: 'tool completion zsh' }`
+	 *
+	 * @param completion - Path string, config object, or callback
+	 *
+	 * @example
+	 * shell.completions('_tool.zsh')
+	 * shell.completions(`${ctx.currentDir}/completions/_tool`)
+	 * shell.completions({ cmd: 'tool completion zsh' })
+	 * shell.completions((ctx) => ({
+	 *   url: `https://github.com/owner/repo/releases/download/${ctx.version}/completions.zsh`,
+	 *   source: `${ctx.currentDir}/_tool`
+	 * }))
+	 */
+	completions(completion: ShellCompletionConfigInput): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Adds a script to be executed once during shell initialization.
+	 * @param script - The script content.
+	 */
+	once(script: string): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Adds a script to be executed always during shell initialization.
+	 * @param script - The script content.
+	 */
+	always(script: string): IShellConfigurator<KnownFunctions>;
+	/**
+	 * Defines shell functions.
+	 *
+	 * @param values - A record of function names to their body content.
+	 *
+	 * @example
+	 * shell.functions({
+	 *   mycommand: 'echo "Running mycommand"'
+	 * })
+	 * // Generates:
+	 * // mycommand() {
+	 * //   echo "Running mycommand"
+	 * // }
+	 */
+	functions<K extends string>(values: Record<K, string>): IShellConfigurator<KnownFunctions | K>;
+	/**
+	 * Adds a directory to the PATH environment variable.
+	 * Paths are deduplicated during shell init generation.
+	 *
+	 * @param pathValue - Directory path to add to PATH. May contain $HOME or other env vars.
+	 *
+	 * @example
+	 * shell.path('$HOME/.local/bin')
+	 * shell.path('${ctx.currentDir}/bin')
+	 */
+	path(pathValue: Resolvable<void, string>): IShellConfigurator<KnownFunctions>;
+}
+type ShellConfiguratorSyncResult = IShellConfigurator<string> | undefined;
+type ShellConfiguratorAsyncResult = Promise<ShellConfiguratorSyncResult>;
+type ShellConfiguratorCallback = (shell: IShellConfigurator) => ShellConfiguratorSyncResult;
+type ShellConfiguratorAsyncCallback = (shell: IShellConfigurator) => ShellConfiguratorAsyncResult;
+/**
+ * Known binary names for type-safe dependsOn() calls.
+ * Generated tool type definitions augment this registry with string literal properties.
+ * The fallback behaviour resolves to `string` when no binary names are registered.
+ */
+interface IKnownBinNameRegistry {
+	__placeholder__?: never;
+}
+type KnownBinNameKeys = Exclude<keyof IKnownBinNameRegistry, "__placeholder__">;
+type KnownBinName = [
+	KnownBinNameKeys
+] extends [
+	never
+] ? string : KnownBinNameKeys;
+type PluginEmittedHookEvent = "after-download" | "after-extract";
+type HookEventName = "before-install" | PluginEmittedHookEvent | "after-install";
+/**
+ * Fluent builder interface for configuring a tool.
+ * Returned by InstallFunction after selecting installer method.
+ */
+export interface IToolConfigBuilder {
+	/**
+	 * Define a binary that this tool provides.
+	 * @param name - The name of the binary executable
+	 * @param pattern - Optional glob pattern to locate the binary within extracted archives
+	 */
+	bin(name: string, pattern?: string): this;
+	/**
+	 * Set a specific version for this tool.
+	 * @param version - The version string (e.g., "1.2.3", "latest")
+	 */
+	version(version: string): this;
+	/**
+	 * Declare binary dependencies that must be installed before this tool.
+	 *
+	 * During generation, the system:
+	 * 1. Builds a dependency graph mapping binaries to their provider tools
+	 * 2. Validates that all dependencies exist and are unambiguous
+	 * 3. Detects circular dependencies and platform mismatches
+	 * 4. Topologically sorts tools so dependencies are processed first
+	 *
+	 * @param binaryNames - Names of binaries this tool depends on (from other tools' `.bin()` calls)
+	 */
+	dependsOn(...binaryNames: KnownBinName[]): this;
+	/**
+	 * Attach a hook handler to a specific lifecycle event.
+	 * Multiple handlers can be added by calling this method multiple times with the same event name.
+	 * @param event - The lifecycle event name (kebab-case)
+	 * @param handler - The async hook function to execute
+	 */
+	hook(event: "before-install", handler: AsyncInstallHook<IInstallContext>): this;
+	hook(event: "after-download", handler: AsyncInstallHook<IDownloadContext>): this;
+	hook(event: "after-extract", handler: AsyncInstallHook<IExtractContext>): this;
+	hook(event: "after-install", handler: AsyncInstallHook<IAfterInstallContext>): this;
+	hook(event: HookEventName, handler: AsyncInstallHook<never>): this;
+	/**
+	 * Configure zsh shell initialization for this tool.
+	 * @param callback - Function that receives shell configurator to add paths, aliases, env vars
+	 */
+	zsh(callback: ShellConfiguratorCallback): this;
+	zsh(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Configure bash shell initialization for this tool.
+	 * @param callback - Function that receives shell configurator to add paths, aliases, env vars
+	 */
+	bash(callback: ShellConfiguratorCallback): this;
+	bash(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Configure PowerShell initialization for this tool.
+	 * @param callback - Function that receives shell configurator to add paths, aliases, env vars
+	 */
+	powershell(callback: ShellConfiguratorCallback): this;
+	powershell(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Create a symbolic link from source to target.
+	 * @param source - The source path (what to link from)
+	 * @param target - The target path (where to create the symlink)
+	 */
+	symlink(source: string, target: string): this;
+	/**
+	 * Copy a file or directory from source to target.
+	 * @param source - The source path (what to copy from)
+	 * @param target - The target path (where to copy to)
+	 */
+	copy(source: string, target: string): this;
+	/**
+	 * Add platform-specific configuration overrides.
+	 * @param platforms - Target platform(s): 'macos', 'linux', 'windows', or array
+	 * @param configure - Function to configure platform-specific settings
+	 */
+	platform(platforms: Platform, configure: (install: IPlatformInstallFunction) => Omit<IPlatformConfigBuilder, "bin">): this;
+	/**
+	 * Add platform and architecture-specific configuration overrides.
+	 * @param platforms - Target platform(s): 'macos', 'linux', 'windows', or array
+	 * @param architectures - Target architecture(s): 'x64', 'arm64', or array
+	 * @param configure - Function to configure platform-specific settings
+	 */
+	platform(platforms: Platform, architectures: Architecture, configure: (install: IPlatformInstallFunction) => Omit<IPlatformConfigBuilder, "bin">): this;
+	/**
+	 * Mark this tool as disabled.
+	 * A disabled tool is skipped during generation with a warning message.
+	 * Useful for temporarily disabling a tool without removing its configuration.
+	 */
+	disable(): this;
+	/**
+	 * Restrict this tool to specific hostnames.
+	 * When set, the tool is only installed on machines where the hostname matches.
+	 * @param pattern - A literal hostname string or regex pattern (e.g., "my-laptop" or /^work-.*$/)
+	 */
+	hostname(pattern: string | RegExp): this;
+	/**
+	 * Finalize and build the tool configuration.
+	 * Call this as the last method in the chain.
+	 * @returns The complete ToolConfig object
+	 */
+	build(): ToolConfig;
+}
+interface IPlatformConfigBuilder {
+	/**
+	 * Define a binary that this tool provides on this platform.
+	 * @param name - The name of the binary executable
+	 * @param pattern - Optional glob pattern to locate the binary within extracted archives
+	 */
+	bin(name: string, pattern?: string): this;
+	/**
+	 * Set a specific version for this tool on this platform.
+	 * @param version - The version string (e.g., "1.2.3", "latest")
+	 */
+	version(version: string): this;
+	/**
+	 * Declare binary dependencies for this platform.
+	 *
+	 * During generation, the system validates dependencies exist and orders tools
+	 * so that dependencies are processed first.
+	 *
+	 * @param binaryNames - Names of binaries this tool depends on (from other tools' `.bin()` calls)
+	 */
+	dependsOn(...binaryNames: KnownBinName[]): this;
+	/**
+	 * Attach a hook handler to a specific lifecycle event.
+	 * Multiple handlers can be added by calling this method multiple times with the same event name.
+	 * @param event - The lifecycle event name (kebab-case)
+	 * @param handler - The async hook function to execute
+	 */
+	hook(event: "before-install", handler: AsyncInstallHook<IInstallContext>): this;
+	hook(event: "after-download", handler: AsyncInstallHook<IDownloadContext>): this;
+	hook(event: "after-extract", handler: AsyncInstallHook<IExtractContext>): this;
+	hook(event: "after-install", handler: AsyncInstallHook<IAfterInstallContext>): this;
+	hook(event: HookEventName, handler: AsyncInstallHook<never>): this;
+	/**
+	 * Configure zsh shell initialization for this platform.
+	 * @param callback - Function that receives shell configurator
+	 */
+	zsh(callback: ShellConfiguratorCallback): this;
+	zsh(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Configure bash shell initialization for this platform.
+	 * @param callback - Function that receives shell configurator
+	 */
+	bash(callback: ShellConfiguratorCallback): this;
+	bash(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Configure PowerShell initialization for this platform.
+	 * @param callback - Function that receives shell configurator
+	 */
+	powershell(callback: ShellConfiguratorCallback): this;
+	powershell(callback: ShellConfiguratorAsyncCallback): Promise<this>;
+	/**
+	 * Create a symbolic link from source to target.
+	 * @param source - The source path (what to link from)
+	 * @param target - The target path (where to create the symlink)
+	 */
+	symlink(source: string, target: string): this;
+	/**
+	 * Copy a file or directory from source to target.
+	 * @param source - The source path (what to copy from)
+	 * @param target - The target path (where to copy to)
+	 */
+	copy(source: string, target: string): this;
+}
+/**
+ * Map of installer methods to their parameter types.
+ * Built dynamically from plugins via IInstallParamsRegistry module augmentation.
+ */
+type InstallMethod = keyof IInstallParamsRegistry;
+interface INoBinMethodRegistry {
+	__placeholder__?: never;
+}
+type NoBinMethodKeys = Exclude<keyof INoBinMethodRegistry, "__placeholder__">;
+interface INoParamsMethodRegistry {
+	__placeholder__?: never;
+}
+type NoParamsMethodKeys = Exclude<keyof INoParamsMethodRegistry, "__placeholder__">;
+type ToolBuilderForMethod<M extends InstallMethod> = [
+	M
+] extends [
+	NoBinMethodKeys
+] ? Omit<IToolConfigBuilder, "bin"> : IToolConfigBuilder;
+type PlatformBuilderForMethod<M extends InstallMethod> = [
+	M
+] extends [
+	NoBinMethodKeys
+] ? Omit<IPlatformConfigBuilder, "bin"> : IPlatformConfigBuilder;
+interface InstallFunction {
+	<M extends InstallMethod>(method: M, params: IInstallParamsRegistry[M]): ToolBuilderForMethod<M>;
+	<M extends NoParamsMethodKeys & InstallMethod>(method: M): ToolBuilderForMethod<M>;
+	(): IToolConfigBuilder;
+}
+interface IPlatformInstallFunction {
+	<M extends InstallMethod>(method: M, params: IInstallParamsRegistry[M]): PlatformBuilderForMethod<M>;
+	<M extends NoParamsMethodKeys & InstallMethod>(method: M): PlatformBuilderForMethod<M>;
+	(): IPlatformConfigBuilder;
+}
+interface IToolConfigContext extends IBaseToolContext {
+}
+type AsyncConfigureTool = (install: InstallFunction, ctx: IToolConfigContext) => Promise<undefined | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | ToolConfig> | undefined | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | ToolConfig;
+declare const platformConfigSchema: z.ZodObject<{
+	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>>;
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	version: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	installationMethod: z.ZodOptional<z.ZodString>;
+	installParams: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+type PlatformConfig = Omit<z.infer<typeof platformConfigSchema>, "installationMethod" | "installParams"> & {
+	installationMethod?: ToolConfig["installationMethod"];
+	installParams?: ToolConfig["installParams"];
+};
+type InstallHook = AsyncInstallHook<IInstallBaseContext>;
+type BaseEnv = Resolvable<IEnvContext, Record<string, string>>;
+interface InstallHooks {
+	/** Runs before any other installation steps (download, extract, main install command) begin. */
+	"before-install"?: InstallHook[];
+	/** Runs after download but before extraction or execution. */
+	"after-download"?: InstallHook[];
+	/** Runs after extraction but before the main binary is finalized. */
+	"after-extract"?: InstallHook[];
+	/** Runs after the main installation command completes. */
+	"after-install"?: InstallHook[];
+}
+interface BaseInstallParams {
+	/**
+	 * When true, the tool will be automatically installed during the `generate` command
+	 * if not already installed. This is useful for tools that must be installed before
+	 * shell initialization can be generated (e.g., zsh plugins that need to be sourced).
+	 */
+	auto?: boolean;
+	/**
+	 * A record of environment variables to be set specifically for the duration of this tool's installation process.
+	 * Can be a static object or a function that receives context and returns the object.
+	 */
+	env?: BaseEnv;
+	/**
+	 * A collection of optional asynchronous hook functions that can be executed at different stages
+	 * of the installation lifecycle.
+	 */
+	hooks?: InstallHooks;
+}
+declare const platformConfigEntrySchema: z.ZodObject<{
+	platforms: z.ZodNumber;
+	architectures: z.ZodOptional<z.ZodNumber>;
+	config: z.ZodUnknown;
+}, z.core.$strict>;
+type BasePlatformConfigEntry = z.infer<typeof platformConfigEntrySchema>;
+type PlatformConfigEntry = Omit<BasePlatformConfigEntry, "config"> & {
+	config: PlatformConfig;
+};
+type InferToolConfigWithPlatforms<TSchema extends z.ZodType> = Omit<z.infer<TSchema>, "platformConfigs"> & {
+	platformConfigs?: PlatformConfigEntry[];
+};
+/**
+ * Parameters for installing a tool using Homebrew (`brew`).
+ * This method is typically used on macOS and Linux (via Linuxbrew).
+ * It involves running `brew install` commands.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface BrewInstallParams extends BaseInstallParams {
+	/** The name of the Homebrew formula to install (e.g., `ripgrep`). */
+	formula?: string;
+	/** If `true`, the `formula` property is treated as a Homebrew Cask name. */
+	cask?: boolean;
+	/** An optional Homebrew tap or an array of taps. */
+	tap?: string | string[];
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+}
+declare const brewToolConfigSchema: z.ZodObject<{
+	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>>;
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"brew">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		formula: z.ZodOptional<z.ZodString>;
+		cask: z.ZodOptional<z.ZodBoolean>;
+		tap: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodArray<z.ZodString>
+		]>>;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+}, z.core.$strict>;
+type BrewToolConfig = InferToolConfigWithPlatforms<typeof brewToolConfigSchema>;
+interface IInstallParamsRegistry {
+	brew: BrewInstallParams;
+}
+interface IToolConfigRegistry {
+	brew: BrewToolConfig;
+}
+declare const cargoToolConfigSchema: z.ZodObject<{
+	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>>;
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"cargo">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		crateName: z.ZodString;
+		binarySource: z.ZodOptional<z.ZodEnum<{
+			"cargo-quickinstall": "cargo-quickinstall";
+			"github-releases": "github-releases";
+		}>>;
+		githubRepo: z.ZodOptional<z.ZodString>;
+		assetPattern: z.ZodOptional<z.ZodString>;
+		versionSource: z.ZodOptional<z.ZodEnum<{
+			"cargo-toml": "cargo-toml";
+			"crates-io": "crates-io";
+			"github-releases": "github-releases";
+		}>>;
+		cargoTomlUrl: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+}, z.core.$strict>;
+/**
+ * Installation parameters for Cargo-based tools using pre-compiled binaries.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface CargoInstallParams extends BaseInstallParams {
+	/** The crate name */
+	crateName: string;
+	/** Source for binaries - either cargo-quickinstall or GitHub releases */
+	binarySource?: "cargo-quickinstall" | "github-releases";
+	/** GitHub repository for the crate (required for github-releases source). Format: "owner/repo" */
+	githubRepo?: string;
+	/** Asset pattern for GitHub releases. Supports placeholders: {version}, {platform}, {arch}, {crateName} */
+	assetPattern?: string;
+	/** Version source - where to get the version information */
+	versionSource?: "cargo-toml" | "crates-io" | "github-releases";
+	/** Custom Cargo.toml URL if different from standard GitHub location */
+	cargoTomlUrl?: string;
+}
+type CargoToolConfig = InferToolConfigWithPlatforms<typeof cargoToolConfigSchema>;
+interface IInstallParamsRegistry {
+	cargo: CargoInstallParams;
+}
+interface IToolConfigRegistry {
+	cargo: CargoToolConfig;
+}
+interface ICurlScriptArgsContext extends IEnvContext {
+	/** Project configuration with paths and settings */
+	projectConfig: ProjectConfig;
+	/**
+	 * The absolute path to the downloaded installation script file on the local file system.
+	 * The script is downloaded from the URL specified in `installParams.url`, saved to the
+	 * staging directory, and made executable (chmod +x). This file is preserved after
+	 * installation completes (moved along with the staging directory to the versioned path).
+	 *
+	 * Example: `${stagingDir}/<tool-name>-install.sh`
+	 */
+	scriptPath: string;
+	/**
+	 * The absolute path to the temporary staging directory for this installation attempt.
+	 * The downloaded installation script (`scriptPath`) is saved here, along with any files
+	 * the script or your code creates during installation. After successful installation,
+	 * the entire directory is renamed to the versioned path (e.g., `<tool-name>/1.2.3`),
+	 * preserving all contents.
+	 *
+	 * Example: `${projectConfig.paths.binariesDir}/<tool-name>/<uuid>`
+	 */
+	stagingDir: string;
+}
+type CurlScriptArgs = Resolvable<ICurlScriptArgsContext, string[]>;
+type CurlScriptEnv = Resolvable<ICurlScriptArgsContext, Record<string, string>>;
+/**
+ * Parameters for installing a tool by downloading and executing a shell script using `curl`.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ * Uses Omit because `env` has a more specific type than BaseInstallParams.env.
+ */
+interface CurlScriptInstallParams extends Omit<BaseInstallParams, "env"> {
+	/** The URL of the installation script to download. */
+	url: string;
+	/** The shell to use for executing the downloaded script. */
+	shell: "bash" | "sh";
+	/** Arguments to pass to the script - can be static array or function returning array. */
+	args?: CurlScriptArgs;
+	/** Environment variables to pass to the script - can be static object or function returning object. */
+	env?: CurlScriptEnv;
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+}
+declare const curlScriptToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"curl-script">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		url: z.ZodString;
+		shell: z.ZodEnum<{
+			bash: "bash";
+			sh: "sh";
+		}>;
+		args: z.ZodOptional<z.ZodCustom<CurlScriptArgs, CurlScriptArgs>>;
+		env: z.ZodOptional<z.ZodCustom<CurlScriptEnv, CurlScriptEnv>>;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type CurlScriptToolConfig = InferToolConfigWithPlatforms<typeof curlScriptToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"curl-script": CurlScriptInstallParams;
+}
+interface IToolConfigRegistry {
+	"curl-script": CurlScriptToolConfig;
+}
+/**
+ * Parameters for installing a tool by downloading a tarball (`.tar`, `.tar.gz`, etc.) using `curl`,
+ * then extracting it and potentially moving a binary from within.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface CurlTarInstallParams extends BaseInstallParams {
+	/** The URL of the tarball to download. */
+	url: string;
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+}
+declare const curlTarToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"curl-tar">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		url: z.ZodString;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type CurlTarToolConfig = InferToolConfigWithPlatforms<typeof curlTarToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"curl-tar": CurlTarInstallParams;
+}
+interface IToolConfigRegistry {
+	"curl-tar": CurlTarToolConfig;
+}
+type AssetPattern = string | RegExp;
+interface IAssetSelectionContext extends IInstallContext {
+	/** Available release assets to choose from */
+	assets: IGitHubReleaseAsset[];
+	/** The GitHub release being processed */
+	release: IGitHubRelease;
+	/** Asset pattern from configuration (if provided) */
+	assetPattern?: AssetPattern;
+}
+type AssetSelector = (context: IAssetSelectionContext) => IGitHubReleaseAsset | undefined;
+/**
+ * Parameters for installing a tool from a GitHub Release.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface GithubReleaseInstallParams extends BaseInstallParams {
+	/**
+	 * The GitHub repository in "owner/repo" format (e.g., `junegunn/fzf`).
+	 */
+	repo: string;
+	/**
+	 * A glob pattern or regular expression used to match the desired asset filename.
+	 * Example: `*linux_amd64.tar.gz` or `/fzf-.*-linux_amd64\.tar\.gz/`.
+	 */
+	assetPattern?: string | RegExp;
+	/**
+	 * A specific version string (e.g., `v1.2.3`, `0.48.0`) or a SemVer constraint.
+	 */
+	version?: string;
+	/**
+	 * A custom function to select the desired asset from available release assets.
+	 */
+	assetSelector?: AssetSelector;
+	/**
+	 * When true, uses the `gh` CLI for GitHub API requests instead of direct fetch.
+	 */
+	ghCli?: boolean;
+	/**
+	 * When true, includes prerelease versions when fetching the latest release.
+	 */
+	prerelease?: boolean;
+}
+declare const githubReleaseToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"github-release">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		repo: z.ZodString;
+		assetPattern: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
+		version: z.ZodOptional<z.ZodString>;
+		assetSelector: z.ZodOptional<z.ZodCustom<AssetSelector, AssetSelector>>;
+		ghCli: z.ZodOptional<z.ZodBoolean>;
+		prerelease: z.ZodOptional<z.ZodBoolean>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type GithubReleaseToolConfig = InferToolConfigWithPlatforms<typeof githubReleaseToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"github-release": GithubReleaseInstallParams;
+}
+interface IToolConfigRegistry {
+	"github-release": GithubReleaseToolConfig;
+}
+interface DmgInstallParams extends BaseInstallParams {
+	/** Source definition for resolving the DMG file. */
+	source: DmgSource;
+	/** The name of the .app bundle inside the DMG. */
+	appName?: string;
+	/** Relative path to the binary inside the .app bundle. */
+	binaryPath?: string;
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+}
+interface DmgUrlSource {
+	type: "url";
+	url: string;
+}
+interface DmgGitHubReleaseSource extends Pick<GithubReleaseInstallParams, "repo" | "version" | "assetPattern" | "assetSelector" | "ghCli" | "prerelease"> {
+	type: "github-release";
+}
+type DmgSource = DmgUrlSource | DmgGitHubReleaseSource;
+declare const dmgToolConfigSchema: z.ZodObject<{
+	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>>;
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"dmg">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		source: z.ZodDiscriminatedUnion<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"url">;
+				url: z.ZodString;
+			}, z.core.$strip>,
+			z.ZodObject<{
+				repo: z.ZodString;
+				assetPattern: z.ZodOptional<z.ZodUnion<readonly [
+					z.ZodString,
+					z.ZodCustom<RegExp, RegExp>
+				]>>;
+				version: z.ZodOptional<z.ZodString>;
+				assetSelector: z.ZodOptional<z.ZodCustom<AssetSelector, AssetSelector>>;
+				ghCli: z.ZodOptional<z.ZodBoolean>;
+				prerelease: z.ZodOptional<z.ZodBoolean>;
+				type: z.ZodLiteral<"github-release">;
+			}, z.core.$strip>
+		], "type">;
+		appName: z.ZodOptional<z.ZodString>;
+		binaryPath: z.ZodOptional<z.ZodString>;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+}, z.core.$strict>;
+type DmgToolConfig = InferToolConfigWithPlatforms<typeof dmgToolConfigSchema>;
+interface IInstallParamsRegistry {
+	dmg: DmgInstallParams;
+}
+interface IToolConfigRegistry {
+	dmg: DmgToolConfig;
+}
+type AssetPattern$1 = string | RegExp;
+interface IGiteaAssetSelectionContext extends IInstallContext {
+	assets: IGitHubReleaseAsset[];
+	release: IGitHubRelease;
+	assetPattern?: AssetPattern$1;
+}
+type GiteaAssetSelector = (context: IGiteaAssetSelectionContext) => IGitHubReleaseAsset | undefined;
+/**
+ * Parameters for installing a tool from a Gitea/Forgejo release.
+ */
+interface GiteaReleaseInstallParams extends BaseInstallParams {
+	instanceUrl: string;
+	repo: string;
+	assetPattern?: string | RegExp;
+	version?: string;
+	assetSelector?: GiteaAssetSelector;
+	prerelease?: boolean;
+	token?: string;
+}
+declare const giteaReleaseToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"gitea-release">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		instanceUrl: z.ZodString;
+		repo: z.ZodString;
+		assetPattern: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
+		version: z.ZodOptional<z.ZodString>;
+		assetSelector: z.ZodOptional<z.ZodCustom<GiteaAssetSelector, GiteaAssetSelector>>;
+		prerelease: z.ZodOptional<z.ZodBoolean>;
+		token: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type GiteaReleaseToolConfig = InferToolConfigWithPlatforms<typeof giteaReleaseToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"gitea-release": GiteaReleaseInstallParams;
+}
+interface IToolConfigRegistry {
+	"gitea-release": GiteaReleaseToolConfig;
+}
+/**
+ * Parameters for a "manual" installation method.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface ManualInstallParams extends BaseInstallParams {
+	/**
+	 * The path to the binary file relative to the tool configuration file location.
+	 * If not specified, only shell configurations and symlinks will be processed.
+	 */
+	binaryPath?: string;
+}
+declare const manualToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"manual">;
+	installParams: z.ZodOptional<z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		binaryPath: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>>;
+}, z.core.$strict>;
+type ManualToolConfig = InferToolConfigWithPlatforms<typeof manualToolConfigSchema>;
+interface IInstallParamsRegistry {
+	manual: ManualInstallParams;
+}
+interface INoParamsMethodRegistry {
+	manual: true;
+}
+interface IToolConfigRegistry {
+	manual: ManualToolConfig;
+}
+interface ConfigContext {
+	/**
+	 * The directory containing the configuration file.
+	 */
+	configFileDir: string;
+	/**
+	 * Information about the current system (platform, architecture, etc.).
+	 */
+	systemInfo: ISystemInfo;
+}
+type ConfigFactory = (ctx: ConfigContext) => Promise<ProjectConfigPartial> | ProjectConfigPartial;
+/**
+ * Wraps a configuration factory so `.ts` config files stay fully typed.
+ *
+ * The factory can be synchronous or asynchronous and should return a {@link ProjectConfigPartial}.
+ *
+ * @param configFn - Configuration factory.
+ * @returns The configuration factory function.
+ *
+ * @example Asynchronous factory
+ * ```typescript
+ * export default defineConfig(async () => ({
+ *   github: {
+ *     token: await fetchToken(),
+ *   },
+ * }));
+ * ```
+ *
+ * @example Synchronous factory
+ * ```typescript
+ * export default defineConfig(() => ({
+ *   paths: {
+ *     dotfilesDir: '~/.dotfiles',
+ *     targetDir: '~/.local/bin',
+ *   },
+ * }));
+ * ```
+ */
+export declare function defineConfig(configFn: ConfigFactory): ConfigFactory;
+type ConfigureToolFnResult = ToolConfig | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | undefined | Promise<ToolConfig | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | undefined>;
+/**
+ * Define a tool configuration with type-safe install method selection.
+ *
+ * The install function is provided as the first parameter, allowing you to
+ * select the installer method and provide type-checked parameters upfront.
+ *
+ * @param fn - Configuration callback that receives:
+ *   - `install` - Function to select installer method. Call with method name and params,
+ *     or call with no args for manual tools. Returns a fluent builder.
+ *   - `ctx` - Context with tool/config info (toolName, projectConfig, systemInfo).
+ *
+ * @returns Async function compatible with tool loading system
+ *
+ * @example
+ * ```ts
+ * export default defineTool((install, ctx) =>
+ *   install('github-release', { repo: 'BurntSushi/ripgrep' })
+ *     .bin('rg')
+ *     .version('14.0.0')
+ * );
+ * ```
+ */
+export declare function defineTool(fn: (
+/**
+ * Function to select the installation method and provide type-checked parameters.
+ * Call with a method name and params for installers, or call with no args for manual tools.
+ * Returns a fluent builder to configure binaries, versions, hooks, and shell settings.
+ *
+ * @inheritdoc
+ */
+install: InstallFunction, 
+/**
+ * Context object providing access to paths, configuration, and system information.
+ * Use `ctx.projectConfig.paths.*` for configured directory paths.
+ */
+ctx: IToolConfigContext) => ConfigureToolFnResult): AsyncConfigureTool;
+/**
+ * Parameters for installing a tool by downloading a standalone binary file.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface CurlBinaryInstallParams extends BaseInstallParams {
+	/** The URL of the binary file to download. */
+	url: string;
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+}
+declare const curlBinaryToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"curl-binary">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		url: z.ZodString;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type CurlBinaryToolConfig = InferToolConfigWithPlatforms<typeof curlBinaryToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"curl-binary": CurlBinaryInstallParams;
+}
+interface IToolConfigRegistry {
+	"curl-binary": CurlBinaryToolConfig;
+}
+/**
+ * Parameters for a "zsh-plugin" installation method.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface ZshPluginInstallParams extends BaseInstallParams {
+	/** GitHub repository in `user/repo` format. Either `repo` or `url` must be specified. */
+	repo?: string;
+	/** Full git URL for non-GitHub repositories. Either `repo` or `url` must be specified. */
+	url?: string;
+	/** Custom plugin name for the cloned directory. */
+	pluginName?: string;
+	/** Path to the plugin's main source file relative to the plugin directory. */
+	source?: string;
+	/** Whether to automatically source the plugin in shell init. @default true */
+	auto?: boolean;
+}
+declare const zshPluginToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"zsh-plugin">;
+	installParams: z.ZodObject<{
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		repo: z.ZodOptional<z.ZodString>;
+		url: z.ZodOptional<z.ZodString>;
+		pluginName: z.ZodOptional<z.ZodString>;
+		source: z.ZodOptional<z.ZodString>;
+		auto: z.ZodDefault<z.ZodBoolean>;
+	}, z.core.$strict>;
+	binaries: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type ZshPluginToolConfig = InferToolConfigWithPlatforms<typeof zshPluginToolConfigSchema>;
+interface IInstallParamsRegistry {
+	"zsh-plugin": ZshPluginInstallParams;
+}
+interface IToolConfigRegistry {
+	"zsh-plugin": ZshPluginToolConfig;
+}
+/**
+ * Parameters for installing a tool using npm.
+ *
+ * NOTE: This is an explicit interface (not z.infer) to ensure TypeScript fully resolves
+ * the property names, which is required for proper `keyof` behavior in declaration files.
+ */
+interface NpmInstallParams extends BaseInstallParams {
+	/** The npm package name to install. */
+	package?: string;
+	/** The version or version range to install. */
+	version?: string;
+	/** Arguments to pass to the binary to check the version. */
+	versionArgs?: string[];
+	/** Regex to extract version from output. */
+	versionRegex?: string;
+	/** The package manager to use for installation. Defaults to `'npm'`. */
+	packageManager?: "npm" | "bun";
+}
+declare const npmToolConfigSchema: z.ZodObject<{
+	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	disabled: z.ZodOptional<z.ZodBoolean>;
+	hostname: z.ZodOptional<z.ZodString>;
+	shellConfigs: z.ZodOptional<z.ZodObject<{
+		zsh: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		bash: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+		powershell: z.ZodOptional<z.ZodObject<{
+			scripts: z.ZodOptional<z.ZodArray<z.ZodType<ShellScript, unknown, z.core.$ZodTypeInternals<ShellScript, unknown>>>>;
+			aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			functions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+			paths: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+			completions: z.ZodOptional<z.ZodUnknown>;
+		}, z.core.$strict>>;
+	}, z.core.$strict>>;
+	symlinks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	copies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		source: z.ZodString;
+		target: z.ZodString;
+	}, z.core.$strict>>>;
+	updateCheck: z.ZodOptional<z.ZodObject<{
+		enabled: z.ZodOptional<z.ZodBoolean>;
+		constraint: z.ZodOptional<z.ZodString>;
+	}, z.core.$strict>>;
+	name: z.ZodString;
+	version: z.ZodString;
+	configFilePath: z.ZodOptional<z.ZodString>;
+	platformConfigs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+		platforms: z.ZodNumber;
+		architectures: z.ZodOptional<z.ZodNumber>;
+		config: z.ZodUnknown;
+	}, z.core.$strict>>>;
+	installationMethod: z.ZodLiteral<"npm">;
+	installParams: z.ZodObject<{
+		auto: z.ZodOptional<z.ZodBoolean>;
+		env: z.ZodOptional<z.ZodCustom<BaseEnv, BaseEnv>>;
+		hooks: z.ZodOptional<z.ZodObject<{
+			"before-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-download": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-extract": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+			"after-install": z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodCustom<InstallHook, InstallHook>>>>;
+		}, z.core.$strip>>;
+		package: z.ZodOptional<z.ZodString>;
+		version: z.ZodOptional<z.ZodString>;
+		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		versionRegex: z.ZodOptional<z.ZodString>;
+		packageManager: z.ZodOptional<z.ZodEnum<{
+			bun: "bun";
+			npm: "npm";
+		}>>;
+	}, z.core.$strict>;
+	binaries: z.ZodArray<z.ZodUnion<readonly [
+		z.ZodString,
+		z.ZodObject<{
+			name: z.ZodString;
+			pattern: z.ZodString;
+		}, z.core.$strict>
+	]>>;
+}, z.core.$strict>;
+type NpmToolConfig = InferToolConfigWithPlatforms<typeof npmToolConfigSchema>;
+interface IInstallParamsRegistry {
+	npm: NpmInstallParams;
+}
+interface IToolConfigRegistry {
+	npm: NpmToolConfig;
+}
+
+export {
+	BrewInstallParams as z_internal_BrewInstallParams,
+	CargoInstallParams as z_internal_CargoInstallParams,
+	CurlBinaryInstallParams as z_internal_CurlBinaryInstallParams,
+	CurlScriptInstallParams as z_internal_CurlScriptInstallParams,
+	CurlTarInstallParams as z_internal_CurlTarInstallParams,
+	GiteaReleaseInstallParams as z_internal_GiteaReleaseInstallParams,
+	GithubReleaseInstallParams as z_internal_GithubReleaseInstallParams,
+	IInstallParamsRegistry as z_internal_IInstallParamsRegistry,
+	IKnownBinNameRegistry as z_internal_IKnownBinNameRegistry,
+	ISystemInfo as z_internal_ISystemInfo,
+	InstallMethod as z_internal_InstallMethod,
+	ManualInstallParams as z_internal_ManualInstallParams,
+	NpmInstallParams as z_internal_NpmInstallParams,
+	ZshPluginInstallParams as z_internal_ZshPluginInstallParams,
+};
+
+export {};