@willwade/aac-processors 0.0.14 → 0.0.15

package/dist/processors/index.js

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

package/dist/snap.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Snap (Tobii Dynavox) Namespace
+ *
+ * All Snap-specific utilities, helpers, and types.
+ */
+export { SnapProcessor } from './processors/snapProcessor';
+export { getPageTokenImageMap, getAllowedImageEntries, openImage, findSnapPackages, findSnapPackagePath, findSnapUsers, findSnapUserVocabularies, findSnapUserHistory, isSnapInstalled, readSnapUsage, readSnapUsageForUser, type SnapPackagePath, type SnapUserInfo, type SnapUsageEntry, } from './processors/snap/helpers';

package/dist/snap.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Snap (Tobii Dynavox) Namespace
+ *
+ * All Snap-specific utilities, helpers, and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSnapUsageForUser = exports.readSnapUsage = exports.isSnapInstalled = exports.findSnapUserHistory = exports.findSnapUserVocabularies = exports.findSnapUsers = exports.findSnapPackagePath = exports.findSnapPackages = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.SnapProcessor = void 0;
+// Processor class
+var snapProcessor_1 = require("./processors/snapProcessor");
+Object.defineProperty(exports, "SnapProcessor", { enumerable: true, get: function () { return snapProcessor_1.SnapProcessor; } });
+// === Snap Helpers ===
+var helpers_1 = require("./processors/snap/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, "findSnapPackages", { enumerable: true, get: function () { return helpers_1.findSnapPackages; } });
+Object.defineProperty(exports, "findSnapPackagePath", { enumerable: true, get: function () { return helpers_1.findSnapPackagePath; } });
+Object.defineProperty(exports, "findSnapUsers", { enumerable: true, get: function () { return helpers_1.findSnapUsers; } });
+Object.defineProperty(exports, "findSnapUserVocabularies", { enumerable: true, get: function () { return helpers_1.findSnapUserVocabularies; } });
+Object.defineProperty(exports, "findSnapUserHistory", { enumerable: true, get: function () { return helpers_1.findSnapUserHistory; } });
+Object.defineProperty(exports, "isSnapInstalled", { enumerable: true, get: function () { return helpers_1.isSnapInstalled; } });
+Object.defineProperty(exports, "readSnapUsage", { enumerable: true, get: function () { return helpers_1.readSnapUsage; } });
+Object.defineProperty(exports, "readSnapUsageForUser", { enumerable: true, get: function () { return helpers_1.readSnapUsageForUser; } });

package/dist/touchchat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TouchChat (PRC-Saltillo) Namespace
+ *
+ * All TouchChat-specific utilities, helpers, and types.
+ */
+export { TouchChatProcessor } from './processors/touchchatProcessor';
+export { getPageTokenImageMap, getAllowedImageEntries, openImage, } from './processors/touchchat/helpers';

package/dist/touchchat.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * TouchChat (PRC-Saltillo) Namespace
+ *
+ * All TouchChat-specific utilities, helpers, and types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.TouchChatProcessor = void 0;
+// Processor class
+var touchchatProcessor_1 = require("./processors/touchchatProcessor");
+Object.defineProperty(exports, "TouchChatProcessor", { enumerable: true, get: function () { return touchchatProcessor_1.TouchChatProcessor; } });
+// === TouchChat Helpers ===
+var helpers_1 = require("./processors/touchchat/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; } });

package/dist/translation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Translation Namespace
+ *
+ * LLM-based translation utilities for AAC files with symbol preservation.
+ *
+ * These utilities are used by processor classes. See individual processors for:
+ * - extractSymbolsForLLM() - method on GridsetProcessor, ObfProcessor, TouchChatProcessor, SnapProcessor
+ * - processLLMTranslations() - method on GridsetProcessor, ObfProcessor, TouchChatProcessor, SnapProcessor
+ *
+ * Or use the lower-level utilities directly:
+ */
+export { normalizeButtonForTranslation, extractSymbolsFromButton, extractAllButtonsForTranslation, createTranslationPrompt, validateTranslationResults, type SymbolInfo, type ButtonForTranslation, type LLMLTranslationResult, } from './utilities/translation/translationProcessor';
+export { type TranslatedString, type SourceString } from './core/baseProcessor';

package/dist/translation.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Translation Namespace
+ *
+ * LLM-based translation utilities for AAC files with symbol preservation.
+ *
+ * These utilities are used by processor classes. See individual processors for:
+ * - extractSymbolsForLLM() - method on GridsetProcessor, ObfProcessor, TouchChatProcessor, SnapProcessor
+ * - processLLMTranslations() - method on GridsetProcessor, ObfProcessor, TouchChatProcessor, SnapProcessor
+ *
+ * Or use the lower-level utilities directly:
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTranslationResults = exports.createTranslationPrompt = exports.extractAllButtonsForTranslation = exports.extractSymbolsFromButton = exports.normalizeButtonForTranslation = void 0;
+// LLM translation utilities
+var translationProcessor_1 = require("./utilities/translation/translationProcessor");
+Object.defineProperty(exports, "normalizeButtonForTranslation", { enumerable: true, get: function () { return translationProcessor_1.normalizeButtonForTranslation; } });
+Object.defineProperty(exports, "extractSymbolsFromButton", { enumerable: true, get: function () { return translationProcessor_1.extractSymbolsFromButton; } });
+Object.defineProperty(exports, "extractAllButtonsForTranslation", { enumerable: true, get: function () { return translationProcessor_1.extractAllButtonsForTranslation; } });
+Object.defineProperty(exports, "createTranslationPrompt", { enumerable: true, get: function () { return translationProcessor_1.createTranslationPrompt; } });
+Object.defineProperty(exports, "validateTranslationResults", { enumerable: true, get: function () { return translationProcessor_1.validateTranslationResults; } });

package/dist/validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation Namespace
+ *
+ * All validation functionality for AAC processors.
+ * Provides consistent validation across all supported formats.
+ */
+export { ValidationError, ValidationCheck, ValidationResult, ValidationOptions, ValidationRule, } from './validation/validationTypes';
+export { BaseValidator } from './validation/baseValidator';
+export { ObfValidator } from './validation/obfValidator';
+export { GridsetValidator } from './validation/gridsetValidator';
+export { SnapValidator } from './validation/snapValidator';
+export { TouchChatValidator } from './validation/touchChatValidator';
+export { getValidatorForFormat, getValidatorForFile } from './validation/index';

package/dist/validation.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Validation Namespace
+ *
+ * All validation functionality for AAC processors.
+ * Provides consistent validation across all supported formats.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValidatorForFile = exports.getValidatorForFormat = exports.TouchChatValidator = exports.SnapValidator = exports.GridsetValidator = exports.ObfValidator = exports.BaseValidator = exports.ValidationError = void 0;
+// Validation types and interfaces
+var validationTypes_1 = require("./validation/validationTypes");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return validationTypes_1.ValidationError; } });
+// Base validator
+var baseValidator_1 = require("./validation/baseValidator");
+Object.defineProperty(exports, "BaseValidator", { enumerable: true, get: function () { return baseValidator_1.BaseValidator; } });
+// Format-specific validators
+var obfValidator_1 = require("./validation/obfValidator");
+Object.defineProperty(exports, "ObfValidator", { enumerable: true, get: function () { return obfValidator_1.ObfValidator; } });
+var gridsetValidator_1 = require("./validation/gridsetValidator");
+Object.defineProperty(exports, "GridsetValidator", { enumerable: true, get: function () { return gridsetValidator_1.GridsetValidator; } });
+var snapValidator_1 = require("./validation/snapValidator");
+Object.defineProperty(exports, "SnapValidator", { enumerable: true, get: function () { return snapValidator_1.SnapValidator; } });
+var touchChatValidator_1 = require("./validation/touchChatValidator");
+Object.defineProperty(exports, "TouchChatValidator", { enumerable: true, get: function () { return touchChatValidator_1.TouchChatValidator; } });
+// Validator factory functions
+var index_1 = require("./validation/index");
+Object.defineProperty(exports, "getValidatorForFormat", { enumerable: true, get: function () { return index_1.getValidatorForFormat; } });
+Object.defineProperty(exports, "getValidatorForFile", { enumerable: true, get: function () { return index_1.getValidatorForFile; } });

