@willwade/aac-processors 0.1.20 → 0.2.0

package/dist/processors/gridset/helpers.js

@@ -1,30 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPageTokenImageMap = getPageTokenImageMap;
 exports.getAllowedImageEntries = getAllowedImageEntries;
@@ -44,13 +18,11 @@ exports.readGrid3HistoryForUser = readGrid3HistoryForUser;
 exports.readAllGrid3History = readAllGrid3History;
 const fast_xml_parser_1 = require("fast-xml-parser");
 const treeStructure_1 = require("../../core/treeStructure");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const child_process_1 = require("child_process");
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const dotnetTicks_1 = require("../../utils/dotnetTicks");
 const password_1 = require("./password");
+const io_1 = require("../../utils/io");
 const zip_1 = require("../../utils/zip");
+const sqlite_1 = require("../../utils/sqlite");
 function normalizeZipPath(p) {
     const unified = p.replace(/\\/g, '/');
     try {
@@ -96,11 +68,11 @@ function getAllowedImageEntries(tree) {
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-async function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)(), zipAdapter) {
+async function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)(), fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     try {
-        const { zip } = zipAdapter
+        const zip = zipAdapter
             ? await zipAdapter(gridsetBuffer)
-            : await (0, zip_1.openZipFromInput)(gridsetBuffer);
+            : await (0, zip_1.getZipAdapter)(gridsetBuffer, fileAdapter);
         const entries = (0, password_1.getZipEntriesFromAdapter)(zip, password);
         const want = normalizeZipPath(entryPath);
         const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
@@ -193,8 +165,9 @@ function getCommonDocumentsPath() {
     }
     try {
         // Query registry for Common Documents path
+        const child_process = (0, io_1.getNodeRequire)()('child_process');
         const command = 'REG.EXE QUERY "HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders" /V "Common Documents"';
-        const output = (0, child_process_1.execSync)(command, { encoding: 'utf-8', windowsHide: true });
+        const output = child_process.execSync(command, { encoding: 'utf-8', windowsHide: true });
         // Parse the output to extract the path
         const match = output.match(/Common Documents\s+REG_SZ\s+(.+)/);
         if (match && match[1]) {
@@ -215,7 +188,8 @@ function getCommonDocumentsPath() {
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
-function findGrid3UserPaths() {
+async function findGrid3UserPaths(fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     // Only works on Windows
     if (process.platform !== 'win32') {
@@ -224,28 +198,28 @@ function findGrid3UserPaths() {
     try {
         const commonDocs = getCommonDocumentsPath();
         // Use Windows path joining so tests that mock a Windows platform stay consistent even on POSIX runners
-        const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+        const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
         // Check if Grid3 Users directory exists
-        if (!fs.existsSync(grid3BasePath)) {
+        if (!(await pathExists(grid3BasePath))) {
             return results;
         }
         // Enumerate users
-        const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+        const users = await listDir(grid3BasePath);
         for (const userDir of users) {
-            if (!userDir.isDirectory())
+            if (!(await isDirectory(userDir)))
                 continue;
-            const userName = userDir.name;
-            const userPath = path.win32.join(grid3BasePath, userName);
+            const userName = userDir;
+            const userPath = (0, io_1.joinWin32)(grid3BasePath, userName);
             // Enumerate language codes
-            const langDirs = fs.readdirSync(userPath, { withFileTypes: true });
+            const langDirs = await listDir(userPath);
             for (const langDir of langDirs) {
-                if (!langDir.isDirectory())
+                if (!(await isDirectory(langDir)))
                     continue;
-                const langCode = langDir.name;
-                const basePath = path.win32.join(userPath, langCode);
-                const historyDbPath = path.win32.join(basePath, 'Phrases', 'history.sqlite');
+                const langCode = langDir;
+                const basePath = (0, io_1.joinWin32)(userPath, langCode);
+                const historyDbPath = (0, io_1.joinWin32)(basePath, 'Phrases', 'history.sqlite');
                 // Only include if history database exists
-                if (fs.existsSync(historyDbPath)) {
+                if (await pathExists(historyDbPath)) {
                     results.push({
                         userName,
                         langCode,
@@ -266,50 +240,52 @@ function findGrid3UserPaths() {
  * Convenience method that returns just the database file paths
  * @returns Array of paths to history.sqlite files
  */
-function findGrid3HistoryDatabases() {
-    return findGrid3UserPaths().map((userPath) => userPath.historyDbPath);
+async function findGrid3HistoryDatabases(fileAdapter) {
+    const userPaths = await findGrid3UserPaths(fileAdapter);
+    return userPaths.map((userPath) => userPath.historyDbPath);
 }
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
  */
-function findGrid3Users() {
-    return findGrid3UserPaths();
+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
  */
-function findGrid3Vocabularies(userName) {
+async function findGrid3Vocabularies(userName, fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists, listDir, isDirectory } = fileAdapter;
     const results = [];
     if (process.platform !== 'win32') {
         return results;
     }
     const commonDocs = getCommonDocumentsPath();
-    const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    if (!fs.existsSync(grid3BasePath)) {
+    const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+    if (!(await pathExists(grid3BasePath))) {
         return results;
     }
     const normalizedUser = userName?.toLowerCase();
-    const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+    const users = await listDir(grid3BasePath);
     for (const userDir of users) {
-        if (!userDir.isDirectory())
+        if (!(await isDirectory(userDir)))
             continue;
-        if (normalizedUser && userDir.name.toLowerCase() !== normalizedUser)
+        if (normalizedUser && userDir.toLowerCase() !== normalizedUser)
             continue;
-        const userRoot = path.win32.join(grid3BasePath, userDir.name);
-        const gridSetsDir = path.win32.join(userRoot, 'Grid Sets');
-        if (!fs.existsSync(gridSetsDir))
+        const userRoot = (0, io_1.joinWin32)(grid3BasePath, userDir);
+        const gridSetsDir = (0, io_1.joinWin32)(userRoot, 'Grid Sets');
+        if (!(await pathExists(gridSetsDir)))
             continue;
-        const entries = fs.readdirSync(gridSetsDir, { withFileTypes: true });
+        const entries = await listDir(gridSetsDir);
         for (const entry of entries) {
-            if (!entry.isFile())
+            if (!(await pathExists(entry)) || (await isDirectory(entry)))
                 continue;
-            const ext = path.extname(entry.name).toLowerCase();
+            const ext = (0, io_1.extname)(entry).toLowerCase();
             if (ext === '.gridset' || ext === '.gridsetx' || ext === '.grd' || ext === '.grdl') {
                 results.push({
-                    userName: userDir.name,
-                    gridsetPath: path.win32.join(gridSetsDir, entry.name),
+                    userName: userDir,
+                    gridsetPath: (0, io_1.joinWin32)(gridSetsDir, entry),
                 });
             }
         }
@@ -322,26 +298,28 @@ function findGrid3Vocabularies(userName) {
  * @param langCode Optional language code filter (case-insensitive)
  * @returns Path to history.sqlite or null if not found
  */
-function findGrid3UserHistory(userName, langCode) {
+async function findGrid3UserHistory(userName, langCode, fileAdapter) {
     if (!userName)
         return null;
     const normalizedUser = userName.toLowerCase();
     const normalizedLang = langCode?.toLowerCase();
-    const match = findGrid3UserPaths().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)
  */
-function isGrid3Installed() {
+async function isGrid3Installed(fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
     if (process.platform !== 'win32')
         return false;
     const commonDocs = getCommonDocumentsPath();
     if (!commonDocs)
         return false;
-    const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
-    return fs.existsSync(grid3BasePath);
+    const grid3BasePath = (0, io_1.joinWin32)(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+    return await pathExists(grid3BasePath);
 }
 function parseGrid3ContentXml(xmlContent) {
     const regex = /<r>(?:<!\[CDATA\[)?(.*?)(?:\]\]>)?<\/r>/gis;
@@ -360,10 +338,12 @@ function parseGrid3ContentXml(xmlContent) {
  * @param historyDbPath Absolute path to the history database
  * @returns Parsed history entries grouped by phrase
  */
-function readGrid3History(historyDbPath) {
-    if (!fs.existsSync(historyDbPath))
+async function readGrid3History(historyDbPath, fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
+    if (!(await pathExists(historyDbPath)))
         return [];
-    const db = new better_sqlite3_1.default(historyDbPath, { readonly: true });
+    const Database = (0, sqlite_1.requireBetterSqlite3)();
+    const db = new Database(historyDbPath, { readonly: true });
     const rows = db
         .prepare(`
       SELECT p.Id as PhraseId,
@@ -420,17 +400,18 @@ function readGrid3History(historyDbPath) {
  * @param langCode Optional language code to narrow selection (case-insensitive)
  * @returns History entries for that user/language, or empty array if none
  */
-function readGrid3HistoryForUser(userName, langCode) {
-    const dbPath = findGrid3UserHistory(userName, langCode);
+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
  */
-function readAllGrid3History() {
-    const paths = findGrid3HistoryDatabases();
-    return paths.flatMap((p) => readGrid3History(p));
+async function readAllGrid3History() {
+    const paths = await findGrid3HistoryDatabases();
+    const history = await Promise.all(paths.map(async (p) => await readGrid3History(p)));
+    return history.flat();
 }

package/dist/processors/gridset/imageDebug.d.ts

@@ -4,8 +4,8 @@
  * These utilities help developers understand why images might not be resolving
  * correctly in Grid3 gridsets.
  */
-import { type ZipAdapter } from '../../utils/zip';
-import { type ProcessorInput } from '../../utils/io';
+import { FileAdapter, type ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 export interface ImageIssue {
     gridName: string;
     cellX: number;
@@ -36,9 +36,7 @@ export interface ImageAuditResult {
  *   console.log(`Cell (${issue.cellX}, ${issue.cellY}): ${issue.suggestion}`);
  * });
  */
-export declare function auditGridsetImages(gridsetBuffer: Uint8Array, password?: string | undefined, zipAdapter?: (input: ProcessorInput) => Promise<{
-    zip: ZipAdapter;
-}>): Promise<ImageAuditResult>;
+export declare function auditGridsetImages(gridsetBuffer: Uint8Array, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<ImageAuditResult>;
 /**
  * Get a human-readable summary of image audit results
  */

package/dist/processors/gridset/imageDebug.js

@@ -8,11 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.auditGridsetImages = auditGridsetImages;
 exports.formatImageAuditSummary = formatImageAuditSummary;
-const zip_1 = require("../../utils/zip");
 const password_1 = require("./password");
 const password_2 = require("./password");
 const fast_xml_parser_1 = require("fast-xml-parser");
 const io_1 = require("../../utils/io");
+const zip_1 = require("../../utils/zip");
 /**
  * Audit a gridset file to find image resolution issues
  *
@@ -26,7 +26,7 @@ const io_1 = require("../../utils/io");
  *   console.log(`Cell (${issue.cellX}, ${issue.cellY}): ${issue.suggestion}`);
  * });
  */
-async function auditGridsetImages(gridsetBuffer, password = (0, password_2.resolveGridsetPasswordFromEnv)(), zipAdapter) {
+async function auditGridsetImages(gridsetBuffer, password = (0, password_2.resolveGridsetPasswordFromEnv)(), fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     const issues = [];
     const availableImages = new Set();
     let totalCells = 0;
@@ -34,9 +34,9 @@ async function auditGridsetImages(gridsetBuffer, password = (0, password_2.resol
     let resolvedImages = 0;
     let unresolvedImages = 0;
     try {
-        const { zip } = zipAdapter
+        const zip = zipAdapter
             ? await zipAdapter(gridsetBuffer)
-            : await (0, zip_1.openZipFromInput)(gridsetBuffer);
+            : await (0, zip_1.getZipAdapter)(gridsetBuffer, fileAdapter);
         const entries = (0, password_1.getZipEntriesFromAdapter)(zip, password);
         const parser = new fast_xml_parser_1.XMLParser();
         // Collect all image files in the gridset

package/dist/processors/gridset/password.d.ts

@@ -1,7 +1,7 @@
 import type JSZip from 'jszip';
 import { ProcessorOptions } from '../../core/baseProcessor';
 import { ProcessorInput } from '../../utils/io';
-import { type ZipAdapter } from '../../utils/zip';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:

package/dist/processors/gridset/symbolExtractor.d.ts

@@ -12,6 +12,8 @@
  *    c. For Tawasol: provide alternative sources
  */
 import { type SymbolReference } from './symbols';
+import { FileAdapter, ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Image extraction result
  */
@@ -50,14 +52,14 @@ export interface SymbolExtractionOptions {
  * @param options - Extraction options
  * @returns Extracted image data
  */
-export declare function extractButtonImage(gridsetBuffer: Buffer, resolvedImageEntry: string | undefined, symbolReference: string | undefined, options?: SymbolExtractionOptions): ExtractedImage;
+export declare function extractButtonImage(gridsetBuffer: Buffer, resolvedImageEntry: string | undefined, symbolReference: string | undefined, options?: SymbolExtractionOptions, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<ExtractedImage>;
 /**
  * Extract image from symbol library
  * @param reference - Symbol reference like "[tawasl]/food/apple.png"
  * @param options - Extraction options
  * @returns Extracted image or reference info
  */
-export declare function extractSymbolLibraryImage(reference: string, options?: SymbolExtractionOptions): ExtractedImage;
+export declare function extractSymbolLibraryImage(reference: string, options?: SymbolExtractionOptions): Promise<ExtractedImage>;
 /**
  * Convert extracted image to Asterics Grid format
  * @param extracted - Extracted image
@@ -95,7 +97,7 @@ export declare function suggestExtractionStrategy(report: SymbolReport): string;
 /**
  * Export symbol references to CSV for manual extraction
  */
-export declare function exportSymbolReferencesToCsv(report: SymbolReport, outputPath: string): void;
+export declare function exportSymbolReferencesToCsv(report: SymbolReport, outputPath: string, fileAdapter?: FileAdapter): Promise<void>;
 /**
  * Create a manifest file for missing symbols
  */

package/dist/processors/gridset/symbolExtractor.js

@@ -12,32 +12,6 @@
  *    b. Provide reference/URL for manual resolution
  *    c. For Tawasol: provide alternative sources
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractButtonImage = extractButtonImage;
 exports.extractSymbolLibraryImage = extractSymbolLibraryImage;
@@ -46,9 +20,9 @@ exports.analyzeSymbolExtraction = analyzeSymbolExtraction;
 exports.suggestExtractionStrategy = suggestExtractionStrategy;
 exports.exportSymbolReferencesToCsv = exportSymbolReferencesToCsv;
 exports.createSymbolManifest = createSymbolManifest;
-const fs = __importStar(require("fs"));
-const adm_zip_1 = __importDefault(require("adm-zip"));
 const symbols_1 = require("./symbols");
+const io_1 = require("../../utils/io");
+const zip_1 = require("../../utils/zip");
 /**
  * Known open-license symbol sources
  */
@@ -80,15 +54,17 @@ const OPEN_LICENSE_SYMBOLS = {
  * @param options - Extraction options
  * @returns Extracted image data
  */
-function extractButtonImage(gridsetBuffer, resolvedImageEntry, symbolReference, options = {}) {
+async function extractButtonImage(gridsetBuffer, resolvedImageEntry, symbolReference, options = {}, fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     // Priority 1: Use embedded image if available
     if (resolvedImageEntry && options.preferEmbedded !== false) {
         try {
-            const zip = new adm_zip_1.default(gridsetBuffer);
-            const entries = zip.getEntries();
-            const entry = entries.find((e) => e.entryName === resolvedImageEntry);
+            const zip = zipAdapter
+                ? await zipAdapter(gridsetBuffer)
+                : await (0, zip_1.getZipAdapter)(gridsetBuffer, fileAdapter);
+            const entries = zip.listFiles();
+            const entry = entries.find((e) => e === resolvedImageEntry);
             if (entry) {
-                const data = entry.getData();
+                const data = Buffer.from(await zip.readFile(entry));
                 const format = detectImageFormat(data);
                 return {
                     found: true,
@@ -105,7 +81,7 @@ function extractButtonImage(gridsetBuffer, resolvedImageEntry, symbolReference,
     }
     // Priority 2: Check symbol library reference
     if (symbolReference) {
-        return extractSymbolLibraryImage(symbolReference, options);
+        return await extractSymbolLibraryImage(symbolReference, options);
     }
     // Not found
     return {
@@ -119,7 +95,7 @@ function extractButtonImage(gridsetBuffer, resolvedImageEntry, symbolReference,
  * @param options - Extraction options
  * @returns Extracted image or reference info
  */
-function extractSymbolLibraryImage(reference, options = {}) {
+async function extractSymbolLibraryImage(reference, options = {}) {
     const ref = parseSymbolReferenceSafe(reference);
     if (!ref || !ref.isValid) {
         return {
@@ -131,7 +107,7 @@ function extractSymbolLibraryImage(reference, options = {}) {
     // Get library metadata
     const libInfo = OPEN_LICENSE_SYMBOLS[ref.library];
     // Resolve symbol reference and extract from .symbols file
-    const resolved = (0, symbols_1.resolveSymbolReference)(reference, {
+    const resolved = await (0, symbols_1.resolveSymbolReference)(reference, {
         grid3Path: options.grid3Path,
     });
     const metadata = {
@@ -310,12 +286,13 @@ function parseSymbolReferenceSafe(reference) {
 /**
  * Export symbol references to CSV for manual extraction
  */
-function exportSymbolReferencesToCsv(report, outputPath) {
+async function exportSymbolReferencesToCsv(report, outputPath, fileAdapter = io_1.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 || ''}"`);
     }
-    fs.writeFileSync(outputPath, lines.join('\n'));
+    await writeTextToPath(outputPath, lines.join('\n'));
 }
 function createSymbolManifest(tree, gridsetName) {
     const manifest = {

package/dist/processors/gridset/symbolSearch.d.ts

@@ -8,6 +8,7 @@
  * above bw=above bw.png=above bw
  * active family=active family.png=active family
  */
+import { FileAdapter } from '../../utils/io';
 /**
  * Symbol search result
  */
@@ -41,20 +42,20 @@ export interface LibrarySearchIndex {
  * @param pixFilePath - Path to .pix file
  * @returns Search index
  */
-export declare function parsePixFile(pixFilePath: string): LibrarySearchIndex;
+export declare function parsePixFile(pixFilePath: string, fileAdapter?: FileAdapter): Promise<LibrarySearchIndex>;
 /**
  * Load search indexes for all available libraries
  * @param options - Search options
  * @returns Map of library name to search index
  */
-export declare function loadSearchIndexes(options?: SymbolSearchOptions): Map<string, LibrarySearchIndex>;
+export declare function loadSearchIndexes(options?: SymbolSearchOptions, fileAdapter?: FileAdapter): Promise<Map<string, LibrarySearchIndex>>;
 /**
  * Search for symbols by term
  * @param searchTerm - Term to search for
  * @param options - Search options
  * @returns Array of search results
  */
-export declare function searchSymbols(searchTerm: string, options?: SymbolSearchOptions): SymbolSearchResult[];
+export declare function searchSymbols(searchTerm: string, options?: SymbolSearchOptions): Promise<SymbolSearchResult[]>;
 /**
  * Get symbol filename for a specific search term
  * @param searchTerm - Search term to look up
@@ -62,7 +63,7 @@ export declare function searchSymbols(searchTerm: string, options?: SymbolSearch
  * @param options - Search options
  * @returns Symbol filename or undefined
  */
-export declare function getSymbolFilename(searchTerm: string, library: string, options?: SymbolSearchOptions): string | undefined;
+export declare function getSymbolFilename(searchTerm: string, library: string, options?: SymbolSearchOptions): Promise<string | undefined>;
 /**
  * Get display name for a symbol filename
  * @param symbolFilename - Symbol filename (e.g., "above bw.png")
@@ -70,34 +71,34 @@ export declare function getSymbolFilename(searchTerm: string, library: string, o
  * @param options - Search options
  * @returns Display name or undefined
  */
-export declare function getSymbolDisplayName(symbolFilename: string, library: string, options?: SymbolSearchOptions): string | undefined;
+export declare function getSymbolDisplayName(symbolFilename: string, library: string, options?: SymbolSearchOptions): Promise<string | undefined>;
 /**
  * Get all search terms for a library
  * @param library - Library name
  * @param options - Search options
  * @returns Array of search terms
  */
-export declare function getAllSearchTerms(library: string, options?: SymbolSearchOptions): string[];
+export declare function getAllSearchTerms(library: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Search suggestions (autocomplete)
  * @param partialTerm - Partial search term
  * @param options - Search options
  * @returns Array of suggested terms
  */
-export declare function getSearchSuggestions(partialTerm: string, options?: SymbolSearchOptions): string[];
+export declare function getSearchSuggestions(partialTerm: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Search for symbols and return results with library references
  * @param searchTerm - Term to search for
  * @param options - Search options
  * @returns Array of full symbol references
  */
-export declare function searchSymbolsWithReferences(searchTerm: string, options?: SymbolSearchOptions): string[];
+export declare function searchSymbolsWithReferences(searchTerm: string, options?: SymbolSearchOptions): Promise<string[]>;
 /**
  * Count symbols in each library
  * @param options - Search options
  * @returns Map of library name to symbol count
  */
-export declare function countLibrarySymbols(options?: SymbolSearchOptions): Map<string, number>;
+export declare function countLibrarySymbols(options?: SymbolSearchOptions): Promise<Map<string, number>>;
 /**
  * Get statistics about symbol libraries
  */
@@ -114,4 +115,4 @@ export interface SymbolSearchStats {
  * @param options - Search options
  * @returns Statistics about available symbols
  */
-export declare function getSymbolSearchStats(options?: SymbolSearchOptions): SymbolSearchStats;
+export declare function getSymbolSearchStats(options?: SymbolSearchOptions): Promise<SymbolSearchStats>;