@willwade/aac-processors 0.1.21 → 0.2.1

package/dist/browser/utilities/analytics/reference/index.js

@@ -21,46 +21,46 @@ export class ReferenceLoader {
     /**
      * Load core vocabulary lists
      */
-    loadCoreLists() {
+    async loadCoreLists() {
         const { readTextFromInput } = this.fileAdapter;
         const filePath = this.fileAdapter.join(this.dataDir, `core_lists.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load common words with baseline effort scores
      */
-    loadCommonWords() {
+    async loadCommonWords() {
         const { readTextFromInput, join } = this.fileAdapter;
         const filePath = join(this.dataDir, `common_words.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load synonym mappings
      */
-    loadSynonyms() {
+    async loadSynonyms() {
         const { readTextFromInput, join } = this.fileAdapter;
         const filePath = join(this.dataDir, `synonyms.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load test sentences
      */
-    loadSentences() {
+    async loadSentences() {
         const { readTextFromInput, join } = this.fileAdapter;
         const filePath = join(this.dataDir, `sentences.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
      * Load fringe vocabulary
      */
-    loadFringe() {
+    async loadFringe() {
         const { readTextFromInput, join } = this.fileAdapter;
         const filePath = join(this.dataDir, `fringe.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         const data = JSON.parse(String(content));
         // Flatten nested category words if needed
         if (Array.isArray(data) && data.length > 0 && data[0].categories) {
@@ -77,10 +77,10 @@ export class ReferenceLoader {
     /**
      * Load base words hash map
      */
-    loadBaseWords() {
+    async loadBaseWords() {
         const { readTextFromInput, join } = this.fileAdapter;
         const filePath = join(this.dataDir, `base_words.${this.locale}.json`);
-        const content = readTextFromInput(filePath);
+        const content = await readTextFromInput(filePath);
         return JSON.parse(String(content));
     }
     /**
@@ -88,10 +88,10 @@ export class ReferenceLoader {
      * Common words that are NOT in core vocabulary lists
      * (matching Ruby loader.rb:413-420)
      */
-    loadCommonFringe() {
-        const commonWordsData = this.loadCommonWords();
+    async loadCommonFringe() {
+        const commonWordsData = await this.loadCommonWords();
         const commonWords = new Set(commonWordsData.words.map((w) => w.toLowerCase()));
-        const coreLists = this.loadCoreLists();
+        const coreLists = await this.loadCoreLists();
         const coreWords = new Set();
         coreLists.forEach((list) => {
             list.words.forEach((word) => coreWords.add(word.toLowerCase()));
@@ -103,14 +103,14 @@ export class ReferenceLoader {
     /**
      * Get all reference data at once
      */
-    loadAll() {
+    async loadAll() {
         return {
-            coreLists: this.loadCoreLists(),
-            commonWords: this.loadCommonWords(),
-            synonyms: this.loadSynonyms(),
-            sentences: this.loadSentences(),
-            fringe: this.loadFringe(),
-            baseWords: this.loadBaseWords(),
+            coreLists: await this.loadCoreLists(),
+            commonWords: await this.loadCommonWords(),
+            synonyms: await this.loadSynonyms(),
+            sentences: await this.loadSentences(),
+            fringe: await this.loadFringe(),
+            baseWords: await this.loadBaseWords(),
         };
     }
 }
@@ -123,7 +123,7 @@ export function getReferenceDataPath(fileAdapter = defaultFileAdapter) {
 /**
  * Check if reference data files exist
  */
-export function hasReferenceData(fileAdapter = defaultFileAdapter) {
+export async function hasReferenceData(fileAdapter = defaultFileAdapter) {
     const { pathExists, join } = fileAdapter;
     const dataPath = getReferenceDataPath();
     const requiredFiles = [
@@ -133,5 +133,6 @@ export function hasReferenceData(fileAdapter = defaultFileAdapter) {
         'synonyms.en.json',
         'fringe.en.json',
     ];
-    return requiredFiles.every((file) => pathExists(join(dataPath, file)));
+    const existingPaths = await Promise.all(requiredFiles.map(async (file) => await pathExists(join(dataPath, file))));
+    return existingPaths.every((exists) => exists);
 }

package/dist/browser/utils/io.js

@@ -24,7 +24,7 @@ function getFs() {
     if (!cachedFs) {
         try {
             const nodeRequire = getNodeRequire();
-            const fsModule = 'fs';
+            const fsModule = 'node:fs';
             cachedFs = nodeRequire(fsModule);
         }
         catch {
@@ -121,57 +121,61 @@ export function extname(path) {
     const tail = splitDeviceRe.exec(path)?.at(3) ?? '';
     return splitTailRe.exec(tail)?.at(3) ?? '';
 }
-function readBinaryFromInput(input) {
+async function readBinaryFromInput(input) {
     if (typeof input === 'string') {
-        return getFs().readFileSync(input);
+        return Promise.resolve(getFs().readFileSync(input));
     }
     if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {
-        return input;
+        return Promise.resolve(input);
     }
     if (input instanceof ArrayBuffer) {
-        return new Uint8Array(input);
+        return Promise.resolve(new Uint8Array(input));
     }
-    return input;
+    return Promise.resolve(input);
 }
-function readTextFromInput(input, encoding = 'utf8') {
+async function readTextFromInput(input, encoding = 'utf8') {
     if (typeof input === 'string') {
-        return getFs().readFileSync(input, encoding);
+        return Promise.resolve(getFs().readFileSync(input, encoding));
     }
     if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {
-        return input.toString(encoding);
+        return Promise.resolve(input.toString(encoding));
     }
     if (input instanceof ArrayBuffer) {
-        return decodeText(new Uint8Array(input));
+        return Promise.resolve(decodeText(new Uint8Array(input)));
     }
-    return decodeText(input);
+    return Promise.resolve(decodeText(input));
 }
-function writeBinaryToPath(outputPath, data) {
+async function writeBinaryToPath(outputPath, data) {
     getFs().writeFileSync(outputPath, data);
+    await Promise.resolve();
 }
-function writeTextToPath(outputPath, text) {
+async function writeTextToPath(outputPath, text) {
     getFs().writeFileSync(outputPath, text, 'utf8');
+    await Promise.resolve();
 }
-function pathExists(path) {
-    return getFs().existsSync(path);
+async function pathExists(path) {
+    return Promise.resolve(getFs().existsSync(path));
 }
-function isDirectory(path) {
-    return getFs().statSync(path).isDirectory();
+async function isDirectory(path) {
+    return Promise.resolve(getFs().statSync(path).isDirectory());
 }
-function getFileSize(path) {
-    return getFs().statSync(path).size;
+async function getFileSize(path) {
+    return Promise.resolve(getFs().statSync(path).size);
 }
-function mkDir(path, options) {
+async function mkDir(path, options) {
     getFs().mkdirSync(path, options);
+    await Promise.resolve();
 }
-function listDir(path) {
-    return getFs().readdirSync(path);
+async function listDir(path) {
+    return Promise.resolve(getFs().readdirSync(path));
 }
-function removePath(path, options) {
+async function removePath(path, options) {
     getFs().rmSync(path, options);
+    await Promise.resolve();
 }
-function mkTempDir(prefix) {
+async function mkTempDir(prefix) {
     const path = join(getOs().tmpdir(), prefix);
-    return getFs().mkdtempSync(path);
+    return Promise.resolve(getFs().mkdtempSync(path));
 }
 function join(...pathParts) {
     return getPath().join(...pathParts);

package/dist/browser/utils/sqlite.js

@@ -79,24 +79,24 @@ export async function openSqliteDatabase(input, options = {}) {
         const db = new Database(input, { readonly: options.readonly ?? true });
         return { db };
     }
-    const data = readBinaryFromInput(input);
+    const data = await readBinaryFromInput(input);
     if (!isNodeRuntime()) {
         const SQL = await getSqlJs();
         const db = new SQL.Database(data);
         return { db: createSqlJsAdapter(db) };
     }
-    const tempDir = mkTempDir('aac-sqlite-');
+    const tempDir = await mkTempDir('aac-sqlite-');
     const dbPath = join(tempDir, 'input.sqlite');
-    writeBinaryToPath(dbPath, data);
+    await writeBinaryToPath(dbPath, data);
     const Database = getBetterSqlite3();
     const db = new Database(dbPath, { readonly: options.readonly ?? true });
-    const cleanup = () => {
+    const cleanup = async () => {
         try {
             db.close();
         }
         finally {
             try {
-                removePath(tempDir, { recursive: true, force: true });
+                await removePath(tempDir, { recursive: true, force: true });
             }
             catch (error) {
                 console.warn('Failed to clean up temporary SQLite files:', error);

package/dist/browser/utils/zip.js

@@ -7,7 +7,7 @@ export async function getZipAdapter(input, fileAdapter) {
             ? new AdmZip(input)
             : typeof input === 'string'
                 ? new AdmZip(input)
-                : new AdmZip(Buffer.from(adapter.readBinaryFromInput(input)));
+                : new AdmZip(Buffer.from(await adapter.readBinaryFromInput(input)));
         return {
             listFiles: () => {
                 return zip
@@ -31,9 +31,7 @@ export async function getZipAdapter(input, fileAdapter) {
     }
     const module = await import('jszip');
     const JSZip = module.default || module;
-    if (input !== undefined && typeof input === 'string')
-        throw new Error('Zip file paths are not supported in browser environments.');
-    const zip = input ? await JSZip.loadAsync(adapter.readBinaryFromInput(input)) : new JSZip();
+    const zip = input ? await JSZip.loadAsync(await adapter.readBinaryFromInput(input)) : new JSZip();
     return {
         listFiles: () => {
             return Object.entries(zip.files)

package/dist/browser/validation/gridsetValidator.js

@@ -17,8 +17,8 @@ export class GridsetValidator extends BaseValidator {
     static async validateFile(filePath, fileAdapter) {
         const { readBinaryFromInput, getFileSize } = fileAdapter ?? defaultFileAdapter;
         const validator = new GridsetValidator();
-        const content = readBinaryFromInput(filePath);
-        const size = getFileSize(filePath);
+        const content = await readBinaryFromInput(filePath);
+        const size = await getFileSize(filePath);
         return validator.validate(content, getBasename(filePath), size);
     }
     /**

package/dist/browser/validation/obfValidator.js

@@ -21,8 +21,8 @@ export class ObfValidator extends BaseValidator {
     static async validateFile(filePath, fileAdapter) {
         const { readBinaryFromInput, getFileSize } = fileAdapter ?? defaultFileAdapter;
         const validator = new ObfValidator();
-        const content = readBinaryFromInput(filePath);
-        const size = getFileSize(filePath);
+        const content = await readBinaryFromInput(filePath);
+        const size = await getFileSize(filePath);
         return validator.validate(content, getBasename(filePath), size);
     }
     /**

package/dist/browser/validation/snapValidator.js

@@ -19,8 +19,8 @@ export class SnapValidator extends BaseValidator {
     static async validateFile(filePath, fileAdapter) {
         const { readBinaryFromInput, getFileSize } = fileAdapter ?? defaultFileAdapter;
         const validator = new SnapValidator();
-        const content = readBinaryFromInput(filePath);
-        const size = getFileSize(filePath);
+        const content = await readBinaryFromInput(filePath);
+        const size = await getFileSize(filePath);
         return validator.validate(content, getBasename(filePath), size);
     }
     /**
@@ -209,7 +209,7 @@ export class SnapValidator extends BaseValidator {
             }
             finally {
                 if (cleanup) {
-                    cleanup();
+                    await cleanup();
                 }
             }
         });

package/dist/browser/validation/touchChatValidator.js

@@ -21,8 +21,8 @@ export class TouchChatValidator extends BaseValidator {
     static async validateFile(filePath, fileAdapter) {
         const { readBinaryFromInput, getFileSize } = fileAdapter ?? defaultFileAdapter;
         const validator = new TouchChatValidator();
-        const content = readBinaryFromInput(filePath);
-        const size = getFileSize(filePath);
+        const content = await readBinaryFromInput(filePath);
+        const size = await getFileSize(filePath);
         return validator.validate(content, getBasename(filePath), size);
     }
     /**
@@ -335,7 +335,7 @@ export class TouchChatValidator extends BaseValidator {
             }
             finally {
                 if (cleanup) {
-                    cleanup();
+                    await cleanup();
                 }
             }
         });

package/dist/cli/index.js

@@ -8,11 +8,14 @@ const history_1 = require("../utilities/analytics/history");
 const analytics_1 = require("../utilities/analytics");
 const aac_1 = require("../types/aac");
 const io_1 = require("../utils/io");
-const { pathExists, isDirectory, join, readTextFromInput, basename, writeTextToPath } = io_1.defaultFileAdapter;
+const node_fs_1 = require("node:fs");
+const { pathExists, isDirectory, join, basename, writeTextToPath } = io_1.defaultFileAdapter;
 // Helper function to detect format from file/folder path
-function detectFormat(filePath) {
+async function detectFormat(filePath) {
     // Check if it's a folder ending with .ascconfig
-    if (pathExists(filePath) && isDirectory(filePath) && filePath.endsWith('.ascconfig')) {
+    if ((await pathExists(filePath)) &&
+        (await isDirectory(filePath)) &&
+        filePath.endsWith('.ascconfig')) {
         return 'ascconfig';
     }
     // Map multi-file formats to their base processor
@@ -61,7 +64,7 @@ function parseFilteringOptions(options) {
     return processorOptions;
 }
 // Set version from package.json
-const packageJson = JSON.parse(readTextFromInput(join(__dirname, '../../package.json')));
+const packageJson = JSON.parse((0, node_fs_1.readFileSync)(join(__dirname, '../../package.json'), 'utf8'));
 commander_1.program.version(packageJson.version);
 commander_1.program
     .command('analyze <file>')
@@ -77,7 +80,7 @@ commander_1.program
         // Parse filtering options
         const filteringOptions = parseFilteringOptions(options);
         // Auto-detect format if not specified
-        const format = options.format || detectFormat(file);
+        const format = options.format || (await detectFormat(file));
         const processor = (0, analyze_1.getProcessor)(format, filteringOptions);
         const tree = await processor.loadIntoTree(file);
         const result = {
@@ -112,7 +115,7 @@ commander_1.program
         // Parse filtering options
         const filteringOptions = parseFilteringOptions(options);
         // Auto-detect format if not specified
-        const format = options.format || detectFormat(file);
+        const format = options.format || (await detectFormat(file));
         const processor = (0, analyze_1.getProcessor)(format, filteringOptions);
         const texts = await processor.extractTexts(file);
         if (!options.quiet) {
@@ -162,7 +165,7 @@ commander_1.program
         // Parse filtering options
         const filteringOptions = parseFilteringOptions(options);
         // Auto-detect input format
-        const inputFormat = detectFormat(input);
+        const inputFormat = await detectFormat(input);
         const inputProcessor = (0, analyze_1.getProcessor)(inputFormat, filteringOptions);
         // Load the tree (handle both files and folders)
         const tree = await inputProcessor.loadIntoTree(input);
@@ -203,7 +206,7 @@ commander_1.program
     .action(async (file, options) => {
     try {
         // Auto-detect format if not specified
-        const format = options.format || detectFormat(file);
+        const format = options.format || (await detectFormat(file));
         // Get processor with gridset password if provided
         const processorOptions = {};
         if (options.gridsetPassword) {
@@ -283,9 +286,9 @@ commander_1.program
     .option('--export-date <iso>', 'Export date for baton export (ISO string)')
     .option('--encryption <mode>', 'Encryption label for baton export', 'none')
     .option('--version <version>', 'Baton export version', '1.0')
-    .action((input, options) => {
+    .action(async (input, options) => {
     try {
-        if (!pathExists(input)) {
+        if (!(await pathExists(input))) {
             throw new Error(`File not found: ${input}`);
         }
         const normalizedSource = (options.source || 'auto').toLowerCase();
@@ -294,10 +297,10 @@ commander_1.program
         const isSnap = ext === '.sps' || ext === '.spb';
         let entries;
         if (normalizedSource === 'grid3' || (normalizedSource === 'auto' && isGrid3Db)) {
-            entries = (0, history_1.readGrid3History)(input);
+            entries = await (0, history_1.readGrid3History)(input);
         }
         else if (normalizedSource === 'snap' || (normalizedSource === 'auto' && isSnap)) {
-            entries = (0, history_1.readSnapUsage)(input);
+            entries = await (0, history_1.readSnapUsage)(input);
         }
         else {
             throw new Error('Unable to detect history source. Use --source grid3 or --source snap.');
@@ -317,7 +320,7 @@ commander_1.program
         }
         const output = JSON.stringify(payload, null, 2);
         if (options.out) {
-            writeTextToPath(options.out, output);
+            await writeTextToPath(options.out, output);
         }
         else {
             console.log(output);
@@ -348,7 +351,7 @@ commander_1.program
     .action(async (file, options) => {
     try {
         const filteringOptions = parseFilteringOptions(options);
-        const format = options.format || detectFormat(file);
+        const format = options.format || (await detectFormat(file));
         const processor = (0, analyze_1.getProcessor)(format, filteringOptions);
         const tree = await processor.loadIntoTree(file);
         const accessMethod = (options.accessMethod || 'direct').toLowerCase();
@@ -403,7 +406,7 @@ commander_1.program
         let care = undefined;
         if (options.care) {
             const comparison = new analytics_1.ComparisonAnalyzer();
-            care = comparison.compare(metrics, metrics, {
+            care = await comparison.compare(metrics, metrics, {
                 includeSentences: true,
                 usePrediction: !!options.usePrediction,
                 scanningConfig,
@@ -421,7 +424,7 @@ commander_1.program
         };
         const output = options.pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result);
         if (options.out) {
-            writeTextToPath(options.out, output);
+            await writeTextToPath(options.out, output);
         }
         else {
             console.log(output);

package/dist/core/baseProcessor.d.ts

@@ -54,7 +54,7 @@ export interface ProcessorConfig {
     grid3Path?: string;
     grid3Locale?: string;
     fileAdapter: FileAdapter;
-    zipAdapter: (input?: ProcessorInput) => Promise<ZipAdapter>;
+    zipAdapter: (input?: ProcessorInput, fileAdapter?: FileAdapter) => Promise<ZipAdapter>;
 }
 export type ProcessorOptions = Partial<ProcessorConfig>;
 export interface ExtractedString {

package/dist/processors/applePanelsProcessor.js

@@ -92,15 +92,14 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
     }
     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') {
                 if (filePathOrBuffer.endsWith('.ascconfig')) {
                     const panelDefsPath = join(filePathOrBuffer, 'Contents', 'Resources', 'PanelDefinitions.plist');
-                    if (pathExists(panelDefsPath)) {
-                        buffer = readBinaryFromInput(panelDefsPath);
+                    if (await pathExists(panelDefsPath)) {
+                        buffer = await readBinaryFromInput(panelDefsPath);
                     }
                     else {
                         const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
@@ -115,13 +114,13 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
                     }
                 }
                 else {
-                    buffer = readBinaryFromInput(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_1.default.parse(content);
             let panelsData = [];
             if (Array.isArray(parsedData.panels)) {
@@ -250,10 +249,12 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
             const validation = (0, validationTypes_1.buildValidationResultFromMessage)({
                 filename,
                 filesize: typeof filePathOrBuffer === 'string'
-                    ? (() => {
-                        return pathExists(filePathOrBuffer) ? getFileSize(filePathOrBuffer) : 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',
@@ -313,15 +314,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 readBinaryFromInput(outputPath);
+            return await readBinaryFromInput(outputPath);
         }
         const configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
         const panelDefsPath = join(configPath, 'Contents', 'Resources', 'PanelDefinitions.plist');
-        return readBinaryFromInput(panelDefsPath);
+        return await 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)
         // 2) Apple Panels bundle folder (*.ascconfig) with Contents/Resources structure
@@ -334,12 +334,12 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
             configPath = outputPath.endsWith('.ascconfig') ? outputPath : `${outputPath}.ascconfig`;
             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 });
+            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',
@@ -355,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);
-            writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
+            await writeTextToPath(join(contentsPath, 'Info.plist'), infoPlistContent);
             // Create AssetIndex.plist (empty)
             const assetIndexContent = plist_1.default.build({});
-            writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
+            await writeTextToPath(join(resourcesPath, 'AssetIndex.plist'), assetIndexContent);
         }
         // Build PanelDefinitions content from tree
         const panelsDict = {};
@@ -485,13 +485,13 @@ class ApplePanelsProcessor extends baseProcessor_1.BaseProcessor {
         if (isSinglePlist) {
             // Write single PanelDefinitions.plist file directly
             const dir = dirname(outputPath);
-            if (!pathExists(dir))
-                mkDir(dir, { recursive: true });
-            writeTextToPath(outputPath, panelDefsContent);
+            if (!(await pathExists(dir)))
+                await mkDir(dir, { recursive: true });
+            await writeTextToPath(outputPath, panelDefsContent);
         }
         else {
             // Write into bundle structure
-            writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
+            await writeTextToPath(join(resourcesPath, 'PanelDefinitions.plist'), panelDefsContent);
         }
     }
     createApplePanelsAction(button) {

package/dist/processors/astericsGridProcessor.d.ts

@@ -35,22 +35,22 @@ declare class AstericsGridProcessor extends BaseProcessor {
     /**
      * Add audio recording to a specific grid element
      */
-    addAudioToElement(filePath: string, elementId: string, audioData: Buffer, metadata?: string): void;
+    addAudioToElement(filePath: string, elementId: string, audioData: Buffer, metadata?: string): Promise<void>;
     /**
      * Create a copy of the grid file with audio recordings added
      */
     createAudioEnhancedGridFile(sourceFilePath: string, targetFilePath: string, audioMappings: Map<string, {
         audioData: Buffer;
         metadata?: string;
-    }>): void;
+    }>): Promise<void>;
     /**
      * Extract all element IDs from the grid file for audio mapping
      */
-    getElementIds(filePathOrBuffer: ProcessorInput): string[];
+    getElementIds(filePathOrBuffer: ProcessorInput): Promise<string[]>;
     /**
      * Check if an element has audio recording
      */
-    hasAudioRecording(filePathOrBuffer: ProcessorInput, elementId: string): boolean;
+    hasAudioRecording(filePathOrBuffer: ProcessorInput, elementId: string): Promise<boolean>;
     /**
      * Extract strings with metadata for aac-tools-platform compatibility
      * Uses the generic implementation from BaseProcessor