@willwade/aac-processors 0.1.5 → 0.1.6

package/dist/index.browser.js

@@ -7,6 +7,10 @@
  * **NOTE: Gridset .gridsetx files**
  * GridsetProcessor supports regular `.gridset` files in browser.
  * Encrypted `.gridsetx` files require Node.js for crypto operations and are not supported in browser.
+ *
+ * **NOTE: SQLite-backed formats**
+ * Snap (.sps/.spb) and TouchChat (.ce) require a WASM-backed SQLite engine.
+ * Configure `sql.js` in browser builds via `configureSqlJs()` before loading these formats.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -23,7 +27,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AstericsGridProcessor = exports.ApplePanelsProcessor = exports.GridsetProcessor = exports.ObfProcessor = exports.OpmlProcessor = exports.DotProcessor = void 0;
+exports.configureSqlJs = exports.AstericsGridProcessor = exports.ApplePanelsProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.GridsetProcessor = exports.ObfProcessor = exports.OpmlProcessor = exports.DotProcessor = void 0;
 exports.getProcessor = getProcessor;
 exports.getSupportedExtensions = getSupportedExtensions;
 exports.isExtensionSupported = isExtensionSupported;
@@ -44,6 +48,10 @@ var obfProcessor_1 = require("./processors/obfProcessor");
 Object.defineProperty(exports, "ObfProcessor", { enumerable: true, get: function () { return obfProcessor_1.ObfProcessor; } });
 var gridsetProcessor_1 = require("./processors/gridsetProcessor");
 Object.defineProperty(exports, "GridsetProcessor", { enumerable: true, get: function () { return gridsetProcessor_1.GridsetProcessor; } });
