import { CliOutputMode } from "./outfitter-fhahf9f3.js";
import { InternalError, Result } from "@outfitter/contracts";
/** Validated input for the docs.list action handler. */
interface DocsListInput {
	readonly cwd: string;
	readonly jq?: string | undefined;
	readonly kind?: string | undefined;
	readonly outputMode: CliOutputMode;
	readonly package?: string | undefined;
}
/** Single entry in the docs list output. */
interface DocsListEntry {
	readonly id: string;
	readonly kind: string;
	readonly outputPath: string;
	readonly package?: string;
	readonly sourcePath: string;
	readonly title: string;
}
/** Output shape for the docs.list action. */
interface DocsListOutput {
	readonly entries: DocsListEntry[];
	readonly total: number;
}
/**
* List documentation entries from the docs map.
*
* Generates the docs map for the workspace and returns a filtered list of
* entries. Supports filtering by doc kind and package name.
*
* @param input - Validated action input
* @returns Result containing the list of docs entries or an error
*/
declare function runDocsList(input: DocsListInput): Promise<Result<DocsListOutput, InternalError>>;
/**
* Print docs list results in the appropriate output format.
*
* @param result - The docs list output
* @param options - Output formatting options
*/
declare function printDocsListResults(result: DocsListOutput, options?: {
	mode?: CliOutputMode;
	jq?: string | undefined;
}): Promise<void>;
export { DocsListInput, DocsListEntry, DocsListOutput, runDocsList, printDocsListResults };