@willwade/aac-processors 0.1.21 → 0.2.0

package/dist/browser/processors/applePanelsProcessor.js

@@ -86,15 +86,14 @@ class ApplePanelsProcessor extends BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput, pathExists, getFileSize, join } = this.options.fileAdapter;
-        await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.plist';
         let buffer;
         try {
             if (typeof filePathOrBuffer === 'string') {
                 if (filePathOrBuffer.endsWith('.ascconfig')) {
                     const panelDefsPath = join(filePathOrBuffer, 'Contents', 'Resources', 'PanelDefinitions.plist');
-                    if (pathExists(panelDefsPath)) {
-                        buffer = readBinaryFromInput(panelDefsPath);
+                    if (await pathExists(panelDefsPath)) {
+                        buffer = await readBinaryFromInput(panelDefsPath);
                     }
                     else {
                         const validation = buildValidationResultFromMessage({
@@ -109,13 +108,13 @@ class ApplePanelsProcessor extends BaseProcessor {
                     }
                 }
                 else {
-                    buffer = readBinaryFromInput(filePathOrBuffer);
+                    buffer = await readBinaryFromInput(filePathOrBuffer);
                 }
             }
             else {
-                buffer = readBinaryFromInput(filePathOrBuffer);
+                buffer = await readBinaryFromInput(filePathOrBuffer);
             }
-            const content = readTextFromInput(buffer);
+            const content = await readTextFromInput(buffer);
             const parsedData = plist.parse(content);
             let panelsData = [];
             if (Array.isArray(parsedData.panels)) {
@@ -244,10 +243,12 @@ class ApplePanelsProcessor extends BaseProcessor {
             const validation = buildValidationResultFromMessage({
                 filename,
                 filesize: typeof filePathOrBuffer === 'string'
-                    ? (() => {
-                        return pathExists(filePathOrBuffer) ? getFileSize(filePathOrBuffer) : 0;
+                    ? await (async () => {
+                        return (await pathExists(filePathOrBuffer))
+                            ? await getFileSize(filePathOrBuffer)
+                            : 0;
                     })()
-                    : readBinaryFromInput(filePathOrBuffer).byteLength,
+                    : (await readBinaryFromInput(filePathOrBuffer)).byteLength,
                 format: 'applepanels',
                 message: err?.message || 'Failed to parse Apple Panels file',
                 type: 'parse',
@@ -307,15 +308,14 @@ class ApplePanelsProcessor extends BaseProcessor {
         // Save the translated tree to the requested location and return its content
         await this.saveFromTree(tree, outputPath);
         if (outputPath.endsWith('.plist')) {
-            return readBinaryFromInput(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         const configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
         const panelDefsPath = join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
-        return readBinaryFromInput(panelDefsPath);
+        return await readBinaryFromInput(panelDefsPath);
     }
     async saveFromTree(tree, outputPath) {
         const { writeTextToPath, pathExists, mkDir, join, dirname } = this.options.fileAdapter;
-        await Promise.resolve();
         // Support two output modes:
         // 1) Single-file .plist (PanelDefinitions.plist content written directly)
         // 2) Apple Panels bundle folder (*.ascconfig) with Contents/Resources structure
@@ -328,12 +328,12 @@ class ApplePanelsProcessor extends BaseProcessor {
             configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
             contentsPath = join(configPath, 'Contents');
             resourcesPath = join(contentsPath, 'Resources');
-            if (!pathExists(configPath))
-                mkDir(configPath, { recursive: true });
-            if (!pathExists(contentsPath))
-                mkDir(contentsPath, { recursive: true });
-            if (!pathExists(resourcesPath))
-                mkDir(resourcesPath, { recursive: true });
+            if (!(await pathExists(configPath)))
+                await mkDir(configPath, { recursive: true });
+            if (!(await pathExists(contentsPath)))
+                await mkDir(contentsPath, { recursive: true });
+            if (!(await pathExists(resourcesPath)))
+                await mkDir(resourcesPath, { recursive: true });
             // Create Info.plist (bundle mode only)
             const infoPlist = {
                 ASCConfigurationDisplayName: tree.metadata?.name || 'AAC Processors Export',
@@ -349,10 +349,10 @@ class ApplePanelsProcessor extends BaseProcessor {
                     `Generated by AAC Processors${tree.metadata?.author ? ` - Author: ${tree.metadata.author}` : ''}`,
             };
             const infoPlistContent = plist.build(infoPlist);
-            writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
+            await writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
             // Create AssetIndex.plist (empty)
             const assetIndexContent = plist.build({});
-            writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
+            await writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
         }
         // Build PanelDefinitions content from tree
         const panelsDict = {};
@@ -479,13 +479,13 @@ class ApplePanelsProcessor extends BaseProcessor {
         if (isSinglePlist) {
             // Write single PanelDefinitions.plist file directly
             const dir = dirname(outputPath);
-            if (!pathExists(dir))
-                mkDir(dir, { recursive: true });
-            writeTextToPath(outputPath, panelDefsContent);
+            if (!(await pathExists(dir)))
+                await mkDir(dir, { recursive: true });
+            await writeTextToPath(outputPath, panelDefsContent);
         }
         else {
             // Write into bundle structure
-            writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
+            await writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
         }
     }
     createApplePanelsAction(button) {

package/dist/browser/processors/astericsGridProcessor.js

@@ -562,7 +562,7 @@ class AstericsGridProcessor extends BaseProcessor {
             });
         }
         // Also extract texts from the raw file for comprehensive coverage
-        const rawTexts = this.extractRawTexts(filePathOrBuffer);
+        const rawTexts = await this.extractRawTexts(filePathOrBuffer);
         rawTexts.forEach((text) => {
             if (text && !texts.includes(text)) {
                 texts.push(text);
@@ -570,9 +570,9 @@ class AstericsGridProcessor extends BaseProcessor {
         });
         return texts;
     }
-    extractRawTexts(filePathOrBuffer) {
+    async extractRawTexts(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -653,12 +653,11 @@ class AstericsGridProcessor extends BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const tree = new AACTree();
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.grd';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         try {
-            let content = readTextFromInput(buffer);
+            let content = await readTextFromInput(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
@@ -1052,8 +1051,7 @@ class AstericsGridProcessor extends BaseProcessor {
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
         const { readTextFromInput, readBinaryFromInput, writeTextToPath } = this.options.fileAdapter;
-        await Promise.resolve();
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1062,8 +1060,8 @@ class AstericsGridProcessor extends BaseProcessor {
         // Apply translations directly to the JSON structure for comprehensive coverage
         this.applyTranslationsToGridFile(grdFile, translations);
         // Write the translated file
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
-        return readBinaryFromInput(outputPath);
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        return await readBinaryFromInput(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1176,7 +1174,6 @@ class AstericsGridProcessor extends BaseProcessor {
     }
     async saveFromTree(tree, outputPath) {
         const { writeTextToPath } = this.options.fileAdapter;
-        await Promise.resolve();
         // Use default Asterics Grid styling instead of taking from first page
         // This prevents issues where the first page has unusual colors (like purple)
         const defaultPageStyle = {
@@ -1379,14 +1376,14 @@ class AstericsGridProcessor extends BaseProcessor {
                 },
             },
         };
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Add audio recording to a specific grid element
      */
-    addAudioToElement(filePath, elementId, audioData, metadata) {
+    async addAudioToElement(filePath, elementId, audioData, metadata) {
         const { readTextFromInput, writeTextToPath } = this.options.fileAdapter;
-        let content = readTextFromInput(filePath);
+        let content = await readTextFromInput(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1429,32 +1426,33 @@ class AstericsGridProcessor extends BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Create a copy of the grid file with audio recordings added
      */
-    createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
+    async createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
         const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         // Copy the source file to target
-        writeBinaryToPath(targetFilePath, readBinaryFromInput(sourceFilePath));
+        await writeBinaryToPath(targetFilePath, await readBinaryFromInput(sourceFilePath));
         // Add audio recordings to the copy
-        audioMappings.forEach((audioInfo, elementId) => {
+        await Promise.all(Object.entries(audioMappings).map(async (item) => {
+            const [elementId, audioInfo] = item;
             try {
-                this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
+                await this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
             }
             catch (error) {
                 // Failed to add audio to element - continue with others
                 console.warn(`Failed to add audio to element ${elementId}:`, error);
             }
-        });
+        }));
     }
     /**
      * Extract all element IDs from the grid file for audio mapping
      */
-    getElementIds(filePathOrBuffer) {
+    async getElementIds(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1476,9 +1474,9 @@ class AstericsGridProcessor extends BaseProcessor {
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer, elementId) {
+    async hasAudioRecording(filePathOrBuffer, elementId) {
         const { readTextFromInput } = this.options.fileAdapter;
-        let content = readTextFromInput(filePathOrBuffer);
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/browser/processors/dotProcessor.js

@@ -49,8 +49,7 @@ class DotProcessor extends BaseProcessor {
     }
     async extractTexts(filePathOrBuffer) {
         const { readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -67,12 +66,11 @@ class DotProcessor extends BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
-        await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.dot';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = readTextFromInput(buffer);
+            const content = await readTextFromInput(buffer);
             if (!content || content.trim().length === 0) {
                 const validation = buildValidationResultFromMessage({
                     filename,
@@ -157,8 +155,7 @@ class DotProcessor extends BaseProcessor {
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
         const { readTextFromInput, writeBinaryToPath } = this.options.fileAdapter;
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -169,12 +166,11 @@ class DotProcessor extends BaseProcessor {
             }
         });
         const resultBuffer = encodeText(translatedContent || '');
-        writeBinaryToPath(outputPath, resultBuffer);
+        await writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, _outputPath) {
         const { writeTextToPath } = this.options.fileAdapter;
-        await Promise.resolve();
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -204,7 +200,7 @@ class DotProcessor extends BaseProcessor {
             });
         }
         dotContent += '}\n';
-        writeTextToPath(_outputPath, dotContent);
+        await writeTextToPath(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/browser/processors/gridset/helpers.js

@@ -170,7 +170,7 @@ export function getCommonDocumentsPath() {
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
-export function findGrid3UserPaths(fileAdapter = defaultFileAdapter) {
+export async function findGrid3UserPaths(fileAdapter = defaultFileAdapter) {
     const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     // Only works on Windows
@@ -182,26 +182,26 @@ export function findGrid3UserPaths(fileAdapter = defaultFileAdapter) {
         // Use Windows path joining so tests that mock a Windows platform stay consistent even on POSIX runners
         const grid3BasePath = joinWin32(commonDocs, 'Smartbox', 'Grid 3', 'Users');
         // Check if Grid3 Users directory exists
-        if (!pathExists(grid3BasePath)) {
+        if (!(await pathExists(grid3BasePath))) {
             return results;
         }
         // Enumerate users
-        const users = listDir(grid3BasePath);
+        const users = await listDir(grid3BasePath);
         for (const userDir of users) {
-            if (!isDirectory(userDir))
+            if (!(await isDirectory(userDir)))
                 continue;
             const userName = userDir;
             const userPath = joinWin32(grid3BasePath, userName);
             // Enumerate language codes
-            const langDirs = listDir(userPath);
+            const langDirs = await listDir(userPath);
             for (const langDir of langDirs) {
-                if (!isDirectory(langDir))
+                if (!(await isDirectory(langDir)))
                     continue;
                 const langCode = langDir;
                 const basePath = joinWin32(userPath, langCode);
                 const historyDbPath = joinWin32(basePath, 'Phrases', 'history.sqlite');
                 // Only include if history database exists
-                if (pathExists(historyDbPath)) {
+                if (await pathExists(historyDbPath)) {
                     results.push({
                         userName,
                         langCode,
@@ -222,21 +222,22 @@ export function findGrid3UserPaths(fileAdapter = defaultFileAdapter) {
  * Convenience method that returns just the database file paths
  * @returns Array of paths to history.sqlite files
  */
-export function findGrid3HistoryDatabases(fileAdapter) {
-    return findGrid3UserPaths(fileAdapter).map((userPath) => userPath.historyDbPath);
+export async function findGrid3HistoryDatabases(fileAdapter) {
+    const userPaths = await findGrid3UserPaths(fileAdapter);
+    return userPaths.map((userPath) => userPath.historyDbPath);
 }
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
  */
-export function findGrid3Users() {
-    return findGrid3UserPaths();
+export async function findGrid3Users() {
+    return await findGrid3UserPaths();
 }
 /**
  * Find Grid 3 gridset/vocabulary files for each user
  * @param userName Optional user filter; matches case-insensitively
  * @returns Array of user/gridset path pairs
  */
-export function findGrid3Vocabularies(userName, fileAdapter = defaultFileAdapter) {
+export async function findGrid3Vocabularies(userName, fileAdapter = defaultFileAdapter) {
     const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     if (process.platform !== 'win32') {
@@ -244,23 +245,23 @@ export function findGrid3Vocabularies(userName, fileAdapter = defaultFileAdapter
     }
     const commonDocs = getCommonDocumentsPath();
     const grid3BasePath = joinWin32(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    if (!pathExists(grid3BasePath)) {
+    if (!(await pathExists(grid3BasePath))) {
         return results;
     }
     const normalizedUser = userName?.toLowerCase();
-    const users = listDir(grid3BasePath);
+    const users = await listDir(grid3BasePath);
     for (const userDir of users) {
-        if (!isDirectory(userDir))
+        if (!(await isDirectory(userDir)))
             continue;
         if (normalizedUser && userDir.toLowerCase() !== normalizedUser)
             continue;
         const userRoot = joinWin32(grid3BasePath, userDir);
         const gridSetsDir = joinWin32(userRoot, 'Grid Sets');
-        if (!pathExists(gridSetsDir))
+        if (!(await pathExists(gridSetsDir)))
             continue;
-        const entries = listDir(gridSetsDir);
+        const entries = await listDir(gridSetsDir);
         for (const entry of entries) {
-            if (!pathExists(entry) || isDirectory(entry))
+            if (!(await pathExists(entry)) || (await isDirectory(entry)))
                 continue;
             const ext = extname(entry).toLowerCase();
             if (ext === '.gridset' || ext === '.gridsetx' || ext === '.grd' || ext === '.grdl') {
@@ -279,19 +280,20 @@ export function findGrid3Vocabularies(userName, fileAdapter = defaultFileAdapter
  * @param langCode Optional language code filter (case-insensitive)
  * @returns Path to history.sqlite or null if not found
  */
-export function findGrid3UserHistory(userName, langCode, fileAdapter) {
+export async function findGrid3UserHistory(userName, langCode, fileAdapter) {
     if (!userName)
         return null;
     const normalizedUser = userName.toLowerCase();
     const normalizedLang = langCode?.toLowerCase();
-    const match = findGrid3UserPaths(fileAdapter).find((u) => u.userName.toLowerCase() === normalizedUser &&
+    const userPaths = await findGrid3UserPaths(fileAdapter);
+    const match = userPaths.find((u) => u.userName.toLowerCase() === normalizedUser &&
         (!normalizedLang || u.langCode.toLowerCase() === normalizedLang));
     return match?.historyDbPath ?? null;
 }
 /**
  * Check whether Grid 3 appears to be installed (Windows only)
  */
-export function isGrid3Installed(fileAdapter = defaultFileAdapter) {
+export async function isGrid3Installed(fileAdapter = defaultFileAdapter) {
     const { pathExists } = fileAdapter;
     if (process.platform !== 'win32')
         return false;
@@ -299,7 +301,7 @@ export function isGrid3Installed(fileAdapter = defaultFileAdapter) {
     if (!commonDocs)
         return false;
     const grid3BasePath = joinWin32(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    return pathExists(grid3BasePath);
+    return await pathExists(grid3BasePath);
 }
 function parseGrid3ContentXml(xmlContent) {
     const regex = /<r>(?:<!\[CDATA\[)?(.*?)(?:\]\]>)?<\/r>/gis;
@@ -318,9 +320,9 @@ function parseGrid3ContentXml(xmlContent) {
  * @param historyDbPath Absolute path to the history database
  * @returns Parsed history entries grouped by phrase
  */
-export function readGrid3History(historyDbPath, fileAdapter = defaultFileAdapter) {
+export async function readGrid3History(historyDbPath, fileAdapter = defaultFileAdapter) {
     const { pathExists } = fileAdapter;
-    if (!pathExists(historyDbPath))
+    if (!(await pathExists(historyDbPath)))
         return [];
     const Database = requireBetterSqlite3();
     const db = new Database(historyDbPath, { readonly: true });
@@ -380,17 +382,18 @@ export function readGrid3History(historyDbPath, fileAdapter = defaultFileAdapter
  * @param langCode Optional language code to narrow selection (case-insensitive)
  * @returns History entries for that user/language, or empty array if none
  */
-export function readGrid3HistoryForUser(userName, langCode) {
-    const dbPath = findGrid3UserHistory(userName, langCode);
+export async function readGrid3HistoryForUser(userName, langCode) {
+    const dbPath = await findGrid3UserHistory(userName, langCode);
     if (!dbPath)
         return [];
-    return readGrid3History(dbPath);
+    return await readGrid3History(dbPath);
 }
 /**
  * Load all available Grid 3 histories on the machine.
  * @returns Combined history entries from every discovered history.sqlite
  */
-export function readAllGrid3History() {
-    const paths = findGrid3HistoryDatabases();
-    return paths.flatMap((p) => readGrid3History(p));
+export async function readAllGrid3History() {
+    const paths = await findGrid3HistoryDatabases();
+    const history = await Promise.all(paths.map(async (p) => await readGrid3History(p)));
+    return history.flat();
 }

package/dist/browser/processors/gridset/symbolExtractor.js

@@ -277,13 +277,13 @@ function parseSymbolReferenceSafe(reference) {
 /**
  * Export symbol references to CSV for manual extraction
  */
-export function exportSymbolReferencesToCsv(report, outputPath, fileAdapter = defaultFileAdapter) {
+export async function exportSymbolReferencesToCsv(report, outputPath, fileAdapter = defaultFileAdapter) {
     const { writeTextToPath } = fileAdapter;
     const lines = ['Reference,Library,Path,Attribution,License'];
     for (const symbol of report.missingSymbols) {
         lines.push(`"${symbol.reference}","${symbol.library}","${symbol.path}","${symbol.attribution || ''}","${symbol.license || ''}"`);
     }
-    writeTextToPath(outputPath, lines.join('\n'));
+    await writeTextToPath(outputPath, lines.join('\n'));
 }
 export function createSymbolManifest(tree, gridsetName) {
     const manifest = {

package/dist/browser/processors/gridset/symbolSearch.js

@@ -14,9 +14,9 @@ import { defaultFileAdapter } from '../../utils/io';
  * @param pixFilePath - Path to .pix file
  * @returns Search index
  */
-export function parsePixFile(pixFilePath, fileAdapter = defaultFileAdapter) {
+export async function parsePixFile(pixFilePath, fileAdapter = defaultFileAdapter) {
     const { readTextFromInput, basename } = fileAdapter;
-    const content = readTextFromInput(pixFilePath);
+    const content = await readTextFromInput(pixFilePath);
     const library = basename(pixFilePath, '.pix');
     const searchTerms = new Map();
     const filenames = new Map();
@@ -43,18 +43,18 @@ export function parsePixFile(pixFilePath, fileAdapter = defaultFileAdapter) {
  * @param options - Search options
  * @returns Map of library name to search index
  */
-export function loadSearchIndexes(options = {}, fileAdapter = defaultFileAdapter) {
+export async function loadSearchIndexes(options = {}, fileAdapter = defaultFileAdapter) {
     const { listDir, pathExists, join, basename } = fileAdapter;
     const { grid3Path, locale = 'en-GB', libraries: specifiedLibs } = options;
     if (!grid3Path) {
         throw new Error('grid3Path is required for symbol search');
     }
     const searchIndexesDir = join(grid3Path, 'Locale', locale, 'symbolsearch');
-    if (!pathExists(searchIndexesDir)) {
+    if (!(await pathExists(searchIndexesDir))) {
         throw new Error(`Symbol search directory not found: ${searchIndexesDir}`);
     }
     const indexes = new Map();
-    const files = listDir(searchIndexesDir);
+    const files = await listDir(searchIndexesDir);
     for (const file of files) {
         if (!file.endsWith('.pix')) {
             continue;
@@ -68,7 +68,7 @@ export function loadSearchIndexes(options = {}, fileAdapter = defaultFileAdapter
         }
         try {
             const pixFilePath = join(searchIndexesDir, file);
-            const index = parsePixFile(pixFilePath);
+            const index = await parsePixFile(pixFilePath);
             indexes.set(libraryName, index);
         }
         catch (error) {
@@ -83,8 +83,8 @@ export function loadSearchIndexes(options = {}, fileAdapter = defaultFileAdapter
  * @param options - Search options
  * @returns Array of search results
  */
-export function searchSymbols(searchTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+export async function searchSymbols(searchTerm, options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const results = [];
     const lowerSearchTerm = searchTerm.toLowerCase().trim();
     const limit = options.limit || 100;
@@ -137,8 +137,8 @@ export function searchSymbols(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Symbol filename or undefined
  */
-export function getSymbolFilename(searchTerm, library, options = {}) {
-    const indexes = loadSearchIndexes({
+export async function getSymbolFilename(searchTerm, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -155,8 +155,8 @@ export function getSymbolFilename(searchTerm, library, options = {}) {
  * @param options - Search options
  * @returns Display name or undefined
  */
-export function getSymbolDisplayName(symbolFilename, library, options = {}) {
-    const indexes = loadSearchIndexes({
+export async function getSymbolDisplayName(symbolFilename, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -172,8 +172,8 @@ export function getSymbolDisplayName(symbolFilename, library, options = {}) {
  * @param options - Search options
  * @returns Array of search terms
  */
-export function getAllSearchTerms(library, options = {}) {
-    const indexes = loadSearchIndexes({
+export async function getAllSearchTerms(library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -189,8 +189,8 @@ export function getAllSearchTerms(library, options = {}) {
  * @param options - Search options
  * @returns Array of suggested terms
  */
-export function getSearchSuggestions(partialTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+export async function getSearchSuggestions(partialTerm, options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const suggestions = new Set();
     const lowerPartial = partialTerm.toLowerCase().trim();
     for (const index of indexes.values()) {
@@ -208,8 +208,8 @@ export function getSearchSuggestions(partialTerm, options = {}) {
  * @param options - Search options
  * @returns Array of full symbol references
  */
-export function searchSymbolsWithReferences(searchTerm, options = {}) {
-    const results = searchSymbols(searchTerm, options);
+export async function searchSymbolsWithReferences(searchTerm, options = {}) {
+    const results = await searchSymbols(searchTerm, options);
     return results.map((r) => `[${r.library}]${r.symbolFilename}`);
 }
 /**
@@ -217,8 +217,8 @@ export function searchSymbolsWithReferences(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Map of library name to symbol count
  */
-export function countLibrarySymbols(options = {}) {
-    const indexes = loadSearchIndexes(options);
+export async function countLibrarySymbols(options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const counts = new Map();
     for (const [libraryName, index] of indexes.entries()) {
         counts.set(libraryName, index.searchTerms.size);
@@ -230,8 +230,8 @@ export function countLibrarySymbols(options = {}) {
  * @param options - Search options
  * @returns Statistics about available symbols
  */
-export function getSymbolSearchStats(options = {}) {
-    const indexes = loadSearchIndexes(options);
+export async function getSymbolSearchStats(options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const stats = {
         totalLibraries: indexes.size,
         totalSymbols: 0,