@willwade/aac-processors 0.1.10 → 0.1.12

package/examples/typescript-demo.ts

@@ -1,251 +0,0 @@
-#!/usr/bin/env ts-node
-
-/**
- * TypeScript Demo - AACProcessors 2.0
- * 
- * This example demonstrates the new TypeScript API and features
- * including translation workflows and cross-format conversion.
- */
-
-import { 
-  getProcessor, 
-  DotProcessor, 
-  ObfProcessor,
-  AACTree, 
-  AACPage, 
-  AACButton 
-} from '../src/index';
-import fs from 'fs';
-import path from 'path';
-
-async function main() {
-  console.log('🚀 AACProcessors 2.0 TypeScript Demo\n');
-
-  // Example 1: Auto-detect processor by file extension
-  console.log('📁 Example 1: Auto-detection');
-  try {
-    const dotFile = path.join(__dirname, 'example.dot');
-    if (fs.existsSync(dotFile)) {
-      const processor = getProcessor(dotFile);
-      console.log(`✅ Detected processor: ${processor.constructor.name}`);
-      
-      const tree = processor.loadIntoTree(dotFile);
-      console.log(`📊 Loaded ${Object.keys(tree.pages).length} pages`);
-      
-      const texts = processor.extractTexts(dotFile);
-      console.log(`📝 Found ${texts.length} text elements`);
-    } else {
-      console.log('⚠️  example.dot not found, skipping auto-detection demo');
-    }
-  } catch (error) {
-    console.error('❌ Auto-detection error:', error);
-  }
-
-  console.log('\n' + '='.repeat(50) + '\n');
-
-  // Example 2: Create a communication board programmatically
-  console.log('🏗️  Example 2: Programmatic Board Creation');
-  
-  const tree = new AACTree();
-  
-  // Create home page
-  const homePage = new AACPage({
-    id: 'home',
-    name: 'Home Page',
-    buttons: []
-  });
-  
-  // Add buttons
-  const greetingButton = new AACButton({
-    id: 'btn_hello',
-    label: 'Hello',
-    message: 'Hello, how are you today?',
-    type: 'SPEAK'
-  });
-  
-  const foodButton = new AACButton({
-    id: 'btn_food',
-    label: 'Food',
-    message: 'I want something to eat',
-    type: 'NAVIGATE',
-    targetPageId: 'food_page'
-  });
-  
-  const drinkButton = new AACButton({
-    id: 'btn_drink',
-    label: 'Drink',
-    message: 'I want something to drink',
-    type: 'SPEAK'
-  });
-  
-  homePage.addButton(greetingButton);
-  homePage.addButton(foodButton);
-  homePage.addButton(drinkButton);
-  tree.addPage(homePage);
-  
-  // Create food page
-  const foodPage = new AACPage({
-    id: 'food_page',
-    name: 'Food Options',
-    buttons: []
-  });
-  
-  const appleButton = new AACButton({
-    id: 'btn_apple',
-    label: 'Apple',
-    message: 'I want an apple',
-    type: 'SPEAK'
-  });
-  
-  const backButton = new AACButton({
-    id: 'btn_back',
-    label: 'Back',
-    message: 'Go back to home',
-    type: 'NAVIGATE',
-    targetPageId: 'home'
-  });
-  
-  foodPage.addButton(appleButton);
-  foodPage.addButton(backButton);
-  tree.addPage(foodPage);
-  
-  tree.rootId = 'home';
-  
-  console.log(`✅ Created communication board with ${Object.keys(tree.pages).length} pages`);
-  
-  console.log('\n' + '='.repeat(50) + '\n');
-
-  // Example 3: Save to multiple formats
-  console.log('💾 Example 3: Cross-Format Conversion');
-  
-  const tempDir = path.join(__dirname, 'temp');
-  if (!fs.existsSync(tempDir)) {
-    fs.mkdirSync(tempDir);
-  }
-  
-  try {
-    // Save as DOT
-    const dotProcessor = new DotProcessor();
-    const dotPath = path.join(tempDir, 'demo-board.dot');
-    dotProcessor.saveFromTree(tree, dotPath);
-    console.log(`✅ Saved as DOT: ${dotPath}`);
-    
-    // Save as OBF
-    const obfProcessor = new ObfProcessor();
-    const obfPath = path.join(tempDir, 'demo-board.obf');
-    obfProcessor.saveFromTree(tree, obfPath);
-    console.log(`✅ Saved as OBF: ${obfPath}`);
-    
-    // Verify round-trip integrity
-    const reloadedDotTree = dotProcessor.loadIntoTree(dotPath);
-    const reloadedObfTree = obfProcessor.loadIntoTree(obfPath);
-    
-    console.log(`🔄 DOT round-trip: ${Object.keys(reloadedDotTree.pages).length} pages`);
-    console.log(`🔄 OBF round-trip: ${Object.keys(reloadedObfTree.pages).length} pages`);
-    
-  } catch (error) {
-    console.error('❌ Conversion error:', error);
-  }
-  
-  console.log('\n' + '='.repeat(50) + '\n');
-
-  // Example 4: Translation workflow
-  console.log('🌍 Example 4: Translation Workflow');
-  
-  try {
-    const dotPath = path.join(tempDir, 'demo-board.dot');
-    if (fs.existsSync(dotPath)) {
-      const processor = new DotProcessor();
-      
-      // Extract all text
-      const originalTexts = processor.extractTexts(dotPath);
-      console.log(`📝 Found ${originalTexts.length} translatable texts:`, originalTexts);
-      
-      // Create Spanish translations
-      const translations = new Map([
-        ['Hello', 'Hola'],
-        ['Food', 'Comida'],
-        ['Drink', 'Bebida'],
-        ['Apple', 'Manzana'],
-        ['Back', 'Atrás'],
-        ['Home Page', 'Página Principal'],
-        ['Food Options', 'Opciones de Comida'],
-        ['Hello, how are you today?', 'Hola, ¿cómo estás hoy?'],
-        ['I want something to eat', 'Quiero algo de comer'],
-        ['I want something to drink', 'Quiero algo de beber'],
-        ['I want an apple', 'Quiero una manzana'],
-        ['Go back to home', 'Volver a casa']
-      ]);
-      
-      // Apply translations
-      const spanishPath = path.join(tempDir, 'demo-board-spanish.dot');
-      const translatedBuffer = processor.processTexts(dotPath, translations, spanishPath);
-      
-      console.log(`✅ Applied ${translations.size} translations`);
-      console.log(`💾 Saved Spanish version: ${spanishPath}`);
-      
-      // Verify translations
-      const spanishTexts = processor.extractTexts(spanishPath);
-      console.log(`🔍 Spanish texts:`, spanishTexts.slice(0, 5), '...');
-      
-    } else {
-      console.log('⚠️  DOT file not found for translation demo');
-    }
-  } catch (error) {
-    console.error('❌ Translation error:', error);
-  }
-  
-  console.log('\n' + '='.repeat(50) + '\n');
-
-  // Example 5: Error handling
-  console.log('🛡️  Example 5: Error Handling');
-  
-  try {
-    const processor = new DotProcessor();
-    
-    // Try to load a non-existent file
-    try {
-      processor.loadIntoTree('non-existent-file.dot');
-    } catch (error) {
-      console.log(`✅ Caught expected error: ${error instanceof Error ? error.message : error}`);
-    }
-    
-    // Try to load invalid content
-    try {
-      const invalidContent = Buffer.from('This is not a valid DOT file');
-      const tree = processor.loadIntoTree(invalidContent);
-      console.log(`✅ Gracefully handled invalid content: ${Object.keys(tree.pages).length} pages`);
-    } catch (error) {
-      console.log(`✅ Handled invalid content error: ${error instanceof Error ? error.message : error}`);
-    }
-    
-  } catch (error) {
-    console.error('❌ Error handling demo failed:', error);
-  }
-  
-  console.log('\n🎉 Demo completed successfully!');
-  console.log('\n📚 For more examples, see:');
-  console.log('   - README.md for API documentation');
-  console.log('   - test/ directory for comprehensive usage examples');
-  console.log('   - examples/ directory for more demos');
-  
-  // Cleanup
-  try {
-    if (fs.existsSync(tempDir)) {
-      fs.rmSync(tempDir, { recursive: true, force: true });
-      console.log('\n🧹 Cleaned up temporary files');
-    }
-  } catch (error) {
-    console.warn('⚠️  Failed to clean up temporary files:', error);
-  }
-}
-
-// Run the demo
-if (require.main === module) {
-  main().catch(error => {
-    console.error('❌ Demo failed:', error);
-    process.exit(1);
-  });
-}
-
-export { main as runDemo };

