@willwade/aac-processors 0.1.20 → 0.2.0

package/dist/browser/core/baseProcessor.js

@@ -41,6 +41,8 @@
  */
 import { AACSemanticCategory } from './treeStructure';
 import { detectCasing, isNumericOrEmpty } from './stringCasing';
+import { defaultFileAdapter } from '../utils/io';
+import { getZipAdapter } from '../utils/zip';
 class BaseProcessor {
     constructor(options = {}) {
         // Default configuration: exclude navigation/system buttons
@@ -48,6 +50,8 @@ class BaseProcessor {
             excludeNavigationButtons: true,
             excludeSystemButtons: true,
             preserveAllButtons: false,
+            fileAdapter: defaultFileAdapter,
+            zipAdapter: getZipAdapter,
             ...options,
         };
     }

package/dist/browser/processors/applePanelsProcessor.js

@@ -1,9 +1,8 @@
 import { BaseProcessor, } from '../core/baseProcessor';
 import { AACTree, AACPage, AACButton, AACSemanticCategory, AACSemanticIntent, } from '../core/treeStructure';
-// Removed unused import: FileProcessor
 import plist from 'plist';
 import { ValidationFailureError, buildValidationResultFromMessage, } from '../validation/validationTypes';
-import { getBasename, getFs, getPath, readBinaryFromInput, readTextFromInput, writeTextToPath, } from '../utils/io';
+import { getBasename } from '../utils/io';
 function isNormalizedPanel(panel) {
     return typeof panel.id === 'string';
 }
@@ -86,17 +85,15 @@ class ApplePanelsProcessor extends BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput, pathExists, getFileSize, join } = this.options.fileAdapter;
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.plist';
         let buffer;
         try {
             if (typeof filePathOrBuffer === 'string') {
-                const fs = getFs();
-                const path = getPath();
                 if (filePathOrBuffer.endsWith('.ascconfig')) {
-                    const panelDefsPath = path.join(filePathOrBuffer, 'Contents', 'Resources', 'PanelDefinitions.plist');
-                    if (fs.existsSync(panelDefsPath)) {
-                        buffer = fs.readFileSync(panelDefsPath);
+                    const panelDefsPath = join(filePathOrBuffer, 'Contents', 'Resources', 'PanelDefinitions.plist');
+                    if (await pathExists(panelDefsPath)) {
+                        buffer = await readBinaryFromInput(panelDefsPath);
                     }
                     else {
                         const validation = buildValidationResultFromMessage({
@@ -111,13 +108,13 @@ class ApplePanelsProcessor extends BaseProcessor {
                     }
                 }
                 else {
-                    buffer = fs.readFileSync(filePathOrBuffer);
+                    buffer = await readBinaryFromInput(filePathOrBuffer);
                 }
             }
             else {
-                buffer = readBinaryFromInput(filePathOrBuffer);
+                buffer = await readBinaryFromInput(filePathOrBuffer);
             }
-            const content = readTextFromInput(buffer);
+            const content = await readTextFromInput(buffer);
             const parsedData = plist.parse(content);
             let panelsData = [];
             if (Array.isArray(parsedData.panels)) {
@@ -246,11 +243,12 @@ class ApplePanelsProcessor extends BaseProcessor {
             const validation = buildValidationResultFromMessage({
                 filename,
                 filesize: typeof filePathOrBuffer === 'string'
-                    ? (() => {
-                        const fs = getFs();
-                        return fs.existsSync(filePathOrBuffer) ? fs.statSync(filePathOrBuffer).size : 0;
+                    ? await (async () => {
+                        return (await pathExists(filePathOrBuffer))
+                            ? await getFileSize(filePathOrBuffer)
+                            : 0;
                     })()
-                    : readBinaryFromInput(filePathOrBuffer).byteLength,
+                    : (await readBinaryFromInput(filePathOrBuffer)).byteLength,
                 format: 'applepanels',
                 message: err?.message || 'Failed to parse Apple Panels file',
                 type: 'parse',
@@ -260,6 +258,7 @@ class ApplePanelsProcessor extends BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readBinaryFromInput, join } = this.options.fileAdapter;
         // Load the tree, apply translations, and save to new file
         const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
@@ -309,15 +308,14 @@ class ApplePanelsProcessor extends BaseProcessor {
         // Save the translated tree to the requested location and return its content
         await this.saveFromTree(tree, outputPath);
         if (outputPath.endsWith('.plist')) {
-            return readBinaryFromInput(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
-        const path = getPath();
         const configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
-        const panelDefsPath = path.join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
-        return readBinaryFromInput(panelDefsPath);
+        const panelDefsPath = join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
+        return await readBinaryFromInput(panelDefsPath);
     }
     async saveFromTree(tree, outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath, pathExists, mkDir, join, dirname } = this.options.fileAdapter;
         // Support two output modes:
         // 1) Single-file .plist (PanelDefinitions.plist content written directly)
         // 2) Apple Panels bundle folder (*.ascconfig) with Contents/Resources structure
@@ -327,17 +325,15 @@ class ApplePanelsProcessor extends BaseProcessor {
         let contentsPath = '';
         let resourcesPath = '';
         if (!isSinglePlist) {
-            const fs = getFs();
-            const path = getPath();
             configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
-            contentsPath = path.join(configPath, 'Contents');
-            resourcesPath = path.join(contentsPath, 'Resources');
-            if (!fs.existsSync(configPath))
-                fs.mkdirSync(configPath, { recursive: true });
-            if (!fs.existsSync(contentsPath))
-                fs.mkdirSync(contentsPath, { recursive: true });
-            if (!fs.existsSync(resourcesPath))
-                fs.mkdirSync(resourcesPath, { recursive: true });
+            contentsPath = join(configPath, 'Contents');
+            resourcesPath = join(contentsPath, 'Resources');
+            if (!(await pathExists(configPath)))
+                await mkDir(configPath, { recursive: true });
+            if (!(await pathExists(contentsPath)))
+                await mkDir(contentsPath, { recursive: true });
+            if (!(await pathExists(resourcesPath)))
+                await mkDir(resourcesPath, { recursive: true });
             // Create Info.plist (bundle mode only)
             const infoPlist = {
                 ASCConfigurationDisplayName: tree.metadata?.name || 'AAC Processors Export',
@@ -353,10 +349,10 @@ class ApplePanelsProcessor extends BaseProcessor {
                     `Generated by AAC Processors${tree.metadata?.author ? ` - Author: ${tree.metadata.author}` : ''}`,
             };
             const infoPlistContent = plist.build(infoPlist);
-            writeTextToPath(path.join(contentsPath, 'Info.plist'), infoPlistContent);
+            await writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
             // Create AssetIndex.plist (empty)
             const assetIndexContent = plist.build({});
-            writeTextToPath(path.join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
+            await writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
         }
         // Build PanelDefinitions content from tree
         const panelsDict = {};
@@ -482,17 +478,14 @@ class ApplePanelsProcessor extends BaseProcessor {
         const panelDefsContent = plist.build(panelDefinitions);
         if (isSinglePlist) {
             // Write single PanelDefinitions.plist file directly
-            const fs = getFs();
-            const path = getPath();
-            const dir = path.dirname(outputPath);
-            if (!fs.existsSync(dir))
-                fs.mkdirSync(dir, { recursive: true });
-            writeTextToPath(outputPath, panelDefsContent);
+            const dir = dirname(outputPath);
+            if (!(await pathExists(dir)))
+                await mkDir(dir, { recursive: true });
+            await writeTextToPath(outputPath, panelDefsContent);
         }
         else {
             // Write into bundle structure
-            const path = getPath();
-            writeTextToPath(path.join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
+            await writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
         }
     }
     createApplePanelsAction(button) {

package/dist/browser/processors/astericsGridProcessor.js

@@ -1,7 +1,7 @@
 import { BaseProcessor, } from '../core/baseProcessor';
 import { AACTree, AACPage, AACButton, AACSemanticCategory, AACSemanticIntent, } from '../core/treeStructure';
 import { ValidationFailureError, buildValidationResultFromMessage, } from '../validation/validationTypes';
-import { getBasename, getFs, readBinaryFromInput, readTextFromInput, writeTextToPath, encodeBase64, } from '../utils/io';
+import { getBasename, encodeBase64 } from '../utils/io';
 const DEFAULT_COLOR_SCHEME_DEFINITIONS = [
     {
         name: 'CS_MODIFIED_FITZGERALD_KEY_VERY_LIGHT',
@@ -562,7 +562,7 @@ class AstericsGridProcessor extends BaseProcessor {
             });
         }
         // Also extract texts from the raw file for comprehensive coverage
-        const rawTexts = this.extractRawTexts(filePathOrBuffer);
+        const rawTexts = await this.extractRawTexts(filePathOrBuffer);
         rawTexts.forEach((text) => {
             if (text && !texts.includes(text)) {
                 texts.push(text);
@@ -570,8 +570,9 @@ class AstericsGridProcessor extends BaseProcessor {
         });
         return texts;
     }
-    extractRawTexts(filePathOrBuffer) {
-        let content = readTextFromInput(filePathOrBuffer);
+    async extractRawTexts(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -651,12 +652,12 @@ class AstericsGridProcessor extends BaseProcessor {
         }
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         const tree = new AACTree();
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.grd';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         try {
-            let content = readTextFromInput(buffer);
+            let content = await readTextFromInput(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
@@ -1049,8 +1050,8 @@ class AstericsGridProcessor extends BaseProcessor {
         });
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
-        await Promise.resolve();
-        let content = readTextFromInput(filePathOrBuffer);
+        const { readTextFromInput, readBinaryFromInput, writeTextToPath } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1059,8 +1060,8 @@ class AstericsGridProcessor extends BaseProcessor {
         // Apply translations directly to the JSON structure for comprehensive coverage
         this.applyTranslationsToGridFile(grdFile, translations);
         // Write the translated file
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
-        return readBinaryFromInput(outputPath);
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        return await readBinaryFromInput(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1172,7 +1173,7 @@ class AstericsGridProcessor extends BaseProcessor {
         }
     }
     async saveFromTree(tree, outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath } = this.options.fileAdapter;
         // Use default Asterics Grid styling instead of taking from first page
         // This prevents issues where the first page has unusual colors (like purple)
         const defaultPageStyle = {
@@ -1375,13 +1376,14 @@ class AstericsGridProcessor extends BaseProcessor {
                 },
             },
         };
-        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Add audio recording to a specific grid element
      */
-    addAudioToElement(filePath, elementId, audioData, metadata) {
-        let content = readTextFromInput(filePath);
+    async addAudioToElement(filePath, elementId, audioData, metadata) {
+        const { readTextFromInput, writeTextToPath } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1424,31 +1426,33 @@ class AstericsGridProcessor extends BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
+        await writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Create a copy of the grid file with audio recordings added
      */
-    createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
+    async createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
+        const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         // Copy the source file to target
-        const fs = getFs();
-        fs.copyFileSync(sourceFilePath, targetFilePath);
+        await writeBinaryToPath(targetFilePath, await readBinaryFromInput(sourceFilePath));
         // Add audio recordings to the copy
-        audioMappings.forEach((audioInfo, elementId) => {
+        await Promise.all(Object.entries(audioMappings).map(async (item) => {
+            const [elementId, audioInfo] = item;
             try {
-                this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
+                await this.addAudioToElement(targetFilePath, elementId, audioInfo.audioData, audioInfo.metadata);
             }
             catch (error) {
                 // Failed to add audio to element - continue with others
                 console.warn(`Failed to add audio to element ${elementId}:`, error);
             }
-        });
+        }));
     }
     /**
      * Extract all element IDs from the grid file for audio mapping
      */
-    getElementIds(filePathOrBuffer) {
-        let content = readTextFromInput(filePathOrBuffer);
+    async getElementIds(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1470,8 +1474,9 @@ class AstericsGridProcessor extends BaseProcessor {
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer, elementId) {
-        let content = readTextFromInput(filePathOrBuffer);
+    async hasAudioRecording(filePathOrBuffer, elementId) {
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = await readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/browser/processors/dotProcessor.js

@@ -1,8 +1,7 @@
 import { BaseProcessor, } from '../core/baseProcessor';
 import { AACTree, AACPage, AACButton, AACSemanticIntent } from '../core/treeStructure';
-// Removed unused import: FileProcessor
 import { ValidationFailureError, buildValidationResultFromMessage, } from '../validation/validationTypes';
-import { getBasename, readBinaryFromInput, readTextFromInput, writeBinaryToPath, writeTextToPath, encodeText, } from '../utils/io';
+import { getBasename, encodeText } from '../utils/io';
 class DotProcessor extends BaseProcessor {
     constructor(options) {
         super(options);
@@ -49,8 +48,8 @@ class DotProcessor extends BaseProcessor {
         return { nodes: Array.from(nodes.values()), edges };
     }
     async extractTexts(filePathOrBuffer) {
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -66,12 +65,12 @@ class DotProcessor extends BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
-        await Promise.resolve();
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         const filename = typeof filePathOrBuffer === 'string' ? getBasename(filePathOrBuffer) : 'upload.dot';
-        const buffer = readBinaryFromInput(filePathOrBuffer);
+        const buffer = await readBinaryFromInput(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = readTextFromInput(buffer);
+            const content = await readTextFromInput(buffer);
             if (!content || content.trim().length === 0) {
                 const validation = buildValidationResultFromMessage({
                     filename,
@@ -155,8 +154,8 @@ class DotProcessor extends BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
-        await Promise.resolve();
-        const content = readTextFromInput(filePathOrBuffer);
+        const { readTextFromInput, writeBinaryToPath } = this.options.fileAdapter;
+        const content = await readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -167,11 +166,11 @@ class DotProcessor extends BaseProcessor {
             }
         });
         const resultBuffer = encodeText(translatedContent || '');
-        writeBinaryToPath(outputPath, resultBuffer);
+        await writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, _outputPath) {
-        await Promise.resolve();
+        const { writeTextToPath } = this.options.fileAdapter;
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
         const escapeDotString = (str) => {
@@ -201,7 +200,7 @@ class DotProcessor extends BaseProcessor {
             });
         }
         dotContent += '}\n';
-        writeTextToPath(_outputPath, dotContent);
+        await writeTextToPath(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility