@willwade/aac-processors 0.0.9 → 0.0.11

package/dist/processors/gridsetProcessor.js

@@ -10,10 +10,47 @@ const adm_zip_1 = __importDefault(require("adm-zip"));
 const fs_1 = __importDefault(require("fs"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const resolver_1 = require("./gridset/resolver");
+const password_1 = require("./gridset/password");
+const crypto_1 = __importDefault(require("crypto"));
+const zlib_1 = __importDefault(require("zlib"));
+const gridsetValidator_1 = require("../validation/gridsetValidator");
+// New imports for enhanced Grid 3 support
+const pluginTypes_1 = require("./gridset/pluginTypes");
+const commands_1 = require("./gridset/commands");
+const symbols_1 = require("./gridset/symbols");
+const resolver_2 = require("./gridset/resolver");
 class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
     }
+    /**
+     * 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.
+     */
+    decryptGridsetEntry(buffer, password) {
+        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_1.default.createDecipheriv('aes-256-cbc', key, iv);
+            const decrypted = Buffer.concat([decipher.update(buffer), decipher.final()]);
+            try {
+                return zlib_1.default.inflateSync(decrypted);
+            }
+            catch {
+                // If data isn't deflated, return raw decrypted bytes
+                return decrypted;
+            }
+        }
+        catch {
+            return buffer;
+        }
+    }
+    // Determine password to use when opening encrypted gridset archives (.gridsetx)
+    getGridsetPassword(source) {
+        return (0, password_1.resolveGridsetPassword)(this.options, source);
+    }
     // Helper function to ensure color has alpha channel (Grid3 format)
     ensureAlphaChannel(color) {
         if (!color)
@@ -222,6 +259,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             fontColor: grid3Style.FontColour,
             fontFamily: grid3Style.FontName,
             fontSize: grid3Style.FontSize ? parseInt(String(grid3Style.FontSize)) : undefined,
+            backgroundShape: grid3Style.BackgroundShape !== undefined
+                ? parseInt(String(grid3Style.BackgroundShape))
+                : undefined,
         };
     }
     // Helper function to get style by ID or return default
