@willwade/aac-processors 0.1.20 → 0.2.0

package/dist/processors/touchchatProcessor.js

@@ -9,7 +9,7 @@ const touchChatValidator_1 = require("../validation/touchChatValidator");
 const io_1 = require("../utils/io");
 const translationProcessor_1 = require("../utilities/translation/translationProcessor");
 const sqlite_1 = require("../utils/sqlite");
-const zip_1 = require("../utils/zip");
+const gridset_1 = require("./gridset");
 const toNumberOrUndefined = (value) => typeof value === 'number' ? value : undefined;
 const toStringOrUndefined = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
 const toBooleanOrUndefined = (value) => typeof value === 'number' ? value !== 0 : undefined;
@@ -58,7 +58,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput } = this.options.fileAdapter;
         // Unzip .ce file, extract the .c4v SQLite DB, and parse pages/buttons
         let db = null;
         let cleanup;
@@ -66,16 +66,17 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             // Store source file path or buffer
             this.sourceFile = filePathOrBuffer;
             // Step 1: Unzip
-            const zipInput = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
-            const { zip } = this.options.zipAdapter
-                ? await this.options.zipAdapter(zipInput)
-                : await (0, zip_1.openZipFromInput)(zipInput);
+            const zipInput = await readBinaryFromInput(filePathOrBuffer);
+            const zip = await this.options.zipAdapter(zipInput);
             const vocabEntry = zip.listFiles().find((name) => name.endsWith('.c4v'));
             if (!vocabEntry) {
                 throw new Error('No .c4v vocab DB found in TouchChat export');
             }
             const dbBuffer = await zip.readFile(vocabEntry);
-            const dbResult = await (0, sqlite_1.openSqliteDatabase)(dbBuffer, { readonly: true });
+            const dbResult = await (0, sqlite_1.openSqliteDatabase)(dbBuffer, {
+                readonly: true,
+                fileAdapter: this.options.fileAdapter,
+            });
             db = dbResult.db;
             cleanup = dbResult.cleanup;
             // Step 3: Create tree and load pages
