@willwade/aac-processors 0.0.13 → 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,23 +194,63 @@ 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)**.
 
 #### **Key Metrics Features**
+
 - **Effort Scores**: Calculate the physical/cognitive cost of any word (Distance, Field Size, Motor Planning).
 - **Vocabulary Coverage**: Compare board sets against core vocabulary lists (e.g., Anderson & Bitner).
 - **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';
+import { ObfsetProcessor, Analytics } from "@willwade/aac-processors";
 
 const processor = new ObfsetProcessor();
-const tree = processor.loadIntoTree('my_pageset.obfset');
+const tree = processor.loadIntoTree("my_pageset.obfset");
 
 // Run clinical effort analysis
 const result = new Analytics.MetricsCalculator().analyze(tree);
@@ -738,6 +778,7 @@ npm run coverage:report
 ### 🛠️ Utility Scripts
 
 A wide range of utility scripts for batch processing, audio generation, and advanced analysis are available in the **[scripts/](./scripts/README.md)** directory. These include:
+
 - **Analysis**: Pageset reporting and vocabulary extraction.
 - **Audio**: Automated TTS generation and audio-enhanced pageset creation.
 - **Conversion**: TSV-to-Gridset and other format-shifting tools.
@@ -845,13 +886,10 @@ Inspired by the Python AACProcessors project
 
 - [ ] **Adaptive Metrics** - Expand scanning analysis to include dwell times and more complex switch logic configurations.
 
-
 ### Low Priority
 
-
 - [ ] **Batch processing CLI** - Process multiple files/directories in parallel.
 
-
 ### Contributing
 
 Want to help with any of these items? See our [Contributing Guidelines](#-contributing) and pick an issue that interests you!

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

@@ -1,3 +1,44 @@
+/**
+ * Base Processor for AAC File Formats
+ *
+ * This module provides base functionality for processing AAC (Augmentative and Alternative
+ * Communication) files across various formats (gridset, OBF, Snap, TouchChat, etc.).
+ *
+ * ## LLM-Based Translation with Symbol Preservation
+ *
+ * All processor formats support LLM-based translation that preserves symbol-to-word
+ * associations across languages. This is critical for AAC systems where visual symbols
+ * are attached to specific words.
+ *
+ * ### Usage Example:
+ *
+ * ```typescript
+ * import { extractAllButtonsForTranslation, createTranslationPrompt } from '../optional/translation/translationProcessor';
+ *
+ * // 1. Extract buttons from your format
+ * const buttons = extractAllButtonsForTranslation(myFormatButtons, (button) => ({
+ *   pageId: button.pageId,
+ *   pageName: button.pageName
+ * }));
+ *
+ * // 2. Create prompt for LLM
+ * const prompt = createTranslationPrompt(buttons, 'Spanish');
+ *
+ * // 3. Send to LLM (Gemini, GPT, etc.) and get response
+ * const llmResponse = await callLLMAPI(prompt);
+ *
+ * // 4. Apply translations to your format
+ * processor.processLLMTranslations(filePath, llmResponse, outputPath);
+ * ```
+ *
+ * ### Format-Specific Implementation:
+ *
+ * Each processor should implement:
+ * - `extractSymbolsForLLM()` - Uses extractAllButtonsForTranslation() utility
+ * - `processLLMTranslations()` - Applies translations using format-specific logic
+ *
+ * See `src/utilities/translation/translationProcessor.ts` for shared utilities.
+ */
 import { AACTree, AACButton } from './treeStructure';
 import { StringCasing } from './stringCasing';
 import { ValidationResult } from '../validation/validationTypes';

package/dist/core/baseProcessor.js

@@ -1,4 +1,45 @@
 "use strict";
+/**
+ * Base Processor for AAC File Formats
+ *
+ * This module provides base functionality for processing AAC (Augmentative and Alternative
+ * Communication) files across various formats (gridset, OBF, Snap, TouchChat, etc.).
+ *
+ * ## LLM-Based Translation with Symbol Preservation
+ *
+ * All processor formats support LLM-based translation that preserves symbol-to-word
+ * associations across languages. This is critical for AAC systems where visual symbols
+ * are attached to specific words.
+ *
+ * ### Usage Example:
+ *
+ * ```typescript
+ * import { extractAllButtonsForTranslation, createTranslationPrompt } from '../optional/translation/translationProcessor';
+ *
+ * // 1. Extract buttons from your format
+ * const buttons = extractAllButtonsForTranslation(myFormatButtons, (button) => ({
+ *   pageId: button.pageId,
+ *   pageName: button.pageName
+ * }));
+ *
+ * // 2. Create prompt for LLM
+ * const prompt = createTranslationPrompt(buttons, 'Spanish');
+ *
+ * // 3. Send to LLM (Gemini, GPT, etc.) and get response
+ * const llmResponse = await callLLMAPI(prompt);
+ *
+ * // 4. Apply translations to your format
+ * processor.processLLMTranslations(filePath, llmResponse, outputPath);
+ * ```
+ *
+ * ### Format-Specific Implementation:
+ *
+ * Each processor should implement:
+ * - `extractSymbolsForLLM()` - Uses extractAllButtonsForTranslation() utility
+ * - `processLLMTranslations()` - Applies translations using format-specific logic
+ *
+ * See `src/utilities/translation/translationProcessor.ts` for shared utilities.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseProcessor = void 0;
 const treeStructure_1 = require("./treeStructure");

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 './optional/analytics';
-export { collectUnifiedHistory, listGrid3Users as listHistoryGrid3Users, listSnapUsers as listHistorySnapUsers, } from './optional/analytics/history';
+export * as Analytics from './utilities/analytics';
+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);
-exports.Analytics = __importStar(require("./optional/analytics"));
-var history_1 = require("./optional/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; } });
+// ===================================================================
+// NAMESPACES
+// ===================================================================
+// Analytics namespace
+exports.Analytics = __importStar(require("./utilities/analytics"));
+// 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