import type { StatModifierSet } from "../stats/statModifiers.js";
export type TalentRequirement = string | {
    nodeId: string;
    rank: number;
};
export interface TalentNodeDef<TStat extends string = string> {
    id: string;
    branch?: string;
    maxRank: number;
    requires?: readonly TalentRequirement[];
    requiresPointsInBranch?: number;
    modifiersPerRank?: StatModifierSet<TStat>;
    grantsAbilities?: readonly string[];
}
export type TalentAllocateReason = "unknown-node" | "max-rank" | "no-points" | "requires" | "branch-points";
export type TalentAllocateResult = {
    ok: true;
} | {
    ok: false;
    reason: TalentAllocateReason;
};
export interface ResolvedTalents<TStat extends string = string> {
    stats: StatModifierSet<TStat>;
    abilities: readonly string[];
}
export interface TalentSnapshot {
    points: number;
    ranks: Record<string, number>;
}
export interface TalentTreeConfig<TStat extends string = string> {
    nodes: readonly TalentNodeDef<TStat>[];
    points?: number;
}
export interface TalentTree<TStat extends string = string> {
    rank(nodeId: string): number;
    pointsAvailable(): number;
    pointsSpent(): number;
    pointsInBranch(branch: string): number;
    grantPoints(amount: number): void;
    canAllocate(nodeId: string): TalentAllocateResult;
    allocate(nodeId: string): TalentAllocateResult;
    resolved(): ResolvedTalents<TStat>;
    reset(): void;
    snapshot(): TalentSnapshot;
    hydrate(snapshot: TalentSnapshot): void;
}
export declare function createTalentTree<TStat extends string = string>(config: TalentTreeConfig<TStat>): TalentTree<TStat>;