npm - @alexgorbatchev/dotfiles - Versions diffs - 0.0.5 → 0.0.10 - Mend

@alexgorbatchev/dotfiles 0.0.5 → 0.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +45 -47
package/cli.js +157 -157
package/cli.js.map +274 -274
package/dashboard-vf1askzj.js +159 -0
package/{dashboard-0ebz5sqb.js.map → dashboard-vf1askzj.js.map} +33 -33
package/dashboard.js +11 -11
package/package.json +1 -1
package/schemas.d.ts +106 -100
package/skill/SKILL.md +7 -5
package/skill/references/api-reference.md +49 -49
package/skill/references/configuration.md +184 -174
package/skill/references/installation-methods/brew.md +18 -18
package/skill/references/installation-methods/cargo.md +19 -19
package/skill/references/installation-methods/curl-binary.md +29 -27
package/skill/references/installation-methods/curl-script.md +28 -28
package/skill/references/installation-methods/curl-tar.md +27 -19
package/skill/references/installation-methods/dmg.md +24 -24
package/skill/references/installation-methods/gitea-release.md +24 -24
package/skill/references/installation-methods/github-release.md +20 -20
package/skill/references/installation-methods/manual.md +18 -18
package/skill/references/installation-methods/npm.md +19 -19
package/skill/references/installation-methods/overview.md +74 -75
package/skill/references/installation-methods/zsh-plugin.md +31 -32
package/skill/references/make-tool.md +168 -167
package/skill/references/shell-and-hooks.md +78 -77
package/dashboard-0ebz5sqb.js +0 -159

package/dashboard.js CHANGED Viewed

@@ -1,13 +1,13 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <base href="/">
-  <title>Dotfiles Dashboard</title>
-<link rel="stylesheet" crossorigin href="./dashboard-3axqywva.css"><script type="module" crossorigin src="./dashboard-0ebz5sqb.js"></script></head>
-<body class="min-h-screen">
-  <div id="app"></div>
-</body>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <base href="/" />
+    <title>Dotfiles Dashboard</title>
+  <link rel="stylesheet" crossorigin href="./dashboard-3axqywva.css"><script type="module" crossorigin src="./dashboard-vf1askzj.js"></script></head>
+  <body class="min-h-screen">
+    <div id="app"></div>
+  </body>
 </html>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@alexgorbatchev/dotfiles",
