import { GitHubAction } from '../../types/github-action';
/**
 * Parses a GitHub Action reference string and returns a structured GitHubAction
 * object.
 *
 * @example
 *
 * ```ts
 * const action = parseActionReference(
 *   'actions/checkout@v3',
 *   'workflow.yml',
 *   10,
 * )
 * // Returns:
 * // {
 * //   type: 'external',
 * //   name: 'actions/checkout',
 * //   version: 'v3',
 * //   file: 'workflow.yml',
 * //   line: 10,
 * // }
 * ```
 *
 * @param reference - The action reference string to parse. Can be:
 *
 *   - External action: "owner/repo@version" (e.g., "actions/checkout@v3")
 *   - Local action: "./path/to/action" or "../path/to/action"
 *   - Docker action: "docker://image:tag".
 *
 * @param file - The file path where this action reference was found.
 * @param line - The line number where this action reference was found.
 * @returns A GitHubAction object if parsing succeeds, null otherwise.
 */
export declare function parseActionReference(reference: string, file: string, line: number): GitHubAction | null;