Implement Owen Animation System with core classes, loaders, and state handlers

- Added OwenSystemFactory for creating the animation system.
- Introduced OwenAnimationContext to manage animations and states.
- Created AnimationLoader and GLTFAnimationLoader for loading animations.
- Developed state handlers: WaitStateHandler, ReactStateHandler, TypeStateHandler, SleepStateHandler.
- Implemented StateFactory for managing state handlers.
- Defined constants for clip types, states, and emotions.
- Added type definitions for TypeScript support.
- Configured Vite for building and serving the project.
- Added licenses (dual) to project.
This commit is contained in:
2025-05-23 21:36:52 +02:00
parent 9e5f576b68
commit 658e1e64b2
29 changed files with 6902 additions and 907 deletions

184
examples/simple-example.js Normal file
View File

@ -0,0 +1,184 @@
/**
* @fileoverview Simple usage example for Node.js environment
* @author Owen Animation System
*/
import { OwenSystemFactory, States } from '../src/index.js';
/**
* Simple example of using Owen Animation System
* This example shows how to use the system without a browser environment
*/
class SimpleOwenExample {
constructor() {
this.owenSystem = null;
}
/**
* Initialize the Owen system with a mock model
* @returns {Promise<void>}
*/
async init() {
try {
// Create a mock GLTF model for demonstration
const mockModel = this.createMockModel();
// Create the Owen system
this.owenSystem = await OwenSystemFactory.createBasicOwenSystem(mockModel);
console.log('✅ Owen Animation System initialized successfully!');
console.log('📊 System Info:');
console.log(` Available States: ${this.owenSystem.getAvailableStates().join(', ')}`);
console.log(` Current State: ${this.owenSystem.getCurrentState()}`);
// Run some example interactions
await this.runExamples();
} catch (error) {
console.error('❌ Failed to initialize Owen system:', error.message);
}
}
/**
* Create a mock 3D model for demonstration purposes
* @returns {Object} Mock model object
*/
createMockModel() {
return {
animations: [
{ name: 'wait_idle_L' },
{ name: 'wait_quirk1_Q' },
{ name: 'wait_quirk2_Q' },
{ name: 'react_idle_L' },
{ name: 'react_angry_Q' },
{ name: 'react_happy_Q' },
{ name: 'type_idle_L' },
{ name: 'type_angry_L' },
{ name: 'sleep_idle_L' },
{ name: 'wait_2react_T' },
{ name: 'react_2type_T' },
{ name: 'type_2wait_T' },
{ name: 'wait_2sleep_T' },
{ name: 'sleep_2wait_T' }
],
scene: {},
userData: {}
};
}
/**
* Run example interactions with the Owen system
* @returns {Promise<void>}
*/
async runExamples() {
console.log('\n🎬 Running example interactions...\n');
// Example 1: Basic state transitions
console.log('📝 Example 1: Manual state transitions');
await this.demonstrateStateTransitions();
// Example 2: Message handling
console.log('\n📝 Example 2: Message handling with emotions');
await this.demonstrateMessageHandling();
// Example 3: System update loop
console.log('\n📝 Example 3: System update simulation');
this.demonstrateUpdateLoop();
console.log('\n✨ All examples completed!');
}
/**
* Demonstrate manual state transitions
* @returns {Promise<void>}
*/
async demonstrateStateTransitions() {
const states = [ States.REACT, States.TYPE, States.WAIT, States.SLEEP ];
for (const state of states) {
console.log(`🔄 Transitioning to ${state.toUpperCase()} state...`);
await this.owenSystem.transitionTo(state);
console.log(` ✓ Current state: ${this.owenSystem.getCurrentState()}`);
console.log(` ✓ Available transitions: ${this.owenSystem.getAvailableTransitions().join(', ')}`);
// Simulate some time passing
await this.sleep(500);
}
}
/**
* Demonstrate message handling with emotional responses
* @returns {Promise<void>}
*/
async demonstrateMessageHandling() {
const messages = [
{ text: 'Hello Owen!', expected: 'neutral response' },
{ text: 'This is urgent!', expected: 'angry/urgent response' },
{ text: 'Great work!', expected: 'happy response' },
{ text: 'There\'s an error in the system', expected: 'shocked response' },
{ text: 'I\'m feeling sad today', expected: 'sad response' }
];
for (const message of messages) {
console.log(`💬 Sending message: "${message.text}"`);
console.log(` Expected: ${message.expected}`);
await this.owenSystem.handleUserMessage(message.text);
console.log(` ✓ Current state after message: ${this.owenSystem.getCurrentState()}`);
await this.sleep(300);
}
}
/**
* Demonstrate the system update loop
* @returns {void}
*/
demonstrateUpdateLoop() {
console.log('⏱️ Simulating update loop for 3 seconds...');
let iterations = 0;
const startTime = Date.now();
const updateLoop = () => {
const deltaTime = 16.67; // ~60 FPS
this.owenSystem.update(deltaTime);
iterations++;
if (Date.now() - startTime < 3000) {
setTimeout(updateLoop, 16);
} else {
console.log(` ✓ Completed ${iterations} update iterations`);
console.log(` ✓ Final state: ${this.owenSystem.getCurrentState()}`);
}
};
updateLoop();
}
/**
* Simple sleep utility for demonstrations
* @param {number} ms - Milliseconds to sleep
* @returns {Promise<void>}
*/
sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
}
// Run the example if this file is executed directly
if (import.meta.url === `file://${process.argv[ 1 ]}`) {
console.log('🚀 Starting Owen Animation System Example\n');
const example = new SimpleOwenExample();
example.init()
.then(() => {
console.log('\n🎉 Example completed successfully!');
console.log('💡 Try modifying this example or check out the browser demo in examples/index.html');
})
.catch(error => {
console.error('\n💥 Example failed:', error);
});
}
export default SimpleOwenExample;