import { DeferredMap, ValueParserResult } from "./valueparser.js";
import { ExecutionContext, Mode, ModeValue, Parser } from "./internal/parser.js";

//#region src/phase2-seed.d.ts

/**
 * Best-effort parser value used for phase-two context collection.
 *
 * @internal
 */
interface Phase2Seed<T = unknown> {
  readonly value: T;
  readonly deferred?: true;
  readonly deferredKeys?: DeferredMap;
}
/**
 * Internal hook for extracting a best-effort phase-two seed from parser state.
 *
 * @internal
 */
type Phase2SeedExtractor<M extends Mode = Mode, TState = unknown, TValue = unknown> = (state: TState, exec?: ExecutionContext) => ModeValue<M, Phase2Seed<TValue> | null>;
/**
 * Internal parser hook key for phase-two seed extraction.
 *
 * @internal
 */
declare const extractPhase2SeedKey: unique symbol;
/**
 * Converts a successful complete() result into a phase-two seed.
 *
 * @internal
 */
declare function phase2SeedFromValueResult<T>(result: Extract<ValueParserResult<T>, {
  readonly success: true;
}>): Phase2Seed<T>;
/**
 * Invokes a parser's internal phase-two seed hook when present.
 *
 * @internal
 */
declare function extractPhase2Seed<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, state: TState, exec?: ExecutionContext): ModeValue<M, Phase2Seed<TValue> | null>;
/**
 * Attempts to complete a parser and falls back to the internal phase-two
 * seed hook when completion returns an unsuccessful result.
 *
 * @internal
 */
declare function completeOrExtractPhase2Seed<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, state: TState, exec?: ExecutionContext): ModeValue<M, Phase2Seed<TValue> | null>;
//#endregion
export { Phase2Seed, Phase2SeedExtractor, completeOrExtractPhase2Seed, extractPhase2Seed, extractPhase2SeedKey, phase2SeedFromValueResult };