@willwade/aac-processors 0.0.29 → 0.1.0

package/dist/processors/applePanelsProcessor.d.ts

@@ -1,13 +1,14 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ProcessorInput } from '../utils/io';
 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;
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
+    saveFromTree(tree: AACTree, outputPath: string): Promise<void>;
     private createApplePanelsAction;
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/applePanelsProcessor.js

@@ -8,9 +8,8 @@ const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
 // Removed unused import: FileProcessor
 const plist_1 = __importDefault(require("plist"));
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const validation_1 = require("../validation");
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
 function isNormalizedPanel(panel) {
     return typeof panel.id === 'string';
 }
@@ -76,8 +75,8 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
             gridY: Math.floor(pixelY / cellSize),
         };
     }
-    extractTexts(filePathOrBuffer) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async extractTexts(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         const texts = [];
         for (const pageId in tree.pages) {
             const page = tree.pages[pageId];
@@ -92,21 +91,21 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         }
         return texts;
     }
-    loadIntoTree(filePathOrBuffer) {
-        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.plist';
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.plist';
         let buffer;
         try {
-            if (Buffer.isBuffer(filePathOrBuffer)) {
-                buffer = filePathOrBuffer;
-            }
-            else if (typeof filePathOrBuffer === 'string') {
+            if (typeof filePathOrBuffer === 'string') {
+                const fs = (0, io_1.getFs)();
+                const path = (0, io_1.getPath)();
                 if (filePathOrBuffer.endsWith('.ascconfig')) {
-                    const panelDefsPath = `${filePathOrBuffer}/Contents/Resources/PanelDefinitions.plist`;
-                    if (fs_1.default.existsSync(panelDefsPath)) {
-                        buffer = fs_1.default.readFileSync(panelDefsPath);
+                    const panelDefsPath = path.join(filePathOrBuffer, 'Contents', 'Resources', 'PanelDefinitions.plist');
+                    if (fs.existsSync(panelDefsPath)) {
+                        buffer = fs.readFileSync(panelDefsPath);
                     }
                     else {
-                        const validation = (0, validation_1.buildValidationResultFromMessage)({
+                        const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                             filename,
                             filesize: 0,
                             format: 'applepanels',
@@ -114,25 +113,17 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                             type: 'missing',
                             description: 'PanelDefinitions.plist',
                         });
-                        throw new validation_1.ValidationFailureError('Apple Panels file not found', validation);
+                        throw new validationTypes_1.ValidationFailureError('Apple Panels file not found', validation);
                     }
                 }
                 else {
-                    buffer = fs_1.default.readFileSync(filePathOrBuffer);
+                    buffer = fs.readFileSync(filePathOrBuffer);
                 }
             }
             else {
-                const validation = (0, validation_1.buildValidationResultFromMessage)({
-                    filename,
-                    filesize: 0,
-                    format: 'applepanels',
-                    message: 'Invalid input: expected string path or Buffer',
-                    type: 'input',
-                    description: 'Apple Panels input',
-                });
-                throw new validation_1.ValidationFailureError('Invalid Apple Panels input', validation);
+                buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
             }
-            const content = buffer.toString('utf8');
+            const content = (0, io_1.readTextFromInput)(buffer);
             const parsedData = plist_1.default.parse(content);
             let panelsData = [];
             if (Array.isArray(parsedData.panels)) {
@@ -154,7 +145,7 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                 });
             }
             if (panelsData.length === 0) {
-                const validation = (0, validation_1.buildValidationResultFromMessage)({
+                const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize: buffer.byteLength,
                     format: 'applepanels',
@@ -162,7 +153,7 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'structure',
                     description: 'Panels definition',
                 });
-                throw new validation_1.ValidationFailureError('Apple Panels has no panels', validation);
+                throw new validationTypes_1.ValidationFailureError('Apple Panels has no panels', validation);
             }
             const data = { panels: panelsData };
             const tree = new treeStructure_1.AACTree();
@@ -255,29 +246,28 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         catch (err) {
-            if (err instanceof validation_1.ValidationFailureError) {
+            if (err instanceof validationTypes_1.ValidationFailureError) {
                 throw err;
             }
-            const validation = (0, validation_1.buildValidationResultFromMessage)({
+            const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
-                filesize: Buffer.isBuffer(filePathOrBuffer)
-                    ? filePathOrBuffer.byteLength
-                    : typeof filePathOrBuffer === 'string'
-                        ? fs_1.default.existsSync(filePathOrBuffer)
-                            ? fs_1.default.statSync(filePathOrBuffer).size
-                            : 0
-                        : 0,
+                filesize: typeof filePathOrBuffer === 'string'
+                    ? (() => {
+                        const fs = (0, io_1.getFs)();
+                        return fs.existsSync(filePathOrBuffer) ? fs.statSync(filePathOrBuffer).size : 0;
+                    })()
+                    : (0, io_1.readBinaryFromInput)(filePathOrBuffer).byteLength,
                 format: 'applepanels',
                 message: err?.message || 'Failed to parse Apple Panels file',
                 type: 'parse',
                 description: 'Parse Apple Panels plist',
             });
-            throw new validation_1.ValidationFailureError('Failed to load Apple Panels file', validation, err);
+            throw new validationTypes_1.ValidationFailureError('Failed to load Apple Panels file', validation, err);
         }
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
+    async processTexts(filePathOrBuffer, translations, outputPath) {
         // Load the tree, apply translations, and save to new file
-        const tree = this.loadIntoTree(filePathOrBuffer);
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         // Apply translations to all text content
         Object.values(tree.pages).forEach((page) => {
             // Translate page names
@@ -323,16 +313,17 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
             });
         });
         // Save the translated tree to the requested location and return its content
-        this.saveFromTree(tree, outputPath);
+        await this.saveFromTree(tree, outputPath);
         if (outputPath.endsWith('.plist')) {
-            return fs_1.default.readFileSync(outputPath);
+            return (0, io_1.readBinaryFromInput)(outputPath);
         }
-        // In bundle mode, return the PanelDefinitions.plist content
+        const path = (0, io_1.getPath)();
         const configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
-        const panelDefsPath = path_1.default.join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
-        return fs_1.default.readFileSync(panelDefsPath);
+        const panelDefsPath = path.join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
+        return (0, io_1.readBinaryFromInput)(panelDefsPath);
     }
-    saveFromTree(tree, outputPath) {
+    async saveFromTree(tree, outputPath) {
+        await Promise.resolve();
         // Support two output modes:
         // 1) Single-file .plist (PanelDefinitions.plist content written directly)
         // 2) Apple Panels bundle folder (*.ascconfig) with Contents/Resources structure
@@ -342,15 +333,17 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         let contentsPath = '';
         let resourcesPath = '';
         if (!isSinglePlist) {
+            const fs = (0, io_1.getFs)();
+            const path = (0, io_1.getPath)();
             configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
-            contentsPath = path_1.default.join(configPath, 'Contents');
-            resourcesPath = path_1.default.join(contentsPath, 'Resources');
-            if (!fs_1.default.existsSync(configPath))
-                fs_1.default.mkdirSync(configPath, { recursive: true });
-            if (!fs_1.default.existsSync(contentsPath))
-                fs_1.default.mkdirSync(contentsPath, { recursive: true });
-            if (!fs_1.default.existsSync(resourcesPath))
-                fs_1.default.mkdirSync(resourcesPath, { recursive: true });
+            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 });
             // Create Info.plist (bundle mode only)
             const infoPlist = {
                 ASCConfigurationDisplayName: tree.metadata?.name || 'AAC Processors Export',
@@ -366,10 +359,10 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                     `Generated by AAC Processors${tree.metadata?.author ? ` - Author: ${tree.metadata.author}` : ''}`,
             };
             const infoPlistContent = plist_1.default.build(infoPlist);
-            fs_1.default.writeFileSync(path_1.default.join(contentsPath, 'Info.plist'), infoPlistContent);
+            (0, io_1.writeTextToPath)(path.join(contentsPath, 'Info.plist'), infoPlistContent);
             // Create AssetIndex.plist (empty)
             const assetIndexContent = plist_1.default.build({});
-            fs_1.default.writeFileSync(path_1.default.join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
+            (0, io_1.writeTextToPath)(path.join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
         }
         // Build PanelDefinitions content from tree
         const panelsDict = {};
@@ -495,14 +488,17 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         const panelDefsContent = plist_1.default.build(panelDefinitions);
         if (isSinglePlist) {
             // Write single PanelDefinitions.plist file directly
-            const dir = path_1.default.dirname(outputPath);
-            if (!fs_1.default.existsSync(dir))
-                fs_1.default.mkdirSync(dir, { recursive: true });
-            fs_1.default.writeFileSync(outputPath, panelDefsContent);
+            const fs = (0, io_1.getFs)();
+            const path = (0, io_1.getPath)();
+            const dir = path.dirname(outputPath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            (0, io_1.writeTextToPath)(outputPath, panelDefsContent);
         }
         else {
             // Write into bundle structure
-            fs_1.default.writeFileSync(path_1.default.join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
+            const path = (0, io_1.getPath)();
+            (0, io_1.writeTextToPath)(path.join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
         }
     }
     createApplePanelsAction(button) {

package/dist/processors/astericsGridProcessor.d.ts

@@ -1,5 +1,6 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ProcessorInput } from '../utils/io';
 export declare function normalizeHexColor(hexColor: string): string | null;
 export declare function adjustHexColor(hexColor: string, amount: number): string;
 export declare function getHighContrastNeutralColor(backgroundColor: string): string;
@@ -20,17 +21,17 @@ declare class AstericsGridProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions & {
         loadAudio?: boolean;
     });
-    extractTexts(filePathOrBuffer: string | Buffer): string[];
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
     private extractRawTexts;
     private extractActionTexts;
-    loadIntoTree(filePathOrBuffer: string | Buffer): AACTree;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
     private getLocalizedLabel;
     private getLocalizedText;
     private createButtonFromElement;
-    processTexts(filePathOrBuffer: string | Buffer, translations: Map<string, string>, outputPath: string): Buffer;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
     private applyTranslationsToGridFile;
     private applyTranslationsToAction;
-    saveFromTree(tree: AACTree, outputPath: string): void;
+    saveFromTree(tree: AACTree, outputPath: string): Promise<void>;
     /**
      * Add audio recording to a specific grid element
      */
@@ -45,11 +46,11 @@ declare class AstericsGridProcessor extends BaseProcessor {
     /**
      * Extract all element IDs from the grid file for audio mapping
      */
-    getElementIds(filePathOrBuffer: string | Buffer): string[];
+    getElementIds(filePathOrBuffer: ProcessorInput): string[];
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer: string | Buffer, elementId: string): boolean;
+    hasAudioRecording(filePathOrBuffer: ProcessorInput, elementId: string): boolean;
     /**
      * Extract strings with metadata for aac-tools-platform compatibility
      * Uses the generic implementation from BaseProcessor

package/dist/processors/astericsGridProcessor.js

@@ -1,7 +1,4 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstericsGridProcessor = void 0;
 exports.normalizeHexColor = normalizeHexColor;
@@ -11,9 +8,8 @@ exports.calculateLuminance = calculateLuminance;
 exports.getContrastingTextColor = getContrastingTextColor;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const validation_1 = require("../validation");
+const validationTypes_1 = require("../validation/validationTypes");
+const io_1 = require("../utils/io");
 const DEFAULT_COLOR_SCHEME_DEFINITIONS = [
     {
         name: 'CS_MODIFIED_FITZGERALD_KEY_VERY_LIGHT',
@@ -559,8 +555,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         this.loadAudio = false;
         this.loadAudio = options.loadAudio || false;
     }
-    extractTexts(filePathOrBuffer) {
-        const tree = this.loadIntoTree(filePathOrBuffer);
+    async extractTexts(filePathOrBuffer) {
+        const tree = await this.loadIntoTree(filePathOrBuffer);
         const texts = [];
         for (const pageId in tree.pages) {
             const page = tree.pages[pageId];
@@ -583,9 +579,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     extractRawTexts(filePathOrBuffer) {
-        let content = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer.toString('utf-8')
-            : fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
+        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -664,21 +658,20 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             // Add more action types as needed
         }
     }
-    loadIntoTree(filePathOrBuffer) {
+    async loadIntoTree(filePathOrBuffer) {
+        await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
-        const filename = typeof filePathOrBuffer === 'string' ? path_1.default.basename(filePathOrBuffer) : 'upload.grd';
-        const buffer = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer
-            : fs_1.default.readFileSync(filePathOrBuffer);
+        const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.grd';
+        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
         try {
-            let content = buffer.toString('utf-8');
+            let content = (0, io_1.readTextFromInput)(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
             }
             const grdFile = JSON.parse(content);
             if (!grdFile.grids) {
-                const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+                const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
                     filesize: buffer.byteLength,
                     format: 'asterics',
@@ -686,7 +679,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                     type: 'structure',
                     description: 'Asterics grid collection',
                 });
-                throw new validation_1.ValidationFailureError('Invalid Asterics grid file', validationResult);
+                throw new validationTypes_1.ValidationFailureError('Invalid Asterics grid file', validationResult);
             }
             const rawColorConfig = grdFile.metadata?.colorConfig;
             const colorConfig = isRecord(rawColorConfig)
@@ -783,10 +776,10 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             return tree;
         }
         catch (err) {
-            if (err instanceof validation_1.ValidationFailureError) {
+            if (err instanceof validationTypes_1.ValidationFailureError) {
                 throw err;
             }
-            const validationResult = (0, validation_1.buildValidationResultFromMessage)({
+            const validationResult = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
                 filesize: buffer.byteLength,
                 format: 'asterics',
@@ -794,7 +787,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 type: 'parse',
                 description: 'Parse Asterics grid JSON',
             });
-            throw new validation_1.ValidationFailureError('Failed to load Asterics grid', validationResult, err);
+            throw new validationTypes_1.ValidationFailureError('Failed to load Asterics grid', validationResult, err);
         }
     }
     getLocalizedLabel(labelMap) {
@@ -1063,11 +1056,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             },
         });
     }
-    processTexts(filePathOrBuffer, translations, outputPath) {
-        // Load and parse the original file
-        let content = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer.toString('utf-8')
-            : fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
+    async processTexts(filePathOrBuffer, translations, outputPath) {
+        await Promise.resolve();
+        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1076,8 +1067,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         // Apply translations directly to the JSON structure for comprehensive coverage
         this.applyTranslationsToGridFile(grdFile, translations);
         // Write the translated file
-        fs_1.default.writeFileSync(outputPath, JSON.stringify(grdFile, null, 2));
-        return fs_1.default.readFileSync(outputPath);
+        (0, io_1.writeTextToPath)(outputPath, JSON.stringify(grdFile, null, 2));
+        return (0, io_1.readBinaryFromInput)(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1188,7 +1179,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             // Add more action types as needed
         }
     }
-    saveFromTree(tree, outputPath) {
+    async saveFromTree(tree, outputPath) {
+        await Promise.resolve();
         // 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 = {
@@ -1321,7 +1313,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                         id: button.audioRecording.id?.toString() || `grid-action-audio-${button.id}`,
                         modelName: 'GridActionAudio',
                         modelVersion: '{"major": 5, "minor": 0, "patch": 0}',
-                        dataBase64: button.audioRecording.data.toString('base64'),
+                        dataBase64: (0, io_1.encodeBase64)(button.audioRecording.data),
                         mimeType: metadata.mimeType || 'audio/wav',
                         durationMs: metadata.durationMs || 0,
                         filename: button.audioRecording.identifier || `audio-${button.id}`,
@@ -1391,13 +1383,13 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 },
             },
         };
-        fs_1.default.writeFileSync(outputPath, JSON.stringify(grdFile, null, 2));
+        (0, io_1.writeTextToPath)(outputPath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Add audio recording to a specific grid element
      */
     addAudioToElement(filePath, elementId, audioData, metadata) {
-        let content = fs_1.default.readFileSync(filePath, 'utf-8');
+        let content = (0, io_1.readTextFromInput)(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1416,7 +1408,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                         id: `grid-action-audio-${elementId}`,
                         modelName: 'GridActionAudio',
                         modelVersion: '{"major": 5, "minor": 0, "patch": 0}',
-                        dataBase64: audioData.toString('base64'),
+                        dataBase64: (0, io_1.encodeBase64)(audioData),
                         mimeType: 'audio/wav',
                         durationMs: 0, // Could be calculated from audio data
                         filename: `audio-${elementId}.wav`,
@@ -1440,14 +1432,15 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        fs_1.default.writeFileSync(filePath, JSON.stringify(grdFile, null, 2));
+        (0, io_1.writeTextToPath)(filePath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Create a copy of the grid file with audio recordings added
      */
     createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
         // Copy the source file to target
-        fs_1.default.copyFileSync(sourceFilePath, targetFilePath);
+        const fs = (0, io_1.getFs)();
+        fs.copyFileSync(sourceFilePath, targetFilePath);
         // Add audio recordings to the copy
         audioMappings.forEach((audioInfo, elementId) => {
             try {
@@ -1463,9 +1456,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
      * Extract all element IDs from the grid file for audio mapping
      */
     getElementIds(filePathOrBuffer) {
-        let content = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer.toString('utf-8')
-            : fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
+        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1488,9 +1479,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
      * Check if an element has audio recording
      */
     hasAudioRecording(filePathOrBuffer, elementId) {
-        let content = Buffer.isBuffer(filePathOrBuffer)
-            ? filePathOrBuffer.toString('utf-8')
-            : fs_1.default.readFileSync(filePathOrBuffer, 'utf-8');
+        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/processors/dotProcessor.d.ts

@@ -1,12 +1,13 @@
 import { BaseProcessor, ProcessorOptions, ExtractStringsResult, TranslatedString, SourceString } from '../core/baseProcessor';
 import { AACTree } from '../core/treeStructure';
+import { ProcessorInput } from '../utils/io';
 declare class DotProcessor extends BaseProcessor {
     constructor(options?: ProcessorOptions);
     private parseDotFile;
-    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;
+    extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
+    loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;
+    processTexts(filePathOrBuffer: ProcessorInput, translations: Map<string, string>, outputPath: string): Promise<Uint8Array>;
+    saveFromTree(tree: AACTree, _outputPath: string): Promise<void>;
     /**
      * Extract strings with metadata for aac-tools-platform compatibility
      * Uses the generic implementation from BaseProcessor