@willwade/aac-processors 0.1.19 → 0.1.21

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() {
+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 (!pathExists(grid3BasePath)) {
             return results;
         }
         // Enumerate users
-        const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+        const users = listDir(grid3BasePath);
         for (const userDir of users) {
-            if (!userDir.isDirectory())
+            if (!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 = listDir(userPath);
             for (const langDir of langDirs) {
-                if (!langDir.isDirectory())
+                if (!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 (pathExists(historyDbPath)) {
                     results.push({
                         userName,
                         langCode,
@@ -266,8 +240,8 @@ 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);
+function findGrid3HistoryDatabases(fileAdapter) {
+    return findGrid3UserPaths(fileAdapter).map((userPath) => userPath.historyDbPath);
 }
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
@@ -280,36 +254,37 @@ function findGrid3Users() {
  * @param userName Optional user filter; matches case-insensitively
  * @returns Array of user/gridset path pairs
  */
-function findGrid3Vocabularies(userName) {
+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 (!pathExists(grid3BasePath)) {
         return results;
     }
     const normalizedUser = userName?.toLowerCase();
-    const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+    const users = listDir(grid3BasePath);
     for (const userDir of users) {
-        if (!userDir.isDirectory())
+        if (!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 (!pathExists(gridSetsDir))
             continue;
-        const entries = fs.readdirSync(gridSetsDir, { withFileTypes: true });
+        const entries = listDir(gridSetsDir);
         for (const entry of entries) {
-            if (!entry.isFile())
+            if (!pathExists(entry) || 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 +297,27 @@ 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) {
+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 match = findGrid3UserPaths(fileAdapter).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() {
+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 pathExists(grid3BasePath);
 }
 function parseGrid3ContentXml(xmlContent) {
     const regex = /<r>(?:<!\[CDATA\[)?(.*?)(?:\]\]>)?<\/r>/gis;
@@ -360,10 +336,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))
+function readGrid3History(historyDbPath, fileAdapter = io_1.defaultFileAdapter) {
+    const { pathExists } = fileAdapter;
+    if (!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,

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): 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) {
+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'));
+    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,13 +42,13 @@ 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): 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): Map<string, LibrarySearchIndex>;
 /**
  * Search for symbols by term
  * @param searchTerm - Term to search for

package/dist/processors/gridset/symbolSearch.js

@@ -9,29 +9,6 @@
  * above bw=above bw.png=above bw
  * active family=active family.png=active family
  */
-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;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePixFile = parsePixFile;
 exports.loadSearchIndexes = loadSearchIndexes;
@@ -43,16 +20,16 @@ exports.getSearchSuggestions = getSearchSuggestions;
 exports.searchSymbolsWithReferences = searchSymbolsWithReferences;
 exports.countLibrarySymbols = countLibrarySymbols;
 exports.getSymbolSearchStats = getSymbolSearchStats;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const io_1 = require("../../utils/io");
 /**
  * Parse a .pix file into search index
  * @param pixFilePath - Path to .pix file
  * @returns Search index
  */
-function parsePixFile(pixFilePath) {
-    const content = fs.readFileSync(pixFilePath, 'utf-8');
-    const library = path.basename(pixFilePath, '.pix');
+function parsePixFile(pixFilePath, fileAdapter = io_1.defaultFileAdapter) {
+    const { readTextFromInput, basename } = fileAdapter;
+    const content = readTextFromInput(pixFilePath);
+    const library = basename(pixFilePath, '.pix');
     const searchTerms = new Map();
     const filenames = new Map();
     const lines = content.split('\n');
@@ -78,22 +55,23 @@ function parsePixFile(pixFilePath) {
  * @param options - Search options
  * @returns Map of library name to search index
  */
-function loadSearchIndexes(options = {}) {
+function loadSearchIndexes(options = {}, fileAdapter = io_1.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 = path.join(grid3Path, 'Locale', locale, 'symbolsearch');
-    if (!fs.existsSync(searchIndexesDir)) {
+    const searchIndexesDir = join(grid3Path, 'Locale', locale, 'symbolsearch');
+    if (!pathExists(searchIndexesDir)) {
         throw new Error(`Symbol search directory not found: ${searchIndexesDir}`);
     }
     const indexes = new Map();
-    const files = fs.readdirSync(searchIndexesDir);
+    const files = listDir(searchIndexesDir);
     for (const file of files) {
         if (!file.endsWith('.pix')) {
             continue;
         }
-        const libraryName = path.basename(file, '.pix');
+        const libraryName = basename(file, '.pix');
         // Filter libraries if specified
         if (specifiedLibs && specifiedLibs.length > 0) {
             if (!specifiedLibs.some((lib) => lib.toLowerCase() === libraryName.toLowerCase())) {
@@ -101,7 +79,7 @@ function loadSearchIndexes(options = {}) {
             }
         }
         try {
-            const pixFilePath = path.join(searchIndexesDir, file);
+            const pixFilePath = join(searchIndexesDir, file);
             const index = parsePixFile(pixFilePath);
             indexes.set(libraryName, index);
         }

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

@@ -12,6 +12,8 @@
  *
  * This module provides symbol resolution and metadata extraction.
  */
+import { FileAdapter, ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Known symbol libraries in Grid 3
  */
@@ -92,14 +94,14 @@ export declare function isSymbolReference(reference: string): boolean;
  * Get the default Grid 3 installation path for the current platform
  * @returns Default Grid 3 path or empty string if not found
  */
-export declare function getDefaultGrid3Path(): string;
+export declare function getDefaultGrid3Path(fileAdapter?: FileAdapter): string;
 /**
  * Get the Symbol Libraries directory path
  * Contains .symbols ZIP archives with actual image files
  * @param grid3Path - Grid 3 installation path
  * @returns Path to Symbol Libraries directory (e.g., "C:\...\Grid 3\Resources\Symbols")
  */
-export declare function getSymbolLibrariesDir(grid3Path: string): string;
+export declare function getSymbolLibrariesDir(grid3Path: string, fileAdapter?: FileAdapter): string;
 /**
  * Get the symbol search indexes directory path for a given locale
  * Contains .pix index files for searching symbols
@@ -107,27 +109,27 @@ export declare function getSymbolLibrariesDir(grid3Path: string): string;
  * @param locale - Locale code (e.g., 'en-GB')
  * @returns Path to symbol search indexes directory (e.g., "C:\...\Grid 3\Locale\en-GB\symbolsearch")
  */
-export declare function getSymbolSearchIndexesDir(grid3Path: string, locale?: string): string;
+export declare function getSymbolSearchIndexesDir(grid3Path: string, locale?: string, fileAdapter?: FileAdapter): string;
 /**
  * Get all available symbol libraries in the Grid 3 installation
  * @param options - Resolution options
  * @returns Array of symbol library information
  */
-export declare function getAvailableSymbolLibraries(options?: SymbolResolutionOptions): SymbolLibraryInfo[];
+export declare function getAvailableSymbolLibraries(options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): SymbolLibraryInfo[];
 /**
  * Check if a symbol library exists
  * @param libraryName - Name of the library (e.g., 'widgit', 'tawasl')
  * @param options - Resolution options
  * @returns Symbol library info or undefined if not found
  */
-export declare function getSymbolLibraryInfo(libraryName: string, options?: SymbolResolutionOptions): SymbolLibraryInfo | undefined;
+export declare function getSymbolLibraryInfo(libraryName: string, options?: SymbolResolutionOptions, fileAdapter?: FileAdapter): SymbolLibraryInfo | undefined;
 /**
  * Resolve a symbol reference to extract the actual image data
  * @param reference - Symbol reference like "[tawasl]/above bw.png"
  * @param options - Resolution options
  * @returns Resolution result with image data if found
  */
-export declare function resolveSymbolReference(reference: string, options?: SymbolResolutionOptions): SymbolResolutionResult;
+export declare function resolveSymbolReference(reference: string, options?: SymbolResolutionOptions, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<SymbolResolutionResult>;
 /**
  * Get all symbol references from a gridset
  * This scans button images for symbol references