@siteed/audio-studio 3.1.1 → 3.2.0

package/ios/AudioStudioModule.swift

@@ -9,6 +9,10 @@ private let recordingInterruptedEvent: String = "onRecordingInterrupted"
 private let deviceChangedEvent: String = "deviceChangedEvent"
 private let trimProgressEvent: String = "TrimProgress"
 private let errorEvent: String = "error"
+private let audioStreamChunkEvent: String = "AudioDataStreamChunk"
+private let audioStreamProgressEvent: String = "AudioDataStreamProgress"
+private let audioStreamCompleteEvent: String = "AudioDataStreamComplete"
+private let audioStreamErrorEvent: String = "AudioDataStreamError"
 private let DEFAULT_SEGMENT_DURATION_MS = 100
 private let audioDeviceTypeBuiltinMic = "builtin_mic"
 private let audioDeviceTypeBluetooth = "bluetooth"
@@ -18,13 +22,16 @@ private let audioDeviceTypeWiredHeadphones = "wired_headphones"
 private let audioDeviceTypeSpeaker = "speaker"
 private let audioDeviceTypeUnknown = "unknown"
 
-public class AudioStudioModule: Module, AudioStreamManagerDelegate, AudioDeviceManagerDelegate {
+public class AudioStudioModule: Module, AudioStreamManagerDelegate, AudioDeviceManagerDelegate, AudioStreamDecoderDelegate {
     private var streamManager = AudioStreamManager()
     private let notificationCenter = UNUserNotificationCenter.current()
     private let notificationIdentifier = "audio_recording_notification"
     private var deviceManager = AudioDeviceManager()
     private var deviceChangeObserver: Any?
 
+    private let streamDecodersLock = NSLock()
+    private var streamDecoders: [String: AudioStreamDecoder] = [:]
+
     // Serial queue for AVAudioEngine lifecycle ops (prepare/start/stop).
     // Prevents concurrent mutation of shared engine state and keeps callers
     // off the main thread to avoid UI freezes during heavy native init.
@@ -43,7 +50,11 @@ public class AudioStudioModule: Module, AudioStreamManagerDelegate, AudioDeviceM
             recordingInterruptedEvent,
             deviceChangedEvent,
             trimProgressEvent,
-            errorEvent
+            errorEvent,
+            audioStreamChunkEvent,
+            audioStreamProgressEvent,
+            audioStreamCompleteEvent,
+            audioStreamErrorEvent
         ])
         
         OnCreate {
@@ -71,6 +82,20 @@ public class AudioStudioModule: Module, AudioStreamManagerDelegate, AudioDeviceM
         OnDestroy {
             Logger.debug("AudioStudioModule", "Module destroyed, stopping device monitoring.")
             _ = streamManager.stopRecording()
+            // Cancel any in-flight streamAudioData decoders before the module
+            // is torn down. Without this, decoder threads can outlive the
+            // module and try to emit events through a destroyed instance.
+            // Detach each decoder's delegate *before* cancelling so the
+            // terminal "cancelled" events the worker emits after observing
+            // `cancel()` are dropped instead of being forwarded.
+            self.streamDecodersLock.lock()
+            let inflight = self.streamDecoders
+            self.streamDecoders.removeAll()
+            self.streamDecodersLock.unlock()
+            for (_, decoder) in inflight {
+                decoder.delegate = nil
+                decoder.cancel()
+            }
             // Clear device manager delegate
             deviceManager.delegate = nil
         }
@@ -901,8 +926,166 @@ public class AudioStudioModule: Module, AudioStreamManagerDelegate, AudioDeviceM
                 }
             }
         }
