# =============================================================================
# REQUIRED SETTINGS
# =============================================================================

# Target languages to translate to (comma-separated locale codes)
# Most popular WordPress languages based on usage statistics
TARGET_LANGUAGES=es_ES,fr_FR,de_DE,it_IT,pt_BR,ru_RU,nl_NL,pl_PL,ja,zh_CN,ko_KR,sv_SE,da_DK,nb_NO,fi

# Path to the input .pot file containing source strings
POT_FILE_PATH=./languages/document-library-lite.pot

# =============================================================================
# OPENAI SETTINGS
# =============================================================================

# OpenAI API key - Get from https://platform.openai.com/api-keys
API_KEY=your_openai_api_key_here

# OpenAI model to use for translation
# Options: gpt-4o-mini, gpt-4o, gpt-4-turbo, gpt-3.5-turbo
MODEL=gpt-4o-mini

# Creativity level for translations (0.0-2.0)
# Lower = more deterministic, higher = more creative
TEMPERATURE=0.7

# Maximum completion tokens for OpenAI responses (auto-calculated if not set)
# MAX_TOKENS=4096

# Source language code (language of the .pot file)
SOURCE_LANGUAGE=en

# =============================================================================
# DICTIONARY SYSTEM
# =============================================================================

# Directory containing dictionary files for consistent translations
# Dictionary files should be named: dictionary-{language}.json
DICTIONARY_DIR=./config/dictionaries

# Enable/disable the user dictionary system (default: enabled)
# Set to false to disable dictionary usage entirely
ENABLE_DICTIONARY=true

# =============================================================================
# FILE OUTPUT SETTINGS
# =============================================================================

# Directory to save generated .po files
OUTPUT_DIR=./languages/

# Prefix for output .po files (e.g., "app-" creates "app-fr_FR.po")
PO_FILE_PREFIX=document-library-lite-

# Locale format for file naming
# Options: target_lang (default), wp_locale, iso_639_1, iso_639_2
LOCALE_FORMAT=target_lang

# Path to existing .po file to merge with (optional)
# INPUT_PO_PATH=existing-translations.po

# Output format for results: console or json
OUTPUT_FORMAT=console

# File to save JSON output (if using json format)
# OUTPUT_FILE=results.json

# =============================================================================
# PERFORMANCE & LIMITS
# =============================================================================

# Number of strings per translation batch (1-100)
# Larger batches reduce cost but increase risk of API failures
BATCH_SIZE=20

# Maximum number of languages to translate in parallel (1-10)
CONCURRENT_JOBS=2

# Timeout for OpenAI API requests in seconds (10-300)
TIMEOUT=60

# Limit the number of strings translated per language (for testing)
# MAX_STRINGS_PER_JOB=50

# Limit total strings translated across all languages (forces sequential processing)
# MAX_TOTAL_STRINGS=150

# Limit total estimated translation cost in USD
# MAX_COST=5.00

# =============================================================================
# ERROR HANDLING & RETRIES
# =============================================================================

# Number of retry attempts per batch (0-10)
MAX_RETRIES=3

# Delay between retry attempts in milliseconds (500-30000)
RETRY_DELAY=2000

# Abort entire translation run if any batch fails all retry attempts
# ABORT_ON_FAILURE=false

# Skip current language on failure and continue with remaining languages
# SKIP_LANGUAGE_ON_FAILURE=false

# =============================================================================
# BEHAVIOR & DEBUGGING
# =============================================================================

# Re-translate all strings, ignoring existing translations
# FORCE_TRANSLATE=false

# Simulate translation without making actual OpenAI API calls
# DRY_RUN=false

# Verbosity level: 0=errors, 1=normal, 2=verbose, 3=debug
VERBOSE_LEVEL=1

# Save detailed request/response logs to timestamped files in debug/ directory
# SAVE_DEBUG_INFO=false

# =============================================================================
# TESTING OPTIONS
# =============================================================================

# Simulate OpenAI API failure rate (0.0-1.0) to test retry logic
# TEST_RETRY_FAILURE_RATE=0.1

# Allow complete failure of a batch (disables final fallback)
# TEST_ALLOW_COMPLETE_FAILURE=false