@willwade/aac-processors 0.2.20 → 0.3.1

package/dist/browser/validation/gridsetValidator.js

@@ -29,12 +29,12 @@ export class GridsetValidator extends BaseValidator {
         if (name.endsWith('.gridset') || name.endsWith('.gridsetx')) {
             return true;
         }
-        // Try to parse as XML and check for gridset structure
+        // Try to parse as XML and check for a Grid 3 <Grid> root element
         try {
             const contentStr = typeof content === 'string' ? content : decodeText(toUint8Array(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
-            return result && (result.gridset || result.Gridset);
+            return !!(result && (result.Grid || result.grid));
         }
         catch {
             return false;
@@ -78,7 +78,7 @@ export class GridsetValidator extends BaseValidator {
         return content[0] === 0x50 && content[1] === 0x4b && content[2] === 0x03 && content[3] === 0x04;
     }
     /**
-     * Validate a single XML file (legacy or exploded format)
+     * Validate a single grid.xml file (exploded/non-zip format)
      */
     async validateSingleXml(content, filename, _filesize) {
         let xmlObj = null;
@@ -94,49 +94,57 @@ export class GridsetValidator extends BaseValidator {
         });
         if (!xmlObj)
             return;
-        await this.add_check('xml_structure', 'gridset root element', async () => {
-            if (!xmlObj.gridset && !xmlObj.Gridset) {
-                this.err('missing root gridset element', true);
+        await this.add_check('xml_structure', 'Grid root element', async () => {
+            if (!xmlObj.Grid && !xmlObj.grid) {
+                this.err('missing root Grid element', true);
             }
         });
-        const gridset = xmlObj.gridset || xmlObj.Gridset;
-        if (gridset) {
-            await this.validateGridsetStructure(gridset, filename, content);
+        const grid = xmlObj.Grid || xmlObj.grid;
+        if (grid) {
+            await this.validateGridStructure(grid, filename);
         }
     }
     /**
      * Validate a ZIP archive (.gridset)
+     *
+     * Real Grid 3 archives do NOT contain a top-level gridset.xml. The required
+     * structure is: Settings0/settings.xml + FileMap.xml + Grids/<name>/grid.xml
+     * (+ optional Styles, images, thumbnails).
      */
-    async validateZipArchive(content, filename, _filesize) {
+    async validateZipArchive(content, _filename, _filesize) {
         const zip = await this._options.zipAdapter(content);
         const entries = zip.listFiles();
-        // Check for gridset.xml (required)
-        await this.add_check('gridset_xml_presence', 'gridset.xml presence', async () => {
-            const gridsetEntry = entries.find((e) => e.toLowerCase() === 'gridset.xml');
-            if (!gridsetEntry) {
-                this.err('Missing gridset.xml in archive', true);
+        // --- Required: at least one Grids/<name>/grid.xml ---
+        const gridEntries = entries.filter((e) => /^Grids\/.+\/grid\.xml$/i.test(e));
+        await this.add_check('grid_xml_presence', 'Grids/*/grid.xml presence', async () => {
+            if (gridEntries.length === 0) {
+                this.err('No Grids/<name>/grid.xml found in archive', true);
             }
-            else {
+        });
+        // Validate the <Grid> structure of each grid.xml (sample up to 5)
+        for (let i = 0; i < Math.min(gridEntries.length, 5); i++) {
+            const entry = gridEntries[i];
+            await this.add_check(`grid_xml[${entry}]`, `grid structure: ${entry}`, async () => {
                 try {
-                    const gridsetXml = await zip.readFile(gridsetEntry);
+                    const gridXml = await zip.readFile(entry);
                     const parser = new xml2js.Parser();
-                    const xmlObj = await parser.parseStringPromise(gridsetXml);
-                    const gridset = xmlObj.gridset || xmlObj.Gridset;
-                    if (!gridset) {
-                        this.err('Invalid gridset.xml structure', true);
+                    const xmlObj = await parser.parseStringPromise(gridXml);
+                    const grid = xmlObj.Grid || xmlObj.grid;
+                    if (!grid) {
+                        this.err(`${entry}: missing root <Grid> element`);
                     }
                     else {
-                        await this.validateGridsetStructure(gridset, filename, new Uint8Array());
+                        await this.validateGridStructure(grid, entry);
                     }
                 }
                 catch (e) {
-                    this.err(`Failed to parse gridset.xml: ${e.message}`, true);
+                    this.err(`${entry}: failed to parse XML: ${e.message}`);
                 }
-            }
-        });
-        // Check for settings.xml (highly recommended/required for metadata)
+            });
+        }
+        // --- Recommended: Settings0/settings.xml ---
         await this.add_check('settings_xml_presence', 'settings.xml presence', async () => {
-            const settingsEntry = entries.find((e) => e.toLowerCase() === 'settings.xml');
+            const settingsEntry = entries.find((e) => e.toLowerCase() === 'settings.xml' || e.toLowerCase().endsWith('/settings.xml'));
             if (!settingsEntry) {
                 this.warn('Missing settings.xml in archive (required for full metadata)');
             }
@@ -161,187 +169,35 @@ export class GridsetValidator extends BaseValidator {
                 }
             }
         });
-    }
-    /**
-     * Validate Gridset structure
-     */
-    async validateGridsetStructure(gridset, _filename, _content) {
-        // Check for required elements
-        await this.add_check('gridset_id', 'gridset id', async () => {
-            const id = gridset.$.id || gridset.$.Id;
-            if (!id) {
-                this.warn('gridset should have an id attribute');
-            }
-        });
-        await this.add_check('gridset_name', 'gridset name', async () => {
-            const name = gridset.$.name || gridset.$.Name || gridset.name?.[0];
-            if (!name) {
-                this.warn('gridset should have a name attribute or element');
-            }
-        });
-        // Check for pages
-        await this.add_check('pages', 'pages element', async () => {
-            if (!gridset.pages && !gridset.Pages) {
-                this.err('gridset must have a pages element');
-            }
-            else {
-                const pages = gridset.pages || gridset.Pages;
-                if (!pages[0] || !Array.isArray(pages[0].page)) {
-                    this.warn('pages should contain at least one page element');
-                }
-            }
-        });
-        // Validate individual pages
-        const pages = gridset.pages?.[0] || gridset.Pages?.[0];
-        if (pages && Array.isArray(pages.page)) {
-            await this.add_check('page_count', 'page count', async () => {
-                if (pages.page.length === 0) {
-                    this.err('gridset must contain at least one page');
-                }
-            });
-            for (let i = 0; i < Math.min(pages.page.length, 10); i++) {
-                // Limit to first 10 pages to avoid excessive validation
-                const page = pages.page[i];
-                await this.validatePage(page, i);
-            }
-        }
-        // Check for fixedCellSize
-        await this.add_check('fixed_cell_size', 'fixedCellSize element', async () => {
-            const fixedSize = gridset.fixedCellSize || gridset.FixedCellSize;
-            if (!fixedSize) {
-                this.warn('gridset should have a fixedCellSize element for consistency');
-            }
-            else {
-                // Validate fixedCellSize structure
-                const size = fixedSize[0];
-                if (size) {
-                    const width = size.$.width || size.$.Width;
-                    const height = size.$.height || size.$.Height;
-                    if (!width || !height) {
-                        this.warn('fixedCellSize should have both width and height attributes');
-                    }
-                    else if (isNaN(parseInt(width)) || isNaN(parseInt(height))) {
-                        this.err('fixedCellSize width and height must be valid numbers');
-                    }
-                }
-            }
-        });
-        // Check for styles
-        await this.add_check('styles', 'styles element', async () => {
-            const styles = gridset.styles || gridset.Styles;
-            if (!styles) {
-                this.warn('gridset should have a styles element for consistent formatting');
+        // --- Recommended: FileMap.xml (used for image resolution) ---
+        await this.add_check('filemap_presence', 'FileMap.xml presence', async () => {
+            const filemapEntry = entries.find((e) => e.toLowerCase() === 'filemap.xml');
+            if (!filemapEntry) {
+                this.warn('Missing FileMap.xml in archive (used for image resolution)');
             }
         });
     }
     /**
-     * Validate a single page
+     * Validate a real Grid 3 <Grid> element (from grid.xml).
+     * Checks for GridGuid, Cells, and basic cell structure.
      */
-    async validatePage(page, index) {
-        await this.add_check(`page[${index}]_id`, `page ${index} id`, async () => {
-            const id = page.$.id || page.$.Id;
-            if (!id) {
-                this.err(`page at index ${index} is missing id attribute`);
+    async validateGridStructure(grid, label) {
+        await this.add_check(`${label}_gridguid`, 'GridGuid', async () => {
+            const guid = grid.GridGuid || grid.gridGuid;
+            if (!guid) {
+                this.warn(`${label}: missing <GridGuid> element`);
             }
         });
-        await this.add_check(`page[${index}]_name`, `page ${index} name`, async () => {
-            const name = page.$.name || page.$.Name || page.name?.[0];
-            if (!name) {
-                this.warn(`page ${index} should have a name`);
-            }
-        });
-        // Check for cells
-        await this.add_check(`page[${index}]_cells`, `page ${index} cells`, async () => {
-            const cells = page.cells || page.Cells;
+        await this.add_check(`${label}_cells`, 'Cells element', async () => {
+            const cells = grid.Cells || grid.cells;
             if (!cells) {
-                this.warn(`page ${index} should have a cells element`);
+                this.warn(`${label}: missing <Cells> element`);
+                return;
             }
-            else {
-                const cellArray = cells[0]?.cell || cells[0]?.Cell;
-                if (!cellArray || !Array.isArray(cellArray) || cellArray.length === 0) {
-                    this.warn(`page ${index} should contain at least one cell`);
-                }
+            const cellArray = cells[0]?.Cell || cells[0]?.cell;
+            if (!cellArray || !Array.isArray(cellArray) || cellArray.length === 0) {
+                this.warn(`${label}: <Cells> should contain at least one <Cell>`);
             }
         });
-        // Validate cells if present
-        const cells = page.cells?.[0] || page.Cells?.[0];
-        if (cells) {
-            const cellArray = cells.cell || cells.Cell;
-            if (Array.isArray(cellArray) && cellArray.length > 0) {
-                // Sample a few cells to validate
-                const sampleSize = Math.min(cellArray.length, 5);
-                for (let i = 0; i < sampleSize; i++) {
-                    await this.validateCell(cellArray[i], index, i);
-                }
-            }
-        }
-    }
-    /**
-     * Validate a single cell
-     */
-    async validateCell(cell, pageIdx, cellIdx) {
-        await this.add_check(`page[${pageIdx}]_cell[${cellIdx}]_id`, `cell id`, async () => {
-            const id = cell.$.id || cell.$.Id;
-            if (!id) {
-                this.warn(`cell ${cellIdx} on page ${pageIdx} is missing id attribute`);
-            }
-        });
-        await this.add_check(`page[${pageIdx}]_cell[${cellIdx}]_content`, `cell content`, async () => {
-            const label = cell.$.label || cell.$.Label;
-            const image = cell.$.image || cell.$.Image;
-            if (!label && !image) {
-                this.warn(`cell ${cellIdx} on page ${pageIdx} should have a label or image`);
-            }
-        });
-        // Validate scan block number (Grid 3 attribute)
-        await this.add_check(`page[${pageIdx}]_cell[${cellIdx}]_scanblock`, `cell scan block`, async () => {
-            const scanBlock = cell.$.scanBlock || cell.$.ScanBlock;
-            if (scanBlock !== undefined) {
-                const blockNum = parseInt(scanBlock, 10);
-                if (isNaN(blockNum) || blockNum < 1 || blockNum > 8) {
-                    this.err(`cell ${cellIdx} on page ${pageIdx} has invalid scanBlock value: ${scanBlock} (must be 1-8)`, false);
-                }
-            }
-        });
-        // Check for color attributes
-        const backgroundColor = cell.$.backgroundColor || cell.$.BackgroundColor;
-        const _color = cell.$.color || cell.$.Color;
-        if (backgroundColor) {
-            await this.add_check(`page[${pageIdx}]_cell[${cellIdx}]_bg_color`, `cell background color`, async () => {
-                // Grid3 colors can be in various formats: named colors, hex, ARGB
-                // We just check it's not empty
-                if (backgroundColor.length === 0) {
-                    this.warn(`cell ${cellIdx} has empty background color`);
-                }
-            });
-        }
-        // Check for valid jump references
-        const jump = cell.$.jump || cell.$.Jump;
-        if (jump) {
-            await this.add_check(`page[${pageIdx}]_cell[${cellIdx}]_jump`, `cell jump reference`, async () => {
-                if (typeof jump !== 'string' || jump.length === 0) {
-                    this.warn(`cell ${cellIdx} has invalid jump reference`);
-                }
-            });
-        }
-    }
-    /**
-     * Validate color format (Grid3 uses ARGB format)
-     */
-    isValidGrid3Color(color) {
-        if (!color || color.length === 0)
-            return false;
-        // Named colors are valid
-        if (/^[a-zA-Z]+$/.test(color))
-            return true;
-        // ARGB format: #AARRGGBB or #RRGGBB
-        if (color.startsWith('#')) {
-            return color.length === 7 || color.length === 9;
-        }
-        // RGB format: rgb(r,g,b) or rgba(r,g,b,a)
-        if (color.startsWith('rgb')) {
-            return true; // Simplified check
-        }
-        return false;
     }
 }

package/dist/cli/index.js

@@ -25,6 +25,9 @@ async function detectFormat(filePath) {
     if (filePath.endsWith('.gridset')) {
         return 'gridset';
     }
+    if (filePath.endsWith('.gtbz')) {
+        return 'gotalknow';
+    }
     // Otherwise use file extension
     return (0, io_1.extname)(filePath).slice(1);
 }

package/dist/core/analyze.js

@@ -11,6 +11,7 @@ const snapProcessor_1 = require("../processors/snapProcessor");
 const dotProcessor_1 = require("../processors/dotProcessor");
 const excelProcessor_1 = require("../processors/excelProcessor");
 const applePanelsProcessor_1 = require("../processors/applePanelsProcessor");
+const gotalkNowProcessor_1 = require("../processors/gotalkNowProcessor");
 /**
  * Resolve a processor instance by friendly format name or common extension.
  * @param format Format key or extension (e.g., 'snap', 'obf', 'xlsx')
@@ -45,6 +46,10 @@ function getProcessor(format, options) {
         case 'panels': // Apple Panels file extension
         case 'ascconfig': // Apple Panels folder format
             return new applePanelsProcessor_1.ApplePanelsProcessor(options);
+        case 'gotalknow':
+        case 'gotalk':
+        case 'gtbz': // GoTalk NOW file extension
+            return new gotalkNowProcessor_1.GotalkNowProcessor(options);
         default:
             throw new Error('Unknown format: ' + format);
     }

package/dist/core/treeStructure.d.ts

@@ -114,6 +114,18 @@ export interface AACSemanticAction {
                 [key: string]: any;
             };
         };
+        gotalkNow?: {
+            buttonType: string;
+            jumpTo?: number;
+            jumpBook?: string;
+            audioLocation?: string;
+            trimStart?: number;
+            trimEnd?: number;
+            url?: string;
+            openInternally?: boolean;
+            goVisual?: string;
+            goVisualLink?: unknown;
+        };
     };
     fallback?: {
         type: 'SPEAK' | 'NAVIGATE' | 'ACTION';

package/dist/gotalkNow.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GoTalk NOW Namespace
+ *
+ * GoTalk NOW (Attainment Company) format processing utilities.
+ */
+export { GotalkNowProcessor } from './processors/gotalkNowProcessor';

package/dist/gotalkNow.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * GoTalk NOW Namespace
+ *
+ * GoTalk NOW (Attainment Company) format processing utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GotalkNowProcessor = void 0;
+// Processor class
+var gotalkNowProcessor_1 = require("./processors/gotalkNowProcessor");
+Object.defineProperty(exports, "GotalkNowProcessor", { enumerable: true, get: function () { return gotalkNowProcessor_1.GotalkNowProcessor; } });

package/dist/index.browser.d.ts

@@ -22,6 +22,7 @@ export { SnapProcessor } from './processors/snapProcessor';
 export { TouchChatProcessor } from './processors/touchchatProcessor';
 export { ApplePanelsProcessor } from './processors/applePanelsProcessor';
 export { AstericsGridProcessor } from './processors/astericsGridProcessor';
+export { GotalkNowProcessor } from './processors/gotalkNowProcessor';
 export * as Metrics from './metrics';
 import { BaseProcessor, ProcessorOptions } from './core/baseProcessor';
 export { configureSqlJs } from './utils/sqlite';

package/dist/index.browser.js

@@ -39,7 +39,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.configureSqlJs = exports.Metrics = exports.AstericsGridProcessor = exports.ApplePanelsProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.GridsetProcessor = exports.ObfProcessor = exports.OpmlProcessor = exports.DotProcessor = void 0;
+exports.configureSqlJs = exports.Metrics = exports.GotalkNowProcessor = exports.AstericsGridProcessor = exports.ApplePanelsProcessor = exports.TouchChatProcessor = exports.SnapProcessor = exports.GridsetProcessor = exports.ObfProcessor = exports.OpmlProcessor = exports.DotProcessor = void 0;
 exports.getProcessor = getProcessor;
 exports.getSupportedExtensions = getSupportedExtensions;
 exports.isExtensionSupported = isExtensionSupported;
@@ -68,6 +68,8 @@ var applePanelsProcessor_1 = require("./processors/applePanelsProcessor");
 Object.defineProperty(exports, "ApplePanelsProcessor", { enumerable: true, get: function () { return applePanelsProcessor_1.ApplePanelsProcessor; } });
 var astericsGridProcessor_1 = require("./processors/astericsGridProcessor");
 Object.defineProperty(exports, "AstericsGridProcessor", { enumerable: true, get: function () { return astericsGridProcessor_1.AstericsGridProcessor; } });
+var gotalkNowProcessor_1 = require("./processors/gotalkNowProcessor");
+Object.defineProperty(exports, "GotalkNowProcessor", { enumerable: true, get: function () { return gotalkNowProcessor_1.GotalkNowProcessor; } });
 // ===================================================================
 // UTILITY FUNCTIONS
 // ===================================================================
@@ -81,6 +83,7 @@ const snapProcessor_2 = require("./processors/snapProcessor");
 const touchchatProcessor_2 = require("./processors/touchchatProcessor");
 const applePanelsProcessor_2 = require("./processors/applePanelsProcessor");
 const astericsGridProcessor_2 = require("./processors/astericsGridProcessor");
+const gotalkNowProcessor_2 = require("./processors/gotalkNowProcessor");
 var sqlite_1 = require("./utils/sqlite");
 Object.defineProperty(exports, "configureSqlJs", { enumerable: true, get: function () { return sqlite_1.configureSqlJs; } });
 /**
@@ -112,6 +115,8 @@ function getProcessor(filePathOrExtension, options) {
             return new applePanelsProcessor_2.ApplePanelsProcessor(options);
         case '.grd':
             return new astericsGridProcessor_2.AstericsGridProcessor(options);
+        case '.gtbz':
+            return new gotalkNowProcessor_2.GotalkNowProcessor(options);
         default:
             throw new Error(`Unsupported file extension: ${extension}`);
     }
@@ -121,7 +126,19 @@ function getProcessor(filePathOrExtension, options) {
  * @returns Array of supported file extensions
  */
 function getSupportedExtensions() {
-    return ['.dot', '.opml', '.obf', '.obz', '.gridset', '.spb', '.sps', '.ce', '.plist', '.grd'];
+    return [
+        '.dot',
+        '.opml',
+        '.obf',
+        '.obz',
+        '.gridset',
+        '.spb',
+        '.sps',
+        '.ce',
+        '.plist',
+        '.grd',
+        '.gtbz',
+    ];
 }
 /**
  * Check if a file extension is supported

package/dist/index.node.d.ts

@@ -25,6 +25,7 @@ export * as Excel from './excel';
 export * as Opml from './opml';
 export * as ApplePanels from './applePanels';
 export * as AstericsGrid from './astericsGrid';
+export * as GotalkNow from './gotalkNow';
 export * as Translation from './translation';
 import { BaseProcessor, ProcessorOptions } from './core/baseProcessor';
 /**

package/dist/index.node.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Translation = exports.AstericsGrid = exports.ApplePanels = exports.Opml = exports.Excel = exports.Dot = exports.TouchChat = exports.Obfset = exports.OBF = exports.Snap = exports.Gridset = exports.WordFormGenerator = exports.TDSnapLexiconParser = exports.Grid3VerbsParser = exports.Metrics = exports.Validation = exports.Analytics = void 0;
+exports.Translation = exports.GotalkNow = exports.AstericsGrid = exports.ApplePanels = exports.Opml = exports.Excel = exports.Dot = exports.TouchChat = exports.Obfset = exports.OBF = exports.Snap = exports.Gridset = exports.WordFormGenerator = exports.TDSnapLexiconParser = exports.Grid3VerbsParser = exports.Metrics = exports.Validation = exports.Analytics = void 0;
 exports.getProcessor = getProcessor;
 exports.getSupportedExtensions = getSupportedExtensions;
 exports.isExtensionSupported = isExtensionSupported;
@@ -74,6 +74,7 @@ exports.Excel = __importStar(require("./excel"));
 exports.Opml = __importStar(require("./opml"));
 exports.ApplePanels = __importStar(require("./applePanels"));
 exports.AstericsGrid = __importStar(require("./astericsGrid"));
+exports.GotalkNow = __importStar(require("./gotalkNow"));
 exports.Translation = __importStar(require("./translation"));
 const dotProcessor_1 = require("./processors/dotProcessor");
 const excelProcessor_1 = require("./processors/excelProcessor");
@@ -85,6 +86,7 @@ const touchchatProcessor_1 = require("./processors/touchchatProcessor");
 const applePanelsProcessor_1 = require("./processors/applePanelsProcessor");
 const astericsGridProcessor_1 = require("./processors/astericsGridProcessor");
 const obfsetProcessor_1 = require("./processors/obfsetProcessor");
+const gotalkNowProcessor_1 = require("./processors/gotalkNowProcessor");
 /**
  * Factory function to get the appropriate processor for a file extension
  * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')
@@ -124,6 +126,8 @@ function getProcessor(filePathOrExtension, options) {
             return new applePanelsProcessor_1.ApplePanelsProcessor(options);
         case '.grd':
             return new astericsGridProcessor_1.AstericsGridProcessor(options);
+        case '.gtbz':
+            return new gotalkNowProcessor_1.GotalkNowProcessor(options);
         default:
             throw new Error(`Unsupported file extension: ${extension}`);
     }
@@ -147,6 +151,7 @@ function getSupportedExtensions() {
         '.ce',
         '.plist',
         '.grd',
+        '.gtbz',
     ];
 }
 /**

package/dist/processors/gotalkNow/nsKeyed.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Helpers for decoding GoTalk NOW's NSKeyedArchiver-encoded values.
+ *
+ * GoTalk NOW stores UIColor and UIFont objects inside `<data>` tags as
+ * binary property lists (NSKeyedArchiver). Rather than pulling in a full
+ * bplist parser, we exploit the fact that the archived objects embed
+ * human-readable ASCII representations of the component values, e.g. an
+ * NSRGB colour appears as "0.908 0.355 0.522" and a font name appears as
+ * "Futura-Medium".
+ */
+/**
+ * Decode an NSKeyedArchiver-encoded UIColor into a #rrggbb hex string.
+ *
+ * NSRGB / NSCalibratedRGB colours store a human-readable "R G B [A]" string
+ * (e.g. "0.908 0.355 0.522") inside the archive — this is the only encoding we
+ * can reliably read without a full binary-plist parser. NSWhite and
+ * UISystemColor values store their components as raw IEEE-754 floats, so we
+ * return undefined for those rather than risk an incorrect colour.
+ */
+export declare function decodeNsColor(buffer: Uint8Array | Buffer | undefined): string | undefined;
+/**
+ * Decode an NSKeyedArchiver-encoded UIFont into its family name.
+ * Font size is encoded as a raw IEEE-754 float and is not extracted.
+ */
+export declare function decodeNsFont(buffer: Uint8Array | Buffer | undefined): {
+    fontFamily?: string;
+};

package/dist/processors/gotalkNow/nsKeyed.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Helpers for decoding GoTalk NOW's NSKeyedArchiver-encoded values.
+ *
+ * GoTalk NOW stores UIColor and UIFont objects inside `<data>` tags as
+ * binary property lists (NSKeyedArchiver). Rather than pulling in a full
+ * bplist parser, we exploit the fact that the archived objects embed
+ * human-readable ASCII representations of the component values, e.g. an
+ * NSRGB colour appears as "0.908 0.355 0.522" and a font name appears as
+ * "Futura-Medium".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeNsColor = decodeNsColor;
+exports.decodeNsFont = decodeNsFont;
+function bufferToLatinString(buffer) {
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(buffer)) {
+        return buffer.toString('latin1');
+    }
+    let out = '';
+    for (let i = 0; i < buffer.length; i++)
+        out += String.fromCharCode(buffer[i]);
+    return out;
+}
+function clampUnit(v) {
+    if (Number.isNaN(v))
+        return 0;
+    return Math.max(0, Math.min(1, v));
+}
+function toHexChannel(v) {
+    return Math.round(clampUnit(v) * 255)
+        .toString(16)
+        .padStart(2, '0');
+}
+/** Convert a 0-1 float triple to an #rrggbb hex string. */
+function rgbToHex(r, g, b) {
+    return `#${toHexChannel(r)}${toHexChannel(g)}${toHexChannel(b)}`;
+}
+/**
+ * Decode an NSKeyedArchiver-encoded UIColor into a #rrggbb hex string.
+ *
+ * NSRGB / NSCalibratedRGB colours store a human-readable "R G B [A]" string
+ * (e.g. "0.908 0.355 0.522") inside the archive — this is the only encoding we
+ * can reliably read without a full binary-plist parser. NSWhite and
+ * UISystemColor values store their components as raw IEEE-754 floats, so we
+ * return undefined for those rather than risk an incorrect colour.
+ */
+function decodeNsColor(buffer) {
+    if (!buffer)
+        return undefined;
+    const s = bufferToLatinString(buffer);
+    // Match RGB[A] component strings like "1 0.949 0.561" or "0.5 0.5 0.5 1".
+    // Allow integer components (e.g. "1") but require at least one decimal to
+    // avoid matching bplist header bytes (e.g. "00 00 00").
+    const candidates = s.match(/\d+(?:\.\d+)?\s+\d+(?:\.\d+)?\s+\d+(?:\.\d+)?(?:\s+\d+(?:\.\d+)?)?/g);
+    if (candidates) {
+        // Find the first candidate that looks like RGB (has at least one decimal point).
+        const rgbStr = candidates.find((c) => c.includes('.'));
+        if (rgbStr) {
+            const parts = rgbStr.split(/\s+/).map(Number);
+            return rgbToHex(parts[0], parts[1], parts[2]);
+        }
+    }
+    return undefined;
+}
+const FONT_KEYWORDS = new Set([
+    'bplist',
+    'bplist00',
+    'UIFont',
+    'UIFontName',
+    'UIFontPointSize',
+    'UIFontDescriptor',
+    'UIFontTraits',
+    'UIFontSystemFont',
+    'UIFontDescriptorAttributes',
+    'UIFontSystemFontName',
+    'NSFont',
+    'NSFontNameAttribute',
+    'NSFontSizeAttribute',
+    'NSName',
+    'NSSize',
+    'NSMutableDictionary',
+    'NSDictionary',
+    'NSObject',
+    'NSKeyedArchiver',
+    'NSColor',
+    'NSColorSpace',
+    'VUIFont',
+    'XNSObject',
+    'classname',
+    'classhints',
+    'classes',
+    'objects',
+    'version',
+    'archiver',
+    'root',
+]);
+/**
+ * Decode an NSKeyedArchiver-encoded UIFont into its family name.
+ * Font size is encoded as a raw IEEE-754 float and is not extracted.
+ */
+function decodeNsFont(buffer) {
+    if (!buffer)
+        return {};
+    const s = bufferToLatinString(buffer);
+    const tokens = s.match(/[A-Za-z][A-Za-z0-9-]{2,}/g) || [];
+    const fontFamily = tokens.find((t) => !FONT_KEYWORDS.has(t) &&
+        !t.startsWith('UI') &&
+        !t.startsWith('NS') &&
+        !t.startsWith('CF') &&
+        !t.startsWith('GT'));
+    return fontFamily ? { fontFamily } : {};
+}