@willwade/aac-processors 0.1.6 → 0.1.8

package/dist/index.node.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Translation = exports.AstericsGrid = exports.ApplePanels = exports.Opml = exports.Excel = exports.Dot = exports.TouchChat = exports.Obfset = exports.OBF = exports.Snap = exports.Gridset = exports.Validation = exports.Analytics = void 0;
+exports.Translation = exports.AstericsGrid = exports.ApplePanels = exports.Opml = exports.Excel = exports.Dot = exports.TouchChat = exports.Obfset = exports.OBF = exports.Snap = exports.Gridset = exports.Metrics = exports.Validation = exports.Analytics = void 0;
 exports.getProcessor = getProcessor;
 exports.getSupportedExtensions = getSupportedExtensions;
 exports.isExtensionSupported = isExtensionSupported;
@@ -50,12 +50,12 @@ __exportStar(require("./processors"), exports);
 // ===================================================================
 // NAMESPACES
 // ===================================================================
-// Analytics namespace
-exports.Analytics = __importStar(require("./utilities/analytics"));
-// Also export analytics classes directly for convenience
-__exportStar(require("./utilities/analytics"), exports);
+// Analytics namespace (usage/history)
+exports.Analytics = __importStar(require("./analytics"));
 // Validation namespace
 exports.Validation = __importStar(require("./validation"));
+// Metrics namespace (pageset analytics)
+exports.Metrics = __importStar(require("./metrics"));
 // Processor namespaces (platform-specific utilities)
 exports.Gridset = __importStar(require("./gridset"));
 exports.Snap = __importStar(require("./snap"));

package/dist/metrics.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Metrics Namespace
+ *
+ * Pageset-focused metrics and analytics (board structure, effort, vocabulary).
+ * Use this for analyzing AAC trees, not end-user usage logs.
+ */
+export * from './utilities/analytics/metrics/types';
+export * from './utilities/analytics/metrics/effort';
+export * from './utilities/analytics/metrics/obl-types';
+export { OblUtil, OblAnonymizer } from './utilities/analytics/metrics/obl';
+export { MetricsCalculator } from './utilities/analytics/metrics/core';
+export { VocabularyAnalyzer } from './utilities/analytics/metrics/vocabulary';
+export { SentenceAnalyzer } from './utilities/analytics/metrics/sentence';
+export { ComparisonAnalyzer } from './utilities/analytics/metrics/comparison';
+export { ReferenceLoader } from './utilities/analytics/reference';
+export { InMemoryReferenceLoader, createBrowserReferenceLoader, loadReferenceDataFromUrl, type ReferenceData, } from './utilities/analytics/reference/browser';
+export * from './utilities/analytics/utils/idGenerator';

package/dist/metrics.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Metrics Namespace
+ *
+ * Pageset-focused metrics and analytics (board structure, effort, vocabulary).
+ * Use this for analyzing AAC trees, not end-user usage logs.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadReferenceDataFromUrl = exports.createBrowserReferenceLoader = exports.InMemoryReferenceLoader = exports.ReferenceLoader = exports.ComparisonAnalyzer = exports.SentenceAnalyzer = exports.VocabularyAnalyzer = exports.MetricsCalculator = exports.OblAnonymizer = exports.OblUtil = void 0;
+__exportStar(require("./utilities/analytics/metrics/types"), exports);
+__exportStar(require("./utilities/analytics/metrics/effort"), exports);
+__exportStar(require("./utilities/analytics/metrics/obl-types"), exports);
+var obl_1 = require("./utilities/analytics/metrics/obl");
+Object.defineProperty(exports, "OblUtil", { enumerable: true, get: function () { return obl_1.OblUtil; } });
+Object.defineProperty(exports, "OblAnonymizer", { enumerable: true, get: function () { return obl_1.OblAnonymizer; } });
+var core_1 = require("./utilities/analytics/metrics/core");
+Object.defineProperty(exports, "MetricsCalculator", { enumerable: true, get: function () { return core_1.MetricsCalculator; } });
+var vocabulary_1 = require("./utilities/analytics/metrics/vocabulary");
+Object.defineProperty(exports, "VocabularyAnalyzer", { enumerable: true, get: function () { return vocabulary_1.VocabularyAnalyzer; } });
+var sentence_1 = require("./utilities/analytics/metrics/sentence");
+Object.defineProperty(exports, "SentenceAnalyzer", { enumerable: true, get: function () { return sentence_1.SentenceAnalyzer; } });
+var comparison_1 = require("./utilities/analytics/metrics/comparison");
+Object.defineProperty(exports, "ComparisonAnalyzer", { enumerable: true, get: function () { return comparison_1.ComparisonAnalyzer; } });
+var reference_1 = require("./utilities/analytics/reference");
+Object.defineProperty(exports, "ReferenceLoader", { enumerable: true, get: function () { return reference_1.ReferenceLoader; } });
+var browser_1 = require("./utilities/analytics/reference/browser");
+Object.defineProperty(exports, "InMemoryReferenceLoader", { enumerable: true, get: function () { return browser_1.InMemoryReferenceLoader; } });
+Object.defineProperty(exports, "createBrowserReferenceLoader", { enumerable: true, get: function () { return browser_1.createBrowserReferenceLoader; } });
+Object.defineProperty(exports, "loadReferenceDataFromUrl", { enumerable: true, get: function () { return browser_1.loadReferenceDataFromUrl; } });
+__exportStar(require("./utilities/analytics/utils/idGenerator"), exports);

