@willwade/aac-processors 0.1.19 → 0.1.21

package/dist/cli/index.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const prettyPrint_1 = require("./prettyPrint");
@@ -10,14 +7,12 @@ const analyze_1 = require("../core/analyze");
 const history_1 = require("../utilities/analytics/history");
 const analytics_1 = require("../utilities/analytics");
 const aac_1 = require("../types/aac");
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
+const io_1 = require("../utils/io");
+const { pathExists, isDirectory, join, readTextFromInput, basename, writeTextToPath } = io_1.defaultFileAdapter;
 // Helper function to detect format from file/folder path
 function detectFormat(filePath) {
     // Check if it's a folder ending with .ascconfig
-    if (fs_1.default.existsSync(filePath) &&
-        fs_1.default.statSync(filePath).isDirectory() &&
-        filePath.endsWith('.ascconfig')) {
+    if (pathExists(filePath) && isDirectory(filePath) && filePath.endsWith('.ascconfig')) {
         return 'ascconfig';
     }
     // Map multi-file formats to their base processor
@@ -28,7 +23,7 @@ function detectFormat(filePath) {
         return 'gridset';
     }
     // Otherwise use file extension
-    return path_1.default.extname(filePath).slice(1);
+    return (0, io_1.extname)(filePath).slice(1);
 }
 // Helper function to parse filtering options from CLI arguments
 function parseFilteringOptions(options) {
@@ -66,7 +61,7 @@ function parseFilteringOptions(options) {
     return processorOptions;
 }
 // Set version from package.json
-const packageJson = JSON.parse(fs_1.default.readFileSync(path_1.default.join(__dirname, '../../package.json'), 'utf8'));
+const packageJson = JSON.parse(readTextFromInput(join(__dirname, '../../package.json')));
 commander_1.program.version(packageJson.version);
 commander_1.program
     .command('analyze <file>')
@@ -290,12 +285,12 @@ commander_1.program
     .option('--version <version>', 'Baton export version', '1.0')
     .action((input, options) => {
     try {
-        if (!fs_1.default.existsSync(input)) {
+        if (!pathExists(input)) {
             throw new Error(`File not found: ${input}`);
         }
         const normalizedSource = (options.source || 'auto').toLowerCase();
-        const ext = path_1.default.extname(input).toLowerCase();
-        const isGrid3Db = ext === '.sqlite' || path_1.default.basename(input).toLowerCase() === 'history.sqlite';
+        const ext = (0, io_1.extname)(input).toLowerCase();
+        const isGrid3Db = ext === '.sqlite' || basename(input).toLowerCase() === 'history.sqlite';
         const isSnap = ext === '.sps' || ext === '.spb';
         let entries;
         if (normalizedSource === 'grid3' || (normalizedSource === 'auto' && isGrid3Db)) {
@@ -322,7 +317,7 @@ commander_1.program
         }
         const output = JSON.stringify(payload, null, 2);
         if (options.out) {
-            fs_1.default.writeFileSync(options.out, output);
+            writeTextToPath(options.out, output);
         }
         else {
             console.log(output);
@@ -426,7 +421,7 @@ commander_1.program
         };
         const output = options.pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result);
         if (options.out) {
-            fs_1.default.writeFileSync(options.out, output);
+            writeTextToPath(options.out, output);
         }
         else {
             console.log(output);

package/dist/core/baseProcessor.d.ts

@@ -42,9 +42,9 @@
 import { AACTree, AACButton } from './treeStructure';
 import { StringCasing } from './stringCasing';
 import { ValidationResult } from '../validation/validationTypes';
-import { BinaryOutput, ProcessorInput } from '../utils/io';
-import type { ZipAdapter } from '../utils/zip';
-export interface ProcessorOptions {
+import { BinaryOutput, FileAdapter, ProcessorInput } from '../utils/io';
+import { ZipAdapter } from '../utils/zip';
+export interface ProcessorConfig {
     excludeNavigationButtons?: boolean;
     excludeSystemButtons?: boolean;
     gridsetPassword?: string;
@@ -53,10 +53,10 @@ export interface ProcessorOptions {
     grid3SymbolDir?: string;
     grid3Path?: string;
     grid3Locale?: string;
-    zipAdapter?: (input: ProcessorInput) => Promise<{
-        zip: ZipAdapter;
-    }>;
+    fileAdapter: FileAdapter;
+    zipAdapter: (input?: ProcessorInput) => Promise<ZipAdapter>;
 }
+export type ProcessorOptions = Partial<ProcessorConfig>;
 export interface ExtractedString {
     string: string;
     vocabPlacementMeta: VocabPlacementMetadata;
@@ -89,7 +89,7 @@ export interface SourceString {
     vocabplacementmetadata: VocabPlacementMetadata;
 }
 declare abstract class BaseProcessor {
-    protected options: ProcessorOptions;
+    protected options: ProcessorConfig;
     constructor(options?: ProcessorOptions);
     abstract extractTexts(filePathOrBuffer: ProcessorInput): Promise<string[]>;
     abstract loadIntoTree(filePathOrBuffer: ProcessorInput): Promise<AACTree>;

package/dist/core/baseProcessor.js

@@ -44,6 +44,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseProcessor = void 0;
 const treeStructure_1 = require("./treeStructure");
 const stringCasing_1 = require("./stringCasing");
+const io_1 = require("../utils/io");
+const zip_1 = require("../utils/zip");
 class BaseProcessor {
     constructor(options = {}) {
         // Default configuration: exclude navigation/system buttons
@@ -51,6 +53,8 @@ class BaseProcessor {
             excludeNavigationButtons: true,
             excludeSystemButtons: true,
             preserveAllButtons: false,
+            fileAdapter: io_1.defaultFileAdapter,
+            zipAdapter: zip_1.getZipAdapter,
             ...options,
         };
     }

package/dist/processors/applePanelsProcessor.js

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApplePanelsProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-// Removed unused import: FileProcessor
 const plist_1 = __importDefault(require("plist"));
 const validationTypes_1 = require("../validation/validationTypes");
 const io_1 = require("../utils/io");
@@ -92,17 +91,16 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput, pathExists, getFileSize, join } = this.options.fileAdapter;
         await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.plist';
         let buffer;
         try {
             if (typeof filePathOrBuffer === 'string') {
-                const fs = (0, io_1.getFs)();
-                const path = (0, io_1.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 (pathExists(panelDefsPath)) {
+                        buffer = readBinaryFromInput(panelDefsPath);
                     }
                     else {
                         const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
@@ -117,13 +115,13 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 }
                 else {
-                    buffer = fs.readFileSync(filePathOrBuffer);
+                    buffer = readBinaryFromInput(filePathOrBuffer);
                 }
             }
             else {
-                buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+                buffer = readBinaryFromInput(filePathOrBuffer);
             }
-            const content = (0, io_1.readTextFromInput)(buffer);
+            const content = readTextFromInput(buffer);
             const parsedData = plist_1.default.parse(content);
             let panelsData = [];
             if (Array.isArray(parsedData.panels)) {
@@ -253,10 +251,9 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                 filename,
                 filesize: typeof filePathOrBuffer === 'string'
                     ? (() => {
-                        const fs = (0, io_1.getFs)();
-                        return fs.existsSync(filePathOrBuffer) ? fs.statSync(filePathOrBuffer).size : 0;
+                        return pathExists(filePathOrBuffer) ? getFileSize(filePathOrBuffer) : 0;
                     })()
-                    : (0, io_1.readBinaryFromInput)(filePathOrBuffer).byteLength,
+                    : readBinaryFromInput(filePathOrBuffer).byteLength,
                 format: 'applepanels',
                 message: err?.message || 'Failed to parse Apple Panels file',
                 type: 'parse',
@@ -266,6 +263,7 @@ class ApplePanelsProcessor extends baseProcessor_1.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
@@ -315,14 +313,14 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         // Save the translated tree to the requested location and return its content
         await this.saveFromTree(tree, outputPath);
         if (outputPath.endsWith('.plist')) {
-            return (0, io_1.readBinaryFromInput)(outputPath);
+            return readBinaryFromInput(outputPath);
         }
-        const path = (0, io_1.getPath)();
         const configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
-        const panelDefsPath = path.join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
-        return (0, io_1.readBinaryFromInput)(panelDefsPath);
+        const panelDefsPath = join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
+        return readBinaryFromInput(panelDefsPath);
     }
     async saveFromTree(tree, outputPath) {
+        const { writeTextToPath, pathExists, mkDir, join, dirname } = this.options.fileAdapter;
         await Promise.resolve();
         // Support two output modes:
         // 1) Single-file .plist (PanelDefinitions.plist content written directly)
@@ -333,17 +331,15 @@ 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.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 (!pathExists(configPath))
+                mkDir(configPath, { recursive: true });
+            if (!pathExists(contentsPath))
+                mkDir(contentsPath, { recursive: true });
+            if (!pathExists(resourcesPath))
+                mkDir(resourcesPath, { recursive: true });
             // Create Info.plist (bundle mode only)
             const infoPlist = {
                 ASCConfigurationDisplayName: tree.metadata?.name || 'AAC Processors Export',
@@ -359,10 +355,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);
-            (0, io_1.writeTextToPath)(path.join(contentsPath, 'Info.plist'), infoPlistContent);
+            writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
             // Create AssetIndex.plist (empty)
             const assetIndexContent = plist_1.default.build({});
-            (0, io_1.writeTextToPath)(path.join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
+            writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
         }
         // Build PanelDefinitions content from tree
         const panelsDict = {};
@@ -488,17 +484,14 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         const panelDefsContent = plist_1.default.build(panelDefinitions);
         if (isSinglePlist) {
             // Write single PanelDefinitions.plist file directly
-            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);
+            const dir = dirname(outputPath);
+            if (!pathExists(dir))
+                mkDir(dir, { recursive: true });
+            writeTextToPath(outputPath, panelDefsContent);
         }
         else {
             // Write into bundle structure
-            const path = (0, io_1.getPath)();
-            (0, io_1.writeTextToPath)(path.join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
+            writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
         }
     }
     createApplePanelsAction(button) {

package/dist/processors/astericsGridProcessor.js

@@ -579,7 +579,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     extractRawTexts(filePathOrBuffer) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -659,12 +660,13 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
         const tree = new treeStructure_1.AACTree();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.grd';
-        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const buffer = readBinaryFromInput(filePathOrBuffer);
         try {
-            let content = (0, io_1.readTextFromInput)(buffer);
+            let content = readTextFromInput(buffer);
             // Remove BOM if present
             if (content.charCodeAt(0) === 0xfeff) {
                 content = content.slice(1);
@@ -1057,8 +1059,9 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         });
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readTextFromInput, readBinaryFromInput, writeTextToPath } = this.options.fileAdapter;
         await Promise.resolve();
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        let content = readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1067,8 +1070,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
-        (0, io_1.writeTextToPath)(outputPath, JSON.stringify(grdFile, null, 2));
-        return (0, io_1.readBinaryFromInput)(outputPath);
+        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
+        return readBinaryFromInput(outputPath);
     }
     applyTranslationsToGridFile(grdFile, translations) {
         grdFile.grids.forEach((grid) => {
@@ -1180,6 +1183,7 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async saveFromTree(tree, outputPath) {
+        const { writeTextToPath } = this.options.fileAdapter;
         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)
@@ -1383,13 +1387,14 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
                 },
             },
         };
-        (0, io_1.writeTextToPath)(outputPath, JSON.stringify(grdFile, null, 2));
+        writeTextToPath(outputPath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Add audio recording to a specific grid element
      */
     addAudioToElement(filePath, elementId, audioData, metadata) {
-        let content = (0, io_1.readTextFromInput)(filePath);
+        const { readTextFromInput, writeTextToPath } = this.options.fileAdapter;
+        let content = readTextFromInput(filePath);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1432,15 +1437,15 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
             throw new Error(`Element with ID ${elementId} not found`);
         }
         // Write back to file
-        (0, io_1.writeTextToPath)(filePath, JSON.stringify(grdFile, null, 2));
+        writeTextToPath(filePath, JSON.stringify(grdFile, null, 2));
     }
     /**
      * Create a copy of the grid file with audio recordings added
      */
     createAudioEnhancedGridFile(sourceFilePath, targetFilePath, audioMappings) {
+        const { writeBinaryToPath, readBinaryFromInput } = this.options.fileAdapter;
         // Copy the source file to target
-        const fs = (0, io_1.getFs)();
-        fs.copyFileSync(sourceFilePath, targetFilePath);
+        writeBinaryToPath(targetFilePath, readBinaryFromInput(sourceFilePath));
         // Add audio recordings to the copy
         audioMappings.forEach((audioInfo, elementId) => {
             try {
@@ -1456,7 +1461,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
      * Extract all element IDs from the grid file for audio mapping
      */
     getElementIds(filePathOrBuffer) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);
@@ -1479,7 +1485,8 @@ class AstericsGridProcessor extends baseProcessor_1.BaseProcessor {
      * Check if an element has audio recording
      */
     hasAudioRecording(filePathOrBuffer, elementId) {
-        let content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const { readTextFromInput } = this.options.fileAdapter;
+        let content = readTextFromInput(filePathOrBuffer);
         // Remove BOM if present
         if (content.charCodeAt(0) === 0xfeff) {
             content = content.slice(1);

package/dist/processors/dotProcessor.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DotProcessor = void 0;
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
-// Removed unused import: FileProcessor
 const validationTypes_1 = require("../validation/validationTypes");
 const io_1 = require("../utils/io");
 class DotProcessor extends baseProcessor_1.BaseProcessor {
@@ -52,8 +51,9 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         return { nodes: Array.from(nodes.values()), edges };
     }
     async extractTexts(filePathOrBuffer) {
+        const { readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = readTextFromInput(filePathOrBuffer);
         const { nodes, edges } = this.parseDotFile(content);
         const texts = [];
         // Collect node labels
@@ -69,12 +69,13 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         return texts;
     }
     async loadIntoTree(filePathOrBuffer) {
+        const { readBinaryFromInput, readTextFromInput } = this.options.fileAdapter;
         await Promise.resolve();
         const filename = typeof filePathOrBuffer === 'string' ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload.dot';
-        const buffer = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const buffer = readBinaryFromInput(filePathOrBuffer);
         const filesize = buffer.byteLength;
         try {
-            const content = (0, io_1.readTextFromInput)(buffer);
+            const content = readTextFromInput(buffer);
             if (!content || content.trim().length === 0) {
                 const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                     filename,
@@ -158,8 +159,9 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
         }
     }
     async processTexts(filePathOrBuffer, translations, outputPath) {
+        const { readTextFromInput, writeBinaryToPath } = this.options.fileAdapter;
         await Promise.resolve();
-        const content = (0, io_1.readTextFromInput)(filePathOrBuffer);
+        const content = readTextFromInput(filePathOrBuffer);
         let translatedContent = content;
         translations.forEach((translation, text) => {
             if (typeof text === 'string' && typeof translation === 'string') {
@@ -170,10 +172,11 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             }
         });
         const resultBuffer = (0, io_1.encodeText)(translatedContent || '');
-        (0, io_1.writeBinaryToPath)(outputPath, resultBuffer);
+        writeBinaryToPath(outputPath, resultBuffer);
         return resultBuffer;
     }
     async saveFromTree(tree, _outputPath) {
+        const { writeTextToPath } = this.options.fileAdapter;
         await Promise.resolve();
         let dotContent = `digraph "${tree.metadata?.name || 'AACBoard'}" {\n`;
         // Helper to escape DOT string
@@ -204,7 +207,7 @@ class DotProcessor extends baseProcessor_1.BaseProcessor {
             });
         }
         dotContent += '}\n';
-        (0, io_1.writeTextToPath)(_outputPath, dotContent);
+        writeTextToPath(_outputPath, dotContent);
     }
     /**
      * Extract strings with metadata for aac-tools-platform compatibility

package/dist/processors/excelProcessor.js

@@ -22,13 +22,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExcelProcessor = void 0;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 const ExcelJS = __importStar(require("exceljs"));
 const baseProcessor_1 = require("../core/baseProcessor");
 const treeStructure_1 = require("../core/treeStructure");
@@ -68,11 +63,12 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * @returns Buffer containing the translated Excel file
      */
     async processTexts(_filePathOrBuffer, _translations, outputPath) {
+        const { dirname, pathExists, mkDir } = this.options.fileAdapter;
         await Promise.resolve();
         console.warn('ExcelProcessor.processTexts is not implemented yet.');
-        const outputDir = path_1.default.dirname(outputPath);
-        if (!fs_1.default.existsSync(outputDir)) {
-            fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const outputDir = dirname(outputPath);
+        if (!pathExists(outputDir)) {
+            mkDir(outputDir, { recursive: true });
         }
         return Buffer.alloc(0);
     }
@@ -468,8 +464,9 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
      * Note: This method is async but maintains the sync interface for compatibility
      */
     async saveFromTree(tree, outputPath) {
-        const outputDir = path_1.default.dirname(outputPath);
-        fs_1.default.mkdirSync(outputDir, { recursive: true });
+        const { mkDir, dirname, writeTextToPath } = this.options.fileAdapter;
+        const outputDir = dirname(outputPath);
+        mkDir(outputDir, { recursive: true });
         try {
             await this.saveFromTreeAsync(tree, outputPath);
         }
@@ -478,8 +475,8 @@ class ExcelProcessor extends baseProcessor_1.BaseProcessor {
             console.error('Failed to save Excel file:', message);
             try {
                 const fallbackPath = outputPath.replace(/\.xlsx$/i, '_error.txt');
-                fs_1.default.mkdirSync(path_1.default.dirname(fallbackPath), { recursive: true });
-                fs_1.default.writeFileSync(fallbackPath, `Error saving Excel file: ${message}`);
+                mkDir(dirname(fallbackPath), { recursive: true });
+                writeTextToPath(fallbackPath, `Error saving Excel file: ${message}`);
             }
             catch (writeError) {
                 console.error('Failed to write Excel error file:', writeError);

package/dist/processors/gridset/helpers.d.ts

@@ -1,6 +1,6 @@
 import { AACTree, AACSemanticCategory, AACSemanticIntent } from '../../core/treeStructure';
-import { type ZipAdapter } from '../../utils/zip';
-import type { ProcessorInput } from '../../utils/io';
+import { FileAdapter, ProcessorInput } from '../../utils/io';
+import { ZipAdapter } from '../../utils/zip';
 /**
  * Build a map of button IDs to resolved image entry paths for a specific page.
  * Helpful when rewriting zip entry names or validating images referenced in a grid.
@@ -17,9 +17,7 @@ export declare function getAllowedImageEntries(tree: AACTree): Set<string>;
  * @param entryPath Entry name inside the zip
  * @returns Image data buffer or null if not found
  */
-export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined, zipAdapter?: (input: ProcessorInput) => Promise<{
-    zip: ZipAdapter;
-}>): Promise<Uint8Array | null>;
+export declare function openImage(gridsetBuffer: Uint8Array, entryPath: string, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input?: ProcessorInput) => Promise<ZipAdapter>): Promise<Uint8Array | null>;
 /**
  * Generate a random GUID for Grid3 elements
  * Grid3 uses GUIDs for grid identification
@@ -90,13 +88,13 @@ export declare function getCommonDocumentsPath(): string;
  * C:\Users\Public\Documents\Smartbox\Grid 3\Users\{UserName}\Grid Sets\
  * @returns Array of Grid3 user path information
  */
-export declare function findGrid3UserPaths(): Grid3UserPath[];
+export declare function findGrid3UserPaths(fileAdapter?: FileAdapter): Grid3UserPath[];
 /**
  * Find all Grid3 history database paths
  * Convenience method that returns just the database file paths
  * @returns Array of paths to history.sqlite files
  */
-export declare function findGrid3HistoryDatabases(): string[];
+export declare function findGrid3HistoryDatabases(fileAdapter?: FileAdapter): string[];
 /**
  * Get Grid 3 users (alias of findGrid3UserPaths for clarity)
  */
@@ -106,24 +104,24 @@ export declare function findGrid3Users(): Grid3UserPath[];
  * @param userName Optional user filter; matches case-insensitively
  * @returns Array of user/gridset path pairs
  */
-export declare function findGrid3Vocabularies(userName?: string): Grid3VocabularyPath[];
+export declare function findGrid3Vocabularies(userName?: string, fileAdapter?: FileAdapter): Grid3VocabularyPath[];
 /**
  * Find a specific user's Grid 3 history database
  * @param userName User name to search for (case-insensitive)
  * @param langCode Optional language code filter (case-insensitive)
  * @returns Path to history.sqlite or null if not found
  */
-export declare function findGrid3UserHistory(userName: string, langCode?: string): string | null;
+export declare function findGrid3UserHistory(userName: string, langCode?: string, fileAdapter?: FileAdapter): string | null;
 /**
  * Check whether Grid 3 appears to be installed (Windows only)
  */
-export declare function isGrid3Installed(): boolean;
+export declare function isGrid3Installed(fileAdapter?: FileAdapter): boolean;
 /**
  * Read history events from a Grid 3 history.sqlite database.
  * @param historyDbPath Absolute path to the history database
  * @returns Parsed history entries grouped by phrase
  */
-export declare function readGrid3History(historyDbPath: string): Grid3HistoryEntry[];
+export declare function readGrid3History(historyDbPath: string, fileAdapter?: FileAdapter): Grid3HistoryEntry[];
 /**
  * Convenience wrapper to load history for a specific Grid 3 user/lang combination.
  * @param userName Grid 3 user name (case-insensitive)