@willwade/aac-processors 0.1.20 → 0.2.0

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');
+async function parsePixFile(pixFilePath, fileAdapter = io_1.defaultFileAdapter) {
+    const { readTextFromInput, basename } = fileAdapter;
+    const content = await 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 = {}) {
+async 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 (!(await pathExists(searchIndexesDir))) {
         throw new Error(`Symbol search directory not found: ${searchIndexesDir}`);
     }
     const indexes = new Map();
-    const files = fs.readdirSync(searchIndexesDir);
+    const files = await 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,8 +79,8 @@ function loadSearchIndexes(options = {}) {
             }
         }
         try {
-            const pixFilePath = path.join(searchIndexesDir, file);
-            const index = parsePixFile(pixFilePath);
+            const pixFilePath = join(searchIndexesDir, file);
+            const index = await parsePixFile(pixFilePath);
             indexes.set(libraryName, index);
         }
         catch (error) {
@@ -117,8 +95,8 @@ function loadSearchIndexes(options = {}) {
  * @param options - Search options
  * @returns Array of search results
  */
-function searchSymbols(searchTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function searchSymbols(searchTerm, options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const results = [];
     const lowerSearchTerm = searchTerm.toLowerCase().trim();
     const limit = options.limit || 100;
@@ -171,8 +149,8 @@ function searchSymbols(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Symbol filename or undefined
  */
-function getSymbolFilename(searchTerm, library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getSymbolFilename(searchTerm, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -189,8 +167,8 @@ function getSymbolFilename(searchTerm, library, options = {}) {
  * @param options - Search options
  * @returns Display name or undefined
  */
-function getSymbolDisplayName(symbolFilename, library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getSymbolDisplayName(symbolFilename, library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -206,8 +184,8 @@ function getSymbolDisplayName(symbolFilename, library, options = {}) {
  * @param options - Search options
  * @returns Array of search terms
  */
-function getAllSearchTerms(library, options = {}) {
-    const indexes = loadSearchIndexes({
+async function getAllSearchTerms(library, options = {}) {
+    const indexes = await loadSearchIndexes({
         ...options,
         libraries: [library],
     });
@@ -223,8 +201,8 @@ function getAllSearchTerms(library, options = {}) {
  * @param options - Search options
  * @returns Array of suggested terms
  */
-function getSearchSuggestions(partialTerm, options = {}) {
-    const indexes = loadSearchIndexes(options);
+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()) {
@@ -242,8 +220,8 @@ function getSearchSuggestions(partialTerm, options = {}) {
  * @param options - Search options
  * @returns Array of full symbol references
  */
-function searchSymbolsWithReferences(searchTerm, options = {}) {
-    const results = searchSymbols(searchTerm, options);
+async function searchSymbolsWithReferences(searchTerm, options = {}) {
+    const results = await searchSymbols(searchTerm, options);
     return results.map((r) => `[${r.library}]${r.symbolFilename}`);
 }
 /**
@@ -251,8 +229,8 @@ function searchSymbolsWithReferences(searchTerm, options = {}) {
  * @param options - Search options
  * @returns Map of library name to symbol count
  */
-function countLibrarySymbols(options = {}) {
-    const indexes = loadSearchIndexes(options);
+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);
@@ -264,8 +242,8 @@ function countLibrarySymbols(options = {}) {
  * @param options - Search options
  * @returns Statistics about available symbols
  */
-function getSymbolSearchStats(options = {}) {
-    const indexes = loadSearchIndexes(options);
+async function getSymbolSearchStats(options = {}) {
+    const indexes = await loadSearchIndexes(options);
     const stats = {
         totalLibraries: indexes.size,
         totalSymbols: 0,

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): Promise<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): Promise<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): Promise<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

package/dist/processors/gridset/symbols.js

@@ -34,6 +34,7 @@ exports.symbolReferenceToFilename = symbolReferenceToFilename;
 exports.getSymbolsDir = getSymbolsDir;
 exports.getSymbolSearchDir = getSymbolSearchDir;
 const io_1 = require("../../utils/io");
+const zip_1 = require("../../utils/zip");
 /**
  * Default Grid 3 installation paths by platform
  */
@@ -76,38 +77,6 @@ exports.SYMBOL_LIBRARIES = {
  * Default locale to use
  */
 exports.DEFAULT_LOCALE = 'en-GB';
-function getNodeFs() {
-    try {
-        return (0, io_1.getFs)();
-    }
-    catch {
-        throw new Error('Symbol library access is not available in this environment.');
-    }
-}
-function getNodePath() {
-    try {
-        return (0, io_1.getPath)();
-    }
-    catch {
-        throw new Error('Path utilities are not available in this environment.');
-    }
-}
-let cachedAdmZip = null;
-function getAdmZip() {
-    if (cachedAdmZip)
-        return cachedAdmZip;
-    try {
-        const nodeRequire = (0, io_1.getNodeRequire)();
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const module = nodeRequire('adm-zip');
-        const resolved = module.default || module;
-        cachedAdmZip = resolved;
-        return resolved;
-    }
-    catch {
-        throw new Error('Symbol library access requires AdmZip in this environment.');
-    }
-}
 /**
  * Parse a symbol reference string
  * @param reference - Symbol reference like "[widgit]/food/apple.png"
@@ -145,12 +114,12 @@ function isSymbolReference(reference) {
  * Get the default Grid 3 installation path for the current platform
  * @returns Default Grid 3 path or empty string if not found
  */
-function getDefaultGrid3Path() {
+async function getDefaultGrid3Path(fileAdapter) {
+    const { pathExists } = fileAdapter ?? io_1.defaultFileAdapter;
     const platform = (typeof process !== 'undefined' && process.platform ? process.platform : 'unknown');
     const defaultPath = DEFAULT_GRID3_PATHS[platform] || '';
     try {
-        const fs = getNodeFs();
-        if (defaultPath && fs.existsSync(defaultPath)) {
+        if (defaultPath && (await pathExists(defaultPath))) {
             return defaultPath;
         }
         // Try to find Grid 3 in common locations
@@ -162,7 +131,7 @@ function getDefaultGrid3Path() {
             '/opt/smartbox/grid3',
         ];
         for (const testPath of commonPaths) {
-            if (fs.existsSync(testPath)) {
+            if (await pathExists(testPath)) {
                 return testPath;
             }
         }
@@ -178,9 +147,9 @@ function getDefaultGrid3Path() {
  * @param grid3Path - Grid 3 installation path
  * @returns Path to Symbol Libraries directory (e.g., "C:\...\Grid 3\Resources\Symbols")
  */
-function getSymbolLibrariesDir(grid3Path) {
-    const path = getNodePath();
-    return path.join(grid3Path, SYMBOLS_SUBDIR);
+function getSymbolLibrariesDir(grid3Path, fileAdapter = io_1.defaultFileAdapter) {
+    const { join } = fileAdapter;
+    return join(grid3Path, SYMBOLS_SUBDIR);
 }
 /**
  * Get the symbol search indexes directory path for a given locale
@@ -189,38 +158,37 @@ function getSymbolLibrariesDir(grid3Path) {
  * @param locale - Locale code (e.g., 'en-GB')
  * @returns Path to symbol search indexes directory (e.g., "C:\...\Grid 3\Locale\en-GB\symbolsearch")
  */
-function getSymbolSearchIndexesDir(grid3Path, locale = exports.DEFAULT_LOCALE) {
-    const path = getNodePath();
-    return path.join(grid3Path, SYMBOLSEARCH_SUBDIR, locale, 'symbolsearch');
+function getSymbolSearchIndexesDir(grid3Path, locale = exports.DEFAULT_LOCALE, fileAdapter = io_1.defaultFileAdapter) {
+    const { join } = fileAdapter;
+    return join(grid3Path, SYMBOLSEARCH_SUBDIR, locale, 'symbolsearch');
 }
 /**
  * Get all available symbol libraries in the Grid 3 installation
  * @param options - Resolution options
  * @returns Array of symbol library information
  */
-function getAvailableSymbolLibraries(options = {}) {
-    const grid3Path = options.grid3Path || options.symbolDir || getDefaultGrid3Path();
+async function getAvailableSymbolLibraries(options = {}, fileAdapter) {
+    const { pathExists, getFileSize, listDir, join, basename } = fileAdapter ?? io_1.defaultFileAdapter;
+    const grid3Path = options.grid3Path || options.symbolDir || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return [];
     }
-    const symbolsDir = getSymbolLibrariesDir(grid3Path);
-    const fs = getNodeFs();
-    if (!fs.existsSync(symbolsDir)) {
+    const symbolsDir = getSymbolLibrariesDir(grid3Path, fileAdapter);
+    if (!(await pathExists(symbolsDir))) {
         return [];
     }
     const libraries = [];
-    const files = fs.readdirSync(symbolsDir);
+    const files = await listDir(symbolsDir);
     for (const file of files) {
         if (file.endsWith('.symbols')) {
-            const path = getNodePath();
-            const fullPath = path.join(symbolsDir, file);
-            const stats = fs.statSync(fullPath);
-            const libraryName = path.basename(file, '.symbols');
+            const fullPath = join(symbolsDir, file);
+            const size = await getFileSize(fullPath);
+            const libraryName = basename(file, '.symbols');
             libraries.push({
                 name: libraryName,
                 pixFile: fullPath, // Reuse this field for the .symbols file path
                 exists: true,
-                size: stats.size,
+                size,
                 locale: 'global', // .symbols files are not locale-specific
             });
         }
@@ -233,12 +201,13 @@ function getAvailableSymbolLibraries(options = {}) {
  * @param options - Resolution options
  * @returns Symbol library info or undefined if not found
  */
-function getSymbolLibraryInfo(libraryName, options = {}) {
-    const grid3Path = options.grid3Path || options.symbolDir || getDefaultGrid3Path();
+async function getSymbolLibraryInfo(libraryName, options = {}, fileAdapter) {
+    const { pathExists, getFileSize, join } = fileAdapter ?? io_1.defaultFileAdapter;
+    const grid3Path = options.grid3Path || options.symbolDir || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return undefined;
     }
-    const symbolsDir = getSymbolLibrariesDir(grid3Path);
+    const symbolsDir = getSymbolLibrariesDir(grid3Path, fileAdapter);
     const normalizedLibName = libraryName.toLowerCase();
     // Try different case variations
     const variations = [
@@ -247,16 +216,14 @@ function getSymbolLibraryInfo(libraryName, options = {}) {
         libraryName + '.symbols',
     ];
     for (const file of variations) {
-        const path = getNodePath();
-        const fullPath = path.join(symbolsDir, file);
-        const fs = getNodeFs();
-        if (fs.existsSync(fullPath)) {
-            const stats = fs.statSync(fullPath);
+        const fullPath = join(symbolsDir, file);
+        if (await pathExists(fullPath)) {
+            const size = await getFileSize(fullPath);
             return {
                 name: libraryName,
                 pixFile: fullPath,
                 exists: true,
-                size: stats.size,
+                size,
                 locale: 'global',
             };
         }
@@ -269,7 +236,7 @@ function getSymbolLibraryInfo(libraryName, options = {}) {
  * @param options - Resolution options
  * @returns Resolution result with image data if found
  */
-function resolveSymbolReference(reference, options = {}) {
+async function resolveSymbolReference(reference, options = {}, fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     const parsed = parseSymbolReference(reference);
     if (!parsed.isValid) {
         return {
@@ -278,7 +245,7 @@ function resolveSymbolReference(reference, options = {}) {
             error: 'Invalid symbol reference format',
         };
     }
-    const grid3Path = options.grid3Path || getDefaultGrid3Path();
+    const grid3Path = options.grid3Path || (await getDefaultGrid3Path());
     if (!grid3Path) {
         return {
             reference: parsed,
@@ -286,7 +253,7 @@ function resolveSymbolReference(reference, options = {}) {
             error: 'Grid 3 installation not found. Please specify grid3Path.',
         };
     }
-    const libraryInfo = getSymbolLibraryInfo(parsed.library, { grid3Path });
+    const libraryInfo = await getSymbolLibraryInfo(parsed.library, { grid3Path });
     if (!libraryInfo || !libraryInfo.exists) {
         return {
             reference: parsed,
@@ -296,16 +263,16 @@ function resolveSymbolReference(reference, options = {}) {
     }
     try {
         // .symbols files are ZIP archives
-        const AdmZip = getAdmZip();
-        const zip = new AdmZip(libraryInfo.pixFile);
+        const zipFile = libraryInfo.pixFile;
+        const zip = zipAdapter ? await zipAdapter(zipFile) : await (0, zip_1.getZipAdapter)(zipFile, fileAdapter);
         // The path in the symbol reference becomes the path within the symbols/ folder
         // e.g., [tawasl]/above bw.png becomes symbols/above bw.png
         const symbolPath = `symbols/${parsed.path}`;
-        const entry = zip.getEntry(symbolPath);
+        const entry = await zip.readFile(symbolPath);
         if (!entry) {
             // Try without the symbols/ prefix (in case reference already includes it)
             const altPath = parsed.path.startsWith('symbols/') ? parsed.path : `symbols/${parsed.path}`;
-            const altEntry = zip.getEntry(altPath);
+            const altEntry = await zip.readFile(altPath);
             if (!altEntry) {
                 return {
                     reference: parsed,
@@ -316,7 +283,7 @@ function resolveSymbolReference(reference, options = {}) {
                 };
             }
             // Found with alternate path
-            const data = altEntry.getData();
+            const data = Buffer.from(altEntry);
             return {
                 reference: parsed,
                 found: true,
@@ -326,7 +293,7 @@ function resolveSymbolReference(reference, options = {}) {
             };
         }
         // Found the symbol!
-        const data = entry.getData();
+        const data = Buffer.from(entry);
         return {
             reference: parsed,
             found: true,

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

@@ -8,8 +8,8 @@
  * Note: Wordlists are only supported in Grid3 format. Other AAC formats
  * do not have equivalent wordlist functionality.
  */
-import { type ZipAdapter } from '../../utils/zip';
-import { type ProcessorInput } from '../../utils/io';
+import { FileAdapter, type ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Represents a single item in a wordlist
  */
@@ -66,9 +66,7 @@ export declare function wordlistToXml(wordlist: WordList): string;
  *   console.log(`Grid "${gridName}" has ${wordlist.items.length} items`);
  * });
  */
-export declare function extractWordlists(gridsetBuffer: Uint8Array, password?: string | undefined, zipAdapter?: (input: ProcessorInput) => Promise<{
-    zip: ZipAdapter;
-}>): Promise<Map<string, WordList>>;
+export declare function extractWordlists(gridsetBuffer: Uint8Array, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<Map<string, WordList>>;
 /**
  * Updates or adds a wordlist to a specific grid in a gridset
  *
@@ -83,4 +81,4 @@ export declare function extractWordlists(gridsetBuffer: Uint8Array, password?: s
  * const updatedGridset = updateWordlist(gridsetBuffer, 'Greetings', newWordlist);
  * fs.writeFileSync('updated-gridset.gridset', updatedGridset);
  */
-export declare function updateWordlist(gridsetBuffer: Uint8Array, gridName: string, wordlist: WordList, password?: string | undefined): Promise<Uint8Array>;
+export declare function updateWordlist(gridsetBuffer: Uint8Array, gridName: string, wordlist: WordList, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<Uint8Array>;

package/dist/processors/gridset/wordlistHelpers.js

@@ -9,29 +9,6 @@
  * Note: Wordlists are only supported in Grid3 format. Other AAC formats
  * do not have equivalent wordlist functionality.
  */
-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.createWordlist = createWordlist;
 exports.wordlistToXml = wordlistToXml;
@@ -39,9 +16,9 @@ exports.extractWordlists = extractWordlists;
 exports.updateWordlist = updateWordlist;
 const fast_xml_parser_1 = require("fast-xml-parser");
 const password_1 = require("./password");
-const zip_1 = require("../../utils/zip");
 const io_1 = require("../../utils/io");
 const io_2 = require("../../utils/io");
+const zip_1 = require("../../utils/zip");
 /**
  * Creates a WordList object from an array of words/phrases or a dictionary
  *
@@ -127,13 +104,13 @@ function wordlistToXml(wordlist) {
  *   console.log(`Grid "${gridName}" has ${wordlist.items.length} items`);
  * });
  */
-async function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridsetPasswordFromEnv)(), zipAdapter) {
+async function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridsetPasswordFromEnv)(), fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     const wordlists = new Map();
     const parser = new fast_xml_parser_1.XMLParser();
     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);
         // Process each grid file
         for (const entry of entries) {
@@ -194,7 +171,7 @@ async function extractWordlists(gridsetBuffer, password = (0, password_1.resolve
  * const updatedGridset = updateWordlist(gridsetBuffer, 'Greetings', newWordlist);
  * fs.writeFileSync('updated-gridset.gridset', updatedGridset);
  */
-async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
+async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0, password_1.resolveGridsetPasswordFromEnv)(), fileAdapter = io_1.defaultFileAdapter, zipAdapter) {
     const parser = new fast_xml_parser_1.XMLParser();
     const builder = new fast_xml_parser_1.XMLBuilder({
         ignoreAttributes: false,
@@ -202,45 +179,11 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
         indentBy: '  ',
         suppressEmptyNode: false,
     });
-    let entries;
-    let saveZip = null;
-    let updateEntry = null;
-    try {
-        if ((0, io_1.isNodeRuntime)()) {
-            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
-            const zip = new AdmZip(Buffer.from(gridsetBuffer));
-            entries = zip.getEntries().map((entry) => ({
-                entryName: entry.entryName,
-                getData: () => Promise.resolve(entry.getData()),
-            }));
-            updateEntry = (entryName, xml) => {
-                zip.addFile(entryName, Buffer.from(xml, 'utf8'));
-            };
-            saveZip = () => Promise.resolve(zip.toBuffer());
-        }
-        else {
-            const module = await Promise.resolve().then(() => __importStar(require('jszip')));
-            const JSZip = module.default || module;
-            const zip = await JSZip.loadAsync(gridsetBuffer);
-            entries = (0, password_1.getZipEntriesFromAdapter)({
-                listFiles: () => Object.keys(zip.files),
-                readFile: async (name) => {
-                    const file = zip.file(name);
-                    if (!file) {
-                        throw new Error(`Zip entry not found: ${name}`);
-                    }
-                    return file.async('uint8array');
-                },
-            }, password);
-            updateEntry = (entryName, xml) => {
-                zip.file(entryName, xml, { binary: false });
-            };
-            saveZip = async () => zip.generateAsync({ type: 'uint8array' });
-        }
-    }
-    catch (error) {
-        throw new Error(`Invalid gridset buffer: ${error.message}`);
-    }
+    const updatedEntries = [];
+    const zip = zipAdapter
+        ? await zipAdapter(gridsetBuffer)
+        : await (0, zip_1.getZipAdapter)(gridsetBuffer, fileAdapter);
+    const entries = (0, password_1.getZipEntriesFromAdapter)(zip, password);
     let found = false;
     // Find and update the grid
     for (const entry of entries) {
@@ -275,9 +218,10 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
                     };
                     // Rebuild the XML
                     const updatedXml = builder.build(data);
-                    if (updateEntry) {
-                        updateEntry(entry.entryName, updatedXml);
-                    }
+                    updatedEntries.push({
+                        name: entry.entryName,
+                        data: updatedXml,
+                    });
                     found = true;
                 }
                 catch (error) {
@@ -290,8 +234,5 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
     if (!found) {
         throw new Error(`Grid "${gridName}" not found in gridset`);
     }
-    if (!saveZip) {
-        throw new Error('Failed to serialize updated gridset.');
-    }
-    return await saveZip();
+    return await zip.writeFiles(updatedEntries);
 }

package/dist/processors/gridsetProcessor.d.ts

@@ -30,7 +30,7 @@ declare class GridsetProcessor extends BaseProcessor {
      * This method uses shared translation utilities that work across all AAC formats.
      *
      * @param filePathOrBuffer - Path to gridset file or buffer
-     * @returns Array of symbol information for LLM processing
+     * @returns Promise resolving to symbol information for LLM processing
      */
     extractSymbolsForLLM(filePathOrBuffer: string | Buffer): Promise<ButtonForTranslation[]>;
     /**
@@ -43,7 +43,7 @@ declare class GridsetProcessor extends BaseProcessor {
      * @param llmTranslations - Array of LLM translations with symbol info
      * @param outputPath - Where to save the translated gridset
      * @param options - Translation options (e.g., allowPartial for testing)
-     * @returns Buffer of the translated gridset
+     * @returns Promise resolving to a buffer of the translated gridset
      */
     processLLMTranslations(filePathOrBuffer: string | Buffer, llmTranslations: LLMLTranslationResult[], outputPath: string, options?: {
         allowPartial?: boolean;