@willwade/aac-processors 0.1.5 → 0.1.7

package/dist/browser/validation/touchChatValidator.js

@@ -0,0 +1,201 @@
+/* eslint-disable @typescript-eslint/require-await */
+/* eslint-disable @typescript-eslint/no-unsafe-argument */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+import * as xml2js from 'xml2js';
+import { BaseValidator } from './baseValidator';
+import { decodeText, getBasename, getFs, readBinaryFromInput, toUint8Array } from '../utils/io';
+/**
+ * Validator for TouchChat files (.ce)
+ * TouchChat files are XML-based
+ */
+export class TouchChatValidator extends BaseValidator {
+    constructor() {
+        super();
+    }
+    /**
+     * Validate a TouchChat file from disk
+     */
+    static async validateFile(filePath) {
+        const validator = new TouchChatValidator();
+        const content = readBinaryFromInput(filePath);
+        const stats = getFs().statSync(filePath);
+        return validator.validate(content, getBasename(filePath), stats.size);
+    }
+    /**
+     * Check if content is TouchChat format
+     */
+    static async identifyFormat(content, filename) {
+        const name = filename.toLowerCase();
+        if (name.endsWith('.ce')) {
+            return true;
+        }
+        // Try to parse as XML and check for TouchChat structure
+        try {
+            const contentStr = typeof content === 'string' ? content : decodeText(toUint8Array(content));
+            const parser = new xml2js.Parser();
+            const result = await parser.parseStringPromise(contentStr);
+            // TouchChat files typically have specific structure
+            return result && (result.PageSet || result.Pageset || result.page || result.Page);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Main validation method
+     */
+    async validate(content, filename, filesize) {
+        this.reset();
+        await this.add_check('filename', 'file extension', async () => {
+            if (!filename.match(/\.ce$/i)) {
+                this.warn('filename should end with .ce');
+            }
+        });
+        let xmlObj = null;
+        await this.add_check('xml_parse', 'valid XML', async () => {
+            try {
+                const parser = new xml2js.Parser();
+                const contentStr = decodeText(content);
+                xmlObj = await parser.parseStringPromise(contentStr);
+            }
+            catch (e) {
+                this.err(`Failed to parse XML: ${e.message}`, true);
+            }
+        });
+        if (!xmlObj) {
+            return this.buildResult(filename, filesize, 'touchchat');
+        }
+        await this.add_check('xml_structure', 'TouchChat root element', async () => {
+            // TouchChat can have different root elements
+            const hasValidRoot = xmlObj.PageSet ||
+                xmlObj.Pageset ||
+                xmlObj.page ||
+                xmlObj.Page ||
+                xmlObj.pages ||
+                xmlObj.Pages;
+            if (!hasValidRoot) {
+                this.err('file does not contain a recognized TouchChat structure');
+            }
+        });
+        const root = xmlObj.PageSet ||
+            xmlObj.Pageset ||
+            xmlObj.page ||
+            xmlObj.Page ||
+            xmlObj.pages ||
+            xmlObj.Pages;
+        if (root) {
+            await this.validateTouchChatStructure(root);
+        }
+        return this.buildResult(filename, filesize, 'touchchat');
+    }
+    /**
+     * Validate TouchChat structure
+     */
+    async validateTouchChatStructure(root) {
+        // Check for ID
+        await this.add_check('root_id', 'root element ID', async () => {
+            const id = root.$?.id || root.$?.Id;
+            if (!id) {
+                this.warn('root element should have an id attribute');
+            }
+        });
+        // Check for name
+        await this.add_check('root_name', 'root element name', async () => {
+            const name = root.$?.name || root.$?.Name || root.name?.[0];
+            if (!name) {
+                this.warn('root element should have a name');
+            }
+        });
+        // Check for pages
+        await this.add_check('pages', 'pages collection', async () => {
+            const pages = root.page || root.Page || root.pages || root.Pages;
+            if (!pages) {
+                this.err('TouchChat file must contain pages');
+            }
+            else if (!Array.isArray(pages) || pages.length === 0) {
+                this.err('TouchChat file must contain at least one page');
+            }
+        });
+        // Validate individual pages
+        const pages = root.page || root.Page || root.pages || root.Pages;
+        if (pages && Array.isArray(pages)) {
+            await this.add_check('page_count', 'page count', async () => {
+                if (pages.length === 0) {
+                    this.err('Must contain at least one page');
+                }
+            });
+            // Sample first few pages
+            const sampleSize = Math.min(pages.length, 5);
+            for (let i = 0; i < sampleSize; i++) {
+                await this.validatePage(pages[i], i);
+            }
+        }
+    }
+    /**
+     * Validate a single page
+     */
+    async validatePage(page, index) {
+        await this.add_check(`page[${index}]_id`, `page ${index} ID`, async () => {
+            const id = page.$?.id || page.$?.Id;
+            if (!id) {
+                this.warn(`page ${index} is missing an id attribute`);
+            }
+        });
+        await this.add_check(`page[${index}]_name`, `page ${index} name`, async () => {
+            const name = page.$?.name || page.$?.Name || page.name?.[0];
+            if (!name) {
+                this.warn(`page ${index} should have a name`);
+            }
+        });
+        // Check for buttons/items
+        await this.add_check(`page[${index}]_buttons`, `page ${index} buttons`, async () => {
+            const buttons = page.button || page.Button || page.item || page.Item;
+            if (!buttons) {
+                this.warn(`page ${index} has no buttons/items`);
+            }
+            else if (Array.isArray(buttons) && buttons.length === 0) {
+                this.warn(`page ${index} should contain at least one button`);
+            }
+        });
+        // Validate button references
+        const buttons = page.button || page.Button || page.item || page.Item;
+        if (buttons && Array.isArray(buttons)) {
+            const sampleSize = Math.min(buttons.length, 3);
+            for (let i = 0; i < sampleSize; i++) {
+                await this.validateButton(buttons[i], index, i);
+            }
+        }
+    }
+    /**
+     * Validate a single button
+     */
+    async validateButton(button, pageIdx, buttonIdx) {
+        await this.add_check(`page[${pageIdx}]_button[${buttonIdx}]_label`, `button label`, async () => {
+            const label = button.$?.label || button.$?.Label || button.label?.[0];
+            if (!label) {
+                this.warn(`button ${buttonIdx} on page ${pageIdx} should have a label`);
+            }
+        });
+        await this.add_check(`page[${pageIdx}]_button[${buttonIdx}]_vocalization`, `button vocalization`, async () => {
+            const vocalization = button.$?.vocalization || button.$?.Vocalization || button.vocalization?.[0];
+            if (!vocalization) {
+                // Vocalization is optional, so just info
+            }
+        });
+        // Check for image reference
+        await this.add_check(`page[${pageIdx}]_button[${buttonIdx}]_image`, `button image`, async () => {
+            const image = button.$?.image || button.$?.Image || button.img?.[0];
+            if (!image) {
+                this.warn(`button ${buttonIdx} on page ${pageIdx} should have an image reference`);
+            }
+        });
+        // Check for link/action
+        await this.add_check(`page[${pageIdx}]_button[${buttonIdx}]_action`, `button action`, async () => {
+            const link = button.$?.link || button.$?.Link;
+            const action = button.$?.action || button.$?.Action;
+            if (!link && !action) {
+                // Not all buttons need actions, they can just speak
+            }
+        });
+    }
+}

package/dist/index.browser.d.ts

@@ -6,6 +6,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.
  */
 export * from './core/treeStructure';
 export * from './core/baseProcessor';
@@ -14,9 +18,12 @@ export { DotProcessor } from './processors/dotProcessor';
 export { OpmlProcessor } from './processors/opmlProcessor';
 export { ObfProcessor } from './processors/obfProcessor';
 export { GridsetProcessor } from './processors/gridsetProcessor';
+export { SnapProcessor } from './processors/snapProcessor';
+export { TouchChatProcessor } from './processors/touchchatProcessor';
 export { ApplePanelsProcessor } from './processors/applePanelsProcessor';
 export { AstericsGridProcessor } from './processors/astericsGridProcessor';
 import { BaseProcessor } from './core/baseProcessor';
+export { configureSqlJs } from './utils/sqlite';
 /**
  * Factory function to get the appropriate processor for a file extension
  * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')

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();
 }