inav-toolkit 2.3.0__py3-none-any.whl

inav_toolkit/i18n.py

@@ -0,0 +1,192 @@
+"""Internationalization (i18n) for INAV Toolkit.
+
+Lightweight JSON-based translation system. No external dependencies.
+
+Usage:
+    from inav_toolkit.i18n import t, set_locale
+
+    set_locale("pt_BR")       # or "es", "en", etc.
+    print(t("verdict.dialed_in"))
+    print(t("quality.too_short", duration="1.2"))
+
+Translation keys use dotted notation (e.g., "verdict.dialed_in").
+Missing keys fall back to English. Missing English keys return the key itself.
+Technical terms (PID, Hz, Roll/Pitch/Yaw, CLI commands) stay untranslated.
+"""
+
+import json
+import os
+import locale as _locale_mod
+
+_catalogs = {}       # lang -> {key: translated_string}
+_active_locale = "en"
+_locales_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), "locales")
+
+
+def _read_json_resource(filename):
+    """Read a JSON file from the locales directory.
+
+    Tries importlib.resources first (works in all install modes),
+    then falls back to direct filesystem access.
+    Returns parsed dict or None on failure.
+    """
+    # Strategy 1: importlib.resources (Python 3.9+, works for wheels/eggs/editable)
+    try:
+        from importlib.resources import files
+        ref = files("inav_toolkit").joinpath("locales", filename)
+        text = ref.read_text(encoding="utf-8")
+        return json.loads(text)
+    except Exception:
+        pass
+
+    # Strategy 2: direct filesystem path relative to this file
+    path = os.path.join(_locales_dir, filename)
+    if os.path.isfile(path):
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                return json.load(f)
+        except (json.JSONDecodeError, OSError):
+            pass
+
+    return None
+
+
+def _load_catalog(lang):
+    """Load a locale JSON catalog. Returns dict or empty dict on failure."""
+    if lang in _catalogs:
+        return _catalogs[lang]
+
+    data = _read_json_resource(f"{lang}.json")
+    _catalogs[lang] = data if data is not None else {}
+    return _catalogs[lang]
+
+
+def set_locale(lang):
+    """Set the active locale. Loads the catalog if not already loaded.
+
+    Args:
+        lang: Language code, e.g., "en", "pt_BR", "es".
+              Also accepts formats like "pt-BR", "pt_BR.UTF-8".
+    """
+    global _active_locale
+
+    # Normalize: "pt-BR" -> "pt_BR", "pt_BR.UTF-8" -> "pt_BR"
+    lang = lang.replace("-", "_").split(".")[0]
+
+    _load_catalog(lang)
+
+    # Also preload base language (e.g., "pt" from "pt_BR") for fallback
+    base = lang.split("_")[0]
+    if base != lang:
+        _load_catalog(base)
+
+    # Always ensure English is loaded as final fallback
+    _load_catalog("en")
+
+    _active_locale = lang
+
+
+def get_locale():
+    """Return the current active locale code."""
+    return _active_locale
+
+
+def detect_locale():
+    """Auto-detect locale from environment.
+
+    Priority: INAV_LANG env var -> LANG/LC_ALL -> "en"
+    """
+    # Check INAV-specific env var first
+    env_lang = os.environ.get("INAV_LANG", "")
+    if env_lang:
+        return env_lang.replace("-", "_").split(".")[0]
+
+    # System locale
+    try:
+        sys_locale = _locale_mod.getdefaultlocale()[0] or ""
+        if sys_locale:
+            return sys_locale.replace("-", "_").split(".")[0]
+    except (ValueError, AttributeError):
+        pass
+
+    # Fallback to LANG env var directly
+    lang_env = os.environ.get("LANG", os.environ.get("LC_ALL", ""))
+    if lang_env:
+        return lang_env.replace("-", "_").split(".")[0]
+
+    return "en"
+
+
+def available_locales():
+    """List available locale codes (based on JSON files in locales/)."""
+    locales = []
+
+    # Strategy 1: importlib.resources
+    try:
+        from importlib.resources import files
+        locales_ref = files("inav_toolkit").joinpath("locales")
+        for item in locales_ref.iterdir():
+            name = item.name if hasattr(item, 'name') else str(item).rsplit("/", 1)[-1]
+            if name.endswith(".json"):
+                locales.append(name[:-5])
+        if locales:
+            return sorted(locales)
+    except Exception:
+        pass
+
+    # Strategy 2: filesystem
+    if os.path.isdir(_locales_dir):
+        for f in sorted(os.listdir(_locales_dir)):
+            if f.endswith(".json"):
+                locales.append(f[:-5])
+    return locales
+
+
+def t(key, **kwargs):
+    """Translate a key, with optional format substitution.
+
+    Fallback chain: active locale -> base language -> English -> key itself.
+
+    Args:
+        key: Dotted translation key, e.g., "verdict.dialed_in"
+        **kwargs: Format substitution values, e.g., duration="1.2"
+
+    Returns:
+        Translated string with substitutions applied.
+
+    Examples:
+        t("verdict.dialed_in")
+        t("quality.too_short", duration="1.2")
+    """
+    # Try active locale
+    catalog = _catalogs.get(_active_locale, {})
+    text = catalog.get(key)
+
+    # Fallback to base language (e.g., "pt" from "pt_BR")
+    if text is None:
+        base = _active_locale.split("_")[0]
+        if base != _active_locale:
+            catalog = _catalogs.get(base, {})
+            text = catalog.get(key)
+
+    # Fallback to English
+    if text is None:
+        catalog = _catalogs.get("en", {})
+        text = catalog.get(key)
+
+    # Final fallback: return key itself
+    if text is None:
+        text = key
+
+    # Apply format substitution
+    if kwargs:
+        try:
+            text = text.format(**kwargs)
+        except (KeyError, IndexError, ValueError):
+            pass  # Return template as-is if substitution fails
+
+    return text
+
+
+# Auto-initialize English catalog on import
+_load_catalog("en")

