import { ParsedArgs } from "@cli-forge/parser";

//#region src/lib/completion-types.d.ts
/**
 * Context passed to completion callbacks.
 */
interface CompletionContext<TArgs = ParsedArgs> {
  /** Partially-parsed args available so far */
  current: Partial<TArgs>;
  /** The raw argv being completed */
  argv: string[];
  /** Default completions cli-forge would return (subcommands, flags, choices) */
  defaultCompletions: string[];
}
/**
 * A completion callback that returns custom completion suggestions.
 * Used with `.completion()` on a CLI instance.
 */
type CompletionCallback<TArgs = ParsedArgs> = (context: CompletionContext<TArgs>) => string[] | Promise<string[]>;
/**
 * Per-option completion callback, attached to option configs via the `completion` field.
 */
type OptionCompletionCallback<TArgs = ParsedArgs> = (context: CompletionContext<TArgs>) => string[] | Promise<string[]>;
/**
 * Helpers for common completion scenarios.
 */
declare const completionHelpers: {
  /**
   * Returns a completion callback that suggests filesystem paths.
   * @param glob Optional glob pattern to filter results (e.g. '*.json')
   */
  files(glob?: string): OptionCompletionCallback;
};
//#endregion
export { CompletionCallback, CompletionContext, OptionCompletionCallback, completionHelpers };
//# sourceMappingURL=completion-types.d.mts.map