@willwade/aac-processors 0.0.30 → 0.1.1

package/dist/processors/dotProcessor.js

@@ -1,15 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DotProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 // Removed unused import: FileProcessor
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const validation_1 = require("../validation");
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
 class DotProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -55,10 +51,9 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
         return { nodes: Array.from(nodes.values()), edges };
     }
-    extractTexts(filePathOrBuffer) {
-        const content = typeof filePathOrBuffer === 'string'
-            ? fs_1.default.readFileSync(filePathOrBuffer, 'utf8')
-            : filePathOrBuffer.toString('utf8');
+    async extractTexts(filePathOrBuffer) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -73,16 +68,15 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
         return texts;
     }
-    loadIntoTree(filePathOrBuffer) {
-        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.dot';
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.dot';
+        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = buffer.toString('utf8');
+            const content = (0, io_1.readTextFromInput)(buffer);
             if (!content || content.trim().length === 0) {
-                const validation = (0, validation_1.buildValidationResultFromMessage)({
+                const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize,
                     format: 'dot',
@@ -90,14 +84,14 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'content',
                     description: 'DOT file content',
                 });
-                throw new validation_1.ValidationFailureError('Empty DOT content', validation);
+                throw new validationTypes_1.ValidationFailureError('Empty DOT content', validation);
             }
             // Check for binary data (contains null bytes or non-printable characters)
             const head = content.substring(0, 100);
             for (let i = 0; i < head.length; i++) {
                 const code = head.charCodeAt(i);
                 if (code === 0 || (code >= 0 && code <= 8) || (code >= 14 && code <= 31)) {
-                    const validation = (0, validation_1.buildValidationResultFromMessage)({
+                    const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                         filename,
                         filesize,
                         format: 'dot',
@@ -105,7 +99,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                         type: 'content',
                         description: 'DOT file content',
                     });
-                    throw new validation_1.ValidationFailureError('Invalid DOT content', validation);
+                    throw new validationTypes_1.ValidationFailureError('Invalid DOT content', validation);
                 }
             }
             const { nodes, edges } = this.parseDotFile(content);
@@ -149,10 +143,10 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         catch (error) {
-            if (error instanceof validation_1.ValidationFailureError) {
+            if (error instanceof validationTypes_1.ValidationFailureError) {
                 throw error;
             }
-            const validation = (0, validation_1.buildValidationResultFromMessage)({
+            const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
                 filesize,
                 format: 'dot',
@@ -160,14 +154,12 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                 type: 'parse',
                 description: 'Parse DOT graph',
             });
-            throw new validation_1.ValidationFailureError('Failed to load DOT file', validation, error);
+            throw new validationTypes_1.ValidationFailureError('Failed to load DOT file', validation, error);
         }
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
-        const safeBuffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const content = safeBuffer.toString('utf8');
+    async processTexts(filePathOrBuffer, translations, outputPath) {
+        await Promise.resolve();
+        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -177,12 +169,12 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
                 translatedContent = translatedContent.replace(new RegExp(`label="${escapedText}"`, 'g'), `label="${escapedTranslation}"`);
             }
         });
-        const resultBuffer = Buffer.from(translatedContent || '', 'utf8');
-        // Save to output path
-        fs_1.default.writeFileSync(outputPath, resultBuffer);
+        const resultBuffer = (0, io_1.encodeText)(translatedContent || '');
+        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
         return resultBuffer;
     }