package/package.json

@@ -1,9 +1,63 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./gridset": {
+      "types": "./dist/gridset.d.ts",
+      "default": "./dist/gridset.js"
+    },
+    "./snap": {
+      "types": "./dist/snap.d.ts",
+      "default": "./dist/snap.js"
+    },
+    "./obf": {
+      "types": "./dist/obf.d.ts",
+      "default": "./dist/obf.js"
+    },
+    "./obfset": {
+      "types": "./dist/obfset.d.ts",
+      "default": "./dist/obfset.js"
+    },
+    "./touchchat": {
+      "types": "./dist/touchchat.d.ts",
+      "default": "./dist/touchchat.js"
+    },
+    "./dot": {
+      "types": "./dist/dot.d.ts",
+      "default": "./dist/dot.js"
+    },
+    "./excel": {
+      "types": "./dist/excel.d.ts",
+      "default": "./dist/excel.js"
+    },
+    "./opml": {
+      "types": "./dist/opml.d.ts",
+      "default": "./dist/opml.js"
+    },
+    "./applePanels": {
+      "types": "./dist/applePanels.d.ts",
+      "default": "./dist/applePanels.js"
+    },
+    "./astericsGrid": {
+      "types": "./dist/astericsGrid.d.ts",
+      "default": "./dist/astericsGrid.js"
+    },
+    "./translation": {
+      "types": "./dist/translation.d.ts",
+      "default": "./dist/translation.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "default": "./dist/validation.js"
+    }
+  },
   "files": [
     "dist/**/*",
     "docs/**/*",
@@ -69,8 +123,8 @@
   },
   "homepage": "https://github.com/willwade/AACProcessors-nodejs#readme",
   "engines": {
-    "node": ">=16.0.0",
-    "npm": ">=8.0.0"
+    "node": ">=20.0.0",
+    "npm": ">=9.0.0"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.7",
@@ -96,7 +150,7 @@
     "@types/xml2js": "^0.4.14",
     "adm-zip": "^0.5.16",
     "axios": "^1.11.0",
-    "better-sqlite3": "^11.9.1",
+    "better-sqlite3": "^12.5.0",
     "commander": "^13.1.0",
     "exceljs": "^4.4.0",
     "fast-xml-parser": "^5.2.0",

package/dist/utilities/screenshotConverter.d.ts

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