@kidd-cli/core 0.1.0

package/dist/project-NPtYX2ZX.js

@@ -0,0 +1,181 @@
+import { dirname, join, resolve } from "node:path";
+import { attempt } from "@kidd-cli/utils/fp";
+import { match as match$1 } from "ts-pattern";
+import { homedir } from "node:os";
+import { existsSync, readFileSync, statSync } from "node:fs";
+
+//#region src/lib/project/root.ts
+const MIN_MODULES_PARTS = 2;
+/**
+* Walk up the directory tree to find the nearest git project root.
+*
+* @param startDir - Directory to start searching from (defaults to cwd).
+* @returns The project root info, or null if no git root is found.
+*/
+function findProjectRoot(startDir = process.cwd()) {
+	/**
+	* Recursively walk up the directory tree searching for a `.git` marker.
+	*
+	* @private
+	*/
+	const findRootRecursive = (currentDir, visited) => {
+		if (visited.has(currentDir)) return null;
+		const nextVisited = new Set([...visited, currentDir]);
+		const gitPath = join(currentDir, ".git");
+		try {
+			const result = checkGitPath(gitPath, currentDir);
+			if (result) return result;
+		} catch {}
+		const parent = dirname(currentDir);
+		if (parent === currentDir) return null;
+		return findRootRecursive(parent, nextVisited);
+	};
+	return findRootRecursive(resolve(startDir), /* @__PURE__ */ new Set());
+}
+/**
+* Check whether the current directory is inside a git submodule.
+*
+* @param startDir - Directory to start searching from.
+* @returns True if the directory is inside a submodule.
+*/
+function isInSubmodule(startDir) {
+	const projectRoot = findProjectRoot(startDir);
+	if (!projectRoot) return false;
+	return projectRoot.isSubmodule;
+}
+/**
+* Resolve the parent repository root when inside a git submodule.
+*
+* @param startDir - Directory to start searching from.
+* @returns The parent repository root path, or null.
+*/
+function getParentRepoRoot(startDir) {
+	const projectRoot = findProjectRoot(startDir);
+	if (!projectRoot || !projectRoot.isSubmodule) return null;
+	const gitFileContent = resolveGitDirFromFile(join(projectRoot.path, ".git"));
+	if (gitFileContent === null) return null;
+	return resolveParentGitDir(projectRoot, gitFileContent);
+}
+/**
+* Resolve a `.git` file reference to determine if this is a submodule.
+*
+* @private
+*/
+function resolveGitFileSubmodule(gitPath, currentDir) {
+	const [readError, gitFileContent] = attempt(() => readFileSync(gitPath, "utf8").trim());
+	if (readError || gitFileContent === null) return {
+		isSubmodule: false,
+		path: currentDir
+	};
+	const gitDirMatch = gitFileContent.match(/^gitdir:\s*(.+)$/);
+	if (gitDirMatch && gitDirMatch[1]) {
+		const gitDir = resolve(currentDir, gitDirMatch[1]);
+		return {
+			isSubmodule: /[/\\]\.git[/\\]modules[/\\]/.test(gitDir),
+			path: currentDir
+		};
+	}
+	return null;
+}
+/**
+* Check whether a `.git` path is a directory or file and resolve accordingly.
+*
+* @private
+*/
+function checkGitPath(gitPath, currentDir) {
+	if (!existsSync(gitPath)) return null;
+	const stats = statSync(gitPath);
+	if (stats.isDirectory()) return {
+		isSubmodule: false,
+		path: currentDir
+	};
+	if (stats.isFile()) return resolveGitFileSubmodule(gitPath, currentDir);
+	return null;
+}
+/**
+* Read a `.git` file and return its raw content.
+*
+* @private
+*/
+function resolveGitDirFromFile(gitFilePath) {
+	const [readError, gitFileContent] = attempt(() => readFileSync(gitFilePath, "utf8").trim());
+	if (readError || gitFileContent === null) return null;
+	return gitFileContent;
+}
+/**
+* Extract the parent repository root from a resolved git modules path.
+*
+* @private
+*/
+function resolveParentFromGitDir(resolvedGitDir) {
+	const gitDirParts = resolvedGitDir.split("/modules/");
+	if (gitDirParts.length >= MIN_MODULES_PARTS) {
+		const [parentGitDir] = gitDirParts;
+		if (parentGitDir && parentGitDir.endsWith(".git")) return dirname(parentGitDir);
+	}
+	return null;
+}
+/**
+* Resolve the parent repository root from a submodule's gitdir reference.
+*
+* @private
+*/
+function resolveParentGitDir(projectRoot, gitFileContent) {
+	const gitDirMatch = gitFileContent.match(/^gitdir:\s*(.+)$/);
+	if (!gitDirMatch) return null;
+	const gitDir = gitDirMatch[1] ?? "";
+	const resolvedGitDir = resolve(projectRoot.path, gitDir);
+	if (process.platform === "win32") return null;
+	return resolveParentFromGitDir(resolvedGitDir);
+}
+
+//#endregion
+//#region src/lib/project/paths.ts
+/**
+* Resolve a directory path relative to the project root.
+*
+* @param options - Options containing the directory name and optional start directory.
+* @returns The resolved local path, or null if no project root is found.
+*/
+function resolveLocalPath(options) {
+	const projectRoot = findProjectRoot(options.startDir);
+	if (!projectRoot) return null;
+	return join(projectRoot.path, options.dirName);
+}
+/**
+* Resolve a directory path relative to the user's home directory.
+*
+* @param options - Options containing the directory name.
+* @returns The resolved global path.
+*/
+function resolveGlobalPath(options) {
+	return join(homedir(), options.dirName);
+}
+/**
+* Resolve a directory path using the specified source strategy.
+*
+* When source is 'local', resolves relative to the project root.
+* When source is 'global', resolves relative to the home directory.
+* When source is 'resolve' (default), tries local first, falling back to global.
+*
+* @param options - Resolution options with dirName, source, and startDir.
+* @returns The resolved path, or null if local resolution fails with source='local'.
+*/
+function resolvePath(options) {
+	const { dirName, source = "resolve", startDir } = options;
+	return match$1(source).with("local", () => resolveLocalPath({
+		dirName,
+		startDir
+	})).with("global", () => resolveGlobalPath({ dirName })).with("resolve", () => {
+		const localPath = resolveLocalPath({
+			dirName,
+			startDir
+		});
+		if (localPath) return localPath;
+		return resolveGlobalPath({ dirName });
+	}).exhaustive();
+}
+
+//#endregion
+export { getParentRepoRoot as a, findProjectRoot as i, resolveLocalPath as n, isInSubmodule as o, resolvePath as r, resolveGlobalPath as t };
+//# sourceMappingURL=project-NPtYX2ZX.js.map