+
+        AsyncFunction("streamAudioData") { (options: [String: Any], promise: Promise) in
+            guard let requestId = options["requestId"] as? String,
+                  let fileUri = options["fileUri"] as? String else {
+                promise.reject(
+                    "ERR_AUDIO_STREAM_INVALID_RANGE",
+                    "fileUri and requestId are required"
+                )
+                return
+            }
+
+            let streamFormat = options["streamFormat"] as? String ?? "float32"
+            guard streamFormat == "float32" else {
+                promise.reject(
+                    "ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT",
+                    "Only streamFormat='float32' is supported"
+                )
+                return
+            }
+
+            let chunkDurationMs = options["chunkDurationMs"] as? Int ?? 1000
+            guard (10...60000).contains(chunkDurationMs) else {
+                promise.reject(
+                    "ERR_AUDIO_STREAM_INVALID_RANGE",
+                    "chunkDurationMs must be in [10, 60000]"
+                )
+                return
+            }
+
+            let opts = AudioStreamDecoder.Options(
+                requestId: requestId,
+                fileUri: fileUri,
+                startTimeMs: options["startTimeMs"] as? Double,
+                endTimeMs: options["endTimeMs"] as? Double,
+                targetSampleRate: options["targetSampleRate"] as? Double,
+                channels: options["channels"] as? Int,
+                normalizeAudio: options["normalizeAudio"] as? Bool ?? true,
+                chunkDurationMs: chunkDurationMs,
+                maxChunkBytes: options["maxChunkBytes"] as? Int,
+                maxBufferedChunks: options["maxBufferedChunks"] as? Int ?? 4,
+                backpressureTimeoutMs: options["backpressureTimeoutMs"] as? Double
+            )
+
+            let decoder = AudioStreamDecoder(options: opts)
+            decoder.delegate = self
+            self.streamDecodersLock.lock()
+            if self.streamDecoders[requestId] != nil {
+                self.streamDecodersLock.unlock()
+                promise.reject(
+                    "ERR_AUDIO_STREAM_BUSY",
+                    "requestId already in use"
+                )
+                return
+            }
+            self.streamDecoders[requestId] = decoder
+            self.streamDecodersLock.unlock()
+            decoder.start()
+            promise.resolve(["requestId": requestId])
+        }
+
+        AsyncFunction("cancelStreamAudioData") { (requestId: String, promise: Promise) in
+            self.streamDecodersLock.lock()
+            let decoder = self.streamDecoders[requestId]
+            self.streamDecodersLock.unlock()
+            decoder?.cancel()
+            promise.resolve(["requestId": requestId, "cancelled": decoder != nil])
+        }
+
+        Function("acknowledgeStreamAudioChunk") { (requestId: String, chunkIndex: Int) in
+            self.streamDecodersLock.lock()
+            let decoder = self.streamDecoders[requestId]
+            self.streamDecodersLock.unlock()
+            decoder?.acknowledgeChunk(chunkIndex)
+        }
+
+        AsyncFunction("getAudioDecodeCapabilities") { (promise: Promise) in
+            promise.resolve([
+                "platform": "ios",
+                "supportedInputFormats": [
+                    "audio/wav",
+                    "audio/aac",
+                    "audio/mp4",
+                    "audio/mpeg",
+                    "audio/x-m4a",
+                    "audio/caf",
+                    "audio/aiff",
+                ],
+                "supportedOutputFormats": ["float32"],
+                "supportsCancellation": true,
+                "supportsBackpressure": true,
+                "supportsTimeRange": true,
+                "supportsTargetSampleRate": true,
+                "supportsChannelMixing": true,
+                "knownLimitations": [
+                    "Opus/WebM input depends on AVFoundation codec availability for the iOS version."
+                ],
+            ])
+        }
     }
