@acorex/components 20.8.32 → 20.9.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "20.8.32",
+  "version": "20.9.0",
   "peerDependencies": {
-    "@acorex/core": "20.8.32",
-    "@acorex/cdk": "20.8.32",
+    "@acorex/core": "20.9.0",
+    "@acorex/cdk": "20.9.0",
     "polytype": ">=0.17.0",
     "angular-imask": ">=7.6.1",
     "gridstack": ">=12.0.0",
@@ -60,14 +60,14 @@
       "types": "./accordion/index.d.ts",
       "default": "./fesm2022/acorex-components-accordion.mjs"
     },
-    "./action-sheet": {
-      "types": "./action-sheet/index.d.ts",
-      "default": "./fesm2022/acorex-components-action-sheet.mjs"
-    },
     "./alert": {
       "types": "./alert/index.d.ts",
       "default": "./fesm2022/acorex-components-alert.mjs"
     },
+    "./action-sheet": {
+      "types": "./action-sheet/index.d.ts",
+      "default": "./fesm2022/acorex-components-action-sheet.mjs"
+    },
     "./aspect-ratio": {
       "types": "./aspect-ratio/index.d.ts",
       "default": "./fesm2022/acorex-components-aspect-ratio.mjs"
@@ -96,26 +96,26 @@
       "types": "./breadcrumbs/index.d.ts",
       "default": "./fesm2022/acorex-components-breadcrumbs.mjs"
     },
-    "./button": {
-      "types": "./button/index.d.ts",
-      "default": "./fesm2022/acorex-components-button.mjs"
-    },
     "./button-group": {
       "types": "./button-group/index.d.ts",
       "default": "./fesm2022/acorex-components-button-group.mjs"
     },
+    "./button": {
+      "types": "./button/index.d.ts",
+      "default": "./fesm2022/acorex-components-button.mjs"
+    },
     "./calendar": {
       "types": "./calendar/index.d.ts",
       "default": "./fesm2022/acorex-components-calendar.mjs"
     },
-    "./check-box": {
-      "types": "./check-box/index.d.ts",
-      "default": "./fesm2022/acorex-components-check-box.mjs"
-    },
     "./chips": {
       "types": "./chips/index.d.ts",
       "default": "./fesm2022/acorex-components-chips.mjs"
     },
+    "./check-box": {
+      "types": "./check-box/index.d.ts",
+      "default": "./fesm2022/acorex-components-check-box.mjs"
+    },
     "./circular-progress": {
       "types": "./circular-progress/index.d.ts",
       "default": "./fesm2022/acorex-components-circular-progress.mjs"
@@ -148,10 +148,6 @@
       "types": "./conversation/index.d.ts",
       "default": "./fesm2022/acorex-components-conversation.mjs"
     },
-    "./conversation2": {
-      "types": "./conversation2/index.d.ts",
-      "default": "./fesm2022/acorex-components-conversation2.mjs"
-    },
     "./cron-job": {
       "types": "./cron-job/index.d.ts",
       "default": "./fesm2022/acorex-components-cron-job.mjs"
@@ -260,6 +256,10 @@
       "types": "./loading/index.d.ts",
       "default": "./fesm2022/acorex-components-loading.mjs"
     },
+    "./loading-dialog": {
+      "types": "./loading-dialog/index.d.ts",
+      "default": "./fesm2022/acorex-components-loading-dialog.mjs"
+    },
     "./map": {
       "types": "./map/index.d.ts",
       "default": "./fesm2022/acorex-components-map.mjs"
@@ -268,10 +268,6 @@
       "types": "./media-viewer/index.d.ts",
       "default": "./fesm2022/acorex-components-media-viewer.mjs"
     },
-    "./loading-dialog": {
-      "types": "./loading-dialog/index.d.ts",
-      "default": "./fesm2022/acorex-components-loading-dialog.mjs"
-    },
     "./menu": {
       "types": "./menu/index.d.ts",
       "default": "./fesm2022/acorex-components-menu.mjs"
@@ -300,14 +296,14 @@
       "types": "./otp/index.d.ts",
       "default": "./fesm2022/acorex-components-otp.mjs"
     },
-    "./paint": {
-      "types": "./paint/index.d.ts",
-      "default": "./fesm2022/acorex-components-paint.mjs"
-    },
     "./page": {
       "types": "./page/index.d.ts",
       "default": "./fesm2022/acorex-components-page.mjs"
     },
