@sirymony/dax v0.1.3

DaxJS

A lightweight, high-performance JavaScript library for building user interfaces with Virtual DOM.

Features

Current Features

• Optimized Virtual DOM implementation with batch updates
• Efficient memoization for frequently accessed nodes
• Robust event management system
• Component lifecycle management
• Props validation with type checking and custom validators
• State management with reactive updates

Upcoming Features

Performance & Memory

• Key-based reconciliation for optimized diffing
• Fragment support for reduced DOM nodes
• Advanced memory management with leak detection
• Event listener cleanup and weak references

Developer Experience

• Developer tools extension
• Enhanced TypeScript support
• Component hot reloading
• Performance profiling tools

State Management

• Computed properties
• State middleware system
• Time-travel debugging
• State persistence

Component Features

• Async rendering support
• Suspense functionality
• Server-side rendering
• Component lazy loading
• Enhanced lifecycle hooks

Installation

npm install @sirymony/dax

Usage

import { VirtualDOM, EventManager, LifecycleManager, PropsValidator, BatchUpdate } from '@sirymony/dax';

// Create a virtual DOM element with batch updates
const vdom = new VirtualDOM();
const batchUpdate = new BatchUpdate();

const element = vdom.createElement('div', { className: 'container' },
  vdom.createElement('h1', {}, 'Hello World'),
  vdom.createElement('p', {}, 'Welcome to DaxJS')
);

// Batch multiple DOM updates for better performance
batchUpdate.add(() => {
  vdom.updateElement(element, { className: 'container active' });
  vdom.appendChild(element, vdom.createElement('span', {}, 'New content'));
});

// Handle events efficiently
const events = new EventManager();
events.on('click', (e) => {
  batchUpdate.add(() => {
    // Updates will be batched together
    console.log('Clicked!');
  });
});

// Manage component lifecycle
const lifecycle = new LifecycleManager();
lifecycle.onMount(() => console.log('Component mounted'));

// Validate props with type checking
const validator = new PropsValidator();
const schema = {
  name: { type: 'string', required: true },
  age: { type: 'number', validator: (value) => value >= 0 }
};
const props = { name: 'John', age: 25 };
const errors = PropsValidator.validate(props, schema);

API Reference

VirtualDOM

The VirtualDOM class provides methods for creating and manipulating virtual DOM elements.

class VirtualDOM {
  createElement(type, props = {}, ...children)
  diff(oldNode, newNode)
  patch(parent, patches, index = 0)
}

PropsValidator

The PropsValidator class provides type checking and custom validation for component props.

class PropsValidator {
  static types = {
    string, number, boolean, array, object, function
  }
  
  static validate(props, schema)
}

Supported validation rules:

• type: string | number | boolean | array | object | function
• required: boolean
• validator: (value) => boolean

Building

# Install dependencies
npm install

# Build the library
npm run build

# Development mode with watch
npm run dev

License

MIT