package/dist/project-NPtYX2ZX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-NPtYX2ZX.js","names":["match"],"sources":["../src/lib/project/root.ts","../src/lib/project/paths.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\n\nimport { attempt } from '@kidd-cli/utils/fp'\n\nimport type { ProjectRoot } from './types.js'\n\nconst MIN_MODULES_PARTS = 2\n\n/**\n * Walk up the directory tree to find the nearest git project root.\n *\n * @param startDir - Directory to start searching from (defaults to cwd).\n * @returns The project root info, or null if no git root is found.\n */\nexport function findProjectRoot(startDir: string = process.cwd()): ProjectRoot | null {\n  /**\n   * Recursively walk up the directory tree searching for a `.git` marker.\n   *\n   * @private\n   */\n  const findRootRecursive = (currentDir: string, visited: Set<string>): ProjectRoot | null => {\n    if (visited.has(currentDir)) {\n      return null\n    }\n    const nextVisited = new Set([...visited, currentDir])\n\n    const gitPath = join(currentDir, '.git')\n    try {\n      const result = checkGitPath(gitPath, currentDir)\n      if (result) {\n        return result\n      }\n    } catch {\n      // Race condition: file may have been deleted between existsSync and statSync\n    }\n\n    const parent = dirname(currentDir)\n    if (parent === currentDir) {\n      return null\n    }\n    return findRootRecursive(parent, nextVisited)\n  }\n\n  return findRootRecursive(resolve(startDir), new Set())\n}\n\n/**\n * Check whether the current directory is inside a git submodule.\n *\n * @param startDir - Directory to start searching from.\n * @returns True if the directory is inside a submodule.\n */\nexport function isInSubmodule(startDir?: string): boolean {\n  const projectRoot = findProjectRoot(startDir)\n  if (!projectRoot) {\n    return false\n  }\n  return projectRoot.isSubmodule\n}\n\n/**\n * Resolve the parent repository root when inside a git submodule.\n *\n * @param startDir - Directory to start searching from.\n * @returns The parent repository root path, or null.\n */\nexport function getParentRepoRoot(startDir?: string): string | null {\n  const projectRoot = findProjectRoot(startDir)\n  if (!projectRoot || !projectRoot.isSubmodule) {\n    return null\n  }\n\n  const gitFilePath = join(projectRoot.path, '.git')\n  const gitFileContent = resolveGitDirFromFile(gitFilePath)\n  if (gitFileContent === null) {\n    return null\n  }\n\n  return resolveParentGitDir(projectRoot, gitFileContent)\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a `.git` file reference to determine if this is a submodule.\n *\n * @private\n */\nfunction resolveGitFileSubmodule(gitPath: string, currentDir: string): ProjectRoot | null {\n  const [readError, gitFileContent] = attempt(() => readFileSync(gitPath, 'utf8').trim())\n  if (readError || gitFileContent === null) {\n    return { isSubmodule: false, path: currentDir }\n  }\n  const gitDirMatch = gitFileContent.match(/^gitdir:\\s*(.+)$/)\n  if (gitDirMatch && gitDirMatch[1]) {\n    const gitDir = resolve(currentDir, gitDirMatch[1])\n    const isSubmodule = /[/\\\\]\\.git[/\\\\]modules[/\\\\]/.test(gitDir)\n    return { isSubmodule, path: currentDir }\n  }\n  return null\n}\n\n/**\n * Check whether a `.git` path is a directory or file and resolve accordingly.\n *\n * @private\n */\nfunction checkGitPath(gitPath: string, currentDir: string): ProjectRoot | null {\n  if (!existsSync(gitPath)) {\n    return null\n  }\n\n  const stats = statSync(gitPath)\n  if (stats.isDirectory()) {\n    return { isSubmodule: false, path: currentDir }\n  }\n\n  if (stats.isFile()) {\n    return resolveGitFileSubmodule(gitPath, currentDir)\n  }\n\n  return null\n}\n\n/**\n * Read a `.git` file and return its raw content.\n *\n * @private\n */\nfunction resolveGitDirFromFile(gitFilePath: string): string | null {\n  const [readError, gitFileContent] = attempt(() => readFileSync(gitFilePath, 'utf8').trim())\n  if (readError || gitFileContent === null) {\n    return null\n  }\n  return gitFileContent\n}\n\n/**\n * Extract the parent repository root from a resolved git modules path.\n *\n * @private\n */\nfunction resolveParentFromGitDir(resolvedGitDir: string): string | null {\n  const gitDirParts = resolvedGitDir.split('/modules/')\n  if (gitDirParts.length >= MIN_MODULES_PARTS) {\n    const [parentGitDir] = gitDirParts\n    if (parentGitDir && parentGitDir.endsWith('.git')) {\n      return dirname(parentGitDir)\n    }\n  }\n  return null\n}\n\n/**\n * Resolve the parent repository root from a submodule's gitdir reference.\n *\n * @private\n */\nfunction resolveParentGitDir(projectRoot: ProjectRoot, gitFileContent: string): string | null {\n  const gitDirMatch = gitFileContent.match(/^gitdir:\\s*(.+)$/)\n  if (!gitDirMatch) {\n    return null\n  }\n\n  const gitDir = gitDirMatch[1] ?? ''\n  const resolvedGitDir = resolve(projectRoot.path, gitDir)\n\n  if (process.platform === 'win32') {\n    return null\n  }\n\n  return resolveParentFromGitDir(resolvedGitDir)\n}\n","import { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nimport { match } from 'ts-pattern'\n\nimport { findProjectRoot } from './root.js'\nimport type { ResolvePathOptions } from './types.js'\n\n/**\n * Resolve a directory path relative to the project root.\n *\n * @param options - Options containing the directory name and optional start directory.\n * @returns The resolved local path, or null if no project root is found.\n */\nexport function resolveLocalPath(options: {\n  readonly dirName: string\n  readonly startDir?: string\n}): string | null {\n  const projectRoot = findProjectRoot(options.startDir)\n  if (!projectRoot) {\n    return null\n  }\n  return join(projectRoot.path, options.dirName)\n}\n\n/**\n * Resolve a directory path relative to the user's home directory.\n *\n * @param options - Options containing the directory name.\n * @returns The resolved global path.\n */\nexport function resolveGlobalPath(options: { readonly dirName: string }): string {\n  return join(homedir(), options.dirName)\n}\n\n/**\n * Resolve a directory path using the specified source strategy.\n *\n * When source is 'local', resolves relative to the project root.\n * When source is 'global', resolves relative to the home directory.\n * When source is 'resolve' (default), tries local first, falling back to global.\n *\n * @param options - Resolution options with dirName, source, and startDir.\n * @returns The resolved path, or null if local resolution fails with source='local'.\n */\nexport function resolvePath(options: ResolvePathOptions): string | null {\n  const { dirName, source = 'resolve', startDir } = options\n  return match(source)\n    .with('local', (): string | null => resolveLocalPath({ dirName, startDir }))\n    .with('global', (): string => resolveGlobalPath({ dirName }))\n    .with('resolve', (): string => {\n      const localPath = resolveLocalPath({ dirName, startDir })\n      if (localPath) {\n        return localPath\n      }\n      return resolveGlobalPath({ dirName })\n    })\n    .exhaustive()\n}\n"],"mappings":"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"}

package/dist/prompts-lLfUSgd6.js

@@ -0,0 +1,63 @@
+import * as clack from "@clack/prompts";
+
+//#region src/lib/prompts/create-prompts.ts
+/**
+* Create a new {@link Spinner} instance backed by @clack/prompts.
+*/
+function createSpinner() {
+	const spinnerInstance = clack.spinner();
+	return {
+		message(msg) {
+			spinnerInstance.message(msg);
+		},
+		start(message) {
+			spinnerInstance.start(message);
+		},
+		stop(message) {
+			spinnerInstance.stop(message);
+		}
+	};
+}
+/**
+* Create a new {@link PromptUtils} instance backed by @clack/prompts.
+*/
+function createPromptUtils() {
+	return {
+		cancel(message) {
+			clack.cancel(message);
+		},
+		confirm(opts) {
+			return clack.confirm(opts);
+		},
+		isCancel(value) {
+			return clack.isCancel(value);
+		},
+		multiselect(opts) {
+			return clack.multiselect(opts);
+		},
+		password(opts) {
+			return clack.password(opts);
+		},
+		select(opts) {
+			return clack.select(opts);
+		},
+		text(opts) {
+			return clack.text(opts);
+		}
+	};
+}
+
+//#endregion
+//#region src/lib/prompts/defaults.ts
+/**
+* Default spinner instance.
+*/
+const spinner = createSpinner();
+/**
+* Default prompt utilities instance.
+*/
+const prompts = createPromptUtils();
+
+//#endregion
+export { createSpinner as i, spinner as n, createPromptUtils as r, prompts as t };
+//# sourceMappingURL=prompts-lLfUSgd6.js.map

package/dist/prompts-lLfUSgd6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts-lLfUSgd6.js","names":[],"sources":["../src/lib/prompts/create-prompts.ts","../src/lib/prompts/defaults.ts"],"sourcesContent":["import * as clack from '@clack/prompts'\n\nimport type { PromptUtils, Spinner } from './types.js'\n\n/**\n * Create a new {@link Spinner} instance backed by @clack/prompts.\n */\nexport function createSpinner(): Spinner {\n  const spinnerInstance = clack.spinner()\n\n  return {\n    message(msg: string): void {\n      spinnerInstance.message(msg)\n    },\n\n    start(message?: string): void {\n      spinnerInstance.start(message)\n    },\n\n    stop(message?: string): void {\n      spinnerInstance.stop(message)\n    },\n  }\n}\n\n/**\n * Create a new {@link PromptUtils} instance backed by @clack/prompts.\n */\nexport function createPromptUtils(): PromptUtils {\n  return {\n    cancel(message?: string): void {\n      clack.cancel(message)\n    },\n\n    confirm(\n      opts: Omit<Parameters<typeof clack.confirm>[0], 'output'>\n    ): ReturnType<typeof clack.confirm> {\n      return clack.confirm(opts)\n    },\n\n    isCancel(value: unknown): value is symbol {\n      return clack.isCancel(value)\n    },\n\n    multiselect<TValue>(\n      opts: Omit<Parameters<typeof clack.multiselect<TValue>>[0], 'output'>\n    ): ReturnType<typeof clack.multiselect<TValue>> {\n      return clack.multiselect(opts)\n    },\n\n    password(\n      opts: Omit<Parameters<typeof clack.password>[0], 'output'>\n    ): ReturnType<typeof clack.password> {\n      return clack.password(opts)\n    },\n\n    select<TValue>(\n      opts: Omit<Parameters<typeof clack.select<TValue>>[0], 'output'>\n    ): ReturnType<typeof clack.select<TValue>> {\n      return clack.select(opts)\n    },\n\n    text(opts: Omit<Parameters<typeof clack.text>[0], 'output'>): ReturnType<typeof clack.text> {\n      return clack.text(opts)\n    },\n  }\n}\n","import { createPromptUtils, createSpinner } from './create-prompts.js'\nimport type { PromptUtils, Spinner } from './types.js'\n\n/**\n * Default spinner instance.\n */\nexport const spinner: Spinner = createSpinner()\n\n/**\n * Default prompt utilities instance.\n */\nexport const prompts: PromptUtils = createPromptUtils()\n"],"mappings":";;;;;;AAOA,SAAgB,gBAAyB;CACvC,MAAM,kBAAkB,MAAM,SAAS;AAEvC,QAAO;EACL,QAAQ,KAAmB;AACzB,mBAAgB,QAAQ,IAAI;;EAG9B,MAAM,SAAwB;AAC5B,mBAAgB,MAAM,QAAQ;;EAGhC,KAAK,SAAwB;AAC3B,mBAAgB,KAAK,QAAQ;;EAEhC;;;;;AAMH,SAAgB,oBAAiC;AAC/C,QAAO;EACL,OAAO,SAAwB;AAC7B,SAAM,OAAO,QAAQ;;EAGvB,QACE,MACkC;AAClC,UAAO,MAAM,QAAQ,KAAK;;EAG5B,SAAS,OAAiC;AACxC,UAAO,MAAM,SAAS,MAAM;;EAG9B,YACE,MAC8C;AAC9C,UAAO,MAAM,YAAY,KAAK;;EAGhC,SACE,MACmC;AACnC,UAAO,MAAM,SAAS,KAAK;;EAG7B,OACE,MACyC;AACzC,UAAO,MAAM,OAAO,KAAK;;EAG3B,KAAK,MAAuF;AAC1F,UAAO,MAAM,KAAK,KAAK;;EAE1B;;;;;;;;AC3DH,MAAa,UAAmB,eAAe;;;;AAK/C,MAAa,UAAuB,mBAAmB"}

package/dist/types-CqKJhsYk.d.ts

@@ -0,0 +1,135 @@
+import { AsyncResult } from "@kidd-cli/utils/fp";
+
+//#region src/middleware/auth/types.d.ts
+/**
+* Bearer token credential — sends `Authorization: Bearer <token>`.
+*/
+interface BearerCredential {
+  readonly type: "bearer";
+  readonly token: string;
+}
+/**
+* Basic auth credential — sends `Authorization: Basic base64(user:pass)`.
+*/
+interface BasicCredential {
+  readonly type: "basic";
+  readonly username: string;
+  readonly password: string;
+}
+/**
+* API key credential — sends the key in a custom header.
+*/
+interface ApiKeyCredential {
+  readonly type: "api-key";
+  readonly headerName: string;
+  readonly key: string;
+}
+/**
+* Custom credential — sends arbitrary headers.
+*/
+interface CustomCredential {
+  readonly type: "custom";
+  readonly headers: Readonly<Record<string, string>>;
+}
+/**
+* Discriminated union of all supported auth credential formats.
+* The `type` field acts as the discriminator.
+*/
+type AuthCredential = BearerCredential | BasicCredential | ApiKeyCredential | CustomCredential;
+/**
+* Resolve credentials from environment variables.
+*/
+interface EnvSourceConfig {
+  readonly source: "env";
+  readonly tokenVar?: string;
+}
+/**
+* Resolve credentials from a `.env` file parsed with dotenv.
+*/
+interface DotenvSourceConfig {
+  readonly source: "dotenv";
+  readonly tokenVar?: string;
+  readonly path?: string;
+}
+/**
+* Resolve credentials from a JSON file on disk.
+*/
+interface FileSourceConfig {
+  readonly source: "file";
+  readonly filename?: string;
+  readonly dirName?: string;
+}
+/**
+* Resolve credentials via an OAuth browser flow.
+*/
+interface OAuthSourceConfig {
+  readonly source: "oauth";
+  readonly authUrl: string;
+  readonly port?: number;
+  readonly callbackPath?: string;
+  readonly timeout?: number;
+}
+/**
+* Resolve credentials by prompting the user interactively.
+*/
+interface PromptSourceConfig {
+  readonly source: "prompt";
+  readonly message?: string;
+}
+/**
+* Resolve credentials via a user-supplied function.
+*/
+interface CustomSourceConfig {
+  readonly source: "custom";
+  readonly resolver: () => Promise<AuthCredential | null> | AuthCredential | null;
+}
+/**
+* Discriminated union of all supported credential source configurations.
+* The `source` field acts as the discriminator.
+*/
+type ResolverConfig = EnvSourceConfig | DotenvSourceConfig | FileSourceConfig | OAuthSourceConfig | PromptSourceConfig | CustomSourceConfig;
+/**
+* Error returned by {@link AuthContext.authenticate} when interactive auth fails.
+*/
+interface LoginError {
+  readonly type: "no_credential" | "save_failed";
+  readonly message: string;
+}
+/**
+* Auth context decorated onto `ctx.auth` by the auth middleware.
+*
+* No credential data is stored directly on the context. Instead, callers
+* use `credential()` to read saved credentials on demand and
+* `authenticated()` to check whether a credential exists without exposing it.
+*
+* `authenticate()` runs the configured interactive resolvers (OAuth, prompt,
+* etc.), persists the resulting credential to disk, and returns a
+* {@link AsyncResult}.
+*/
+interface AuthContext {
+  readonly credential: () => AuthCredential | null;
+  readonly authenticated: () => boolean;
+  readonly authenticate: () => AsyncResult<AuthCredential, LoginError>;
+}
+/**
+* Options accepted by the `auth()` middleware factory.
+*
+* @property resolvers - Ordered list of credential sources to try via `authenticate()`.
+*/
+interface AuthOptions {
+  readonly resolvers: readonly ResolverConfig[];
+}
+/**
+* Augments the base {@link Context} with an optional `auth` property.
+*
+* When a consumer imports `kidd/auth`, this declaration merges `auth`
+* onto `Context` so that `ctx.auth` is typed without manual casting.
+*/
+declare module "@kidd-cli/core" {
+  interface Context {
+    readonly auth: AuthContext;
+  }
+}
+//#endregion
+export { ResolverConfig as a, LoginError as i, AuthCredential as n, AuthOptions as r, AuthContext as t };
+//# sourceMappingURL=types-CqKJhsYk.d.ts.map

package/dist/types-CqKJhsYk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CqKJhsYk.d.ts","names":[],"sources":["../src/middleware/auth/types.ts"],"mappings":";;;;;;UAmBiB,gBAAA;EAAA,SACN,IAAA;EAAA,SACA,KAAA;AAAA;AAeX;;;AAAA,UATiB,eAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,QAAA;AAAA;;AAeX;;UATiB,gBAAA;EAAA,SACN,IAAA;EAAA,SACA,UAAA;EAAA,SACA,GAAA;AAAA;;;;UAMM,gBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA,EAAS,QAAA,CAAS,MAAA;AAAA;;;;;KAOjB,cAAA,GACR,gBAAA,GACA,eAAA,GACA,gBAAA,GACA,gBAAA;;;;UASa,eAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA;AAAA;;;;UAMM,kBAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA;EAAA,SACA,IAAA;AAAA;;;;UAMM,gBAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA;EAAA,SACA,OAAA;AAAA;;;;UAMM,iBAAA;EAAA,SACN,MAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,YAAA;EAAA,SACA,OAAA;AAAA;;;;UAMM,kBAAA;EAAA,SACN,MAAA;EAAA,SACA,OAAA;AAAA;AAFX;;;AAAA,UAQiB,kBAAA;EAAA,SACN,MAAA;EAAA,SACA,QAAA,QAAgB,OAAA,CAAQ,cAAA,WAAyB,cAAA;AAAA;;;;;KAOhD,cAAA,GACR,eAAA,GACA,kBAAA,GACA,gBAAA,GACA,iBAAA,GACA,kBAAA,GACA,kBAAA;;;;UASa,UAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;AAAA;;AAjBX;;;;;;;;;;UAmCiB,WAAA;EAAA,SACN,UAAA,QAAkB,cAAA;EAAA,SAClB,aAAA;EAAA,SACA,YAAA,QAAoB,WAAA,CAAY,cAAA,EAAgB,UAAA;AAAA;;;;;AAvB3D;UAmCiB,WAAA;EAAA,SACN,SAAA,WAAoB,cAAA;AAAA;;AAhB/B;;;;;;YA8BY,OAAA;IAAA,SACC,IAAA,EAAM,WAAA;EAAA;AAAA"}

package/dist/types-Cz9h927W.d.ts

@@ -0,0 +1,23 @@
+//#region src/lib/project/types.d.ts
+/**
+* Resolved project root with submodule detection.
+*/
+interface ProjectRoot {
+  readonly isSubmodule: boolean;
+  readonly path: string;
+}
+/**
+* Source strategy for path resolution.
+*/
+type PathSource = "local" | "global" | "resolve";
+/**
+* Options for resolving a directory path from local or global sources.
+*/
+interface ResolvePathOptions {
+  readonly dirName: string;
+  readonly source?: PathSource;
+  readonly startDir?: string;
+}
+//#endregion
+export { ProjectRoot as n, ResolvePathOptions as r, PathSource as t };
+//# sourceMappingURL=types-Cz9h927W.d.ts.map

package/dist/types-Cz9h927W.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Cz9h927W.d.ts","names":[],"sources":["../src/lib/project/types.ts"],"mappings":";;AAGA;;UAAiB,WAAA;EAAA,SACN,WAAA;EAAA,SACA,IAAA;AAAA;;;;KAMC,UAAA;AAKZ;;;AAAA,UAAiB,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,MAAA,GAAS,UAAA;EAAA,SACT,QAAA;AAAA"}

package/dist/types-DFtYg5uZ.d.ts

@@ -0,0 +1,26 @@
+import * as clack from "@clack/prompts";
+
+//#region src/lib/prompts/types.d.ts
+/**
+* Terminal spinner for indicating long-running operations.
+*/
+interface Spinner {
+  start(message?: string): void;
+  stop(message?: string): void;
+  message(message: string): void;
+}
+/**
+* Interactive prompt methods backed by @clack/prompts.
+*/
+interface PromptUtils {
+  select<TValue>(opts: Omit<Parameters<typeof clack.select<TValue>>[0], "output">): ReturnType<typeof clack.select<TValue>>;
+  confirm(opts: Omit<Parameters<typeof clack.confirm>[0], "output">): ReturnType<typeof clack.confirm>;
+  text(opts: Omit<Parameters<typeof clack.text>[0], "output">): ReturnType<typeof clack.text>;
+  multiselect<TValue>(opts: Omit<Parameters<typeof clack.multiselect<TValue>>[0], "output">): ReturnType<typeof clack.multiselect<TValue>>;
+  password(opts: Omit<Parameters<typeof clack.password>[0], "output">): ReturnType<typeof clack.password>;
+  isCancel(value: unknown): value is symbol;
+  cancel(message?: string): void;
+}
+//#endregion
+export { Spinner as n, PromptUtils as t };
+//# sourceMappingURL=types-DFtYg5uZ.d.ts.map

package/dist/types-DFtYg5uZ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DFtYg5uZ.d.ts","names":[],"sources":["../src/lib/prompts/types.ts"],"mappings":";;;;;AAKA;UAAiB,OAAA;EACf,KAAA,CAAM,OAAA;EACN,IAAA,CAAK,OAAA;EACL,OAAA,CAAQ,OAAA;AAAA;;;;UAMO,WAAA;EACf,MAAA,SACE,IAAA,EAAM,IAAA,CAAK,UAAA,QAAkB,KAAA,CAAM,MAAA,CAAO,MAAA,mBACzC,UAAA,QAAkB,KAAA,CAAM,MAAA,CAAO,MAAA;EAClC,OAAA,CACE,IAAA,EAAM,IAAA,CAAK,UAAA,QAAkB,KAAA,CAAM,OAAA,kBAClC,UAAA,QAAkB,KAAA,CAAM,OAAA;EAC3B,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,UAAA,QAAkB,KAAA,CAAM,IAAA,kBAAsB,UAAA,QAAkB,KAAA,CAAM,IAAA;EACtF,WAAA,SACE,IAAA,EAAM,IAAA,CAAK,UAAA,QAAkB,KAAA,CAAM,WAAA,CAAY,MAAA,mBAC9C,UAAA,QAAkB,KAAA,CAAM,WAAA,CAAY,MAAA;EACvC,QAAA,CACE,IAAA,EAAM,IAAA,CAAK,UAAA,QAAkB,KAAA,CAAM,QAAA,kBAClC,UAAA,QAAkB,KAAA,CAAM,QAAA;EAC3B,QAAA,CAAS,KAAA,YAAiB,KAAA;EAC1B,MAAA,CAAO,OAAA;AAAA"}