+    "./paint": {
+      "types": "./paint/index.d.ts",
+      "default": "./fesm2022/acorex-components-paint.mjs"
+    },
     "./password-box": {
       "types": "./password-box/index.d.ts",
       "default": "./fesm2022/acorex-components-password-box.mjs"
@@ -324,14 +320,14 @@
       "types": "./picker/index.d.ts",
       "default": "./fesm2022/acorex-components-picker.mjs"
     },
-    "./popup": {
-      "types": "./popup/index.d.ts",
-      "default": "./fesm2022/acorex-components-popup.mjs"
-    },
     "./popover": {
       "types": "./popover/index.d.ts",
       "default": "./fesm2022/acorex-components-popover.mjs"
     },
+    "./popup": {
+      "types": "./popup/index.d.ts",
+      "default": "./fesm2022/acorex-components-popup.mjs"
+    },
     "./progress-bar": {
       "types": "./progress-bar/index.d.ts",
       "default": "./fesm2022/acorex-components-progress-bar.mjs"
@@ -396,26 +392,26 @@
       "types": "./select-box/index.d.ts",
       "default": "./fesm2022/acorex-components-select-box.mjs"
     },
-    "./selection-list-2": {
-      "types": "./selection-list-2/index.d.ts",
-      "default": "./fesm2022/acorex-components-selection-list-2.mjs"
-    },
     "./selection-list": {
       "types": "./selection-list/index.d.ts",
       "default": "./fesm2022/acorex-components-selection-list.mjs"
     },
+    "./selection-list-2": {
+      "types": "./selection-list-2/index.d.ts",
+      "default": "./fesm2022/acorex-components-selection-list-2.mjs"
+    },
     "./side-menu": {
       "types": "./side-menu/index.d.ts",
       "default": "./fesm2022/acorex-components-side-menu.mjs"
     },
-    "./slider": {
-      "types": "./slider/index.d.ts",
-      "default": "./fesm2022/acorex-components-slider.mjs"
-    },
     "./skeleton": {
       "types": "./skeleton/index.d.ts",
       "default": "./fesm2022/acorex-components-skeleton.mjs"
     },
+    "./slider": {
+      "types": "./slider/index.d.ts",
+      "default": "./fesm2022/acorex-components-slider.mjs"
+    },
     "./sliding-item": {
       "types": "./sliding-item/index.d.ts",
       "default": "./fesm2022/acorex-components-sliding-item.mjs"

package/scheduler-picker/index.d.ts

@@ -855,6 +855,8 @@ declare class AXSchedulerPickerService {
      * Parses standard cron format: minute hour day month weekday
      */
     fromCronExpression(cron: string): Promise<AXSchedulerPickerValue | null>;
+    /** cron-parser v5 field values may include special chars (L, W, …); keep numbers only. */
+    private cronFieldNumericValues;
     /**
      * Analyze a cron field to extract interval and values
      */

package/conversation2/README.md

@@ -1,463 +0,0 @@
-# @acorex/components/conversation2
-
-A modern, fully-featured conversation/chat component for Angular 18+. Built with signals, standalone components, and extensibility in mind.
-
-## 🚀 Features
-
-- **Real-time Messaging** - Live message updates with WebSocket support
-- **Multiple Message Types** - Text, images, videos, audio, voice, files, locations, stickers, contacts
-- **Rich Interactions** - Reactions, replies, message editing, deletion, forwarding
-- **Group & Private Chats** - Support for 1-on-1 and group conversations
-- **Typing Indicators** - Real-time typing status
-- **Read Receipts** - Message delivery and read status
-- **Infinite Scroll** - Efficient pagination for message history
-- **Search** - Search within conversations and messages
-- **Extensible** - Plugin system for custom message renderers and actions
-- **Responsive** - Mobile-friendly design
-- **Accessibility** - ARIA labels and keyboard navigation
-
-## 📦 Installation
-
-```bash
-npm install @acorex/components/conversation2
-```
-
-## 🔧 Peer Dependencies
-
-This package requires the following peer dependencies:
-
-### Required Angular Dependencies
-
-```json
-{
-  "@angular/common": "^18.0.0",
-  "@angular/core": "^18.0.0",
-  "@angular/forms": "^18.0.0",
-  "rxjs": "^7.8.0"
-}
-```
-
-### Required Acorex Dependencies
-
-#### Core Packages
-
-- `@acorex/cdk/common` - Common utilities and directives
-- `@acorex/core/date-time` - Date and time formatting
-- `@acorex/core/format` - General formatting utilities
-
-#### Component Packages
-
-- `@acorex/components/avatar` - User avatars
-- `@acorex/components/badge` - Notification badges
-- `@acorex/components/button` - Button components
-- `@acorex/components/decorators` - Decorative elements
-- `@acorex/components/dialog` - Dialog service
-- `@acorex/components/dropdown` - Dropdown panels
-- `@acorex/components/image` - Image components
-- `@acorex/components/label` - Label components
-- `@acorex/components/loading` - Loading indicators
-- `@acorex/components/menu` - Context menus
-- `@acorex/components/popover` - Popover components
-- `@acorex/components/popup` - Popup service
-- `@acorex/components/search-box` - Search functionality
-- `@acorex/components/select-box` - Select dropdowns
-- `@acorex/components/tabs` - Tab components
-- `@acorex/components/text-area` - Text input areas
-- `@acorex/components/text-box` - Text input boxes
-- `@acorex/components/toast` - Toast notifications
-- `@acorex/components/tooltip` - Tooltips
-- `@acorex/components/uploader` - File upload functionality
-
-## 🎯 Quick Start
-
-> **New to Conversation2?** Check out our [5-Minute Quick Start Guide](./docs/QUICK-START.md) for the fastest way to get started!
-
-### Detailed Setup
-
-### 1. Standalone Application (Recommended)
-
-```typescript
-import { ApplicationConfig } from '@angular/core';
-import {
-  provideConversation,
-  AXIndexedDBUserApi,
-  AXIndexedDBConversationApi,
-  AXIndexedDBMessageApi,
-  AXIndexedDBRealtimeApi,
-} from '@acorex/components/conversation2';
-
-export const appConfig: ApplicationConfig = {
-  providers: [
-    MyAppUploaderService,
-    provideConversation({
-      userApi: AXIndexedDBUserApi,
-      conversationApi: AXIndexedDBConversationApi,
-      messageApi: AXIndexedDBMessageApi,
-      realtimeApi: AXIndexedDBRealtimeApi, // optional
-      config: {
-        messagePageSize: 50,
-        conversationPageSize: 30,
-      },
-      registry: {
-        // Optional: Register custom message renderers, actions, etc.
-      },
-    }),
-  ],
-};
-```
-
-### 2. NgModule Application (Legacy)
-
-```typescript
-import { NgModule } from '@angular/core';
-import {
-  AXConversation2Module,
-  AXIndexedDBUserApi,
-  AXIndexedDBConversationApi,
-  AXIndexedDBMessageApi,
-  AXIndexedDBRealtimeApi,
-} from '@acorex/components/conversation2';
-
-@NgModule({
-  imports: [
-    AXConversation2Module.forRoot({
-      userApi: AXIndexedDBUserApi,
-      conversationApi: AXIndexedDBConversationApi,
-      messageApi: AXIndexedDBMessageApi,
-      realtimeApi: AXIndexedDBRealtimeApi,
-      config: { /* ... */ },
-    }),
-  ],
-})
-export class AppModule {}
-```
-
-### 3. Use in Template
-
-```html
-<ax-conversation-container></ax-conversation-container>
-```
-
-## 🔌 API Implementation
-
-You must provide an API implementation that extends `AXConversationApi`:
-
-```typescript
-import { Injectable } from '@angular/core';
-import { HttpClient } from '@angular/common/http';
-import { AXConversationApi, AXPagination, AXPaginatedResult } from '@acorex/components/conversation2';
-
-@Injectable()
-export class MyConversationApi extends AXConversationApi {
-  constructor(private http: HttpClient) {
-    super();
-  }
-
-  async connect(): Promise<void> {
-    // Initialize WebSocket connection
-  }
-
-  async fetchConversations(pagination: AXPagination): Promise<AXPaginatedResult<AXConversation>> {
-    const response = await this.http.get('/api/conversations', {
-      params: { page: pagination.page, pageSize: pagination.pageSize }
-    }).toPromise();
-    return response;
-  }
-
-  // Implement other required methods...
-}
-```
-
-### Built-in API Implementations
-
-#### IndexedDB API (Development/Demo)
-
-```typescript
-import {
-  provideConversation,
-  AXIndexedDBUserApi,
-  AXIndexedDBConversationApi,
-  AXIndexedDBMessageApi,
-  AXIndexedDBRealtimeApi,
-} from '@acorex/components/conversation2';
-
-// Provides in-memory storage with sample data
-// Perfect for development and demos
-provideConversation({
-  userApi: AXIndexedDBUserApi,
-  conversationApi: AXIndexedDBConversationApi,
-  messageApi: AXIndexedDBMessageApi,
-  realtimeApi: AXIndexedDBRealtimeApi,
-});
-```
-
-Register a service that subscribes to `AXUploaderService.onUpload`, `onResolveUrl`, and `onDeleteMedia` (see showcase `AXShowcaseConversationIndexedDbUploaderService`).
-
-#### IndexedDB with AI API (AI-Powered Demo)
-
-```typescript
-import {
-  provideConversation,
-  AXIndexedDBUserApi,
-  AXIndexedDBConversationApi,
-  AXIndexedDBMessageAIApi,
-  AXIndexedDBRealtimeApi,
-} from '@acorex/components/conversation2';
-
-// Includes AI-powered auto-responses via message API
-provideConversation({
-  userApi: AXIndexedDBUserApi,
-  conversationApi: AXIndexedDBConversationApi,
-  messageApi: AXIndexedDBMessageAIApi,
-  realtimeApi: AXIndexedDBRealtimeApi,
-});
-```
-
-## ⚙️ Configuration
-
-### Conversation Config
-
-```typescript
-interface AXConversationConfig {
-  // Pagination
-  messagePageSize?: number;             // Default: 50
-  conversationPageSize?: number;        // Default: 30
-  infiniteScrollThreshold?: number;     // Default: 200px
-  scrollThreshold?: number;             // Default: 100px
-
-  // UI Behavior
-  messageHighlightDuration?: number;    // Default: 2000ms
-  typingIndicatorTimeout?: number;      // Default: 3000ms
-}
-```
-
-### Registry Configuration
-
-```typescript
-interface AXRegistryConfiguration {
-  messageRenderers?: AXMessageRenderer[];
-  messageActions?: AXMessageAction[];
-  composerActions?: AXComposerAction[];
-  composerTabs?: AXComposerTab[];
-  conversationTabs?: AXConversationTab[];
-  infoBarActions?: AXInfoBarAction[];
-  conversationItemActions?: AXConversationItemAction[];
-}
-```
-
-## 🎨 Customization
-
-### Custom Message Renderer
-
-```typescript
-import { Component, input } from '@angular/core';
-import { AXMessageRenderer } from '@acorex/components/conversation2';
-
-@Component({
-  selector: 'my-custom-renderer',
-  template: `<div>{{ message().payload.customData }}</div>`
-})
-export class MyCustomRendererComponent {
-  message = input.required<AXMessage>();
-}
-
-const myRenderer: AXMessageRenderer = {
-  type: 'custom',
-  component: MyCustomRendererComponent,
-  priority: 100
-};
-
-// Register in config
-provideConversation({
-  api: MyApi,
-  registry: {
-    messageRenderers: [myRenderer]
-  }
-});
-```
-
-### Custom Message Action
-
-```typescript
-const forwardAction: AXMessageAction = {
-  id: 'forward',
-  label: 'Forward',
-  icon: 'forward',
-  shortcut: 'Ctrl+F',
-  enabled: (message, user) => message.senderId === user.id,
-  execute: async (message, service) => {
-    // Forward logic
-  }
-};
-
-provideConversation({
-  api: MyApi,
-  registry: {
-    messageActions: [forwardAction]
-  }
-});
-```
-
-## 📱 Components
-
-### Main Components
-
-- `<ax-conversation-container>` - Full conversation UI with sidebar, messages, and composer
-- `<ax-conversation-sidebar>` - Conversation list sidebar
-- `<ax-conversation-message-list>` - Message list with virtual scrolling
-- `<ax-conversation-composer>` - Message input area
-- `<ax-conversation-info-bar>` - Conversation header with actions
-
-### Usage Examples
-
-```html
-<!-- Full conversation UI -->
-<ax-conversation-container></ax-conversation-container>
-
-<!-- Custom layout -->
-<div class="my-chat-layout">
-  <ax-conversation-sidebar></ax-conversation-sidebar>
-  <div class="chat-main">
-    <ax-conversation-info-bar></ax-conversation-info-bar>
-    <ax-conversation-message-list></ax-conversation-message-list>
-    <ax-conversation-composer></ax-conversation-composer>
-  </div>
-</div>
-```
-
-## 🎭 Services
-
-### AXConversationService
-
-Main service for conversation operations:
-
-```typescript
-import { inject } from '@angular/core';
-import { AXConversationService } from '@acorex/components/conversation2';
-
-export class MyComponent {
-  private conversationService = inject(AXConversationService);
-
-  async sendMessage() {
-    await this.conversationService.sendMessage({
-      conversationId: 'conv-123',
-      type: 'text',
-      payload: { text: 'Hello!' }
-    });
-  }
-
-  async createConversation() {
-    const conv = await this.conversationService.createConversation(
-      ['user-1', 'user-2'],
-      'private'
-    );
-  }
-}
-```
-
-## 🧪 Testing
-
-```typescript
-import { TestBed } from '@angular/core/testing';
-import { provideConversation, AXConversationService } from '@acorex/components/conversation2';
-import { MockUserApi, MockConversationApi, MockMessageApi } from './mocks/mock-apis';
-
-describe('MyComponent', () => {
-  beforeEach(() => {
-    TestBed.configureTestingModule({
-      providers: [
-        provideConversation({
-          userApi: MockUserApi,
-          conversationApi: MockConversationApi,
-          messageApi: MockMessageApi,
-        }),
-      ],
-    });
-  });
-
-  it('should send message', async () => {
-    const service = TestBed.inject(AXConversationService);
-    const message = await service.sendMessage({
-      conversationId: 'test',
-      type: 'text',
-      payload: { text: 'Test' },
-    });
-    expect(message).toBeDefined();
-  });
-});
-```
-
-## 🎯 Message Types
-
-Supported message types out of the box:
-
-- **text** - Plain text messages
-- **image** - Image messages with thumbnails
-- **video** - Video messages with playback
-- **audio** - Audio file messages
-- **voice** - Voice recordings
-- **file** - Generic file attachments
-- **location** - Location sharing
-- **sticker** - Sticker messages
-- **contact** - Contact card sharing
-- **system** - System notifications
-
-## 🔒 Security Considerations
-
-- **API Keys**: Never hardcode API keys in source code. Use environment variables or injection tokens.
-- **File Upload**: Validate file types and sizes on both client and server.
-- **XSS Protection**: All user content is sanitized by default.
-- **Authentication**: Implement proper authentication in your API layer.
-
-## 📊 Performance Tips
-
-1. **Virtual Scrolling**: Enabled by default for large message lists
-2. **Lazy Loading**: Images and media are loaded on demand
-3. **Pagination**: Messages are loaded in pages to reduce initial load
-4. **Debouncing**: Typing indicators are debounced to reduce network traffic
-5. **Memoization**: Use computed signals for expensive calculations
-
-## 🐛 Troubleshooting
-
-### Common Issues
-
-**Issue**: Messages not appearing
-
-- Check if API is connected: `conversationService.connectionStatus$()`
-- Verify API implementation returns correct data structure
-
-**Issue**: File upload fails
-
-- Check composer file-type catalogs and per-action `uploadConstraints` (`allowedMimeTypes`, `minSize`, `maxSize`)
-- Register a handler service subscribed to `AXUploaderService.onUpload` (and resolve/delete events) with progress and `AbortSignal` support
-
-**Issue**: Styling issues
-
-- Ensure all Acorex component styles are imported
-- Check for CSS conflicts with global styles
-
-## 📚 Additional Resources
-
-- [Quick Start Guide](./docs/QUICK-START.md) - Get started in 5 minutes
-- [Architecture Overview](./docs/ARCHITECTURE-OVERVIEW.md) - Understand the module structure
-- [API Documentation](./docs/ARCHITECTURE-APIS.md) - Implement custom backends
-- [Component Guide](./docs/ARCHITECTURE-COMPONENTS.md) - Learn about components
-- [Plugin System](./docs/ARCHITECTURE-PLUGINS.md) - Extend functionality
-- [Usage Guide](./docs/USAGE-GUIDE.md) - Advanced usage patterns
-
-## 🤝 Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details.
-
-## 📄 License
-
-MIT License - see LICENSE file for details
-
-## 🔄 Changelog
-
-See [CHANGELOG.md](./CHANGELOG.md) for version history and updates.
-
-## 💬 Support
-
-- GitHub Issues: [Report a bug](https://github.com/acorexui/acorex-ui/issues)
-- Discussions: [Ask questions](https://github.com/acorexui/acorex-ui/discussions)