package/examples/vitedemo/README.md

@@ -1,164 +0,0 @@
-# AAC Processors Browser Demo
-
-A real browser demo that uses Vite to bundle AACProcessors for browser use.
-
-## Features
-
-- ✅ **Real file processing** - Upload and process actual AAC files
-- ✅ **All browser-compatible processors** - Tests Dot, OPML, OBF/OBZ, Gridset, Snap, TouchChat, ApplePanels, AstericsGrid
-- ✅ **Interactive UI** - Drag & drop files, view pages and buttons
-- ✅ **Text-to-speech** - Click SPEAK buttons to hear messages (browser speech API)
-- ✅ **Navigation** - Click NAVIGATE buttons to jump between pages
-- ✅ **Compatibility tests** - Automated tests for all processors
-- ✅ **Performance metrics** - Load time, page/button/text counts
-- ✅ **TypeScript** - Full type safety and IntelliSense
-
-## Quick Start
-
-### 1. Install Dependencies
-
-```bash
-cd examples/vitedemo
-npm install
-```
-
-### 2. Run Dev Server
-
-```bash
-npm run dev
-```
-
-The demo will open automatically at: http://localhost:3000
-
-### 3. Build for Production (Not Supported Yet)
-
-This demo is intended for `npm run dev` only. The production build currently fails because the
-demo source includes strict TypeScript issues, so it will not work "out of the box."
-
-This demo is the recommended browser test environment.
-
-## How to Use
-
-1. **Upload a file**
-   - Drag & drop an AAC file onto the upload area
-   - Or click to open file picker
-   - Supported formats: .dot, .opml, .obf, .obz, .gridset, .sps, .spb, .ce, .plist, .grd
-
-2. **Process the file**
-   - Click "Process File" button
-   - View pages and buttons in the right panel
-   - Check stats: pages, buttons, texts, load time
-
-3. **Interact with buttons**
-   - Click SPEAK buttons to hear text (uses browser speech API)
-   - Click NAVIGATE buttons to jump to target pages
-
-4. **Run compatibility tests**
-   - Click "Run Compatibility Tests"
-   - See test results in the left panel
-   - Tests all browser-compatible processors
-
-## Supported File Types
-
-| Format   | Extensions      | Processor               |
-|----------|-----------------|-------------------------|
-| DOT      | .dot            | DotProcessor            |
-| OPML     | .opml           | OpmlProcessor           |
-| OBF/OBZ  | .obf, .obz      | ObfProcessor            |
-| Gridset  | .gridset        | GridsetProcessor        |
-| Snap     | .sps, .spb      | SnapProcessor           |
-| TouchChat| .ce             | TouchChatProcessor      |
-| Apple    | .plist          | ApplePanelsProcessor    |
-| Asterics | .grd            | AstericsGridProcessor   |
-
-## Test Files
-
-You can use test files from the parent directory:
-
-```bash
-# From vitedemo directory
-../../test/assets/dot/example.dot
-../../test/assets/opml/example.opml
-../../test/assets/obf/simple.obf
-../../test/assets/gridset/example.gridset
-../../test/assets/asterics/example.grd
-```
-
-## Technical Details
-
-### Vite Configuration
-
-The demo uses a custom Vite config to import from the source TypeScript:
-
-```typescript
-// vite.config.ts
-export default defineConfig({
-  resolve: {
-    alias: {
-      'aac-processors': path.resolve(__dirname, '../../src/index.browser.ts')
-    }
-  }
-});
-```
-
-This allows direct TypeScript import without pre-building.
-
-### Import Example (with SQLite WASM)
-
-```typescript
-import { configureSqlJs, getProcessor } from 'aac-processors';
-import sqlWasmUrl from 'sql.js/dist/sql-wasm.wasm?url';
-
-configureSqlJs({
-  locateFile: () => sqlWasmUrl
-});
-
-// Get processor for file type
-const processor = getProcessor('.obf');
-
-// Load file from input
-const arrayBuffer = await file.arrayBuffer();
-const tree = await processor.loadIntoTree(arrayBuffer);
-
-// Extract texts
-const texts = await processor.extractTexts(arrayBuffer);
-```
-
-## Troubleshooting
-
-### Module not found errors
-
-Make sure you're in the `examples/vitedemo` directory and have run `npm install`.
-
-### TypeScript errors
-
-Clear the Vite cache:
-```bash
-rm -rf node_modules/.vite
-npm run dev
-```
-
-### File processing errors
-
-Check the browser console (F12) for detailed error messages. Common issues:
-- Invalid file format
-- Corrupted file
-- Unsupported file type (check extensions)
-
-## Browser Compatibility
-
-- ✅ Chrome/Edge (recommended)
-- ✅ Firefox
-- ✅ Safari
-- ⚠️ Speech API works best in Chrome/Edge
-
-## Next Steps
-
-This demonstrates that AACProcessors works in browsers with a bundler. To use in your own project:
-
-1. Install AACProcessors: `npm install @willwade/aac-processors`
-2. Set up Vite/Webpack/Rollup
-3. Import from `'aac-processors'`
-4. Use `getProcessor()` factory function
-
-See `docs/BROWSER_USAGE.md` for complete setup guides.