@willwade/aac-processors 0.1.0 → 0.1.1

package/dist/browser/processors/gridset/password.js

@@ -1,4 +1,9 @@
-import path from 'path';
+function getExtension(source) {
+    const index = source.lastIndexOf('.');
+    if (index === -1)
+        return '';
+    return source.slice(index);
+}
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
@@ -8,17 +13,18 @@ import path from 'path';
 export function resolveGridsetPassword(options, source) {
     if (options?.gridsetPassword)
         return options.gridsetPassword;
-    if (process.env.GRIDSET_PASSWORD)
-        return process.env.GRIDSET_PASSWORD;
+    const envPassword = typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
+    if (envPassword)
+        return envPassword;
     if (typeof source === 'string') {
-        const ext = path.extname(source).toLowerCase();
+        const ext = getExtension(source).toLowerCase();
         if (ext === '.gridsetx')
-            return process.env.GRIDSET_PASSWORD;
+            return envPassword;
     }
     return undefined;
 }
 export function resolveGridsetPasswordFromEnv() {
-    return process.env.GRIDSET_PASSWORD;
+    return typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
 }
 export function getZipEntriesWithPassword(zip, password) {
     const entries = [];

package/dist/browser/processors/gridset/symbols.js

@@ -12,9 +12,7 @@
  *
  * This module provides symbol resolution and metadata extraction.
  */
-import * as fs from 'fs';
-import * as path from 'path';
-import AdmZip from 'adm-zip';
+import { getFs, getPath } from '../../utils/io';
 /**
  * Default Grid 3 installation paths by platform
  */
@@ -57,6 +55,37 @@ export const SYMBOL_LIBRARIES = {
  * Default locale to use
  */
 export const DEFAULT_LOCALE = 'en-GB';
+function getNodeFs() {
+    try {
+        return getFs();
+    }
+    catch {
+        throw new Error('Symbol library access is not available in this environment.');
+    }
+}
+function getNodePath() {
+    try {
+        return getPath();
+    }
+    catch {
+        throw new Error('Path utilities are not available in this environment.');
+    }
+}
+let cachedAdmZip = null;
+function getAdmZip() {
+    if (cachedAdmZip)
+        return cachedAdmZip;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const module = require('adm-zip');
+        const resolved = module.default || module;
+        cachedAdmZip = resolved;
+        return resolved;
+    }
+    catch {
+        throw new Error('Symbol library access requires AdmZip in this environment.');
+    }
+}
 /**
  * Parse a symbol reference string
  * @param reference - Symbol reference like "[widgit]/food/apple.png"
@@ -95,24 +124,30 @@ export function isSymbolReference(reference) {
  * @returns Default Grid 3 path or empty string if not found
  */
 export function getDefaultGrid3Path() {
-    const platform = process.platform;
+    const platform = (typeof process !== 'undefined' && process.platform ? process.platform : 'unknown');
     const defaultPath = DEFAULT_GRID3_PATHS[platform] || '';
-    if (defaultPath && fs.existsSync(defaultPath)) {
-        return defaultPath;
-    }
-    // Try to find Grid 3 in common locations
-    const commonPaths = [
-        'C:\\Program Files (x86)\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        '/Applications/Grid 3.app',
-        '/opt/smartbox/grid3',
-    ];
-    for (const testPath of commonPaths) {
-        if (fs.existsSync(testPath)) {
-            return testPath;
+    try {
+        const fs = getNodeFs();
+        if (defaultPath && fs.existsSync(defaultPath)) {
+            return defaultPath;
+        }
+        // Try to find Grid 3 in common locations
+        const commonPaths = [
+            'C:\\Program Files (x86)\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            '/Applications/Grid 3.app',
+            '/opt/smartbox/grid3',
+        ];
+        for (const testPath of commonPaths) {
+            if (fs.existsSync(testPath)) {
+                return testPath;
+            }
         }
     }
+    catch {
+        return '';
+    }
     return '';
 }
 /**
@@ -122,6 +157,7 @@ export function getDefaultGrid3Path() {
  * @returns Path to Symbol Libraries directory (e.g., "C:\...\Grid 3\Resources\Symbols")
  */
 export function getSymbolLibrariesDir(grid3Path) {
+    const path = getNodePath();
     return path.join(grid3Path, SYMBOLS_SUBDIR);
 }
 /**
@@ -132,6 +168,7 @@ export function getSymbolLibrariesDir(grid3Path) {
  * @returns Path to symbol search indexes directory (e.g., "C:\...\Grid 3\Locale\en-GB\symbolsearch")
  */
 export function getSymbolSearchIndexesDir(grid3Path, locale = DEFAULT_LOCALE) {
+    const path = getNodePath();
     return path.join(grid3Path, SYMBOLSEARCH_SUBDIR, locale, 'symbolsearch');
 }
 /**
@@ -145,6 +182,7 @@ export function getAvailableSymbolLibraries(options = {}) {
         return [];
     }
     const symbolsDir = getSymbolLibrariesDir(grid3Path);
+    const fs = getNodeFs();
     if (!fs.existsSync(symbolsDir)) {
         return [];
     }
@@ -152,6 +190,7 @@ export function getAvailableSymbolLibraries(options = {}) {
     const files = fs.readdirSync(symbolsDir);
     for (const file of files) {
         if (file.endsWith('.symbols')) {
+            const path = getNodePath();
             const fullPath = path.join(symbolsDir, file);
             const stats = fs.statSync(fullPath);
             const libraryName = path.basename(file, '.symbols');
@@ -186,7 +225,9 @@ export function getSymbolLibraryInfo(libraryName, options = {}) {
         libraryName + '.symbols',
     ];
     for (const file of variations) {
+        const path = getNodePath();
         const fullPath = path.join(symbolsDir, file);
+        const fs = getNodeFs();
         if (fs.existsSync(fullPath)) {
             const stats = fs.statSync(fullPath);
             return {
@@ -233,6 +274,7 @@ export function resolveSymbolReference(reference, options = {}) {
     }
     try {
         // .symbols files are ZIP archives
+        const AdmZip = getAdmZip();
         const zip = new AdmZip(libraryInfo.pixFile);
         // The path in the symbol reference becomes the path within the symbols/ folder
         // e.g., [tawasl]/above bw.png becomes symbols/above bw.png
@@ -398,7 +440,8 @@ export function analyzeSymbolUsage(tree) {
  */
 export function symbolReferenceToFilename(reference, cellX, cellY) {
     const parsed = parseSymbolReference(reference);
-    const ext = path.extname(parsed.path) || '.png';
+    const dotIndex = parsed.path.lastIndexOf('.');
+    const ext = dotIndex >= 0 ? parsed.path.slice(dotIndex) : '.png';
     // Grid 3 format: {x}-{y}-0-text-0.{ext}
     return `${cellX}-${cellY}-0-text-0${ext}`;
 }

package/dist/browser/validation/gridsetValidator.js

@@ -1,11 +1,10 @@
 /* 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 JSZip from 'jszip';
 import { BaseValidator } from './baseValidator';
+import { getFs, getPath } from '../utils/io';
 /**
  * Validator for Grid3/Smartbox Gridset files (.gridset, .gridsetx)
  */
@@ -18,6 +17,8 @@ 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);

package/dist/processors/gridset/password.js

@@ -1,12 +1,14 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveGridsetPassword = resolveGridsetPassword;
 exports.resolveGridsetPasswordFromEnv = resolveGridsetPasswordFromEnv;
 exports.getZipEntriesWithPassword = getZipEntriesWithPassword;
-const path_1 = __importDefault(require("path"));
+function getExtension(source) {
+    const index = source.lastIndexOf('.');
+    if (index === -1)
+        return '';
+    return source.slice(index);
+}
 /**
  * Resolve the password to use for Grid3 archives.
  * Preference order:
@@ -16,17 +18,18 @@ const path_1 = __importDefault(require("path"));
 function resolveGridsetPassword(options, source) {
     if (options?.gridsetPassword)
         return options.gridsetPassword;
-    if (process.env.GRIDSET_PASSWORD)
-        return process.env.GRIDSET_PASSWORD;
+    const envPassword = typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
+    if (envPassword)
+        return envPassword;
     if (typeof source === 'string') {
-        const ext = path_1.default.extname(source).toLowerCase();
+        const ext = getExtension(source).toLowerCase();
         if (ext === '.gridsetx')
-            return process.env.GRIDSET_PASSWORD;
+            return envPassword;
     }
     return undefined;
 }
 function resolveGridsetPasswordFromEnv() {
-    return process.env.GRIDSET_PASSWORD;
+    return typeof process !== 'undefined' ? process.env?.GRIDSET_PASSWORD : undefined;
 }
 function getZipEntriesWithPassword(zip, password) {
     const entries = [];

package/dist/processors/gridset/symbols.js

@@ -13,32 +13,6 @@
  *
  * This module provides symbol resolution and metadata extraction.
  */
-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.DEFAULT_LOCALE = exports.SYMBOL_LIBRARIES = void 0;
 exports.parseSymbolReference = parseSymbolReference;
@@ -59,9 +33,7 @@ exports.analyzeSymbolUsage = analyzeSymbolUsage;
 exports.symbolReferenceToFilename = symbolReferenceToFilename;
 exports.getSymbolsDir = getSymbolsDir;
 exports.getSymbolSearchDir = getSymbolSearchDir;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const adm_zip_1 = __importDefault(require("adm-zip"));
+const io_1 = require("../../utils/io");
 /**
  * Default Grid 3 installation paths by platform
  */
@@ -104,6 +76,37 @@ exports.SYMBOL_LIBRARIES = {
  * Default locale to use
  */
 exports.DEFAULT_LOCALE = 'en-GB';
+function getNodeFs() {
+    try {
+        return (0, io_1.getFs)();
+    }
+    catch {
+        throw new Error('Symbol library access is not available in this environment.');
+    }
+}
+function getNodePath() {
+    try {
+        return (0, io_1.getPath)();
+    }
+    catch {
+        throw new Error('Path utilities are not available in this environment.');
+    }
+}
+let cachedAdmZip = null;
+function getAdmZip() {
+    if (cachedAdmZip)
+        return cachedAdmZip;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const module = require('adm-zip');
+        const resolved = module.default || module;
+        cachedAdmZip = resolved;
+        return resolved;
+    }
+    catch {
+        throw new Error('Symbol library access requires AdmZip in this environment.');
+    }
+}
 /**
  * Parse a symbol reference string
  * @param reference - Symbol reference like "[widgit]/food/apple.png"
@@ -142,23 +145,29 @@ function isSymbolReference(reference) {
  * @returns Default Grid 3 path or empty string if not found
  */
 function getDefaultGrid3Path() {
-    const platform = process.platform;
+    const platform = (typeof process !== 'undefined' && process.platform ? process.platform : 'unknown');
     const defaultPath = DEFAULT_GRID3_PATHS[platform] || '';
-    if (defaultPath && fs.existsSync(defaultPath)) {
-        return defaultPath;
-    }
-    // Try to find Grid 3 in common locations
-    const commonPaths = [
-        'C:\\Program Files (x86)\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        'C:\\Program Files\\Smartbox\\Grid 3',
-        '/Applications/Grid 3.app',
-        '/opt/smartbox/grid3',
-    ];
-    for (const testPath of commonPaths) {
-        if (fs.existsSync(testPath)) {
-            return testPath;
+    try {
+        const fs = getNodeFs();
+        if (defaultPath && fs.existsSync(defaultPath)) {
+            return defaultPath;
         }
+        // Try to find Grid 3 in common locations
+        const commonPaths = [
+            'C:\\Program Files (x86)\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            'C:\\Program Files\\Smartbox\\Grid 3',
+            '/Applications/Grid 3.app',
+            '/opt/smartbox/grid3',
+        ];
+        for (const testPath of commonPaths) {
+            if (fs.existsSync(testPath)) {
+                return testPath;
+            }
+        }
+    }
+    catch {
+        return '';
     }
     return '';
 }
@@ -169,6 +178,7 @@ function getDefaultGrid3Path() {
  * @returns Path to Symbol Libraries directory (e.g., "C:\...\Grid 3\Resources\Symbols")
  */
 function getSymbolLibrariesDir(grid3Path) {
+    const path = getNodePath();
     return path.join(grid3Path, SYMBOLS_SUBDIR);
 }
 /**
@@ -179,6 +189,7 @@ function getSymbolLibrariesDir(grid3Path) {
  * @returns Path to symbol search indexes directory (e.g., "C:\...\Grid 3\Locale\en-GB\symbolsearch")
  */
 function getSymbolSearchIndexesDir(grid3Path, locale = exports.DEFAULT_LOCALE) {
+    const path = getNodePath();
     return path.join(grid3Path, SYMBOLSEARCH_SUBDIR, locale, 'symbolsearch');
 }
 /**
@@ -192,6 +203,7 @@ function getAvailableSymbolLibraries(options = {}) {
         return [];
     }
     const symbolsDir = getSymbolLibrariesDir(grid3Path);
+    const fs = getNodeFs();
     if (!fs.existsSync(symbolsDir)) {
         return [];
     }
@@ -199,6 +211,7 @@ function getAvailableSymbolLibraries(options = {}) {
     const files = fs.readdirSync(symbolsDir);
     for (const file of files) {
         if (file.endsWith('.symbols')) {
+            const path = getNodePath();
             const fullPath = path.join(symbolsDir, file);
             const stats = fs.statSync(fullPath);
             const libraryName = path.basename(file, '.symbols');
@@ -233,7 +246,9 @@ function getSymbolLibraryInfo(libraryName, options = {}) {
         libraryName + '.symbols',
     ];
     for (const file of variations) {
+        const path = getNodePath();
         const fullPath = path.join(symbolsDir, file);
+        const fs = getNodeFs();
         if (fs.existsSync(fullPath)) {
             const stats = fs.statSync(fullPath);
             return {
@@ -280,7 +295,8 @@ function resolveSymbolReference(reference, options = {}) {
     }
     try {
         // .symbols files are ZIP archives
-        const zip = new adm_zip_1.default(libraryInfo.pixFile);
+        const AdmZip = getAdmZip();
+        const zip = new AdmZip(libraryInfo.pixFile);
         // The path in the symbol reference becomes the path within the symbols/ folder
         // e.g., [tawasl]/above bw.png becomes symbols/above bw.png
         const symbolPath = `symbols/${parsed.path}`;
@@ -445,7 +461,8 @@ function analyzeSymbolUsage(tree) {
  */
 function symbolReferenceToFilename(reference, cellX, cellY) {
     const parsed = parseSymbolReference(reference);
-    const ext = path.extname(parsed.path) || '.png';
+    const dotIndex = parsed.path.lastIndexOf('.');
+    const ext = dotIndex >= 0 ? parsed.path.slice(dotIndex) : '.png';
     // Grid 3 format: {x}-{y}-0-text-0.{ext}
     return `${cellX}-${cellY}-0-text-0${ext}`;
 }

package/dist/validation/gridsetValidator.js

@@ -30,11 +30,10 @@ exports.GridsetValidator = 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 jszip_1 = __importDefault(require("jszip"));
 const baseValidator_1 = require("./baseValidator");
+const io_1 = require("../utils/io");
 /**
  * Validator for Grid3/Smartbox Gridset files (.gridset, .gridsetx)
  */
@@ -47,6 +46,8 @@ 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);

package/docs/PAGESET_GETTING_STARTED.md

@@ -0,0 +1,185 @@
+# AAC Pageset Quickstart (Node + Browser)
+
+This guide shows two simple ways to generate or convert AAC pagesets using `aac-processors`:
+
+- Node.js: full conversion between formats (read + write)
+- Browser: generate or export to OBF/OBZ in-memory (downloadable)
+
+If you need lossless conversion in the browser, use a Node/worker service for the save step (file I/O is required for most formats).
+
+## Node.js: Convert and Generate Pagesets
+
+### Install
+
+```bash
+npm install aac-processors
+```
+
+### Convert a Gridset to OBF
+
+```ts
+import { getProcessor, ObfProcessor } from 'aac-processors';
+
+async function convertGridsetToObf() {
+  const sourcePath = './input/example.gridset';
+  const targetPath = './output/example.obf';
+
+  const sourceProcessor = getProcessor(sourcePath); // GridsetProcessor
+  const tree = await sourceProcessor.loadIntoTree(sourcePath);
+
+  const obf = new ObfProcessor();
+  await obf.saveFromTree(tree, targetPath);
+
+  console.log('Saved:', targetPath);
+}
+
+convertGridsetToObf().catch(console.error);
+```
+
+### Generate a Simple Pageset and Save as OBZ
+
+```ts
+import { AACTree, AACPage, AACButton, ObfProcessor } from 'aac-processors';
+
+async function generateObz() {
+  const tree = new AACTree();
+  tree.metadata = { name: 'Starter Demo', locale: 'en' };
+
+  const hello = new AACButton({ id: 'hello', label: 'Hello', message: 'Hello' });
+  const thanks = new AACButton({ id: 'thanks', label: 'Thanks', message: 'Thank you' });
+
+  const home = new AACPage({
+    id: 'home',
+    name: 'Home',
+    buttons: [hello, thanks],
+    grid: [[hello, thanks]],
+  });
+
+  tree.addPage(home);
+  tree.rootId = 'home';
+
+  const obf = new ObfProcessor();
+  await obf.saveFromTree(tree, './output/starter.obz');
+
+  console.log('Saved: ./output/starter.obz');
+}
+
+generateObz().catch(console.error);
+```
+
+## Browser: Generate or Convert to OBF/OBZ
+
+In the browser you can still parse files and build an `AACTree`, but most processors cannot write to disk (no `fs`).
+The example below generates an `AACTree`, converts it to OBF JSON in-memory, and downloads it.
+
+If you need full conversions in a browser app, do the save step in Node (server or worker).
+
+### Generate a Pageset and Download as OBF
+
+```ts
+import { AACTree, AACPage, AACButton, ObfProcessor } from 'aac-processors';
+
+function downloadBlob(data: BlobPart, filename: string, type: string) {
+  const blob = new Blob([data], { type });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+
+function buildSampleTree() {
+  const tree = new AACTree();
+  tree.metadata = { name: 'Browser Demo', locale: 'en' };
+
+  const hello = new AACButton({ id: 'hello', label: 'Hello', message: 'Hello' });
+  const yes = new AACButton({ id: 'yes', label: 'Yes', message: 'Yes' });
+
+  const home = new AACPage({
+    id: 'home',
+    name: 'Home',
+    buttons: [hello, yes],
+    grid: [[hello, yes]],
+  });
+
+  tree.addPage(home);
+  tree.rootId = 'home';
+  return tree;
+}
+
+async function exportObf(tree: AACTree) {
+  // This mirrors the browser demo approach: create OBF JSON and download.
+  // ObfProcessor.saveFromTree writes to disk, so we build a board in-memory.
+  const obf = new ObfProcessor() as ObfProcessor & {
+    createObfBoardFromPage?: (page: AACPage, fallbackName: string, metadata?: AACTree['metadata']) => any;
+  };
+
+  const rootPage = tree.rootId ? tree.getPage(tree.rootId) : Object.values(tree.pages)[0];
+  const board = obf.createObfBoardFromPage
+    ? obf.createObfBoardFromPage(rootPage!, 'Board', tree.metadata)
+    : {
+        format: 'open-board-0.1',
+        id: rootPage?.id ?? 'board',
+        name: rootPage?.name ?? 'Board',
+        locale: tree.metadata?.locale || 'en',
+        grid: { rows: 1, columns: rootPage?.buttons.length ?? 0, order: [] },
+        buttons: (rootPage?.buttons || []).map((button) => ({
+          id: button.id,
+          label: button.label,
+          vocalization: button.message || button.label,
+        })),
+      };
+
+  const json = JSON.stringify(board, null, 2);
+  downloadBlob(json, 'browser-demo.obf', 'application/json');
+}
+
+const tree = buildSampleTree();
+exportObf(tree);
+```
+
+### Convert an Uploaded Pageset to OBZ (Browser)
+
+This uses the same idea as the Vite demo: parse any supported file into a tree,
+then export OBF/OBZ in-memory and download.
+
+```ts
+import { getProcessor, ObfProcessor, type AACTree, type AACPage } from 'aac-processors';
+import JSZip from 'jszip';
+
+async function convertToObz(file: File) {
+  const extension = '.' + file.name.split('.').pop();
+  const processor = getProcessor(extension);
+  const buffer = await file.arrayBuffer();
+  const tree = await processor.loadIntoTree(buffer);
+
+  const obf = new ObfProcessor() as ObfProcessor & {
+    createObfBoardFromPage?: (page: AACPage, fallbackName: string, metadata?: AACTree['metadata']) => any;
+  };
+
+  const zip = new JSZip();
+  Object.values(tree.pages).forEach((page) => {
+    const board = obf.createObfBoardFromPage
+      ? obf.createObfBoardFromPage(page, 'Board', tree.metadata)
+      : { format: 'open-board-0.1', id: page.id, name: page.name, grid: { rows: 0, columns: 0, order: [] }, buttons: [] };
+    zip.file(`${page.id}.obf`, JSON.stringify(board, null, 2));
+  });
+
+  const data = await zip.generateAsync({ type: 'uint8array' });
+  const blob = new Blob([data], { type: 'application/zip' });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = 'converted.obz';
+  a.click();
+  URL.revokeObjectURL(url);
+}
+```
+
+## Tips
+
+- Use `loadIntoTree()` to normalize different AAC formats into one structure.
+- In Node, `saveFromTree()` lets you write to OBF, OBZ, Gridset, etc.
+- In the browser, build the output in memory and offer it for download.
+- For full-fidelity conversions in the browser, use a server-side endpoint to save files.

package/examples/vitedemo/QUICKSTART.md

@@ -40,6 +40,7 @@ The `test-files/` folder contains example AAC files you can use:
 - **Navigation**: Click NAVIGATE buttons to jump between pages
 - **Stats**: See page/button/text counts and load time
 - **Logs**: Watch the processing log in real-time
+- **Pageset Lab**: Open the "Create & Convert" tab to generate a sample pageset or convert an upload to OBF/OBZ
 
 ## 🛠️ Development
 

package/examples/vitedemo/index.html

@@ -63,6 +63,39 @@
             border-bottom: 2px solid #667eea;
         }
 
+        .tab-header {
+            display: flex;
+            gap: 8px;
+            margin-bottom: 15px;
+        }
+
+        .tab-btn {
+            flex: 1;
+            border: 1px solid #d6daf5;
+            background: #f7f8ff;
+            color: #3d4bb8;
+            padding: 8px 12px;
+            border-radius: 8px;
+            font-size: 13px;
+            font-weight: 600;
+            cursor: pointer;
+            transition: all 0.2s;
+        }
+
+        .tab-btn.active {
+            background: #667eea;
+            color: #fff;
+            border-color: #667eea;
+        }
+
+        .tab-content {
+            display: none;
+        }
+
+        .tab-content.active {
+            display: block;
+        }
+
         .upload-area {
             border: 2px dashed #ccc;
             border-radius: 8px;
@@ -290,6 +323,83 @@
             font-size: 13px;
         }
 
+        .demo-section {
+            background: #f8f9ff;
+            border-radius: 10px;
+            padding: 15px;
+            border: 1px solid #e4e7ff;
+            margin-bottom: 15px;
+        }
+
+        .section-title {
+            font-size: 14px;
+            font-weight: 700;
+            color: #3942a3;
+            margin-bottom: 10px;
+        }
+
+        .field {
+            display: flex;
+            flex-direction: column;
+            gap: 6px;
+            margin-bottom: 10px;
+            font-size: 12px;
+            color: #4d4d4d;
+        }
+
+        .field select,
+        .field input {
+            border: 1px solid #d7d9f5;
+            border-radius: 6px;
+            padding: 8px 10px;
+            font-size: 13px;
+        }
+
+        .action-row {
+            display: flex;
+            gap: 10px;
+        }
+
+        .action-row .btn {
+            margin-bottom: 0;
+        }
+
+        .hint {
+            font-size: 12px;
+            color: #667;
+            margin-top: 8px;
+        }
+
+        .status-pill {
+            margin-top: 10px;
+            font-size: 12px;
+            padding: 8px 10px;
+            border-radius: 8px;
+            background: #eef0ff;
+            color: #4a4a8a;
+        }
+
+        .status-pill.success {
+            background: #e0f4e7;
+            color: #256d3b;
+        }
+
+        .status-pill.warn {
+            background: #fff4d6;
+            color: #7a5a00;
+        }
+
+        .code-preview {
+            background: #0f172a;
+            color: #d7e3ff;
+            padding: 12px;
+            border-radius: 8px;
+            font-size: 12px;
+            max-height: 220px;
+            overflow: auto;
+            white-space: pre-wrap;
+        }
+
         @media (max-width: 1024px) {
             .main-grid {
                 grid-template-columns: 1fr;
@@ -361,11 +471,56 @@
 
             <!-- Right Panel: Results -->
             <div class="panel results-panel">
-                <div class="panel-title">📊 File Contents</div>
-                <div id="results">
-                    <p style="color: #999; text-align: center; padding: 40px;">
-                        Load a file to see its contents here
-                    </p>
+                <div class="panel-title">📊 AAC Pageset Lab</div>
+                <div class="tab-header">
+                    <button class="tab-btn active" data-tab="inspectTab">Inspect</button>
+                    <button class="tab-btn" data-tab="pagesetTab">Create & Convert</button>
+                </div>
+                <div class="tab-content active" id="inspectTab">
+                    <div id="results">
+                        <p style="color: #999; text-align: center; padding: 40px;">
+                            Load a file to see its contents here
+                        </p>
+                    </div>
+                </div>
+                <div class="tab-content" id="pagesetTab">
+                    <div class="demo-section">
+                        <div class="section-title">✨ Create a Sample Pageset</div>
+                        <div class="field">
+                            <label for="templateSelect">Template</label>
+                            <select id="templateSelect">
+                                <option value="starter">Starter 2x2 + Feelings</option>
+                                <option value="home">Home & Core 3x3</option>
+                            </select>
+                        </div>
+                        <div class="field">
+                            <label for="formatSelect">Output format</label>
+                            <select id="formatSelect">
+                                <option value="obf">OBF (.obf)</option>
+                                <option value="obz">OBZ (.obz)</option>
+                            </select>
+                        </div>
+                        <div class="action-row">
+                            <button class="btn" id="createPagesetBtn">Generate & Download</button>
+                            <button class="btn btn-secondary" id="previewPagesetBtn">Preview in Viewer</button>
+                        </div>
+                        <div class="hint">Creates a demo AACTree, then exports to OBF/OBZ.</div>
+                    </div>
+
+                    <div class="demo-section">
+                        <div class="section-title">🔁 Convert Loaded Pageset</div>
+                        <div class="action-row">
+                            <button class="btn" id="convertToObfBtn" disabled>Download .obf</button>
+                            <button class="btn btn-secondary" id="convertToObzBtn" disabled>Download .obz</button>
+                        </div>
+                        <div class="hint">Upload and process a file first, then export it in another format.</div>
+                        <div class="status-pill" id="conversionStatus">No pageset loaded yet.</div>
+                    </div>
+
+                    <div class="demo-section">
+                        <div class="section-title">📄 Export Preview</div>
+                        <pre class="code-preview" id="pagesetOutput">Generate or convert a pageset to preview the output JSON.</pre>
+                    </div>
                 </div>
             </div>
         </div>

package/examples/vitedemo/src/main.ts

@@ -74,9 +74,9 @@ import {
   GridsetProcessor,
   ApplePanelsProcessor,
   AstericsGridProcessor,
-  type AACTree,
-  type AACPage,
-  type AACButton
+  AACTree,
+  AACPage,
+  AACButton
 } from 'aac-processors';
 
 // UI Elements
@@ -93,11 +93,38 @@ 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 tabButtons = document.querySelectorAll('.tab-btn') as NodeListOf<HTMLButtonElement>;
+const inspectTab = document.getElementById('inspectTab') as HTMLElement;
+const pagesetTab = document.getElementById('pagesetTab') as HTMLElement;
+const templateSelect = document.getElementById('templateSelect') as HTMLSelectElement;
+const formatSelect = document.getElementById('formatSelect') as HTMLSelectElement;
+const createPagesetBtn = document.getElementById('createPagesetBtn') as HTMLButtonElement;
+const previewPagesetBtn = document.getElementById('previewPagesetBtn') as HTMLButtonElement;
+const convertToObfBtn = document.getElementById('convertToObfBtn') as HTMLButtonElement;
+const convertToObzBtn = document.getElementById('convertToObzBtn') as HTMLButtonElement;
+const conversionStatus = document.getElementById('conversionStatus') as HTMLElement;
+const pagesetOutput = document.getElementById('pagesetOutput') as HTMLElement;
 
 // State
 let currentFile: File | null = null;
 let currentProcessor: any = null;
 let currentTree: AACTree | null = null;
+let currentSourceLabel = 'pageset';
+
+// Tabs
+function setActiveTab(tabId: string) {
+  tabButtons.forEach((btn) => {
+    btn.classList.toggle('active', btn.dataset.tab === tabId);
+  });
+  inspectTab.classList.toggle('active', tabId === 'inspectTab');
+  pagesetTab.classList.toggle('active', tabId === 'pagesetTab');
+}
+
+tabButtons.forEach((btn) => {
+  btn.addEventListener('click', () => {
+    setActiveTab(btn.dataset.tab || 'inspectTab');
+  });
+});
 
 // Logging
 function log(message: string, type: 'info' | 'success' | 'error' | 'warn' = 'info') {
@@ -109,6 +136,52 @@ function log(message: string, type: 'info' | 'success' | 'error' | 'warn' = 'inf
   console.log(`[${type.toUpperCase()}]`, message);
 }
 
+function setConversionStatus(message: string, state: 'success' | 'warn' | 'info' = 'info') {
+  conversionStatus.textContent = message;
+  conversionStatus.classList.remove('success', 'warn');
+  if (state !== 'info') {
+    conversionStatus.classList.add(state);
+  }
+}
+
+function updateConvertButtons() {
+  const hasTree = !!currentTree;
+  convertToObfBtn.disabled = !hasTree;
+  convertToObzBtn.disabled = !hasTree;
+  if (!hasTree) {
+    setConversionStatus('No pageset loaded yet.', 'info');
+  } else {
+    setConversionStatus(`Ready to export: ${currentSourceLabel}`, 'success');
+  }
+}
+
+function updateStatsForTree(tree: AACTree, textCount?: number, loadTimeMs?: number) {
+  const pageCount = Object.keys(tree.pages).length;
+  const buttonCount = Object.values(tree.pages).reduce(
+    (sum: number, page: AACPage) => sum + page.buttons.length,
+    0
+  );
+
+  document.getElementById('pageCount')!.textContent = pageCount.toString();
+  document.getElementById('buttonCount')!.textContent = buttonCount.toString();
+  document.getElementById('textCount')!.textContent = (textCount ?? 0).toString();
+  document.getElementById('loadTime')!.textContent =
+    loadTimeMs !== undefined ? `${loadTimeMs.toFixed(0)}ms` : '—';
+  stats.style.display = 'grid';
+}
+
+function collectTextCount(tree: AACTree): number {
+  const texts = new Set<string>();
+  Object.values(tree.pages).forEach((page) => {
+    if (page.name) texts.add(page.name);
+    page.buttons.forEach((button) => {
+      if (button.label) texts.add(button.label);
+      if (button.message) texts.add(button.message);
+    });
+  });
+  return texts.size;
+}
+
 // Get file extension
 function getFileExtension(filename: string): string {
   const match = filename.toLowerCase().match(/\.\w+$/);
@@ -146,6 +219,7 @@ function handleFile(file: File) {
     fileDetails.textContent = `${file.name} • ${formatFileSize(file.size)}`;
     fileInfo.style.display = 'block';
     processBtn.disabled = false;
+    currentSourceLabel = file.name;
 
     log(`Using processor: ${currentProcessor.constructor.name}`, 'success');
   } catch (error) {
@@ -213,22 +287,13 @@ processBtn.addEventListener('click', async () => {
     log(`Extracted ${texts.length} texts`, 'success');
 
     // Update stats
-    const pageCount = Object.keys(currentTree.pages).length;
-    const buttonCount = Object.values(currentTree.pages).reduce(
-      (sum: number, page: AACPage) => sum + page.buttons.length,
-      0
-    );
-
-    document.getElementById('pageCount')!.textContent = pageCount.toString();
-    document.getElementById('buttonCount')!.textContent = buttonCount.toString();
-    document.getElementById('textCount')!.textContent = texts.length.toString();
-    document.getElementById('loadTime')!.textContent = `${loadTime.toFixed(0)}ms`;
-    stats.style.display = 'grid';
+    updateStatsForTree(currentTree, texts.length, loadTime);
 
     // Display results
     displayResults(currentTree);
+    updateConvertButtons();
 
-    log(`✅ Successfully processed ${pageCount} pages with ${buttonCount} buttons`, 'success');
+    log(`✅ Successfully processed ${Object.keys(currentTree.pages).length} pages`, 'success');
   } catch (error) {
     const errorMsg = (error as Error).message;
     log(`❌ Error: ${errorMsg}`, 'error');
@@ -343,12 +408,299 @@ clearBtn.addEventListener('click', () => {
   currentFile = null;
   currentProcessor = null;
   currentTree = null;
+  currentSourceLabel = 'pageset';
   fileInput.value = '';
   fileInfo.style.display = 'none';
   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';
   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();
+});
+
+function sanitizeFilename(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/(^-|-$)/g, '') || 'pageset';
+}
+
+function buildSampleTree(template: string): AACTree {
+  const tree = new AACTree();
+  tree.metadata = {
+    name: template === 'home' ? 'Home & Core Demo' : 'Starter Demo',
+    description: 'Generated in the AAC Processors browser demo',
+    locale: 'en',
+  };
+
+  if (template === 'home') {
+    const hello = new AACButton({ id: 'hello', label: 'Hello', message: 'Hello', action: { type: 'SPEAK' } });
+    const want = new AACButton({ id: 'want', label: 'I want', message: 'I want', action: { type: 'SPEAK' } });
+    const help = new AACButton({ id: 'help', label: 'Help', message: 'Help', action: { type: 'SPEAK' } });
+    const more = new AACButton({
+      id: 'more',
+      label: 'More',
+      targetPageId: 'core',
+      action: { type: 'NAVIGATE', targetPageId: 'core' },
+    });
+    const yes = new AACButton({ id: 'yes', label: 'Yes', message: 'Yes', action: { type: 'SPEAK' } });
+    const no = new AACButton({ id: 'no', label: 'No', message: 'No', action: { type: 'SPEAK' } });
+    const stop = new AACButton({ id: 'stop', label: 'Stop', message: 'Stop', action: { type: 'SPEAK' } });
+    const go = new AACButton({ id: 'go', label: 'Go', message: 'Go', action: { type: 'SPEAK' } });
+    const food = new AACButton({
+      id: 'food',
+      label: 'Food',
+      targetPageId: 'food',
+      action: { type: 'NAVIGATE', targetPageId: 'food' },
+    });
+
+    const homePage = new AACPage({
+      id: 'home',
+      name: 'Home',
+      buttons: [hello, want, help, more, yes, no, stop, go, food],
+      grid: [
+        [hello, want, help],
+        [more, yes, no],
+        [stop, go, food],
+      ],
+    });
+
+    const hungry = new AACButton({ id: 'hungry', label: 'Hungry', message: 'I am hungry', action: { type: 'SPEAK' } });
+    const drink = new AACButton({ id: 'drink', label: 'Drink', message: 'I want a drink', action: { type: 'SPEAK' } });
+    const snack = new AACButton({ id: 'snack', label: 'Snack', message: 'Snack', action: { type: 'SPEAK' } });
+    const backFood = new AACButton({
+      id: 'back-food',
+      label: 'Back',
+      targetPageId: 'home',
+      action: { type: 'NAVIGATE', targetPageId: 'home' },
+    });
+
+    const foodPage = new AACPage({
+      id: 'food',
+      name: 'Food',
+      buttons: [hungry, drink, snack, backFood],
+      grid: [
+        [hungry, drink],
+        [snack, backFood],
+      ],
+    });
+
+    const coreYes = new AACButton({ id: 'core-yes', label: 'Yes', message: 'Yes', action: { type: 'SPEAK' } });
+    const coreNo = new AACButton({ id: 'core-no', label: 'No', message: 'No', action: { type: 'SPEAK' } });
+    const coreStop = new AACButton({ id: 'core-stop', label: 'Stop', message: 'Stop', action: { type: 'SPEAK' } });
+    const coreGo = new AACButton({ id: 'core-go', label: 'Go', message: 'Go', action: { type: 'SPEAK' } });
+    const backCore = new AACButton({
+      id: 'back-core',
+      label: 'Back',
+      targetPageId: 'home',
+      action: { type: 'NAVIGATE', targetPageId: 'home' },
+    });
+
+    const corePage = new AACPage({
+      id: 'core',
+      name: 'Core Words',
+      buttons: [coreYes, coreNo, coreStop, coreGo, backCore],
+      grid: [
+        [coreYes, coreNo],
+        [coreStop, coreGo],
+        [backCore, null],
+      ],
+    });
+
+    tree.addPage(homePage);
+    tree.addPage(corePage);
+    tree.addPage(foodPage);
+    tree.rootId = 'home';
+    return tree;
+  }
+
+  const hello = new AACButton({ id: 'hello', label: 'Hello', message: 'Hello', action: { type: 'SPEAK' } });
+  const thanks = new AACButton({ id: 'thanks', label: 'Thanks', message: 'Thank you', action: { type: 'SPEAK' } });
+  const yes = new AACButton({ id: 'yes', label: 'Yes', message: 'Yes', action: { type: 'SPEAK' } });
+  const more = new AACButton({
+    id: 'more',
+    label: 'Feelings',
+    targetPageId: 'feelings',
+    action: { type: 'NAVIGATE', targetPageId: 'feelings' },
+  });
+
+  const homePage = new AACPage({
+    id: 'home',
+    name: 'Starter',
+    buttons: [hello, thanks, yes, more],
+    grid: [
+      [hello, thanks],
+      [yes, more],
+    ],
+  });
+
+  const happy = new AACButton({ id: 'happy', label: 'Happy', message: 'I feel happy', action: { type: 'SPEAK' } });
+  const sad = new AACButton({ id: 'sad', label: 'Sad', message: 'I feel sad', action: { type: 'SPEAK' } });
+  const back = new AACButton({
+    id: 'back',
+    label: 'Back',
+    targetPageId: 'home',
+    action: { type: 'NAVIGATE', targetPageId: 'home' },
+  });
+
+  const feelingsPage = new AACPage({
+    id: 'feelings',
+    name: 'Feelings',
+    buttons: [happy, sad, back],
+    grid: [
+      [happy, sad],
+      [back, null],
+    ],
+  });
+
+  tree.addPage(homePage);
+  tree.addPage(feelingsPage);
+  tree.rootId = 'home';
+  return tree;
+}
+
+function buildFallbackObfBoard(page: AACPage, metadata?: AACTree['metadata']) {
+  const rows = page.grid.length || 1;
+  const columns = page.grid.reduce((max, row) => Math.max(max, row.length), 0) || page.buttons.length;
+  const order: (string | null)[][] = [];
+  const positions = new Map<string, number>();
+
+  if (page.grid.length) {
+    page.grid.forEach((row, rowIndex) => {
+      const orderRow: (string | null)[] = [];
+      for (let colIndex = 0; colIndex < columns; colIndex++) {
+        const cell = row[colIndex] || null;
+        if (cell) {
+          const id = String(cell.id ?? '');
+          orderRow.push(id);
+          positions.set(id, rowIndex * columns + colIndex);
+        } else {
+          orderRow.push(null);
+        }
+      }
+      order.push(orderRow);
+    });
+  } else {
+    const fallbackRow = page.buttons.map((button, index) => {
+      const id = String(button.id ?? '');
+      positions.set(id, index);
+      return id;
+    });
+    order.push(fallbackRow);
+  }
+
+  return {
+    format: 'open-board-0.1',
+    id: page.id,
+    locale: metadata?.locale || page.locale || 'en',
+    name: page.name || metadata?.name || 'Board',
+    description_html: page.descriptionHtml || metadata?.description || '',
+    grid: { rows, columns, order },
+    buttons: page.buttons.map((button) => ({
+      id: button.id,
+      label: button.label,
+      vocalization: button.message || button.label,
+      load_board: button.targetPageId ? { path: button.targetPageId } : undefined,
+      box_id: positions.get(String(button.id ?? '')),
+      background_color: button.style?.backgroundColor,
+      border_color: button.style?.borderColor,
+    })),
+  };
+}
+
+async function buildObfExport(tree: AACTree, format: 'obf' | 'obz') {
+  const obfProcessor = new ObfProcessor();
+  const obfInternal = obfProcessor as ObfProcessor & {
+    createObfBoardFromPage?: (page: AACPage, fallbackName: string, metadata?: AACTree['metadata']) => any;
+  };
+
+  const boards = Object.values(tree.pages).map((page) => ({
+    pageId: page.id,
+    board: obfInternal.createObfBoardFromPage
+      ? obfInternal.createObfBoardFromPage(page, 'Board', tree.metadata)
+      : buildFallbackObfBoard(page, tree.metadata),
+  }));
+
+  if (format === 'obf') {
+    const rootPage = tree.rootId ? tree.getPage(tree.rootId) : Object.values(tree.pages)[0];
+    const board =
+      boards.find((entry) => entry.pageId === rootPage?.id)?.board ?? boards[0]?.board ?? {};
+    const json = JSON.stringify(board, null, 2);
+    return { filename: `${sanitizeFilename(tree.metadata?.name || 'pageset')}.obf`, data: json };
+  }
+
+  const module = await import('jszip');
+  const JSZip = module.default || module;
+  const zip = new JSZip();
+  boards.forEach((entry) => {
+    zip.file(`${entry.pageId}.obf`, JSON.stringify(entry.board, null, 2));
+  });
+  const zipData = await zip.generateAsync({ type: 'uint8array' });
+  return { filename: `${sanitizeFilename(tree.metadata?.name || 'pageset')}.obz`, data: zipData };
+}
+
+function triggerDownload(data: Uint8Array | string, filename: string, mime: string) {
+  const blob = new Blob([data], { type: mime });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+
+createPagesetBtn.addEventListener('click', async () => {
+  const template = templateSelect.value;
+  const format = formatSelect.value === 'obz' ? 'obz' : 'obf';
+  const tree = buildSampleTree(template);
+  currentTree = tree;
+  currentSourceLabel = `${tree.metadata?.name || 'sample pageset'}`;
+  updateConvertButtons();
+
+  const exportData = await buildObfExport(tree, format);
+  const isObf = typeof exportData.data === 'string';
+  triggerDownload(
+    exportData.data,
+    exportData.filename,
+    isObf ? 'application/json' : 'application/zip'
+  );
+
+  pagesetOutput.textContent = isObf
+    ? exportData.data
+    : `Generated OBZ with ${Object.keys(tree.pages).length} boards.`;
+
+  log(`Created sample pageset and exported ${exportData.filename}`, 'success');
+  setConversionStatus(`Exported ${exportData.filename}`, 'success');
+});
+
+previewPagesetBtn.addEventListener('click', () => {
+  const tree = buildSampleTree(templateSelect.value);
+  currentTree = tree;
+  currentSourceLabel = `${tree.metadata?.name || 'sample pageset'}`;
+  displayResults(tree);
+  updateStatsForTree(tree, collectTextCount(tree));
+  updateConvertButtons();
+  setActiveTab('inspectTab');
+  log('Previewing sample pageset in viewer', 'info');
+});
+
+convertToObfBtn.addEventListener('click', async () => {
+  if (!currentTree) return;
+  const exportData = await buildObfExport(currentTree, 'obf');
+  triggerDownload(exportData.data, exportData.filename, 'application/json');
+  pagesetOutput.textContent = exportData.data as string;
+  log(`Converted ${currentSourceLabel} to ${exportData.filename}`, 'success');
+  setConversionStatus(`Exported ${exportData.filename}`, 'success');
+});
+
+convertToObzBtn.addEventListener('click', async () => {
+  if (!currentTree) return;
+  const exportData = await buildObfExport(currentTree, 'obz');
+  triggerDownload(exportData.data, exportData.filename, 'application/zip');
+  pagesetOutput.textContent = `Generated OBZ with ${Object.keys(currentTree.pages).length} boards.`;
+  log(`Converted ${currentSourceLabel} to ${exportData.filename}`, 'success');
+  setConversionStatus(`Exported ${exportData.filename}`, 'success');
 });
 
 // Run compatibility tests

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@willwade/aac-processors",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",
@@ -93,6 +93,7 @@
     "lint:fix": "eslint \"src/**/*.{js,ts}\" \"test/**/*.{js,ts}\" --fix",
     "format": "prettier --write \"src/**/*.{js,ts}\" \"test/**/*.{js,ts}\" \"*.{js,ts,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{js,ts}\" \"test/**/*.{js,ts}\" \"*.{js,ts,json,md}\"",
+    "smoke:browser": "node scripts/smoke-browser-bundle.js",
     "test": "npm run build && jest",
     "test:watch": "npm run build && jest --watch",
     "test:coverage": "npm run build && jest --coverage",