@willwade/aac-processors 0.0.10 → 0.0.12

package/dist/processors/index.js

@@ -1,7 +1,22 @@
 "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);
+};
 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.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.ensureAlphaChannelFromStyles = 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.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");
@@ -20,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; } });
@@ -83,9 +100,83 @@ Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get:
 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; } });

package/dist/processors/obfProcessor.js

@@ -6,10 +6,9 @@ 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';
 class ObfProcessor extends baseProcessor_1.BaseProcessor {
@@ -48,6 +47,7 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 },
                 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 +105,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;
+}

package/dist/processors/obfsetProcessor.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * OBF Set Processor - Handles JSON-formatted .obfset files
+ * These are pre-extracted board sets in JSON array format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObfsetProcessor = void 0;
+const treeStructure_1 = require("../core/treeStructure");
+const treeStructure_2 = require("../core/treeStructure");
+const fs_1 = __importDefault(require("fs"));
+const baseProcessor_1 = require("../core/baseProcessor");
+class ObfsetProcessor extends baseProcessor_1.BaseProcessor {
+    constructor(options = {}) {
+        super(options);
+    }
+    /**
+     * Extract all text content
+     */
+    extractTexts(filePathOrBuffer) {
+        const tree = this.loadIntoTree(filePathOrBuffer);
+        const texts = new Set();
+        Object.values(tree.pages).forEach((page) => {
+            if (page.name)
+                texts.add(page.name);
+            page.buttons.forEach((button) => {
+                if (button.label)
+                    texts.add(button.label);
+            });
+        });
+        return Array.from(texts);
+    }
+    /**
+     * Load an .obfset file (JSON array of boards)
+     */
+    loadIntoTree(filePathOrBuffer) {
+        const tree = new treeStructure_1.AACTree();
+        let content;
+        if (Buffer.isBuffer(filePathOrBuffer)) {
+            content = filePathOrBuffer.toString('utf-8');
+        }
+        else {
+            content = fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
+        }
+        const boards = JSON.parse(content);
+        // Track board ID mappings
+        const boardMap = new Map();
+        // First pass: create all boards
+        boards.forEach((boardData) => {
+            const rows = boardData.grid?.rows || 4;
+            const cols = boardData.grid?.columns || 6;
+            const name = boardData.name || boardData.id || `Board ${boardData.id}`;
+            const page = new treeStructure_2.AACPage({
+                id: boardData.id,
+                name,
+                grid: { columns: cols, rows: rows },
+                buttons: [],
+            });
+            tree.addPage(page);
+            boardMap.set(boardData.id, page);
+        });
+        // Second pass: process buttons and establish parent relationships
+        boards.forEach((boardData) => {
+            const page = boardMap.get(boardData.id);
+            if (!page)
+                return;
+            const rows = boardData.grid?.rows || 4;
+            const cols = boardData.grid?.columns || 6;
+            // Initialize grid with nulls
+            page.grid = Array.from({ length: rows }, () => Array.from({ length: cols }, () => null));
+            // Create button map by ID
+            const buttonMap = new Map();
+            const buttons = boardData.buttons || [];
+            buttons.forEach((btnData) => {
+                buttonMap.set(btnData.id, btnData);
+            });
+            // Process grid order to place buttons in correct positions
+            const gridOrder = boardData.grid?.order || [];
+            const semanticIds = [];
+            const cloneIds = [];
+            gridOrder.forEach((row, rowIndex) => {
+                row.forEach((buttonId, colIndex) => {
+                    const btnData = buttonMap.get(buttonId);
+                    if (btnData) {
+                        // Create semantic action
+                        let semanticAction;
+                        if (btnData.load_board?.id) {
+                            // Navigation button
+                            semanticAction = {
+                                category: treeStructure_2.AACSemanticCategory.NAVIGATION,
+                                intent: treeStructure_2.AACSemanticIntent.NAVIGATE_TO,
+                                targetId: btnData.load_board.id,
+                                fallback: {
+                                    type: 'NAVIGATE',
+                                    targetPageId: btnData.load_board.id,
+                                    add_to_sentence: btnData.load_board.add_to_sentence,
+                                    temporary_home: btnData.load_board.temporary_home,
+                                },
+                                platformData: {
+                                    grid3: {
+                                        commandId: 'GO_TO_BOARD',
+                                        parameters: {
+                                            add_to_sentence: btnData.load_board.add_to_sentence,
+                                            temporary_home: btnData.load_board.temporary_home,
+                                        },
+                                    },
+                                },
+                            };
+                        }
+                        else {
+                            // Speaking button
+                            semanticAction = {
+                                category: treeStructure_2.AACSemanticCategory.COMMUNICATION,
+                                intent: treeStructure_2.AACSemanticIntent.SPEAK_TEXT,
+                                text: btnData.label || '',
+                                fallback: { type: 'SPEAK', message: btnData.label || '' },
+                            };
+                        }
+                        const button = new treeStructure_2.AACButton({
+                            id: btnData.id,
+                            label: btnData.label || '',
+                            message: btnData.label || '',
+                            targetPageId: btnData.load_board?.id,
+                            semanticAction,
+                            semantic_id: btnData.semantic_id,
+                            clone_id: btnData.clone_id,
+                        });
+                        // Add to grid at the correct position
+                        if (rowIndex < rows && colIndex < cols) {
+                            page.grid[rowIndex][colIndex] = button;
+                        }
+                        page.buttons.push(button);
+                        // Track IDs
+                        if (btnData.semantic_id) {
+                            semanticIds.push(String(btnData.semantic_id));
+                        }
+                        if (btnData.clone_id) {
+                            cloneIds.push(String(btnData.clone_id));
+                        }
+                        // Establish parent relationship if this button links to another board
+                        if (btnData.load_board?.id) {
+                            const targetPage = boardMap.get(String(btnData.load_board.id));
+                            if (targetPage) {
+                                targetPage.parentId = page.id;
+                            }
+                        }
+                    }
+                });
+            });
+            // Store IDs on page
+            page.semantic_ids = semanticIds;
+            page.clone_ids = cloneIds;
+        });
+        // Set root board (first board or one with no parent)
+        const rootBoard = Array.from(boardMap.values()).find((p) => !p.parentId);
+        if (rootBoard) {
+            tree.rootId = rootBoard.id;
+        }
+        return tree;
+    }
+    /**
+     * Process texts (not supported for .obfset currently)
+     */
+    processTexts(_filePathOrBuffer, _translations, _outputPath) {
+        throw new Error('processTexts is not supported for .obfset currently');
+    }
+    /**
+     * Save tree structure back to file
+     */
+    saveFromTree(_tree, _outputPath) {
+        throw new Error('saveFromTree is not supported for .obfset currently');
+    }
+    supportsExtension(extension) {
+        return extension === '.obfset';
+    }
+}
+exports.ObfsetProcessor = ObfsetProcessor;

