<?php

if (!defined('ABSPATH')) {
    exit;
}

// a11ybridge-legal-hints.php (auto-generated proposal, EN)

/*

Für spätere i18n via JSON/PO bist du jetzt gut aufgestellt:

Die Array-Keys (advanced_show_accessibility_badge, voice_command_scroll_down, …) sind deine stabilen message IDs.

Die Werte unter badge, tooltip, privacy sind aktuell dein Default-EN-Text und können später durch:

__('a11ybridge_legal_hint_advanced_show_accessibility_badge_badge', 'a11ybridge')

oder ein JSON-Lookup (translations[locale][legalHints][key][field])
ersetzt werden, ohne das Schema dieses Files zu ändern.

Sprich: du kannst dieses File später 1:1 als “Datenquelle” für Keys verwenden und den Text extern ziehen, ohne dein ganzes Legal-Hints-Handling umzubauen.

*/
return [
    // === ADVANCED ===
    'advanced_show_accessibility_badge' => [
        'badge'      => 'Transparency / UWG § 5 (DE)',
        'tooltip'    => 'Indicates the availability of accessibility options. Not a certificate; avoid statements such as “WCAG-compliant” / “certified”. Optional link to the accessibility statement.',
        'privacy'    => 'TTDSG (DE) § 25 (if badge status is stored in the browser)',
    ],

    'advanced_analytics' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Accessibility metrics for prioritisation and impact monitoring; GDPR must be observed.',
        
        'privacy' => 'GDPR Art. 6; TTDSG (DE) § 25',
    ],

    'advanced_badge_position' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Advanced functions for compliance and quality assurance.',
        
    ],

    'advanced_badge_style' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Advanced functions for compliance and quality assurance.',
        
    ],

    'advanced_create_report' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Reporting / evidence functions for audits and documentation.',
        
    ],

    'advanced_debug_mode' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Debug mode for quality assurance – development tool.',
        
    ],

    'advanced_email_report' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Reporting / evidence functions for audits and documentation.',
        
    ],

    'advanced_performance_optimization' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Optimisation of the performance of accessible components.',
        
    ],

    'advanced_scan_depth' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Extended accessibility scans/checks for evidence and QA.',
        
    ],

    'advanced_scan_frequency' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Extended accessibility scans/checks for evidence and QA.',
        
    ],

    'advanced_simple_issues' => [
        'badge'   => 'Governance / WCAG',
        'tooltip' => 'Advanced functions for compliance and quality assurance.',
        
    ],

    // Full scan
    'scanner_full_scan' => [
        'badge'      => 'EN 301 549 / WCAG (advisory report)',
        'tooltip'    => 'Full scan for common WCAG topics. Result is an advisory report – not a certification. Scope and accuracy may vary depending on theme/plugins.',
        'privacy'    => 'GDPR Art. 6/28 (for server-side scan); TTDSG (DE) § 25 (for LocalStorage)',
        
    ],

    // Quick scan
    'scanner_quick_scan' => [
        'badge'      => 'Quick check (heuristics)',
        'tooltip'    => 'Limited quick check (e.g. skip link, visible focus, alt count). No full coverage, no certificate.',
        'privacy'    => 'GDPR Art. 6/28 (for server-side scan); TTDSG (DE) § 25 (for LocalStorage)',
    ],

    // Download last report
    'scanner_download_last_report' => [
        'badge'      => 'Evidence / compliance',
        'tooltip'    => 'Export the last advisory report as PDF/MD/CSV. Not a proof of conformity; for documentation and follow-up.',
        'privacy'    => 'GDPR Art. 6/28 (report may contain personal data or URLs)',
        
    ],

    // === AI_FEATURE ===
    'ai_feature_automatic_alt_text_on_upload' => [
        'badge'   => 'WCAG 2.1 A: 1.1.2',
        'tooltip' => 'Alternative text for non-text content (supported by AI).',
        // 
    ],

    'ai_feature_automatic_daily_alt_text' => [
        'badge'   => 'WCAG 2.1 A: 1.1.2',
        'tooltip' => 'Alternative text for non-text content (supported by AI).',
        // 
    ],

    'ai_feature_description_level' => [
        'badge'   => 'WCAG 1.1.2 (quality)',
        'tooltip' => 'Level of detail of alternative texts – content quality.',
        // 
    ],

    'ai_feature_language' => [
        'badge'   => 'WCAG 2.1 A: 3.1.1 / 3.1.2',
        'tooltip' => 'Correctly indicate primary language and language changes.',
        // 
    ],

    'ai_feature_simplification_check_missing' => [
        'badge'   => 'WCAG AAA: 3.1.5 (supporting)',
        'tooltip' => 'Easy-to-understand language; supporting function (beyond AA obligations).',
        // 
    ],

    'ai_feature_simplification_default' => [
        'badge'   => 'WCAG AAA: 3.1.5 (supporting)',
        'tooltip' => 'Easy-to-understand language; supporting function (beyond AA obligations).',
        // 
    ],

    'ai_feature_simplification_generate_all' => [
        'badge'   => 'WCAG AAA: 3.1.5 (supporting)',
        'tooltip' => 'Easy-to-understand language; supporting function (beyond AA obligations).',
        // 
    ],

    'ai_feature_simplification_language' => [
        'badge'   => 'WCAG AAA: 3.1.5 (supporting)',
        'tooltip' => 'Easy-to-understand language; supporting function (beyond AA obligations).',
        // 
    ],

    'ai_feature_text_simplify' => [
        'badge'   => 'WCAG AAA: 3.1.5 (supporting)',
        'tooltip' => 'Easy-to-understand language; supporting function (beyond AA obligations).',
        // 
    ],

    'ai_feature_simplification_consent_required' => [
        'badge'   => 'Privacy / Transparency',
        'tooltip' => 'Requires explicit user consent before selected text is sent to the AI service.',
    ],

    'ai_feature_simplification_reconsent_interval' => [
        'badge'   => 'Privacy / UX',
        'tooltip' => 'How often consent must be renewed. 0 means remembered in the visitor browser.',
    ],


    // === BASICS ===
    'basics_hide_toolbar_on_scroll' => [
        'badge'   => 'WCAG 2.1 / 2.2: operability',
        'tooltip' => 'Improves operability and orientation (control bar / toolbar).',
    ],

    'basics_mobile_friendly' => [
        'badge'   => 'WCAG 2.2: 2.5.5 / 2.5.7',
        'tooltip' => 'Improves touch targets and mobile operation (target size).',
    ],

    'basics_show_toolbar' => [
        'badge'   => 'WCAG 2.1: 2.4.8',
        'tooltip' => 'Visible controls support orientation.',
    ],

    'basics_toolbar_position' => [
        'badge'   => 'WCAG 2.1 / 2.2: operability',
        'tooltip' => 'Improves operability and orientation (control bar / toolbar).',
    ],

    'basics_touch_friendly' => [
        'badge'   => 'WCAG 2.2: 2.5.5 / 2.5.7',
        'tooltip' => 'Improves touch targets and mobile operation (target size).',
    ],

    // === OTHER ===
    'dsgvo_compliance' => [
        'badge'   => 'Info',
        'tooltip' => 'General note without specific legal reference.',
    ],

    'sign_language_audio' => [
        'badge'   => 'Info',
        'tooltip' => 'General note without specific legal reference.',
    ],

    'sign_language_video' => [
        'badge'   => 'Info',
        'tooltip' => 'General note without specific legal reference.',
    ],


    // === SPECIALS ===
    'accessibility_badge' => [
        'badge'   => 'Transparency / info',
        'tooltip' => 'Accessibility badge shows active accessibility options – not a mandatory criterion.',
    ],

    'accessibility_scanner' => [
        'badge'   => 'WCAG checks',
        'tooltip' => 'Basic check of common accessibility issues; not a replacement for a full audit.',
    ],

    'alt_text_ai' => [
        'badge'   => 'WCAG 2.1 A: 1.1.2',
        'tooltip' => 'Supports text alternatives for non-text content. Editorial review remains necessary.',
        'privacy'  => 'GDPR Art. 6/28 (for server-based AI)',
        
    ],

    'color_anomaly' => [
        'badge'   => 'WCAG 2.1 A: 1.4.1 (indirect)',
        'tooltip' => 'Improves distinguishability; supplements “use of color”. Not a mandatory criterion.',
    ],

    'contrast_toggle' => [
        'badge'   => 'WCAG 2.1 AA: 1.4.3 / 1.4.11',
        'tooltip' => 'Supports minimum contrast for text and UI elements (AA). Reference: EN 301 549.',
        
    ],

    'focus_mode' => [
        'badge'   => 'Supporting (A/AA)',
        'tooltip' => 'Reduces visual distractions; supports operability and readability.',
    ],

    'keyboard_focus' => [
        'badge'   => 'WCAG 2.1 A/AA: 2.1.1, 2.1.2, 2.4.3, 2.4.7, 2.4.11',
        'tooltip' => 'Keyboard operation and visible, non-obscured focus.',
        
    ],

    'text_simplify_ai' => [
        'badge'   => 'WCAG AAA: 3.1.5 (beyond AA)',
        'tooltip' => 'Simplifies complex texts; professional review is recommended. GDPR must be observed for server-based AI.',
    ],

    'text_size' => [
        'badge'   => 'WCAG 2.1 AA: 1.4.4',
        'tooltip' => 'Helps fulfil “Resize text” (200% without loss of functionality). Reference: EN 301 549.',
    ],

    'tts_browser' => [
        'badge'   => 'Assistive',
        'tooltip' => 'Reads selected text aloud; not an AA requirement.',
    ],

    'video_descriptions' => [
        'badge'   => 'WCAG 2.1 AA: 1.2.5',
        'tooltip' => 'Audio description for pre-recorded videos.',
        
    ],

    /*
    'voice_commands' => [
        'badge'   => 'Assistive + GDPR (Art. 6(1)(a), 13) and possibly TTDSG § 25',
        'tooltip' => 'Optional voice control. Opt-in and privacy notice required.',
    ],
    */

    // === USER_MANAGEMENT ===
    'user_management_delete_data' => [
        'badge'   => 'GDPR data subject rights',
        'tooltip' => 'Right to erasure.',
        'privacy' => 'GDPR Art. 17',
    ],

    'user_management_export_data' => [
        'badge'   => 'GDPR data subject rights',
        'tooltip' => 'Right to data portability.',
        'privacy' => 'GDPR Art. 20',
    ],

    'user_management_reset_data' => [
        'badge'   => 'GDPR data subject rights',
        'tooltip' => 'Reset of user data – be careful with deletion obligations.',
        'privacy' => 'GDPR Art. 5',
    ],

    // === USER_NEW_ACCOUNTS_DEFAULTS ===
    'user_new_accounts_defaults_color' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    'user_new_accounts_defaults_contrast' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    'user_new_accounts_defaults_font_size' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    'user_new_accounts_defaults_language' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    'user_new_accounts_defaults_toolbar_position' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    'user_new_accounts_defaults_voice_speed' => [
        'badge'   => 'Usability',
        'tooltip' => 'Accessibility defaults (user-friendly, not mandatory).',
    ],

    // === USER_PRIVACY ===
    'user_privacy_anonymous_data_usage' => [
        'badge'   => 'GDPR',
        'tooltip' => 'Data minimisation / anonymisation where possible.',
        'privacy' => 'GDPR Art. 5(1)(c),(e), 25',
    ],

    'user_privacy_cookie_consent' => [
        'badge'   => 'GDPR',
        'tooltip' => 'Consent for storage / tracking on end devices.',
        'privacy' => 'TTDSG (DE) § 25; GDPR Art. 6(1)(a)',
    ],

    'user_privacy_data_encryption' => [
        'badge'   => 'GDPR',
        'tooltip' => 'State of the art: encryption of personal data.',
        'privacy' => 'GDPR Art. 32',
    ],

    'user_privacy_data_saving_duration' => [
        'badge'   => 'GDPR',
        'tooltip' => 'Storage limitation – do not retain data longer than necessary.',
        'privacy' => 'GDPR Art. 5(1)(e)',
    ],

    'user_privacy_dsgvo_conformity' => [
        'badge'   => 'GDPR',
        'tooltip' => 'General GDPR compliance; privacy by design / by default.',
        'privacy' => 'GDPR Art. 5, 25',
    ],

    // === USER_PROFILE ===
    'user_profile_activate_account' => [
        'badge'   => 'Usability / GDPR',
        'tooltip' => 'Activation with double opt-in is recommended.',
        'privacy' => 'GDPR Art. 7',
    ],

    'user_profile_automatic_saving' => [
        'badge'   => 'Usability / GDPR',
        'tooltip' => 'Profile / account options; data minimisation and transparency must be observed.',
    ],

    'user_profile_device_sync' => [
        'badge'   => 'Usability / GDPR',
        'tooltip' => 'Profile / account options; data minimisation and transparency must be observed.',
    ],

    'user_profile_guest_settings' => [
        'badge'   => 'Usability / GDPR',
        'tooltip' => 'Profile / account options; data minimisation and transparency must be observed.',
    ],

    'user_profile_sharing_settings' => [
        'badge'   => 'Usability / GDPR',
        'tooltip' => 'Profile / account options; data minimisation and transparency must be observed.',
    ],

    // === USER_STORAGE ===
    'user_storage_cleanup_inactive' => [
        'badge'   => 'GDPR: storage limitation',
        'tooltip' => 'Automatic deletion of inactive data – storage limitation.',
        'privacy' => 'GDPR Art. 5(1)(e)',
    ],

    'user_storage_cookie_fallback' => [
        'badge'   => 'TTDSG / GDPR',
        'tooltip' => 'Cookie fallback only with valid legal basis (consent / § 25 TTDSG).',
        'privacy' => 'TTDSG (DE) § 25; GDPR Art. 6',
    ],

    'user_storage_create_backup' => [
        'badge'   => 'GDPR: storage limitation',
        'tooltip' => 'Operate backups in a GDPR-compliant way (purpose limitation, access control).',
    ],

    'user_storage_saving_location' => [
        'badge'   => 'GDPR: storage limitation',
        'tooltip' => 'Consider storage location (EU/EEA) and data processing agreements.',
        'privacy' => 'GDPR Chapter V (third countries)',
    ],

    'user_storage_session_length' => [
        'badge'   => 'GDPR: storage limitation',
        'tooltip' => 'Session duration / session storage – observe data minimisation.',
    ],

    // === UNUSED (no matching legal_id in settings) ===
    'evidence_pack' => [
        'badge'   => 'Evidence / compliance',
        'tooltip' => 'Export of active accessibility features + WCAG references for audits.',
    ],

    'policy_profiles' => [
        'badge'   => 'Governance',
        'tooltip' => 'Quick selection of preconfigured accessibility defaults (EN 301 549 / WCAG practice).',
    ],

    'role_locks' => [
        'badge'   => 'GDPR Art. 32 / 25 (least privilege)',
        'tooltip' => 'Role-based visibility / editability of options.',
    ],

    'staging_license' => [
        'badge'   => 'Dev / governance',
        'tooltip' => 'Separate license for staging / production.',
    ],

    'whitelabel' => [
        'badge'   => 'Corporate / governance',
        'tooltip' => 'Meets brand guidelines (without vendor branding).',
    ],

    // ==== Voice Commands (tab) ====
    'voice_commands' => [
        'badge'   => 'WCAG 2.1',
        'tooltip' => 'Voice control supports, among other things, operability (2.1.1 keyboard), pause / stop / hide (2.2.2) and instructions (3.3.2). Not mandatory, but a strongly recommended additional input method.',
        // 
        'privacy' => 'GDPR: microphone only with consent; no storage without approval.',
    ],

    'voice_command_open_toolbar' => [
        'badge'   => 'WCAG 2.4.7',
        'tooltip' => 'Opens the accessibility toolbar via voice. Supports visible controls and focus guidance.',
    ],

    'voice_command_close_toolbar' => [
        'badge'   => 'WCAG 2.4.7',
        'tooltip' => 'Closes the toolbar via voice – helps users with motor impairments.',
    ],

    'voice_command_open_settings' => [
        'badge'   => 'WCAG 3.3.2',
        'tooltip' => 'Opens settings with verbal instructions; supports clear user guidance.',
    ],

    'voice_command_scroll_up' => [
        'badge'   => 'WCAG 2.2.2',
        'tooltip' => 'Scrolls up via voice command; facilitates control without mouse/keyboard.',
    ],

    'voice_command_scroll_down' => [
        'badge'   => 'WCAG 2.2.2',
        'tooltip' => 'Scrolls down via voice command; supports uninterrupted use.',
    ],

    'voice_command_scroll_top' => [
        'badge'   => 'WCAG 2.2.2',
        'tooltip' => 'Jump to the top of the page; useful for quick navigation.',
    ],

    'voice_command_scroll_bottom' => [
        'badge'   => 'WCAG 2.2.2',
        'tooltip' => 'Jump to the bottom of the page; speeds up navigation on long pages.',
    ],

    'voice_command_increase_font' => [
        'badge'   => 'WCAG 1.4.4',
        'tooltip' => 'Increase text size via voice (without breaking layout).',
    ],

    'voice_command_decrease_font' => [
        'badge'   => 'WCAG 1.4.4',
        'tooltip' => 'Decrease text size via voice; can be reset at any time.',
    ],

    'voice_command_reset_font' => [
        'badge'   => 'WCAG 1.4.4',
        'tooltip' => 'Reset text size to the default value.',
    ],

    'voice_command_contrast_toggle' => [
        'badge'   => 'WCAG 1.4.3',
        'tooltip' => 'Toggle contrast mode (light/dark); improves readability.',
    ],

    'voice_command_highlight_links_toggle' => [
        'badge'   => 'WCAG 1.4.11',
        'tooltip' => 'Highlight links; makes interactive elements easier to recognise.',
    ],

    'voice_command_focus_mode_toggle' => [
        'badge'   => 'WCAG 2.4.7',
        'tooltip' => 'Enable distraction-free reading (focus mode) via voice command.',
    ],

    'voice_command_next_section' => [
        'badge'   => 'WCAG 2.4.1',
        'tooltip' => 'Jump to the next content section (semantic navigation).',
    ],

    'voice_command_prev_section' => [
        'badge'   => 'WCAG 2.4.1',
        'tooltip' => 'Jump to the previous section.',
    ],

    'voice_command_search' => [
        'badge'   => 'WCAG 3.3.2',
        'tooltip' => 'Start page or site search via voice; clear instructions.',
    ],

    'voice_command_start_read' => [
        'badge'   => 'Assistive',
        'tooltip' => 'Starts text-to-speech reading via voice; helpful for cognitive or visual barriers.',
        'privacy'  => 'Local / server TTS depending on settings; no storage without approval.',
    ],

    'voice_command_pause_read' => [
        'badge'   => 'Assistive',
        'tooltip' => 'Pause reading.',
    ],

    'voice_command_stop_read' => [
        'badge'   => 'Assistive',
        'tooltip' => 'Stop reading.',
    ],

    'voice_command_zoom_in' => [
        'badge'   => 'WCAG 1.4.4',
        'tooltip' => 'Zoom in (keep layout intact); alternative input method.',
    ],

    'voice_command_zoom_out' => [
        'badge'   => 'WCAG 1.4.4',
        'tooltip' => 'Zoom out; can be reset at any time.',
    ],

    'voice_command_color_filters_toggle' => [
        'badge'   => 'WCAG 1.4.1',
        'tooltip' => 'Toggle colour filters (support for colour vision deficiencies).',
    ],

    'voice_command_dyslexic_font_toggle' => [
        'badge'   => 'Best practice',
        'tooltip' => 'Toggle dyslexia-friendly font (recommended, not mandatory).',
    ],

    'voice_command_custom' => [
        'badge'   => 'Best practice',
        'tooltip' => 'Define custom voice commands (governance / auditability).',
        
    ],

    // ==== Voice (settings, no voice_command_*) ====
    'voice_language' => [
        'badge'      => 'WCAG 3.1.2',
        'tooltip'    => 'Set recognition language – improves accuracy and intelligibility; ideally aligned with content language.',
    ],

    'voice_fallback_language' => [
        'badge'      => 'WCAG 3.1.1',
        'tooltip'    => 'Define a fallback language when the main language is unclear – safeguards understandable interaction.',
    ],

    'voice_ai_supported_languages' => [
        'badge'      => 'Best practice',
        'tooltip'    => 'Transparent list of supported languages for speech recognition and TTS.',
    ],

    'voice_activation_word' => [
        'badge'      => 'Best practice',
        'tooltip'    => 'Activation via wake word; low-barrier use without mouse/keyboard. Clearly communicate if passive listening is active.',
        // 
        'privacy'    => 'GDPR: continuous listening only with consent (Art. 6(1)(a)); transparency (Art. 13).',
    ],

    'voice_sensitivity' => [
        'badge'      => 'Usability',
        'tooltip'    => 'Control sensitivity / threshold (e.g. VAD) – reduces false triggers and improves recognition.',
    ],

    'voice_continuous' => [
        'badge'      => 'Best practice',
        'tooltip'    => 'Continuous recognition for follow-up commands without re-activation.',
        // 
        'privacy'    => 'GDPR: allow continuous recording only with consent; data minimisation and clear notices.',
    ],

    'voice_spoken_feedback' => [
        'badge'      => 'Assistive',
        'tooltip'    => 'Spoken feedback (e.g. confirmations / status) to improve orientation.',
    ],

    'voice_tutorial_mode' => [
        'badge'      => 'WCAG 3.3.2',
        'tooltip'    => 'Guided mode with examples and clear instructions for voice control.',
    ],

];