adminator-admin-dashboard 2.7.0 → 2.7.1

package/src/types/index.ts

@@ -0,0 +1,236 @@
+/**
+ * Core type definitions for Adminator Dashboard
+ */
+
+// Theme types
+export type Theme = 'light' | 'dark' | 'auto';
+
+export interface ThemeConfig {
+  theme: Theme;
+  autoDetect: boolean;
+  persistChoice: boolean;
+}
+
+// Component types
+export interface ComponentOptions {
+  [key: string]: any;
+}
+
+export interface ComponentInterface {
+  name: string;
+  element: HTMLElement;
+  options: ComponentOptions;
+  isInitialized: boolean;
+  init(): void;
+  destroy(): void;
+}
+
+// Sidebar types
+export interface SidebarOptions {
+  breakpoint?: number;
+  collapsible?: boolean;
+  autoHide?: boolean;
+  animation?: boolean;
+  animationDuration?: number;
+}
+
+export interface SidebarState {
+  isCollapsed: boolean;
+  isMobile: boolean;
+  activeMenu: string | null;
+}
+
+// Chart types
+export type ChartType = 'line' | 'bar' | 'doughnut' | 'pie' | 'radar' | 'scatter' | 'bubble' | 'polarArea';
+
+export interface ChartDataset {
+  label?: string;
+  data: number[];
+  backgroundColor?: string | string[];
+  borderColor?: string | string[];
+  borderWidth?: number;
+  fill?: boolean;
+}
+
+export interface ChartData {
+  labels: string[];
+  datasets: ChartDataset[];
+}
+
+export interface ChartOptions {
+  type: ChartType;
+  data: ChartData;
+  responsive?: boolean;
+  maintainAspectRatio?: boolean;
+  plugins?: any;
+  scales?: any;
+}
+
+// DataTable types
+export interface DataTableColumn {
+  key: string;
+  title: string;
+  sortable?: boolean;
+  searchable?: boolean;
+  render?: (value: any, row: any) => string;
+}
+
+export interface DataTableOptions {
+  columns: DataTableColumn[];
+  data: any[];
+  pageSize?: number;
+  sortable?: boolean;
+  searchable?: boolean;
+  pagination?: boolean;
+}
+
+export interface DataTableState {
+  currentPage: number;
+  pageSize: number;
+  totalRows: number;
+  sortColumn: string | null;
+  sortDirection: 'asc' | 'desc';
+  searchQuery: string;
+  filteredData: any[];
+}
+
+// Date utilities types
+export interface DateRange {
+  start: Date;
+  end: Date;
+}
+
+export interface DateFormatOptions {
+  locale?: string;
+  format?: string;
+  timeZone?: string;
+}
+
+// DOM utilities types
+export type DOMEventHandler = (event: Event) => void;
+
+export interface DOMUtilities {
+  select: (selector: string, context?: Element | Document) => HTMLElement | null;
+  selectAll: (selector: string, context?: Element | Document) => HTMLElement[];
+  on: (element: Element | Window | Document, event: string, handler: DOMEventHandler) => void;
+  off: (element: Element | Window | Document, event: string, handler: DOMEventHandler) => void;
+  addClass: (element: Element, className: string) => void;
+  removeClass: (element: Element, className: string) => void;
+  toggleClass: (element: Element, className: string) => void;
+  hasClass: (element: Element, className: string) => boolean;
+  attr: (element: Element, attribute: string, value?: string) => string | void;
+  data: (element: Element, key: string, value?: any) => any;
+  ready: (callback: () => void) => void;
+  exists: (selector: string, context?: Element | Document) => boolean;
+}
+
+// Application state types
+export interface ApplicationState {
+  theme: Theme;
+  sidebar: SidebarState;
+  components: Map<string, ComponentInterface>;
+  isInitialized: boolean;
+}
+
+export interface ApplicationConfig {
+  theme: ThemeConfig;
+  sidebar: SidebarOptions;
+  enableAnalytics?: boolean;
+  debugMode?: boolean;
+}
+
+// Event types
+export interface CustomEventDetail {
+  [key: string]: any;
+}
+
+export interface ThemeChangeEvent extends CustomEvent {
+  detail: {
+    theme: Theme;
+    previousTheme: Theme;
+  };
+}
+
+export interface ComponentEvent extends CustomEvent {
+  detail: {
+    component: string;
+    action: 'init' | 'destroy' | 'update';
+    data?: any;
+  };
+}
+
+// Utility types
+export type DeepPartial<T> = {
+  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+
+export type RequiredKeys<T, K extends keyof T> = T & Required<Pick<T, K>>;
+
+export type OptionalKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+
+// Color types
+export interface ColorPalette {
+  primary: string;
+  secondary: string;
+  success: string;
+  danger: string;
+  warning: string;
+  info: string;
+  light: string;
+  dark: string;
+}
+
+export interface ThemeColors {
+  light: ColorPalette;
+  dark: ColorPalette;
+}
+
+// Animation types
+export type AnimationEasing = 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'linear';
+
+export interface AnimationOptions {
+  duration?: number;
+  easing?: AnimationEasing;
+  delay?: number;
+  fillMode?: 'none' | 'forwards' | 'backwards' | 'both';
+}
+
+// Layout types
+export interface LayoutBreakpoints {
+  xs: number;
+  sm: number;
+  md: number;
+  lg: number;
+  xl: number;
+  xxl: number;
+}
+
+export interface ResponsiveConfig {
+  breakpoints: LayoutBreakpoints;
+  mobileFirst: boolean;
+}
+
+// Error types
+export class AdminatorError extends Error {
+  constructor(
+    message: string,
+    public component?: string,
+    public code?: string
+  ) {
+    super(message);
+    this.name = 'AdminatorError';
+  }
+}
+
+// Plugin types
+export interface PluginInterface {
+  name: string;
+  version: string;
+  dependencies?: string[];
+  init(app: any): void;
+  destroy(): void;
+}
+
+export interface PluginRegistry {
+  [key: string]: PluginInterface;
+}

package/RELEASE_NOTES.md

@@ -1,92 +0,0 @@
-# 🚀 Adminator v2.7.0 - jQuery-Free Release
-
-## 📋 Overview
-This major release completely removes jQuery dependency from the Adminator admin dashboard while maintaining all functionality and improving performance. The project now uses modern vanilla JavaScript with Bootstrap 5.3.7.
-
-## ✨ Major Changes
-
-### 🗑️ Removed jQuery Dependencies (600KB+ bundle reduction)
-- ❌ **jQuery Core** (3.7.1) → ✅ **Vanilla JavaScript**
-- ❌ **jQuery Sparkline** (2.4.0) → ✅ **Chart.js 4.5.0** mini charts
-- ❌ **Bootstrap Datepicker** (1.10.0) → ✅ **HTML5 date inputs** + vanilla JS
-- ❌ **DataTables** (1.10.18) → ✅ **Custom vanilla JS** table component
-- ❌ **Easy Pie Chart** (2.1.7) → ✅ **Custom SVG** pie charts
-- ❌ **jVectorMap** (2.0.4) → ✅ **JSVectorMap 1.6.0** (jQuery-free)
-
-### 🔧 New Vanilla JavaScript Components
-- **Bootstrap 5 Components**: Modals, dropdowns, popovers, tooltips, accordions
-- **Enhanced Data Tables**: Sorting, pagination, search functionality
-- **Interactive Charts**: Chart.js-based sparklines with theme support
-- **Vector Maps**: Interactive world maps with markers and tooltips
-- **Date Pickers**: HTML5 date inputs with enhanced UX
-- **Theme System**: Improved dark/light mode with CSS variables
-
-### 📱 Mobile Enhancements
-- Full-width search overlay for mobile devices
-- Enhanced dropdown behavior with overlay management
-- Touch-friendly interactions and gestures
-- Viewport-based responsive breakpoints
-- Prevents horizontal scrolling on mobile
-
-### 🎨 Bootstrap 5 Migration
-- **Updated to Bootstrap 5.3.7** from Bootstrap 4
-- **Fixed deprecated classes**: `sr-only` → `visually-hidden`
-- **Updated data attributes**: `data-toggle` → `data-bs-toggle`
-- **Enhanced UI components**: New examples and improved styling
-- **Better accessibility**: Proper ARIA attributes and keyboard navigation
-
-## 🚀 Performance Improvements
-- **Bundle size reduction**: ~600KB smaller JavaScript bundle
-- **Faster page loads**: Eliminated jQuery dependency
-- **Modern ES6+**: Class-based architecture with better maintainability
-- **Optimized builds**: Webpack 5.99.9 with modern optimizations
-
-## 📦 New Features
-- **Theme Toggle**: Automatic injection with OS preference detection
-- **Comprehensive Documentation**: Updated CLAUDE.md with full architecture guide
-- **Mobile-First Design**: Enhanced mobile experience across all components
-- **Dark Mode**: Complete dark mode implementation with CSS variables
-
-## 🔧 Technical Details
-- **Build System**: Webpack 5.99.9 with hot module replacement
-- **JavaScript**: ES6+ with Babel transpilation, ESLint 9.x flat config
-- **CSS**: Sass/SCSS with PostCSS processing
-- **Frontend**: 100% jQuery-free vanilla JavaScript
-- **Theme System**: CSS variables-based dark/light mode
-
-## 📖 Documentation
-- Complete architecture documentation in `CLAUDE.md`
-- Development commands and workflow guidelines
-- Component integration examples
-- Mobile optimization techniques
-
-## 🔗 Demo
-- **Live Demo**: https://puikinsh.github.io/Adminator-admin-dashboard/
-- **Development Server**: `npm start` (http://localhost:4000)
-
-## 💻 Quick Start
-```bash
-# Install dependencies
-npm install
-
-# Start development server
-npm start
-
-# Build for production
-npm run build
-
-# Run linters
-npm run lint
-```
-
-## 🎯 What's Next
-This release establishes a modern, maintainable foundation for the Adminator admin dashboard. All functionality has been preserved while significantly improving performance and developer experience.
-
-## 🙏 Acknowledgments
-- Original design by [Colorlib](https://colorlib.com)
-- jQuery removal and modernization completed with comprehensive testing
-- Bootstrap 5 migration with full backward compatibility
-
----
-
-**Full Changelog**: https://github.com/puikinsh/Adminator-admin-dashboard/compare/v2.6.1...v2.7.0