-  "version": "0.0.5",
+  "version": "0.0.10",
   "description": "Declarative, versioned dotfiles management with generated shims and shell integration.",
   "license": "MIT",
   "repository": {

package/schemas.d.ts CHANGED Viewed

@@ -39,6 +39,15 @@ export declare function dedentString(str: string): string;
  * @returns The processed string with proper indentation and replaced placeholders
  */
 export declare function dedentTemplate(template: string, values: Record<string, string>): string;
+type FileWriteContent = string | NodeJS.ArrayBufferView;
+interface IRecursiveDirectoryOptions {
+	recursive?: boolean;
+}
+interface IRemoveOptions extends IRecursiveDirectoryOptions {
+	force?: boolean;
+}
+type SymlinkKind = "file" | "dir" | "junction";
+type FileMode = number | string;
 interface IFileSystem {
 	/**
 	 * Reads the entire content of a file.
@@ -60,7 +69,7 @@ interface IFileSystem {
 	 * @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>;
+	writeFile(path: string, content: FileWriteContent, encoding?: BufferEncoding): Promise<void>;
 	/**
 	 * Checks if a file or directory exists.
 	 * @param path - A path to a file or directory.
@@ -73,9 +82,7 @@ interface IFileSystem {
 	 * @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>;
+	mkdir(path: string, options?: IRecursiveDirectoryOptions): Promise<void>;
 	/**
 	 * Reads the contents of a directory.
 	 * @param path - A path to a directory.
@@ -88,10 +95,7 @@ interface IFileSystem {
 	 * @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>;
+	rm(path: string, options?: IRemoveOptions): Promise<void>;
 	/**
 	 * Asynchronously removes a directory.
 	 * @param path - A path to a directory.
@@ -99,9 +103,7 @@ interface IFileSystem {
 	 * @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>;
+	rmdir(path: string, options?: IRecursiveDirectoryOptions): Promise<void>;
 	/**
 	 * Gets file or directory stats.
 	 * @param path - A path to a file or directory.
@@ -121,7 +123,7 @@ interface IFileSystem {
 	 * @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>;
+	symlink(target: string, path: string, type?: SymlinkKind): Promise<void>;
 	/**
 	 * Reads the value of a symbolic link.
 	 * @param path - A path to a symbolic link.
@@ -134,7 +136,7 @@ interface IFileSystem {
 	 * @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>;
+	chmod(path: string, mode: FileMode): Promise<void>;
 	/**
 	 * Asynchronously copies a file.
 	 * @param src - The source file path.
@@ -490,7 +492,7 @@ type BoundReplaceInFile = (filePath: string, from: ReplaceInFilePattern, to: Rep
 type BoundResolve = (pattern: string) => string;
 interface IBaseToolContext {
 	/**
-	 * The user's parsed application configuration from the main `config.ts` file.
+	 * The user's parsed application configuration from the main `dotfiles.config.ts` file.
 	 */
 	projectConfig: ProjectConfig;
 	/**
@@ -660,7 +662,7 @@ interface IGitHubRelease {
 	/** The URL to view this release on the GitHub website. */
 	html_url: string;
 }
-interface ShellResult {
+interface IShellResult {
 	/** Exit code of the process */
 	code: number;
 	/** Stdout as string */
@@ -668,15 +670,15 @@ interface ShellResult {
 	/** Stderr as string */
 	stderr: string;
 }
-interface ShellCommand extends PromiseLike<ShellResult> {
+interface IShellCommand extends PromiseLike<IShellResult> {
 	/** Set working directory */
-	cwd(path: string): ShellCommand;
+	cwd(path: string): IShellCommand;
 	/** Set/merge environment variables */
-	env(vars: Record<string, string | undefined>): ShellCommand;
+	env(vars: Record<string, string | undefined>): IShellCommand;
 	/** Suppress output logging (command still logged) */
-	quiet(): ShellCommand;
+	quiet(): IShellCommand;
 	/** Don't throw on non-zero exit code, return result with code instead */
-	noThrow(): ShellCommand;
+	noThrow(): IShellCommand;
 	/** Get stdout as trimmed string */
 	text(): Promise<string>;
 	/** Parse stdout as JSON */
@@ -686,9 +688,9 @@ interface ShellCommand extends PromiseLike<ShellResult> {
 	/** Get stdout as bytes */
 	bytes(): Promise<Uint8Array>;
 }
-interface Shell {
-	(strings: TemplateStringsArray, ...values: unknown[]): ShellCommand;
-	(command: string): ShellCommand;
+interface IShell {
+	(strings: TemplateStringsArray, ...values: unknown[]): IShellCommand;
+	(command: string): IShellCommand;
 }
 interface IEnvContext {
 	/** Project configuration with paths and settings */
@@ -722,7 +724,7 @@ interface IInstallBaseContext extends IBaseToolContext {
 	 * Use the `$` tagged template literal to execute shell commands within hooks.
 	 * The working directory can be changed using `cd` commands or `process.chdir()`.
 	 */
-	$: Shell;
+	$: IShell;
 	/**
 	 * An instance of the file system for performing file operations.
 	 */
@@ -1353,7 +1355,7 @@ type PlatformBuilderForMethod<M extends InstallMethod> = [
 ] extends [
 	NoBinMethodKeys
 ] ? Omit<IPlatformConfigBuilder, "bin"> : IPlatformConfigBuilder;
-interface InstallFunction {
+interface IInstallFunction {
 	<M extends InstallMethod>(method: M, params: IInstallParamsRegistry[M]): ToolBuilderForMethod<M>;
 	<M extends NoParamsMethodKeys & InstallMethod>(method: M): ToolBuilderForMethod<M>;
 	(): IToolConfigBuilder;
@@ -1365,7 +1367,7 @@ interface IPlatformInstallFunction {
 }
 interface IToolConfigContext extends IBaseToolContext {
 }
-type AsyncConfigureTool = (install: InstallFunction, ctx: IToolConfigContext) => Promise<undefined | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | ToolConfig> | undefined | IToolConfigBuilder | Omit<IToolConfigBuilder, "bin"> | ToolConfig;
+type AsyncConfigureTool = (install: IInstallFunction, 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,
@@ -1425,7 +1427,7 @@ type PlatformConfig = Omit<z.infer<typeof platformConfigSchema>, "installationMe
 };
 type InstallHook = AsyncInstallHook<IInstallBaseContext>;
 type BaseEnv = Resolvable<IEnvContext, Record<string, string>>;
-interface InstallHooks {
+interface IInstallHooks {
 	/** Runs before any other installation steps (download, extract, main install command) begin. */
 	"before-install"?: InstallHook[];
 	/** Runs after download but before extraction or execution. */
@@ -1435,7 +1437,7 @@ interface InstallHooks {
 	/** Runs after the main installation command completes. */
 	"after-install"?: InstallHook[];
 }
-interface BaseInstallParams {
+interface IBaseInstallParams {
 	/**
 	 * 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
@@ -1443,7 +1445,7 @@ interface BaseInstallParams {
 	 */
 	auto?: boolean;
 	/**
-	 * A record of environment variables to be set specifically for the duration of this tool's installation process.
+	 * A record of environment variables to be set specifically for the duration of the tool's installation process.
 	 * Can be a static object or a function that receives context and returns the object.
 	 */
 	env?: BaseEnv;
@@ -1451,7 +1453,7 @@ interface BaseInstallParams {
 	 * A collection of optional asynchronous hook functions that can be executed at different stages
 	 * of the installation lifecycle.
 	 */
-	hooks?: InstallHooks;
+	hooks?: IInstallHooks;
 }
 declare const platformConfigEntrySchema: z.ZodObject<{
 	platforms: z.ZodNumber;
@@ -1473,7 +1475,7 @@ type InferToolConfigWithPlatforms<TSchema extends z.ZodType> = Omit<z.infer<TSch
  * 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 {
+interface IBrewInstallParams extends IBaseInstallParams {
 	/** 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. */
@@ -1482,8 +1484,8 @@ interface BrewInstallParams extends BaseInstallParams {
 	tap?: string | string[];
 	/** Arguments to pass to the binary to check the version. */
 	versionArgs?: string[];
-	/** Regex to extract version from output. */
-	versionRegex?: string;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 }
 declare const brewToolConfigSchema: z.ZodObject<{
 	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
@@ -1559,12 +1561,15 @@ declare const brewToolConfigSchema: z.ZodObject<{
 			z.ZodArray<z.ZodString>
 		]>>;
 		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-		versionRegex: z.ZodOptional<z.ZodString>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 	}, z.core.$strict>;
 }, z.core.$strict>;
 type BrewToolConfig = InferToolConfigWithPlatforms<typeof brewToolConfigSchema>;
 interface IInstallParamsRegistry {
-	brew: BrewInstallParams;
+	brew: IBrewInstallParams;
 }
 interface IToolConfigRegistry {
 	brew: BrewToolConfig;
@@ -1657,7 +1662,7 @@ declare const cargoToolConfigSchema: z.ZodObject<{
  * 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 {
+interface ICargoInstallParams extends IBaseInstallParams {
 	/** The crate name */
 	crateName: string;
 	/** Source for binaries - either cargo-quickinstall or GitHub releases */
@@ -1673,7 +1678,7 @@ interface CargoInstallParams extends BaseInstallParams {
 }
 type CargoToolConfig = InferToolConfigWithPlatforms<typeof cargoToolConfigSchema>;
 interface IInstallParamsRegistry {
-	cargo: CargoInstallParams;
+	cargo: ICargoInstallParams;
 }
 interface IToolConfigRegistry {
 	cargo: CargoToolConfig;
@@ -1710,7 +1715,7 @@ type CurlScriptEnv = Resolvable<ICurlScriptArgsContext, Record<string, string>>;
  * 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"> {
+interface ICurlScriptInstallParams extends Omit<IBaseInstallParams, "env"> {
 	/** The URL of the installation script to download. */
 	url: string;
 	/** The shell to use for executing the downloaded script. */
@@ -1721,8 +1726,8 @@ interface CurlScriptInstallParams extends Omit<BaseInstallParams, "env"> {
 	env?: CurlScriptEnv;
 	/** Arguments to pass to the binary to check the version. */
 	versionArgs?: string[];
-	/** Regex to extract version from output. */
-	versionRegex?: string;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 }
 declare const curlScriptToolConfigSchema: z.ZodObject<{
 	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1791,7 +1796,10 @@ declare const curlScriptToolConfigSchema: z.ZodObject<{
 		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>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 	}, z.core.$strict>;
 	binaries: z.ZodArray<z.ZodUnion<readonly [
 		z.ZodString,
@@ -1803,7 +1811,7 @@ declare const curlScriptToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type CurlScriptToolConfig = InferToolConfigWithPlatforms<typeof curlScriptToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"curl-script": CurlScriptInstallParams;
+	"curl-script": ICurlScriptInstallParams;
 }
 interface IToolConfigRegistry {
 	"curl-script": CurlScriptToolConfig;
@@ -1815,13 +1823,13 @@ interface IToolConfigRegistry {
  * 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 {
+interface ICurlTarInstallParams extends IBaseInstallParams {
 	/** 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;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 }
 declare const curlTarToolConfigSchema: z.ZodObject<{
 	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1885,7 +1893,10 @@ declare const curlTarToolConfigSchema: z.ZodObject<{
 		}, z.core.$strip>>;
 		url: z.ZodString;
 		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-		versionRegex: z.ZodOptional<z.ZodString>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 	}, z.core.$strict>;
 	binaries: z.ZodArray<z.ZodUnion<readonly [
 		z.ZodString,
@@ -1897,7 +1908,7 @@ declare const curlTarToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type CurlTarToolConfig = InferToolConfigWithPlatforms<typeof curlTarToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"curl-tar": CurlTarInstallParams;
+	"curl-tar": ICurlTarInstallParams;
 }
 interface IToolConfigRegistry {
 	"curl-tar": CurlTarToolConfig;
@@ -1918,7 +1929,7 @@ type AssetSelector = (context: IAssetSelectionContext) => IGitHubReleaseAsset |
  * 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 {
+interface IGithubReleaseInstallParams extends IBaseInstallParams {
 	/**
 	 * The GitHub repository in "owner/repo" format (e.g., `junegunn/fzf`).
 	 */
@@ -2025,12 +2036,12 @@ declare const githubReleaseToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type GithubReleaseToolConfig = InferToolConfigWithPlatforms<typeof githubReleaseToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"github-release": GithubReleaseInstallParams;
+	"github-release": IGithubReleaseInstallParams;
 }
 interface IToolConfigRegistry {
 	"github-release": GithubReleaseToolConfig;
 }
-interface DmgInstallParams extends BaseInstallParams {
+interface IDmgInstallParams extends IBaseInstallParams {
 	/** Source definition for resolving the DMG file. */
 	source: DmgSource;
 	/** The name of the .app bundle inside the DMG. */
@@ -2039,17 +2050,17 @@ interface DmgInstallParams extends BaseInstallParams {
 	binaryPath?: string;
 	/** Arguments to pass to the binary to check the version. */
 	versionArgs?: string[];
-	/** Regex to extract version from output. */
-	versionRegex?: string;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 }
-interface DmgUrlSource {
+interface IDmgUrlSource {
 	type: "url";
 	url: string;
 }
-interface DmgGitHubReleaseSource extends Pick<GithubReleaseInstallParams, "repo" | "version" | "assetPattern" | "assetSelector" | "ghCli" | "prerelease"> {
+interface IDmgGitHubReleaseSource extends Pick<IGithubReleaseInstallParams, "repo" | "version" | "assetPattern" | "assetSelector" | "ghCli" | "prerelease"> {
 	type: "github-release";
 }
-type DmgSource = DmgUrlSource | DmgGitHubReleaseSource;
+type DmgSource = IDmgUrlSource | IDmgGitHubReleaseSource;
 declare const dmgToolConfigSchema: z.ZodObject<{
 	binaries: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [
 		z.ZodString,
@@ -2138,12 +2149,15 @@ declare const dmgToolConfigSchema: z.ZodObject<{
 		appName: z.ZodOptional<z.ZodString>;
 		binaryPath: z.ZodOptional<z.ZodString>;
 		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-		versionRegex: z.ZodOptional<z.ZodString>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 	}, z.core.$strict>;
 }, z.core.$strict>;
 type DmgToolConfig = InferToolConfigWithPlatforms<typeof dmgToolConfigSchema>;
 interface IInstallParamsRegistry {
-	dmg: DmgInstallParams;
+	dmg: IDmgInstallParams;
 }
 interface IToolConfigRegistry {
 	dmg: DmgToolConfig;
@@ -2158,7 +2172,7 @@ type GiteaAssetSelector = (context: IGiteaAssetSelectionContext) => IGitHubRelea
 /**
  * Parameters for installing a tool from a Gitea/Forgejo release.
  */
-interface GiteaReleaseInstallParams extends BaseInstallParams {
+interface IGiteaReleaseInstallParams extends IBaseInstallParams {
 	instanceUrl: string;
 	repo: string;
 	assetPattern?: string | RegExp;
@@ -2248,7 +2262,7 @@ declare const giteaReleaseToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type GiteaReleaseToolConfig = InferToolConfigWithPlatforms<typeof giteaReleaseToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"gitea-release": GiteaReleaseInstallParams;
+	"gitea-release": IGiteaReleaseInstallParams;
 }
 interface IToolConfigRegistry {
 	"gitea-release": GiteaReleaseToolConfig;
@@ -2259,7 +2273,7 @@ interface IToolConfigRegistry {
  * 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 {
+interface IManualInstallParams extends IBaseInstallParams {
 	/**
 	 * The path to the binary file relative to the tool configuration file location.
 	 * If not specified, only shell configurations and symlinks will be processed.
@@ -2338,7 +2352,7 @@ declare const manualToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type ManualToolConfig = InferToolConfigWithPlatforms<typeof manualToolConfigSchema>;
 interface IInstallParamsRegistry {
-	manual: ManualInstallParams;
+	manual: IManualInstallParams;
 }
 interface INoParamsMethodRegistry {
 	manual: true;
@@ -2346,7 +2360,7 @@ interface INoParamsMethodRegistry {
 interface IToolConfigRegistry {
 	manual: ManualToolConfig;
 }
-interface ConfigContext {
+interface IConfigContext {
 	/**
 	 * The directory containing the configuration file.
 	 */
@@ -2356,7 +2370,7 @@ interface ConfigContext {
 	 */
 	systemInfo: ISystemInfo;
 }
-type ConfigFactory = (ctx: ConfigContext) => Promise<ProjectConfigPartial> | ProjectConfigPartial;
+type ConfigFactory = (ctx: IConfigContext) => Promise<ProjectConfigPartial> | ProjectConfigPartial;
 /**
  * Wraps a configuration factory so `.ts` config files stay fully typed.
  *
@@ -2385,7 +2399,6 @@ type ConfigFactory = (ctx: ConfigContext) => Promise<ProjectConfigPartial> | Pro
  * ```
  */
 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.
  *
@@ -2408,33 +2421,20 @@ type ConfigureToolFnResult = ToolConfig | IToolConfigBuilder | Omit<IToolConfigB
  * );
  * ```
  */
-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;
+export declare function defineTool(fn: AsyncConfigureTool): 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 {
+interface ICurlBinaryInstallParams extends IBaseInstallParams {
 	/** 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;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 }
 declare const curlBinaryToolConfigSchema: z.ZodObject<{
 	dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2498,7 +2498,10 @@ declare const curlBinaryToolConfigSchema: z.ZodObject<{
 		}, z.core.$strip>>;
 		url: z.ZodString;
 		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-		versionRegex: z.ZodOptional<z.ZodString>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 	}, z.core.$strict>;
 	binaries: z.ZodArray<z.ZodUnion<readonly [
 		z.ZodString,
@@ -2510,7 +2513,7 @@ declare const curlBinaryToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type CurlBinaryToolConfig = InferToolConfigWithPlatforms<typeof curlBinaryToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"curl-binary": CurlBinaryInstallParams;
+	"curl-binary": ICurlBinaryInstallParams;
 }
 interface IToolConfigRegistry {
 	"curl-binary": CurlBinaryToolConfig;
@@ -2521,7 +2524,7 @@ interface IToolConfigRegistry {
  * 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 {
+interface IZshPluginInstallParams extends IBaseInstallParams {
 	/** 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. */
@@ -2602,7 +2605,7 @@ declare const zshPluginToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type ZshPluginToolConfig = InferToolConfigWithPlatforms<typeof zshPluginToolConfigSchema>;
 interface IInstallParamsRegistry {
-	"zsh-plugin": ZshPluginInstallParams;
+	"zsh-plugin": IZshPluginInstallParams;
 }
 interface IToolConfigRegistry {
 	"zsh-plugin": ZshPluginToolConfig;
@@ -2613,15 +2616,15 @@ interface IToolConfigRegistry {
  * 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 {
+interface INpmInstallParams extends IBaseInstallParams {
 	/** 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;
+	/** Regex pattern or source string used to extract the version from output. */
+	versionRegex?: string | RegExp;
 	/** The package manager to use for installation. Defaults to `'npm'`. */
 	packageManager?: "npm" | "bun";
 }
@@ -2688,7 +2691,10 @@ declare const npmToolConfigSchema: z.ZodObject<{
 		package: z.ZodOptional<z.ZodString>;
 		version: z.ZodOptional<z.ZodString>;
 		versionArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-		versionRegex: z.ZodOptional<z.ZodString>;
+		versionRegex: z.ZodOptional<z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<RegExp, RegExp>
+		]>>;
 		packageManager: z.ZodOptional<z.ZodEnum<{
 			bun: "bun";
 			npm: "npm";
@@ -2704,27 +2710,27 @@ declare const npmToolConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 type NpmToolConfig = InferToolConfigWithPlatforms<typeof npmToolConfigSchema>;
 interface IInstallParamsRegistry {
-	npm: NpmInstallParams;
+	npm: INpmInstallParams;
 }
 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,
+	IBrewInstallParams as z_internal_BrewInstallParams,
+	ICargoInstallParams as z_internal_CargoInstallParams,
+	ICurlBinaryInstallParams as z_internal_CurlBinaryInstallParams,
+	ICurlScriptInstallParams as z_internal_CurlScriptInstallParams,
+	ICurlTarInstallParams as z_internal_CurlTarInstallParams,
+	IGiteaReleaseInstallParams as z_internal_GiteaReleaseInstallParams,
+	IGithubReleaseInstallParams as z_internal_GithubReleaseInstallParams,
 	IInstallParamsRegistry as z_internal_IInstallParamsRegistry,
 	IKnownBinNameRegistry as z_internal_IKnownBinNameRegistry,
+	IManualInstallParams as z_internal_ManualInstallParams,
+	INpmInstallParams as z_internal_NpmInstallParams,
 	ISystemInfo as z_internal_ISystemInfo,
+	IZshPluginInstallParams as z_internal_ZshPluginInstallParams,
 	InstallMethod as z_internal_InstallMethod,
-	ManualInstallParams as z_internal_ManualInstallParams,
-	NpmInstallParams as z_internal_NpmInstallParams,
-	ZshPluginInstallParams as z_internal_ZshPluginInstallParams,
 };
 export {};

package/skill/SKILL.md CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 name: dotfiles
 description: >-
-  .tool.ts configuration files, defineTool, install(), config.ts, defineConfig,
+  .tool.ts configuration files, defineTool, install(), dotfiles.config.ts, defineConfig,
   installation methods (github-release, gitea-release, brew, cargo, npm, curl-script, curl-tar, curl-binary, dmg, manual, zsh-plugin),
   shell integration (aliases, functions, completions, env, symlinks, sourceFile),
   hooks (before-install, after-download, after-extract, after-install),
@@ -15,12 +15,12 @@ Declarative, versioned dotfiles management. Define CLI tools in TypeScript `.too
 ## Quick Reference
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 export default defineTool((install, ctx) =>
-  install('github-release', { repo: 'BurntSushi/ripgrep' })
-    .bin('rg')
-    .zsh((shell) => shell.aliases({ rgi: 'rg -i' }).completions('complete/_rg'))
+  install("github-release", { repo: "BurntSushi/ripgrep" })
+    .bin("rg")
+    .zsh((shell) => shell.aliases({ rgi: "rg -i" }).completions("complete/_rg")),
 );
 ```
@@ -30,6 +30,8 @@ Every tool that provides executables **must** have `.bin()` — it generates a s
 After any `.tool.ts` file change (create, delete, or modify), run `dotfiles generate` to sync generated artifacts.
+`dotfiles install <tool-or-binary>` is also a repair command: it verifies the on-disk install payload, reinstalls broken tools, regenerates missing shims for non-externally-managed tools, removes stale temporary shims for externally managed tools, and reconciles the tool's generated artifacts.
 ## Reference Files
 Read these based on the task at hand: