@erpsquad/common 1.8.81 → 1.8.83

package/CHANGELOG.md

@@ -1,254 +1,254 @@
-# Changelog
-
-All notable changes to the ERP UI Library will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.0] - 2024-01-15
-
-### Added
-- Initial release of the ERP UI Library as a standalone npm package
-- 80+ UI components extracted from erp-common workspace module
-- Comprehensive theming system with light/dark mode support
-- RTL/LTR text direction support
-- Flexible Redux integration (optional)
-- TypeScript definitions for all components and utilities
-- Custom hooks for authentication, language, permissions, and more
-- Utility functions for date formatting, file size, text manipulation, and colors
-- Context providers for auth, language, pages, and permissions
-- Enhanced components with flexible Redux/prop-based usage patterns
-- Comprehensive documentation and examples
-- Migration guide from erp-common workspace module
-
-### Components
-- **Form Controls**: Button, TextField, Select, DatePicker, Checkbox, Radio, Switch, etc.
-- **Data Display**: MaterialTable, Grid, Card, Avatar, Chip, Typography, etc.
-- **Navigation**: Sidebar, Breadcrumb, Pagination, Tabs, Menu, etc.
-- **Feedback**: Snackbar, Toast, Loader, Alert, Modal, etc.
-- **Layout**: Box, Container, Stack, Divider, etc.
-- **Enhanced Components**: ShareModalEnhanced, HeaderEnhanced with flexible Redux integration
-
-### Hooks
-- `useAuth` - Authentication state management
-- `useLanguage` - Internationalization and language switching
-- `usePermissions` - Role-based access control
-- `usePages` - Page state management
-- `useDeepMemo` - Deep memoization for complex objects
-- `useReduxIntegration` - Unified interface for Redux/prop-based components
-
-### Utilities
-- `formatDate` - Date formatting with various patterns
-- `formatFileSize` - Human-readable file size formatting
-- `formatText` / `deformatText` - Text transformation utilities
-- `colorUtils` - Color manipulation and conversion utilities
-
-### Theme System
-- `createLightTheme` - Light theme creation with custom colors
-- `createDarkTheme` - Dark theme creation with custom colors
-- `ERPUIProvider` - Main provider component with theme, context, and Redux integration
-- Support for custom primary colors and Material-UI theme extensions
-
-### Redux Integration
-- Optional Redux slices for share, header, and reports functionality
-- `createLibraryStore` - Helper for creating Redux store with library slices
-- `createConfiguredApiClient` - API client configuration helper
-- `getLibrarySlices` - Export all library Redux slices
-- Flexible component design supporting both Redux and prop-based usage
-
-### Breaking Changes from erp-common
-
-#### Import Path Changes
-- **Before**: `import Button from 'erp-common/src/components/button/button'`
-- **After**: `import { Button } from '@company/erp-ui-library'`
-
-#### Provider Requirements
-- **Before**: Theme and contexts automatically provided
-- **After**: Must wrap app with `ERPUIProvider`
-
-```typescript
-// Before
-function App() {
-  return <MyComponent />;
-}
-
-// After
-import { ERPUIProvider } from '@company/erp-ui-library';
-
-function App() {
-  return (
-    <ERPUIProvider>
-      <MyComponent />
-    </ERPUIProvider>
-  );
-}
-```
-
-#### Redux Integration Changes
-- **Before**: Components automatically used Redux
-- **After**: Must specify `useRedux` prop for enhanced components
-
-```typescript
-// Before
-<ShareModal open={isOpen} onClose={handleClose} />
-
-// After - with Redux
-<ShareModalEnhanced useRedux={true} open={isOpen} onClose={handleClose} />
-
-// After - without Redux
-<ShareModalEnhanced
-  useRedux={false}
-  users={users}
-  departments={departments}
-  loading={loading}
-  onFetchUsersAndDepartments={fetchData}
-  open={isOpen}
-  onClose={handleClose}
-/>
-```
-
-#### Store Configuration Changes
-- **Before**: Redux store automatically configured with all slices
-- **After**: Must explicitly configure store with library slices
-
-```typescript
-// Before
-import { store } from 'erp-common/src/redux/store';
-
-// After
-import { configureStore } from '@reduxjs/toolkit';
-import { getLibrarySlices } from '@company/erp-ui-library';
-
-const store = configureStore({
-  reducer: {
-    ...getLibrarySlices(),
-    // your app reducers
-  }
-});
-```
-
-#### API Client Configuration
-- **Before**: API client automatically configured
-- **After**: Must explicitly configure API client
-
-```typescript
-// After
-import { createConfiguredApiClient } from '@company/erp-ui-library';
-
-const apiClient = createConfiguredApiClient(
-  baseApiClient,
-  () => ({ authorization: `Bearer ${getToken()}` })
-);
-```
-
-### Migration Path
-
-1. **Install the library**: `npm install @company/erp-ui-library`
-2. **Install peer dependencies**: React, Material-UI, etc.
-3. **Update imports**: Change from workspace paths to npm package imports
-4. **Add ERPUIProvider**: Wrap your app with the provider
-5. **Configure Redux** (if using): Set up store with library slices
-6. **Update enhanced components**: Add `useRedux` prop and handle both patterns
-7. **Test thoroughly**: Ensure all functionality works as expected
-8. **Remove old workspace**: Clean up erp-common workspace module
-
-### Documentation
-- [README.md](README.md) - Installation and basic usage
-- [API.md](API.md) - Comprehensive API documentation
-- [EXAMPLES.md](EXAMPLES.md) - Usage examples and patterns
-- [MIGRATION.md](MIGRATION.md) - Detailed migration guide from erp-common
-- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Common issues and solutions
-
-### Development
-- TypeScript support with strict type checking
-- Jest testing framework with React Testing Library
-- ESLint configuration for code quality
-- Vite build system for fast development and optimized production builds
-- Size limit monitoring to prevent bundle bloat
-- Comprehensive test coverage for components, hooks, and utilities
-
-### Performance
-- Tree shaking support for optimal bundle size
-- Lazy loading support for large components
-- Memoization utilities for expensive calculations
-- Optimized Material-UI theme integration
-- Minimal runtime overhead for unused features
-
----
-
-## Version History
-
-### [1.0.0] - 2024-01-15
-- Initial release as standalone npm package
-- Migration from erp-common workspace module
-- Comprehensive component library with 80+ components
-- Flexible Redux integration
-- Full TypeScript support
-- Theming system with light/dark modes
-- RTL/LTR support
-- Internationalization support
-- Complete documentation and migration guide
-
----
-
-## Upgrade Guide
-
-### From erp-common workspace to 1.0.0
-
-This is a major migration from a workspace module to an npm package. Please follow the detailed [Migration Guide](MIGRATION.md) for step-by-step instructions.
-
-**Key Changes:**
-1. Package installation required
-2. Import paths changed
-3. Provider wrapper required
-4. Redux integration made optional and explicit
-5. Enhanced components with flexible usage patterns
-
-**Estimated Migration Time:** 1-2 weeks depending on application size
-
-**Support:** See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for common issues and solutions
-
----
-
-## Future Releases
-
-### Planned for 1.1.0
-- Additional form components (file upload, rich text editor)
-- Enhanced data visualization components
-- Improved accessibility features
-- Performance optimizations
-- Additional utility functions
-
-### Planned for 1.2.0
-- Mobile-responsive component variants
-- Advanced theming capabilities
-- Component composition utilities
-- Enhanced testing utilities
-
-### Planned for 2.0.0
-- React 19 support
-- Material-UI v6 upgrade
-- Breaking changes for improved API consistency
-- New component architecture patterns
-
----
-
-## Contributing
-
-We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
-- Code style and standards
-- Testing requirements
-- Documentation standards
-- Pull request process
-- Issue reporting
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Support
-
-- **Documentation**: [GitHub Repository](https://github.com/company/erp-ui-library)
-- **Issues**: [GitHub Issues](https://github.com/company/erp-ui-library/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/company/erp-ui-library/discussions)
+# Changelog
+
+All notable changes to the ERP UI Library will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-01-15
+
+### Added
+- Initial release of the ERP UI Library as a standalone npm package
+- 80+ UI components extracted from erp-common workspace module
+- Comprehensive theming system with light/dark mode support
+- RTL/LTR text direction support
+- Flexible Redux integration (optional)
+- TypeScript definitions for all components and utilities
+- Custom hooks for authentication, language, permissions, and more
+- Utility functions for date formatting, file size, text manipulation, and colors
+- Context providers for auth, language, pages, and permissions
+- Enhanced components with flexible Redux/prop-based usage patterns
+- Comprehensive documentation and examples
+- Migration guide from erp-common workspace module
+
+### Components
+- **Form Controls**: Button, TextField, Select, DatePicker, Checkbox, Radio, Switch, etc.
+- **Data Display**: MaterialTable, Grid, Card, Avatar, Chip, Typography, etc.
+- **Navigation**: Sidebar, Breadcrumb, Pagination, Tabs, Menu, etc.
+- **Feedback**: Snackbar, Toast, Loader, Alert, Modal, etc.
+- **Layout**: Box, Container, Stack, Divider, etc.
+- **Enhanced Components**: ShareModalEnhanced, HeaderEnhanced with flexible Redux integration
+
+### Hooks
+- `useAuth` - Authentication state management
+- `useLanguage` - Internationalization and language switching
+- `usePermissions` - Role-based access control
+- `usePages` - Page state management
+- `useDeepMemo` - Deep memoization for complex objects
+- `useReduxIntegration` - Unified interface for Redux/prop-based components
+
+### Utilities
+- `formatDate` - Date formatting with various patterns
+- `formatFileSize` - Human-readable file size formatting
+- `formatText` / `deformatText` - Text transformation utilities
+- `colorUtils` - Color manipulation and conversion utilities
+
+### Theme System
+- `createLightTheme` - Light theme creation with custom colors
+- `createDarkTheme` - Dark theme creation with custom colors
+- `ERPUIProvider` - Main provider component with theme, context, and Redux integration
+- Support for custom primary colors and Material-UI theme extensions
+
+### Redux Integration
+- Optional Redux slices for share, header, and reports functionality
+- `createLibraryStore` - Helper for creating Redux store with library slices
+- `createConfiguredApiClient` - API client configuration helper
+- `getLibrarySlices` - Export all library Redux slices
+- Flexible component design supporting both Redux and prop-based usage
+
+### Breaking Changes from erp-common
+
+#### Import Path Changes
+- **Before**: `import Button from 'erp-common/src/components/button/button'`
+- **After**: `import { Button } from '@company/erp-ui-library'`
+
+#### Provider Requirements
+- **Before**: Theme and contexts automatically provided
+- **After**: Must wrap app with `ERPUIProvider`
+
+```typescript
+// Before
+function App() {
+  return <MyComponent />;
+}
+
+// After
+import { ERPUIProvider } from '@company/erp-ui-library';
+
+function App() {
+  return (
+    <ERPUIProvider>
+      <MyComponent />
+    </ERPUIProvider>
+  );
+}
+```
+
+#### Redux Integration Changes
+- **Before**: Components automatically used Redux
+- **After**: Must specify `useRedux` prop for enhanced components
+
+```typescript
+// Before
+<ShareModal open={isOpen} onClose={handleClose} />
+
+// After - with Redux
+<ShareModalEnhanced useRedux={true} open={isOpen} onClose={handleClose} />
+
+// After - without Redux
+<ShareModalEnhanced
+  useRedux={false}
+  users={users}
+  departments={departments}
+  loading={loading}
+  onFetchUsersAndDepartments={fetchData}
+  open={isOpen}
+  onClose={handleClose}
+/>
+```
+
+#### Store Configuration Changes
+- **Before**: Redux store automatically configured with all slices
+- **After**: Must explicitly configure store with library slices
+
+```typescript
+// Before
+import { store } from 'erp-common/src/redux/store';
+
+// After
+import { configureStore } from '@reduxjs/toolkit';
+import { getLibrarySlices } from '@company/erp-ui-library';
+
+const store = configureStore({
+  reducer: {
+    ...getLibrarySlices(),
+    // your app reducers
+  }
+});
+```
+
+#### API Client Configuration
+- **Before**: API client automatically configured
+- **After**: Must explicitly configure API client
+
+```typescript
+// After
+import { createConfiguredApiClient } from '@company/erp-ui-library';
+
+const apiClient = createConfiguredApiClient(
+  baseApiClient,
+  () => ({ authorization: `Bearer ${getToken()}` })
+);
+```
+
+### Migration Path
+
+1. **Install the library**: `npm install @company/erp-ui-library`
+2. **Install peer dependencies**: React, Material-UI, etc.
+3. **Update imports**: Change from workspace paths to npm package imports
+4. **Add ERPUIProvider**: Wrap your app with the provider
+5. **Configure Redux** (if using): Set up store with library slices
+6. **Update enhanced components**: Add `useRedux` prop and handle both patterns
+7. **Test thoroughly**: Ensure all functionality works as expected
+8. **Remove old workspace**: Clean up erp-common workspace module
+
+### Documentation
+- [README.md](README.md) - Installation and basic usage
+- [API.md](API.md) - Comprehensive API documentation
+- [EXAMPLES.md](EXAMPLES.md) - Usage examples and patterns
+- [MIGRATION.md](MIGRATION.md) - Detailed migration guide from erp-common
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Common issues and solutions
+
+### Development
+- TypeScript support with strict type checking
+- Jest testing framework with React Testing Library
+- ESLint configuration for code quality
+- Vite build system for fast development and optimized production builds
+- Size limit monitoring to prevent bundle bloat
+- Comprehensive test coverage for components, hooks, and utilities
+
+### Performance
+- Tree shaking support for optimal bundle size
+- Lazy loading support for large components
+- Memoization utilities for expensive calculations
+- Optimized Material-UI theme integration
+- Minimal runtime overhead for unused features
+
+---
+
+## Version History
+
+### [1.0.0] - 2024-01-15
+- Initial release as standalone npm package
+- Migration from erp-common workspace module
+- Comprehensive component library with 80+ components
+- Flexible Redux integration
+- Full TypeScript support
+- Theming system with light/dark modes
+- RTL/LTR support
+- Internationalization support
+- Complete documentation and migration guide
+
+---
+
+## Upgrade Guide
+
+### From erp-common workspace to 1.0.0
+
+This is a major migration from a workspace module to an npm package. Please follow the detailed [Migration Guide](MIGRATION.md) for step-by-step instructions.
+
+**Key Changes:**
+1. Package installation required
+2. Import paths changed
+3. Provider wrapper required
+4. Redux integration made optional and explicit
+5. Enhanced components with flexible usage patterns
+
+**Estimated Migration Time:** 1-2 weeks depending on application size
+
+**Support:** See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for common issues and solutions
+
+---
+
+## Future Releases
+
+### Planned for 1.1.0
+- Additional form components (file upload, rich text editor)
+- Enhanced data visualization components
+- Improved accessibility features
+- Performance optimizations
+- Additional utility functions
+
+### Planned for 1.2.0
+- Mobile-responsive component variants
+- Advanced theming capabilities
+- Component composition utilities
+- Enhanced testing utilities
+
+### Planned for 2.0.0
+- React 19 support
+- Material-UI v6 upgrade
+- Breaking changes for improved API consistency
+- New component architecture patterns
+
+---
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
+- Code style and standards
+- Testing requirements
+- Documentation standards
+- Pull request process
+- Issue reporting
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- **Documentation**: [GitHub Repository](https://github.com/company/erp-ui-library)
+- **Issues**: [GitHub Issues](https://github.com/company/erp-ui-library/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/company/erp-ui-library/discussions)
 - **Email**: erp-ui-library@company.com