@willwade/aac-processors 0.0.5 → 0.0.7

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

@@ -2,3 +2,33 @@ import { AACTree } from '../../core/treeStructure';
 export declare function getPageTokenImageMap(tree: AACTree, pageId: string): Map<string, string>;
 export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
 export declare function openImage(gridsetBuffer: Buffer, entryPath: string): Buffer | null;
+/**
+ * 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
+ */
+export declare function generateGrid3Guid(): string;
+/**
+ * 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
+ */
+export declare function createSettingsXml(startGrid: string, options?: {
+    scanEnabled?: boolean;
+    scanTimeoutMs?: number;
+    hoverEnabled?: boolean;
+    hoverTimeoutMs?: number;
+    mouseclickEnabled?: boolean;
+    language?: string;
+}): string;
+/**
+ * Create Grid3 FileMap.xml content
+ * @param grids - Array of grid configurations with name and path
+ * @returns XML string for FileMap.xml
+ */
+export declare function createFileMapXml(grids: Array<{
+    name: string;
+    path: string;
+    dynamicFiles?: string[];
+}>): string;

package/dist/processors/gridset/helpers.js

@@ -6,7 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPageTokenImageMap = getPageTokenImageMap;
 exports.getAllowedImageEntries = getAllowedImageEntries;
 exports.openImage = openImage;
+exports.generateGrid3Guid = generateGrid3Guid;
+exports.createSettingsXml = createSettingsXml;
+exports.createFileMapXml = createFileMapXml;
 const adm_zip_1 = __importDefault(require("adm-zip"));
+const fast_xml_parser_1 = require("fast-xml-parser");
 function normalizeZipPath(p) {
     const unified = p.replace(/\\/g, '/');
     try {
@@ -46,3 +50,68 @@ 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);
+}

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/gridset/wordlistHelpers.js

