@willwade/aac-processors 0.0.3

package/dist/index.js

@@ -0,0 +1,96 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProcessor = getProcessor;
+exports.getSupportedExtensions = getSupportedExtensions;
+exports.isExtensionSupported = isExtensionSupported;
+// Main entry point for AACProcessors library
+__exportStar(require("./core/treeStructure"), exports);
+__exportStar(require("./core/baseProcessor"), exports);
+__exportStar(require("./core/stringCasing"), exports);
+__exportStar(require("./processors"), exports);
+const dotProcessor_1 = require("./processors/dotProcessor");
+const excelProcessor_1 = require("./processors/excelProcessor");
+const opmlProcessor_1 = require("./processors/opmlProcessor");
+const obfProcessor_1 = require("./processors/obfProcessor");
+const gridsetProcessor_1 = require("./processors/gridsetProcessor");
+const snapProcessor_1 = require("./processors/snapProcessor");
+const touchchatProcessor_1 = require("./processors/touchchatProcessor");
+const applePanelsProcessor_1 = require("./processors/applePanelsProcessor");
+const astericsGridProcessor_1 = require("./processors/astericsGridProcessor");
+/**
+ * Factory function to get the appropriate processor for a file extension
+ * @param filePathOrExtension - File path or extension (e.g., '.dot', '/path/to/file.obf')
+ * @returns The appropriate processor instance
+ * @throws Error if the file extension is not supported
+ */
+function getProcessor(filePathOrExtension) {
+    // Extract extension from file path
+    const extension = filePathOrExtension.includes('.')
+        ? filePathOrExtension.substring(filePathOrExtension.lastIndexOf('.'))
+        : filePathOrExtension;
+    switch (extension.toLowerCase()) {
+        case '.dot':
+            return new dotProcessor_1.DotProcessor();
+        case '.xlsx':
+            return new excelProcessor_1.ExcelProcessor();
+        case '.opml':
+            return new opmlProcessor_1.OpmlProcessor();
+        case '.obf':
+        case '.obz':
+            return new obfProcessor_1.ObfProcessor();
+        case '.gridset':
+            return new gridsetProcessor_1.GridsetProcessor();
+        case '.spb':
+        case '.sps':
+            return new snapProcessor_1.SnapProcessor();
+        case '.ce':
+            return new touchchatProcessor_1.TouchChatProcessor();
+        case '.plist':
+            return new applePanelsProcessor_1.ApplePanelsProcessor();
+        case '.grd':
+            return new astericsGridProcessor_1.AstericsGridProcessor();
+        default:
+            throw new Error(`Unsupported file extension: ${extension}`);
+    }
+}
+/**
+ * Get all supported file extensions
+ * @returns Array of supported file extensions
+ */
+function getSupportedExtensions() {
+    return [
+        '.dot',
+        '.xlsx',
+        '.opml',
+        '.obf',
+        '.obz',
+        '.gridset',
+        '.spb',
+        '.sps',
+        '.ce',
+        '.plist',
+        '.grd',
+    ];
+}
+/**
+ * Check if a file extension is supported
+ * @param extension - File extension to check
+ * @returns True if the extension is supported
+ */
+function isExtensionSupported(extension) {
+    return getSupportedExtensions().includes(extension.toLowerCase());
+}

package/dist/optional/symbolTools.d.ts

@@ -0,0 +1,28 @@
+export declare abstract class SymbolExtractor {
+    abstract getSymbolReferences(filePath: string): string[];
+}
+export declare abstract class SymbolResolver {
+    protected symbolPath: string;
+    protected dbPath: string;
+    constructor(symbolPath: string, dbPath: string);
+    abstract resolveSymbol(symbolRef: string): string | null;
+}
+export declare class SnapSymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(filePath: string): string[];
+}
+export declare class SnapSymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef: string): string | null;
+}
+export declare class Grid3SymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(filePath: string): string[];
+}
+export declare class Grid3SymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef: string): string | null;
+}
+export declare class TouchChatSymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(_filePath: string): string[];
+}
+export declare class TouchChatSymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef: string): string | null;
+}
+export declare function resolveSymbol(label: string, symbolDir: string): string | null;