inav_toolkit/locales/en.json

@@ -0,0 +1,187 @@
+{
+  "_meta": {
+    "locale": "en",
+    "name": "English",
+    "authors": ["INAV Toolkit contributors"],
+    "note": "Reference catalog. Keys use dotted notation. {placeholders} are substituted at runtime. Technical terms (PID, Hz, Roll/Pitch/Yaw, LPF, CLI commands) stay untranslated in all locales."
+  },
+
+  "banner.analyzer": "INAV Blackbox Analyzer",
+  "banner.nav_analyzer": "INAV Nav Analyzer",
+  "banner.replay": "INAV Flight Replay",
+  "banner.compare": "INAV Flight Comparison",
+  "banner.quality_check": "Log Quality Check",
+  "banner.loading": "Loading: {file}",
+  "banner.craft": "Aircraft",
+  "banner.firmware": "Firmware",
+  "banner.platform": "Platform",
+  "banner.frame": "Frame",
+  "banner.props": "Props",
+  "banner.battery": "Battery",
+  "banner.motors": "Motors",
+  "banner.profile": "Profile",
+  "banner.filters": "Filters",
+
+  "quality.title": "Log Quality",
+  "quality.good": "GOOD",
+  "quality.marginal": "MARGINAL",
+  "quality.unusable": "UNUSABLE",
+  "quality.all_passed": "All quality checks passed",
+  "quality.not_usable": "Log is not usable for analysis. Run with --check-log for details.",
+  "quality.fields_label": "Fields",
+  "quality.active": "active",
+  "quality.idle": "idle",
+  "quality.too_short": "Log is only {duration}s — need at least 5s for analysis",
+  "quality.short": "Log is short ({duration}s) — results may be unreliable, 10s+ recommended",
+  "quality.low_sr_fail": "Sample rate {sr}Hz is too low for spectral analysis (need 100Hz+)",
+  "quality.low_sr_warn": "Sample rate {sr}Hz limits noise analysis to {nyquist}Hz (500Hz+ preferred)",
+  "quality.few_samples": "Only {n} samples — need at least {min} for FFT",
+  "quality.no_gyro": "No gyro data found — cannot perform noise or PID analysis",
+  "quality.no_motors": "No motor data — motor balance analysis unavailable",
+  "quality.no_setpoint": "No setpoint/rcCommand data — PID response analysis unavailable",
+  "quality.no_stick": "No stick movement detected — log may be ground-only (armed but not flying)",
+  "quality.zeros_gyro": "Gyro {axis} is all zeros — sensor may be dead or not logging",
+  "quality.zeros_motor": "Motor {n} output is all zeros — motor disabled or not armed?",
+  "quality.corrupt_fail": "{pct}% of frames corrupt — log may be damaged",
+  "quality.corrupt_warn": "{pct}% of frames had decode errors",
+  "quality.nan_fail": "Gyro {axis} has {pct}% NaN values — data largely missing",
+  "quality.nan_warn": "Gyro {axis} has {pct}% NaN values — some data gaps",
+
+  "verdict.dialed_in": "This tune is dialed in. You're done — go fly!",
+  "verdict.nearly_there": "Almost there — just minor tweaks left.",
+  "verdict.getting_better": "Making progress. Apply the changes below and fly again.",
+  "verdict.needs_work": "Significant tuning needed. Start with the top priorities.",
+  "verdict.rough": "Needs attention. Focus on filters first, then PIDs.",
+  "verdict.need_data_good": "Noise and motors look good, but PID performance could not be measured. Fly with stick inputs (rolls, pitches, yaw sweeps) for tuning data.",
+  "verdict.need_data_bad": "PID performance could not be measured. Fly with deliberate stick inputs for tuning data.",
+  "verdict.idle": "Motors were at idle throughout this log — the quad was armed but not flying. Hover for 15+ seconds with gentle stick inputs for meaningful analysis.",
+
+  "section.scores": "Scores",
+  "section.overall": "Overall",
+  "section.noise": "Noise",
+  "section.pid": "PID Response",
+  "section.motor": "Motor Balance",
+  "section.oscillation": "Oscillation",
+  "section.findings": "Findings",
+  "section.noise_sources": "Noise Sources",
+  "section.recommended": "Recommended Changes",
+  "section.deferred": "Deferred (apply after test flight)",
+  "section.config_changes": "Config Changes",
+  "section.motor_balance": "Motor Balance",
+  "section.comparison": "Score Comparison",
+  "section.verdict": "Verdict",
+  "section.duration": "Duration",
+  "section.actions_remaining": "Actions Remaining",
+  "section.noise_overlay": "Noise Spectrum Overlay",
+  "section.pid_compare": "PID Response Comparison",
+  "section.flight_modes": "Flight Modes",
+  "section.spectrogram": "Noise Spectrogram (Waterfall)",
+
+  "compare.improved": "Tune improved",
+  "compare.degraded": "Tune degraded",
+  "compare.same": "Roughly the same",
+  "compare.improved_by": "Overall improved by {delta} points",
+  "compare.degraded_by": "Overall degraded by {delta} points",
+  "compare.score_same": "Overall score roughly the same",
+  "compare.diff_craft": "Different craft names: \"{a}\" vs \"{b}\"",
+  "compare.diff_craft_note": "Comparison still works but thresholds may differ.",
+  "compare.diff_profile": "Different frame profiles: {a} vs {b}",
+  "compare.diff_profile_note": "Score thresholds differ — deltas may reflect profile, not tuning.",
+  "compare.analyzing_a": "Analyzing flight A...",
+  "compare.analyzing_b": "Analyzing flight B...",
+  "compare.generating": "Generating comparison report...",
+  "compare.change": "Change",
+  "compare.metric": "Metric",
+  "compare.spread": "Spread",
+  "compare.peak_sat": "Peak Sat",
+
+  "replay.synced_zoom": "synced zoom/pan",
+  "replay.flight_mode_bar": "flight mode overlay",
+  "replay.webgl": "WebGL rendering",
+  "replay.panels": "Panels: gyro×3, motors, spectrogram waterfall, throttle",
+  "replay.features": "Features: {features}",
+  "replay.no_mode_data": "No flight mode data (S-frames)",
+  "replay.computing_spectrogram": "Computing spectrogram...",
+  "replay.generating": "Generating Plotly.js replay (WebGL)...",
+
+  "report.generated_by": "Generated by",
+  "report.state_saved": "State: {path} (use --previous on next run)",
+  "report.html_saved": "Report: {path}",
+  "report.markdown_saved": "Markdown: {path} (paste into forum/Discord)",
+  "report.test_with_props_off": "Test changes with props off first",
+
+  "label.setting": "Setting",
+  "label.current": "Current",
+  "label.recommended": "Recommended",
+  "label.reason": "Reason",
+  "label.axis": "Axis",
+  "label.delay": "Delay",
+  "label.overshoot": "Overshoot",
+  "label.avg": "Avg",
+  "label.stddev": "StdDev",
+  "label.saturation": "Saturation",
+  "label.motor": "Motor",
+  "label.frequency": "Frequency",
+  "label.power": "Power",
+  "label.confidence": "confidence",
+  "label.score": "Score",
+  "label.date": "Date",
+
+  "terminal.no_changes": "No changes needed — go fly!",
+  "terminal.need_stick_data": "Need flight data with stick inputs to measure PID response.",
+  "terminal.progression": "Progression",
+  "terminal.improving": "Improving",
+  "terminal.degrading": "Degrading",
+  "terminal.stable": "Stable",
+  "terminal.done": "done",
+  "terminal.analyzing": "Analyzing...",
+  "terminal.parsing_headers": "Parsing {n} header parameters...",
+  "terminal.decoding": "Decoding binary log (native)...",
+  "terminal.parsing_csv": "Parsing CSV...",
+  "terminal.nav_data": "Nav data",
+  "terminal.no_nav_fields": "Warning: No navigation fields found in this log",
+  "terminal.no_pid_values": "Warning: No PID values in headers — use .bbl for exact recommendations",
+
+  "severity.critical": "CRITICAL",
+  "severity.important": "IMPORTANT",
+  "severity.moderate": "MODERATE",
+  "severity.minor": "MINOR",
+  "severity.info": "INFO",
+
+  "finding.osc_p_too_high": "Hover oscillation — reduce P from {current} to {new}",
+  "finding.osc_pd_interaction": "Oscillation: P/D interaction — reduce both P and D",
+  "finding.osc_d_noise": "D-term noise amplification causing oscillation",
+  "finding.osc_filter_gap": "High-frequency noise leaking through filters",
+  "finding.osc_unknown": "Hover oscillation detected — reduce P by 25%",
+  "finding.phase_lag_high": "Total filter phase lag: {degrees}° ({ms}ms) at {freq}Hz",
+  "finding.enable_dyn_notch": "Noise peaks detected — dynamic notch will track and attenuate these",
+  "finding.enable_rpm": "RPM filter tracks motor noise precisely — requires ESC telemetry or bidirectional DSHOT",
+  "finding.gyro_lpf_adjust": "Gyro lowpass filter: {direction} from {current}Hz to {new}Hz",
+  "finding.dterm_lpf_adjust": "D-term lowpass filter: Reduce from {current}Hz to {new}Hz",
+
+  "sanity.title": "INAV Pre-Flight Sanity Check",
+  "sanity.go": "GO FOR FLIGHT",
+  "sanity.no_go": "NO-GO — Fix issues before flying",
+  "sanity.caution": "CAUTION — Review warnings before flying",
+  "sanity.category.mixing": "Motor/Servo Mixing",
+  "sanity.category.modes": "Flight Modes",
+  "sanity.category.sensors": "Sensor Configuration",
+  "sanity.category.failsafe": "Failsafe",
+  "sanity.category.battery": "Battery Monitoring",
+  "sanity.category.pid_range": "PID Range Check",
+  "sanity.category.filters": "Filter Configuration",
+  "sanity.category.rates": "Rates & Limits",
+  "sanity.category.gps_nav": "GPS & Navigation",
+  "sanity.category.motor_protocol": "Motor Protocol",
+  "sanity.category.osd": "OSD Configuration",
+  "sanity.category.arming": "Arming Safety",
+  "sanity.category.servo": "Servo Configuration",
+  "sanity.category.vtol": "VTOL Configuration",
+  "sanity.category.board": "Board & Port Setup",
+  "sanity.category.misc": "Miscellaneous",
+
+  "error.file_not_found": "File not found: {path}",
+  "error.not_inav": "Not an INAV FC (got: {variant})",
+  "error.no_logfile": "No logfile specified. Use: inav-analyze flight.bbl",
+  "error.compare_not_found": "Comparison file not found: {path}"
+}

inav_toolkit/locales/es.json

@@ -0,0 +1,187 @@
+{
+  "_meta": {
+    "locale": "es",
+    "name": "Español",
+    "authors": ["INAV Toolkit contributors"],
+    "note": "Términos técnicos (PID, Hz, Roll/Pitch/Yaw, LPF, comandos CLI) permanecen en inglés."
+  },
+
+  "banner.analyzer": "INAV Analizador de Blackbox",
+  "banner.nav_analyzer": "INAV Analizador de Navegación",
+  "banner.replay": "INAV Reproducción de Vuelo",
+  "banner.compare": "INAV Comparación de Vuelos",
+  "banner.quality_check": "Verificación de Calidad del Log",
+  "banner.loading": "Cargando: {file}",
+  "banner.craft": "Aeronave",
+  "banner.firmware": "Firmware",
+  "banner.platform": "Plataforma",
+  "banner.frame": "Frame",
+  "banner.props": "Hélices",
+  "banner.battery": "Batería",
+  "banner.motors": "Motores",
+  "banner.profile": "Perfil",
+  "banner.filters": "Filtros",
+
+  "quality.title": "Calidad del Log",
+  "quality.good": "BUENO",
+  "quality.marginal": "MARGINAL",
+  "quality.unusable": "INUTILIZABLE",
+  "quality.all_passed": "Todas las verificaciones de calidad aprobadas",
+  "quality.not_usable": "El log no es utilizable para análisis. Ejecute con --check-log para detalles.",
+  "quality.fields_label": "Campos",
+  "quality.active": "activo",
+  "quality.idle": "inactivo",
+  "quality.too_short": "El log tiene solo {duration}s — se necesitan al menos 5s para análisis",
+  "quality.short": "El log es corto ({duration}s) — los resultados pueden ser imprecisos, se recomiendan 10s+",
+  "quality.low_sr_fail": "Tasa de muestreo {sr}Hz es demasiado baja para análisis espectral (se necesitan 100Hz+)",
+  "quality.low_sr_warn": "Tasa de muestreo {sr}Hz limita el análisis de ruido a {nyquist}Hz (preferible 500Hz+)",
+  "quality.few_samples": "Solo {n} muestras — se necesitan al menos {min} para FFT",
+  "quality.no_gyro": "No se encontraron datos del giroscopio — no se puede analizar ruido ni PID",
+  "quality.no_motors": "Sin datos de motor — análisis de balance no disponible",
+  "quality.no_setpoint": "Sin datos de setpoint/rcCommand — análisis de respuesta PID no disponible",
+  "quality.no_stick": "No se detectó movimiento de stick — el log puede ser solo de tierra (armado pero sin volar)",
+  "quality.zeros_gyro": "Gyro {axis} está todo en ceros — el sensor puede estar muerto o sin registro",
+  "quality.zeros_motor": "Motor {n} está todo en ceros — ¿motor desactivado o no armado?",
+  "quality.corrupt_fail": "{pct}% de los frames corruptos — el log puede estar dañado",
+  "quality.corrupt_warn": "{pct}% de los frames tuvieron errores de decodificación",
+  "quality.nan_fail": "Gyro {axis} tiene {pct}% valores NaN — datos en gran parte ausentes",
+  "quality.nan_warn": "Gyro {axis} tiene {pct}% valores NaN — algunas lagunas en los datos",
+
+  "verdict.dialed_in": "El tune está perfecto. ¡Listo para volar!",
+  "verdict.nearly_there": "Casi listo — solo quedan ajustes menores.",
+  "verdict.getting_better": "Progresando. Aplique los cambios a continuación y vuele de nuevo.",
+  "verdict.needs_work": "Se necesita ajuste significativo. Comience con las prioridades.",
+  "verdict.rough": "Necesita atención. Enfóquese en los filtros primero, luego en los PIDs.",
+  "verdict.need_data_good": "Ruido y motores se ven bien, pero no se pudo medir el rendimiento PID. Vuele con movimientos de stick (rolls, pitches, barridos de yaw) para datos de tune.",
+  "verdict.need_data_bad": "No se pudo medir el rendimiento PID. Vuele con movimientos deliberados de stick para datos de tune.",
+  "verdict.idle": "Los motores estuvieron en idle durante todo el log — el quad estaba armado pero no voló. Haga hover por 15+ segundos con movimientos suaves de stick para análisis significativo.",
+
+  "section.scores": "Puntuaciones",
+  "section.overall": "General",
+  "section.noise": "Ruido",
+  "section.pid": "Respuesta PID",
+  "section.motor": "Balance de Motores",
+  "section.oscillation": "Oscilación",
+  "section.findings": "Diagnóstico",
+  "section.noise_sources": "Fuentes de Ruido",
+  "section.recommended": "Cambios Recomendados",
+  "section.deferred": "Diferido (aplicar después del vuelo de prueba)",
+  "section.config_changes": "Cambios de Configuración",
+  "section.motor_balance": "Balance de Motores",
+  "section.comparison": "Comparación de Puntuaciones",
+  "section.verdict": "Veredicto",
+  "section.duration": "Duración",
+  "section.actions_remaining": "Acciones Restantes",
+  "section.noise_overlay": "Superposición de Espectro de Ruido",
+  "section.pid_compare": "Comparación de Respuesta PID",
+  "section.flight_modes": "Modos de Vuelo",
+  "section.spectrogram": "Espectrograma de Ruido (Cascada)",
+
+  "compare.improved": "El tune mejoró",
+  "compare.degraded": "El tune empeoró",
+  "compare.same": "Prácticamente igual",
+  "compare.improved_by": "General mejoró {delta} puntos",
+  "compare.degraded_by": "General empeoró {delta} puntos",
+  "compare.score_same": "Puntuación general prácticamente igual",
+  "compare.diff_craft": "Nombres de aeronaves diferentes: \"{a}\" vs \"{b}\"",
+  "compare.diff_craft_note": "La comparación funciona pero los umbrales pueden diferir.",
+  "compare.diff_profile": "Perfiles de frame diferentes: {a} vs {b}",
+  "compare.diff_profile_note": "Los umbrales de puntuación difieren — los deltas pueden reflejar el perfil, no el tune.",
+  "compare.analyzing_a": "Analizando vuelo A...",
+  "compare.analyzing_b": "Analizando vuelo B...",
+  "compare.generating": "Generando informe de comparación...",
+  "compare.change": "Cambio",
+  "compare.metric": "Métrica",
+  "compare.spread": "Dispersión",
+  "compare.peak_sat": "Saturación Pico",
+
+  "replay.synced_zoom": "zoom/pan sincronizado",
+  "replay.flight_mode_bar": "barra de modos de vuelo",
+  "replay.webgl": "renderizado WebGL",
+  "replay.panels": "Paneles: gyro×3, motores, espectrograma cascada, throttle",
+  "replay.features": "Características: {features}",
+  "replay.no_mode_data": "Sin datos de modo de vuelo (S-frames)",
+  "replay.computing_spectrogram": "Calculando espectrograma...",
+  "replay.generating": "Generando replay Plotly.js (WebGL)...",
+
+  "report.generated_by": "Generado por",
+  "report.state_saved": "Estado: {path} (use --previous en la próxima ejecución)",
+  "report.html_saved": "Informe: {path}",
+  "report.markdown_saved": "Markdown: {path} (pegue en foro/Discord)",
+  "report.test_with_props_off": "Pruebe los cambios con las hélices quitadas primero",
+
+  "label.setting": "Configuración",
+  "label.current": "Actual",
+  "label.recommended": "Recomendado",
+  "label.reason": "Razón",
+  "label.axis": "Eje",
+  "label.delay": "Retardo",
+  "label.overshoot": "Overshoot",
+  "label.avg": "Prom",
+  "label.stddev": "DesvEst",
+  "label.saturation": "Saturación",
+  "label.motor": "Motor",
+  "label.frequency": "Frecuencia",
+  "label.power": "Potencia",
+  "label.confidence": "confianza",
+  "label.score": "Puntuación",
+  "label.date": "Fecha",
+
+  "terminal.no_changes": "¡No se necesitan cambios — a volar!",
+  "terminal.need_stick_data": "Se necesitan datos de vuelo con movimientos de stick para medir respuesta PID.",
+  "terminal.progression": "Progresión",
+  "terminal.improving": "Mejorando",
+  "terminal.degrading": "Empeorando",
+  "terminal.stable": "Estable",
+  "terminal.done": "listo",
+  "terminal.analyzing": "Analizando...",
+  "terminal.parsing_headers": "Procesando {n} parámetros del encabezado...",
+  "terminal.decoding": "Decodificando log binario (nativo)...",
+  "terminal.parsing_csv": "Procesando CSV...",
+  "terminal.nav_data": "Datos de navegación",
+  "terminal.no_nav_fields": "Aviso: No se encontraron campos de navegación en este log",
+  "terminal.no_pid_values": "Aviso: Sin valores PID en los encabezados — use .bbl para recomendaciones exactas",
+
+  "severity.critical": "CRÍTICO",
+  "severity.important": "IMPORTANTE",
+  "severity.moderate": "MODERADO",
+  "severity.minor": "MENOR",
+  "severity.info": "INFO",
+
+  "finding.osc_p_too_high": "Oscilación en hover — reduzca P de {current} a {new}",
+  "finding.osc_pd_interaction": "Oscilación: interacción P/D — reduzca ambos P y D",
+  "finding.osc_d_noise": "Amplificación de ruido en el D-term causando oscilación",
+  "finding.osc_filter_gap": "Ruido de alta frecuencia filtrándose a través de los filtros",
+  "finding.osc_unknown": "Oscilación en hover detectada — reduzca P en 25%",
+  "finding.phase_lag_high": "Retardo total de fase de los filtros: {degrees}° ({ms}ms) a {freq}Hz",
+  "finding.enable_dyn_notch": "Picos de ruido detectados — el notch dinámico rastreará y atenuará estos",
+  "finding.enable_rpm": "El filtro RPM rastrea el ruido de los motores con precisión — requiere telemetría ESC o DSHOT bidireccional",
+  "finding.gyro_lpf_adjust": "Filtro lowpass del giroscopio: {direction} de {current}Hz a {new}Hz",
+  "finding.dterm_lpf_adjust": "Filtro lowpass del D-term: Reducir de {current}Hz a {new}Hz",
+
+  "sanity.title": "INAV Verificación Pre-Vuelo",
+  "sanity.go": "APROBADO PARA VUELO",
+  "sanity.no_go": "NO APROBADO — Corrija los problemas antes de volar",
+  "sanity.caution": "PRECAUCIÓN — Revise los avisos antes de volar",
+  "sanity.category.mixing": "Mezcla Motor/Servo",
+  "sanity.category.modes": "Modos de Vuelo",
+  "sanity.category.sensors": "Configuración de Sensores",
+  "sanity.category.failsafe": "Failsafe",
+  "sanity.category.battery": "Monitoreo de Batería",
+  "sanity.category.pid_range": "Verificación de Rango PID",
+  "sanity.category.filters": "Configuración de Filtros",
+  "sanity.category.rates": "Rates y Límites",
+  "sanity.category.gps_nav": "GPS y Navegación",
+  "sanity.category.motor_protocol": "Protocolo de Motor",
+  "sanity.category.osd": "Configuración de OSD",
+  "sanity.category.arming": "Seguridad de Armado",
+  "sanity.category.servo": "Configuración de Servo",
+  "sanity.category.vtol": "Configuración VTOL",
+  "sanity.category.board": "Configuración de Placa y Puertos",
+  "sanity.category.misc": "Varios",
+
+  "error.file_not_found": "Archivo no encontrado: {path}",
+  "error.not_inav": "No es un FC INAV (recibido: {variant})",
+  "error.no_logfile": "No se especificó archivo de log. Use: inav-analyze vuelo.bbl",
+  "error.compare_not_found": "Archivo de comparación no encontrado: {path}"
+}