package/dist/processors/snapProcessor.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnapProcessor = 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 better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
@@ -226,6 +226,9 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                         targetPageId: targetPageUniqueId,
                         semanticAction: semanticAction,
                         audioRecording: audioRecording,
+                        semantic_id: btnRow.LibrarySymbolId
+                            ? `snap_symbol_${btnRow.LibrarySymbolId}`
+                            : undefined, // Extract semantic_id from LibrarySymbolId
                         style: {
                             backgroundColor: btnRow.BackgroundColor
                                 ? `#${btnRow.BackgroundColor.toString(16)}`
@@ -258,6 +261,10 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                                 gridX < 10 &&
                                 pageGrid[gridY] &&
                                 pageGrid[gridY][gridX] === null) {
+                                // Generate clone_id for button at this position
+                                const rows = pageGrid.length;
+                                const cols = pageGrid[0] ? pageGrid[0].length : 10;
+                                button.clone_id = (0, idGenerator_1.generateCloneId)(rows, cols, gridY, gridX, button.label);
                                 pageGrid[gridY][gridX] = button;
                             }
                         }
@@ -274,6 +281,27 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
                 const currentPage = tree.getPage(uniqueId);
                 if (currentPage && pageGrid) {
                     currentPage.grid = pageGrid;
+                    // Track semantic_ids and clone_ids on the page
+                    const semanticIds = [];
+                    const cloneIds = [];
+                    pageGrid.forEach((row) => {
+                        row.forEach((btn) => {
+                            if (btn) {
+                                if (btn.semantic_id) {
+                                    semanticIds.push(btn.semantic_id);
+                                }
+                                if (btn.clone_id) {
+                                    cloneIds.push(btn.clone_id);
+                                }
+                            }
+                        });
+                    });
+                    if (semanticIds.length > 0) {
+                        currentPage.semantic_ids = semanticIds;
+                    }
+                    if (cloneIds.length > 0) {
+                        currentPage.clone_ids = cloneIds;
+                    }
                 }
             }
             return tree;

package/dist/processors/touchchatProcessor.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TouchChatProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
+const idGenerator_1 = require("../optional/analytics/utils/idGenerator");
 const stringCasing_1 = require("../core/stringCasing");
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
@@ -165,6 +166,7 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                         label: cell.label || '',
                         message: cell.message || '',
                         semanticAction: semanticAction,
+                        semantic_id: cell.symbol_link_id || cell.symbolLinkId || undefined, // Extract semantic_id from symbol_link_id
                         style: {
                             backgroundColor: intToHex(style?.body_color),
                             borderColor: intToHex(style?.border_color),
@@ -241,6 +243,31 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
                     const page = tree.getPage(pageId);
                     if (page) {
                         page.grid = grid;
+                        // Generate clone_id for each button 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
+                                    const rows = grid.length;
+                                    const cols = grid[0] ? grid[0].length : 10;
+                                    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;
+                        }
                     }
                 });
             }

package/dist/types/aac.d.ts

@@ -25,6 +25,25 @@ export interface AACButton {
         identifier?: string;
         metadata?: string;
     };
+    contentType?: 'Normal' | 'AutoContent' | 'Workspace' | 'LiveCell';
+    contentSubType?: string;
+    image?: string;
+    resolvedImageEntry?: string;
+    symbolLibrary?: string;
+    symbolPath?: string;
+    x?: number;
+    y?: number;
+    columnSpan?: number;
+    rowSpan?: number;
+    scanBlocks?: number[];
+    visibility?: 'Visible' | 'Hidden' | 'Disabled' | 'PointerAndTouchOnly' | 'Empty';
+    directActivate?: boolean;
+    audioDescription?: string;
+    parameters?: {
+        [key: string]: any;
+    };
+    semantic_id?: string;
+    clone_id?: string;
 }
 export interface AACPage {
     id: string;
@@ -37,6 +56,8 @@ export interface AACPage {
     descriptionHtml?: string;
     images?: any[];
     sounds?: any[];
+    semantic_ids?: string[];
+    clone_ids?: string[];
 }
 export interface AACTree {
     pages: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "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",