@hoanghong/speaking-angular 0.4.3 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.5.0
+
+- Optional multi-criteria local pronunciation diagnostics with methods, limitations and unavailable scores.
+- Compatible with older service responses.
+
 ## 0.4.3
 
 - Remove service addresses from public integration examples; no runtime changes.

package/README.md

@@ -5,15 +5,15 @@ Component nhận dạng lời nói online dùng ngay. Chỉ cài package, chọn
 ## 1. Cài đặt
 
 ```bash
-npm install ./vendor/hoanghong-speaking-core-0.4.3.tgz ./vendor/hoanghong-speaking-angular-0.4.3.tgz
+npm install ./vendor/hoanghong-speaking-core-0.5.0.tgz ./vendor/hoanghong-speaking-angular-0.5.0.tgz
 ```
 
 Core được cài tự động. Với ứng dụng mới: `npx @angular/cli@18 new speaking-demo --standalone --routing=false --style=css`, rồi `cd speaking-demo` và chạy lệnh trên.
 
-Bản 0.4.3 là bộ cài test local: giải nén ZIP và copy hai tarball vào `vendor/` trước.
-Chưa publish 0.4.3 lên registry. Các tính năng nhận dạng cũ vẫn dùng được.
+Bản 0.5.0 là bộ cài test local: giải nén ZIP và copy hai tarball vào `vendor/` trước.
+Chưa publish 0.5.0 lên registry. Các tính năng nhận dạng cũ vẫn dùng được.
 
-## Đánh giá phát âm tiếng Anh Mỹ (0.4.3)
+## Đánh giá phát âm tiếng Anh Mỹ (0.5.0)
 
 Thêm `SpeakingService` vào `providers` của component dùng để test, import từ
 `@hoanghong/speaking-angular`, rồi gọi trong class component:
@@ -166,3 +166,27 @@ App keys identify an application and are visible in browser/mobile applications.
 ```ts
 provideSpeakingApp({ appKey: environment.speakingAppKey });
 ```
+
+
+## Multi-criteria pronunciation diagnostics (0.5.0)
+
+Optional `breakdown` contains accuracy, completeness, fluency, prosody, pronunciation,
+vocabulary, grammar and topic. Each has score (0–100 or null), status
+(estimated/unavailable), method and reason. These are local diagnostics, not Azure
+scores or calibrated grades. Older services may omit breakdown.
+
+- Accuracy = 100 * matches / (matches + substitutions + insertions), at phoneme level.
+- Completeness = 100 * (reference phonemes - omissions) / reference phonemes.
+  Substitutions count as covered; this is coverage, not correctness.
+- Fluency is an energy continuity proxy = 100 * (1 - internal pause seconds / active span).
+  20 ms RMS windows, threshold=max(0.005, 0.1*peak RMS), internal gaps >=250 ms.
+  Excludes leading/trailing silence; requires >=2 s audio and >=1 s active span.
+  Noise may inflate the value and intentional pauses may lower it; this is not VAD/native fluency.
+- Prosody has no score. Pitch P90-P10 and standard deviation (semitones) are reported
+  with >=20 voiced frames and >=2 s audio. Variation does not imply correct intonation.
+- Overall pronunciation and content scores remain null: no calibrated composite,
+  stress model, transcript/grammar evaluator or topic evaluator is configured.
+
+errors counts phoneme matches/substitutions/omissions/insertions. signal.pauses are
+acoustic intervals, not linguistic unexpected/missing breaks. Consult limitations
+and version=local-diagnostics-v1 before interpreting estimates.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hoanghong/speaking-angular",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "Ready-to-use online speaking: five languages, microphone realtime and audio upload",
   "type": "module",
   "peerDependencies": {
@@ -11,7 +11,7 @@
   "sideEffects": false,
   "license": "MIT",
   "dependencies": {
-    "@hoanghong/speaking-core": "^0.4.3",
+    "@hoanghong/speaking-core": "^0.5.0",
     "tslib": "^2.3.0"
   },
   "publishConfig": {