/**
 * Configuration options for getSpreadSheetData
 */
export interface SpreadsheetOptions {
    rowLimit?: number;
    /**
     * Seconds to wait between consecutive Google Sheets write API calls
     * (proactive throttle) and as the base back-off delay when retrying calls
     * that fail with a rate-limit response (HTTP 429 / 503).
     * The actual retry delay for each attempt is `waitSeconds * 2^attempt`,
     * capped at 30 seconds.  Defaults to 1.
     */
    waitSeconds?: number;
    dataJsonPath?: string;
    localesOutputPath?: string;
    translationsOutputDir?: string;
    syncLocalChanges?: boolean;
    autoTranslate?: boolean;
    /**
     * Google Spreadsheet ID.
     * Overrides the `GOOGLE_SPREADSHEET_ID` environment variable when provided.
     */
    spreadsheetId?: string;
    /**
     * When `true`, the spreadsheet is read through the Google Visualization
     * API without any service-account credentials.
     *
     * The spreadsheet must be shared as **"Anyone with link can view"** (or
     * broader). Bidirectional sync and auto-translate are unavailable in
     * this mode because they require write access.
     */
    publicSheet?: boolean;
    /**
     * Automatically create a new Google Spreadsheet when no spreadsheetId is
     * available and the caller is in authenticated mode.
     * Default: `true` (creation happens on the first run when no ID is set).
     */
    autoCreate?: boolean;
    /** Title for the auto-created spreadsheet (default: "google-sheet-translations"). */
    spreadsheetTitle?: string;
    /**
     * Source locale used when seeding the auto-created spreadsheet with
     * GOOGLETRANSLATE formulas (default: "en").
     */
    sourceLocale?: string;
    /**
     * Target locales for GOOGLETRANSLATE formulas in the auto-created spreadsheet.
     * Default: ['de', 'fr', 'es', 'it', 'pt', 'ja', 'zh'].
     */
    targetLocales?: string[];
    /**
     * When `true`, existing translations in other language columns are overwritten
     * with GOOGLETRANSLATE formulas when `autoTranslate` is also enabled and keys
     * are pushed.  When `false` (the default), only **empty** cells receive a
     * formula – cells that already contain a translation are left untouched.
     */
    override?: boolean;
    /**
     * When `true`, **all** keys from the local `languageData.json` are pushed to
     * the spreadsheet – including keys that already exist there.  This is useful
     * when the file has been copied from another project and the spreadsheet needs
     * a complete refresh.  The file-timestamp guard (`isDataJsonNewer`) is
     * bypassed.  Whether existing cell values are overwritten depends on the usual
     * `override` + `autoTranslate` flags.  Implies `syncLocalChanges`.
     * Default: `false`.
     */
    cleanPush?: boolean;
}
/**
 * Normalized configuration with all defaults applied
 */
export interface NormalizedConfig {
    rowLimit: number;
    waitSeconds: number;
    dataJsonPath: string;
    localesOutputPath: string;
    translationsOutputDir: string;
    syncLocalChanges: boolean;
    autoTranslate: boolean;
    spreadsheetId: string | undefined;
    publicSheet: boolean;
    autoCreate: boolean;
    spreadsheetTitle: string;
    sourceLocale: string;
    targetLocales: string[];
    override: boolean;
    cleanPush: boolean;
}
/**
 * Normalizes configuration options by applying defaults
 */
export declare function normalizeConfig(options?: SpreadsheetOptions): NormalizedConfig;
//# sourceMappingURL=configurationHandler.d.ts.map