-    
+
+    private func releaseStreamDecoder(_ requestId: String) {
+        streamDecodersLock.lock()
+        streamDecoders.removeValue(forKey: requestId)
+        streamDecodersLock.unlock()
+    }
+
+    /// Returns true when `requestId` is still tracked by the module. Used as
+    /// the lifecycle gate for delegate sends: callbacks that race with
+    /// `OnDestroy` (which clears the map *before* cancelling) see `false`
+    /// and skip `sendEvent`, so we never push events through a destroyed
+    /// React context.
+    private func isActiveStreamDecoder(_ requestId: String) -> Bool {
+        streamDecodersLock.lock()
+        defer { streamDecodersLock.unlock() }
+        return streamDecoders[requestId] != nil
+    }
+
+    // MARK: - AudioStreamDecoderDelegate
+
+    public func streamDecoder(
+        _ decoder: AudioStreamDecoder,
+        didEmitChunk payload: [String: Any]
+    ) {
+        guard let requestId = payload["requestId"] as? String,
+              isActiveStreamDecoder(requestId) else { return }
+        sendEvent(audioStreamChunkEvent, payload)
+    }
+
+    public func streamDecoder(
+        _ decoder: AudioStreamDecoder,
+        didReportProgress payload: [String: Any]
+    ) {
+        guard let requestId = payload["requestId"] as? String,
+              isActiveStreamDecoder(requestId) else { return }
+        sendEvent(audioStreamProgressEvent, payload)
+    }
+
+    public func streamDecoder(
+        _ decoder: AudioStreamDecoder,
+        didCompleteWith payload: [String: Any]
+    ) {
+        guard let requestId = payload["requestId"] as? String,
+              isActiveStreamDecoder(requestId) else { return }
+        releaseStreamDecoder(requestId)
+        sendEvent(audioStreamCompleteEvent, payload)
+    }
+
+    public func streamDecoder(
+        _ decoder: AudioStreamDecoder,
+        didFailWith payload: [String: Any]
+    ) {
+        guard let requestId = payload["requestId"] as? String,
+              isActiveStreamDecoder(requestId) else { return }
+        if let code = payload["code"] as? String,
+           code != "ERR_AUDIO_STREAM_CANCELLED" {
+            releaseStreamDecoder(requestId)
+        }
+        sendEvent(audioStreamErrorEvent, payload)
+    }
+
     func audioStreamManager(_ manager: AudioStreamManager, didReceiveInterruption info: [String: Any]) {
         Logger.debug("AudioStudioModule", "Delegate: didReceiveInterruption: \(info)")
         // Convert iOS interruption events to match the TypeScript types

package/package.json

@@ -1,147 +1,164 @@
 {
-    "name": "@siteed/audio-studio",
-    "version": "3.1.1",
-    "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
-    "license": "MIT",
-    "type": "commonjs",
-    "main": "./build/cjs/index.js",
-    "module": "./build/esm/index.js",
-    "types": "./build/types/index.d.ts",
-    "expo": {
-        "plugin": "./app.plugin.js"
-    },
-    "author": "Arthur Breton <abreton@siteed.net> (https://github.com/deeeed)",
-    "homepage": "https://github.com/deeeed/audiolab/blob/main/packages/audio-studio/README.md",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/deeeed/audiolab.git",
-        "directory": "packages/audio-studio"
-    },
-    "bugs": {
-        "url": "https://github.com/deeeed/audiolab/issues"
-    },
-    "keywords": [
-        "react-native",
-        "expo",
-        "audio",
-        "recording",
-        "audio-analysis",
-        "audio-processing",
-        "audio-visualization",
-        "waveform",
-        "spectrogram",
-        "mel-spectrogram",
-        "mfcc",
-        "audio-features",
-        "audio-compression",
-        "opus",
-        "aac",
-        "pcm",
-        "wav",
-        "cross-platform",
-        "background-recording",
-        "audio-trimming",
-        "dual-stream"
-    ],
-    "files": [
-        "src",
-        "android",
-        "ios",
-        "cpp",
-        "plugin",
-        "app.plugin.js",
-        "LICENSE",
-        "CHANGELOG.md",
-        "generated",
-        "expo-module.config.json",
-        "README.md",
-        "package.json",
-        "*.podspec",
-        "prebuilt",
-        "build",
-        "!ios/build",
-        "!android/build",
-        "!android/gradle",
-        "!android/gradlew",
-        "!android/gradlew.bat",
-        "!android/local.properties",
-        "!**/__tests__",
-        "!**/__fixtures__",
-        "!**/__mocks__",
-        "!**/.*"
-    ],
-    "scripts": {
-        "build:wasm": "bash scripts/build-wasm.sh",
-        "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin && cp -r prebuilt/ build/cjs/prebuilt && cp -r prebuilt/ build/esm/prebuilt",
-        "build:cjs": "tsc -p tsconfig.cjs.json",
-        "build:esm": "tsc -p tsconfig.esm.json",
-        "build:types": "tsc -p tsconfig.types.json",
-        "build:plugin": "tsc --project plugin/tsconfig.json && cp plugin/build/index.js plugin/build/index.cjs",
-        "build:plugin:dev": "expo-module build plugin",
-        "build:dev": "expo-module build",
-        "clean": "expo-module clean && rimraf build plugin/build",
-        "lint": "expo-module lint",
-        "lint:fix": "expo-module lint --fix",
-        "test": "expo-module test",
-        "test:android": "yarn test:android:unit && yarn test:android:instrumented",
-        "test:android:unit": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test",
-        "test:android:instrumented": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:connectedAndroidTest",
-        "test:android:unit:watch": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test --continuous",
-        "test:ios": "cd ../../apps/playground/ios && xcodebuild -workspace AudioDevPlayground.xcworkspace -scheme AudioDevPlayground -destination 'platform=iOS Simulator,name=iPhone 15' build",
-        "test:coverage": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:jacocoTestReport",
-        "typecheck": "tsc --noEmit",
-        "docgen": "typedoc src/index.ts --plugin typedoc-plugin-markdown --readme none --out ../../documentation_site/docs/api-reference/API && node ../../scripts/escape-mdx-generics.js ../../documentation_site/docs/api-reference",
-        "prepare": "yarn build && node -e \"require('fs').renameSync('./plugin/build/index.d.ts', './plugin/build/index.d.cts')\"",
-        "prepublishOnly.disabled": "expo-module prepublishOnly",
-        "expo-module": "expo-module",
-        "open:ios": "open -a \"Xcode\" ../../apps/playground/ios",
-        "open:android": "open -a \"Android Studio\" ../../apps/playground/android",
-        "size": "bundle-size && size-limit",
-        "release": "./publish.sh",
-        "agent:test:unit": "yarn test:android:unit",
-        "agent:test:integration": "yarn test:android:instrumented",
-        "agent:compilation:check": "yarn typecheck && yarn build"
-    },
-    "devDependencies": {
-        "@expo/config-plugins": "~54.0.0",
-        "@expo/npm-proofread": "^1.0.1",
-        "@siteed/publisher": "^0.4.18",
-        "@size-limit/preset-big-lib": "^11.1.4",
-        "@types/jest": "^29.5.12",
-        "@types/node": "^20.12.7",
-        "@types/react": "~19.0.10",
-        "@typescript-eslint/eslint-plugin": "^7.7.0",
-        "@typescript-eslint/parser": "^7.7.0",
-        "bundle-size": "^1.1.5",
-        "eslint": "^8.56.0",
-        "eslint-config-prettier": "^9.1.0",
-        "eslint-config-universe": "^12.0.0",
-        "eslint-plugin-import": "^2.29.1",
-        "eslint-plugin-prettier": "^5.1.3",
-        "eslint-plugin-promise": "^6.1.1",
-        "eslint-plugin-react": "^7.34.1",
-        "expo": "^54.0.0",
-        "expo-module-scripts": "^4.1.7",
-        "expo-modules-core": "~3.0.0",
-        "jest": "^29.7.0",
-        "prettier": "^3.2.5",
-        "react": "19.2.0",
-        "react-native": "0.83.6",
-        "rimraf": "^6.0.1",
-        "size-limit": "^11.1.4",
-        "ts-node": "^10.9.2",
-        "typedoc": "^0.27.4",
-        "typedoc-plugin-markdown": "~4.4.2",
-        "typescript": "~5.8.3"
-    },
-    "peerDependencies": {
-        "@expo/config-plugins": ">=7.0.0",
-        "expo": ">=52.0.0",
-        "react": "*",
-        "react-native": "*"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org"
-    }
-}
+  "name": "@siteed/audio-studio",
+  "version": "3.2.0",
+  "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
+  "types": "./build/types/index.d.ts",
+  "expo": {
+    "plugin": "./app.plugin.js"
+  },
+  "author": "Arthur Breton <abreton@siteed.net> (https://github.com/deeeed)",
+  "homepage": "https://github.com/deeeed/audiolab/blob/main/packages/audio-studio/README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deeeed/audiolab.git",
+    "directory": "packages/audio-studio"
+  },
+  "bugs": {
+    "url": "https://github.com/deeeed/audiolab/issues"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "audio",
+    "recording",
+    "audio-analysis",
+    "audio-processing",
+    "audio-visualization",
+    "waveform",
+    "spectrogram",
+    "mel-spectrogram",
+    "mfcc",
+    "audio-features",
+    "audio-compression",
+    "opus",
+    "aac",
+    "pcm",
+    "wav",
+    "cross-platform",
+    "background-recording",
+    "audio-trimming",
+    "dual-stream"
+  ],
+  "files": [
+    "src",
+    "android",
+    "ios",
+    "cpp",
+    "plugin",
+    "app.plugin.js",
+    "LICENSE",
+    "CHANGELOG.md",
+    "generated",
+    "expo-module.config.json",
+    "README.md",
+    "package.json",
+    "*.podspec",
+    "prebuilt",
+    "build",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!ios/AudioStudioTests",
+    "!ios/AudioStudioTests/**",
+    "!ios/tests",
+    "!ios/tests/**",
+    "!android/src/androidTest",
+    "!android/src/androidTest/**",
+    "!android/src/test",
+    "!android/src/test/**",
+    "!android/src/test/resources",
+    "!android/src/test/resources/**",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "build:wasm": "bash scripts/build-wasm.sh",
+    "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin && cp -r prebuilt/ build/cjs/prebuilt && cp -r prebuilt/ build/esm/prebuilt",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build:plugin": "tsc --project plugin/tsconfig.json && cp plugin/build/index.js plugin/build/index.cjs",
+    "build:plugin:dev": "expo-module build plugin",
+    "build:dev": "expo-module build",
+    "clean": "expo-module clean && rimraf build plugin/build",
+    "lint": "expo-module lint",
+    "lint:fix": "expo-module lint --fix",
+    "test": "expo-module test",
+    "test:android": "yarn test:android:unit && yarn test:android:instrumented",
+    "test:android:unit": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test",
+    "test:android:instrumented": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:connectedAndroidTest",
+    "test:android:unit:watch": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test --continuous",
+    "test:ios": "cd ../../apps/playground/ios && xcodebuild -workspace AudioDevPlayground.xcworkspace -scheme AudioDevPlayground -destination 'generic/platform=iOS Simulator' build",
+    "test:coverage": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:jacocoTestReport",
+    "typecheck": "tsc --noEmit",
+    "docgen": "typedoc src/index.ts --plugin typedoc-plugin-markdown --readme none --out ../../documentation_site/docs/api-reference/API && node ../../scripts/escape-mdx-generics.js ../../documentation_site/docs/api-reference",
+    "prepare": "yarn build && node -e \"require('fs').renameSync('./plugin/build/index.d.ts', './plugin/build/index.d.cts')\"",
+    "prepublishOnly.disabled": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "open -a \"Xcode\" ../../apps/playground/ios",
+    "open:android": "open -a \"Android Studio\" ../../apps/playground/android",
+    "size": "bundle-size && size-limit",
+    "release": "./publish.sh",
+    "agent:test:unit": "yarn test:android:unit",
+    "agent:test:integration": "yarn test:android:instrumented",
+    "agent:compilation:check": "yarn typecheck && yarn build",
+    "android": "cd ../../apps/playground && yarn android",
+    "android:launch": "cd ../../apps/playground && yarn android:launch",
+    "validate:stream-long": "node scripts/validate-stream-long.mjs",
+    "android:device": "cd ../../apps/playground && yarn android:device",
+    "android:device:launch": "cd ../../apps/playground && yarn android:device:launch",
+    "summarize:stream-long": "node scripts/summarize-stream-long.mjs"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "~54.0.0",
+    "@expo/npm-proofread": "^1.0.1",
+    "@siteed/publisher": "^0.4.18",
+    "@size-limit/preset-big-lib": "^11.1.4",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.7",
+    "@types/react": "~19.0.10",
+    "@typescript-eslint/eslint-plugin": "^7.7.0",
+    "@typescript-eslint/parser": "^7.7.0",
+    "bundle-size": "^1.1.5",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-universe": "^12.0.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-react": "^7.34.1",
+    "expo": "^54.0.0",
+    "expo-module-scripts": "^4.1.7",
+    "expo-modules-core": "~3.0.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "react": "19.2.0",
+    "react-native": "0.83.6",
+    "rimraf": "^6.0.1",
+    "size-limit": "^11.1.4",
+    "ts-jest": "^29.2.6",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.27.4",
+    "typedoc-plugin-markdown": "~4.4.2",
+    "typescript": "~5.8.3"
+  },
+  "peerDependencies": {
+    "@expo/config-plugins": ">=7.0.0",
+    "expo": ">=52.0.0",
+    "react": "*",
+    "react-native": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/scripts/README.md

@@ -0,0 +1,58 @@
+# Test Scripts
+
+This directory contains unified test scripts for expo-audio-studio.
+
+## run_tests.sh
+
+A unified test runner that can execute tests for both Android and iOS platforms.
+
+### Usage
+
+```bash
+./scripts/run_tests.sh [platform] [type]
+```
+
+### Parameters
+
+- **platform**: Which platform to test
+  - `all` (default) - Run tests for both platforms
+  - `android` - Run Android tests only
+  - `ios` - Run iOS tests only
+
+- **type**: Which type of tests to run
+  - `all` (default) - Run all test types
+  - `unit` - Run unit tests (Android only)
+  - `instrumented` - Run instrumented tests (Android only)
+  - `standalone` - Run standalone Swift tests (iOS only)
+
+### Examples
+
+```bash
+# Run all tests for both platforms
+./scripts/run_tests.sh
+
+# Run Android tests only
+./scripts/run_tests.sh android
+
+# Run Android unit tests only
+./scripts/run_tests.sh android unit
+
+# Run iOS tests only
+./scripts/run_tests.sh ios
+
+# Run all tests explicitly
+./scripts/run_tests.sh all all
+```
+
+### Requirements
+
+- **Android**: Requires Android SDK and a connected device/emulator for instrumented tests
+- **iOS**: Requires Swift compiler (comes with Xcode)
+
+### Output
+
+The script provides colored output:
+- 🧪 Test execution progress
+- ✅ Success messages in green
+- ❌ Failure messages in red
+- Summary of tests passed/failed