@willwade/aac-processors 0.0.14 → 0.0.15

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)
 
 ---
@@ -194,6 +194,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 +244,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";

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/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/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * AAC Processor Classes
+ *
+ * All processor classes for different AAC file formats.
+ * For platform-specific utilities (Gridset, Snap, etc.), use the namespace imports:
+ * - import { Gridset } from 'aac-processors/gridset';
+ * - import { Snap } from 'aac-processors/snap';
+ */
 export { ApplePanelsProcessor } from './applePanelsProcessor';
 export { DotProcessor } from './dotProcessor';
 export { ExcelProcessor } from './excelProcessor';
@@ -8,21 +16,3 @@ export { SnapProcessor } from './snapProcessor';
 export { TouchChatProcessor } from './touchchatProcessor';
 export { AstericsGridProcessor } from './astericsGridProcessor';
 export { ObfsetProcessor } from './obfsetProcessor';
-export { getPageTokenImageMap, getAllowedImageEntries, openImage, generateGrid3Guid, createSettingsXml, createFileMapXml, getCommonDocumentsPath, findGrid3UserPaths, findGrid3HistoryDatabases, findGrid3Users, findGrid3Vocabularies, findGrid3UserHistory, isGrid3Installed, readGrid3History, readGrid3HistoryForUser, readAllGrid3History, type Grid3UserPath, type Grid3VocabularyPath, type Grid3HistoryEntry, } from './gridset/helpers';
-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, 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';