@willwade/aac-processors 0.2.20 → 0.3.1

package/README.md

@@ -65,6 +65,7 @@ const tree = await processor.loadIntoTree(gridsetUint8Array);
 - DOT (Graphviz)
 - Apple Panels (macOS plist)
 - Asterics Grid
+- GoTalk NOW (.gtbz)
 - Excel export
 
 ## Wrangle strings workflow

package/dist/browser/index.browser.js

@@ -28,6 +28,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';
 // ===================================================================
 // UTILITY FUNCTIONS
 // ===================================================================
@@ -41,6 +42,7 @@ import { SnapProcessor } from './processors/snapProcessor';
 import { TouchChatProcessor } from './processors/touchchatProcessor';
 import { ApplePanelsProcessor } from './processors/applePanelsProcessor';
 import { AstericsGridProcessor } from './processors/astericsGridProcessor';
+import { GotalkNowProcessor } from './processors/gotalkNowProcessor';
 export { configureSqlJs } from './utils/sqlite';
 /**
  * Factory function to get the appropriate processor for a file extension
@@ -71,6 +73,8 @@ export function getProcessor(filePathOrExtension, options) {
             return new ApplePanelsProcessor(options);
         case '.grd':
             return new AstericsGridProcessor(options);
+        case '.gtbz':
+            return new GotalkNowProcessor(options);
         default:
             throw new Error(`Unsupported file extension: ${extension}`);
     }
@@ -80,7 +84,19 @@ export function getProcessor(filePathOrExtension, options) {
  * @returns Array of supported file extensions
  */
 export 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/browser/processors/gotalkNow/nsKeyed.js

@@ -0,0 +1,108 @@
+/**
+ * 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".
+ */
+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.
+ */
+export 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.
+ */
+export 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 } : {};
+}