fix: improve DataTable pagination component

[christoph2806]

DataTable Pagination Component Improvements

Overview

This PR enhances the DataTable pagination component to improve its functionality, maintainability, and performance. The changes focus on better type safety, error handling, and documentation while maintaining backward compatibility.

Changes

Component Structure

• Improved organization of pagination logic
• Enhanced type definitions for better type safety
• Added comprehensive JSDoc comments
• Optimized component rendering for better performance

Technical Details

• Refactored pagination state management
• Added proper error boundaries
• Improved accessibility features
• Enhanced keyboard navigation support
• Added proper ARIA attributes

Documentation

• Added detailed component documentation
• Included usage examples
• Documented all props and their types
• Added migration guide for any breaking changes

Impact

User Experience

• More reliable pagination behavior
• Better handling of edge cases
• Improved accessibility
• Smoother performance with large datasets

Developer Experience

• Better type safety
• Clearer component API
• Improved maintainability
• Better error messages

Testing

Unit Tests

• Pagination state management
• Edge case handling
• Accessibility features
• Keyboard navigation

Integration Tests

• Component integration with DataTable
• State synchronization
• Event handling
• Performance benchmarks

Related Issues

• Closes refactor: cleanup DataTable components and tests #67
• Related to feat: Fix Release v0.4.1 - TypeScript Declarations & API Standardization #45

Checklist

• Code follows project style guidelines
• All tests pass
• Documentation is updated
• No breaking changes
• Performance impact is acceptable
• Accessibility requirements are met