@willwade/aac-processors 0.3.3 → 0.3.4

package/dist/browser/utilities/analytics/competence.js

@@ -267,6 +267,21 @@ export function spellingValidity(words, dictionary) {
     }
     return checked === 0 ? null : correct / checked;
 }
+export function lexicalRichness(words) {
+    const n = words.length;
+    const freq = new Map();
+    for (const w of words)
+        freq.set(w, (freq.get(w) ?? 0) + 1);
+    const v = freq.size;
+    let v1 = 0;
+    for (const c of freq.values())
+        if (c === 1)
+            v1++;
+    const brunetsW = n > 0 && v > 0 ? n * Math.pow(v, -0.165) : null;
+    // Honoré's R is undefined when every word is a hapax (V1 = V) or N <= 1.
+    const honoresR = n > 1 && v > 0 && v1 < v ? (100 * Math.log(n)) / (1 - v1 / v) : null;
+    return { brunetsW, honoresR, hapax: v1, types: v, tokens: n };
+}
 function distribution(values) {
     return {
         median: median(values),
@@ -381,6 +396,9 @@ export function analyzeTimeline(utterances, options = {}) {
                 classifyInflection: resources.classifyInflection,
             });
         const spell = suppressed ? null : spellingValidity(stream, dictionary);
+        const rich = suppressed
+            ? { brunetsW: null, honoresR: null, hapax: 0, types: 0, tokens: 0 }
+            : lexicalRichness(stream);
         timeline.push({
             month: key,
             utterances: activity.utterances,
@@ -392,6 +410,7 @@ export function analyzeTimeline(utterances, options = {}) {
             syntacticDiversity: syn,
             morphologicalDiversity: mor,
             spellingValidity: spell,
+            lexicalRichness: rich,
             suppressed,
             suppressReason,
         });

package/dist/utilities/analytics/competence.d.ts

@@ -118,6 +118,19 @@ export declare function morphologicalDiversity(words: WordStream, options?: Dive
  * Returns null (unavailable) if no dictionary is provided.
  */
 export declare function spellingValidity(words: WordStream, dictionary?: Set<string>): number | null;
+export interface LexicalRichness {
+    /** Brunet's index W = N · V^(-0.165). Range ~10–30; LOWER = richer. */
+    brunetsW: number | null;
+    /** Honoré's statistic R = 100·ln N / (1 − V1/V). HIGHER = richer. */
+    honoresR: number | null;
+    /** Hapax legomena (words used exactly once) — count only. */
+    hapax: number;
+    /** Number of distinct words (V). */
+    types: number;
+    /** Number of tokens (N). */
+    tokens: number;
+}
+export declare function lexicalRichness(words: WordStream): LexicalRichness;
 export interface DistributionStats {
     median: number | null;
     mean: number | null;
@@ -151,6 +164,8 @@ export interface MonthBin {
     morphologicalDiversity: DiversityResult;
     /** Phonological — only when a dictionary is supplied. */
     spellingValidity: number | null;
+    /** Lexical richness indices (Brunet's W, Honoré's R) — always available. */
+    lexicalRichness: LexicalRichness;
     /** True when the month has too little data to trust the diversity figures. */
     suppressed: boolean;
     suppressReason: string | null;

package/dist/utilities/analytics/competence.js

@@ -42,6 +42,7 @@ exports.lexicalDiversity = lexicalDiversity;
 exports.syntacticDiversity = syntacticDiversity;
 exports.morphologicalDiversity = morphologicalDiversity;
 exports.spellingValidity = spellingValidity;
+exports.lexicalRichness = lexicalRichness;
 exports.summarizeActivity = summarizeActivity;
 exports.analyzeTimeline = analyzeTimeline;
 /* ------------------------------------------------------------------ *
@@ -277,6 +278,21 @@ function spellingValidity(words, dictionary) {
     }
     return checked === 0 ? null : correct / checked;
 }
+function lexicalRichness(words) {
+    const n = words.length;
+    const freq = new Map();
+    for (const w of words)
+        freq.set(w, (freq.get(w) ?? 0) + 1);
+    const v = freq.size;
+    let v1 = 0;
+    for (const c of freq.values())
+        if (c === 1)
+            v1++;
+    const brunetsW = n > 0 && v > 0 ? n * Math.pow(v, -0.165) : null;
+    // Honoré's R is undefined when every word is a hapax (V1 = V) or N <= 1.
+    const honoresR = n > 1 && v > 0 && v1 < v ? (100 * Math.log(n)) / (1 - v1 / v) : null;
+    return { brunetsW, honoresR, hapax: v1, types: v, tokens: n };
+}
 function distribution(values) {
     return {
         median: median(values),
@@ -391,6 +407,9 @@ function analyzeTimeline(utterances, options = {}) {
                 classifyInflection: resources.classifyInflection,
             });
         const spell = suppressed ? null : spellingValidity(stream, dictionary);
+        const rich = suppressed
+            ? { brunetsW: null, honoresR: null, hapax: 0, types: 0, tokens: 0 }
+            : lexicalRichness(stream);
         timeline.push({
             month: key,
             utterances: activity.utterances,
@@ -402,6 +421,7 @@ function analyzeTimeline(utterances, options = {}) {
             syntacticDiversity: syn,
             morphologicalDiversity: mor,
             spellingValidity: spell,
+            lexicalRichness: rich,
             suppressed,
             suppressReason,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "browser": "dist/browser/index.browser.js",