@willwade/aac-processors 0.0.9 → 0.0.10

package/dist/processors/gridsetProcessor.js

@@ -10,10 +10,42 @@ const adm_zip_1 = __importDefault(require("adm-zip"));
 const fs_1 = __importDefault(require("fs"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const resolver_1 = require("./gridset/resolver");
+const password_1 = require("./gridset/password");
+const crypto_1 = __importDefault(require("crypto"));
+const zlib_1 = __importDefault(require("zlib"));
+const gridsetValidator_1 = require("../validation/gridsetValidator");
 class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     constructor(options) {
         super(options);
     }
+    /**
+     * Decrypt and inflate a Grid3 encrypted payload (DesktopContentEncrypter).
+     * Uses AES-256-CBC with key/IV derived from the password padded with spaces
+     * and then Deflate decompression.
+     */
+    decryptGridsetEntry(buffer, password) {
+        const pwd = (password || 'Chocolate').padEnd(32, ' ');
+        const key = Buffer.from(pwd.slice(0, 32), 'utf8');
+        const iv = Buffer.from(pwd.slice(0, 16), 'utf8');
+        try {
+            const decipher = crypto_1.default.createDecipheriv('aes-256-cbc', key, iv);
+            const decrypted = Buffer.concat([decipher.update(buffer), decipher.final()]);
+            try {
+                return zlib_1.default.inflateSync(decrypted);
+            }
+            catch {
+                // If data isn't deflated, return raw decrypted bytes
+                return decrypted;
+            }
+        }
+        catch {
+            return buffer;
+        }
+    }
+    // Determine password to use when opening encrypted gridset archives (.gridsetx)
+    getGridsetPassword(source) {
+        return (0, password_1.resolveGridsetPassword)(this.options, source);
+    }
     // Helper function to ensure color has alpha channel (Grid3 format)
     ensureAlphaChannel(color) {
         if (!color)
@@ -242,10 +274,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         return undefined;
     }
     extractTexts(filePathOrBuffer) {
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const tree = this.loadIntoTree(buffer);
+        const tree = this.loadIntoTree(filePathOrBuffer);
         const texts = [];
         for (const pageId in tree.pages) {
             const page = tree.pages[pageId];
@@ -269,13 +298,23 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         catch (error) {
             throw new Error(`Invalid ZIP file format: ${error.message}`);
         }
+        const password = this.getGridsetPassword(filePathOrBuffer);
+        const entries = (0, password_1.getZipEntriesWithPassword)(zip, password);
         const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
+        const isEncryptedArchive = typeof filePathOrBuffer === 'string' && filePathOrBuffer.toLowerCase().endsWith('.gridsetx');
+        const encryptedContentPassword = this.getGridsetPassword(filePathOrBuffer);
+        const readEntryBuffer = (entry) => {
+            const raw = entry.getData();
+            if (!isEncryptedArchive)
+                return raw;
+            return this.decryptGridsetEntry(raw, encryptedContentPassword);
+        };
         // Parse FileMap.xml if present to index dynamic files per grid
         const fileMapIndex = new Map();
         try {
-            const fmEntry = zip.getEntries().find((e) => e.entryName.endsWith('FileMap.xml'));
+            const fmEntry = entries.find((e) => e.entryName.endsWith('FileMap.xml'));
             if (fmEntry) {
-                const fmXml = fmEntry.getData().toString('utf8');
+                const fmXml = readEntryBuffer(fmEntry).toString('utf8');
                 const fmData = parser.parse(fmXml);
                 const entries = fmData?.FileMap?.Entries?.Entry || fmData?.fileMap?.entries?.entry;
                 if (entries) {
@@ -307,12 +346,10 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         }
         // First, load styles from Settings0/Styles/styles.xml (Grid3 format)
         const styles = new Map();
-        const styleEntry = zip
-            .getEntries()
-            .find((entry) => entry.entryName.endsWith('styles.xml') || entry.entryName.endsWith('style.xml'));
+        const styleEntry = entries.find((entry) => entry.entryName.endsWith('styles.xml') || entry.entryName.endsWith('style.xml'));
         if (styleEntry) {
             try {
-                const styleXmlContent = styleEntry.getData().toString('utf8');
+                const styleXmlContent = readEntryBuffer(styleEntry).toString('utf8');
                 const styleData = parser.parse(styleXmlContent);
                 // Parse styles and store them in the map
                 // Grid3 uses StyleData.Styles.Style with Key attribute
@@ -343,14 +380,14 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             }
         }
         // Debug: log all entry names
-        // console.log('Gridset zip entries:', zip.getEntries().map(e => e.entryName));
+        // console.log('Gridset zip entries:', entries.map(e => e.entryName));
         // First pass: collect all grid names and IDs for navigation resolution
         const gridNameToIdMap = new Map();
         const gridIdToNameMap = new Map();
-        zip.getEntries().forEach((entry) => {
+        entries.forEach((entry) => {
             if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
                 try {
-                    const xmlContent = entry.getData().toString('utf8');
+                    const xmlContent = readEntryBuffer(entry).toString('utf8');
                     const data = parser.parse(xmlContent);
                     const grid = data.Grid || data.grid;
                     if (!grid)
@@ -373,12 +410,12 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         // Second pass: process each grid file in the gridset
-        zip.getEntries().forEach((entry) => {
+        entries.forEach((entry) => {
             // Only process files named grid.xml under Grids/ (any subdir)
             if (entry.entryName.startsWith('Grids/') && entry.entryName.endsWith('grid.xml')) {
                 let xmlContent;
                 try {
-                    xmlContent = entry.getData().toString('utf8');
+                    xmlContent = readEntryBuffer(entry).toString('utf8');
                 }
                 catch (e) {
                     // Skip unreadable files
@@ -482,7 +519,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                             x: cellX + 1,
                             y: cellY + 1,
                             dynamicFiles,
-                        }) || undefined;
+                        }, entries) || undefined;
                         if (commands) {
                             const commandArr = Array.isArray(commands) ? commands : [commands];
                             for (const command of commandArr) {
@@ -910,9 +947,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         }
         // Read settings.xml to get the StartGrid (home page)
         try {
-            const settingsEntry = zip.getEntries().find((e) => e.entryName.endsWith('settings.xml'));
+            const settingsEntry = entries.find((e) => e.entryName.endsWith('settings.xml'));
             if (settingsEntry) {
-                const settingsXml = settingsEntry.getData().toString('utf8');
+                const settingsXml = readEntryBuffer(settingsEntry).toString('utf8');
                 const settingsData = parser.parse(settingsXml);
                 const startGridName = settingsData?.GridSetSettings?.StartGrid ||
                     settingsData?.gridSetSettings?.startGrid ||
@@ -933,10 +970,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     }
     processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
-        const tree = this.loadIntoTree(buffer);
+        const tree = this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
         Object.values(tree.pages).forEach((page) => {
             // Translate page names
@@ -1327,5 +1361,13 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
     generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate Gridset file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return gridsetValidator_1.GridsetValidator.validateFile(filePath);
+    }
 }
 exports.GridsetProcessor = GridsetProcessor;

package/dist/processors/index.d.ts

@@ -11,6 +11,7 @@ export { getPageTokenImageMap, getAllowedImageEntries, openImage, generateGrid3G
 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';
 export { createWordlist, extractWordlists, updateWordlist, wordlistToXml, type WordList, type WordListItem, } from './gridset/wordlistHelpers';
+export { resolveGridsetPassword, resolveGridsetPasswordFromEnv } from './gridset/password';
 export { getNamedColor, rgbaToHex, channelToHex, clampColorChannel, clampAlpha, toHexColor, darkenColor, normalizeColor, ensureAlphaChannel, } from './gridset/colorUtils';
 export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, createDefaultStylesXml, createCategoryStyle, } from './gridset/styleHelpers';
 export { ensureAlphaChannel as ensureAlphaChannelFromStyles } from './gridset/styleHelpers';

package/dist/processors/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clampColorChannel = exports.channelToHex = exports.rgbaToHex = exports.getNamedColor = 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 = void 0;
+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;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -63,6 +63,9 @@ Object.defineProperty(exports, "createWordlist", { enumerable: true, get: functi
 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; } });

package/dist/processors/obfProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class ObfProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
     private processBoard;
@@ -19,5 +20,11 @@ declare class ObfProcessor extends BaseProcessor {
      * Uses the generic implementation from BaseProcessor
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate OBF/OBZ file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { ObfProcessor };

package/dist/processors/obfProcessor.js

@@ -10,6 +10,7 @@ const treeStructure_1 = require("../core/treeStructure");
 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 {
     constructor(options) {
@@ -359,5 +360,13 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
     async generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate OBF/OBZ file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return obfValidator_1.ObfValidator.validateFile(filePath);
+    }
 }
 exports.ObfProcessor = ObfProcessor;

package/dist/processors/snapProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class SnapProcessor extends BaseProcessor {
     private symbolResolver;
     private loadAudio;
@@ -40,5 +41,11 @@ declare class SnapProcessor extends BaseProcessor {
      * Uses the generic implementation from BaseProcessor
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate Snap file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { SnapProcessor };

package/dist/processors/snapProcessor.js

@@ -11,6 +11,7 @@ const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const crypto_1 = __importDefault(require("crypto"));
+const snapValidator_1 = require("../validation/snapValidator");
 class SnapProcessor extends baseProcessor_1.BaseProcessor {
     constructor(symbolResolver = null, options = {}) {
         super(options);
@@ -612,5 +613,13 @@ class SnapProcessor extends baseProcessor_1.BaseProcessor {
     async generateTranslatedDownload(filePath, translatedStrings, sourceStrings) {
         return this.generateTranslatedDownloadGeneric(filePath, translatedStrings, sourceStrings);
     }
+    /**
+     * Validate Snap file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return snapValidator_1.SnapValidator.validateFile(filePath);
+    }
 }
 exports.SnapProcessor = SnapProcessor;

package/dist/processors/touchchatProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ValidationResult } from '../validation/validationTypes';
 declare class TouchChatProcessor extends BaseProcessor {
     private tree;
     private sourceFile;
@@ -23,5 +24,11 @@ declare class TouchChatProcessor extends BaseProcessor {
      * @returns Promise with path to the generated translated file
      */
     generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+    /**
+     * Validate TouchChat file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    validate(filePath: string): Promise<ValidationResult>;
 }
 export { TouchChatProcessor };

package/dist/processors/touchchatProcessor.js

@@ -12,6 +12,7 @@ const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
+const touchChatValidator_1 = require("../validation/touchChatValidator");
 const toNumberOrUndefined = (value) => typeof value === 'number' ? value : undefined;
 const toStringOrUndefined = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
 const toBooleanOrUndefined = (value) => typeof value === 'number' ? value !== 0 : undefined;
@@ -787,5 +788,13 @@ class TouchChatProcessor extends baseProcessor_1.BaseProcessor {
             return Promise.reject(new Error(`Failed to generate translated download: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
+    /**
+     * Validate TouchChat file format
+     * @param filePath - Path to the file to validate
+     * @returns Promise with validation result
+     */
+    async validate(filePath) {
+        return touchChatValidator_1.TouchChatValidator.validateFile(filePath);
+    }
 }
 exports.TouchChatProcessor = TouchChatProcessor;

package/dist/utilities/screenshotConverter.d.ts

@@ -0,0 +1,69 @@
+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;
+}