import type { GameSave, GameSaveDocument } from "./gameSave.js";
import type { SaveSlotMeta, SaveSlots } from "./saveSlots.js";
/**
 * Bridging the versioned save document (`createGameSave`) to the save-select index (`createSaveSlots`):
 * the document already carries `savedAt`, `time` and `playtime`, so a menu built on the index can show
 * real saves instead of hand-maintained metadata.
 */
/** How one document becomes a menu slot. */
export interface SaveSlotMetaOptions {
    /** Player-facing name for the slot. Defaults to the slot id. */
    nameOf?: (slot: string, document: GameSaveDocument) => string;
    /**
     * Extra display chips, merged over the playtime chip. The game decides which document fields matter
     * (`chapter`, `location`, `level`, …); the index never interprets meta keys.
     */
    metaOf?: (slot: string, document: GameSaveDocument) => Record<string, string | number>;
}
/** "4h 12m" / "12m" / "< 1m" — the playtime chip every save menu wants. */
export declare function formatSavePlaytime(seconds: number): string;
/**
 * Project one save document onto the index's display metadata: name, last-saved time and a playtime
 * chip (plus any caller `metaOf` fields). Pure, so a menu can build its list from documents a host
 * fetched for it.
 *
 * @capability save-slot-meta project a save document onto save-select display metadata
 */
export declare function saveSlotMeta(slot: string, document: GameSaveDocument, options?: SaveSlotMetaOptions): SaveSlotMeta;
/** The source a slot list is refreshed from — a `GameSave`, or a narrower reader. */
export interface SaveSlotSource {
    slots(): Promise<string[]>;
    peek(slot: string): Promise<GameSaveDocument | null>;
}
/** The result of a refresh: what the menu should show now. */
export interface SaveSlotsRefresh {
    /** Written slots in the order the save store indexes them. */
    saved: string[];
    /** Slot metadata for every written slot. */
    filled: SaveSlotMeta[];
    /** Written slots the index could not hold (id not in it and the index is full). */
    skipped: string[];
}
/**
 * Read every written slot's document and write the display metadata into a `SaveSlots` index — the
 * glue between B5.3's save document and a save-select menu. Slots the index already knows that have
 * no document are cleared, so a deleted save stops showing a stale Continue.
 *
 * @capability save-slot-index refresh a save-select index from the game's save documents
 */
export declare function refreshSaveSlots(source: SaveSlotSource, model: SaveSlots, options?: SaveSlotMetaOptions): Promise<SaveSlotsRefresh>;
/**
 * Adapt a {@link GameSave} as a {@link SaveSlotSource}. Kept separate so a host can supply its own
 * reader (a cloud endpoint listing saves) with the same shape.
 */
export declare function gameSaveSlotSource(save: GameSave): SaveSlotSource;