@willwade/aac-processors 0.0.14 → 0.0.16

package/README.md

@@ -56,7 +56,7 @@ npm run build
 
 ### Requirements
 
-- **Node.js** 16.0.0 or higher
+- **Node.js** 20.0.0 or higher
 - **TypeScript** 5.5+ (for development)
 
 ---
@@ -94,7 +94,7 @@ This step is only required for Electron apps; regular Node.js consumers do not n
 
 ## 🔧 Quick Start
 
-### Basic Usage (TypeScript/ES6)
+### Basic Usage (TypeScript)
 
 ```typescript
 import {
@@ -118,15 +118,20 @@ const aacTree = dotProcessor.loadIntoTree("examples/example.dot");
 console.log("Pages:", Object.keys(aacTree.pages).length);
 ```
 
-### Basic Usage (CommonJS)
+### Platform Support
 
-```javascript
-const { getProcessor, DotProcessor } = require("aac-processors");
+**AACProcessors is designed for Node.js environments only.** It requires Node.js v20+ and cannot run in browsers due to:
 
-const processor = getProcessor("board.dot");
-const tree = processor.loadIntoTree("board.dot");
-console.log(tree);
-```
+- **File system access** - Required for reading/writing AAC files
+- **Native SQLite** - Used by Snap, TouchChat, and Analytics features
+- **Binary format processing** - ZIP, encrypted formats, etc.
+
+**For browser-based AAC display**, consider these alternatives:
+- **obf-renderer** - Display OBF/OBZ files in web apps
+- **Arc Core** - Browser-based AAC communication
+- **Cboard** - Web-based AAC display system
+
+This library focuses on **server-side file processing**, not client-side rendering.
 
 ### Button Filtering System
 