package/dist/optional/symbolTools.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TouchChatSymbolResolver = exports.TouchChatSymbolExtractor = exports.Grid3SymbolResolver = exports.Grid3SymbolExtractor = exports.SnapSymbolResolver = exports.SnapSymbolExtractor = exports.SymbolResolver = exports.SymbolExtractor = void 0;
+exports.resolveSymbol = resolveSymbol;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+// --- Base Classes ---
+class SymbolExtractor {
+}
+exports.SymbolExtractor = SymbolExtractor;
+class SymbolResolver {
+    constructor(symbolPath, dbPath) {
+        this.symbolPath = symbolPath;
+        this.dbPath = dbPath;
+    }
+}
+exports.SymbolResolver = SymbolResolver;
+// --- Snap (Tobii Dynavox) ---
+let Database = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    Database = require('better-sqlite3');
+}
+catch {
+    Database = null;
+}
+class SnapSymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(filePath) {
+        if (!Database)
+            throw new Error('better-sqlite3 not installed');
+        const db = new Database(filePath, { readonly: true });
+        const rows = db
+            .prepare('SELECT DISTINCT LibrarySymbolId FROM Button WHERE LibrarySymbolId IS NOT NULL')
+            .all();
+        db.close();
+        return rows.map((row) => String(row.LibrarySymbolId));
+    }
+}
+exports.SnapSymbolExtractor = SnapSymbolExtractor;
+class SnapSymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef) {
+        if (!Database)
+            throw new Error('better-sqlite3 not installed');
+        const db = new Database(this.dbPath, { readonly: true });
+        const query = 'SELECT ImageData FROM Symbol WHERE Id = ?';
+        const row = db.prepare(query).get(symbolRef);
+        db.close();
+        if (!row)
+            return null;
+        const outPath = path_1.default.join(this.symbolPath, `${symbolRef}.png`);
+        fs_1.default.writeFileSync(outPath, row.ImageData);
+        return outPath;
+    }
+}
+exports.SnapSymbolResolver = SnapSymbolResolver;
+// --- Grid 3 ---
+let AdmZip = null;
+let XMLParser = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    AdmZip = require('adm-zip');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    XMLParser = require('fast-xml-parser').XMLParser;
+}
+catch {
+    AdmZip = null;
+    XMLParser = null;
+}
+class Grid3SymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(filePath) {
+        if (!AdmZip || !XMLParser)
+            throw new Error('adm-zip or fast-xml-parser not installed');
+        const zip = new AdmZip(filePath);
+        const parser = new XMLParser();
+        const refs = new Set();
+        zip.getEntries().forEach((entry) => {
+            if (entry.entryName.endsWith('.gridset')) {
+                const xmlBuffer = entry.getData();
+                // Parse to validate XML structure (future: extract refs)
+                parser.parse(xmlBuffer.toString('utf8'));
+                // TODO: Extract symbol references from Grid 3 XML structure when needed
+            }
+        });
+        return Array.from(refs);
+    }
+}
+exports.Grid3SymbolExtractor = Grid3SymbolExtractor;
+class Grid3SymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef) {
+        // Implementation depends on Grid 3 symbol storage format
+        const symbolPath = path_1.default.join(this.symbolPath, symbolRef);
+        return fs_1.default.existsSync(symbolPath) ? symbolPath : null;
+    }
+}
+exports.Grid3SymbolResolver = Grid3SymbolResolver;
+// --- TouchChat ---
+class TouchChatSymbolExtractor extends SymbolExtractor {
+    getSymbolReferences(_filePath) {
+        // Implementation depends on TouchChat file format
+        return [];
+    }
+}
+exports.TouchChatSymbolExtractor = TouchChatSymbolExtractor;
+class TouchChatSymbolResolver extends SymbolResolver {
+    resolveSymbol(symbolRef) {
+        // Implementation depends on TouchChat symbol storage format
+        const symbolPath = path_1.default.join(this.symbolPath, symbolRef);
+        return fs_1.default.existsSync(symbolPath) ? symbolPath : null;
+    }
+}
+exports.TouchChatSymbolResolver = TouchChatSymbolResolver;
+// --- Simple fallback function for PCS-style lookup ---
+function resolveSymbol(label, symbolDir) {
+    const cleanLabel = label.toLowerCase().replace(/[^a-z0-9]/g, '');
+    const exts = ['.png', '.jpg', '.svg'];
+    for (const ext of exts) {
+        const symbolPath = path_1.default.join(symbolDir, cleanLabel + ext);
+        if (fs_1.default.existsSync(symbolPath)) {
+            return symbolPath;
+        }
+    }
+    return null;
+}

package/dist/processors/applePanelsProcessor.d.ts

@@ -0,0 +1,23 @@
+import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
+import { AACTree } from '../core/treeStructure';
+declare class ApplePanelsProcessor extends BaseProcessor {
+    constructor(options?: ProcessorOptions);
+    private parseRect;
+    private pixelToGrid;
+    extractTexts(filePathOrBuffer: string | Buffer): string[];
+    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
+    saveFromTree(tree: AACTree, outputPath: string): void;
+    private createApplePanelsAction;
+    /**
+     * Extract strings with metadata for aac-tools-platform compatibility
+     * Uses the generic implementation from BaseProcessor
+     */
+    extractStringsWithMetadata(filePath: string): Promise<ExtractStringsResult>;
+    /**
+     * Generate translated download for aac-tools-platform compatibility
+     * Uses the generic implementation from BaseProcessor
+     */
+    generateTranslatedDownload(filePath: string, translatedStrings: TranslatedString[], sourceStrings: SourceString[]): Promise<string>;
+}
+export { ApplePanelsProcessor };