@willwade/aac-processors 0.0.11 → 0.0.12

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

@@ -42,6 +42,8 @@ export interface AACButton {
     parameters?: {
         [key: string]: any;
     };
+    semantic_id?: string;
+    clone_id?: string;
 }
 export interface AACPage {
     id: string;
@@ -54,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.11",
+  "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",