@@ -470,7 +471,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         finally {
             // Clean up
             if (cleanup) {
-                cleanup();
+                await cleanup();
             }
             else if (db) {
                 db.close();
@@ -478,6 +479,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { pathExists, mkDir, removePath, mkTempDir, writeBinaryToPath, readBinaryFromInput, dirname, join, } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('processTexts is only supported in Node.js environments for TouchChat files.');
         }
@@ -490,28 +492,25 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
          * within the embedded SQLite database, ensuring assets and metadata remain intact.
          */
         if (typeof filePathOrBuffer === 'string') {
-            const fs = (0, io_1.getFs)();
-            const path = (0, io_1.getPath)();
-            const os = (0, io_1.getOs)();
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
             const inputPath = filePathOrBuffer;
-            const outputDir = path.dirname(outputPath);
-            if (!fs.existsSync(outputDir)) {
-                fs.mkdirSync(outputDir, { recursive: true });
+            const outputDir = dirname(outputPath);
+            const dirExists = await pathExists(outputDir);
+            if (!dirExists) {
+                await mkDir(outputDir, { recursive: true });
             }
-            if (fs.existsSync(outputPath)) {
-                fs.unlinkSync(outputPath);
+            if (await pathExists(outputPath)) {
+                await removePath(outputPath);
             }
-            const zip = new AdmZip(inputPath);
-            const entries = zip.getEntries();
+            const zip = await this.options.zipAdapter(inputPath);
+            const entries = (0, gridset_1.getZipEntriesFromAdapter)(zip);
             const vocabEntry = entries.find((entry) => entry.entryName.endsWith('.c4v'));
             if (!vocabEntry) {
                 throw new Error('No .c4v vocab DB found in TouchChat export');
             }
-            const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchchat-translate-'));
-            const dbPath = path.join(tempDir, 'vocab.c4v');
+            const tempDir = await mkTempDir('touchchat-translate-');
+            const dbPath = join(tempDir, 'vocab.c4v');
             try {
-                fs.writeFileSync(dbPath, vocabEntry.getData());
+                await writeBinaryToPath(dbPath, await vocabEntry.getData());
                 const Database = (0, sqlite_1.requireBetterSqlite3)();
                 const db = new Database(dbPath, { readonly: false });
                 try {
@@ -564,26 +563,34 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                 finally {
                     db.close();
                 }
-                const outputZip = new AdmZip();
-                entries.forEach((entry) => {
+                const outputZip = await this.options.zipAdapter();
+                const files = [];
+                for (const entry of entries) {
                     if (entry.entryName === vocabEntry.entryName) {
-                        return;
+                        continue;
                     }
-                    const data = entry.isDirectory ? Buffer.alloc(0) : entry.getData();
-                    outputZip.addFile(entry.entryName, data, entry.comment || '');
+                    const data = await entry.getData();
+                    files.push({
+                        name: entry.entryName,
+                        data,
+                    });
+                }
+                files.push({
+                    name: vocabEntry.entryName,
+                    data: await readBinaryFromInput(dbPath),
                 });
-                outputZip.addFile(vocabEntry.entryName, fs.readFileSync(dbPath));
-                outputZip.writeZip(outputPath);
+                const zipData = await outputZip.writeFiles(files);
+                await writeBinaryToPath(outputPath, zipData);
             }
             finally {
                 try {
-                    fs.rmSync(tempDir, { recursive: true, force: true });
+                    await removePath(tempDir, { recursive: true, force: true });
                 }
                 catch {
                     // Best-effort cleanup
                 }
             }
-            return fs.readFileSync(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         // Fallback for buffer inputs: rebuild from tree (may drop TouchChat metadata)
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -610,20 +617,16 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         await this.saveFromTree(tree, outputPath);
-        const fs = (0, io_1.getFs)();
-        return fs.readFileSync(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
     async saveFromTree(tree, outputPath) {
-        await Promise.resolve();
+        const { writeBinaryToPath, mkTempDir, readBinaryFromInput, pathExists, removePath, join } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('saveFromTree is only supported in Node.js environments for TouchChat files.');
         }
-        const fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
-        const os = (0, io_1.getOs)();
         // Create a TouchChat database that matches the expected schema for loading
-        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchchat-export-'));
-        const dbPath = path.join(tmpDir, 'vocab.c4v');
+        const tmpDir = await mkTempDir('touchchat-export-');
+        const dbPath = join(tmpDir, 'vocab.c4v');
         try {
             const Database = (0, sqlite_1.requireBetterSqlite3)();
             const db = new Database(dbPath);
@@ -916,15 +919,20 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             }
             db.close();
             // Create zip file with the database
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-            const zip = new AdmZip();
-            zip.addLocalFile(dbPath, '', 'vocab.c4v');
-            zip.writeZip(outputPath);
+            const zip = await this.options.zipAdapter();
+            const data = await readBinaryFromInput(dbPath);
+            const zipData = await zip.writeFiles([
+                {
+                    name: 'vocab.c4v',
+                    data,
+                },
+            ]);
+            await writeBinaryToPath(outputPath, zipData);
         }
         finally {
             // Clean up
-            if (fs.existsSync(tmpDir)) {
-                fs.rmSync(tmpDir, { recursive: true, force: true });
+            if (await pathExists(tmpDir)) {
+                await removePath(tmpDir, { recursive: true, force: true });
             }
         }
     }
@@ -1007,7 +1015,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             const outputPath = filePath.replace(/\.ce$/, '_translated.ce');
             // Use existing processTexts method
             await this.processTexts(filePath, translations, outputPath);
-            return Promise.resolve(outputPath);
+            return outputPath;
         }
         catch (error) {
             return Promise.reject(new Error(`Failed to generate translated download: ${error instanceof Error ? error.message : 'Unknown error'}`));
@@ -1019,7 +1027,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Promise with validation result
      */
     async validate(filePath) {
-        return touchChatValidator_1.TouchChatValidator.validateFile(filePath);
+        return await touchChatValidator_1.TouchChatValidator.validateFile(filePath, this.options.fileAdapter);
     }
     /**
      * Extract symbol information from a TouchChat file for LLM-based translation.
@@ -1028,7 +1036,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to TouchChat .ce file or buffer
-     * @returns Array of symbol information for LLM processing
+     * @returns Promise resolving to symbol information for LLM processing
      */
     async extractSymbolsForLLM(filePathOrBuffer) {
         const tree = await this.loadIntoTree(filePathOrBuffer);
@@ -1058,9 +1066,10 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated TouchChat file
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated TouchChat file
+     * @returns Promise resolving to a buffer of the translated TouchChat file
      */
     async processLLMTranslations(filePathOrBuffer, llmTranslations, outputPath, options) {
+        const { readBinaryFromInput } = this.options.fileAdapter;
         if (!(0, io_1.isNodeRuntime)()) {
             throw new Error('processLLMTranslations is only supported in Node.js environments for TouchChat files.');
         }
@@ -1102,8 +1111,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
         });
         // Save and return
         await this.saveFromTree(tree, outputPath);
-        const fs = (0, io_1.getFs)();
-        return fs.readFileSync(outputPath);
+        return await readBinaryFromInput(outputPath);
     }
 }
 exports.TouchChatProcessor = TouchChatProcessor;

package/dist/types/aac.d.ts

@@ -203,6 +203,6 @@ export interface AACTree {
     getPage(id: string): AACPage | undefined;
 }
 export interface AACProcessor {
-    extractTexts(filePath: string | Buffer): string[];
-    loadIntoTree(filePath: string | Buffer): AACTree;
+    extractTexts(filePath: string | Buffer): Promise<string[]>;
+    loadIntoTree(filePath: string | Buffer): Promise<AACTree>;
 }

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

@@ -64,30 +64,30 @@ export declare function exportHistoryToBaton(entries: HistoryEntry[], options?:
 /**
  * Read Grid 3 phrase history from a history.sqlite database and tag entries with their source.
  */
-export declare function readGrid3History(historyDbPath: string): HistoryEntry[];
+export declare function readGrid3History(historyDbPath: string): Promise<HistoryEntry[]>;
 /**
  * Read Grid 3 history for a specific user/language combination.
  */
-export declare function readGrid3HistoryForUser(userName: string, langCode?: string): HistoryEntry[];
+export declare function readGrid3HistoryForUser(userName: string, langCode?: string): Promise<HistoryEntry[]>;
 /**
  * Read every available Grid 3 history database on the machine.
  */
-export declare function readAllGrid3History(): HistoryEntry[];
+export declare function readAllGrid3History(): Promise<HistoryEntry[]>;
 /**
  * Read Snap button usage from a pageset database and tag entries with source.
  */
-export declare function readSnapUsage(pagesetPath: string): HistoryEntry[];
+export declare function readSnapUsage(pagesetPath: string): Promise<HistoryEntry[]>;
 /**
  * Read Snap usage for a specific user across all discovered pagesets.
  */
-export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): HistoryEntry[];
-export declare function listSnapUsers(): SnapUserInfo[];
+export declare function readSnapUsageForUser(userId?: string, packageNamePattern?: string): Promise<HistoryEntry[]>;
+export declare function listSnapUsers(): Promise<SnapUserInfo[]>;
 /**
  * List Grid 3 users on the current machine.
  */
-export declare function listGrid3Users(): Grid3UserPath[];
+export declare function listGrid3Users(): Promise<Grid3UserPath[]>;
 /**
  * Convenience helper to gather all available history across Grid 3 and Snap.
  * Returns an empty array if no history files are present.
  */
-export declare function collectUnifiedHistory(): HistoryEntry[];
+export declare function collectUnifiedHistory(): Promise<HistoryEntry[]>;

package/dist/utilities/analytics/history.js

@@ -72,8 +72,9 @@ function exportHistoryToBaton(entries, options) {
 /**
  * Read Grid 3 phrase history from a history.sqlite database and tag entries with their source.
  */
-function readGrid3History(historyDbPath) {
-    return (0, helpers_1.readGrid3History)(historyDbPath).map((e) => ({
+async function readGrid3History(historyDbPath) {
+    const history = await (0, helpers_1.readGrid3History)(historyDbPath);
+    return history.map((e) => ({
         ...e,
         source: 'Grid',
     }));
@@ -81,8 +82,9 @@ function readGrid3History(historyDbPath) {
 /**
  * Read Grid 3 history for a specific user/language combination.
  */
-function readGrid3HistoryForUser(userName, langCode) {
-    return (0, helpers_1.readGrid3HistoryForUser)(userName, langCode).map((e) => ({
+async function readGrid3HistoryForUser(userName, langCode) {
+    const history = await (0, helpers_1.readGrid3HistoryForUser)(userName, langCode);
+    return history.map((e) => ({
         ...e,
         source: 'Grid',
     }));
@@ -90,39 +92,43 @@ function readGrid3HistoryForUser(userName, langCode) {
 /**
  * Read every available Grid 3 history database on the machine.
  */
-function readAllGrid3History() {
-    return (0, helpers_1.readAllGrid3History)().map((e) => ({ ...e, source: 'Grid' }));
+async function readAllGrid3History() {
+    const history = await (0, helpers_1.readAllGrid3History)();
+    return history.map((e) => ({ ...e, source: 'Grid' }));
 }
 /**
  * Read Snap button usage from a pageset database and tag entries with source.
  */
-function readSnapUsage(pagesetPath) {
-    return (0, helpers_2.readSnapUsage)(pagesetPath).map((e) => ({ ...e, source: 'Snap' }));
+async function readSnapUsage(pagesetPath) {
+    const usage = await (0, helpers_2.readSnapUsage)(pagesetPath);
+    return usage.map((e) => ({ ...e, source: 'Snap' }));
 }
 /**
  * Read Snap usage for a specific user across all discovered pagesets.
  */
-function readSnapUsageForUser(userId, packageNamePattern = 'TobiiDynavox') {
-    return (0, helpers_2.readSnapUsageForUser)(userId, packageNamePattern).map((e) => ({
+async function readSnapUsageForUser(userId, packageNamePattern = 'TobiiDynavox') {
+    const usage = await (0, helpers_2.readSnapUsageForUser)(userId, packageNamePattern);
+    return usage.map((e) => ({
         ...e,
         source: 'Snap',
     }));
 }
-function listSnapUsers() {
-    return (0, helpers_2.findSnapUsers)();
+async function listSnapUsers() {
+    return await (0, helpers_2.findSnapUsers)();
 }
 /**
  * List Grid 3 users on the current machine.
  */
-function listGrid3Users() {
-    return (0, helpers_1.findGrid3Users)();
+async function listGrid3Users() {
+    return await (0, helpers_1.findGrid3Users)();
 }
 /**
  * Convenience helper to gather all available history across Grid 3 and Snap.
  * Returns an empty array if no history files are present.
  */
-function collectUnifiedHistory() {
-    const gridHistory = readAllGrid3History();
-    const snapHistory = (0, helpers_2.findSnapUsers)().flatMap((u) => readSnapUsageForUser(u.userId));
-    return [...gridHistory, ...snapHistory];
+async function collectUnifiedHistory() {
+    const gridHistory = await readAllGrid3History();
+    const users = await (0, helpers_2.findSnapUsers)();
+    const snapHistory = await Promise.all(users.map(async (u) => await readSnapUsageForUser(u.userId)));
+    return [...gridHistory, ...snapHistory.flat()];
 }

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

@@ -9,6 +9,7 @@
  *
  * @module
  */
+import { FileAdapter } from '../../utils/io';
 export * from './metrics/types';
 export * from './metrics/effort';
 export * from './utils/idGenerator';
@@ -23,8 +24,8 @@ export { ReferenceLoader } from './reference';
 /**
  * Get the default reference data path
  */
-export declare function getReferenceDataPath(): string;
+export declare function getReferenceDataPath(fileAdapter: FileAdapter): string;
 /**
  * Check if reference data files exist
  */
-export declare function hasReferenceData(): boolean;
+export declare function hasReferenceData(fileAdapter?: FileAdapter): Promise<boolean>;

package/dist/utilities/analytics/index.js

@@ -24,15 +24,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReferenceLoader = exports.ComparisonAnalyzer = exports.SentenceAnalyzer = exports.VocabularyAnalyzer = exports.MetricsCalculator = exports.OblAnonymizer = exports.OblUtil = void 0;
 exports.getReferenceDataPath = getReferenceDataPath;
 exports.hasReferenceData = hasReferenceData;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
+const io_1 = require("../../utils/io");
 // Always-available exports
 __exportStar(require("./metrics/types"), exports);
 __exportStar(require("./metrics/effort"), exports);
@@ -59,14 +55,16 @@ Object.defineProperty(exports, "ReferenceLoader", { enumerable: true, get: funct
 /**
  * Get the default reference data path
  */
-function getReferenceDataPath() {
-    return path_1.default.join(__dirname, 'reference', 'data');
+function getReferenceDataPath(fileAdapter) {
+    const { join } = fileAdapter;
+    return join(__dirname, 'reference', 'data');
 }
 /**
  * Check if reference data files exist
  */
-function hasReferenceData() {
-    const dataPath = getReferenceDataPath();
+async function hasReferenceData(fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists, join } = fileAdapter;
+    const dataPath = getReferenceDataPath(fileAdapter);
     const requiredFiles = [
         'core_lists.en.json',
         'common_words.en.json',
@@ -74,5 +72,6 @@ function hasReferenceData() {
         'synonyms.en.json',
         'fringe.en.json',
     ];
-    return requiredFiles.every((file) => fs_1.default.existsSync(path_1.default.join(dataPath, file)));
+    const existingPaths = await Promise.all(requiredFiles.map(async (file) => await pathExists(join(dataPath, file))));
+    return existingPaths.every((exists) => exists);
 }

package/dist/utilities/analytics/metrics/comparison.d.ts

@@ -19,7 +19,7 @@ export declare class ComparisonAnalyzer {
     compare(targetResult: MetricsResult, compareResult: MetricsResult, options?: {
         includeSentences?: boolean;
         locale?: string;
-    } & Partial<MetricsOptions>): ComparisonResult;
+    } & Partial<MetricsOptions>): Promise<ComparisonResult>;
     /**
      * Calculate CARE component scores
      */

package/dist/utilities/analytics/metrics/comparison.js

@@ -26,7 +26,7 @@ class ComparisonAnalyzer {
     /**
      * Compare two board sets
      */
-    compare(targetResult, compareResult, options) {
+    async compare(targetResult, compareResult, options) {
         // Create base result from target
         const baseResult = { ...targetResult };
         // Create word maps with normalized keys
@@ -80,7 +80,7 @@ class ComparisonAnalyzer {
             };
         });
         // Calculate CARE components
-        const careComponents = this.calculateCareComponents(targetResult, compareResult, overlappingWords, options);
+        const careComponents = await this.calculateCareComponents(targetResult, compareResult, overlappingWords, options);
         // Analyze high/low effort words
         const highEffortWords = [];
         const lowEffortWords = [];
@@ -113,7 +113,7 @@ class ComparisonAnalyzer {
         // Sentence analysis
         let sentences = [];
         if (options?.includeSentences) {
-            const testSentences = this.referenceLoader.loadSentences();
+            const testSentences = await this.referenceLoader.loadSentences();
             const targetSentences = this.sentenceAnalyzer.analyzeSentences(targetResult, testSentences);
             const compareSentences = this.sentenceAnalyzer.analyzeSentences(compareResult, testSentences);
             sentences = targetSentences.map((ts, idx) => ({
@@ -126,7 +126,7 @@ class ComparisonAnalyzer {
             }));
         }
         // Core vocabulary analysis
-        const coreLists = this.referenceLoader.loadCoreLists();
+        const coreLists = await this.referenceLoader.loadCoreLists();
         const cores = {};
         coreLists.forEach((list) => {
             let targetTotal = 0;
@@ -174,8 +174,8 @@ class ComparisonAnalyzer {
             }
         });
         // Fringe vocabulary analysis
-        const fringeWords = this.analyzeFringe(targetWords, compareWords);
-        const commonFringeWords = this.analyzeCommonFringe(targetWords, compareWords);
+        const fringeWords = await this.analyzeFringe(targetWords, compareWords);
+        const commonFringeWords = await this.analyzeCommonFringe(targetWords, compareWords);
         return {
             ...baseResult,
             buttons: enrichedButtons,
@@ -217,9 +217,9 @@ class ComparisonAnalyzer {
     /**
      * Calculate CARE component scores
      */
-    calculateCareComponents(targetResult, compareResult, _overlappingWords, options) {
+    async calculateCareComponents(targetResult, compareResult, _overlappingWords, options) {
         // Load common words with baseline efforts (matching Ruby line 527-534)
-        const commonWordsData = this.referenceLoader.loadCommonWords();
+        const commonWordsData = await this.referenceLoader.loadCommonWords();
         const commonWords = new Map();
         commonWordsData.words.forEach((word) => {
             commonWords.set(word.toLowerCase(), commonWordsData.efforts[word] || 0);
@@ -271,10 +271,10 @@ class ComparisonAnalyzer {
             }
         });
         // Load reference data
-        const coreLists = this.referenceLoader.loadCoreLists();
-        const fringe = this.referenceLoader.loadFringe();
-        const commonFringe = this.referenceLoader.loadCommonFringe();
-        const sentences = this.referenceLoader.loadSentences();
+        const coreLists = await this.referenceLoader.loadCoreLists();
+        const fringe = await this.referenceLoader.loadFringe();
+        const commonFringe = await this.referenceLoader.loadCommonFringe();
+        const sentences = await this.referenceLoader.loadSentences();
         // Calculate core coverage and effort (matching Ruby lines 609-647)
         let coreCount = 0;
         let compCoreCount = 0;
@@ -426,8 +426,8 @@ class ComparisonAnalyzer {
     /**
      * Analyze fringe vocabulary
      */
-    analyzeFringe(targetWords, compareWords) {
-        const fringe = this.referenceLoader.loadFringe();
+    async analyzeFringe(targetWords, compareWords) {
+        const fringe = await this.referenceLoader.loadFringe();
         const result = [];
         fringe.forEach((word) => {
             const key = this.normalize(word);
@@ -447,8 +447,8 @@ class ComparisonAnalyzer {
     /**
      * Analyze common fringe vocabulary
      */
-    analyzeCommonFringe(targetWords, compareWords) {
-        const fringe = this.referenceLoader.loadFringe();
+    async analyzeCommonFringe(targetWords, compareWords) {
+        const fringe = await this.referenceLoader.loadFringe();
         const result = [];
         fringe.forEach((word) => {
             const key = this.normalize(word);

package/dist/utilities/analytics/metrics/vocabulary.d.ts

@@ -41,7 +41,7 @@ export declare class VocabularyAnalyzer {
         locale?: string;
         highEffortThreshold?: number;
         lowEffortThreshold?: number;
-    }): VocabularyAnalysis;
+    }): Promise<VocabularyAnalysis>;
     /**
      * Analyze coverage for a single core list
      */

package/dist/utilities/analytics/metrics/vocabulary.js

@@ -16,12 +16,12 @@ class VocabularyAnalyzer {
     /**
      * Analyze vocabulary coverage against core lists
      */
-    analyze(metrics, options) {
+    async analyze(metrics, options) {
         // const locale = options?.locale || metrics.locale || 'en';
         const highEffortThreshold = options?.highEffortThreshold || 5.0;
         const lowEffortThreshold = options?.lowEffortThreshold || 2.0;
         // Load reference data
-        const coreLists = this.referenceLoader.loadCoreLists();
+        const coreLists = await this.referenceLoader.loadCoreLists();
         // Create word to effort map (using lowercase keys for matching)
         const wordEffortMap = new Map();
         metrics.buttons.forEach((btn) => {

package/dist/utilities/analytics/reference/browser.d.ts

@@ -16,16 +16,16 @@ export interface ReferenceData {
 export declare class InMemoryReferenceLoader implements ReferenceDataProvider {
     private data;
     constructor(data: ReferenceData);
-    loadCoreLists(): CoreList[];
-    loadCommonWords(): CommonWordsData;
-    loadSynonyms(): SynonymsData;
-    loadSentences(): string[][];
-    loadFringe(): string[];
-    loadBaseWords(): {
+    loadCoreLists(): Promise<CoreList[]>;
+    loadCommonWords(): Promise<CommonWordsData>;
+    loadSynonyms(): Promise<SynonymsData>;
+    loadSentences(): Promise<string[][]>;
+    loadFringe(): Promise<string[]>;
+    loadBaseWords(): Promise<{
         [word: string]: boolean;
-    };
-    loadCommonFringe(): string[];
-    loadAll(): ReferenceData;
+    }>;
+    loadCommonFringe(): Promise<string[]>;
+    loadAll(): Promise<ReferenceData>;
 }
 export declare function loadReferenceDataFromUrl(baseUrl: string, locale?: string): Promise<ReferenceData>;
 export declare function createBrowserReferenceLoader(baseUrl: string, locale?: string): Promise<InMemoryReferenceLoader>;

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

@@ -10,34 +10,34 @@ class InMemoryReferenceLoader {
     constructor(data) {
         this.data = data;
     }
-    loadCoreLists() {
-        return this.data.coreLists;
+    async loadCoreLists() {
+        return Promise.resolve(this.data.coreLists);
     }
-    loadCommonWords() {
-        return this.data.commonWords;
+    async loadCommonWords() {
+        return Promise.resolve(this.data.commonWords);
     }
-    loadSynonyms() {
-        return this.data.synonyms;
+    async loadSynonyms() {
+        return Promise.resolve(this.data.synonyms);
     }
-    loadSentences() {
-        return this.data.sentences;
+    async loadSentences() {
+        return Promise.resolve(this.data.sentences);
     }
-    loadFringe() {
-        return this.data.fringe;
+    async loadFringe() {
+        return Promise.resolve(this.data.fringe);
     }
-    loadBaseWords() {
-        return this.data.baseWords;
+    async loadBaseWords() {
+        return Promise.resolve(this.data.baseWords);
     }
-    loadCommonFringe() {
+    async loadCommonFringe() {
         const commonWords = new Set(this.data.commonWords.words.map((w) => w.toLowerCase()));
         const coreWords = new Set();
         this.data.coreLists.forEach((list) => {
             list.words.forEach((word) => coreWords.add(word.toLowerCase()));
         });
-        return Array.from(commonWords).filter((word) => !coreWords.has(word));
+        return Promise.resolve(Array.from(commonWords).filter((word) => !coreWords.has(word)));
     }
-    loadAll() {
-        return this.data;
+    async loadAll() {
+        return Promise.resolve(this.data);
     }
 }
 exports.InMemoryReferenceLoader = InMemoryReferenceLoader;