@willwade/aac-processors 0.0.6 → 0.0.8

package/dist/processors/gridset/helpers.js

@@ -1,4 +1,27 @@
 "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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,7 +29,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPageTokenImageMap = getPageTokenImageMap;
 exports.getAllowedImageEntries = getAllowedImageEntries;
 exports.openImage = openImage;
+exports.generateGrid3Guid = generateGrid3Guid;
+exports.createSettingsXml = createSettingsXml;
+exports.createFileMapXml = createFileMapXml;
+exports.getCommonDocumentsPath = getCommonDocumentsPath;
+exports.findGrid3UserPaths = findGrid3UserPaths;
+exports.findGrid3HistoryDatabases = findGrid3HistoryDatabases;
+exports.findGrid3Users = findGrid3Users;
+exports.findGrid3Vocabularies = findGrid3Vocabularies;
+exports.findGrid3UserHistory = findGrid3UserHistory;
+exports.isGrid3Installed = isGrid3Installed;
+exports.readGrid3History = readGrid3History;
+exports.readGrid3HistoryForUser = readGrid3HistoryForUser;
+exports.readAllGrid3History = readAllGrid3History;
 const adm_zip_1 = __importDefault(require("adm-zip"));
+const fast_xml_parser_1 = require("fast-xml-parser");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const dotnetTicks_1 = require("../../utils/dotnetTicks");
 function normalizeZipPath(p) {
     const unified = p.replace(/\\/g, '/');
     try {
@@ -16,6 +58,10 @@ function normalizeZipPath(p) {
         return unified;
     }
 }
+/**
+ * Build a map of button IDs to resolved image entry paths for a specific page.
+ * Helpful when rewriting zip entry names or validating images referenced in a grid.
+ */
 function getPageTokenImageMap(tree, pageId) {
     const map = new Map();
     const page = tree.getPage(pageId);
@@ -28,6 +74,10 @@ function getPageTokenImageMap(tree, pageId) {
     }
     return map;
 }
+/**
+ * Collect all image entries referenced across every page in a tree.
+ * Returns normalized zip entry paths that should be preserved when pruning images.
+ */
 function getAllowedImageEntries(tree) {
     const out = new Set();
     Object.values(tree.pages).forEach((page) => {
@@ -38,6 +88,12 @@ function getAllowedImageEntries(tree) {
     });
     return out;
 }
+/**
+ * Read an image entry from a gridset zip by path.
+ * @param gridsetBuffer Gridset archive contents
+ * @param entryPath Entry name inside the zip
+ * @returns Image data buffer or null if not found
+ */
 function openImage(gridsetBuffer, entryPath) {
     const zip = new adm_zip_1.default(gridsetBuffer);
     const want = normalizeZipPath(entryPath);
@@ -46,3 +102,301 @@ function openImage(gridsetBuffer, entryPath) {
         return null;
     return entry.getData();
 }
+/**
+ * Generate a random GUID for Grid3 elements
+ * Grid3 uses GUIDs for grid identification
+ * @returns A UUID v4-like string in the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+function generateGrid3Guid() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Create Grid3 settings XML with start grid and common settings
+ * @param startGrid - Name of the grid to start on
+ * @param options - Optional settings (scan, hover, language, etc.)
+ * @returns XML string for Settings.xml
+ */
+function createSettingsXml(startGrid, options) {
+    const builder = new fast_xml_parser_1.XMLBuilder({
+        ignoreAttributes: false,
+        format: true,
+        indentBy: '  ',
+    });
+    const settingsData = {
+        GridSetSettings: {
+            '@_xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
+            StartGrid: startGrid,
+            ScanEnabled: options?.scanEnabled?.toString() ?? 'false',
+            ScanTimeoutMs: options?.scanTimeoutMs?.toString() ?? '2000',
+            HoverEnabled: options?.hoverEnabled?.toString() ?? 'false',
+            HoverTimeoutMs: options?.hoverTimeoutMs?.toString() ?? '1000',
+            MouseclickEnabled: options?.mouseclickEnabled?.toString() ?? 'true',
+            Language: options?.language ?? 'en-US',
+        },
+    };
+    return builder.build(settingsData);
+}
+/**
+ * Create Grid3 FileMap.xml content
+ * @param grids - Array of grid configurations with name and path
+ * @returns XML string for FileMap.xml
+ */
+function createFileMapXml(grids) {
+    const builder = new fast_xml_parser_1.XMLBuilder({
+        ignoreAttributes: false,
+        format: true,
+        indentBy: '  ',
+    });
+    const entries = grids.map((grid) => ({
+        '@_StaticFile': grid.path,
+        ...(grid.dynamicFiles && grid.dynamicFiles.length > 0
+            ? { DynamicFiles: { File: grid.dynamicFiles } }
+            : {}),
+    }));
+    const fileMapData = {
+        FileMap: {
+            '@_xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
+            Entries: {
+                Entry: entries,
+            },
+        },
+    };
+    return builder.build(fileMapData);
+}
+/**
+ * Get the Windows Common Documents folder path from registry
+ * Falls back to default path if registry access fails
+ * @returns Path to Common Documents folder
+ */
+function getCommonDocumentsPath() {
+    // Only works on Windows
+    if (process.platform !== 'win32') {
+        return '';
+    }
+    try {
+        // Query registry for Common Documents path
+        const command = 'REG.EXE QUERY "HKLM\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders" /V "Common Documents"';
+        const output = (0, child_process_1.execSync)(command, { encoding: 'utf-8', windowsHide: true });
+        // Parse the output to extract the path
+        const match = output.match(/Common Documents\s+REG_SZ\s+(.+)/);
+        if (match && match[1]) {
+            return match[1].trim();
+        }
+    }
+    catch (error) {
+        // Registry access failed, fall back to default
+    }
+    // Default fallback path
+    return 'C:\\Users\\Public\\Documents';
+}
+/**
+ * Find all Grid3 user data paths
+ * Searches for users and language codes in the Grid3 directory structure
+ * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\{langCode}\Phrases\history.sqlite
+ * @returns Array of Grid3 user path information
+ */
+function findGrid3UserPaths() {
+    const results = [];
+    // Only works on Windows
+    if (process.platform !== 'win32') {
+        return results;
+    }
+    try {
+        const commonDocs = getCommonDocumentsPath();
+        // Use Windows path joining so tests that mock a Windows platform stay consistent even on POSIX runners
+        const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+        // Check if Grid3 Users directory exists
+        if (!fs.existsSync(grid3BasePath)) {
+            return results;
+        }
+        // Enumerate users
+        const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+        for (const userDir of users) {
+            if (!userDir.isDirectory())
+                continue;
+            const userName = userDir.name;
+            const userPath = path.win32.join(grid3BasePath, userName);
+            // Enumerate language codes
+            const langDirs = fs.readdirSync(userPath, { withFileTypes: true });
+            for (const langDir of langDirs) {
+                if (!langDir.isDirectory())
+                    continue;
+                const langCode = langDir.name;
+                const basePath = path.win32.join(userPath, langCode);
+                const historyDbPath = path.win32.join(basePath, 'Phrases', 'history.sqlite');
+                // Only include if history database exists
+                if (fs.existsSync(historyDbPath)) {
+                    results.push({
+                        userName,
+                        langCode,
+                        basePath,
+                        historyDbPath,
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Silently fail if directory access fails
+    }
+    return results;
+}
+/**
+ * Find all Grid3 history database paths
+ * Convenience method that returns just the database file paths
+ * @returns Array of paths to history.sqlite files
+ */
+function findGrid3HistoryDatabases() {
+    return findGrid3UserPaths().map((userPath) => userPath.historyDbPath);
+}
+/**
+ * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
+ */
+function findGrid3Users() {
+    return findGrid3UserPaths();
+}
+/**
+ * Find Grid 3 gridset/vocabulary files for each user
+ * @param userName Optional user filter; matches case-insensitively
+ * @returns Array of user/gridset path pairs
+ */
+function findGrid3Vocabularies(userName) {
+    const results = [];
+    if (process.platform !== 'win32') {
+        return results;
+    }
+    const commonDocs = getCommonDocumentsPath();
+    const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+    if (!fs.existsSync(grid3BasePath)) {
+        return results;
+    }
+    const normalizedUser = userName?.toLowerCase();
+    const users = fs.readdirSync(grid3BasePath, { withFileTypes: true });
+    for (const userDir of users) {
+        if (!userDir.isDirectory())
+            continue;
+        if (normalizedUser && userDir.name.toLowerCase() !== normalizedUser)
+            continue;
+        const userRoot = path.win32.join(grid3BasePath, userDir.name);
+        const gridSetsDir = path.win32.join(userRoot, 'Grid Sets');
+        if (!fs.existsSync(gridSetsDir))
+            continue;
+        const entries = fs.readdirSync(gridSetsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const ext = path.extname(entry.name).toLowerCase();
+            if (ext === '.gridset' || ext === '.grd' || ext === '.grdl') {
+                results.push({
+                    userName: userDir.name,
+                    gridsetPath: path.win32.join(gridSetsDir, entry.name),
+                });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Find a specific user's Grid 3 history database
+ * @param userName User name to search for (case-insensitive)
+ * @param langCode Optional language code filter (case-insensitive)
+ * @returns Path to history.sqlite or null if not found
+ */
+function findGrid3UserHistory(userName, langCode) {
+    const normalizedUser = userName.toLowerCase();
+    const normalizedLang = langCode?.toLowerCase();
+    const match = findGrid3UserPaths().find((u) => u.userName.toLowerCase() === normalizedUser &&
+        (!normalizedLang || u.langCode.toLowerCase() === normalizedLang));
+    return match?.historyDbPath ?? null;
+}
+/**
+ * Check whether Grid 3 appears to be installed (Windows only)
+ */
+function isGrid3Installed() {
+    if (process.platform !== 'win32')
+        return false;
+    const commonDocs = getCommonDocumentsPath();
+    if (!commonDocs)
+        return false;
+    const grid3BasePath = path.win32.join(commonDocs, 'Smartbox', 'Grid 3', 'Users');
+    return fs.existsSync(grid3BasePath);
+}
+function parseGrid3ContentXml(xmlContent) {
+    const regex = /<r>(?:<!\[CDATA\[)?(.*?)(?:\]\]>)?<\/r>/gis;
+    const parts = [];
+    let match;
+    while ((match = regex.exec(xmlContent)) !== null) {
+        parts.push(match[1]);
+    }
+    if (parts.length > 0) {
+        return parts.join('');
+    }
+    return xmlContent.replace(/<[^>]+>/g, '').trim();
+}
+/**
+ * Read history events from a Grid 3 history.sqlite database.
+ * @param historyDbPath Absolute path to the history database
+ * @returns Parsed history entries grouped by phrase
+ */
+function readGrid3History(historyDbPath) {
+    if (!fs.existsSync(historyDbPath))
+        return [];
+    const db = new better_sqlite3_1.default(historyDbPath, { readonly: true });
+    const rows = db
+        .prepare(`
+      SELECT p.Id as PhraseId,
+             p.Text as TextValue,
+             p.Content as ContentXml,
+             ph.Timestamp as TickValue,
+             ph.Latitude as Latitude,
+             ph.Longitude as Longitude
+      FROM PhraseHistory ph
+      INNER JOIN Phrases p ON p.Id = ph.PhraseId
+      WHERE ph.Timestamp <> 0
+      ORDER BY ph.Timestamp ASC
+    `)
+        .all();
+    const events = new Map();
+    for (const row of rows) {
+        const phraseId = row.PhraseId;
+        const contentText = parseGrid3ContentXml(String(row.ContentXml ?? row.TextValue ?? ''));
+        const entry = events.get(phraseId) ??
+            {
+                id: `grid:${phraseId}`,
+                content: contentText,
+                occurrences: [],
+                rawXml: row.ContentXml,
+            };
+        entry.occurrences.push({
+            timestamp: (0, dotnetTicks_1.dotNetTicksToDate)(BigInt(row.TickValue ?? 0)),
+            latitude: row.Latitude ?? null,
+            longitude: row.Longitude ?? null,
+        });
+        events.set(phraseId, entry);
+    }
+    return Array.from(events.values());
+}
+/**
+ * Convenience wrapper to load history for a specific Grid 3 user/lang combination.
+ * @param userName Grid 3 user name (case-insensitive)
+ * @param langCode Optional language code to narrow selection (case-insensitive)
+ * @returns History entries for that user/language, or empty array if none
+ */
+function readGrid3HistoryForUser(userName, langCode) {
+    const dbPath = findGrid3UserHistory(userName, langCode);
+    if (!dbPath)
+        return [];
+    return readGrid3History(dbPath);
+}
+/**
+ * Load all available Grid 3 histories on the machine.
+ * @returns Combined history entries from every discovered history.sqlite
+ */
+function readAllGrid3History() {
+    const paths = findGrid3HistoryDatabases();
+    return paths.flatMap((p) => readGrid3History(p));
+}

package/dist/processors/gridset/styleHelpers.d.ts

@@ -25,11 +25,10 @@ export declare const DEFAULT_GRID3_STYLES: Record<string, Grid3Style>;
  */
 export declare const CATEGORY_STYLES: Record<string, Grid3Style>;
 /**
- * Ensure a color has an alpha channel (Grid3 format requires 8-digit ARGB)
- * @param color - Color string (hex format)
- * @returns Color with alpha channel in format #AARRGGBBFF
+ * Re-export ensureAlphaChannel from colorUtils for backward compatibility
+ * @deprecated Use ensureAlphaChannel from colorUtils instead
  */
-export declare function ensureAlphaChannel(color: string | undefined): string;
+export { ensureAlphaChannel } from './colorUtils';
 /**
  * Create a Grid3 style XML string with default and category styles
  * @param includeCategories - Whether to include category-specific styles (default: true)

package/dist/processors/gridset/styleHelpers.js

@@ -6,11 +6,11 @@
  * style XML generation, and style conversion utilities.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = void 0;
-exports.ensureAlphaChannel = ensureAlphaChannel;
+exports.ensureAlphaChannel = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = void 0;
 exports.createDefaultStylesXml = createDefaultStylesXml;
 exports.createCategoryStyle = createCategoryStyle;
 const fast_xml_parser_1 = require("fast-xml-parser");
+const colorUtils_1 = require("./colorUtils");
 /**
  * Default Grid3 styles for common use cases
  * Colors are in 8-digit ARGB hex format (#AARRGGBBFF)
@@ -119,29 +119,11 @@ exports.CATEGORY_STYLES = {
     },
 };
 /**
- * Ensure a color has an alpha channel (Grid3 format requires 8-digit ARGB)
- * @param color - Color string (hex format)
- * @returns Color with alpha channel in format #AARRGGBBFF
+ * Re-export ensureAlphaChannel from colorUtils for backward compatibility
+ * @deprecated Use ensureAlphaChannel from colorUtils instead
  */
-function ensureAlphaChannel(color) {
-    if (!color)
-        return '#FFFFFFFF';
-    // If already 8 digits (with alpha), return as is
-    if (color.match(/^#[0-9A-Fa-f]{8}$/))
-        return color;
-    // If 6 digits (no alpha), add FF for fully opaque
-    if (color.match(/^#[0-9A-Fa-f]{6}$/))
-        return color + 'FF';
-    // If 3 digits (shorthand), expand to 8
-    if (color.match(/^#[0-9A-Fa-f]{3}$/)) {
-        const r = color[1];
-        const g = color[2];
-        const b = color[3];
-        return `#${r}${r}${g}${g}${b}${b}FF`;
-    }
-    // Invalid or unknown format, return white
-    return '#FFFFFFFF';
-}
+var colorUtils_2 = require("./colorUtils");
+Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return colorUtils_2.ensureAlphaChannel; } });
 /**
  * Create a Grid3 style XML string with default and category styles
  * @param includeCategories - Whether to include category-specific styles (default: true)
@@ -185,27 +167,11 @@ function createDefaultStylesXml(includeCategories = true) {
  */
 function createCategoryStyle(categoryName, backgroundColor, fontColor = '#FFFFFFFF') {
     return {
-        BackColour: ensureAlphaChannel(backgroundColor),
-        TileColour: ensureAlphaChannel(backgroundColor),
-        BorderColour: ensureAlphaChannel(darkenColor(backgroundColor, 30)),
-        FontColour: ensureAlphaChannel(fontColor),
+        BackColour: (0, colorUtils_1.ensureAlphaChannel)(backgroundColor),
+        TileColour: (0, colorUtils_1.ensureAlphaChannel)(backgroundColor),
+        BorderColour: (0, colorUtils_1.ensureAlphaChannel)((0, colorUtils_1.darkenColor)(backgroundColor, 30)),
+        FontColour: (0, colorUtils_1.ensureAlphaChannel)(fontColor),
         FontName: 'Arial',
         FontSize: '16',
     };
 }
-/**
- * Darken a hex color by a given amount
- * @param hexColor - Hex color string
- * @param amount - Amount to darken (0-255)
- * @returns Darkened hex color
- */
-function darkenColor(hexColor, amount) {
-    const normalized = ensureAlphaChannel(hexColor);
-    const hex = normalized.slice(1, 7); // Extract RGB part (skip # and alpha)
-    const num = parseInt(hex, 16);
-    const clamp = (value) => Math.max(0, Math.min(255, value));
-    const r = clamp(((num >> 16) & 0xff) - amount);
-    const g = clamp(((num >> 8) & 0xff) - amount);
-    const b = clamp((num & 0xff) - amount);
-    return `#${((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1)}`;
-}

package/dist/processors/index.d.ts

@@ -7,10 +7,12 @@ export { OpmlProcessor } from './opmlProcessor';
 export { SnapProcessor } from './snapProcessor';
 export { TouchChatProcessor } from './touchchatProcessor';
 export { AstericsGridProcessor } from './astericsGridProcessor';
-export { getPageTokenImageMap, getAllowedImageEntries, openImage } from './gridset/helpers';
-export { getPageTokenImageMap as getGridsetPageTokenImageMap, getAllowedImageEntries as getGridsetAllowedImageEntries, openImage as openGridsetImage, } from './gridset/helpers';
+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';
 export { createWordlist, extractWordlists, updateWordlist, wordlistToXml, type WordList, type WordListItem, } from './gridset/wordlistHelpers';
-export { DEFAULT_GRID3_STYLES, CATEGORY_STYLES, ensureAlphaChannel, createDefaultStylesXml, createCategoryStyle, type Grid3Style, } from './gridset/styleHelpers';
-export { getPageTokenImageMap as getSnapPageTokenImageMap, getAllowedImageEntries as getSnapAllowedImageEntries, openImage as openSnapImage, } from './snap/helpers';
+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';
+export { getPageTokenImageMap as getSnapPageTokenImageMap, getAllowedImageEntries as getSnapAllowedImageEntries, openImage as openSnapImage, findSnapPackages, findSnapPackagePath, findSnapUsers, findSnapUserVocabularies, findSnapUserHistory, isSnapInstalled, readSnapUsage, readSnapUsageForUser, type SnapPackagePath, type SnapUserInfo, type SnapUsageEntry, } from './snap/helpers';
 export { getPageTokenImageMap as getTouchChatPageTokenImageMap, getAllowedImageEntries as getTouchChatAllowedImageEntries, openImage as openTouchChatImage, } from './touchchat/helpers';

package/dist/processors/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = exports.openSnapImage = exports.getSnapAllowedImageEntries = exports.getSnapPageTokenImageMap = exports.createCategoryStyle = exports.createDefaultStylesXml = exports.ensureAlphaChannel = exports.CATEGORY_STYLES = exports.DEFAULT_GRID3_STYLES = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = 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.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;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -24,10 +25,36 @@ var helpers_1 = require("./gridset/helpers");
 Object.defineProperty(exports, "getPageTokenImageMap", { enumerable: true, get: function () { return helpers_1.getPageTokenImageMap; } });
 Object.defineProperty(exports, "getAllowedImageEntries", { enumerable: true, get: function () { return helpers_1.getAllowedImageEntries; } });
 Object.defineProperty(exports, "openImage", { enumerable: true, get: function () { return helpers_1.openImage; } });
+Object.defineProperty(exports, "generateGrid3Guid", { enumerable: true, get: function () { return helpers_1.generateGrid3Guid; } });
+Object.defineProperty(exports, "createSettingsXml", { enumerable: true, get: function () { return helpers_1.createSettingsXml; } });
+Object.defineProperty(exports, "createFileMapXml", { enumerable: true, get: function () { return helpers_1.createFileMapXml; } });
+Object.defineProperty(exports, "getCommonDocumentsPath", { enumerable: true, get: function () { return helpers_1.getCommonDocumentsPath; } });
+Object.defineProperty(exports, "findGrid3UserPaths", { enumerable: true, get: function () { return helpers_1.findGrid3UserPaths; } });
+Object.defineProperty(exports, "findGrid3HistoryDatabases", { enumerable: true, get: function () { return helpers_1.findGrid3HistoryDatabases; } });
+Object.defineProperty(exports, "findGrid3Users", { enumerable: true, get: function () { return helpers_1.findGrid3Users; } });
+Object.defineProperty(exports, "findGrid3Vocabularies", { enumerable: true, get: function () { return helpers_1.findGrid3Vocabularies; } });
+Object.defineProperty(exports, "findGrid3UserHistory", { enumerable: true, get: function () { return helpers_1.findGrid3UserHistory; } });
+Object.defineProperty(exports, "isGrid3Installed", { enumerable: true, get: function () { return helpers_1.isGrid3Installed; } });
+Object.defineProperty(exports, "readGrid3History", { enumerable: true, get: function () { return helpers_1.readGrid3History; } });
+Object.defineProperty(exports, "readGrid3HistoryForUser", { enumerable: true, get: function () { return helpers_1.readGrid3HistoryForUser; } });
+Object.defineProperty(exports, "readAllGrid3History", { enumerable: true, get: function () { return helpers_1.readAllGrid3History; } });
 var helpers_2 = require("./gridset/helpers");
 Object.defineProperty(exports, "getGridsetPageTokenImageMap", { enumerable: true, get: function () { return helpers_2.getPageTokenImageMap; } });
 Object.defineProperty(exports, "getGridsetAllowedImageEntries", { enumerable: true, get: function () { return helpers_2.getAllowedImageEntries; } });
 Object.defineProperty(exports, "openGridsetImage", { enumerable: true, get: function () { return helpers_2.openImage; } });
+Object.defineProperty(exports, "generateGridsetGuid", { enumerable: true, get: function () { return helpers_2.generateGrid3Guid; } });
+Object.defineProperty(exports, "createGridsetSettingsXml", { enumerable: true, get: function () { return helpers_2.createSettingsXml; } });
+Object.defineProperty(exports, "createGridsetFileMapXml", { enumerable: true, get: function () { return helpers_2.createFileMapXml; } });
+Object.defineProperty(exports, "getGridsetCommonDocumentsPath", { enumerable: true, get: function () { return helpers_2.getCommonDocumentsPath; } });
+Object.defineProperty(exports, "findGridsetUserPaths", { enumerable: true, get: function () { return helpers_2.findGrid3UserPaths; } });
+Object.defineProperty(exports, "findGridsetHistoryDatabases", { enumerable: true, get: function () { return helpers_2.findGrid3HistoryDatabases; } });
+Object.defineProperty(exports, "findGridsetUsers", { enumerable: true, get: function () { return helpers_2.findGrid3Users; } });
+Object.defineProperty(exports, "findGridsetVocabularies", { enumerable: true, get: function () { return helpers_2.findGrid3Vocabularies; } });
+Object.defineProperty(exports, "findGridsetUserHistory", { enumerable: true, get: function () { return helpers_2.findGrid3UserHistory; } });
+Object.defineProperty(exports, "isGridsetInstalled", { enumerable: true, get: function () { return helpers_2.isGrid3Installed; } });
+Object.defineProperty(exports, "readGridsetHistory", { enumerable: true, get: function () { return helpers_2.readGrid3History; } });
+Object.defineProperty(exports, "readGridsetHistoryForUser", { enumerable: true, get: function () { return helpers_2.readGrid3HistoryForUser; } });
+Object.defineProperty(exports, "readAllGridsetHistory", { enumerable: true, get: function () { return helpers_2.readAllGrid3History; } });
 var resolver_1 = require("./gridset/resolver");
 Object.defineProperty(exports, "resolveGrid3CellImage", { enumerable: true, get: function () { return resolver_1.resolveGrid3CellImage; } });
 // Gridset (Grid 3) wordlist helpers
@@ -36,18 +63,39 @@ 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; } });
+// Gridset (Grid 3) color utilities
+var colorUtils_1 = require("./gridset/colorUtils");
+Object.defineProperty(exports, "getNamedColor", { enumerable: true, get: function () { return colorUtils_1.getNamedColor; } });
+Object.defineProperty(exports, "rgbaToHex", { enumerable: true, get: function () { return colorUtils_1.rgbaToHex; } });
+Object.defineProperty(exports, "channelToHex", { enumerable: true, get: function () { return colorUtils_1.channelToHex; } });
+Object.defineProperty(exports, "clampColorChannel", { enumerable: true, get: function () { return colorUtils_1.clampColorChannel; } });
+Object.defineProperty(exports, "clampAlpha", { enumerable: true, get: function () { return colorUtils_1.clampAlpha; } });
+Object.defineProperty(exports, "toHexColor", { enumerable: true, get: function () { return colorUtils_1.toHexColor; } });
+Object.defineProperty(exports, "darkenColor", { enumerable: true, get: function () { return colorUtils_1.darkenColor; } });
+Object.defineProperty(exports, "normalizeColor", { enumerable: true, get: function () { return colorUtils_1.normalizeColor; } });
+Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return colorUtils_1.ensureAlphaChannel; } });
 // Gridset (Grid 3) style helpers
 var styleHelpers_1 = require("./gridset/styleHelpers");
 Object.defineProperty(exports, "DEFAULT_GRID3_STYLES", { enumerable: true, get: function () { return styleHelpers_1.DEFAULT_GRID3_STYLES; } });
 Object.defineProperty(exports, "CATEGORY_STYLES", { enumerable: true, get: function () { return styleHelpers_1.CATEGORY_STYLES; } });
-Object.defineProperty(exports, "ensureAlphaChannel", { enumerable: true, get: function () { return styleHelpers_1.ensureAlphaChannel; } });
 Object.defineProperty(exports, "createDefaultStylesXml", { enumerable: true, get: function () { return styleHelpers_1.createDefaultStylesXml; } });
 Object.defineProperty(exports, "createCategoryStyle", { enumerable: true, get: function () { return styleHelpers_1.createCategoryStyle; } });
-// Snap helpers (stubs)
+// 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; } });
+// Snap helpers
 var helpers_3 = require("./snap/helpers");
 Object.defineProperty(exports, "getSnapPageTokenImageMap", { enumerable: true, get: function () { return helpers_3.getPageTokenImageMap; } });
 Object.defineProperty(exports, "getSnapAllowedImageEntries", { enumerable: true, get: function () { return helpers_3.getAllowedImageEntries; } });
 Object.defineProperty(exports, "openSnapImage", { enumerable: true, get: function () { return helpers_3.openImage; } });
+Object.defineProperty(exports, "findSnapPackages", { enumerable: true, get: function () { return helpers_3.findSnapPackages; } });
+Object.defineProperty(exports, "findSnapPackagePath", { enumerable: true, get: function () { return helpers_3.findSnapPackagePath; } });
+Object.defineProperty(exports, "findSnapUsers", { enumerable: true, get: function () { return helpers_3.findSnapUsers; } });
+Object.defineProperty(exports, "findSnapUserVocabularies", { enumerable: true, get: function () { return helpers_3.findSnapUserVocabularies; } });
+Object.defineProperty(exports, "findSnapUserHistory", { enumerable: true, get: function () { return helpers_3.findSnapUserHistory; } });
+Object.defineProperty(exports, "isSnapInstalled", { enumerable: true, get: function () { return helpers_3.isSnapInstalled; } });
+Object.defineProperty(exports, "readSnapUsage", { enumerable: true, get: function () { return helpers_3.readSnapUsage; } });
+Object.defineProperty(exports, "readSnapUsageForUser", { enumerable: true, get: function () { return helpers_3.readSnapUsageForUser; } });
 // TouchChat helpers (stubs)
 var helpers_4 = require("./touchchat/helpers");
 Object.defineProperty(exports, "getTouchChatPageTokenImageMap", { enumerable: true, get: function () { return helpers_4.getPageTokenImageMap; } });

package/dist/processors/obfProcessor.js

@@ -144,12 +144,15 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 }
                 const obj = JSON.parse(str);
                 if (obj && typeof obj === 'object' && 'id' in obj && 'buttons' in obj) {
+                    // Validate buttons is an array
+                    if (!Array.isArray(obj.buttons)) {
+                        throw new Error('Invalid OBF: buttons must be an array');
+                    }
                     return obj;
                 }
             }
             catch (error) {
                 // Log parsing errors for debugging but don't throw
-                console.warn(`Failed to parse OBF JSON: ${error.message}`);
             }
             return null;
         }
@@ -232,7 +235,12 @@ class ObfProcessor extends baseProcessor_1.BaseProcessor {
                 buttonPositions.set(id, index);
                 return id;
             });
-            return { rows: 1, columns: fallbackRow.length, order: [fallbackRow], buttonPositions };
+            return {
+                rows: 1,
+                columns: fallbackRow.length,
+                order: [fallbackRow],
+                buttonPositions,
+            };
         }
         const order = [];
         for (let rowIndex = 0; rowIndex < totalRows; rowIndex++) {