fix: TTS playback, screen wake lock, and TTS phrase caching

[nbucic]

Summary

• TTS silent on Android — window.NativePhp.tts.speak was called but that object never existed in the codebase; browser speechSynthesis fallback also failed silently because getVoices() returns [] synchronously and the code never waited for the voiceschanged event.
• Screen never stays awake — keepScreenOn setting was stored in the DB (default true) but never consumed: TimerScreen.php didn't expose it as a Livewire property, Settings.php didn't include it in settingsLoaded, and app.js had zero wake lock code.
• TTS caching — native Kotlin bridge (see below) pre-synthesizes all known phrases to WAV files in the app cache directory on first launch; replays them via MediaPlayer with zero latency on subsequent runs.

What was changed (committed)

File	Change
resources/js/audio.js	speak() now uses window.AndroidTTS?.speak (Kotlin bridge); browser fallback waits for voiceschanged event before calling speechSynthesis.speak()
resources/js/app.js	Added keepScreenOn property + navigator.wakeLock.request/release tied to timer state; added settingsLoaded event listener to sync settings changes from Settings screen
app/Livewire/TimerScreen.php	Added public bool $keepScreenOn loaded from settings in mount()
app/Livewire/Settings.php	Added keepScreenOn to settingsLoaded dispatch

Kotlin changes required in nativephp/android/ (gitignored)

The /nativephp directory is gitignored so these three changes must be applied manually after pulling this branch.

1. Create nativephp/android/app/src/main/java/com/nativephp/mobile/bridge/TTSBridge.kt

package com.nativephp.mobile.bridge

import android.content.Context
import android.media.MediaPlayer
import android.os.Bundle
import android.speech.tts.TextToSpeech
import android.speech.tts.UtteranceProgressListener
import android.util.Log
import android.webkit.JavascriptInterface
import java.io.File
import java.util.Locale
import java.util.concurrent.ConcurrentHashMap

class TTSBridge(private val context: Context) {

    private companion object {
        const val TAG = "TTSBridge"
        const val CACHE_DAYS = 3L

        val KNOWN_PHRASES = listOf(
            "Done", "Go", "Next", "Get ready",
            "3", "2", "1",
            "Rest", "Work", "Prepare",
        )
    }

    private var tts: TextToSpeech? = null
    private val players = ConcurrentHashMap<String, MediaPlayer>()
    private var engineReady = false

    init {
        tts = TextToSpeech(context) { status ->
            if (status == TextToSpeech.SUCCESS) {
                tts?.language = Locale.US
                tts?.setPitch(0.9f)
                tts?.setSpeechRate(0.85f)
                engineReady = true
                setupUtteranceListener()
                prebuildCache()
                Log.d(TAG, "TTS engine ready")
            } else {
                Log.e(TAG, "TTS engine init failed with status $status")
            }
        }
    }

    private fun cacheFile(phrase: String): File {
        val safeName = phrase.lowercase().replace(Regex("[^a-z0-9]"), "_")
        return File(context.cacheDir, "tts_$safeName.wav")
    }

    private fun isCacheStale(file: File): Boolean {
        if (!file.exists()) return true
        val cutoffMs = System.currentTimeMillis() - CACHE_DAYS * 86_400_000L
        return file.lastModified() < cutoffMs
    }

    private fun setupUtteranceListener() {
        tts?.setOnUtteranceProgressListener(object : UtteranceProgressListener() {
            override fun onDone(utteranceId: String) {
                val file = cacheFile(utteranceId)
                if (file.exists() && file.length() > 0) {
                    try {
                        val player = MediaPlayer().apply {
                            setDataSource(file.absolutePath)
                            prepare()
                        }
                        players[utteranceId] = player
                    } catch (e: Exception) {
                        Log.e(TAG, "Failed to load MediaPlayer for $utteranceId: ${e.message}")
                    }
                }
            }
            override fun onError(utteranceId: String) {}
            override fun onStart(utteranceId: String) {}
        })
    }

    private fun prebuildCache() {
        KNOWN_PHRASES.forEach { phrase ->
            val file = cacheFile(phrase)
            if (isCacheStale(file)) {
                val params = Bundle()
                tts?.synthesizeToFile(phrase, params, file, phrase)
            } else {
                try {
                    players[phrase] = MediaPlayer().apply {
                        setDataSource(file.absolutePath)
                        prepare()
                    }
                } catch (e: Exception) {
                    file.delete()
                    val params = Bundle()
                    tts?.synthesizeToFile(phrase, params, file, phrase)
                }
            }
        }
    }

    @JavascriptInterface
    fun speak(text: String) {
        val player = players[text]
        if (player != null) {
            try {
                player.seekTo(0)
                player.start()
                return
            } catch (e: Exception) {
                players.remove(text)
            }
        }
        if (engineReady) {
            tts?.speak(text, TextToSpeech.QUEUE_FLUSH, null, null)
        }
    }

    fun shutdown() {
        players.values.forEach { try { it.release() } catch (_: Exception) {} }
        players.clear()
        tts?.shutdown()
        tts = null
        engineReady = false
    }
}

2. Edit WebViewManager.kt — add TTSBridge import + field + registration + shutdown

// Add import at top:
import com.nativephp.mobile.bridge.TTSBridge

// Add field alongside other private vals:
private val ttsBridge = TTSBridge(context)

// In setupJavaScriptInterfaces():
private fun setupJavaScriptInterfaces() {
    webView.addJavascriptInterface(JSBridge(phpBridge, TAG), "AndroidPOST")
    webView.addJavascriptInterface(ttsBridge, "AndroidTTS")   // ← add this line
}

// Add new public method:
fun shutdown() {
    ttsBridge.shutdown()
}

3. Edit MainActivity.kt — call webViewManager.shutdown() in onDestroy()

if (::webViewManager.isInitialized) {
    val chromeClient = webView.webChromeClient
    if (chromeClient is WebChromeClient) {
        chromeClient.onHideCustomView()
    }
    webViewManager.shutdown()   // ← add this line
}

Test plan

• Start a timer in voice mode — each phase transition should speak (Done / Go / Next / Get ready)
• Verify second+ run plays cached phrases with no perceptible delay
• Start a timer — screen should stay on throughout
• Toggle "Keep screen on" OFF in Settings, start timer — screen should dim/lock normally
• Toggle it back ON — screen stays on again
• Confirm wake lock releases when timer finishes or is stopped

🤖 Generated with Claude Code