@@ -242,10 +282,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         return undefined;
     }
     extractTexts(filePathOrBuffer) {
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const tree = this.loadIntoTree(buffer);
+        const tree = this.loadIntoTree(filePathOrBuffer);
         const texts = [];
         for (const pageId in tree.pages) {
             const page = tree.pages[pageId];
@@ -269,13 +306,23 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         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 parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
+        const isEncryptedArchive = typeof filePathOrBuffer === 'string' && filePathOrBuffer.toLowerCase().endsWith('.gridsetx');
+        const encryptedContentPassword = this.getGridsetPassword(filePathOrBuffer);
+        const readEntryBuffer = (entry) => {
+            const raw = entry.getData();
+            if (!isEncryptedArchive)
+                return raw;
+            return this.decryptGridsetEntry(raw, encryptedContentPassword);
+        };
         // Parse FileMap.xml if present to index dynamic files per grid
         const fileMapIndex = new Map();
         try {
-            const fmEntry = zip.getEntries().find((e) => e.entryName.endsWith('FileMap.xml'));
+            const fmEntry = entries.find((e) => e.entryName.endsWith('FileMap.xml'));
             if (fmEntry) {
-                const fmXml = fmEntry.getData().toString('utf8');
+                const fmXml = readEntryBuffer(fmEntry).toString('utf8');
                 const fmData = parser.parse(fmXml);
                 const entries = fmData?.FileMap?.Entries?.Entry || fmData?.fileMap?.entries?.entry;
                 if (entries) {
@@ -307,12 +354,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         }
         // First, load styles from Settings0/Styles/styles.xml (Grid3 format)
         const styles = new Map();
-        const styleEntry = zip
-            .getEntries()
-            .find((entry) => entry.entryName.endsWith('styles.xml') || entry.entryName.endsWith('style.xml'));
+        const styleEntry = entries.find((entry) => entry.entryName.endsWith('styles.xml') || entry.entryName.endsWith('style.xml'));
         if (styleEntry) {
             try {
-                const styleXmlContent = styleEntry.getData().toString('utf8');
+                const styleXmlContent = readEntryBuffer(styleEntry).toString('utf8');
                 const styleData = parser.parse(styleXmlContent);
                 // Parse styles and store them in the map
                 // Grid3 uses StyleData.Styles.Style with Key attribute
@@ -343,14 +388,14 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             }
         }
         // Debug: log all entry names
-        // console.log('Gridset zip entries:', zip.getEntries().map(e => e.entryName));
+        // console.log('Gridset zip entries:', entries.map(e => e.entryName));
         // First pass: collect all grid names and IDs for navigation resolution
         const gridNameToIdMap = new Map();
         const gridIdToNameMap = new Map();
-        zip.getEntries().forEach((entry) => {
+        entries.forEach((entry) => {
             if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
                 try {
-                    const xmlContent = entry.getData().toString('utf8');
+                    const xmlContent = readEntryBuffer(entry).toString('utf8');
                     const data = parser.parse(xmlContent);
                     const grid = data.Grid || data.grid;
                     if (!grid)
@@ -373,12 +418,12 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         // Second pass: process each grid file in the gridset
-        zip.getEntries().forEach((entry) => {
+        entries.forEach((entry) => {
             // Only process files named grid.xml under Grids/ (any subdir)
             if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
                 let xmlContent;
                 try {
-                    xmlContent = entry.getData().toString('utf8');
+                    xmlContent = readEntryBuffer(entry).toString('utf8');
                 }
                 catch (e) {
                     // Skip unreadable files
@@ -459,11 +504,14 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                             }
                         }
                         const message = label; // Use caption as message
+                        // Detect plugin cell type (Workspace, LiveCell, AutoContent)
+                        const pluginMetadata = (0, pluginTypes_1.detectPluginCellType)(content);
                         // Parse all command types from Grid3 and create semantic actions
                         let semanticAction;
                         let legacyAction = null;
                         // infer action type implicitly from commands; no explicit enum needed
                         let navigationTarget;
+                        let detectedCommands = []; // Store detected command metadata
                         const commands = content.Commands?.Command || content.commands?.command;
                         // Resolve image for this cell using FileMap and coordinate heuristics
                         const imageCandidate = captionAndImage?.Image ||
@@ -482,9 +530,15 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                             x: cellX + 1,
                             y: cellY + 1,
                             dynamicFiles,
-                        }) || undefined;
+                        }, entries) || undefined;
+                        // Check if image is a symbol library reference
+                        let symbolLibraryRef = null;
+                        if (declaredImageName && (0, resolver_2.isSymbolLibraryReference)(declaredImageName)) {
+                            symbolLibraryRef = (0, symbols_1.parseSymbolReference)(declaredImageName);
+                        }
                         if (commands) {
                             const commandArr = Array.isArray(commands) ? commands : [commands];
+                            detectedCommands = commandArr.map((cmd) => (0, commands_1.detectCommand)(cmd));
                             for (const command of commandArr) {
                                 const commandId = command['@_ID'] || command.ID || command.id;
                                 const parameters = command.Parameter || command.parameter;
@@ -874,10 +928,27 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                             y: cellY,
                             columnSpan: colSpan,
                             rowSpan: rowSpan,
+                            contentType: pluginMetadata.cellType === pluginTypes_1.Grid3CellType.Regular
+                                ? 'Normal'
+                                : pluginMetadata.cellType === pluginTypes_1.Grid3CellType.Workspace
+                                    ? 'Workspace'
+                                    : pluginMetadata.cellType === pluginTypes_1.Grid3CellType.LiveCell
+                                        ? 'LiveCell'
+                                        : 'AutoContent',
+                            contentSubType: pluginMetadata.subType ||
+                                pluginMetadata.liveCellType ||
+                                pluginMetadata.autoContentType,
+                            symbolLibrary: symbolLibraryRef?.library || undefined,
+                            symbolPath: symbolLibraryRef?.path || undefined,
                             style: {
                                 ...cellStyle,
                                 ...inlineStyle, // Inline styles override referenced styles
                             },
+                            parameters: {
+                                pluginMetadata: pluginMetadata, // Store full plugin metadata for future use
+                                grid3Commands: detectedCommands, // Store detected command metadata
+                                symbolLibraryRef: symbolLibraryRef, // Store full symbol reference
+                            },
                         });
                         // Add button to page
                         page.addButton(button);
@@ -910,9 +981,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         }
         // Read settings.xml to get the StartGrid (home page)
         try {
-            const settingsEntry = zip.getEntries().find((e) => e.entryName.endsWith('settings.xml'));
+            const settingsEntry = entries.find((e) => e.entryName.endsWith('settings.xml'));
             if (settingsEntry) {
-                const settingsXml = settingsEntry.getData().toString('utf8');
+                const settingsXml = readEntryBuffer(settingsEntry).toString('utf8');
                 const settingsData = parser.parse(settingsXml);
                 const startGridName = settingsData?.GridSetSettings?.StartGrid ||
                     settingsData?.gridSetSettings?.startGrid ||
@@ -933,10 +1004,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     }
     processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const tree = this.loadIntoTree(buffer);
+        const tree = this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
         Object.values(tree.pages).forEach((page) => {
             // Translate page names
@@ -1327,5 +1395,13 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate Gridset file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return gridsetValidator_1.GridsetValidator.validateFile(filePath);
+    }
 }
 exports.GridsetProcessor = GridsetProcessor;

package/dist/processors/index.d.ts

@@ -11,8 +11,17 @@ export { getPageTokenImageMap, getAllowedImageEntries, openImage, generateGrid3G
 export { getPageTokenImageMap as getGridsetPageTokenImageMap, getAllowedImageEntries as getGridsetAllowedImageEntries, openImage as openGridsetImage, generateGrid3Guid as generateGridsetGuid, createSettingsXml as createGridsetSettingsXml, createFileMapXml as createGridsetFileMapXml, getCommonDocumentsPath as getGridsetCommonDocumentsPath, findGrid3UserPaths as findGridsetUserPaths, findGrid3HistoryDatabases as findGridsetHistoryDatabases, findGrid3Users as findGridsetUsers, findGrid3Vocabularies as findGridsetVocabularies, findGrid3UserHistory as findGridsetUserHistory, isGrid3Installed as isGridsetInstalled, readGrid3History as readGridsetHistory, readGrid3HistoryForUser as readGridsetHistoryForUser, readAllGrid3History as readAllGridsetHistory, } from './gridset/helpers';
 export { resolveGrid3CellImage } from './gridset/resolver';
 export { createWordlist, extractWordlists, updateWordlist, wordlistToXml, type WordList, type WordListItem, } from './gridset/wordlistHelpers';
+export { resolveGridsetPassword, resolveGridsetPasswordFromEnv } from './gridset/password';
 export { getNamedColor, rgbaToHex, channelToHex, clampColorChannel, clampAlpha, toHexColor, darkenColor, normalizeColor, ensureAlphaChannel, } from './gridset/colorUtils';
-export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, createDefaultStylesXml, createCategoryStyle, } from './gridset/styleHelpers';
+export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, createDefaultStylesXml, createCategoryStyle, CellBackgroundShape, SHAPE_NAMES, } from './gridset/styleHelpers';
 export { ensureAlphaChannel as ensureAlphaChannelFromStyles } from './gridset/styleHelpers';
+export { detectPluginCellType, type Grid3PluginMetadata, Grid3CellType, WORKSPACE_TYPES, LIVECELL_TYPES, AUTOCONTENT_TYPES, getCellTypeDisplayName, isWorkspaceCell, isLiveCell, isAutoContentCell, isRegularCell, } from './gridset/pluginTypes';
+export { detectCommand, getCommandDefinition, getCommandsByPlugin, getCommandsByCategory, getAllCommandIds, getAllPluginIds, extractCommandParameters, GRID3_COMMANDS, type Grid3CommandDefinition, type CommandParameter, type ExtractedParameters, Grid3CommandCategory, } from './gridset/commands';
+export * from './gridset/index';
+export { parseSymbolReference, isSymbolReference, resolveSymbolReference, getAvailableSymbolLibraries, getSymbolLibraryInfo, extractSymbolReferences, analyzeSymbolUsage, createSymbolReference, getSymbolLibraryName, getSymbolPath, isKnownSymbolLibrary, getSymbolLibraryDisplayName, getDefaultGrid3Path, getSymbolLibrariesDir, getSymbolSearchIndexesDir, symbolReferenceToFilename, SYMBOL_LIBRARIES, } from './gridset/symbols';
+export { isSymbolLibraryReference, parseImageSymbolReference } from './gridset/resolver';
+export { getSymbolsDir, getSymbolSearchDir } from './gridset/symbols';
+export { extractButtonImage, extractSymbolLibraryImage, convertToAstericsImage, analyzeSymbolExtraction, suggestExtractionStrategy, exportSymbolReferencesToCsv, createSymbolManifest, } from './gridset/symbolExtractor';
+export { parsePixFile, loadSearchIndexes, searchSymbols, searchSymbolsWithReferences, getSymbolFilename, getSymbolDisplayName, getAllSearchTerms, getSearchSuggestions, countLibrarySymbols, getSymbolSearchStats, } from './gridset/symbolSearch';
 export { getPageTokenImageMap as getSnapPageTokenImageMap, getAllowedImageEntries as getSnapAllowedImageEntries, openImage as openSnapImage, findSnapPackages, findSnapPackagePath, findSnapUsers, findSnapUserVocabularies, findSnapUserHistory, isSnapInstalled, readSnapUsage, readSnapUsageForUser, type SnapPackagePath, type SnapUserInfo, type SnapUsageEntry, } from './snap/helpers';
 export { getPageTokenImageMap as getTouchChatPageTokenImageMap, getAllowedImageEntries as getTouchChatAllowedImageEntries, openImage as openTouchChatImage, } from './touchchat/helpers';

package/dist/processors/index.js

@@ -1,7 +1,22 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __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.clampColorChannel = exports.channelToHex = exports.rgbaToHex = exports.getNamedColor = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.readAllGridsetHistory = exports.readGridsetHistoryForUser = exports.readGridsetHistory = exports.isGridsetInstalled = exports.findGridsetUserHistory = exports.findGridsetVocabularies = exports.findGridsetUsers = exports.findGridsetHistoryDatabases = exports.findGridsetUserPaths = exports.getGridsetCommonDocumentsPath = exports.createGridsetFileMapXml = exports.createGridsetSettingsXml = exports.generateGridsetGuid = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3Users = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
-exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.readSnapUsageForUser = exports.readSnapUsage = exports.isSnapInstalled = exports.findSnapUserHistory = exports.findSnapUserVocabularies = exports.findSnapUsers = exports.findSnapPackagePath = exports.findSnapPackages = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = exports.ensureAlphaChannelFromStyles = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.ensureAlphaChannel = exports.normalizeColor = exports.darkenColor = exports.toHexColor = exports.clampAlpha = void 0;
+exports.rgbaToHex = exports.getNamedColor = exports.resolveGridsetPasswordFromEnv = exports.resolveGridsetPassword = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.readAllGridsetHistory = exports.readGridsetHistoryForUser = exports.readGridsetHistory = exports.isGridsetInstalled = exports.findGridsetUserHistory = exports.findGridsetVocabularies = exports.findGridsetUsers = exports.findGridsetHistoryDatabases = exports.findGridsetUserPaths = exports.getGridsetCommonDocumentsPath = exports.createGridsetFileMapXml = exports.createGridsetSettingsXml = exports.generateGridsetGuid = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3Users = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
+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 = 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.ensureAlphaChannelFromStyles = exports.SHAPE_NAMES = exports.CellBackgroundShape = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.ensureAlphaChannel = exports.normalizeColor = exports.darkenColor = exports.toHexColor = exports.clampAlpha = exports.clampColorChannel = exports.channelToHex = void 0;
+exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.readSnapUsageForUser = exports.readSnapUsage = exports.isSnapInstalled = exports.findSnapUserHistory = exports.findSnapUserVocabularies = exports.findSnapUsers = exports.findSnapPackagePath = exports.findSnapPackages = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = 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.getSymbolSearchDir = exports.getSymbolsDir = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = void 0;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -63,6 +78,9 @@ Object.defineProperty(exports, "createWordlist", { enumerable: true, get: functi
 Object.defineProperty(exports, "extractWordlists", { enumerable: true, get: function () { return wordlistHelpers_1.extractWordlists; } });
 Object.defineProperty(exports, "updateWordlist", { enumerable: true, get: function () { return wordlistHelpers_1.updateWordlist; } });
 Object.defineProperty(exports, "wordlistToXml", { enumerable: true, get: function () { return wordlistHelpers_1.wordlistToXml; } });
+var password_1 = require("./gridset/password");
+Object.defineProperty(exports, "resolveGridsetPassword", { enumerable: true, get: function () { return password_1.resolveGridsetPassword; } });
+Object.defineProperty(exports, "resolveGridsetPasswordFromEnv", { enumerable: true, get: function () { return password_1.resolveGridsetPasswordFromEnv; } });
 // Gridset (Grid 3) color utilities
 var colorUtils_1 = require("./gridset/colorUtils");
 Object.defineProperty(exports, "getNamedColor", { enumerable: true, get: function () { return colorUtils_1.getNamedColor; } });
@@ -80,9 +98,83 @@ Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get:
 Object.defineProperty(exports, "CATEGORY_STYLES", { enumerable: true, get: function () { return styleHelpers_1.CATEGORY_STYLES; } });
 Object.defineProperty(exports, "createDefaultStylesXml", { enumerable: true, get: function () { return styleHelpers_1.createDefaultStylesXml; } });
 Object.defineProperty(exports, "createCategoryStyle", { enumerable: true, get: function () { return styleHelpers_1.createCategoryStyle; } });
+Object.defineProperty(exports, "CellBackgroundShape", { enumerable: true, get: function () { return styleHelpers_1.CellBackgroundShape; } });
+Object.defineProperty(exports, "SHAPE_NAMES", { enumerable: true, get: function () { return styleHelpers_1.SHAPE_NAMES; } });
 // Re-export ensureAlphaChannel from styleHelpers for backward compatibility
 var styleHelpers_2 = require("./gridset/styleHelpers");
 Object.defineProperty(exports, "ensureAlphaChannelFromStyles", { enumerable: true, get: function () { return styleHelpers_2.ensureAlphaChannel; } });
+// Gridset (Grid 3) plugin cell type detection
+var pluginTypes_1 = require("./gridset/pluginTypes");
+Object.defineProperty(exports, "detectPluginCellType", { enumerable: true, get: function () { return pluginTypes_1.detectPluginCellType; } });
+Object.defineProperty(exports, "Grid3CellType", { enumerable: true, get: function () { return pluginTypes_1.Grid3CellType; } });
+Object.defineProperty(exports, "WORKSPACE_TYPES", { enumerable: true, get: function () { return pluginTypes_1.WORKSPACE_TYPES; } });
+Object.defineProperty(exports, "LIVECELL_TYPES", { enumerable: true, get: function () { return pluginTypes_1.LIVECELL_TYPES; } });
+Object.defineProperty(exports, "AUTOCONTENT_TYPES", { enumerable: true, get: function () { return pluginTypes_1.AUTOCONTENT_TYPES; } });
+Object.defineProperty(exports, "getCellTypeDisplayName", { enumerable: true, get: function () { return pluginTypes_1.getCellTypeDisplayName; } });
+Object.defineProperty(exports, "isWorkspaceCell", { enumerable: true, get: function () { return pluginTypes_1.isWorkspaceCell; } });
+Object.defineProperty(exports, "isLiveCell", { enumerable: true, get: function () { return pluginTypes_1.isLiveCell; } });
+Object.defineProperty(exports, "isAutoContentCell", { enumerable: true, get: function () { return pluginTypes_1.isAutoContentCell; } });
+Object.defineProperty(exports, "isRegularCell", { enumerable: true, get: function () { return pluginTypes_1.isRegularCell; } });
+// Gridset (Grid 3) command definitions and detection
+var commands_1 = require("./gridset/commands");
+Object.defineProperty(exports, "detectCommand", { enumerable: true, get: function () { return commands_1.detectCommand; } });
+Object.defineProperty(exports, "getCommandDefinition", { enumerable: true, get: function () { return commands_1.getCommandDefinition; } });
+Object.defineProperty(exports, "getCommandsByPlugin", { enumerable: true, get: function () { return commands_1.getCommandsByPlugin; } });
+Object.defineProperty(exports, "getCommandsByCategory", { enumerable: true, get: function () { return commands_1.getCommandsByCategory; } });
+Object.defineProperty(exports, "getAllCommandIds", { enumerable: true, get: function () { return commands_1.getAllCommandIds; } });
+Object.defineProperty(exports, "getAllPluginIds", { enumerable: true, get: function () { return commands_1.getAllPluginIds; } });
+Object.defineProperty(exports, "extractCommandParameters", { enumerable: true, get: function () { return commands_1.extractCommandParameters; } });
+Object.defineProperty(exports, "GRID3_COMMANDS", { enumerable: true, get: function () { return commands_1.GRID3_COMMANDS; } });
+Object.defineProperty(exports, "Grid3CommandCategory", { enumerable: true, get: function () { return commands_1.Grid3CommandCategory; } });
+// Gridset (Grid 3) enhanced index - re-export everything
+__exportStar(require("./gridset/index"), exports);
+// Gridset (Grid 3) symbol library handling
+var symbols_1 = require("./gridset/symbols");
+Object.defineProperty(exports, "parseSymbolReference", { enumerable: true, get: function () { return symbols_1.parseSymbolReference; } });
+Object.defineProperty(exports, "isSymbolReference", { enumerable: true, get: function () { return symbols_1.isSymbolReference; } });
+Object.defineProperty(exports, "resolveSymbolReference", { enumerable: true, get: function () { return symbols_1.resolveSymbolReference; } });
+Object.defineProperty(exports, "getAvailableSymbolLibraries", { enumerable: true, get: function () { return symbols_1.getAvailableSymbolLibraries; } });
+Object.defineProperty(exports, "getSymbolLibraryInfo", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryInfo; } });
+Object.defineProperty(exports, "extractSymbolReferences", { enumerable: true, get: function () { return symbols_1.extractSymbolReferences; } });
+Object.defineProperty(exports, "analyzeSymbolUsage", { enumerable: true, get: function () { return symbols_1.analyzeSymbolUsage; } });
+Object.defineProperty(exports, "createSymbolReference", { enumerable: true, get: function () { return symbols_1.createSymbolReference; } });
+Object.defineProperty(exports, "getSymbolLibraryName", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryName; } });
+Object.defineProperty(exports, "getSymbolPath", { enumerable: true, get: function () { return symbols_1.getSymbolPath; } });
+Object.defineProperty(exports, "isKnownSymbolLibrary", { enumerable: true, get: function () { return symbols_1.isKnownSymbolLibrary; } });
+Object.defineProperty(exports, "getSymbolLibraryDisplayName", { enumerable: true, get: function () { return symbols_1.getSymbolLibraryDisplayName; } });
+Object.defineProperty(exports, "getDefaultGrid3Path", { enumerable: true, get: function () { return symbols_1.getDefaultGrid3Path; } });
+Object.defineProperty(exports, "getSymbolLibrariesDir", { enumerable: true, get: function () { return symbols_1.getSymbolLibrariesDir; } });
+Object.defineProperty(exports, "getSymbolSearchIndexesDir", { enumerable: true, get: function () { return symbols_1.getSymbolSearchIndexesDir; } });
+Object.defineProperty(exports, "symbolReferenceToFilename", { enumerable: true, get: function () { return symbols_1.symbolReferenceToFilename; } });
+Object.defineProperty(exports, "SYMBOL_LIBRARIES", { enumerable: true, get: function () { return symbols_1.SYMBOL_LIBRARIES; } });
+var resolver_2 = require("./gridset/resolver");
+Object.defineProperty(exports, "isSymbolLibraryReference", { enumerable: true, get: function () { return resolver_2.isSymbolLibraryReference; } });
+Object.defineProperty(exports, "parseImageSymbolReference", { enumerable: true, get: function () { return resolver_2.parseImageSymbolReference; } });
+// Backward compatibility
+var symbols_2 = require("./gridset/symbols");
+Object.defineProperty(exports, "getSymbolsDir", { enumerable: true, get: function () { return symbols_2.getSymbolsDir; } });
+Object.defineProperty(exports, "getSymbolSearchDir", { enumerable: true, get: function () { return symbols_2.getSymbolSearchDir; } });
+// Gridset (Grid 3) symbol extraction for conversion
+var symbolExtractor_1 = require("./gridset/symbolExtractor");
+Object.defineProperty(exports, "extractButtonImage", { enumerable: true, get: function () { return symbolExtractor_1.extractButtonImage; } });
+Object.defineProperty(exports, "extractSymbolLibraryImage", { enumerable: true, get: function () { return symbolExtractor_1.extractSymbolLibraryImage; } });
+Object.defineProperty(exports, "convertToAstericsImage", { enumerable: true, get: function () { return symbolExtractor_1.convertToAstericsImage; } });
+Object.defineProperty(exports, "analyzeSymbolExtraction", { enumerable: true, get: function () { return symbolExtractor_1.analyzeSymbolExtraction; } });
+Object.defineProperty(exports, "suggestExtractionStrategy", { enumerable: true, get: function () { return symbolExtractor_1.suggestExtractionStrategy; } });
+Object.defineProperty(exports, "exportSymbolReferencesToCsv", { enumerable: true, get: function () { return symbolExtractor_1.exportSymbolReferencesToCsv; } });
+Object.defineProperty(exports, "createSymbolManifest", { enumerable: true, get: function () { return symbolExtractor_1.createSymbolManifest; } });
+// Gridset (Grid 3) symbol search
+var symbolSearch_1 = require("./gridset/symbolSearch");
+Object.defineProperty(exports, "parsePixFile", { enumerable: true, get: function () { return symbolSearch_1.parsePixFile; } });
+Object.defineProperty(exports, "loadSearchIndexes", { enumerable: true, get: function () { return symbolSearch_1.loadSearchIndexes; } });
+Object.defineProperty(exports, "searchSymbols", { enumerable: true, get: function () { return symbolSearch_1.searchSymbols; } });
+Object.defineProperty(exports, "searchSymbolsWithReferences", { enumerable: true, get: function () { return symbolSearch_1.searchSymbolsWithReferences; } });
+Object.defineProperty(exports, "getSymbolFilename", { enumerable: true, get: function () { return symbolSearch_1.getSymbolFilename; } });
+Object.defineProperty(exports, "getSymbolDisplayName", { enumerable: true, get: function () { return symbolSearch_1.getSymbolDisplayName; } });
+Object.defineProperty(exports, "getAllSearchTerms", { enumerable: true, get: function () { return symbolSearch_1.getAllSearchTerms; } });
+Object.defineProperty(exports, "getSearchSuggestions", { enumerable: true, get: function () { return symbolSearch_1.getSearchSuggestions; } });
+Object.defineProperty(exports, "countLibrarySymbols", { enumerable: true, get: function () { return symbolSearch_1.countLibrarySymbols; } });
+Object.defineProperty(exports, "getSymbolSearchStats", { enumerable: true, get: function () { return symbolSearch_1.getSymbolSearchStats; } });
 // Snap helpers
 var helpers_3 = require("./snap/helpers");
 Object.defineProperty(exports, "getSnapPageTokenImageMap", { enumerable: true, get: function () { return helpers_3.getPageTokenImageMap; } });

package/dist/processors/obfProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class ObfProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
     private processBoard;
@@ -19,5 +20,11 @@ declare class ObfProcessor extends BaseProcessor {
      * Uses the generic implementation from BaseProcessor
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate OBF/OBZ file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { ObfProcessor };

package/dist/processors/obfProcessor.js

@@ -10,6 +10,7 @@ const treeStructure_1 = require("../core/treeStructure");
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const fs_1 = __importDefault(require("fs"));
 // Removed unused import: path
+const obfValidator_1 = require("../validation/obfValidator");
 const OBF_FORMAT_VERSION = 'open-board-0.1';
 class ObfProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
@@ -359,5 +360,13 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
     async generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate OBF/OBZ file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return obfValidator_1.ObfValidator.validateFile(filePath);
+    }
 }
 exports.ObfProcessor = ObfProcessor;

package/dist/processors/snapProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class SnapProcessor extends BaseProcessor {
     private symbolResolver;
     private loadAudio;
@@ -40,5 +41,11 @@ declare class SnapProcessor extends BaseProcessor {
      * Uses the generic implementation from BaseProcessor
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate Snap file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { SnapProcessor };

package/dist/processors/snapProcessor.js

@@ -11,6 +11,7 @@ const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const crypto_1 = __importDefault(require("crypto"));
+const snapValidator_1 = require("../validation/snapValidator");
 class SnapProcessor extends baseProcessor_1.BaseProcessor {
     constructor(symbolResolver = null, options = {}) {
         super(options);
@@ -612,5 +613,13 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
     async generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate Snap file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return snapValidator_1.SnapValidator.validateFile(filePath);
+    }
 }
 exports.SnapProcessor = SnapProcessor;

package/dist/processors/touchchatProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class TouchChatProcessor extends BaseProcessor {
     private tree;
     private sourceFile;
@@ -23,5 +24,11 @@ declare class TouchChatProcessor extends BaseProcessor {
      * @returns Promise with path to the generated translated file
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate TouchChat file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { TouchChatProcessor };

package/dist/processors/touchchatProcessor.js

@@ -12,6 +12,7 @@ const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
+const touchChatValidator_1 = require("../validation/touchChatValidator");
 const toNumberOrUndefined = (value) => typeof value === 'number' ? value : undefined;
 const toStringOrUndefined = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
 const toBooleanOrUndefined = (value) => typeof value === 'number' ? value !== 0 : undefined;
@@ -787,5 +788,13 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             return Promise.reject(new Error(`Failed to generate translated download: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
+    /**
+     * Validate TouchChat file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return touchChatValidator_1.TouchChatValidator.validateFile(filePath);
+    }
 }
 exports.TouchChatProcessor = TouchChatProcessor;

package/dist/types/aac.d.ts

@@ -25,6 +25,23 @@ export interface AACButton {
         identifier?: string;
         metadata?: string;
     };
+    contentType?: 'Normal' | 'AutoContent' | 'Workspace' | 'LiveCell';
+    contentSubType?: string;
+    image?: string;
+    resolvedImageEntry?: string;
+    symbolLibrary?: string;
+    symbolPath?: string;
+    x?: number;
+    y?: number;
+    columnSpan?: number;
+    rowSpan?: number;
+    scanBlocks?: number[];
+    visibility?: 'Visible' | 'Hidden' | 'Disabled' | 'PointerAndTouchOnly' | 'Empty';
+    directActivate?: boolean;
+    audioDescription?: string;
+    parameters?: {
+        [key: string]: any;
+    };
 }
 export interface AACPage {
     id: string;

package/dist/utilities/screenshotConverter.d.ts

@@ -0,0 +1,69 @@
+import { AACPage, AACTree } from '../core/treeStructure';
+export interface ScreenshotCell {
+    text: string;
+    row: number;
+    col: number;
+    isCategory?: boolean;
+    isNavigation?: boolean;
+    isEmpty?: boolean;
+    imageUrl?: string;
+}
+export interface ScreenshotGrid {
+    rows: number;
+    cols: number;
+    cells: ScreenshotCell[];
+    categories: string[];
+    metadata?: {
+        timestamp?: string;
+        battery?: string;
+        date?: string;
+    };
+}
+export interface ScreenshotPage {
+    filename: string;
+    grid: ScreenshotGrid;
+    extractedAt: Date;
+    pageName?: string;
+    parentPath?: string;
+    pageTitle?: string;
+}
+export interface PageHierarchy {
+    [pageId: string]: {
+        page: ScreenshotPage;
+        children: string[];
+        parent?: string;
+    };
+}
+export interface ScreenshotConversionOptions {
+    includeEmptyCells: boolean;
+    generateIds: boolean;
+    targetPlatform?: 'grid3' | 'asterics' | 'snap' | 'touchchat';
+    language: string;
+    fallbackCategory: string;
+    filenameDelimiter?: string;
+}
+export declare class ScreenshotConverter {
+    private static defaultOptions;
+    /**
+     * Parse filename to extract page hierarchy and names
+     * Examples:
+     * - "Home.png" → pageName: "Home", parentPath: ""
+     * - "Home->Fragen.png" → pageName: "Fragen", parentPath: "Home"
+     * - "Home->Settings->Profile.jpg" → pageName: "Profile", parentPath: "Home->Settings"
+     */
+    static parseFilename(filename: string, delimiter?: string): {
+        pageName: string;
+        parentPath: string;
+    };
+    /**
+     * Build page hierarchy from an array of screenshots
+     */
+    static buildPageHierarchy(screenshots: ScreenshotPage[]): PageHierarchy;
+    static parseOCRText(ocrResult: string): ScreenshotGrid;
+    private static isCategoryToken;
+    private static isNavigationToken;
+    static convertToAACPage(screenshotPage: ScreenshotPage, pageHierarchy?: PageHierarchy, options?: Partial<ScreenshotConversionOptions>): AACPage;
+    private static createSemanticAction;
+    static convertToAACTree(screenshotPages: ScreenshotPage[], options?: Partial<ScreenshotConversionOptions>): AACTree;
+    private static sanitizePageId;
+}