package/dist/utilities/analytics/metrics/comparison.d.ts

@@ -5,12 +5,13 @@
  * analyze vocabulary differences, and generate CARE component scores.
  */
 import { MetricsResult, ComparisonResult } from './types';
+import { type ReferenceDataProvider } from '../reference/index';
 import { MetricsOptions } from './types';
 export declare class ComparisonAnalyzer {
     private vocabAnalyzer;
     private sentenceAnalyzer;
     private referenceLoader;
-    constructor();
+    constructor(referenceLoader?: ReferenceDataProvider);
     private normalize;
     /**
      * Compare two board sets

package/dist/utilities/analytics/metrics/comparison.js

@@ -12,10 +12,10 @@ const vocabulary_1 = require("./vocabulary");
 const index_1 = require("../reference/index");
 const effort_1 = require("./effort");
 class ComparisonAnalyzer {
-    constructor() {
-        this.vocabAnalyzer = new vocabulary_1.VocabularyAnalyzer();
+    constructor(referenceLoader) {
+        this.vocabAnalyzer = new vocabulary_1.VocabularyAnalyzer(referenceLoader);
         this.sentenceAnalyzer = new sentence_1.SentenceAnalyzer();
-        this.referenceLoader = new index_1.ReferenceLoader();
+        this.referenceLoader = referenceLoader || new index_1.ReferenceLoader();
     }
     normalize(word) {
         return word

package/dist/utilities/analytics/metrics/vocabulary.d.ts

@@ -5,7 +5,7 @@
  * and identifies missing/extra words compared to reference lists.
  */
 import { MetricsResult } from './types';
-import { ReferenceLoader } from '../reference/index';
+import { type ReferenceDataProvider } from '../reference/index';
 export interface VocabularyAnalysis {
     core_coverage: {
         [listId: string]: {
@@ -33,7 +33,7 @@ export interface VocabularyAnalysis {
 }
 export declare class VocabularyAnalyzer {
     private referenceLoader;
-    constructor(referenceLoader?: ReferenceLoader);
+    constructor(referenceLoader?: ReferenceDataProvider);
     /**
      * Analyze vocabulary coverage against core lists
      */

package/dist/utilities/analytics/reference/browser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Browser-friendly reference data loader using fetch.
+ */
+import type { CoreList, CommonWordsData, SynonymsData } from '../metrics/types';
+import type { ReferenceDataProvider } from './index';
+export interface ReferenceData {
+    coreLists: CoreList[];
+    commonWords: CommonWordsData;
+    synonyms: SynonymsData;
+    sentences: string[][];
+    fringe: string[];
+    baseWords: {
+        [word: string]: boolean;
+    };
+}
+export declare class InMemoryReferenceLoader implements ReferenceDataProvider {
+    private data;
+    constructor(data: ReferenceData);
+    loadCoreLists(): CoreList[];
+    loadCommonWords(): CommonWordsData;
+    loadSynonyms(): SynonymsData;
+    loadSentences(): string[][];
+    loadFringe(): string[];
+    loadBaseWords(): {
+        [word: string]: boolean;
+    };
+    loadCommonFringe(): string[];
+    loadAll(): ReferenceData;
+}
+export declare function loadReferenceDataFromUrl(baseUrl: string, locale?: string): Promise<ReferenceData>;
+export declare function createBrowserReferenceLoader(baseUrl: string, locale?: string): Promise<InMemoryReferenceLoader>;

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

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Browser-friendly reference data loader using fetch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryReferenceLoader = void 0;
+exports.loadReferenceDataFromUrl = loadReferenceDataFromUrl;
+exports.createBrowserReferenceLoader = createBrowserReferenceLoader;
+class InMemoryReferenceLoader {
+    constructor(data) {
+        this.data = data;
+    }
+    loadCoreLists() {
+        return this.data.coreLists;
+    }
+    loadCommonWords() {
+        return this.data.commonWords;
+    }
+    loadSynonyms() {
+        return this.data.synonyms;
+    }
+    loadSentences() {
+        return this.data.sentences;
+    }
+    loadFringe() {
+        return this.data.fringe;
+    }
+    loadBaseWords() {
+        return this.data.baseWords;
+    }
+    loadCommonFringe() {
+        const commonWords = new Set(this.data.commonWords.words.map((w) => w.toLowerCase()));
+        const coreWords = new Set();
+        this.data.coreLists.forEach((list) => {
+            list.words.forEach((word) => coreWords.add(word.toLowerCase()));
+        });
+        return Array.from(commonWords).filter((word) => !coreWords.has(word));
+    }
+    loadAll() {
+        return this.data;
+    }
+}
+exports.InMemoryReferenceLoader = InMemoryReferenceLoader;
+async function loadReferenceDataFromUrl(baseUrl, locale = 'en') {
+    const root = baseUrl.replace(/\/$/, '');
+    const fetchJson = async (name) => {
+        const res = await fetch(`${root}/${name}.${locale}.json`);
+        if (!res.ok) {
+            throw new Error(`Failed to load ${name}.${locale}.json`);
+        }
+        return (await res.json());
+    };
+    const [coreLists, commonWords, synonyms, sentences, fringe, baseWords] = await Promise.all([
+        fetchJson('core_lists'),
+        fetchJson('common_words'),
+        fetchJson('synonyms'),
+        fetchJson('sentences'),
+        fetchJson('fringe'),
+        fetchJson('base_words'),
+    ]);
+    return {
+        coreLists,
+        commonWords,
+        synonyms,
+        sentences,
+        fringe,
+        baseWords,
+    };
+}
+async function createBrowserReferenceLoader(baseUrl, locale = 'en') {
+    const data = await loadReferenceDataFromUrl(baseUrl, locale);
+    return new InMemoryReferenceLoader(data);
+}

package/dist/utilities/analytics/reference/index.d.ts

@@ -5,6 +5,27 @@
  * for AAC metrics analysis.
  */
 import { CoreList, CommonWordsData, SynonymsData } from '../metrics/types';
+export interface ReferenceDataProvider {
+    loadCoreLists(): CoreList[];
+    loadCommonWords(): CommonWordsData;
+    loadSynonyms(): SynonymsData;
+    loadSentences(): string[][];
+    loadFringe(): string[];
+    loadBaseWords(): {
+        [word: string]: boolean;
+    };
+    loadCommonFringe(): string[];
+    loadAll(): {
+        coreLists: CoreList[];
+        commonWords: CommonWordsData;
+        synonyms: SynonymsData;
+        sentences: string[][];
+        fringe: string[];
+        baseWords: {
+            [word: string]: boolean;
+        };
+    };
+}
 export declare class ReferenceLoader {
     private dataDir;
     private locale;

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

@@ -5,35 +5,11 @@
  * Loads reference vocabulary lists, core lists, and sentences
  * for AAC metrics analysis.
  */
-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.ReferenceLoader = void 0;
 exports.getReferenceDataPath = getReferenceDataPath;
 exports.hasReferenceData = hasReferenceData;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
+const io_1 = require("../../../utils/io");
 class ReferenceLoader {
     constructor(dataDir, locale = 'en') {
         this.locale = locale;
@@ -43,48 +19,48 @@ class ReferenceLoader {
         else {
             // Resolve the data directory relative to this file's location
             // Use __dirname which works correctly after compilation
-            this.dataDir = path.join(__dirname, 'data');
+            this.dataDir = (0, io_1.getPath)().join(__dirname, 'data');
         }
     }
     /**
      * Load core vocabulary lists
      */
     loadCoreLists() {
-        const filePath = path.join(this.dataDir, `core_lists.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `core_lists.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        return JSON.parse(String(content));
     }
     /**
      * Load common words with baseline effort scores
      */
     loadCommonWords() {
-        const filePath = path.join(this.dataDir, `common_words.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `common_words.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        return JSON.parse(String(content));
     }
     /**
      * Load synonym mappings
      */
     loadSynonyms() {
-        const filePath = path.join(this.dataDir, `synonyms.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `synonyms.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        return JSON.parse(String(content));
     }
     /**
      * Load test sentences
      */
     loadSentences() {
-        const filePath = path.join(this.dataDir, `sentences.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `sentences.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        return JSON.parse(String(content));
     }
     /**
      * Load fringe vocabulary
      */
     loadFringe() {
-        const filePath = path.join(this.dataDir, `fringe.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `fringe.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(String(content));
         // Flatten nested category words if needed
         if (Array.isArray(data) && data.length > 0 && data[0].categories) {
             const flattened = [];
@@ -101,9 +77,9 @@ class ReferenceLoader {
      * Load base words hash map
      */
     loadBaseWords() {
-        const filePath = path.join(this.dataDir, `base_words.${this.locale}.json`);
-        const content = fs.readFileSync(filePath, 'utf-8');
-        return JSON.parse(content);
+        const filePath = (0, io_1.getPath)().join(this.dataDir, `base_words.${this.locale}.json`);
+        const content = (0, io_1.getFs)().readFileSync(filePath, 'utf-8');
+        return JSON.parse(String(content));
     }
     /**
      * Load common fringe vocabulary
@@ -141,7 +117,7 @@ exports.ReferenceLoader = ReferenceLoader;
  * Get the default reference data path
  */
 function getReferenceDataPath() {
-    return path.join(__dirname, 'data');
+    return String((0, io_1.getPath)().join(__dirname, 'data'));
 }
 /**
  * Check if reference data files exist
@@ -155,5 +131,5 @@ function hasReferenceData() {
         'synonyms.en.json',
         'fringe.en.json',
     ];
-    return requiredFiles.every((file) => fs.existsSync(path.join(dataPath, file)));
+    return requiredFiles.every((file) => (0, io_1.getFs)().existsSync((0, io_1.getPath)().join(dataPath, file)));
 }

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);
             }