@willwade/aac-processors 0.0.11 → 0.0.13

package/dist/processors/gridset/pluginTypes.js

@@ -106,10 +106,10 @@ function detectPluginCellType(content) {
     if (!content) {
         return { cellType: Grid3CellType.Regular };
     }
-    const contentType = content.ContentType || content.contenttype || content.ContentType;
-    const contentSubType = content.ContentSubType || content.contentsubtype || content.ContentSubType;
+    const contentType = content.ContentType || content.contenttype;
+    const contentSubType = content.ContentSubType || content.contentsubtype;
     // Workspace cells - full editing workspaces
-    if (contentType === 'Workspace') {
+    if (contentType === 'Workspace' || content.Style?.BasedOnStyle === 'Workspace') {
         return {
             cellType: Grid3CellType.Workspace,
             subType: contentSubType || undefined,
@@ -118,7 +118,7 @@ function detectPluginCellType(content) {
         };
     }
     // LiveCell detection - dynamic content displays
-    if (contentType === 'LiveCell') {
+    if (contentType === 'LiveCell' || content.Style?.BasedOnStyle === 'LiveCell') {
         return {
             cellType: Grid3CellType.LiveCell,
             liveCellType: contentSubType || undefined,
@@ -127,7 +127,7 @@ function detectPluginCellType(content) {
         };
     }
     // AutoContent detection - dynamic word/content suggestions
-    if (contentType === 'AutoContent') {
+    if (contentType === 'AutoContent' || content.Style?.BasedOnStyle === 'AutoContent') {
         const autoContentType = extractAutoContentType(content);
         return {
             cellType: Grid3CellType.AutoContent,
@@ -172,38 +172,38 @@ function inferWorkspacePlugin(subType) {
         return undefined;
     const normalized = subType.toLowerCase();
     if (normalized.includes('chat'))
-        return 'chat';
+        return 'Grid3.Chat';
     if (normalized.includes('email') || normalized.includes('mail'))
-        return 'email';
-    if (normalized.includes('word') || normalized.includes('processor'))
-        return 'wordprocessor';
+        return 'Grid3.Email';
+    if (normalized.includes('word') || normalized.includes('doc'))
+        return 'Grid3.WordProcessor';
     if (normalized.includes('phone'))
-        return 'phone';
+        return 'Grid3.Phone';
     if (normalized.includes('sms') || normalized.includes('text'))
-        return 'sms';
-    if (normalized.includes('web') || normalized.includes('browser'))
-        return 'webbrowser';
-    if (normalized.includes('computer') || normalized.includes('control'))
-        return 'computercontrol';
-    if (normalized.includes('calculator') || normalized.includes('calc'))
-        return 'calculator';
-    if (normalized.includes('timer') || normalized.includes('stopwatch'))
-        return 'timer';
+        return 'Grid3.Sms';
+    if (normalized.includes('browser') || normalized.includes('web'))
+        return 'Grid3.WebBrowser';
+    if (normalized.includes('computer'))
+        return 'Grid3.ComputerControl';
+    if (normalized.includes('calc'))
+        return 'Grid3.Calculator';
+    if (normalized.includes('timer'))
+        return 'Grid3.Timer';
     if (normalized.includes('music') || normalized.includes('video'))
-        return 'musicvideo';
+        return 'Grid3.MusicVideo';
     if (normalized.includes('photo') || normalized.includes('image'))
-        return 'photos';
+        return 'Grid3.Photos';
     if (normalized.includes('contact'))
-        return 'contacts';
+        return 'Grid3.Contacts';
     if (normalized.includes('learning'))
-        return 'interactivelearning';
-    if (normalized.includes('message') && normalized.includes('bank'))
-        return 'messagebanking';
-    if (normalized.includes('env') || normalized.includes('ir'))
-        return 'environmentcontrol';
-    if (normalized.includes('setting'))
-        return 'settings';
-    return undefined;
+        return 'Grid3.InteractiveLearning';
+    if (normalized.includes('message') && normalized.includes('banking'))
+        return 'Grid3.MessageBanking';
+    if (normalized.includes('control'))
+        return 'Grid3.EnvironmentControl';
+    if (normalized.includes('settings'))
+        return 'Grid3.Settings';
+    return `Grid3.${subType}`;
 }
 /**
  * Infer plugin ID from live cell type
@@ -212,24 +212,25 @@ function inferLiveCellPlugin(liveCellType) {
     if (!liveCellType)
         return undefined;
     const normalized = liveCellType.toLowerCase();
-    if (normalized.includes('clock') || normalized.includes('time') || normalized.includes('date')) {
-        return 'clock';
-    }
+    if (normalized.includes('clock'))
+        return 'Grid3.Clock';
+    if (normalized.includes('date'))
+        return 'Grid3.Clock';
     if (normalized.includes('volume'))
-        return 'speech';
+        return 'Grid3.Volume';
     if (normalized.includes('speed'))
-        return 'speech';
+        return 'Grid3.Speed';
     if (normalized.includes('voice'))
-        return 'speech';
+        return 'Grid3.Speech';
     if (normalized.includes('message'))
-        return 'chat';
+        return 'Grid3.Chat';
     if (normalized.includes('battery'))
-        return 'settings';
-    if (normalized.includes('wifi') || normalized.includes('network'))
-        return 'settings';
+        return 'Grid3.Battery';
+    if (normalized.includes('wifi'))
+        return 'Grid3.Wifi';
     if (normalized.includes('bluetooth'))
-        return 'settings';
-    return undefined;
+        return 'Grid3.Bluetooth';
+    return `Grid3.${liveCellType}`;
 }
 /**
  * Infer plugin ID from auto content type
@@ -239,24 +240,24 @@ function inferAutoContentPlugin(autoContentType) {
         return undefined;
     const normalized = autoContentType.toLowerCase();
     if (normalized.includes('voice') || normalized.includes('speed'))
-        return 'speech';
+        return 'Grid3.Speech';
     if (normalized.includes('email') || normalized.includes('mail'))
-        return 'email';
+        return 'Grid3.Email';
     if (normalized.includes('phone'))
-        return 'phone';
+        return 'Grid3.Phone';
     if (normalized.includes('sms') || normalized.includes('text'))
-        return 'sms';
+        return 'Grid3.Sms';
     if (normalized.includes('web') ||
         normalized.includes('favorite') ||
         normalized.includes('history')) {
-        return 'webbrowser';
+        return 'Grid3.WebBrowser';
     }
     if (normalized.includes('prediction'))
-        return 'prediction';
+        return 'Grid3.Prediction';
     if (normalized.includes('grammar'))
-        return 'grammar';
+        return 'Grid3.Grammar';
     if (normalized.includes('context'))
-        return 'autocontent';
+        return 'Grid3.AutoContent';
     return undefined;
 }
 /**

package/dist/processors/gridset/symbolExtractor.js

@@ -154,10 +154,11 @@ function extractSymbolLibraryImage(reference, options = {}) {
         };
     }
     // Successfully extracted!
-    const format = detectImageFormat(resolved.data);
+    const data = resolved.data;
+    const format = data ? detectImageFormat(data) : 'unknown';
     return {
         found: true,
-        data: resolved.data,
+        data,
         format,
         source: 'symbol-library',
         reference: reference,

package/dist/processors/gridset/symbolSearch.js

@@ -126,13 +126,15 @@ function searchSymbols(searchTerm, options = {}) {
         // Exact match first
         if (index.searchTerms.has(lowerSearchTerm)) {
             const symbolFilename = index.searchTerms.get(lowerSearchTerm);
-            results.push({
-                searchTerm: lowerSearchTerm,
-                symbolFilename,
-                displayName: index.filenames.get(symbolFilename) || lowerSearchTerm,
-                library: libraryName,
-                exactMatch: true,
-            });
+            if (symbolFilename) {
+                results.push({
+                    searchTerm: lowerSearchTerm,
+                    symbolFilename,
+                    displayName: index.filenames.get(symbolFilename) || lowerSearchTerm,
+                    library: libraryName,
+                    exactMatch: true,
+                });
+            }
         }
         // Fuzzy match if enabled
         if (options.fuzzyMatch !== false) {

package/dist/processors/gridsetProcessor.js

@@ -19,6 +19,7 @@ const pluginTypes_1 = require("./gridset/pluginTypes");
 const commands_1 = require("./gridset/commands");
 const symbols_1 = require("./gridset/symbols");
 const resolver_2 = require("./gridset/resolver");
+const idGenerator_1 = require("../optional/analytics/utils/idGenerator");
 class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -489,18 +490,62 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         const cellY = Math.max(0, parseInt(String(cell['@_Y'] || '1'), 10) - 1);
                         const colSpan = parseInt(String(cell['@_ColumnSpan'] || '1'), 10);
                         const rowSpan = parseInt(String(cell['@_RowSpan'] || '1'), 10);
+                        // Extract scan block number (1-8) for block scanning support
+                        const scanBlock = parseInt(String(cell['@_ScanBlock'] || '1'), 10);
+                        // Extract visibility from Grid 3's <Visibility> child element
+                        // Grid 3 stores visibility as a child element, not an attribute
+                        // Valid values: Visible, Hidden, Disabled, PointerAndTouchOnly, TouchOnly, PointerOnly
+                        const grid3Visibility = cell.Visibility || cell.visibility;
+                        // Map Grid 3 visibility values to AAC standard values
+                        // Grid 3 can have additional values like TouchOnly, PointerOnly that map to PointerAndTouchOnly
+                        let cellVisibility;
+                        if (grid3Visibility) {
+                            const vis = String(grid3Visibility);
+                            // Direct mapping for standard values
+                            if (vis === 'Visible' ||
+                                vis === 'Hidden' ||
+                                vis === 'Disabled' ||
+                                vis === 'PointerAndTouchOnly') {
+                                cellVisibility = vis;
+                            }
+                            // Map Grid 3 specific values to AAC standard
+                            else if (vis === 'TouchOnly' || vis === 'PointerOnly') {
+                                cellVisibility = 'PointerAndTouchOnly';
+                            }
+                            // Grid 3 may use 'Empty' for cells that exist but have no content
+                            else if (vis === 'Empty') {
+                                cellVisibility = 'Empty';
+                            }
+                            // Unknown visibility - default to Visible
+                            else {
+                                cellVisibility = undefined; // Let it default
+                            }
+                        }
                         // Extract label from CaptionAndImage/Caption
                         const content = cell.Content;
                         const captionAndImage = content.CaptionAndImage || content.captionAndImage;
                         let label = captionAndImage?.Caption || captionAndImage?.caption || '';
+                        // Check if cell has an image/symbol (needed to decide if we should keep it)
+                        const hasImageCandidate = !!(captionAndImage?.Image ||
+                            captionAndImage?.image ||
+                            captionAndImage?.ImageName ||
+                            captionAndImage?.imageName ||
+                            captionAndImage?.Symbol ||
+                            captionAndImage?.symbol);
                         // If no caption, try other sources or create a placeholder
                         if (!label) {
-                            // For cells without captions (like AutoContent cells), create a meaningful label
+                            // For cells without captions, check if they have images/symbols before skipping
                             if (content.ContentType === 'AutoContent') {
                                 label = `AutoContent_${idx}`;
                             }
+                            else if (hasImageCandidate ||
+                                content.ContentType === 'Workspace' ||
+                                content.ContentType === 'LiveCell') {
+                                // Keep cells with images/symbols even if no caption
+                                label = `Cell_${idx}`;
+                            }
                             else {
-                                return; // Skip cells without labels
+                                return; // Skip cells without labels AND without images/symbols
                             }
                         }
                         const message = label; // Use caption as message
@@ -922,12 +967,14 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                             message: String(message),
                             targetPageId: navigationTarget ? String(navigationTarget) : undefined,
                             semanticAction: semanticAction,
+                            semantic_id: cell.semantic_id || cell.SemanticId || undefined, // Extract semantic_id if present
                             image: declaredImageName,
                             resolvedImageEntry: resolvedImageEntry,
                             x: cellX,
                             y: cellY,
                             columnSpan: colSpan,
                             rowSpan: rowSpan,
+                            scanBlock: scanBlock, // Add scan block number for block scanning metrics
                             contentType: pluginMetadata.cellType === pluginTypes_1.Grid3CellType.Regular
                                 ? 'Normal'
                                 : pluginMetadata.cellType === pluginTypes_1.Grid3CellType.Workspace
@@ -940,6 +987,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                 pluginMetadata.autoContentType,
                             symbolLibrary: symbolLibraryRef?.library || undefined,
                             symbolPath: symbolLibraryRef?.path || undefined,
+                            visibility: cellVisibility,
                             style: {
                                 ...cellStyle,
                                 ...inlineStyle, // Inline styles override referenced styles
@@ -963,6 +1011,29 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     });
                     // Set the page's grid layout
                     page.grid = gridLayout;
+                    // Generate clone_id for each button in the grid
+                    const semanticIds = [];
+                    const cloneIds = [];
+                    gridLayout.forEach((row, rowIndex) => {
+                        row.forEach((btn, colIndex) => {
+                            if (btn) {
+                                // Generate clone_id based on position and label
+                                btn.clone_id = (0, idGenerator_1.generateCloneId)(maxRows, maxCols, rowIndex, colIndex, btn.label);
+                                cloneIds.push(btn.clone_id);
+                                // Track semantic_id if present
+                                if (btn.semantic_id) {
+                                    semanticIds.push(btn.semantic_id);
+                                }
+                            }
+                        });
+                    });
+                    // Track IDs on the page
+                    if (semanticIds.length > 0) {
+                        page.semantic_ids = semanticIds;
+                    }
+                    if (cloneIds.length > 0) {
+                        page.clone_ids = cloneIds;
+                    }
                 }
                 tree.addPage(page);
             }
@@ -1143,30 +1214,18 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     GridGuid: page.id,
                     // Calculate grid dimensions based on actual layout
                     ColumnDefinitions: this.calculateColumnDefinitions(page),
-                    RowDefinitions: this.calculateRowDefinitions(page),
+                    RowDefinitions: this.calculateRowDefinitions(page, false), // No automatic workspace row injection
                     AutoContentCommands: '',
                     Cells: page.buttons.length > 0
                         ? {
                             Cell: [
-                                // Add workspace/message bar cell at the top of ALL pages
-                                // Grid3 uses 0-based coordinates; omit X and Y to use defaults (0, 0)
-                                {
-                                    '@_ColumnSpan': 4,
-                                    Content: {
-                                        ContentType: 'Workspace',
-                                        ContentSubType: 'Chat',
-                                        Style: {
-                                            BasedOnStyle: 'Workspace',
-                                        },
-                                    },
-                                },
                                 // Regular button cells
                                 ...this.filterPageButtons(page.buttons).map((button, btnIndex) => {
                                     const buttonStyleId = button.style ? addStyle(button.style) : '';
                                     // Find button position in grid layout
                                     const position = this.findButtonPosition(page, button, btnIndex);
-                                    // Shift all buttons down by 1 row to make room for workspace
-                                    const yOffset = 1;
+                                    // Use position directly from tree
+                                    const yOffset = 0;
                                     // Build CaptionAndImage object
                                     const captionAndImage = {
                                         Caption: button.label || '',
@@ -1207,6 +1266,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                         '@_ColumnSpan': position.columnSpan,
                                         '@_RowSpan': position.rowSpan,
                                         Content: {
+                                            ContentType: button.contentType === 'Normal' ? undefined : button.contentType,
+                                            ContentSubType: button.contentSubType,
                                             Commands: this.generateCommandsFromSemanticAction(button, tree),
                                             CaptionAndImage: captionAndImage,
                                         },
@@ -1322,15 +1383,16 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         };
     }
     // Helper method to calculate row definitions based on page layout
-    calculateRowDefinitions(page) {
+    calculateRowDefinitions(page, addWorkspaceOffset = false) {
         let maxRows = 4; // Default minimum
+        const offset = addWorkspaceOffset ? 1 : 0;
         if (page.grid && page.grid.length > 0) {
-            maxRows = Math.max(maxRows, page.grid.length);
+            maxRows = Math.max(maxRows, page.grid.length + offset);
         }
         else {
             // Fallback: estimate from button count
             const estimatedCols = Math.ceil(Math.sqrt(page.buttons.length));
-            maxRows = Math.max(4, Math.ceil(page.buttons.length / estimatedCols));
+            maxRows = Math.max(4, Math.ceil(page.buttons.length / estimatedCols)) + offset;
         }
         return {
             RowDefinition: Array(maxRows).fill({}),

package/dist/processors/index.d.ts

@@ -7,6 +7,7 @@ export { OpmlProcessor } from './opmlProcessor';
 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';

package/dist/processors/index.js

@@ -14,9 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rgbaToHex = exports.getNamedColor = exports.resolveGridsetPasswordFromEnv = exports.resolveGridsetPassword = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.readAllGridsetHistory = exports.readGridsetHistoryForUser = exports.readGridsetHistory = exports.isGridsetInstalled = exports.findGridsetUserHistory = exports.findGridsetVocabularies = exports.findGridsetUsers = exports.findGridsetHistoryDatabases = exports.findGridsetUserPaths = exports.getGridsetCommonDocumentsPath = exports.createGridsetFileMapXml = exports.createGridsetSettingsXml = exports.generateGridsetGuid = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = exports.readAllGrid3History = exports.readGrid3HistoryForUser = exports.readGrid3History = exports.isGrid3Installed = exports.findGrid3UserHistory = exports.findGrid3Vocabularies = exports.findGrid3Users = exports.findGrid3HistoryDatabases = exports.findGrid3UserPaths = exports.getCommonDocumentsPath = exports.createFileMapXml = exports.createSettingsXml = exports.generateGrid3Guid = exports.openImage = exports.getAllowedImageEntries = exports.getPageTokenImageMap = exports.AstericsGridProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.OpmlProcessor = exports.ObfProcessor = exports.GridsetProcessor = exports.ExcelProcessor = exports.DotProcessor = exports.ApplePanelsProcessor = void 0;
-exports.SYMBOL_LIBRARIES = exports.symbolReferenceToFilename = exports.getSymbolSearchIndexesDir = exports.getSymbolLibrariesDir = exports.getDefaultGrid3Path = exports.getSymbolLibraryDisplayName = exports.isKnownSymbolLibrary = exports.getSymbolPath = exports.getSymbolLibraryName = exports.createSymbolReference = exports.analyzeSymbolUsage = exports.extractSymbolReferences = exports.getSymbolLibraryInfo = exports.getAvailableSymbolLibraries = exports.resolveSymbolReference = exports.isSymbolReference = exports.parseSymbolReference = exports.Grid3CommandCategory = exports.GRID3_COMMANDS = exports.extractCommandParameters = exports.getAllPluginIds = exports.getAllCommandIds = exports.getCommandsByCategory = exports.getCommandsByPlugin = exports.getCommandDefinition = exports.detectCommand = exports.isRegularCell = exports.isAutoContentCell = exports.isLiveCell = exports.isWorkspaceCell = exports.getCellTypeDisplayName = exports.AUTOCONTENT_TYPES = exports.LIVECELL_TYPES = exports.WORKSPACE_TYPES = exports.Grid3CellType = exports.detectPluginCellType = exports.ensureAlphaChannelFromStyles = exports.SHAPE_NAMES = exports.CellBackgroundShape = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.ensureAlphaChannel = exports.normalizeColor = exports.darkenColor = exports.toHexColor = exports.clampAlpha = exports.clampColorChannel = exports.channelToHex = void 0;
-exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.readSnapUsageForUser = exports.readSnapUsage = exports.isSnapInstalled = exports.findSnapUserHistory = exports.findSnapUserVocabularies = exports.findSnapUsers = exports.findSnapPackagePath = exports.findSnapPackages = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = exports.getSymbolSearchStats = exports.countLibrarySymbols = exports.getSearchSuggestions = exports.getAllSearchTerms = exports.getSymbolDisplayName = exports.getSymbolFilename = exports.searchSymbolsWithReferences = exports.searchSymbols = exports.loadSearchIndexes = exports.parsePixFile = exports.createSymbolManifest = exports.exportSymbolReferencesToCsv = exports.suggestExtractionStrategy = exports.analyzeSymbolExtraction = exports.convertToAstericsImage = exports.extractSymbolLibraryImage = exports.extractButtonImage = exports.getSymbolSearchDir = exports.getSymbolsDir = exports.parseImageSymbolReference = exports.isSymbolLibraryReference = void 0;
+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;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -35,6 +35,8 @@ var touchchatProcessor_1 = require("./touchchatProcessor");
 Object.defineProperty(exports, "TouchChatProcessor", { enumerable: true, get: function () { return touchchatProcessor_1.TouchChatProcessor; } });
 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; } });

package/dist/processors/obfProcessor.js

@@ -6,12 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-// Removed unused import: FileProcessor
+const idGenerator_1 = require("../optional/analytics/utils/idGenerator");
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const fs_1 = __importDefault(require("fs"));
-// Removed unused import: path
 const obfValidator_1 = require("../validation/obfValidator");
 const OBF_FORMAT_VERSION = 'open-board-0.1';
+/**
+ * Map OBF hidden value to AAC standard visibility
+ * OBF: true = hidden, false/undefined = visible
+ * Maps to: 'Hidden' | 'Visible' | undefined
+ */
+function mapObfVisibility(hidden) {
+    if (hidden === undefined) {
+        return undefined; // Default to visible
+    }
+    return hidden ? 'Hidden' : 'Visible';
+}
 class ObfProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
@@ -42,12 +52,14 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 id: String(btn?.id || ''),
                 label: String(btn?.label || ''),
                 message: String(btn?.vocalization || btn?.label || ''),
+                visibility: mapObfVisibility(btn.hidden),
                 style: {
                     backgroundColor: btn.background_color,
                     borderColor: btn.border_color,
                 },
                 semanticAction,
                 targetPageId: btn.load_board?.path,
+                semantic_id: btn.semantic_id, // Extract semantic_id if present
             });
         });
         const buttonMap = new Map(buttons.map((btn) => [btn.id, btn]));
@@ -105,6 +117,29 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 }
                 page.grid = grid;
+                // Generate clone_id for buttons in the grid
+                const semanticIds = [];
+                const cloneIds = [];
+                grid.forEach((row, rowIndex) => {
+                    row.forEach((btn, colIndex) => {
+                        if (btn) {
+                            // Generate clone_id based on position and label
+                            btn.clone_id = (0, idGenerator_1.generateCloneId)(rows, cols, rowIndex, colIndex, btn.label);
+                            cloneIds.push(btn.clone_id);
+                            // Track semantic_id if present
+                            if (btn.semantic_id) {
+                                semanticIds.push(btn.semantic_id);
+                            }
+                        }
+                    });
+                });
+                // Track IDs on the page
+                if (semanticIds.length > 0) {
+                    page.semantic_ids = semanticIds;
+                }
+                if (cloneIds.length > 0) {
+                    page.clone_ids = cloneIds;
+                }
             }
         }
         return page;

package/dist/processors/obfsetProcessor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OBF Set Processor - Handles JSON-formatted .obfset files
+ * These are pre-extracted board sets in JSON array format
+ */
+import { AACTree } from '../core/treeStructure';
+import { BaseProcessor, ProcessorOptions } from '../core/baseProcessor';
+export declare class ObfsetProcessor extends BaseProcessor {
+    constructor(options?: ProcessorOptions);
+    /**
+     * Extract all text content
+     */
+    extractTexts(filePathOrBuffer: string | Buffer): string[];
+    /**
+     * Load an .obfset file (JSON array of boards)
+     */
+    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    /**
+     * Process texts (not supported for .obfset currently)
+     */
+    processTexts(_filePathOrBuffer: string | Buffer, _translations: Map<string, string>, _outputPath: string): Buffer;
+    /**
+     * Save tree structure back to file
+     */
+    saveFromTree(_tree: AACTree, _outputPath: string): void;
+    supportsExtension(extension: string): boolean;
+}