@willwade/aac-processors 0.1.6 → 0.1.7

package/dist/browser/utils/io.js

@@ -72,8 +72,22 @@ export function isNodeRuntime() {
     return typeof process !== 'undefined' && !!process.versions?.node;
 }
 export function getBasename(filePath) {
-    const parts = filePath.split(/[/\\]/);
-    return parts[parts.length - 1] || filePath;
+    const trimmed = filePath.replace(/[/\\]+$/, '') || filePath;
+    const parts = trimmed.split(/[/\\]/);
+    return parts[parts.length - 1] || trimmed;
+}
+export function toUint8Array(input) {
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    return new Uint8Array(input);
+}
+export function toArrayBuffer(input) {
+    if (input instanceof ArrayBuffer) {
+        return input;
+    }
+    const view = input instanceof Uint8Array ? input : new Uint8Array(input);
+    return view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength);
 }
 export function decodeText(input) {
     if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {

package/dist/browser/validation/gridsetValidator.js

@@ -2,24 +2,9 @@
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 import JSZip from 'jszip';
+import * as xml2js from 'xml2js';
 import { BaseValidator } from './baseValidator';
-import { getFs, getNodeRequire, getPath } from '../utils/io';
-let cachedXml2js = null;
-function getXml2js() {
-    if (cachedXml2js)
-        return cachedXml2js;
-    try {
-        const nodeRequire = getNodeRequire();
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const module = nodeRequire('xml2js');
-        const resolved = module.default || module;
-        cachedXml2js = resolved;
-        return resolved;
-    }
-    catch {
-        throw new Error('Validator requires Xml2js in this environment.');
-    }
-}
+import { decodeText, getBasename, getFs, toUint8Array } from '../utils/io';
 /**
  * Validator for Grid3/Smartbox Gridset files (.gridset, .gridsetx)
  */
@@ -33,10 +18,9 @@ export class GridsetValidator extends BaseValidator {
     static async validateFile(filePath) {
         const validator = new GridsetValidator();
         const fs = getFs();
-        const path = getPath();
         const content = fs.readFileSync(filePath);
         const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        return validator.validate(content, getBasename(filePath), stats.size);
     }
     /**
      * Check if content is Gridset format
@@ -48,8 +32,7 @@ export class GridsetValidator extends BaseValidator {
         }
         // Try to parse as XML and check for gridset structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
-            const xml2js = getXml2js();
+            const contentStr = typeof content === 'string' ? content : decodeText(toUint8Array(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             return result && (result.gridset || result.Gridset);
@@ -102,9 +85,8 @@ export class GridsetValidator extends BaseValidator {
         let xmlObj = null;
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
-                const xml2js = getXml2js();
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = decodeText(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {
@@ -129,7 +111,7 @@ export class GridsetValidator extends BaseValidator {
     async validateZipArchive(content, filename, _filesize) {
         let zip;
         try {
-            zip = await JSZip.loadAsync(Buffer.from(content));
+            zip = await JSZip.loadAsync(toUint8Array(content));
         }
         catch (e) {
             this.err(`Failed to open ZIP archive: ${e.message}`, true);
@@ -145,7 +127,6 @@ export class GridsetValidator extends BaseValidator {
             else {
                 try {
                     const gridsetXml = await gridsetEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(gridsetXml);
                     const gridset = xmlObj.gridset || xmlObj.Gridset;
@@ -153,7 +134,7 @@ export class GridsetValidator extends BaseValidator {
                         this.err('Invalid gridset.xml structure', true);
                     }
                     else {
-                        await this.validateGridsetStructure(gridset, filename, Buffer.from(gridsetXml));
+                        await this.validateGridsetStructure(gridset, filename, new Uint8Array());
                     }
                 }
                 catch (e) {
@@ -170,7 +151,6 @@ export class GridsetValidator extends BaseValidator {
             else {
                 try {
                     const settingsXml = await settingsEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(settingsXml);
                     const settings = xmlObj.GridSetSettings || xmlObj.gridSetSettings || xmlObj.GridsetSettings;

package/dist/browser/validation/obfValidator.js

@@ -5,7 +5,7 @@
 /* eslint-disable @typescript-eslint/restrict-template-expressions */
 import JSZip from 'jszip';
 import { BaseValidator } from './baseValidator';
-import { getFs, getPath, readBinaryFromInput } from '../utils/io';
+import { decodeText, getBasename, getFs, readBinaryFromInput, toUint8Array } from '../utils/io';
 const OBF_FORMAT = 'open-board-0.1';
 const OBF_FORMAT_CURRENT_VERSION = 0.1;
 /**
@@ -22,7 +22,7 @@ export class ObfValidator extends BaseValidator {
         const validator = new ObfValidator();
         const content = readBinaryFromInput(filePath);
         const stats = getFs().statSync(filePath);
-        return validator.validate(content, getPath().basename(filePath), stats.size);
+        return validator.validate(content, getBasename(filePath), stats.size);
     }
     /**
      * Check if content is OBF format
@@ -34,7 +34,12 @@ export class ObfValidator extends BaseValidator {
         }
         // Try to parse as JSON and check format
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString() : content;
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const contentStr = typeof content === 'string' ? content : decodeText(toUint8Array(content));
             const json = JSON.parse(contentStr);
             return json && json.format && json.format.startsWith('open-board-');
         }
@@ -68,7 +73,7 @@ export class ObfValidator extends BaseValidator {
         let json = null;
         await this.add_check('valid_json', 'JSON file', async () => {
             try {
-                json = JSON.parse(content.toString());
+                json = JSON.parse(decodeText(content));
             }
             catch {
                 this.err("Couldn't parse as JSON", true);

package/dist/browser/validation/snapValidator.js

@@ -1,10 +1,9 @@
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
-import * as fs from 'fs';
-import * as path from 'path';
 import * as xml2js from 'xml2js';
 import JSZip from 'jszip';
 import { BaseValidator } from './baseValidator';
+import { getBasename, getFs, readBinaryFromInput, toUint8Array } from '../utils/io';
 /**
  * Validator for Snap files (.spb, .sps)
  * Snap files are zipped packages containing XML configuration
@@ -18,9 +17,9 @@ export class SnapValidator extends BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new SnapValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = readBinaryFromInput(filePath);
+        const stats = getFs().statSync(filePath);
+        return validator.validate(content, getBasename(filePath), stats.size);
     }
     /**
      * Check if content is Snap format
@@ -33,8 +32,7 @@ export class SnapValidator extends BaseValidator {
         }
         // Try to parse as ZIP and check for Snap structure
         try {
-            const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-            const zip = await JSZip.loadAsync(buffer);
+            const zip = await JSZip.loadAsync(toUint8Array(content));
             const entries = Object.values(zip.files).filter((entry) => !entry.dir);
             return entries.some((entry) => entry.name.includes('settings') || entry.name.includes('.xml'));
         }
@@ -56,8 +54,7 @@ export class SnapValidator extends BaseValidator {
         let validZip = false;
         await this.add_check('zip', 'valid zip package', async () => {
             try {
-                const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-                zip = await JSZip.loadAsync(buffer);
+                zip = await JSZip.loadAsync(toUint8Array(content));
                 const entries = Object.values(zip.files);
                 validZip = entries.length > 0;
             }

package/dist/browser/validation/touchChatValidator.js

@@ -1,10 +1,9 @@
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
-import * as fs from 'fs';
-import * as path from 'path';
 import * as xml2js from 'xml2js';
 import { BaseValidator } from './baseValidator';
+import { decodeText, getBasename, getFs, readBinaryFromInput, toUint8Array } from '../utils/io';
 /**
  * Validator for TouchChat files (.ce)
  * TouchChat files are XML-based
@@ -18,9 +17,9 @@ export class TouchChatValidator extends BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new TouchChatValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = readBinaryFromInput(filePath);
+        const stats = getFs().statSync(filePath);
+        return validator.validate(content, getBasename(filePath), stats.size);
     }
     /**
      * Check if content is TouchChat format
@@ -32,7 +31,7 @@ export class TouchChatValidator extends BaseValidator {
         }
         // Try to parse as XML and check for TouchChat structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
+            const contentStr = typeof content === 'string' ? content : decodeText(toUint8Array(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             // TouchChat files typically have specific structure
@@ -56,7 +55,7 @@ export class TouchChatValidator extends BaseValidator {
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = decodeText(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {

package/dist/utils/io.d.ts

@@ -7,6 +7,8 @@ export declare function getPath(): typeof import('path');
 export declare function getOs(): typeof import('os');
 export declare function isNodeRuntime(): boolean;
 export declare function getBasename(filePath: string): string;
+export declare function toUint8Array(input: Uint8Array | ArrayBuffer | Buffer): Uint8Array;
+export declare function toArrayBuffer(input: Uint8Array | ArrayBuffer | Buffer): ArrayBuffer;
 export declare function decodeText(input: Uint8Array): string;
 export declare function encodeBase64(input: Uint8Array): string;
 export declare function encodeText(text: string): BinaryOutput;

package/dist/utils/io.js

@@ -6,6 +6,8 @@ exports.getPath = getPath;
 exports.getOs = getOs;
 exports.isNodeRuntime = isNodeRuntime;
 exports.getBasename = getBasename;
+exports.toUint8Array = toUint8Array;
+exports.toArrayBuffer = toArrayBuffer;
 exports.decodeText = decodeText;
 exports.encodeBase64 = encodeBase64;
 exports.encodeText = encodeText;
@@ -87,8 +89,22 @@ function isNodeRuntime() {
     return typeof process !== 'undefined' && !!process.versions?.node;
 }
 function getBasename(filePath) {
-    const parts = filePath.split(/[/\\]/);
-    return parts[parts.length - 1] || filePath;
+    const trimmed = filePath.replace(/[/\\]+$/, '') || filePath;
+    const parts = trimmed.split(/[/\\]/);
+    return parts[parts.length - 1] || trimmed;
+}
+function toUint8Array(input) {
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    return new Uint8Array(input);
+}
+function toArrayBuffer(input) {
+    if (input instanceof ArrayBuffer) {
+        return input;
+    }
+    const view = input instanceof Uint8Array ? input : new Uint8Array(input);
+    return view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength);
 }
 function decodeText(input) {
     if (typeof Buffer !== 'undefined' && Buffer.isBuffer(input)) {

package/dist/validation/applePanelsValidator.js

@@ -1,45 +1,23 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __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.ApplePanelsValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const plist_1 = __importDefault(require("plist"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Apple Panels (.plist or .ascconfig directory)
  */
 class ApplePanelsValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new ApplePanelsValidator();
+        const fs = (0, io_1.getFs)();
+        const path = (0, io_1.getPath)();
         let content;
-        const filename = path.basename(filePath);
+        const filename = (0, io_1.getBasename)(filePath);
         let size = 0;
         const stats = fs.existsSync(filePath) ? fs.statSync(filePath) : null;
         if (stats?.isDirectory() && filename.toLowerCase().endsWith('.ascconfig')) {
@@ -62,7 +40,12 @@ class ApplePanelsValidator extends baseValidator_1.BaseValidator {
             return true;
         }
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parsed = plist_1.default.parse(str);
             return Boolean(parsed.panels || parsed.Panels);
         }
@@ -80,7 +63,7 @@ class ApplePanelsValidator extends baseValidator_1.BaseValidator {
         let parsed = null;
         await this.add_check('plist_parse', 'valid plist/XML', async () => {
             try {
-                const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+                const str = (0, io_1.decodeText)(content);
                 parsed = plist_1.default.parse(str);
             }
             catch (e) {

package/dist/validation/astericsValidator.js

@@ -1,33 +1,9 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstericsGridValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Asterics Grid (.grd) JSON files
  */
@@ -37,9 +13,9 @@ class AstericsGridValidator extends baseValidator_1.BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new AstericsGridValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Identify whether the content appears to be an Asterics .grd file
@@ -50,7 +26,12 @@ class AstericsGridValidator extends baseValidator_1.BaseValidator {
             return true;
         }
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const json = JSON.parse(str);
             return Array.isArray(json?.grids);
         }
@@ -68,7 +49,7 @@ class AstericsGridValidator extends baseValidator_1.BaseValidator {
         let json = null;
         await this.add_check('json_parse', 'valid JSON', async () => {
             try {
-                let str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+                let str = (0, io_1.decodeText)(content);
                 if (str.charCodeAt(0) === 0xfeff) {
                     str = str.slice(1);
                 }

package/dist/validation/dotValidator.js

@@ -1,49 +1,30 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DotValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Graphviz DOT files
  */
 class DotValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new DotValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
         if (name.endsWith('.dot'))
             return true;
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             return str.includes('digraph') || str.includes('->');
         }
         catch {
@@ -59,7 +40,7 @@ class DotValidator extends baseValidator_1.BaseValidator {
         });
         let text = '';
         await this.add_check('text', 'text content', async () => {
-            text = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            text = (0, io_1.decodeText)(content);
             if (!text.trim()) {
                 this.err('DOT file is empty', true);
             }

package/dist/validation/excelValidator.js

@@ -25,19 +25,18 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExcelValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const ExcelJS = __importStar(require("exceljs"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Excel imports (.xlsx/.xls)
  */
 class ExcelValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new ExcelValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(_content, filename) {
         const name = filename.toLowerCase();
@@ -58,7 +57,7 @@ class ExcelValidator extends baseValidator_1.BaseValidator {
             });
             return this.buildResult(filename, filesize, 'excel');
         }
-        const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
+        const buffer = typeof Buffer !== 'undefined' && Buffer.isBuffer(content) ? content : (0, io_1.toArrayBuffer)(content);
         const workbook = new ExcelJS.Workbook();
         await this.add_check('open', 'open workbook', async () => {
             try {

package/dist/validation/gridsetValidator.js

@@ -1,4 +1,27 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -8,24 +31,9 @@ exports.GridsetValidator = void 0;
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
 const jszip_1 = __importDefault(require("jszip"));
+const xml2js = __importStar(require("xml2js"));
 const baseValidator_1 = require("./baseValidator");
 const io_1 = require("../utils/io");
-let cachedXml2js = null;
-function getXml2js() {
-    if (cachedXml2js)
-        return cachedXml2js;
-    try {
-        const nodeRequire = (0, io_1.getNodeRequire)();
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const module = nodeRequire('xml2js');
-        const resolved = module.default || module;
-        cachedXml2js = resolved;
-        return resolved;
-    }
-    catch {
-        throw new Error('Validator requires Xml2js in this environment.');
-    }
-}
 /**
  * Validator for Grid3/Smartbox Gridset files (.gridset, .gridsetx)
  */
@@ -39,10 +47,9 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new GridsetValidator();
         const fs = (0, io_1.getFs)();
-        const path = (0, io_1.getPath)();
         const content = fs.readFileSync(filePath);
         const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is Gridset format
@@ -54,8 +61,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as XML and check for gridset structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
-            const xml2js = getXml2js();
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             return result && (result.gridset || result.Gridset);
@@ -108,9 +114,8 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
         let xmlObj = null;
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
-                const xml2js = getXml2js();
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = (0, io_1.decodeText)(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {
@@ -135,7 +140,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
     async validateZipArchive(content, filename, _filesize) {
         let zip;
         try {
-            zip = await jszip_1.default.loadAsync(Buffer.from(content));
+            zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
         }
         catch (e) {
             this.err(`Failed to open ZIP archive: ${e.message}`, true);
@@ -151,7 +156,6 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
             else {
                 try {
                     const gridsetXml = await gridsetEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(gridsetXml);
                     const gridset = xmlObj.gridset || xmlObj.Gridset;
@@ -159,7 +163,7 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
                         this.err('Invalid gridset.xml structure', true);
                     }
                     else {
-                        await this.validateGridsetStructure(gridset, filename, Buffer.from(gridsetXml));
+                        await this.validateGridsetStructure(gridset, filename, new Uint8Array());
                     }
                 }
                 catch (e) {
@@ -176,7 +180,6 @@ class GridsetValidator extends baseValidator_1.BaseValidator {
             else {
                 try {
                     const settingsXml = await settingsEntry.async('string');
-                    const xml2js = getXml2js();
                     const parser = new xml2js.Parser();
                     const xmlObj = await parser.parseStringPromise(settingsXml);
                     const settings = xmlObj.GridSetSettings || xmlObj.gridSetSettings || xmlObj.GridsetSettings;

package/dist/validation/index.d.ts

@@ -16,6 +16,7 @@ export { ApplePanelsValidator } from './applePanelsValidator';
 export { ObfsetValidator } from './obfsetValidator';
 import { BaseValidator } from './baseValidator';
 import { ValidationResult } from './validationTypes';
+import { type ProcessorInput } from '../utils/io';
 export declare function getValidatorForFormat(format: string): BaseValidator | null;
 export declare function getValidatorForFile(filename: string): BaseValidator | null;
 /**
@@ -23,4 +24,4 @@ export declare function getValidatorForFile(filename: string): BaseValidator | n
  * When a file path is provided, any validator-specific validateFile() helper
  * will be used if available to access nested resources.
  */
-export declare function validateFileOrBuffer(filePathOrBuffer: string | Buffer, filenameHint?: string): Promise<ValidationResult>;
+export declare function validateFileOrBuffer(filePathOrBuffer: ProcessorInput, filenameHint?: string): Promise<ValidationResult>;

package/dist/validation/index.js

@@ -3,29 +3,6 @@
  * Validation system for AAC processors
  * Provides consistent validation across all supported formats
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfsetValidator = exports.ApplePanelsValidator = exports.DotValidator = exports.OpmlValidator = exports.ExcelValidator = exports.AstericsGridValidator = exports.TouchChatValidator = exports.SnapValidator = exports.GridsetValidator = exports.ObfValidator = exports.BaseValidator = exports.buildValidationResultFromMessage = exports.ValidationFailureError = exports.ValidationError = void 0;
 exports.getValidatorForFormat = getValidatorForFormat;
@@ -72,8 +49,7 @@ const opmlValidator_2 = require("./opmlValidator");
 const dotValidator_2 = require("./dotValidator");
 const applePanelsValidator_2 = require("./applePanelsValidator");
 const obfsetValidator_2 = require("./obfsetValidator");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const io_1 = require("../utils/io");
 function getValidatorForFormat(format) {
     switch (format.toLowerCase()) {
         case 'obf':
@@ -151,22 +127,23 @@ function getValidatorForFile(filename) {
  */
 async function validateFileOrBuffer(filePathOrBuffer, filenameHint) {
     const isPath = typeof filePathOrBuffer === 'string';
-    const name = filenameHint || (isPath ? path.basename(filePathOrBuffer) : 'upload');
+    const name = filenameHint || (isPath ? (0, io_1.getBasename)(filePathOrBuffer) : 'upload');
     const validator = getValidatorForFile(name) || getValidatorForFormat(name);
     if (!validator) {
         throw new Error(`No validator registered for ${name}`);
     }
     if (isPath) {
+        if (!(0, io_1.isNodeRuntime)()) {
+            throw new Error('File path validation is only supported in Node.js environments.');
+        }
         const ctor = validator.constructor;
         if (typeof ctor.validateFile === 'function') {
             return ctor.validateFile(filePathOrBuffer);
         }
-        const buf = fs.readFileSync(filePathOrBuffer);
-        const stats = fs.statSync(filePathOrBuffer);
-        return validator.validate(buf, path.basename(filePathOrBuffer), stats.size);
+        const buf = (0, io_1.readBinaryFromInput)(filePathOrBuffer);
+        const stats = (0, io_1.getFs)().statSync(filePathOrBuffer);
+        return validator.validate(buf, (0, io_1.getBasename)(filePathOrBuffer), stats.size);
     }
-    const buffer = Buffer.isBuffer(filePathOrBuffer)
-        ? filePathOrBuffer
-        : Buffer.from(filePathOrBuffer);
+    const buffer = (0, io_1.toUint8Array)(filePathOrBuffer);
     return validator.validate(buffer, name, buffer.byteLength);
 }

package/dist/validation/obfValidator.js

@@ -28,7 +28,7 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         const validator = new ObfValidator();
         const content = (0, io_1.readBinaryFromInput)(filePath);
         const stats = (0, io_1.getFs)().statSync(filePath);
-        return validator.validate(content, (0, io_1.getPath)().basename(filePath), stats.size);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is OBF format
@@ -40,7 +40,12 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as JSON and check format
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString() : content;
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const json = JSON.parse(contentStr);
             return json && json.format && json.format.startsWith('open-board-');
         }
@@ -74,7 +79,7 @@ class ObfValidator extends baseValidator_1.BaseValidator {
         let json = null;
         await this.add_check('valid_json', 'JSON file', async () => {
             try {
-                json = JSON.parse(content.toString());
+                json = JSON.parse((0, io_1.decodeText)(content));
             }
             catch {
                 this.err("Couldn't parse as JSON", true);

package/dist/validation/obfsetValidator.js

@@ -1,49 +1,30 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObfsetValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for OBF set bundles (.obfset) - JSON arrays of boards
  */
 class ObfsetValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new ObfsetValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
         if (name.endsWith('.obfset'))
             return true;
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parsed = JSON.parse(str);
             return Array.isArray(parsed);
         }
@@ -61,7 +42,7 @@ class ObfsetValidator extends baseValidator_1.BaseValidator {
         let boards = null;
         await this.add_check('json_parse', 'valid JSON array', async () => {
             try {
-                const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+                const str = (0, io_1.decodeText)(content);
                 const parsed = JSON.parse(str);
                 if (!Array.isArray(parsed)) {
                     this.err('root must be a JSON array of boards', true);

package/dist/validation/opmlValidator.js

@@ -1,43 +1,19 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpmlValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const fast_xml_parser_1 = require("fast-xml-parser");
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for OPML files
  */
 class OpmlValidator extends baseValidator_1.BaseValidator {
     static async validateFile(filePath) {
         const validator = new OpmlValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     static async identifyFormat(content, filename) {
         const name = filename.toLowerCase();
@@ -45,7 +21,12 @@ class OpmlValidator extends baseValidator_1.BaseValidator {
             return true;
         }
         try {
-            const str = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            if (typeof content !== 'string' &&
+                !(content instanceof ArrayBuffer) &&
+                !(content instanceof Uint8Array)) {
+                return false;
+            }
+            const str = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const validation = fast_xml_parser_1.XMLValidator.validate(str);
             if (validation !== true) {
                 return false;
@@ -68,7 +49,7 @@ class OpmlValidator extends baseValidator_1.BaseValidator {
         });
         let text = '';
         await this.add_check('content', 'non-empty content', async () => {
-            text = Buffer.isBuffer(content) ? content.toString('utf-8') : String(content);
+            text = (0, io_1.decodeText)(content);
             if (!text.trim()) {
                 this.err('OPML file is empty', true);
             }

package/dist/validation/snapValidator.js

@@ -29,11 +29,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SnapValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const xml2js = __importStar(require("xml2js"));
 const jszip_1 = __importDefault(require("jszip"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Snap files (.spb, .sps)
  * Snap files are zipped packages containing XML configuration
@@ -47,9 +46,9 @@ class SnapValidator extends baseValidator_1.BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new SnapValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is Snap format
@@ -62,8 +61,7 @@ class SnapValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as ZIP and check for Snap structure
         try {
-            const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-            const zip = await jszip_1.default.loadAsync(buffer);
+            const zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
             const entries = Object.values(zip.files).filter((entry) => !entry.dir);
             return entries.some((entry) => entry.name.includes('settings') || entry.name.includes('.xml'));
         }
@@ -85,8 +83,7 @@ class SnapValidator extends baseValidator_1.BaseValidator {
         let validZip = false;
         await this.add_check('zip', 'valid zip package', async () => {
             try {
-                const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
-                zip = await jszip_1.default.loadAsync(buffer);
+                zip = await jszip_1.default.loadAsync((0, io_1.toUint8Array)(content));
                 const entries = Object.values(zip.files);
                 validZip = entries.length > 0;
             }

package/dist/validation/touchChatValidator.js

@@ -27,10 +27,9 @@ exports.TouchChatValidator = void 0;
 /* eslint-disable @typescript-eslint/require-await */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 /* eslint-disable @typescript-eslint/no-unsafe-return */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const xml2js = __importStar(require("xml2js"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for TouchChat files (.ce)
  * TouchChat files are XML-based
@@ -44,9 +43,9 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
      */
     static async validateFile(filePath) {
         const validator = new TouchChatValidator();
-        const content = fs.readFileSync(filePath);
-        const stats = fs.statSync(filePath);
-        return validator.validate(content, path.basename(filePath), stats.size);
+        const content = (0, io_1.readBinaryFromInput)(filePath);
+        const stats = (0, io_1.getFs)().statSync(filePath);
+        return validator.validate(content, (0, io_1.getBasename)(filePath), stats.size);
     }
     /**
      * Check if content is TouchChat format
@@ -58,7 +57,7 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
         }
         // Try to parse as XML and check for TouchChat structure
         try {
-            const contentStr = Buffer.isBuffer(content) ? content.toString('utf-8') : content;
+            const contentStr = typeof content === 'string' ? content : (0, io_1.decodeText)((0, io_1.toUint8Array)(content));
             const parser = new xml2js.Parser();
             const result = await parser.parseStringPromise(contentStr);
             // TouchChat files typically have specific structure
@@ -82,7 +81,7 @@ class TouchChatValidator extends baseValidator_1.BaseValidator {
         await this.add_check('xml_parse', 'valid XML', async () => {
             try {
                 const parser = new xml2js.Parser();
-                const contentStr = content.toString('utf-8');
+                const contentStr = (0, io_1.decodeText)(content);
                 xmlObj = await parser.parseStringPromise(contentStr);
             }
             catch (e) {

package/examples/vitedemo/index.html

@@ -191,6 +191,48 @@
             font-size: 13px;
         }
 
+        .validation-panel {
+            margin-top: 15px;
+        }
+
+        .validation-summary {
+            background: #f8f9fa;
+            border-radius: 8px;
+            padding: 10px 12px;
+            font-size: 13px;
+            font-weight: 600;
+            margin-bottom: 10px;
+        }
+
+        .validation-summary.success {
+            border-left: 4px solid #2ecc71;
+            color: #2d7a4f;
+        }
+
+        .validation-summary.error {
+            border-left: 4px solid #e74c3c;
+            color: #b03a2e;
+        }
+
+        .validation-list {
+            max-height: 180px;
+            overflow-y: auto;
+            font-size: 12px;
+        }
+
+        .validation-item {
+            padding: 6px 0;
+            border-bottom: 1px solid #ececec;
+        }
+
+        .validation-item.warn {
+            color: #c18401;
+        }
+
+        .validation-item.error {
+            color: #b03a2e;
+        }
+
         .processor-name {
             font-weight: 600;
             color: #333;
@@ -437,6 +479,7 @@
                 </div>
 
                 <button class="btn" id="processBtn" disabled>🚀 Process File</button>
+                <button class="btn btn-secondary" id="validateBtn" disabled>✅ Validate File</button>
                 <button class="btn btn-secondary" id="runTestsBtn">🧪 Run Compatibility Tests</button>
                 <button class="btn btn-secondary" id="clearBtn">🗑️ Clear Results</button>
 
@@ -467,6 +510,12 @@
                     <div class="panel-title">Test Results</div>
                     <div id="testList"></div>
                 </div>
+
+                <div class="validation-panel" id="validationPanel" style="display: none;">
+                    <div class="panel-title">Validation</div>
+                    <div class="validation-summary" id="validationSummary"></div>
+                    <div class="validation-list" id="validationList"></div>
+                </div>
             </div>
 
             <!-- Right Panel: Results -->

package/examples/vitedemo/src/main.ts

@@ -81,6 +81,7 @@ import {
   AACPage,
   AACButton
 } from 'aac-processors';
+import { validateFileOrBuffer, type ValidationResult } from 'aac-processors/validation';
 
 import sqlWasmUrl from 'sql.js/dist/sql-wasm.wasm?url';
 
@@ -92,6 +93,7 @@ configureSqlJs({
 const dropArea = document.getElementById('dropArea') as HTMLElement;
 const fileInput = document.getElementById('fileInput') as HTMLInputElement;
 const processBtn = document.getElementById('processBtn') as HTMLButtonElement;
+const validateBtn = document.getElementById('validateBtn') as HTMLButtonElement;
 const runTestsBtn = document.getElementById('runTestsBtn') as HTMLButtonElement;
 const clearBtn = document.getElementById('clearBtn') as HTMLButtonElement;
 const fileInfo = document.getElementById('fileInfo') as HTMLElement;
@@ -102,6 +104,9 @@ const results = document.getElementById('results') as HTMLElement;
 const logPanel = document.getElementById('logPanel') as HTMLElement;
 const testResults = document.getElementById('testResults') as HTMLElement;
 const testList = document.getElementById('testList') as HTMLElement;
+const validationPanel = document.getElementById('validationPanel') as HTMLElement;
+const validationSummary = document.getElementById('validationSummary') as HTMLElement;
+const validationList = document.getElementById('validationList') as HTMLElement;
 const tabButtons = document.querySelectorAll('.tab-btn') as NodeListOf<HTMLButtonElement>;
 const inspectTab = document.getElementById('inspectTab') as HTMLElement;
 const pagesetTab = document.getElementById('pagesetTab') as HTMLElement;
@@ -218,6 +223,7 @@ function handleFile(file: File) {
     fileDetails.textContent = extension;
     fileInfo.style.display = 'block';
     processBtn.disabled = true;
+    validateBtn.disabled = true;
     return;
   }
 
@@ -228,12 +234,14 @@ function handleFile(file: File) {
     fileDetails.textContent = `${file.name} • ${formatFileSize(file.size)}`;
     fileInfo.style.display = 'block';
     processBtn.disabled = false;
+    validateBtn.disabled = false;
     currentSourceLabel = file.name;
 
     log(`Using processor: ${currentProcessor.constructor.name}`, 'success');
   } catch (error) {
     log(`Error getting processor: ${(error as Error).message}`, 'error');
     processBtn.disabled = true;
+    validateBtn.disabled = true;
   }
 }
 
@@ -314,6 +322,79 @@ processBtn.addEventListener('click', async () => {
   }
 });
 
+function collectValidationMessages(
+  result: ValidationResult,
+  prefix = ''
+): Array<{ type: 'error' | 'warn'; message: string }> {
+  const messages: Array<{ type: 'error' | 'warn'; message: string }> = [];
+  const label = prefix ? `${prefix}: ` : '';
+  result.results.forEach((check) => {
+    if (!check.valid && check.error) {
+      messages.push({ type: 'error', message: `${label}${check.description}: ${check.error}` });
+    }
+    if (check.warnings?.length) {
+      check.warnings.forEach((warning) => {
+        messages.push({ type: 'warn', message: `${label}${check.description}: ${warning}` });
+      });
+    }
+  });
+  result.sub_results?.forEach((sub) => {
+    const nextPrefix = `${label}${sub.filename || sub.format}`;
+    messages.push(...collectValidationMessages(sub, nextPrefix));
+  });
+  return messages;
+}
+
+function renderValidationResult(result: ValidationResult) {
+  validationPanel.style.display = 'block';
+  validationSummary.classList.remove('success', 'error');
+  validationSummary.classList.add(result.valid ? 'success' : 'error');
+  validationSummary.textContent = `${result.valid ? '✅ Valid' : '❌ Invalid'} • ${result.format.toUpperCase()} • ${result.errors} errors, ${result.warnings} warnings`;
+
+  validationList.innerHTML = '';
+  const messages = collectValidationMessages(result).slice(0, 30);
+  if (messages.length === 0) {
+    const empty = document.createElement('div');
+    empty.className = 'validation-item';
+    empty.textContent = 'No issues reported.';
+    validationList.appendChild(empty);
+    return;
+  }
+
+  messages.forEach((entry) => {
+    const item = document.createElement('div');
+    item.className = `validation-item ${entry.type}`;
+    item.textContent = entry.message;
+    validationList.appendChild(item);
+  });
+}
+
+validateBtn.addEventListener('click', async () => {
+  if (!currentFile) return;
+  log('Validating file...', 'info');
+
+  try {
+    validateBtn.disabled = true;
+    const arrayBuffer = await currentFile.arrayBuffer();
+    const result = await validateFileOrBuffer(new Uint8Array(arrayBuffer), currentFile.name);
+    renderValidationResult(result);
+    log(
+      `${result.valid ? '✅' : '❌'} Validation complete: ${result.errors} errors, ${result.warnings} warnings`,
+      result.valid ? 'success' : 'warn'
+    );
+  } catch (error) {
+    const errorMsg = (error as Error).message;
+    validationPanel.style.display = 'block';
+    validationSummary.classList.remove('success');
+    validationSummary.classList.add('error');
+    validationSummary.textContent = `❌ Validation failed: ${errorMsg}`;
+    validationList.innerHTML = '';
+    log(`❌ Validation failed: ${errorMsg}`, 'error');
+  } finally {
+    validateBtn.disabled = !currentFile;
+  }
+});
+
 // Display results
 function displayResults(tree: AACTree) {
   results.innerHTML = '';
@@ -423,6 +504,9 @@ clearBtn.addEventListener('click', () => {
   stats.style.display = 'none';
   results.innerHTML = '<p style="color: #999; text-align: center; padding: 40px;">Load a file to see its contents here</p>';
   testResults.style.display = 'none';
+  validationPanel.style.display = 'none';
+  validationSummary.textContent = '';
+  validationList.innerHTML = '';
   logPanel.innerHTML = '<div class="log-entry log-info">Cleared. Ready to process files...</div>';
   pagesetOutput.textContent = 'Generate or convert a pageset to preview the output JSON.';
   updateConvertButtons();

package/examples/vitedemo/vite.config.ts

@@ -3,13 +3,32 @@ import path from 'path';
 
 export default defineConfig({
   resolve: {
-    alias: {
-      'aac-processors': path.resolve(__dirname, '../../src/index.browser.ts'),
-      stream: path.resolve(__dirname, 'node_modules/stream-browserify'),
-      events: path.resolve(__dirname, 'node_modules/events'),
-      timers: path.resolve(__dirname, 'node_modules/timers-browserify'),
-      util: path.resolve(__dirname, 'node_modules/util')
-    }
+    alias: [
+      {
+        find: /^aac-processors\/validation$/,
+        replacement: path.resolve(__dirname, '../../src/validation.ts'),
+      },
+      {
+        find: /^aac-processors$/,
+        replacement: path.resolve(__dirname, '../../src/index.browser.ts'),
+      },
+      {
+        find: /^stream$/,
+        replacement: path.resolve(__dirname, 'node_modules/stream-browserify'),
+      },
+      {
+        find: /^events$/,
+        replacement: path.resolve(__dirname, 'node_modules/events'),
+      },
+      {
+        find: /^timers$/,
+        replacement: path.resolve(__dirname, 'node_modules/timers-browserify'),
+      },
+      {
+        find: /^util$/,
+        replacement: path.resolve(__dirname, 'node_modules/util'),
+      },
+    ],
   },
   optimizeDeps: {
     exclude: ['aac-processors'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A comprehensive TypeScript library for processing AAC (Augmentative and Alternative Communication) file formats with translation support",
   "main": "dist/index.js",
   "browser": "dist/browser/index.browser.js",