/**
 * reader.ts, the profile, read as occasions and plans.
 *
 * One direction only. This module reads the owner's file and types what it
 * finds; nothing here writes, and nothing here takes a date from anywhere other
 * than the owner's file. That is the §6 rule made structural: a calendar entry is a
 * single occurrence of an ephemeral thing, and sourcing an occasion from one
 * would give the wrong recurrence and lose the fact the moment the event passed.
 * There is no calendar-shaped input to this module, so there is no path to get
 * it wrong later.
 *
 * The reader is also where CONFLICTS are found. The profile already preserves
 * every line the owner wrote, so two different dates for the same thing are both
 * sitting in the document; taking the newer one silently would be the one
 * behaviour explicitly ruled out. Both are reported, and the conflict becomes an
 * open item that is raised now and raised again if it is ignored.
 */
import type { ProfileLine } from '../owner-profile/types.js';
import { type IsoDate } from './dates.js';
import type { Occasion, OccasionConflict, Plan, UnparsedOccasionLine, UnparsedPlanLine } from './types.js';
/**
 * The narrow read surface this module needs from the owner-profile store.
 *
 * Three named methods, no generic section reader: the store deliberately has no
 * "give me any closed section" call and this interface must not become one by
 * accident.
 */
export interface OccasionProfileSource {
    /** Raw prose lines under `## Important dates`. */
    importantDates(): readonly ProfileLine[];
    /** Raw prose lines under `## Plans`. */
    plans(): readonly ProfileLine[];
    /** Profile lines mentioning one person, by name. Opens the interview. */
    person(name: string): readonly ProfileLine[];
    /**
     * What the owner calls THEMSELVES: `identity.name` and `identity.goesBy`.
     *
     * The linkage that lets an entry using the owner's own name be recognised as
     * being about the person whose file this is, without any name literal living
     * in the code. Values they have not declared are simply absent from the list.
     *
     * OPTIONAL, and absent means "no names known" rather than "no match". A
     * narrow embed that does not supply it gets `unattributed` for everything,
     * which is the ordinary cadence, the failure direction that costs the owner a
     * nudge they did not need rather than one they did.
     */
    ownerNames?(): readonly string[];
}
/** Everything the dates section holds, including what did not parse. */
export interface OccasionReadResult {
    readonly occasions: readonly Occasion[];
    readonly unparsed: readonly UnparsedOccasionLine[];
    readonly conflicts: readonly OccasionConflict[];
}
/** Everything the plans section holds. */
export interface PlanReadResult {
    readonly plans: readonly Plan[];
    readonly unparsed: readonly UnparsedPlanLine[];
}
/**
 * Read every occasion, in document order.
 *
 * The FIRST line for an id is the active occasion, matching the profile's own
 * rule for a duplicated mechanical field. A later line for the same id is not
 * dropped: if it names a different date it becomes a conflict, and if it names
 * the same one it is a harmless duplicate that stays in the file and stays
 * visible.
 */
export declare function readOccasions(source: OccasionProfileSource): OccasionReadResult;
/** Read every plan, in document order. */
export declare function readPlans(source: OccasionProfileSource): PlanReadResult;
/** The plan covering `date` that takes the owner away from home, if there is one. */
export declare function awayPlanOn(plans: readonly Plan[], date: IsoDate): Plan | undefined;
/**
 * The next away plan that STARTS on or after `date`, if there is one.
 *
 * Used to move a nudge earlier so it reaches the owner before they leave rather
 * than while they are standing in an airport. Ordered by start date because two
 * overlapping trips would otherwise resolve by document order, which is the
 * order they happened to type them in.
 */
export declare function nextAwayPlanFrom(plans: readonly Plan[], date: IsoDate): Plan | undefined;
/** True when the owner is away on `date`. */
export declare function isAwayOn(plans: readonly Plan[], date: IsoDate): boolean;
//# sourceMappingURL=reader.d.ts.map