+var snapProcessor_1 = require("./processors/snapProcessor");
+Object.defineProperty(exports, "SnapProcessor", { enumerable: true, get: function () { return snapProcessor_1.SnapProcessor; } });
+var touchchatProcessor_1 = require("./processors/touchchatProcessor");
+Object.defineProperty(exports, "TouchChatProcessor", { enumerable: true, get: function () { return touchchatProcessor_1.TouchChatProcessor; } });
 var applePanelsProcessor_1 = require("./processors/applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var astericsGridProcessor_1 = require("./processors/astericsGridProcessor");
@@ -52,8 +60,12 @@ const dotProcessor_2 = require("./processors/dotProcessor");
 const opmlProcessor_2 = require("./processors/opmlProcessor");
 const obfProcessor_2 = require("./processors/obfProcessor");
 const gridsetProcessor_2 = require("./processors/gridsetProcessor");
+const snapProcessor_2 = require("./processors/snapProcessor");
+const touchchatProcessor_2 = require("./processors/touchchatProcessor");
 const applePanelsProcessor_2 = require("./processors/applePanelsProcessor");
 const astericsGridProcessor_2 = require("./processors/astericsGridProcessor");
+var sqlite_1 = require("./utils/sqlite");
+Object.defineProperty(exports, "configureSqlJs", { enumerable: true, get: function () { return sqlite_1.configureSqlJs; } });
 /**
  * Factory function to get the appropriate processor for a file extension
  * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')
@@ -74,6 +86,11 @@ function getProcessor(filePathOrExtension) {
             return new obfProcessor_2.ObfProcessor();
         case '.gridset':
             return new gridsetProcessor_2.GridsetProcessor();
+        case '.spb':
+        case '.sps':
+            return new snapProcessor_2.SnapProcessor();
+        case '.ce':
+            return new touchchatProcessor_2.TouchChatProcessor();
         case '.plist':
             return new applePanelsProcessor_2.ApplePanelsProcessor();
         case '.grd':
@@ -87,7 +104,7 @@ function getProcessor(filePathOrExtension) {
  * @returns Array of supported file extensions
  */
 function getSupportedExtensions() {
-    return ['.dot', '.opml', '.obf', '.obz', '.gridset', '.plist', '.grd'];
+    return ['.dot', '.opml', '.obf', '.obz', '.gridset', '.spb', '.sps', '.ce', '.plist', '.grd'];
 }
 /**
  * Check if a file extension is supported

package/dist/processors/gridset/helpers.js

@@ -50,6 +50,7 @@ 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 zip_1 = require("../../utils/zip");
 function normalizeZipPath(p) {
     const unified = p.replace(/\\/g, '/');
     try {
@@ -97,10 +98,8 @@ function getAllowedImageEntries(tree) {
  */
 async function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
     try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const JSZip = require('jszip');
-        const zip = await JSZip.loadAsync(gridsetBuffer);
-        const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
+        const { zip } = await (0, zip_1.openZipFromInput)(gridsetBuffer);
+        const entries = (0, password_1.getZipEntriesFromAdapter)(zip, password);
         const want = normalizeZipPath(entryPath);
         const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
         if (!entry)

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

@@ -15,7 +15,7 @@ import { CellBackgroundShape } from './styleHelpers';
 import { Grid3CellType } from './pluginTypes';
 import { Grid3CommandCategory } from './commands';
 export { ensureAlphaChannel, darkenColor, lightenColor, hexToRgba, rgbaToHex } from './colorUtils';
-export { resolveGridsetPassword, getZipEntriesWithPassword, resolveGridsetPasswordFromEnv, } from './password';
+export { resolveGridsetPassword, getZipEntriesWithPassword, getZipEntriesFromAdapter, resolveGridsetPasswordFromEnv, } from './password';
 export { getPageTokenImageMap, getAllowedImageEntries, openImage, generateGrid3Guid, createSettingsXml, createFileMapXml, getCommonDocumentsPath, findGrid3UserPaths, findGrid3HistoryDatabases, findGrid3Vocabularies, findGrid3UserHistory, findGrid3Users, isGrid3Installed, readGrid3History, readGrid3HistoryForUser, readAllGrid3History, type Grid3UserPath, type Grid3VocabularyPath, type Grid3HistoryEntry, } from './helpers';
 export { parseSymbolReference, isSymbolReference, resolveSymbolReference, getAvailableSymbolLibraries, getSymbolLibraryInfo, extractSymbolReferences, analyzeSymbolUsage, createSymbolReference, getSymbolLibraryName, getSymbolPath, isKnownSymbolLibrary, getSymbolLibraryDisplayName, getDefaultGrid3Path, getSymbolLibrariesDir, getSymbolSearchIndexesDir, symbolReferenceToFilename, SYMBOL_LIBRARIES, type SymbolReference, type SymbolLibraryInfo, type SymbolResolutionOptions, type SymbolResolutionResult, type SymbolUsageStats, type SymbolLibraryName, } from './symbols';
 export { getSymbolsDir, getSymbolSearchDir } from './symbols';

package/dist/processors/gridset/index.js

@@ -10,8 +10,8 @@
  * - Image resolution helpers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseSymbolReference = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3Users = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.resolveGridsetPasswordFromEnv = exports.getZipEntriesWithPassword = exports.resolveGridsetPassword = exports.rgbaToHex = exports.hexToRgba = exports.lightenColor = exports.darkenColor = exports.ensureAlphaChannel = exports.Grid3CommandCategory = exports.GRID3_COMMANDS = exports.extractCommandParameters = exports.getAllPluginIds = exports.getAllCommandIds = exports.getCommandsByCategory = exports.getCommandsByPlugin = exports.getCommandDefinition = exports.detectCommand = exports.isRegularCell = exports.isAutoContentCell = exports.isLiveCell = exports.isWorkspaceCell = exports.getCellTypeDisplayName = exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = exports.detectPluginCellType = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.SHAPE_NAMES = exports.CellBackgroundShape = void 0;
-exports.GRID3_COMMAND_CATEGORIES = exports.GRID3_CELL_TYPES = exports.GRID3_CELL_SHAPES = exports.GRID3_PLUGIN_IDS = exports.GRID3_COMMAND_IDS = exports.getSymbolSearchStats = exports.countLibrarySymbols = exports.getSearchSuggestions = exports.getAllSearchTerms = exports.getSymbolDisplayName = exports.getSymbolFilename = exports.searchSymbolsWithReferences = exports.searchSymbols = exports.loadSearchIndexes = exports.parsePixFile = exports.createSymbolManifest = exports.exportSymbolReferencesToCsv = exports.suggestExtractionStrategy = exports.analyzeSymbolExtraction = exports.convertToAstericsImage = exports.extractSymbolLibraryImage = exports.extractButtonImage = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = exports.resolveGrid3CellImage = exports.getSymbolSearchDir = exports.getSymbolsDir = exports.SYMBOL_LIBRARIES = exports.symbolReferenceToFilename = exports.getSymbolSearchIndexesDir = exports.getSymbolLibrariesDir = exports.getDefaultGrid3Path = exports.getSymbolLibraryDisplayName = exports.isKnownSymbolLibrary = exports.getSymbolPath = exports.getSymbolLibraryName = exports.createSymbolReference = exports.analyzeSymbolUsage = exports.extractSymbolReferences = exports.getSymbolLibraryInfo = exports.getAvailableSymbolLibraries = exports.resolveSymbolReference = exports.isSymbolReference = void 0;
+exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3Users = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.resolveGridsetPasswordFromEnv = exports.getZipEntriesFromAdapter = exports.getZipEntriesWithPassword = exports.resolveGridsetPassword = exports.rgbaToHex = exports.hexToRgba = exports.lightenColor = exports.darkenColor = exports.ensureAlphaChannel = exports.Grid3CommandCategory = exports.GRID3_COMMANDS = exports.extractCommandParameters = exports.getAllPluginIds = exports.getAllCommandIds = exports.getCommandsByCategory = exports.getCommandsByPlugin = exports.getCommandDefinition = exports.detectCommand = exports.isRegularCell = exports.isAutoContentCell = exports.isLiveCell = exports.isWorkspaceCell = exports.getCellTypeDisplayName = exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = exports.detectPluginCellType = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.SHAPE_NAMES = exports.CellBackgroundShape = void 0;
+exports.GRID3_COMMAND_CATEGORIES = exports.GRID3_CELL_TYPES = exports.GRID3_CELL_SHAPES = exports.GRID3_PLUGIN_IDS = exports.GRID3_COMMAND_IDS = exports.getSymbolSearchStats = exports.countLibrarySymbols = exports.getSearchSuggestions = exports.getAllSearchTerms = exports.getSymbolDisplayName = exports.getSymbolFilename = exports.searchSymbolsWithReferences = exports.searchSymbols = exports.loadSearchIndexes = exports.parsePixFile = exports.createSymbolManifest = exports.exportSymbolReferencesToCsv = exports.suggestExtractionStrategy = exports.analyzeSymbolExtraction = exports.convertToAstericsImage = exports.extractSymbolLibraryImage = exports.extractButtonImage = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = exports.resolveGrid3CellImage = exports.getSymbolSearchDir = exports.getSymbolsDir = exports.SYMBOL_LIBRARIES = exports.symbolReferenceToFilename = exports.getSymbolSearchIndexesDir = exports.getSymbolLibrariesDir = exports.getDefaultGrid3Path = exports.getSymbolLibraryDisplayName = exports.isKnownSymbolLibrary = exports.getSymbolPath = exports.getSymbolLibraryName = exports.createSymbolReference = exports.analyzeSymbolUsage = exports.extractSymbolReferences = exports.getSymbolLibraryInfo = exports.getAvailableSymbolLibraries = exports.resolveSymbolReference = exports.isSymbolReference = exports.parseSymbolReference = void 0;
 // Style helpers
 var styleHelpers_1 = require("./styleHelpers");
 Object.defineProperty(exports, "CellBackgroundShape", { enumerable: true, get: function () { return styleHelpers_1.CellBackgroundShape; } });
@@ -59,6 +59,7 @@ Object.defineProperty(exports, "rgbaToHex", { enumerable: true, get: function ()
 var password_1 = require("./password");
 Object.defineProperty(exports, "resolveGridsetPassword", { enumerable: true, get: function () { return password_1.resolveGridsetPassword; } });
 Object.defineProperty(exports, "getZipEntriesWithPassword", { enumerable: true, get: function () { return password_1.getZipEntriesWithPassword; } });
+Object.defineProperty(exports, "getZipEntriesFromAdapter", { enumerable: true, get: function () { return password_1.getZipEntriesFromAdapter; } });
 Object.defineProperty(exports, "resolveGridsetPasswordFromEnv", { enumerable: true, get: function () { return password_1.resolveGridsetPasswordFromEnv; } });
 // Helper functions
 var helpers_1 = require("./helpers");

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

@@ -1,6 +1,7 @@
 import type JSZip from 'jszip';
 import { ProcessorOptions } from '../../core/baseProcessor';
 import { ProcessorInput } from '../../utils/io';
+import { type ZipAdapter } from '../../utils/zip';
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
@@ -18,11 +19,11 @@ export declare function resolveGridsetPasswordFromEnv(): string | undefined;
  * @param password - Optional password (kept for API compatibility, not used with JSZip)
  * @returns Array of entry objects with name and data
  */
-type ZipEntry = {
+export type ZipEntry = {
     name: string;
     entryName: string;
     dir: boolean;
     getData: () => Promise<Uint8Array>;
 };
 export declare function getZipEntriesWithPassword(zip: JSZip, password?: string): ZipEntry[];
-export {};
+export declare function getZipEntriesFromAdapter(zip: ZipAdapter, password?: string): ZipEntry[];

package/dist/processors/gridset/password.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveGridsetPassword = resolveGridsetPassword;
 exports.resolveGridsetPasswordFromEnv = resolveGridsetPasswordFromEnv;
 exports.getZipEntriesWithPassword = getZipEntriesWithPassword;
+exports.getZipEntriesFromAdapter = getZipEntriesFromAdapter;
 function getExtension(source) {
     const index = source.lastIndexOf('.');
     if (index === -1)
@@ -52,3 +53,14 @@ function getZipEntriesWithPassword(zip, password) {
     });
     return entries;
 }
+function getZipEntriesFromAdapter(zip, password) {
+    if (password) {
+        console.warn('Zip password support is handled at the archive level for .gridsetx files.');
+    }
+    return zip.listFiles().map((entryName) => ({
+        name: entryName,
+        entryName,
+        dir: false,
+        getData: () => zip.readFile(entryName),
+    }));
+}

package/dist/processors/gridset/wordlistHelpers.js

@@ -9,6 +9,29 @@
  * 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;
@@ -16,7 +39,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");
 /**
  * Creates a WordList object from an array of words/phrases or a dictionary
  *
@@ -105,55 +130,52 @@ function wordlistToXml(wordlist) {
 async function extractWordlists(gridsetBuffer, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
     const wordlists = new Map();
     const parser = new fast_xml_parser_1.XMLParser();
-    let zip;
     try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const JSZip = require('jszip');
-        zip = await JSZip.loadAsync(gridsetBuffer);
-    }
-    catch (error) {
-        throw new Error(`Invalid gridset buffer: ${error.message}`);
-    }
-    const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
-    // Process each grid file
-    for (const entry of entries) {
-        if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
-            try {
-                const xmlContent = (0, io_1.decodeText)(await entry.getData());
-                const data = parser.parse(xmlContent);
-                const grid = data.Grid || data.grid;
-                if (!grid || !grid.WordList) {
-                    continue;
-                }
-                // Extract grid name from path (e.g., "Grids/MyGrid/grid.xml" -> "MyGrid")
-                const match = entry.entryName.match(/^Grids\/([^/]+)\//);
-                const gridName = match ? match[1] : entry.entryName;
-                // Parse wordlist items
-                const wordlistData = grid.WordList;
-                const itemsContainer = wordlistData.Items || wordlistData.items;
-                if (!itemsContainer) {
-                    continue;
+        const { zip } = await (0, zip_1.openZipFromInput)(gridsetBuffer);
+        const entries = (0, password_1.getZipEntriesFromAdapter)(zip, password);
+        // Process each grid file
+        for (const entry of entries) {
+            if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
+                try {
+                    const xmlContent = (0, io_2.decodeText)(await entry.getData());
+                    const data = parser.parse(xmlContent);
+                    const grid = data.Grid || data.grid;
+                    if (!grid || !grid.WordList) {
+                        continue;
+                    }
+                    // Extract grid name from path (e.g., "Grids/MyGrid/grid.xml" -> "MyGrid")
+                    const match = entry.entryName.match(/^Grids\/([^/]+)\//);
+                    const gridName = match ? match[1] : entry.entryName;
+                    // Parse wordlist items
+                    const wordlistData = grid.WordList;
+                    const itemsContainer = wordlistData.Items || wordlistData.items;
+                    if (!itemsContainer) {
+                        continue;
+                    }
+                    const itemArray = Array.isArray(itemsContainer.WordListItem)
+                        ? itemsContainer.WordListItem
+                        : itemsContainer.WordListItem
+                            ? [itemsContainer.WordListItem]
+                            : [];
+                    const items = itemArray.map((item) => ({
+                        text: item.Text?.s?.r || item.text?.s?.r || '',
+                        image: item.Image || item.image || undefined,
+                        partOfSpeech: item.PartOfSpeech || item.partOfSpeech || 'Unknown',
+                    }));
+                    if (items.length > 0) {
+                        wordlists.set(gridName, { items });
+                    }
                 }
-                const itemArray = Array.isArray(itemsContainer.WordListItem)
-                    ? itemsContainer.WordListItem
-                    : itemsContainer.WordListItem
-                        ? [itemsContainer.WordListItem]
-                        : [];
-                const items = itemArray.map((item) => ({
-                    text: item.Text?.s?.r || item.text?.s?.r || '',
-                    image: item.Image || item.image || undefined,
-                    partOfSpeech: item.PartOfSpeech || item.partOfSpeech || 'Unknown',
-                }));
-                if (items.length > 0) {
-                    wordlists.set(gridName, { items });
+                catch (error) {
+                    // Skip grids with parsing errors
+                    console.warn(`Failed to extract wordlist from ${entry.entryName}:`, error);
                 }
             }
-            catch (error) {
-                // Skip grids with parsing errors
-                console.warn(`Failed to extract wordlist from ${entry.entryName}:`, error);
-            }
         }
     }
+    catch (error) {
+        throw new Error(`Invalid gridset buffer: ${error.message}`);
+    }
     return wordlists;
 }
 /**
@@ -178,16 +200,45 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
         indentBy: '  ',
         suppressEmptyNode: false,
     });
-    let zip;
+    let entries;
+    let saveZip = null;
+    let updateEntry = null;
     try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const JSZip = require('jszip');
-        zip = await JSZip.loadAsync(gridsetBuffer);
+        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 entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
     let found = false;
     // Find and update the grid
     for (const entry of entries) {
@@ -196,7 +247,7 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
             const currentGridName = match ? match[1] : null;
             if (currentGridName === gridName) {
                 try {
-                    const xmlContent = (0, io_1.decodeText)(await entry.getData());
+                    const xmlContent = (0, io_2.decodeText)(await entry.getData());
                     const data = parser.parse(xmlContent);
                     const grid = data.Grid || data.grid;
                     if (!grid) {
@@ -222,7 +273,9 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
                     };
                     // Rebuild the XML
                     const updatedXml = builder.build(data);
-                    zip.file(entry.entryName, updatedXml, { binary: false });
+                    if (updateEntry) {
+                        updateEntry(entry.entryName, updatedXml);
+                    }
                     found = true;
                 }
                 catch (error) {
@@ -235,5 +288,8 @@ async function updateWordlist(gridsetBuffer, gridName, wordlist, password = (0,
     if (!found) {
         throw new Error(`Grid "${gridName}" not found in gridset`);
     }
-    return await zip.generateAsync({ type: 'uint8array' });
+    if (!saveZip) {
+        throw new Error('Failed to serialize updated gridset.');
+    }
+    return await saveZip();
 }

package/dist/processors/gridsetProcessor.js

@@ -40,31 +40,7 @@ const resolver_2 = require("./gridset/resolver");
 const idGenerator_1 = require("../utilities/analytics/utils/idGenerator");
 const symbolAlignment_1 = require("./gridset/symbolAlignment");
 const io_1 = require("../utils/io");
-let JSZipModule;
-async function getJSZip() {
-    if (!JSZipModule) {
-        try {
-            // Try ES module import first (browser/Vite)
-            const module = await Promise.resolve().then(() => __importStar(require('jszip')));
-            JSZipModule = module.default || module;
-        }
-        catch (error) {
-            // Fall back to CommonJS require (Node.js)
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-var-requires
-                const module = require('jszip');
-                JSZipModule = module.default || module;
-            }
-            catch (err2) {
-                throw new Error('Zip handling requires JSZip in this environment.');
-            }
-        }
-    }
-    if (!JSZipModule) {
-        throw new Error('Zip handling requires JSZip in this environment.');
-    }
-    return JSZipModule;
-}
+const zip_1 = require("../utils/zip");
 class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -437,17 +413,15 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     }
     async loadIntoTree(filePathOrBuffer) {
         const tree = new treeStructure_1.AACTree();
-        let zip;
+        let zipResult;
         try {
-            const JSZip = await getJSZip();
-            const zipInput = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
-            zip = await JSZip.loadAsync(zipInput);
+            zipResult = await (0, zip_1.openZipFromInput)((0, io_1.readBinaryFromInput)(filePathOrBuffer));
         }
         catch (error) {
             throw new Error(`Invalid ZIP file format: ${error.message}`);
         }
         const password = this.getGridsetPassword(filePathOrBuffer);
-        const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
+        const entries = (0, password_1.getZipEntriesFromAdapter)(zipResult.zip, password);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
         const isEncryptedArchive = typeof filePathOrBuffer === 'string' && filePathOrBuffer.toLowerCase().endsWith('.gridsetx');
         const encryptedContentPassword = this.getGridsetPassword(filePathOrBuffer);
@@ -458,14 +432,11 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             passwordProtected: !!password,
         };
         const readEntryBuffer = async (entry) => {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument
             const raw = await entry.getData();
             if (!isEncryptedArchive) {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 return raw;
             }
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-unsafe-return
-            return (0, crypto_1.decryptGridsetEntry)(raw, encryptedContentPassword);
+            return (0, crypto_1.decryptGridsetEntry)(Buffer.from(raw), encryptedContentPassword);
         };
         // Parse FileMap.xml if present to index dynamic files per grid
         const fileMapIndex = new Map();
@@ -785,7 +756,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         const gridEntryPath = entry.entryName.replace(/\\/g, '/');
                         const baseDir = gridEntryPath.replace(/\/grid\.xml$/, '/');
                         const dynamicFiles = fileMapIndex.get(gridEntryPath) || [];
-                        const resolvedImageEntry = (0, resolver_1.resolveGrid3CellImage)(zip, {
+                        const resolvedImageEntry = (0, resolver_1.resolveGrid3CellImage)(null, {
                             baseDir,
                             imageName: declaredImageName,
                             x: cellX + 1,
@@ -1636,11 +1607,36 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         return (0, io_1.readBinaryFromInput)(outputPath);
     }
     async saveFromTree(tree, outputPath) {
-        const JSZip = await getJSZip();
-        const zip = new JSZip();
+        const useNodeZip = (0, io_1.isNodeRuntime)();
+        let addText;
+        let addBinary;
+        let finalizeZip;
+        if (useNodeZip) {
+            const AdmZip = (0, io_1.getNodeRequire)()('adm-zip');
+            const zip = new AdmZip();
+            addText = (entryPath, content) => {
+                zip.addFile(entryPath, Buffer.from(content, 'utf8'));
+            };
+            addBinary = (entryPath, content) => {
+                zip.addFile(entryPath, Buffer.from(content));
+            };
+            finalizeZip = () => Promise.resolve(zip.toBuffer());
+        }
+        else {
+            const module = await Promise.resolve().then(() => __importStar(require('jszip')));
+            const JSZip = module.default || module;
+            const zip = new JSZip();
+            addText = (entryPath, content) => {
+                zip.file(entryPath, content, { binary: false });
+            };
+            addBinary = (entryPath, content) => {
+                zip.file(entryPath, content);
+            };
+            finalizeZip = async () => zip.generateAsync({ type: 'uint8array' });
+        }
         if (Object.keys(tree.pages).length === 0) {
             // Create empty zip for empty tree
-            const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
+            const zipBuffer = await finalizeZip();
             (0, io_1.writeBinaryToPath)(outputPath, zipBuffer);
             return;
         }
@@ -1713,7 +1709,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             suppressEmptyNode: true,
         });
         const settingsXmlContent = settingsBuilder.build(settingsData);
-        zip.file('Settings0/settings.xml', settingsXmlContent, { binary: false });
+        addText('Settings0/settings.xml', settingsXmlContent);
         // Create Settings0/Styles/style.xml if there are styles
         if (uniqueStyles.size > 0) {
             const stylesArray = Array.from(uniqueStyles.values()).map(({ id, style }) => {
@@ -1746,7 +1742,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 indentBy: '  ',
             });
             const styleXmlContent = styleBuilder.build(styleData);
-            zip.file('Settings0/Styles/styles.xml', styleXmlContent, { binary: false });
+            addText('Settings0/Styles/styles.xml', styleXmlContent);
         }
         // Collect grid file paths for FileMap.xml
         const gridFilePaths = [];
@@ -1887,14 +1883,14 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             // Add to zip in Grids folder with proper Grid3 naming
             const gridPath = `Grids/${page.name || page.id}/grid.xml`;
             gridFilePaths.push(gridPath);
-            zip.file(gridPath, xmlContent, { binary: false });
+            addText(gridPath, xmlContent);
         });
         // Write image files to ZIP
         buttonImages.forEach((imgData) => {
             if (imgData.imageData && imgData.imageData.length > 0) {
                 // Create image path in the grid's directory
                 const imagePath = `Grids/${imgData.pageName}/${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
-                zip.file(imagePath, imgData.imageData);
+                addBinary(imagePath, imgData.imageData);
             }
         });
         // Create FileMap.xml to map all grid files with their dynamic image files
@@ -1933,9 +1929,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             indentBy: '  ',
         });
         const fileMapXmlContent = fileMapBuilder.build(fileMapData);
-        zip.file('FileMap.xml', fileMapXmlContent, { binary: false });
+        addText('FileMap.xml', fileMapXmlContent);
         // Write the zip file
-        const zipBuffer = await zip.generateAsync({ type: 'uint8array' });
+        const zipBuffer = await finalizeZip();
         (0, io_1.writeBinaryToPath)(outputPath, zipBuffer);
     }
     // Helper method to calculate column definitions based on page layout