@acorex/components 21.0.3-next.3 → 21.0.3-next.30

package/types/acorex-components-conversation2.d.ts

@@ -13,7 +13,8 @@ import { AXContextMenuOpeningEvent, AXContextMenuItemsClickEvent } from '@acorex
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXMapMarker } from '@acorex/components/map';
-import { AXFileTypeInfoProvider, AXFileType, AXFileService } from '@acorex/core/file';
+import * as _acorex_core_file from '@acorex/core/file';
+import { AXFileTypeInfoProvider, AXFileType, AXFileService, AXFileTypeRegistryService, AXFileTypeExtensionHint, AXFileTypeOpenContext } from '@acorex/core/file';
 import { SafeHtml } from '@angular/platform-browser';
 import * as i1 from '@angular/common';
 import * as i2 from '@angular/forms';
@@ -460,6 +461,8 @@ interface AXConversation {
     id: string;
     /** Conversation type */
     type: AXConversationType;
+    /** User who created this conversation */
+    creatorId?: string;
     /** Conversation title/name */
     title: string;
     /** Conversation avatar/image URL */
@@ -1346,8 +1349,6 @@ declare class AXComposerComponent implements OnDestroy {
     readonly composerPopupComponent: typeof AXComposerPopupComponent;
     /** Input placeholder - use service */
     readonly placeholder: _angular_core.Signal<string>;
-    /** Sending message state */
-    readonly sendingMessage: _angular_core.WritableSignal<boolean>;
     /** Typing indicator subject for rate limiting */
     private readonly typingSubject;
     constructor();
@@ -1504,6 +1505,10 @@ declare class AXComposerService {
     onConversationChanged(previousConversationId: string | null, currentConversationId: string | null): void;
     sendTypingIndicator(conversationId: string): Promise<void>;
     sendMessage(command: AXSendMessageCommand, options?: AXSendMessageOptions): Promise<void>;
+    /**
+     * Resets composer input immediately when a send starts so upload/API work continues in the background.
+     */
+    clearComposerInput(conversationId?: string): void;
     /**
      * Show a component in the composer (full-width mode)
      */
@@ -1857,6 +1862,8 @@ interface AXConversationCreateData {
     type: AXConversationType;
     /** Participant user IDs */
     participantIds: string[];
+    /** User who creates the conversation */
+    creatorId?: string;
     /** Conversation title (for groups/channels) */
     title?: string;
     /** Conversation description */
@@ -3126,7 +3133,7 @@ declare class AXConversationService {
     private readonly _messageDeleted$;
     private readonly _typingIndicator$;
     private readonly _presenceUpdate$;
-    /** All conversations */
+    /** All conversations (viewer-scoped display titles for private 1v1 chats) */
     readonly conversations: _angular_core.Signal<AXConversation[]>;
     /** Active conversation ID */
     readonly activeConversationId: _angular_core.Signal<string>;
@@ -3715,6 +3722,8 @@ declare class AXCnvMediaPlaybackInfoBarBannerComponent implements AXMessageInfoB
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXCnvMediaPlaybackInfoBarBannerComponent, "ax-cnv-media-playback-info-bar-banner", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "currentTime": { "alias": "currentTime"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "isPlaying": { "alias": "isPlaying"; "required": false; "isSignal": true; }; "onTogglePlay": { "alias": "onTogglePlay"; "required": false; "isSignal": true; }; "playbackSpeed": { "alias": "playbackSpeed"; "required": false; "isSignal": true; }; "onCycleSpeed": { "alias": "onCycleSpeed"; "required": false; "isSignal": true; }; "showSpeedControl": { "alias": "showSpeedControl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Caption first, else a label with optional extra lines (URLs, names). */
+declare function mediaCopyText(caption: string | undefined, singleLabel: string, pluralLabel: string, count: number, lines: (string | undefined)[]): string;
 /**
  * Registers the live renderer on {@link AXMessageListService} for message actions.
  */
@@ -4155,8 +4164,8 @@ declare class AXMessageListComponent implements OnDestroy {
     /** Handle context menu item click for messages */
     handleMessageContextMenuItemClick(event: AXContextMenuItemsClickEvent, message: AXMessage): void;
     /**
-     * TrackBy function for message groups
-     * Tracks by date only to prevent re-rendering when messages are added
+     * TrackBy function for message groups.
+     * Include the latest message id so new messages in the same date group re-render.
      */
     trackMessageGroup(index: number, group: {
         date: string;
@@ -5361,46 +5370,41 @@ declare class AXVoiceRecorderComponent {
 }
 
 declare class AXConversationAudioFileTypeProvider extends AXFileTypeInfoProvider {
-    items(): Promise<AXFileType<Record<string, (ctx: {
-        readAsDataUrl: (file: File | Blob) => Promise<string>;
-        platformId: object;
-    }, ...args: unknown[]) => Promise<unknown> | unknown>>[]>;
+    items(): Promise<AXFileType<{
+        [x: string]: (ctx: _acorex_core_file.AXFileTypeContext, ...args: unknown[]) => Promise<unknown> | unknown;
+    }>[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationAudioFileTypeProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationAudioFileTypeProvider>;
 }
 
 declare class AXConversationFileFileTypeProvider extends AXFileTypeInfoProvider {
-    items(): Promise<AXFileType<Record<string, (ctx: {
-        readAsDataUrl: (file: File | Blob) => Promise<string>;
-        platformId: object;
-    }, ...args: unknown[]) => Promise<unknown> | unknown>>[]>;
+    items(): Promise<AXFileType<{
+        [x: string]: (ctx: _acorex_core_file.AXFileTypeContext, ...args: unknown[]) => Promise<unknown> | unknown;
+    }>[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationFileFileTypeProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationFileFileTypeProvider>;
 }
 
 declare class AXConversationImageFileTypeProvider extends AXFileTypeInfoProvider {
-    items(): Promise<AXFileType<Record<string, (ctx: {
-        readAsDataUrl: (file: File | Blob) => Promise<string>;
-        platformId: object;
-    }, ...args: unknown[]) => Promise<unknown> | unknown>>[]>;
+    items(): Promise<AXFileType<{
+        [x: string]: (ctx: _acorex_core_file.AXFileTypeContext, ...args: unknown[]) => Promise<unknown> | unknown;
+    }>[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationImageFileTypeProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationImageFileTypeProvider>;
 }
 
 declare class AXConversationVideoFileTypeProvider extends AXFileTypeInfoProvider {
-    items(): Promise<AXFileType<Record<string, (ctx: {
-        readAsDataUrl: (file: File | Blob) => Promise<string>;
-        platformId: object;
-    }, ...args: unknown[]) => Promise<unknown> | unknown>>[]>;
+    items(): Promise<AXFileType<{
+        [x: string]: (ctx: _acorex_core_file.AXFileTypeContext, ...args: unknown[]) => Promise<unknown> | unknown;
+    }>[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationVideoFileTypeProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationVideoFileTypeProvider>;
 }
 
 declare class AXConversationVoiceFileTypeProvider extends AXFileTypeInfoProvider {
-    items(): Promise<AXFileType<Record<string, (ctx: {
-        readAsDataUrl: (file: File | Blob) => Promise<string>;
-        platformId: object;
-    }, ...args: unknown[]) => Promise<unknown> | unknown>>[]>;
+    items(): Promise<AXFileType<{
+        [x: string]: (ctx: _acorex_core_file.AXFileTypeContext, ...args: unknown[]) => Promise<unknown> | unknown;
+    }>[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationVoiceFileTypeProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationVoiceFileTypeProvider>;
 }
@@ -5424,7 +5428,7 @@ declare const AX_CONVERSATION_COMPOSER_LOCATION_ACTION: AXComposerAction;
 
 declare function mergeUploadResult(type: AXMessageType, payload: AXMessagePayload, result: AXUploadResult): AXMessagePayload;
 declare function applyLocalPreview(type: AXMessageType, payload: AXMessagePayload, localUrl: string, mimeType?: string): AXMessagePayload;
-declare function toUploaderReference(payload: AXMessagePayload): AXUploaderReference;
+declare function toUploaderReference$1(payload: AXMessagePayload): AXUploaderReference;
 declare function createObjectUrl(platformId: object, blob: Blob): string;
 declare function revokeObjectUrl(platformId: object, url: string): void;
 declare function createLocalPreviewUrl(fileService: AXFileService, platformId: object, source: File | Blob, messageType: AXMessageType): Promise<string | undefined>;
@@ -5470,7 +5474,7 @@ declare class AXConversationInfoPanelComponent extends AXClosableComponent imple
     conversationService: AXConversationService;
     readonly activeTab: _angular_core.WritableSignal<"profile" | "manage">;
     readonly showMemberSearch: _angular_core.WritableSignal<boolean>;
-    readonly panelView: _angular_core.WritableSignal<"media" | "main">;
+    readonly panelView: _angular_core.WritableSignal<"main" | "media">;
     readonly selectedMediaCategory: _angular_core.WritableSignal<AXConversationMediaCategory>;
     readonly conversationMessages: _angular_core.WritableSignal<AXMessage[]>;
     readonly loadingMessages: _angular_core.WritableSignal<boolean>;
@@ -5772,7 +5776,22 @@ declare function resolvePrivatePeerUserId(conversation: AXConversation, currentU
 /** Whether `auto` kind should render a user avatar for this conversation. */
 declare function shouldUseUserAvatarForConversation(conversation: AXConversation, currentUserId?: string): boolean;
 declare function resolveUserAvatarDisplay(userId: string, conversation: AXConversation | undefined, message?: AXMessage): AXConversationAvatarDisplay;
-declare function resolveConversationAvatarDisplay(conversation: AXConversation): AXConversationAvatarDisplay;
+declare function resolveConversationAvatarDisplay(conversation: AXConversation, currentUserId?: string): AXConversationAvatarDisplay;
+
+/** True when the stored title is a placeholder, not a user-defined name. */
+declare function isGenericPrivateConversationTitle(title: string | undefined): boolean;
+/** Other participant in a private 1v1 chat (excludes the current viewer). */
+declare function resolvePrivatePeerParticipant(conversation: AXConversation, currentUserId?: string): AXParticipant | undefined;
+/**
+ * Resolves the display title for the current viewer.
+ * Private 1v1 chats show the other participant's name when no custom title is set.
+ */
+declare function resolveConversationTitleForViewer(conversation: AXConversation, currentUserId?: string): string;
+/**
+ * Returns a viewer-scoped copy of a conversation with dynamic private title/avatar/icon.
+ * Does not mutate the source object.
+ */
+declare function resolveConversationForViewer(conversation: AXConversation, currentUserId?: string): AXConversation;
 
 /** Resolves typed `profile`, falling back to legacy `metadata.profile`. */
 declare function resolveParticipantProfile(participant?: AXParticipant): AXUserProfile;
@@ -5969,6 +5988,32 @@ declare function validateLatitude(latitude: number | undefined | null): AXValida
  */
 declare function validateLongitude(longitude: number | undefined | null): AXValidationResult;
 
+/** First non-empty URL for img/video/audio at runtime (includes resolved blob: URLs). */
+declare function pickDisplayMediaUrl(...candidates: (string | null | undefined)[]): string;
+
+/** Format image message payload for rendering (array shape, safe thumbnails). */
+declare function normalizeImagePayload(payload: AXImagePayload): AXImagePayload;
+/** Preferred URL for grid / lightbox (never inline base64 thumbnails). */
+declare function resolveImageDisplayUrl(image: AXImageMediaItem): string | undefined;
+
+declare function toUploaderReference(item: AXMediaItemFields): AXUploaderReference;
+
+/**
+ * Resolves multimedia payload URLs for renderers (direct url or mediaId via uploader).
+ */
+
+/**
+ * Creates a signal of the resolved playback URL for a media reference.
+ */
+declare function createResolvedMediaUrlSignal(reference: Signal<AXUploaderReference | undefined>): Signal<string | null>;
+
+/** Infer extension/MIME hints from a persisted message payload. */
+declare function inferFileExtensionHintFromMessage(message: AXMessage): AXFileTypeExtensionHint;
+/** Use file-type `copy` on the message when `message.fileType` is set; otherwise fallback. */
+declare function copyWithFileTypeFallback(message: AXMessage, registry: AXFileTypeRegistryService, fallback: () => string): Promise<string>;
+/** Use file-type `open` on the message when `message.fileType` is set. */
+declare function openWithFileType(message: AXMessage, registry: AXFileTypeRegistryService, ctx: AXFileTypeOpenContext): Promise<boolean>;
+
 /**
  * Error Message Constants
  * Centralized error messages with i18n support structure
@@ -6361,5 +6406,5 @@ declare function getErrorMessage(code: string, params?: Record<string, string |
  */
 type AXErrorCode = typeof MESSAGE_ERRORS[keyof typeof MESSAGE_ERRORS]['code'] | typeof FILE_ERRORS[keyof typeof FILE_ERRORS]['code'] | typeof USER_ERRORS[keyof typeof USER_ERRORS]['code'] | typeof CONVERSATION_ERRORS[keyof typeof CONVERSATION_ERRORS]['code'] | typeof CONNECTION_ERRORS[keyof typeof CONNECTION_ERRORS]['code'] | typeof LOCATION_ERRORS[keyof typeof LOCATION_ERRORS]['code'] | typeof URL_ERRORS[keyof typeof URL_ERRORS]['code'];
 
-export { AXAudioPickerComponent, AXAudioRendererComponent, AXBaseRegistry, AXCnvMediaPlaybackInfoBarBannerComponent, AXComposerActionRegistry, AXComposerComponent, AXComposerPopupComponent, AXComposerService, AXComposerTabRegistry, AXConversation2Module, AXConversationAiApiKey, AXConversationAiResponderService, AXConversationApi, AXConversationContainerComponent, AXConversationContainerDirective, AXConversationDateUtilsService, AXConversationIndexedDbConversationApi, AXConversationIndexedDbMessageAiApi, AXConversationIndexedDbMessageApi, AXConversationIndexedDbRealtimeApi, AXConversationIndexedDbStorage, AXConversationIndexedDbStores, AXConversationIndexedDbUserApi, AXConversationInfoMediaViewComponent, AXConversationInfoPanelComponent, AXConversationItemActionRegistry, AXConversationMessageRendererStateComponent, AXConversationMessageUtilsService, AXConversationService, AXConversationSharedStorage, AXConversationTabRegistry, AXEmojiTabComponent, AXErrorHandlerService, AXFallbackRendererComponent, AXFilePickerComponent, AXFileRendererComponent, AXForwardMessageDialogComponent, AXImagePickerComponent, AXImageRendererComponent, AXInfiniteScrollDirective, AXInfoBarActionRegistry, AXInfoBarComponent, AXInfoBarSearchComponent, AXInfoBarService, AXLocationPickerComponent, AXLocationRendererComponent, AXMessageActionRegistry, AXMessageApi, AXMessageListComponent, AXMessageListNoActiveDefaultComponent, AXMessageListService, AXMessageRendererRegistry, AXNewConversationDialogComponent, AXPickerFooterComponent, AXPickerHeaderComponent, AXRealtimeApi, AXRegistryService, AXSidebarComponent, AXSidebarService, AXStickerRendererComponent, AXStickerTabComponent, AXSystemRendererComponent, AXTextRendererComponent, AXUserApi, AXVideoPickerComponent, AXVideoRendererComponent, AXVoiceRecorderComponent, AXVoiceRendererComponent, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_FILE_TYPE_PROVIDERS, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_CONVERSATION_AVATAR_COMPONENT, AX_CONVERSATION_CURSOR_PREFIX, AX_CONVERSATION_FALLBACK_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_INFO_BAR_ARCHIVE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_STICKER_RENDERER, AX_CONVERSATION_SYSTEM_RENDERER, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_ARCHIVED, AX_CONVERSATION_TAB_BOT, AX_CONVERSATION_TAB_CHANNELS, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_UNREAD, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_USER_AVATAR_COMPONENT, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_DEFAULT_CONVERSATION_CONFIG, AX_MESSAGE_CURSOR_PREFIX, AX_STICKER_API_KEY, CONNECTION_ERRORS, CONVERSATION_CONFIG, CONVERSATION_ERRORS, CONVERSATION_FILE_TYPES_READY, DEFAULT_COMPOSER_ACTIONS, DEFAULT_COMPOSER_TABS, DEFAULT_CONVERSATION_ITEM_ACTIONS, DEFAULT_CONVERSATION_TABS, DEFAULT_INFO_BAR_ACTIONS, DEFAULT_MESSAGE_ACTIONS, DEFAULT_MESSAGE_RENDERERS, ERROR_HANDLER_CONFIG, ERROR_MESSAGES, FILE_ERRORS, LOCATION_ERRORS, MESSAGE_ERRORS, REGISTRY_CONFIG, URL_ERRORS, USER_ERRORS, applyConversationFilters, applyLocalPreview, axConversationIndexedDbStorage, conversationSharedStorage, createLocalPreviewUrl, createObjectUrl, encodeConversationCursor, encodeMessageCursor, formatErrorMessage, getConversationLastActivity, getConversationMessagesNewestFirst, getErrorMessage, getSortedConversationsForInbox, mergeUploadResult, mergeWithDefaults, normalizeAllConversationMessageIndexes, paginateChatNewestFirst, paginateChatOldestFirst, parseChatCursor, provideConversation, provideConversationComposerFileTypes, provideConversationFileCatalog, registerChatMessage, resolveConversationAvatarDisplay, resolveParticipantProfile, resolvePrivatePeerUserId, resolveUserAvatarDisplay, revokeObjectUrl, sanitizeInput, shouldUseUserAvatarForConversation, sortConversationMessageIds, toUploaderReference, unregisterChatMessage, validateConversationId, validateEmail, validateLatitude, validateLongitude, validateMessagePayload, validateMessageText, validateMessageType, validateUrl, validateUserId, validateUserIds };
+export { AXAudioPickerComponent, AXAudioRendererComponent, AXBaseRegistry, AXCnvMediaPlaybackInfoBarBannerComponent, AXComposerActionRegistry, AXComposerComponent, AXComposerPopupComponent, AXComposerService, AXComposerTabRegistry, AXConversation2Module, AXConversationAiApiKey, AXConversationAiResponderService, AXConversationApi, AXConversationContainerComponent, AXConversationContainerDirective, AXConversationDateUtilsService, AXConversationIndexedDbConversationApi, AXConversationIndexedDbMessageAiApi, AXConversationIndexedDbMessageApi, AXConversationIndexedDbRealtimeApi, AXConversationIndexedDbStorage, AXConversationIndexedDbStores, AXConversationIndexedDbUserApi, AXConversationInfoMediaViewComponent, AXConversationInfoPanelComponent, AXConversationItemActionRegistry, AXConversationMessageRendererStateComponent, AXConversationMessageUtilsService, AXConversationService, AXConversationSharedStorage, AXConversationTabRegistry, AXEmojiTabComponent, AXErrorHandlerService, AXFallbackRendererComponent, AXFilePickerComponent, AXFileRendererComponent, AXForwardMessageDialogComponent, AXImagePickerComponent, AXImageRendererComponent, AXInfiniteScrollDirective, AXInfoBarActionRegistry, AXInfoBarComponent, AXInfoBarSearchComponent, AXInfoBarService, AXLocationPickerComponent, AXLocationRendererComponent, AXMessageActionRegistry, AXMessageApi, AXMessageListComponent, AXMessageListNoActiveDefaultComponent, AXMessageListService, AXMessageRendererCopyHostComponent, AXMessageRendererRegistry, AXNewConversationDialogComponent, AXPickerFooterComponent, AXPickerHeaderComponent, AXRealtimeApi, AXRegistryService, AXSidebarComponent, AXSidebarService, AXStickerRendererComponent, AXStickerTabComponent, AXSystemRendererComponent, AXTextRendererComponent, AXUserApi, AXVideoPickerComponent, AXVideoRendererComponent, AXVoiceRecorderComponent, AXVoiceRendererComponent, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_FILE_TYPE_PROVIDERS, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_CONVERSATION_AVATAR_COMPONENT, AX_CONVERSATION_CURSOR_PREFIX, AX_CONVERSATION_FALLBACK_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_INFO_BAR_ARCHIVE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_STICKER_RENDERER, AX_CONVERSATION_SYSTEM_RENDERER, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_ARCHIVED, AX_CONVERSATION_TAB_BOT, AX_CONVERSATION_TAB_CHANNELS, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_UNREAD, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_USER_AVATAR_COMPONENT, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_DEFAULT_CONVERSATION_CONFIG, AX_MESSAGE_CURSOR_PREFIX, AX_STICKER_API_KEY, CONNECTION_ERRORS, CONVERSATION_CONFIG, CONVERSATION_ERRORS, CONVERSATION_FILE_TYPES_READY, DEFAULT_COMPOSER_ACTIONS, DEFAULT_COMPOSER_TABS, DEFAULT_CONVERSATION_ITEM_ACTIONS, DEFAULT_CONVERSATION_TABS, DEFAULT_INFO_BAR_ACTIONS, DEFAULT_MESSAGE_ACTIONS, DEFAULT_MESSAGE_RENDERERS, ERROR_HANDLER_CONFIG, ERROR_MESSAGES, FILE_ERRORS, LOCATION_ERRORS, MESSAGE_ERRORS, REGISTRY_CONFIG, URL_ERRORS, USER_ERRORS, applyConversationFilters, applyLocalPreview, axConversationIndexedDbStorage, conversationSharedStorage, copyWithFileTypeFallback, createLocalPreviewUrl, createObjectUrl, createResolvedMediaUrlSignal, encodeConversationCursor, encodeMessageCursor, formatErrorMessage, getConversationLastActivity, getConversationMessagesNewestFirst, getErrorMessage, getSortedConversationsForInbox, inferFileExtensionHintFromMessage, isGenericPrivateConversationTitle, mediaCopyText, mergeUploadResult, mergeWithDefaults, normalizeAllConversationMessageIndexes, normalizeImagePayload, openWithFileType, paginateChatNewestFirst, paginateChatOldestFirst, parseChatCursor, pickDisplayMediaUrl, provideConversation, provideConversationComposerFileTypes, provideConversationFileCatalog, registerChatMessage, resolveConversationAvatarDisplay, resolveConversationForViewer, resolveConversationTitleForViewer, resolveImageDisplayUrl, resolveParticipantProfile, resolvePrivatePeerParticipant, resolvePrivatePeerUserId, resolveUserAvatarDisplay, revokeObjectUrl, sanitizeInput, shouldUseUserAvatarForConversation, sortConversationMessageIds, toUploaderReference as toMediaItemUploaderReference, toUploaderReference$1 as toUploaderReference, unregisterChatMessage, validateConversationId, validateEmail, validateLatitude, validateLongitude, validateMessagePayload, validateMessageText, validateMessageType, validateUrl, validateUserId, validateUserIds };
 export type { AXApiError, AXAudioMediaItem, AXAudioPayload, AXBlockReportReason, AXCallEvent, AXChatCursorKind, AXComposerAction, AXComposerActionComponent, AXComposerActionContext, AXComposerActiveComponent, AXComposerTab, AXConnectionEvent, AXConnectionOptions, AXConnectionStatus, AXConversation, AXConversationAiResponderConfig, AXConversationAvatarComponents, AXConversationAvatarDisplay, AXConversationAvatarKind, AXConversationConfig, AXConversationConversationAvatarComponent, AXConversationCreateData, AXConversationError, AXConversationFilter, AXConversationFilters, AXConversationIndexedDbMediaRecord, AXConversationItemAction, AXConversationItemActionContext, AXConversationMetadata, AXConversationOptions, AXConversationSettings, AXConversationSettingsUpdate, AXConversationSort, AXConversationStatus, AXConversationTab, AXConversationType, AXConversationUpdateData, AXConversationUploadOptions, AXConversationUserAvatarComponent, AXDeleteMessageCommand, AXEditMessageCommand, AXErrorCode, AXErrorHandlerConfig, AXErrorMessage, AXErrorSeverity, AXFileMediaItem, AXFilePayload, AXGroupedReaction, AXImageMediaItem, AXImagePayload, AXInfoBarAction, AXInfoBarActionComponent, AXInfoBarActionContext, AXInfoBarActiveBanner, AXInfoBarActiveComponent, AXLink, AXLinkPreview, AXLoadMessagesResult, AXLocationPayload, AXMediaItemFields, AXMention, AXMessage, AXMessageAction, AXMessageActionContext, AXMessageForwardData, AXMessageInfoBarBannerComponent, AXMessageListEmptyComponent, AXMessagePayload, AXMessageRenderer, AXMessageRendererCapabilities, AXMessageRendererComponent, AXMessageRendererContentState, AXMessageRendererState, AXMessageSearchFilters, AXMessageStatus, AXMessageType, AXNotificationEvent, AXPaginatedResult, AXPagination, AXPaginationState, AXParsedChatCursor, AXParticipant, AXParticipantRole, AXParticipantStatus, AXParticipantUpdate, AXPinnedMessage, AXPlaybackBannerInputs, AXPollOption, AXPollPayload, AXPresenceStatus, AXPresenceUpdate, AXReaction, AXReadReceipt, AXRegistryConfiguration, AXRegistryItem, AXSendMessageCommand, AXSendMessageOptions, AXSendMessageUploadSource, AXStickerPayload, AXSystemPayload, AXTextFormat, AXTextPayload, AXTypingIndicator, AXUploaderReference, AXUploaderResult, AXUserProfile, AXUserProfileUpdate, AXUserRole, AXUserSearchFilters, AXValidationResult, AXVideoMediaItem, AXVideoPayload, AXVoicePayload, DropdownMenuItem, UploaderFilePreview };

package/types/acorex-components-image-editor.d.ts

@@ -12,8 +12,9 @@ import * as i7 from '@acorex/components/decorators';
 import * as i8 from '@acorex/components/loading';
 import * as i9 from '@acorex/components/dialog';
 
+type AXImageEditorTool = 'pen' | 'highlight' | 'crop' | 'rotate';
 declare class AXImageEditorService {
-    activeToolState: _angular_core.WritableSignal<"pen" | "highlight" | "crop" | "rotate" | "history">;
+    activeToolState: _angular_core.WritableSignal<AXImageEditorTool>;
     penColor: _angular_core.WritableSignal<string | CanvasGradient | CanvasPattern>;
     highlightColor: _angular_core.WritableSignal<string | CanvasGradient | CanvasPattern>;
     penWidth: _angular_core.WritableSignal<number>;
@@ -30,6 +31,9 @@ declare class AXImageEditorService {
     undoPressed: _angular_core.WritableSignal<boolean>;
     redoPressed: _angular_core.WritableSignal<boolean>;
     cropperRatio: _angular_core.WritableSignal<string>;
+    cropperSize: _angular_core.WritableSignal<number>;
+    toggleTool(tool: AXImageEditorTool): void;
+    activateTool(tool: AXImageEditorTool): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXImageEditorService>;
 }
@@ -41,6 +45,8 @@ declare class AXImageEditorService {
 declare class AXImageEditorCropperWindowComponent implements OnDestroy {
     #private;
     readonly showGrid: _angular_core.InputSignal<boolean>;
+    /** Base size in pixels used to calculate the initial cropper window dimensions. */
+    readonly size: _angular_core.InputSignal<number>;
     protected service: AXImageEditorService;
     private ngZone;
     private selectedHandle;
@@ -78,7 +84,7 @@ declare class AXImageEditorCropperWindowComponent implements OnDestroy {
     protected changeSizeHandler(e: MouseEvent): void;
     protected clearSelector(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorCropperWindowComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorCropperWindowComponent, "ax-image-editor-cropper-window", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorCropperWindowComponent, "ax-image-editor-cropper-window", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDestroy {
@@ -86,6 +92,10 @@ declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDe
      * its change grid display state.
      */
     readonly showGrid: _angular_core.InputSignal<boolean>;
+    /**
+     * Base size in pixels for the initial cropper window dimensions.
+     */
+    readonly cropperSize: _angular_core.InputSignal<number>;
     /**
      * its change grid display state.
      */
@@ -141,13 +151,13 @@ declare class AXImageEditorViewComponent extends MXBaseComponent implements OnDe
     /** @ignore */
     protected mouseUpHandler(): void;
     /** @ignore */
-    cropButtonHandler(): void;
+    crop(): Promise<void>;
     /** @ignore */
     protected rotateImage(): void;
     /** @ignore */
     protected saveImageChange(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorViewComponent, "ax-image-editor-view", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorViewComponent, "ax-image-editor-view", never, { "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "cropperSize": { "alias": "cropperSize"; "required": false; "isSignal": true; }; "src": { "alias": "src"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare const AXImageEditorContainerComponent_base: polytype.Polytype.ClusteredConstructor<[{
@@ -165,41 +175,48 @@ declare class AXImageEditorContainerComponent extends AXImageEditorContainerComp
     protected service: AXImageEditorService;
     imageEditorContainer: _angular_core.Signal<ElementRef<any>>;
     view: _angular_core.Signal<AXImageEditorViewComponent>;
-    aspectRatio: _angular_core.InputSignal<string[]>;
-    protected cropButtonHandler(): void;
+    /** Applies the current cropper selection. */
+    crop(): Promise<void>;
     get __hostClass(): string;
     private get __hostName();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorContainerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorContainerComponent, "ax-image-editor-container", never, { "look": { "alias": "look"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; }, { "onValueChanged": "onValueChanged"; }, ["view"], ["ax-header", "ax-image-editor-view", "ax-validation-rule"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorContainerComponent, "ax-image-editor-container", never, { "look": { "alias": "look"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "onValueChanged": "onValueChanged"; }, ["view"], ["ax-header", "ax-image-editor-view", "ax-footer", "ax-validation-rule"], true, never>;
 }
 
 /**
- * paint mode.
+ * Base class for image editor tool trigger components.
  * @category Components
  */
-declare class AXImageEditorCropComponent {
+declare abstract class AXImageEditorToolComponent {
     protected service: AXImageEditorService;
-    cropPressed: _angular_core.OutputEmitterRef<void>;
+    abstract readonly tool: AXImageEditorTool;
+    setActive(): void;
+}
+
+/**
+ * Crop tool trigger for the image editor toolbar.
+ * @category Components
+ */
+declare class AXImageEditorCropComponent extends AXImageEditorToolComponent {
+    #private;
+    readonly tool = "crop";
+    private container;
+    /** Aspect ratio presets. Append `:active` to mark the default ratio, e.g. `'2:1:active'`. */
     aspectRatio: _angular_core.InputSignal<string[]>;
-    protected cropButtonHandler(): void;
-    protected ratioHandler(r: '1:1' | '16:9' | string): void;
+    /** Base size in pixels for the initial cropper window dimensions. */
+    size: _angular_core.InputSignal<number>;
+    /** Applies the current cropper selection. */
+    crop(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorCropComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorCropComponent, "ax-image-editor-crop", never, { "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; }, { "cropPressed": "cropPressed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorCropComponent, "ax-image-editor-crop", never, { "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
- * paint mode.
+ * Highlight tool trigger for the image editor toolbar.
  * @category Components
  */
-declare class AXImageEditorHighlightComponent {
-    protected service: AXImageEditorService;
-    /** @ignore */
-    protected selectedColor: _angular_core.WritableSignal<string | CanvasGradient | CanvasPattern>;
-    /** @ignore */
-    protected value: number;
-    protected changeColorHandler(e: string): void;
-    /** @ignore */
-    protected valueHandler(e: number): void;
+declare class AXImageEditorHighlightComponent extends AXImageEditorToolComponent {
+    readonly tool = "highlight";
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorHighlightComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorHighlightComponent, "ax-image-editor-highlight", never, {}, {}, never, never, true, never>;
 }
@@ -217,52 +234,62 @@ declare class AXImageEditorHistoryComponent {
 }
 
 /**
- * paint mode.
+ * Pen tool trigger for the image editor toolbar.
  * @category Components
  */
-declare class AXImageEditorPenComponent {
-    protected service: AXImageEditorService;
-    /** @ignore */
-    protected value: number;
-    /** @ignore */
-    protected selectedColor: _angular_core.WritableSignal<string | CanvasGradient | CanvasPattern>;
-    protected changeColorHandler(e: string): void;
-    /** @ignore */
-    protected valueHandler(e: number): void;
+declare class AXImageEditorPenComponent extends AXImageEditorToolComponent {
+    readonly tool = "pen";
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorPenComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorPenComponent, "ax-image-editor-pen", never, {}, {}, never, never, true, never>;
 }
 
 /**
- * paint mode.
+ * Rotate tool trigger for the image editor toolbar.
  * @category Components
  */
-declare class AXImageEditorRotateComponent {
-    /** @ignore */
-    protected service: AXImageEditorService;
-    /** @ignore */
-    protected rotateRightHandler(): void;
-    /** @ignore */
-    protected rotateLeftHandler(): void;
+declare class AXImageEditorRotateComponent extends AXImageEditorToolComponent {
+    readonly tool = "rotate";
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorRotateComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorRotateComponent, "ax-image-editor-rotate", never, {}, {}, never, never, true, never>;
 }
 
 /**
- * paint mode.
+ * Toolbar layout for configurable image editor tools.
  * @category Components
  */
-declare class AXImageEditorToolSelectorComponent {
+declare class AXImageEditorToolsBarComponent {
+    #private;
     protected service: AXImageEditorService;
-    protected changeToolHandler(tool: 'pen' | 'highlight' | 'crop' | 'rotate'): void;
+    /**
+     * Tool component reference to activate on load.
+     */
+    active: _angular_core.InputSignal<AXImageEditorToolComponent>;
+    /** Hides the tools bar UI while keeping projected tools configurable. */
+    hidden: _angular_core.InputSignal<boolean>;
+    protected penTool: _angular_core.Signal<AXImageEditorPenComponent>;
+    protected highlightTool: _angular_core.Signal<AXImageEditorHighlightComponent>;
+    protected cropTool: _angular_core.Signal<AXImageEditorCropComponent>;
+    protected rotateTool: _angular_core.Signal<AXImageEditorRotateComponent>;
+    protected cropAspectRatio: _angular_core.Signal<string[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorToolsBarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorToolsBarComponent, "ax-image-editor-tools-bar", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, ["penTool", "highlightTool", "cropTool", "rotateTool"], ["ax-image-editor-pen, ax-image-editor-highlight, ax-image-editor-crop, ax-image-editor-rotate"], true, never>;
+}
+
+/**
+ * Convenience wrapper that includes all image editor tools.
+ * @category Components
+ */
+declare class AXImageEditorToolSelectorComponent {
+    aspectRatio: _angular_core.InputSignal<string[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorToolSelectorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorToolSelectorComponent, "ax-image-editor-tool-selector", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXImageEditorToolSelectorComponent, "ax-image-editor-tool-selector", never, { "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXImageEditorModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXImageEditorModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXImageEditorModule, never, [typeof i1.AXButtonModule, typeof i2.FormsModule, typeof i3.AXRangeSliderModule, typeof i4.AXSelectBoxModule, typeof i5.AXColorBoxModule, typeof i6.AXPopoverModule, typeof i7.AXDecoratorModule, typeof i8.AXLoadingModule, typeof i9.AXDialogModule, typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent], [typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXImageEditorModule, never, [typeof i1.AXButtonModule, typeof i2.FormsModule, typeof i3.AXRangeSliderModule, typeof i4.AXSelectBoxModule, typeof i5.AXColorBoxModule, typeof i6.AXPopoverModule, typeof i7.AXDecoratorModule, typeof i8.AXLoadingModule, typeof i9.AXDialogModule, typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent], [typeof AXImageEditorViewComponent, typeof AXImageEditorContainerComponent, typeof AXImageEditorCropComponent, typeof AXImageEditorHistoryComponent, typeof AXImageEditorToolSelectorComponent, typeof AXImageEditorToolsBarComponent, typeof AXImageEditorPenComponent, typeof AXImageEditorHighlightComponent, typeof AXImageEditorRotateComponent, typeof AXImageEditorCropperWindowComponent]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXImageEditorModule>;
 }
 
-export { AXImageEditorContainerComponent, AXImageEditorCropComponent, AXImageEditorCropperWindowComponent, AXImageEditorHighlightComponent, AXImageEditorHistoryComponent, AXImageEditorModule, AXImageEditorPenComponent, AXImageEditorRotateComponent, AXImageEditorService, AXImageEditorToolSelectorComponent, AXImageEditorViewComponent };
+export { AXImageEditorContainerComponent, AXImageEditorCropComponent, AXImageEditorCropperWindowComponent, AXImageEditorHighlightComponent, AXImageEditorHistoryComponent, AXImageEditorModule, AXImageEditorPenComponent, AXImageEditorRotateComponent, AXImageEditorService, AXImageEditorToolComponent, AXImageEditorToolSelectorComponent, AXImageEditorToolsBarComponent, AXImageEditorViewComponent };
+export type { AXImageEditorTool };