/**
 * Host adapter — pure answer assembly (spec §10; no PI runtime, no fs, no network).
 *
 * The shared typed core both render paths feed. A renderer captures a {@link RawSelection} per question
 * (widget-shaped); {@link assembleAnswers} turns the batch into the structured answers object keyed by
 * `question.key` (dotted for nested sections), which the engine then maps back onto the target schema.
 *
 * The only PI reference here is a *type* — the run mode for the capability gate — a type-only import,
 * fully erased at runtime, so this module stays offline-testable.
 */
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
import type { Question, Questionnaire, QuestionOption } from "../flow/questionnaire.ts";
/** PI run mode (`"tui" | "rpc" | "json" | "print"`), derived from the exported context type. */
export type ExtensionMode = ExtensionContext["mode"];
/** Sentinel option value meaning "the user took the implicit Other choice and typed free text". */
export declare const OTHER_VALUE = "__other__";
/** Display label for the implicit "Other" choice appended to a single-choice question. */
export declare const OTHER_LABEL = "Other\u2026";
/**
 * A renderer's raw capture for one question, before typing. Both render paths (the rich `ctx.ui.custom`
 * form and the native-dialog fallback) produce this shape; {@link assembleAnswers} types it.
 */
export interface RawSelection {
    /** single: the picked option value, or {@link OTHER_VALUE} when the implicit "Other" choice was taken. */
    readonly option?: string;
    /** multi: the picked option values. */
    readonly options?: readonly string[];
    /** text/chat: the entered string; also the free text when `option === OTHER_VALUE`. */
    readonly text?: string;
}
/**
 * Assemble structured answers keyed by `question.key` from a renderer's raw per-question selections
 * (pure). single → the chosen value, or the "Other" free text; multi → an array; text/chat → a string.
 * A question with no capture collapses to the empty value of its shape (`""` / `[]`).
 */
export declare function assembleAnswers(questionnaire: Questionnaire, raw: Readonly<Record<string, RawSelection>>): Record<string, unknown>;
/** A question's options ordered for display: recommended first (stable), original order otherwise. */
export declare function orderedOptions(question: Question): QuestionOption[];
/** A question's prompt title: `"<section> — <question>"` when the question belongs to a section. */
export declare function questionTitle(question: Question): string;
/** A single option's display label: `label` + `(recommended)` marker + ` — description` when present. */
export declare function optionLabel(option: QuestionOption): string;
/**
 * Capability gate (pure): render the rich `ctx.ui.custom` form only when a real terminal TUI is present.
 * Everything else (RPC / JSON / print) falls back to native per-question dialogs — which also work over
 * RPC, where `custom` cannot render.
 */
export declare function useRichForm(mode: ExtensionMode, hasUI: boolean): boolean;
//# sourceMappingURL=answer-assembly.d.ts.map