-    saveFromTree(tree, _outputPath) {
+    async saveFromTree(tree, _outputPath) {
+        await Promise.resolve();
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -212,7 +204,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         dotContent += '}\n';
-        fs_1.default.writeFileSync(_outputPath, dotContent);
+        (0, io_1.writeTextToPath)(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/excelProcessor.d.ts

@@ -1,3 +1,4 @@
+import { ProcessorInput } from '../utils/io';
 import { BaseProcessor, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
 /**
@@ -12,13 +13,13 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns Array of all text content found in the Excel file
      */
-    extractTexts(_filePathOrBuffer: string | Buffer): string[];
+    extractTexts(_filePathOrBuffer: ProcessorInput): Promise<string[]>;
     /**
      * Load Excel file into AACTree structure
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns AACTree representation of the Excel file
      */
-    loadIntoTree(_filePathOrBuffer: string | Buffer): AACTree;
+    loadIntoTree(_filePathOrBuffer: ProcessorInput): Promise<AACTree>;
     /**
      * Process texts in Excel file (apply translations)
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
@@ -26,7 +27,7 @@ export declare class ExcelProcessor extends BaseProcessor {
      * @param outputPath - Path where translated Excel file should be saved
      * @returns Buffer containing the translated Excel file
      */
-    processTexts(_filePathOrBuffer: string | Buffer, _translations: Map<string, string>, outputPath: string): Buffer;
+    processTexts(_filePathOrBuffer: ProcessorInput, _translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
     /**
      * Convert an AAC page to an Excel worksheet
      * @param workbook - Excel workbook to add worksheet to

package/dist/processors/excelProcessor.js

@@ -43,7 +43,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns Array of all text content found in the Excel file
      */
-    extractTexts(_filePathOrBuffer) {
+    async extractTexts(_filePathOrBuffer) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.extractTexts is not implemented yet.');
         return [];
     }
@@ -52,7 +53,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param filePathOrBuffer - Path to Excel file or Buffer containing Excel data
      * @returns AACTree representation of the Excel file
      */
-    loadIntoTree(_filePathOrBuffer) {
+    async loadIntoTree(_filePathOrBuffer) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.loadIntoTree is not implemented yet.');
         const tree = new treeStructure_1.AACTree();
         tree.metadata.format = 'excel';
@@ -65,7 +67,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @param outputPath - Path where translated Excel file should be saved
      * @returns Buffer containing the translated Excel file
      */
-    processTexts(_filePathOrBuffer, _translations, outputPath) {
+    async processTexts(_filePathOrBuffer, _translations, outputPath) {
+        await Promise.resolve();
         console.warn('ExcelProcessor.processTexts is not implemented yet.');
         const outputDir = path_1.default.dirname(outputPath);
         if (!fs_1.default.existsSync(outputDir)) {

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

@@ -0,0 +1,18 @@
+/**
+ * Crypto utilities for Gridsetx (encrypted Grid3 files)
+ * This module is only needed for .gridsetx files and uses Node-only crypto/zlib
+ */
+/**
+ * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
+ * Uses AES-256-CBC with key/IV derived from the password padded with spaces
+ * and then Deflate decompression.
+ *
+ * @param buffer - Encrypted buffer
+ * @param password - Password (defaults to 'Chocolate')
+ * @returns Decrypted and inflated buffer
+ */
+export declare function decryptGridsetEntry(buffer: Buffer, password?: string): Buffer;
+/**
+ * Check if crypto operations are available in the current environment
+ */
+export declare function isCryptoAvailable(): boolean;

package/dist/processors/gridset/crypto.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Crypto utilities for Gridsetx (encrypted Grid3 files)
+ * This module is only needed for .gridsetx files and uses Node-only crypto/zlib
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decryptGridsetEntry = decryptGridsetEntry;
+exports.isCryptoAvailable = isCryptoAvailable;
+/**
+ * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
+ * Uses AES-256-CBC with key/IV derived from the password padded with spaces
+ * and then Deflate decompression.
+ *
+ * @param buffer - Encrypted buffer
+ * @param password - Password (defaults to 'Chocolate')
+ * @returns Decrypted and inflated buffer
+ */
+function decryptGridsetEntry(buffer, password) {
+    // Dynamic require to avoid breaking in browser environments
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
+    const crypto = require('crypto');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-return
+    const zlib = require('zlib');
+    const pwd = (password || 'Chocolate').padEnd(32, ' ');
+    const key = Buffer.from(pwd.slice(0, 32), 'utf8');
+    const iv = Buffer.from(pwd.slice(0, 16), 'utf8');
+    try {
+        const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv);
+        const decrypted = Buffer.concat([decipher.update(buffer), decipher.final()]);
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return zlib.inflateSync(decrypted);
+        }
+        catch {
+            // If data isn't deflated, return raw decrypted bytes
+            return decrypted;
+        }
+    }
+    catch {
+        return buffer;
+    }
+}
+/**
+ * Check if crypto operations are available in the current environment
+ */
+function isCryptoAvailable() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('crypto');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('zlib');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

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

@@ -15,7 +15,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(gridsetBuffer: Buffer, entryPath: string, password?: string | undefined): Buffer | null;
+export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined): Promise<Uint8Array | null>;
 /**
  * Generate a random GUID for Grid3 elements
  * Grid3 uses GUIDs for grid identification

package/dist/processors/gridset/helpers.js

@@ -42,7 +42,6 @@ exports.isGrid3Installed = isGrid3Installed;
 exports.readGrid3History = readGrid3History;
 exports.readGrid3HistoryForUser = readGrid3HistoryForUser;
 exports.readAllGrid3History = readAllGrid3History;
-const adm_zip_1 = __importDefault(require("adm-zip"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const treeStructure_1 = require("../../core/treeStructure");
 const fs = __importStar(require("fs"));
@@ -96,14 +95,25 @@ function getAllowedImageEntries(tree) {
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-function openImage(gridsetBuffer, entryPath, password = (0, password_1.resolveGridsetPasswordFromEnv)()) {
-    const zip = new adm_zip_1.default(gridsetBuffer);
-    const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
-    const want = normalizeZipPath(entryPath);
-    const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
-    if (!entry)
+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 want = normalizeZipPath(entryPath);
+        const entry = entries.find((e) => normalizeZipPath(e.entryName) === want);
+        if (!entry)
+            return null;
+        const data = await entry.getData();
+        if (typeof Buffer !== 'undefined' && typeof Buffer.from === 'function') {
+            return Buffer.from(data);
+        }
+        return data;
+    }
+    catch (error) {
         return null;
-    return entry.getData();
+    }
 }
 /**
  * Generate a random GUID for Grid3 elements

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

@@ -1,11 +1,28 @@
+import type JSZip from 'jszip';
 import { ProcessorOptions } from '../../core/baseProcessor';
-import AdmZip from 'adm-zip';
+import { ProcessorInput } from '../../utils/io';
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
  * 1. Explicit processor option
  * 2. GRIDSET_PASSWORD env var
  */
-export declare function resolveGridsetPassword(options?: ProcessorOptions, source?: string | Buffer): string | undefined;
+export declare function resolveGridsetPassword(options?: ProcessorOptions, source?: ProcessorInput): string | undefined;
 export declare function resolveGridsetPasswordFromEnv(): string | undefined;
-export declare function getZipEntriesWithPassword(zip: AdmZip, password?: string): AdmZip.IZipEntry[];
+/**
+ * Get zip entries as an array from JSZip instance.
+ * JSZip doesn't have password protection at the entry level like AdmZip.
+ * Password protection for .gridsetx is handled at the archive level in crypto.ts.
+ *
+ * @param zip - JSZip instance
+ * @param password - Optional password (kept for API compatibility, not used with JSZip)
+ * @returns Array of entry objects with name and data
+ */
+type ZipEntry = {
+    name: string;
+    entryName: string;
+    dir: boolean;
+    getData: () => Promise<Uint8Array>;
+};
+export declare function getZipEntriesWithPassword(zip: JSZip, password?: string): ZipEntry[];
+export {};

package/dist/processors/gridset/password.js

@@ -1,12 +1,14 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveGridsetPassword = resolveGridsetPassword;
 exports.resolveGridsetPasswordFromEnv = resolveGridsetPasswordFromEnv;
 exports.getZipEntriesWithPassword = getZipEntriesWithPassword;
-const path_1 = __importDefault(require("path"));
+function getExtension(source) {
+    const index = source.lastIndexOf('.');
+    if (index === -1)
+        return '';
+    return source.slice(index);
+}
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
@@ -16,22 +18,37 @@ const path_1 = __importDefault(require("path"));
 function resolveGridsetPassword(options, source) {
     if (options?.gridsetPassword)
         return options.gridsetPassword;
-    if (process.env.GRIDSET_PASSWORD)
-        return process.env.GRIDSET_PASSWORD;
+    const envPassword = typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
+    if (envPassword)
+        return envPassword;
     if (typeof source === 'string') {
-        const ext = path_1.default.extname(source).toLowerCase();
+        const ext = getExtension(source).toLowerCase();
         if (ext === '.gridsetx')
-            return process.env.GRIDSET_PASSWORD;
+            return envPassword;
     }
     return undefined;
 }
 function resolveGridsetPasswordFromEnv() {
-    return process.env.GRIDSET_PASSWORD;
+    return typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
 }
-// Wrapper to set the password before reading entries (typed getEntries lacks the optional arg)
 function getZipEntriesWithPassword(zip, password) {
+    const entries = [];
+    // Note: JSZip doesn't support zip-level password protection like AdmZip
+    // Password protection for .gridsetx files is handled at the encrypted archive level
+    // in crypto.ts before the zip is loaded
     if (password) {
-        return zip.getEntries(password);
+        console.warn('JSZip does not support zip-level password protection. For .gridsetx encrypted files, password is handled at the archive level.');
     }
-    return zip.getEntries();
+    zip.forEach((relativePath, file) => {
+        entries.push({
+            name: relativePath,
+            entryName: relativePath,
+            dir: file.dir || false,
+            getData: async () => {
+                // Use 'uint8array' which is supported everywhere
+                return await file.async('uint8array');
+            },
+        });
+    });
+    return entries;
 }

package/dist/processors/gridset/symbols.js

@@ -13,32 +13,6 @@
  *
  * This module provides symbol resolution and metadata extraction.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_LOCALE = exports.SYMBOL_LIBRARIES = void 0;
 exports.parseSymbolReference = parseSymbolReference;
@@ -59,9 +33,7 @@ exports.analyzeSymbolUsage = analyzeSymbolUsage;
 exports.symbolReferenceToFilename = symbolReferenceToFilename;
 exports.getSymbolsDir = getSymbolsDir;
 exports.getSymbolSearchDir = getSymbolSearchDir;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const adm_zip_1 = __importDefault(require("adm-zip"));
+const io_1 = require("../../utils/io");
 /**
  * Default Grid 3 installation paths by platform
  */
@@ -104,6 +76,37 @@ 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 {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const module = require('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"
@@ -142,23 +145,29 @@ function isSymbolReference(reference) {
  * @returns Default Grid 3 path or empty string if not found
  */
 function getDefaultGrid3Path() {
-    const platform = process.platform;
+    const platform = (typeof process !== 'undefined' && process.platform ? process.platform : 'unknown');
     const defaultPath = DEFAULT_GRID3_PATHS[platform] || '';
-    if (defaultPath && fs.existsSync(defaultPath)) {
-        return defaultPath;
-    }
-    // Try to find Grid 3 in common locations
-    const commonPaths = [
-        'C:\\Program Files (x86)\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        '/Applications/Grid 3.app',
-        '/opt/smartbox/grid3',
-    ];
-    for (const testPath of commonPaths) {
-        if (fs.existsSync(testPath)) {
-            return testPath;
+    try {
+        const fs = getNodeFs();
+        if (defaultPath && fs.existsSync(defaultPath)) {
+            return defaultPath;
         }
+        // Try to find Grid 3 in common locations
+        const commonPaths = [
+            'C:\\Program Files (x86)\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            '/Applications/Grid 3.app',
+            '/opt/smartbox/grid3',
+        ];
+        for (const testPath of commonPaths) {
+            if (fs.existsSync(testPath)) {
+                return testPath;
+            }
+        }
+    }
+    catch {
+        return '';
     }
     return '';
 }
@@ -169,6 +178,7 @@ function getDefaultGrid3Path() {
  * @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);
 }
 /**
@@ -179,6 +189,7 @@ function getSymbolLibrariesDir(grid3Path) {
  * @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');
 }
 /**
@@ -192,6 +203,7 @@ function getAvailableSymbolLibraries(options = {}) {
         return [];
     }
     const symbolsDir = getSymbolLibrariesDir(grid3Path);
+    const fs = getNodeFs();
     if (!fs.existsSync(symbolsDir)) {
         return [];
     }
@@ -199,6 +211,7 @@ function getAvailableSymbolLibraries(options = {}) {
     const files = fs.readdirSync(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');
@@ -233,7 +246,9 @@ 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);
             return {
@@ -280,7 +295,8 @@ function resolveSymbolReference(reference, options = {}) {
     }
     try {
         // .symbols files are ZIP archives
-        const zip = new adm_zip_1.default(libraryInfo.pixFile);
+        const AdmZip = getAdmZip();
+        const zip = new AdmZip(libraryInfo.pixFile);
         // 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}`;
@@ -445,7 +461,8 @@ function analyzeSymbolUsage(tree) {
  */
 function symbolReferenceToFilename(reference, cellX, cellY) {
     const parsed = parseSymbolReference(reference);
-    const ext = path.extname(parsed.path) || '.png';
+    const dotIndex = parsed.path.lastIndexOf('.');
+    const ext = dotIndex >= 0 ? parsed.path.slice(dotIndex) : '.png';
     // Grid 3 format: {x}-{y}-0-text-0.{ext}
     return `${cellX}-${cellY}-0-text-0${ext}`;
 }

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

@@ -59,12 +59,12 @@ export declare function wordlistToXml(wordlist: WordList): string;
  * @returns Map of grid names to their wordlists (if they have any)
  *
  * @example
- * const wordlists = extractWordlists(gridsetBuffer);
+ * const wordlists = await extractWordlists(gridsetBuffer);
  * wordlists.forEach((wordlist, gridName) => {
  *   console.log(`Grid "${gridName}" has ${wordlist.items.length} items`);
  * });
  */
-export declare function extractWordlists(gridsetBuffer: Buffer, password?: string | undefined): Map<string, WordList>;
+export declare function extractWordlists(gridsetBuffer: Uint8Array, password?: string | undefined): Promise<Map<string, WordList>>;
 /**
  * Updates or adds a wordlist to a specific grid in a gridset
  *
@@ -79,4 +79,4 @@ export declare function extractWordlists(gridsetBuffer: Buffer, password?: strin
  * const updatedGridset = updateWordlist(gridsetBuffer, 'Greetings', newWordlist);
  * fs.writeFileSync('updated-gridset.gridset', updatedGridset);
  */
-export declare function updateWordlist(gridsetBuffer: Buffer, gridName: string, wordlist: WordList, password?: string | undefined): Buffer;
+export declare function updateWordlist(gridsetBuffer: Uint8Array, gridName: string, wordlist: WordList, password?: string | undefined): Promise<Uint8Array>;