@@ -194,6 +199,45 @@ const translatedBuffer = processor.processTexts(
 console.log("Translation complete!");
 ```
 
+### 🤖 LLM-Based Translation with Symbol Preservation
+
+For advanced AI-powered translation that preserves symbol-to-word associations across languages, see the **[Translation Utilities Guide](./src/utilities/translation/README.md)**.
+
+**Features:**
+- 🧠 **Intelligent symbol mapping**: LLMs understand grammar, not just word position
+- 🎯 **Cross-format support**: Works with Gridset, OBF/OBZ, TouchChat, and Snap
+- 🔗 **Symbol preservation**: Symbols stay attached to correct translated words
+- ✅ **Validated output**: Built-in validation catches translation errors
+
+**Quick Demo:**
+```bash
+# Translate a Grid 3 file to Spanish using Gemini 2.0 Flash
+export GEMINI_API_KEY="your-key-here"
+node scripts/translation/gemini-translate-gridset.js "./tmp/Voco Chat.gridset" Spanish
+```
+
+**Complete Example:**
+```typescript
+import { GridsetProcessor } from "@willwade/aac-processors";
+
+const processor = new GridsetProcessor();
+
+// 1. Extract buttons with symbol information
+const buttons = processor.extractSymbolsForLLM("board.gridset");
+
+// 2. Create LLM prompt (or call your LLM API directly)
+// See: src/utilities/translation/README.md
+
+// 3. Apply translations with preserved symbols
+processor.processLLMTranslations(
+  "board.gridset",
+  llmTranslations,
+  "board-spanish.gridset"
+);
+```
+
+See **[scripts/translation/](./scripts/translation/)** for complete working examples with Gemini, GPT-4, and other LLMs.
+
 ### 📊 AAC Analytics & Clinical Metrics
 
 The library includes an optional high-performance analytics engine for evaluating AAC board sets based on the **AAC Effort Algorithm (v0.2)**.
@@ -205,7 +249,7 @@ The library includes an optional high-performance analytics engine for evaluatin
 - **Sentence Analysis**: Measure the effort required to construct common test sentences.
 - **Comparative Analysis**: Identify gaps and improvements between two pageset versions.
 
-For detailed documentation, see the **[AAC Metrics Guide](./src/optional/analytics/docs/AAC_METRICS_GUIDE.md)** and **[Vocabulary Analysis Guide](./src/optional/analytics/docs/VOCABULARY_ANALYSIS_GUIDE.md)**.
+For detailed documentation, see the **[AAC Metrics Guide](./src/utilities/analytics/docs/AAC_METRICS_GUIDE.md)** and **[Vocabulary Analysis Guide](./src/utilities/analytics/docs/VOCABULARY_ANALYSIS_GUIDE.md)**.
 
 ```typescript
 import { ObfsetProcessor, Analytics } from "@willwade/aac-processors";
@@ -854,3 +898,7 @@ Inspired by the Python AACProcessors project
 ### Contributing
 
 Want to help with any of these items? See our [Contributing Guidelines](#-contributing) and pick an issue that interests you!
+
+### Credits
+
+Some of the OBF work is directly from https://github.com/open-aac/obf and https://github.com/open-aac/aac-metrics - OBLA too https://www.openboardformat.org/logs 

package/dist/applePanels.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Apple Panels (macOS) Namespace
+ *
+ * Apple Panels format processing for macOS AAC solutions.
+ */
+export { ApplePanelsProcessor } from './processors/applePanelsProcessor';

package/dist/applePanels.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Apple Panels (macOS) Namespace
+ *
+ * Apple Panels format processing for macOS AAC solutions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplePanelsProcessor = void 0;
+// Processor class
+var applePanelsProcessor_1 = require("./processors/applePanelsProcessor");
+Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
+// Note: Apple Panels doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/astericsGrid.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Asterics Grid Namespace
+ *
+ * Asterics Grid format processing for Asterics AAC solutions.
+ */
+export { AstericsGridProcessor } from './processors/astericsGridProcessor';

package/dist/astericsGrid.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Asterics Grid Namespace
+ *
+ * Asterics Grid format processing for Asterics AAC solutions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AstericsGridProcessor = void 0;
+// Processor class
+var astericsGridProcessor_1 = require("./processors/astericsGridProcessor");
+Object.defineProperty(exports, "AstericsGridProcessor", { enumerable: true, get: function () { return astericsGridProcessor_1.AstericsGridProcessor; } });
+// Note: Asterics Grid doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/core/treeStructure.d.ts

@@ -86,6 +86,7 @@ export interface AACSemanticAction {
         touchChat?: {
             actionCode: number;
             actionData: string;
+            resourceId?: number;
         };
         snap?: {
             navigatePageId?: number;

package/dist/dot.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Dot (Graphviz) Namespace
+ *
+ * DOT format processing for graph-based communication boards.
+ */
+export { DotProcessor } from './processors/dotProcessor';

package/dist/dot.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Dot (Graphviz) Namespace
+ *
+ * DOT format processing for graph-based communication boards.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DotProcessor = void 0;
+// Processor class
+var dotProcessor_1 = require("./processors/dotProcessor");
+Object.defineProperty(exports, "DotProcessor", { enumerable: true, get: function () { return dotProcessor_1.DotProcessor; } });
+// Note: DOT doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/excel.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Excel Namespace
+ *
+ * Excel export format for vocabulary analysis and reporting.
+ */
+export { ExcelProcessor } from './processors/excelProcessor';

package/dist/excel.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Excel Namespace
+ *
+ * Excel export format for vocabulary analysis and reporting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExcelProcessor = void 0;
+// Processor class
+var excelProcessor_1 = require("./processors/excelProcessor");
+Object.defineProperty(exports, "ExcelProcessor", { enumerable: true, get: function () { return excelProcessor_1.ExcelProcessor; } });
+// Note: Excel doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/gridset.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gridset (Grid 3) Namespace
+ *
+ * All Grid 3 / Gridset-specific utilities, helpers, and types.
+ * Organized by category for cleaner imports.
+ */
+export { GridsetProcessor } from './processors/gridsetProcessor';
+export { getPageTokenImageMap, getAllowedImageEntries, openImage, getCommonDocumentsPath, findGrid3UserPaths, findGrid3HistoryDatabases, findGrid3Users, findGrid3Vocabularies, findGrid3UserHistory, isGrid3Installed, readGrid3History, readGrid3HistoryForUser, readAllGrid3History, generateGrid3Guid, createSettingsXml, createFileMapXml, type Grid3UserPath, type Grid3VocabularyPath, type Grid3HistoryEntry, } from './processors/gridset/helpers';
+export { createWordlist, extractWordlists, updateWordlist, wordlistToXml, type WordList, type WordListItem, } from './processors/gridset/wordlistHelpers';
+export { getNamedColor, rgbaToHex, channelToHex, clampColorChannel, clampAlpha, toHexColor, darkenColor, normalizeColor, ensureAlphaChannel, } from './processors/gridset/colorUtils';
+export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, createDefaultStylesXml, createCategoryStyle, CellBackgroundShape, SHAPE_NAMES, ensureAlphaChannel as ensureAlphaChannelFromStyles, } from './processors/gridset/styleHelpers';
+export { detectPluginCellType, getCellTypeDisplayName, isWorkspaceCell, isLiveCell, isAutoContentCell, isRegularCell, type Grid3PluginMetadata, Grid3CellType, WORKSPACE_TYPES, LIVECELL_TYPES, AUTOCONTENT_TYPES, } from './processors/gridset/pluginTypes';
+export { detectCommand, getCommandDefinition, getCommandsByPlugin, getCommandsByCategory, getAllCommandIds, getAllPluginIds, extractCommandParameters, GRID3_COMMANDS, type Grid3CommandDefinition, type CommandParameter, type ExtractedParameters, Grid3CommandCategory, } from './processors/gridset/commands';
+export { parseSymbolReference, isSymbolReference, resolveSymbolReference, getAvailableSymbolLibraries, getSymbolLibraryInfo, extractSymbolReferences, analyzeSymbolUsage, createSymbolReference, getSymbolLibraryName, getSymbolPath, isKnownSymbolLibrary, getSymbolLibraryDisplayName, getDefaultGrid3Path, getSymbolLibrariesDir, getSymbolSearchIndexesDir, symbolReferenceToFilename, SYMBOL_LIBRARIES, isSymbolLibraryReference, parseImageSymbolReference, resolveGrid3CellImage, getSymbolsDir, getSymbolSearchDir, } from './processors/gridset/index';
+export { extractButtonImage, extractSymbolLibraryImage, convertToAstericsImage, analyzeSymbolExtraction, suggestExtractionStrategy, exportSymbolReferencesToCsv, createSymbolManifest, } from './processors/gridset/symbolExtractor';
+export { parsePixFile, loadSearchIndexes, searchSymbols, searchSymbolsWithReferences, getSymbolFilename, getSymbolDisplayName, getAllSearchTerms, getSearchSuggestions, countLibrarySymbols, getSymbolSearchStats, } from './processors/gridset/symbolSearch';
+export { resolveGridsetPassword, resolveGridsetPasswordFromEnv, } from './processors/gridset/password';

package/dist/gridset.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Gridset (Grid 3) Namespace
+ *
+ * All Grid 3 / Gridset-specific utilities, helpers, and types.
+ * Organized by category for cleaner imports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommandsByPlugin = exports.getCommandDefinition = exports.detectCommand = exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = exports.isRegularCell = exports.isAutoContentCell = exports.isLiveCell = exports.isWorkspaceCell = exports.getCellTypeDisplayName = 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 = exports.rgbaToHex = exports.getNamedColor = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3Users = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.GridsetProcessor = void 0;
+exports.resolveGridsetPasswordFromEnv = exports.resolveGridsetPassword = 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.resolveGrid3CellImage = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = 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 = void 0;
+// Processor class
+var gridsetProcessor_1 = require("./processors/gridsetProcessor");
+Object.defineProperty(exports, "GridsetProcessor", { enumerable: true, get: function () { return gridsetProcessor_1.GridsetProcessor; } });
+// === User & File System Helpers ===
+var helpers_1 = require("./processors/gridset/helpers");
+Object.defineProperty(exports, "getPageTokenImageMap", { enumerable: true, get: function () { return helpers_1.getPageTokenImageMap; } });
+Object.defineProperty(exports, "getAllowedImageEntries", { enumerable: true, get: function () { return helpers_1.getAllowedImageEntries; } });
+Object.defineProperty(exports, "openImage", { enumerable: true, get: function () { return helpers_1.openImage; } });
+Object.defineProperty(exports, "getCommonDocumentsPath", { enumerable: true, get: function () { return helpers_1.getCommonDocumentsPath; } });
+Object.defineProperty(exports, "findGrid3UserPaths", { enumerable: true, get: function () { return helpers_1.findGrid3UserPaths; } });
+Object.defineProperty(exports, "findGrid3HistoryDatabases", { enumerable: true, get: function () { return helpers_1.findGrid3HistoryDatabases; } });
+Object.defineProperty(exports, "findGrid3Users", { enumerable: true, get: function () { return helpers_1.findGrid3Users; } });
+Object.defineProperty(exports, "findGrid3Vocabularies", { enumerable: true, get: function () { return helpers_1.findGrid3Vocabularies; } });
+Object.defineProperty(exports, "findGrid3UserHistory", { enumerable: true, get: function () { return helpers_1.findGrid3UserHistory; } });
+Object.defineProperty(exports, "isGrid3Installed", { enumerable: true, get: function () { return helpers_1.isGrid3Installed; } });
+Object.defineProperty(exports, "readGrid3History", { enumerable: true, get: function () { return helpers_1.readGrid3History; } });
+Object.defineProperty(exports, "readGrid3HistoryForUser", { enumerable: true, get: function () { return helpers_1.readGrid3HistoryForUser; } });
+Object.defineProperty(exports, "readAllGrid3History", { enumerable: true, get: function () { return helpers_1.readAllGrid3History; } });
+Object.defineProperty(exports, "generateGrid3Guid", { enumerable: true, get: function () { return helpers_1.generateGrid3Guid; } });
+Object.defineProperty(exports, "createSettingsXml", { enumerable: true, get: function () { return helpers_1.createSettingsXml; } });
+Object.defineProperty(exports, "createFileMapXml", { enumerable: true, get: function () { return helpers_1.createFileMapXml; } });
+// === Wordlist Management ===
+var wordlistHelpers_1 = require("./processors/gridset/wordlistHelpers");
+Object.defineProperty(exports, "createWordlist", { enumerable: true, get: function () { return wordlistHelpers_1.createWordlist; } });
+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; } });
+// === Color Utilities ===
+var colorUtils_1 = require("./processors/gridset/colorUtils");
+Object.defineProperty(exports, "getNamedColor", { enumerable: true, get: function () { return colorUtils_1.getNamedColor; } });
+Object.defineProperty(exports, "rgbaToHex", { enumerable: true, get: function () { return colorUtils_1.rgbaToHex; } });
+Object.defineProperty(exports, "channelToHex", { enumerable: true, get: function () { return colorUtils_1.channelToHex; } });
+Object.defineProperty(exports, "clampColorChannel", { enumerable: true, get: function () { return colorUtils_1.clampColorChannel; } });
+Object.defineProperty(exports, "clampAlpha", { enumerable: true, get: function () { return colorUtils_1.clampAlpha; } });
+Object.defineProperty(exports, "toHexColor", { enumerable: true, get: function () { return colorUtils_1.toHexColor; } });
+Object.defineProperty(exports, "darkenColor", { enumerable: true, get: function () { return colorUtils_1.darkenColor; } });
+Object.defineProperty(exports, "normalizeColor", { enumerable: true, get: function () { return colorUtils_1.normalizeColor; } });
+Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return colorUtils_1.ensureAlphaChannel; } });
+// === Style Helpers ===
+var styleHelpers_1 = require("./processors/gridset/styleHelpers");
+Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get: function () { return styleHelpers_1.DEFAULT_GRID3_STYLES; } });
+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; } });
+Object.defineProperty(exports, "ensureAlphaChannelFromStyles", { enumerable: true, get: function () { return styleHelpers_1.ensureAlphaChannel; } });
+// === Plugin & Workspace Detection ===
+var pluginTypes_1 = require("./processors/gridset/pluginTypes");
+Object.defineProperty(exports, "detectPluginCellType", { enumerable: true, get: function () { return pluginTypes_1.detectPluginCellType; } });
+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; } });
+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; } });
+// === Command Detection ===
+var commands_1 = require("./processors/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; } });
+// === Symbol Libraries ===
+var index_1 = require("./processors/gridset/index");
+Object.defineProperty(exports, "parseSymbolReference", { enumerable: true, get: function () { return index_1.parseSymbolReference; } });
+Object.defineProperty(exports, "isSymbolReference", { enumerable: true, get: function () { return index_1.isSymbolReference; } });
+Object.defineProperty(exports, "resolveSymbolReference", { enumerable: true, get: function () { return index_1.resolveSymbolReference; } });
+Object.defineProperty(exports, "getAvailableSymbolLibraries", { enumerable: true, get: function () { return index_1.getAvailableSymbolLibraries; } });
+Object.defineProperty(exports, "getSymbolLibraryInfo", { enumerable: true, get: function () { return index_1.getSymbolLibraryInfo; } });
+Object.defineProperty(exports, "extractSymbolReferences", { enumerable: true, get: function () { return index_1.extractSymbolReferences; } });
+Object.defineProperty(exports, "analyzeSymbolUsage", { enumerable: true, get: function () { return index_1.analyzeSymbolUsage; } });
+Object.defineProperty(exports, "createSymbolReference", { enumerable: true, get: function () { return index_1.createSymbolReference; } });
+Object.defineProperty(exports, "getSymbolLibraryName", { enumerable: true, get: function () { return index_1.getSymbolLibraryName; } });
+Object.defineProperty(exports, "getSymbolPath", { enumerable: true, get: function () { return index_1.getSymbolPath; } });
+Object.defineProperty(exports, "isKnownSymbolLibrary", { enumerable: true, get: function () { return index_1.isKnownSymbolLibrary; } });
+Object.defineProperty(exports, "getSymbolLibraryDisplayName", { enumerable: true, get: function () { return index_1.getSymbolLibraryDisplayName; } });
+Object.defineProperty(exports, "getDefaultGrid3Path", { enumerable: true, get: function () { return index_1.getDefaultGrid3Path; } });
+Object.defineProperty(exports, "getSymbolLibrariesDir", { enumerable: true, get: function () { return index_1.getSymbolLibrariesDir; } });
+Object.defineProperty(exports, "getSymbolSearchIndexesDir", { enumerable: true, get: function () { return index_1.getSymbolSearchIndexesDir; } });
+Object.defineProperty(exports, "symbolReferenceToFilename", { enumerable: true, get: function () { return index_1.symbolReferenceToFilename; } });
+Object.defineProperty(exports, "SYMBOL_LIBRARIES", { enumerable: true, get: function () { return index_1.SYMBOL_LIBRARIES; } });
+Object.defineProperty(exports, "isSymbolLibraryReference", { enumerable: true, get: function () { return index_1.isSymbolLibraryReference; } });
+Object.defineProperty(exports, "parseImageSymbolReference", { enumerable: true, get: function () { return index_1.parseImageSymbolReference; } });
+Object.defineProperty(exports, "resolveGrid3CellImage", { enumerable: true, get: function () { return index_1.resolveGrid3CellImage; } });
+// Backward compatibility
+Object.defineProperty(exports, "getSymbolsDir", { enumerable: true, get: function () { return index_1.getSymbolsDir; } });
+Object.defineProperty(exports, "getSymbolSearchDir", { enumerable: true, get: function () { return index_1.getSymbolSearchDir; } });
+// === Symbol Extraction ===
+var symbolExtractor_1 = require("./processors/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; } });
+// === Symbol Search ===
+var symbolSearch_1 = require("./processors/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; } });
+// === Password Management ===
+var password_1 = require("./processors/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; } });

package/dist/index.d.ts

@@ -1,16 +1,37 @@
+/**
+ * AACProcessors Library
+ *
+ * A comprehensive TypeScript library for processing AAC file formats.
+ *
+ * @module aac-processors
+ */
 export * from './core/treeStructure';
 export * from './core/baseProcessor';
 export * from './core/stringCasing';
 export * from './processors';
-export * from './validation';
 export * as Analytics from './utilities/analytics';
-export { collectUnifiedHistory, listGrid3Users as listHistoryGrid3Users, listSnapUsers as listHistorySnapUsers, } from './utilities/analytics/history';
+export * as Validation from './validation';
+export * as Gridset from './gridset';
+export * as Snap from './snap';
+export * as OBF from './obf';
+export * as Obfset from './obfset';
+export * as TouchChat from './touchchat';
+export * as Dot from './dot';
+export * as Excel from './excel';
+export * as Opml from './opml';
+export * as ApplePanels from './applePanels';
+export * as AstericsGrid from './astericsGrid';
+export * as Translation from './translation';
 import { BaseProcessor } from './core/baseProcessor';
 /**
  * Factory function to get the appropriate processor for a file extension
  * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')
  * @returns The appropriate processor instance
  * @throws Error if the file extension is not supported
+ *
+ * @example
+ * const processor = getProcessor('/path/to/file.gridset');
+ * const tree = processor.loadIntoTree('/path/to/file.gridset');
  */
 export declare function getProcessor(filePathOrExtension: string): BaseProcessor;
 /**

package/dist/index.js

@@ -1,4 +1,11 @@
 "use strict";
+/**
+ * AACProcessors Library
+ *
+ * A comprehensive TypeScript library for processing AAC file formats.
+ *
+ * @module aac-processors
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -26,21 +33,39 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listHistorySnapUsers = exports.listHistoryGrid3Users = exports.collectUnifiedHistory = exports.Analytics = void 0;
+exports.Translation = exports.AstericsGrid = exports.ApplePanels = exports.Opml = exports.Excel = exports.Dot = exports.TouchChat = exports.Obfset = exports.OBF = exports.Snap = exports.Gridset = exports.Validation = exports.Analytics = void 0;
 exports.getProcessor = getProcessor;
 exports.getSupportedExtensions = getSupportedExtensions;
 exports.isExtensionSupported = isExtensionSupported;
-// Main entry point for AACProcessors library
+// ===================================================================
+// CORE TYPES (always needed)
+// ===================================================================
 __exportStar(require("./core/treeStructure"), exports);
 __exportStar(require("./core/baseProcessor"), exports);
 __exportStar(require("./core/stringCasing"), exports);
+// ===================================================================
+// PROCESSORS (main functionality)
+// ===================================================================
 __exportStar(require("./processors"), exports);
-__exportStar(require("./validation"), exports);
+// ===================================================================
+// NAMESPACES
+// ===================================================================
+// Analytics namespace
 exports.Analytics = __importStar(require("./utilities/analytics"));
-var history_1 = require("./utilities/analytics/history");
-Object.defineProperty(exports, "collectUnifiedHistory", { enumerable: true, get: function () { return history_1.collectUnifiedHistory; } });
-Object.defineProperty(exports, "listHistoryGrid3Users", { enumerable: true, get: function () { return history_1.listGrid3Users; } });
-Object.defineProperty(exports, "listHistorySnapUsers", { enumerable: true, get: function () { return history_1.listSnapUsers; } });
+// Validation namespace
+exports.Validation = __importStar(require("./validation"));
+// Processor namespaces (platform-specific utilities)
+exports.Gridset = __importStar(require("./gridset"));
+exports.Snap = __importStar(require("./snap"));
+exports.OBF = __importStar(require("./obf"));
+exports.Obfset = __importStar(require("./obfset"));
+exports.TouchChat = __importStar(require("./touchchat"));
+exports.Dot = __importStar(require("./dot"));
+exports.Excel = __importStar(require("./excel"));
+exports.Opml = __importStar(require("./opml"));
+exports.ApplePanels = __importStar(require("./applePanels"));
+exports.AstericsGrid = __importStar(require("./astericsGrid"));
+exports.Translation = __importStar(require("./translation"));
 const dotProcessor_1 = require("./processors/dotProcessor");
 const excelProcessor_1 = require("./processors/excelProcessor");
 const opmlProcessor_1 = require("./processors/opmlProcessor");
@@ -56,6 +81,10 @@ const obfsetProcessor_1 = require("./processors/obfsetProcessor");
  * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')
  * @returns The appropriate processor instance
  * @throws Error if the file extension is not supported
+ *
+ * @example
+ * const processor = getProcessor('/path/to/file.gridset');
+ * const tree = processor.loadIntoTree('/path/to/file.gridset');
  */
 function getProcessor(filePathOrExtension) {
     // Extract extension from file path

package/dist/obf.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OBF (Open Board Format) Namespace
+ *
+ * All OBF/OBZ-specific utilities, helpers, and types.
+ */
+export { ObfProcessor } from './processors/obfProcessor';
+export { ObfsetProcessor } from './processors/obfsetProcessor';

package/dist/obf.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * OBF (Open Board Format) Namespace
+ *
+ * All OBF/OBZ-specific utilities, helpers, and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObfsetProcessor = exports.ObfProcessor = void 0;
+// Processor class
+var obfProcessor_1 = require("./processors/obfProcessor");
+Object.defineProperty(exports, "ObfProcessor", { enumerable: true, get: function () { return obfProcessor_1.ObfProcessor; } });
+var obfsetProcessor_1 = require("./processors/obfsetProcessor");
+Object.defineProperty(exports, "ObfsetProcessor", { enumerable: true, get: function () { return obfsetProcessor_1.ObfsetProcessor; } });
+// Note: OBF doesn't currently have platform-specific helpers like Gridset/Snap
+// Future helper functions can be added here

package/dist/obfset.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Obfset Namespace
+ *
+ * OBF Set (multiple OBF files) processing.
+ */
+export { ObfsetProcessor } from './processors/obfsetProcessor';

package/dist/obfset.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Obfset Namespace
+ *
+ * OBF Set (multiple OBF files) processing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObfsetProcessor = void 0;
+// Processor class
+var obfsetProcessor_1 = require("./processors/obfsetProcessor");
+Object.defineProperty(exports, "ObfsetProcessor", { enumerable: true, get: function () { return obfsetProcessor_1.ObfsetProcessor; } });
+// Note: Obfset doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/opml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OPML (Outline Processor Markup Language) Namespace
+ *
+ * OPML format processing for hierarchical communication boards.
+ */
+export { OpmlProcessor } from './processors/opmlProcessor';

package/dist/opml.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * OPML (Outline Processor Markup Language) Namespace
+ *
+ * OPML format processing for hierarchical communication boards.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpmlProcessor = void 0;
+// Processor class
+var opmlProcessor_1 = require("./processors/opmlProcessor");
+Object.defineProperty(exports, "OpmlProcessor", { enumerable: true, get: function () { return opmlProcessor_1.OpmlProcessor; } });
+// Note: OPML doesn't currently have platform-specific helpers
+// Future helper functions can be added here

package/dist/processors/gridset/commands.js

@@ -699,6 +699,21 @@ exports.GRID3_COMMANDS = {
         description: 'Clear word prediction buffer',
         platforms: ['desktop', 'ios', 'medicare', 'medicareBionics'],
     },
+    'Prediction.PredictThis': {
+        id: 'Prediction.PredictThis',
+        category: Grid3CommandCategory.AUTO_CONTENT,
+        pluginId: 'prediction',
+        displayName: 'Predict This',
+        description: 'Provide suggestions based on word list',
+        parameters: [
+            {
+                key: 'wordlist',
+                type: 'string', // Actually highly structured, but string type is a placeholder
+                required: true,
+                description: 'Word list for prediction',
+            },
+        ],
+    },
     'Grammar.Change': {
         id: 'Grammar.Change',
         category: Grid3CommandCategory.AUTO_CONTENT,

package/dist/processors/gridset/pluginTypes.js

@@ -128,12 +128,12 @@ function detectPluginCellType(content) {
     }
     // AutoContent detection - dynamic word/content suggestions
     if (contentType === 'AutoContent' || content.Style?.BasedOnStyle === 'AutoContent') {
-        const autoContentType = extractAutoContentType(content);
+        const autoContentType = extractAutoContentType(content) || contentSubType;
         return {
             cellType: Grid3CellType.AutoContent,
-            autoContentType: autoContentType || undefined,
-            pluginId: inferAutoContentPlugin(autoContentType),
-            displayName: autoContentType || 'Auto Content',
+            autoContentType: autoContentType ? String(autoContentType) : undefined,
+            pluginId: inferAutoContentPlugin(autoContentType ? String(autoContentType) : undefined),
+            displayName: autoContentType ? String(autoContentType) : 'Auto Content',
         };
     }
     // Regular cell

package/dist/processors/gridsetProcessor.d.ts

@@ -12,6 +12,10 @@ declare class GridsetProcessor extends BaseProcessor {
     private decryptGridsetEntry;
     private getGridsetPassword;
     private ensureAlphaChannel;
+    /**
+     * Extract words from Grid3 WordList structure
+     */
+    private _extractWordsFromWordList;
     private generateCommandsFromSemanticAction;
     private convertGrid3StyleToAACStyle;
     private getStyleById;