@@ -49,7 +49,7 @@ function createWordlist(input) {
     }
     else if (typeof input === 'object') {
         // Handle dictionary/object input
-        items = Object.entries(input).map(([key, value]) => {
+        items = Object.entries(input).map(([, value]) => {
             if (typeof value === 'string') {
                 return { text: value };
             }
@@ -222,7 +222,8 @@ function updateWordlist(gridsetBuffer, gridName, wordlist) {
                     found = true;
                 }
                 catch (error) {
-                    throw new Error(`Failed to update wordlist in grid "${gridName}": ${error}`);
+                    const message = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Failed to update wordlist in grid "${gridName}": ${message}`);
                 }
             }
         }

package/dist/processors/gridsetProcessor.js

@@ -56,7 +56,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     r: text,
                                 },
                                 {
-                                    r: { '__cdata': ' ' },
+                                    r: { __cdata: ' ' },
                                 },
                             ],
                         },
@@ -131,92 +131,85 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     },
                 };
             case 'SPEAK_TEXT':
-            case 'SPEAK_IMMEDIATE':
-                // For communication buttons, insert text into message bar (sentence building)
-                // Grid3 requires explicit trailing space for automatic word spacing
-                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                // Users can speak the complete sentence with a dedicated Speak button
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+            case 'SPEAK_IMMEDIATE': {
+                // Users can speak the complete sentence with a dedicated Speak button // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace) // Grid3 requires explicit trailing space for automatic word spacing // For communication buttons, insert text into message bar (sentence building)
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
+                }
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
+                    },
+                };
+            }
+            case 'INSERT_TEXT': {
+                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace) // Add trailing space for word buttons to enable sentence building
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
                 }
-            case 'INSERT_TEXT':
-                // Add trailing space for word buttons to enable sentence building
-                // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
-                }
-            default:
-                // Fallback to insert text with structured XML format
+                    },
+                };
+            }
+            default: {
                 // Use two <s> elements: one for the word, one for the space (CDATA preserves whitespace)
-                {
-                    let text = semanticAction.text || button.message || button.label || '';
-                    // Remove trailing space from message if present (we'll add it as separate segment)
-                    if (text.endsWith(' ')) {
-                        text = text.slice(0, -1);
-                    }
-                    return {
-                        Command: {
-                            '@_ID': 'Action.InsertText',
-                            Parameter: {
-                                '@_Key': 'text',
-                                p: {
-                                    s: [
-                                        {
-                                            r: text,
-                                        },
-                                        {
-                                            r: { '__cdata': ' ' },
-                                        },
-                                    ],
-                                },
+                // Fallback to insert text with structured XML format
+                let text = semanticAction.text || button.message || button.label || '';
+                // Remove trailing space from message if present (we'll add it as separate segment)
+                if (text.endsWith(' ')) {
+                    text = text.slice(0, -1);
+                }
+                return {
+                    Command: {
+                        '@_ID': 'Action.InsertText',
+                        Parameter: {
+                            '@_Key': 'text',
+                            p: {
+                                s: [
+                                    {
+                                        r: text,
+                                    },
+                                    {
+                                        r: { __cdata: ' ' },
+                                    },
+                                ],
                             },
                         },
-                    };
-                }
+                    },
+                };
+            }
         }
     }
     // Helper function to convert Grid 3 style to AACStyle
@@ -288,10 +281,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                 if (entries) {
                     const arr = Array.isArray(entries) ? entries : [entries];
                     for (const ent of arr) {
-                        const staticFile = (ent['@_StaticFile'] ||
-                            ent.StaticFile ||
-                            ent.staticFile ||
-                            '').replace(/\\/g, '/');
+                        const rawStaticFile = ent['@_StaticFile'] || ent.StaticFile || ent.staticFile;
+                        const staticFile = typeof rawStaticFile === 'string' ? rawStaticFile.replace(/\\/g, '/') : '';
                         if (!staticFile)
                             continue;
                         const df = ent.DynamicFiles || ent.dynamicFiles;
@@ -987,26 +978,22 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         const buttonImages = new Map();
         // Helper function to add style and return its ID
         const addStyle = (style) => {
-            if (!style || typeof style !== 'object')
-                return '';
-            const obj = style;
-            if (Object.keys(obj).length === 0)
+            if (!style)
                 return '';
-            const styleKey = JSON.stringify(obj);
+            const normalizedStyle = { ...style };
+            const styleKey = JSON.stringify(normalizedStyle);
             const existing = uniqueStyles.get(styleKey);
             if (existing)
                 return existing.id;
             const styleId = `Style${styleIdCounter++}`;
-            uniqueStyles.set(styleKey, { id: styleId, style: obj });
+            uniqueStyles.set(styleKey, { id: styleId, style: normalizedStyle });
             return styleId;
         };
         // Collect styles from all pages and buttons
         Object.values(tree.pages).forEach((page) => {
-            if (page.style)
-                addStyle(page.style);
+            addStyle(page.style);
             page.buttons.forEach((button) => {
-                if (button.style)
-                    addStyle(button.style);
+                addStyle(button.style);
             });
         });
         // Get the home/start grid from tree.rootId, fallback to first page
@@ -1053,8 +1040,8 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                     // When TileColour is present, BackColour is the surround (outer area)
                     // For "None" surround, just use BackColour for the fill (no TileColour)
                     BackColour: this.ensureAlphaChannel(style.backgroundColor),
-                    BorderColour: this.ensureAlphaChannel(style.borderColor) || '#000000FF',
-                    FontColour: this.ensureAlphaChannel(style.fontColor) || '#000000FF',
+                    BorderColour: this.ensureAlphaChannel(style.borderColor),
+                    FontColour: this.ensureAlphaChannel(style.fontColor),
                     FontName: style.fontFamily || 'Arial',
                     FontSize: style.fontSize?.toString() || '16',
                 };
@@ -1081,7 +1068,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
         // Collect grid file paths for FileMap.xml
         const gridFilePaths = [];
         // Create a grid for each page
-        Object.values(tree.pages).forEach((page, index) => {
+        Object.values(tree.pages).forEach((page) => {
             const gridData = {
                 Grid: {
                     '@_xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
@@ -1121,8 +1108,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     if (button.image) {
                                         // Try to determine file extension from image name or default to PNG
                                         let imageExt = 'png';
-                                        if (button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i)) {
-                                            imageExt = button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i)[1].toLowerCase();
+                                        const imageMatch = button.image.match(/\.(png|jpg|jpeg|gif|svg)$/i);
+                                        if (imageMatch) {
+                                            imageExt = imageMatch[1].toLowerCase();
                                         }
                                         // Grid3 dynamically constructs image filenames by prepending cell coordinates
                                         // The XML should only contain the suffix: -0-text-0.{ext}
@@ -1131,7 +1119,9 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                         // Extract image data from button parameters if available
                                         // (AstericsGridProcessor stores it there during loadIntoTree)
                                         let imageData = Buffer.alloc(0);
-                                        if (button.parameters && button.parameters.imageData && Buffer.isBuffer(button.parameters.imageData)) {
+                                        if (button.parameters &&
+                                            button.parameters.imageData &&
+                                            Buffer.isBuffer(button.parameters.imageData)) {
                                             imageData = button.parameters.imageData;
                                         }
                                         // Store image data for later writing to ZIP
@@ -1182,7 +1172,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                                     }
                                     return cellData;
                                 }),
-                            ]
+                            ],
                         }
                         : { Cell: [] },
                 },
@@ -1202,7 +1192,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
             zip.addFile(gridPath, Buffer.from(xmlContent, 'utf8'));
         });
         // Write image files to ZIP
-        buttonImages.forEach((imgData, buttonId) => {
+        buttonImages.forEach((imgData) => {
             if (imgData.imageData && imgData.imageData.length > 0) {
                 // Create image path in the grid's directory
                 const imagePath = `Grids\\${imgData.pageName}\\${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
@@ -1221,7 +1211,7 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         const imageFiles = [];
                         // Collect image filenames for buttons on this page
                         // IMPORTANT: FileMap.xml requires full paths like "Grids\PageName\1-5-0-text-0.png"
-                        buttonImages.forEach((imgData, buttonId) => {
+                        buttonImages.forEach((imgData) => {
                             if (imgData.pageName === gridName && imgData.imageData.length > 0) {
                                 const imagePath = `Grids\\${gridName}\\${imgData.x}-${imgData.y}-0-text-0.${imgData.ext}`;
                                 imageFiles.push(imagePath);
@@ -1229,9 +1219,11 @@ class GridsetProcessor extends baseProcessor_1.BaseProcessor {
                         });
                         return {
                             '@_StaticFile': gridPath,
-                            DynamicFiles: imageFiles.length > 0 ? {
-                                File: imageFiles
-                            } : {},
+                            DynamicFiles: imageFiles.length > 0
+                                ? {
+                                    File: imageFiles,
+                                }
+                                : {},
                         };
                     }),
                 },

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, } from './gridset/helpers';
+export { getPageTokenImageMap as getGridsetPageTokenImageMap, getAllowedImageEntries as getGridsetAllowedImageEntries, openImage as openGridsetImage, generateGrid3Guid as generateGridsetGuid, createSettingsXml as createGridsetSettingsXml, createFileMapXml as createGridsetFileMapXml, } 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 { 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, } from './snap/helpers';
 export { getPageTokenImageMap as getTouchChatPageTokenImageMap, getAllowedImageEntries as getTouchChatAllowedImageEntries, openImage as openTouchChatImage, } from './touchchat/helpers';

package/dist/processors/index.js

@@ -1,6 +1,6 @@
 "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.openTouchChatImage = exports.getTouchChatAllowedImageEntries = exports.getTouchChatPageTokenImageMap = 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 = exports.rgbaToHex = exports.getNamedColor = exports.wordlistToXml = exports.updateWordlist = exports.extractWordlists = exports.createWordlist = exports.resolveGrid3CellImage = exports.createGridsetFileMapXml = exports.createGridsetSettingsXml = exports.generateGridsetGuid = exports.openGridsetImage = exports.getGridsetAllowedImageEntries = exports.getGridsetPageTokenImageMap = 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;
 var applePanelsProcessor_1 = require("./applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var dotProcessor_1 = require("./dotProcessor");
@@ -24,10 +24,16 @@ 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; } });
 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; } });
 var resolver_1 = require("./gridset/resolver");
 Object.defineProperty(exports, "resolveGrid3CellImage", { enumerable: true, get: function () { return resolver_1.resolveGrid3CellImage; } });
 // Gridset (Grid 3) wordlist helpers
@@ -36,13 +42,26 @@ 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; } });
+// 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 (stubs)
 var helpers_3 = require("./snap/helpers");
 Object.defineProperty(exports, "getSnapPageTokenImageMap", { enumerable: true, get: function () { return helpers_3.getPageTokenImageMap; } });

package/dist/processors/obfProcessor.d.ts

@@ -5,6 +5,8 @@ declare class ObfProcessor extends BaseProcessor {
     private processBoard;
     extractTexts(filePathOrBuffer: string | Buffer): string[];
     loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    private buildGridMetadata;
+    private createObfBoardFromPage;
     processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
     saveFromTree(tree: AACTree, outputPath: string): void;
     /**