stream-chat-angular 2.14.0 → 2.15.0

package/assets/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.14.0";
+export declare const version = "2.15.0";

package/bundles/stream-chat-angular.umd.js

@@ -354,10 +354,10 @@
         return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
     }
 
-    var version = '2.14.0';
+    var version = '2.15.0';
 
     /**
-     * The `NotificationService` can be used to add or remove notifications. By default the [`NotificationList`](../components/notifications.mdx) component displays the currently active notifications.
+     * The `NotificationService` can be used to add or remove notifications. By default the [`NotificationList`](../components/NotificationListComponent.mdx) component displays the currently active notifications.
      */
     var NotificationService = /** @class */ (function () {
         function NotificationService() {
@@ -828,7 +828,7 @@
             });
         };
         /**
-         * Resets the `activeChannel$`, `channels$` and `activeChannelMessages$` Observables. Useful when disconnecting a chat user, use in combination with [`disconnectUser`](./chat-client.mdx/#disconnectuser).
+         * Resets the `activeChannel$`, `channels$` and `activeChannelMessages$` Observables. Useful when disconnecting a chat user, use in combination with [`disconnectUser`](./ChatClientService.mdx/#disconnectuser).
          */
         ChannelService.prototype.reset = function () {
             this.activeChannelMessagesSubject.next([]);
@@ -2146,8 +2146,14 @@
                     }]
             }], ctorParameters: function () { return [{ type: i2__namespace.TranslateService }]; } });
 
+    /**
+     * The `Avatar` component displays the provided image, with fallback to the first letter of the optional name input.
+     */
     var AvatarComponent = /** @class */ (function () {
         function AvatarComponent() {
+            /**
+             * The size in pixels of the avatar image.
+             */
             this.size = 32;
             this.isLoaded = false;
             this.isError = false;
@@ -2179,6 +2185,9 @@
                     type: i0.Input
                 }] } });
 
+    /**
+     * The `Icon` component can be used to display different icons (i. e. message delivered icon).
+     */
     var IconComponent = /** @class */ (function () {
         function IconComponent() {
         }
@@ -2199,9 +2208,18 @@
                     type: i0.Input
                 }] } });
 
+    /**
+     * The `LoadingIndicator` component displays a spinner to indicate that an action is in progress.
+     */
     var LoadingIndicatorComponent = /** @class */ (function () {
         function LoadingIndicatorComponent() {
+            /**
+             * The size of the indicator (in pixels)
+             */
             this.size = 15;
+            /**
+             * The color of the indicator
+             */
             this.color = '#006CFF';
         }
         return LoadingIndicatorComponent;
@@ -2331,7 +2349,7 @@
             }], ctorParameters: function () { return []; } });
 
     /**
-     * The `MessageInputConfigService` is used to keep a consistent configuration among the different [`MessageInput`](../components/message-input.mdx) components if your UI has more than one input component.
+     * The `MessageInputConfigService` is used to keep a consistent configuration among the different [`MessageInput`](../components/MessageInputComponent.mdx) components if your UI has more than one input component.
      */
     var MessageInputConfigService = /** @class */ (function () {
         function MessageInputConfigService() {
@@ -2384,10 +2402,16 @@
                     }]
             }], ctorParameters: function () { return []; } });
 
+    /**
+     * The `AttachmentList` compontent displays the attachments of a message
+     */
     var AttachmentListComponent = /** @class */ (function () {
         function AttachmentListComponent(imageLoadService, channelService) {
             this.imageLoadService = imageLoadService;
             this.channelService = channelService;
+            /**
+             * The attachments to display
+             */
             this.attachments = [];
             this.orderedAttachments = [];
         }
@@ -2453,6 +2477,9 @@
                     type: i0.Input
                 }] } });
 
+    /**
+     * The `AttachmentPreviewList` compontent displays a preview of the attachments uploaded to a message. Users can delete attachments using the preview component, or retry upload if it failed previously.
+     */
     var AttachmentPreviewListComponent = /** @class */ (function () {
         function AttachmentPreviewListComponent(attachmentService) {
             this.attachmentService = attachmentService;
@@ -2498,6 +2525,9 @@
                     }]
             }], ctorParameters: function () { return [{ type: AttachmentService }]; } });
 
+    /**
+     * The `MessageInput` component displays an input where users can type their messages and upload files, and sends the message to the active channel. The component can be used to compose new messages or update existing ones. To send messages, the chat user needs to have the necessary [channel capability](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript).
+     */
     var MessageInputComponent = /** @class */ (function () {
         function MessageInputComponent(channelService, notificationService, attachmentService, configService, textareaType, componentFactoryResolver, cdRef, chatClient, emojiInputService) {
             var _this = this;
@@ -2510,7 +2540,13 @@
             this.cdRef = cdRef;
             this.chatClient = chatClient;
             this.emojiInputService = emojiInputService;
+            /**
+             * Determines if the message is being dispalyed in a channel or in a [thread](https://getstream.io/chat/docs/javascript/threads/?language=javascript).
+             */
             this.mode = 'main';
+            /**
+             * Emits when a message was successfuly sent or updated
+             */
             this.messageUpdate = new i0.EventEmitter();
             this.textareaValue = '';
             this.mentionedUsers = [];
@@ -2864,10 +2900,19 @@
                     args: [TextareaDirective, { static: false }]
                 }] } });
 
+    /**
+     * The `Modal` component displays its content in an overlay. The modal can be closed with a close button, if the user clicks outside of the modal content, or if the escape button is pressed. The modal can also be closed from outside.
+     */
     var ModalComponent = /** @class */ (function () {
         function ModalComponent() {
             var _this = this;
+            /**
+             * If `true` the modal will be displayed, if `false` the modal will be hidden
+             */
             this.isOpen = false;
+            /**
+             * Emits `true` if the modal becomes visible, and `false` if the modal is closed.
+             */
             this.isOpenChange = new i0.EventEmitter();
             this.watchForEscPress = function (event) {
                 if (event.key === 'Escape') {
@@ -2926,6 +2971,9 @@
                     args: ['content']
                 }] } });
 
+    /**
+     * The `Notification` component displays a notification within the [`NotificationList`](./NotificationListComponent.mdx)
+     */
     var NotificationComponent = /** @class */ (function () {
         function NotificationComponent() {
         }
@@ -2944,6 +2992,9 @@
                     type: i0.Input
                 }] } });
 
+    /**
+     * The `NotificationList` component displays the list of active notifications.
+     */
     var NotificationListComponent = /** @class */ (function () {
         function NotificationListComponent(notificationService) {
             this.notificationService = notificationService;
@@ -2965,16 +3016,34 @@
                     }]
             }], ctorParameters: function () { return [{ type: NotificationService }]; } });
 
+    /**
+     * The `MessageActionsBox` component displays a list of message actions (i.e edit), that can be opened or closed. You can find the [list of the supported actions](../concepts/message-interactions.mdx) in the message interaction guide.
+     */
     var MessageActionsBoxComponent = /** @class */ (function () {
         function MessageActionsBoxComponent(chatClientService, notificationService, channelService) {
             var _this = this;
             this.chatClientService = chatClientService;
             this.notificationService = notificationService;
             this.channelService = channelService;
+            /**
+             * Indicates if the list should be opened or closed. Adding a UI element to open and close the list is the parent's component responsibility.
+             */
             this.isOpen = false;
+            /**
+             * Indicates if the message actions are belonging to a message that was sent by the current user or not.
+             */
             this.isMine = false;
+            /**
+             * The list of [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript) that are enabled for the current user, the list of [supported interactions](../concepts/message-interactions.mdx) can be found in our message interaction guide. Unathorized actions won't be displayed on the UI.
+             */
             this.enabledActions = [];
+            /**
+             * The number of authorized actions (it can be less or equal than the number of enabled actions)
+             */
             this.displayedActionsCount = new i0.EventEmitter();
+            /**
+             * An event which emits `true` if the edit message modal is open, and `false` when it is closed.
+             */
             this.isEditing = new i0.EventEmitter();
             this.isEditModalOpen = false;
             this.modalClosed = function () {
@@ -3149,6 +3218,9 @@
                     args: [MessageInputComponent]
                 }] } });
 
+    /**
+     * The `Channel` component is a container component that displays the [`ChannelHeader`](./ChannelHeaderComponent.mdx), [`MessageList`](./MessageListComponent.mdx), [`NotificationList`](./NotificationListComponent.mdx) and [`MessageInput`](./MessageInputComponent.mdx) components. You can also provide the [`Thread`](./ThreadComponent.mdx) component to use message [threads](https://getstream.io/chat/docs/javascript/threads/?language=javascript).
+     */
     var ChannelComponent = /** @class */ (function () {
         function ChannelComponent(channelService) {
             this.channelService = channelService;
@@ -3253,6 +3325,9 @@
                 args: [{ providedIn: 'root' }]
             }], ctorParameters: function () { return []; } });
 
+    /**
+     * The `ChannelHeader` component displays the avatar and name of the currently active channel along with member and watcher information. You can read about [the difference between members and watchers](https://getstream.io/chat/docs/javascript/watch_channel/?language=javascript#watchers-vs-members) in the platform documentation. Please note that number of watchers is only displayed if the user has [`connect-events` capability](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript)
+     */
     var ChannelHeaderComponent = /** @class */ (function () {
         function ChannelHeaderComponent(channelService, channelListToggleService) {
             var _this = this;
@@ -3302,6 +3377,9 @@
                     }]
             }], ctorParameters: function () { return [{ type: ChannelService }, { type: ChannelListToggleService }]; } });
 
+    /**
+     * The `ChannelPreview` component displays a channel preview in the channel list, it consists of the image, name and latest message of the channel.
+     */
     var ChannelPreviewComponent = /** @class */ (function () {
         function ChannelPreviewComponent(channelService, ngZone) {
             this.channelService = channelService;
@@ -3404,6 +3482,9 @@
                     type: i0.Input
                 }] } });
 
+    /**
+     * The `ChannelList` component renders the list of channels.
+     */
     var ChannelListComponent = /** @class */ (function () {
         function ChannelListComponent(channelService, channelListToggleService) {
             this.channelService = channelService;
@@ -3500,16 +3581,34 @@
         wow: '😮',
         sad: '😞',
     };
+    /**
+     * The `MessageReactions` component displays the reactions of a message, the current user can add and remove reactions. You can read more about [message reactions](https://getstream.io/chat/docs/javascript/send_reaction/?language=javascript) in the platform documentation.
+     */
     var MessageReactionsComponent = /** @class */ (function () {
         function MessageReactionsComponent(cdRef, channelService) {
             var _this = this;
             this.cdRef = cdRef;
             this.channelService = channelService;
+            /**
+             * The number of reactions grouped by [reaction types](https://github.com/GetStream/stream-chat-angular/tree/master/projects/stream-chat-angular/src/lib/message-reactions/message-reactions.component.ts)
+             */
             this.messageReactionCounts = {};
+            /**
+             * Indicates if the selector should be opened or closed. Adding a UI element to open and close the selector is the parent's component responsibility.
+             */
             this.isSelectorOpen = false;
-            this.isSelectorOpenChange = new i0.EventEmitter();
+            /**
+             * List of reactions of a [message](../types/stream-message.mdx), used to display the users of a reaction type.
+             */
             this.latestReactions = [];
+            /**
+             * List of the user's own reactions of a [message](../types/stream-message.mdx), used to display the users of a reaction type.
+             */
             this.ownReactions = [];
+            /**
+             * Indicates if the selector should be opened or closed. Adding a UI element to open and close the selector is the parent's component responsibility.
+             */
+            this.isSelectorOpenChange = new i0.EventEmitter();
             this.eventHandler = function (event) {
                 var _a;
                 if (!((_a = _this.selectorContainer) === null || _a === void 0 ? void 0 : _a.nativeElement.contains(event.target))) {
@@ -3623,12 +3722,12 @@
                     type: i0.Input
                 }], isSelectorOpen: [{
                     type: i0.Input
-                }], isSelectorOpenChange: [{
-                    type: i0.Output
                 }], latestReactions: [{
                     type: i0.Input
                 }], ownReactions: [{
                     type: i0.Input
+                }], isSelectorOpenChange: [{
+                    type: i0.Output
                 }], selectorContainer: [{
                     type: i0.ViewChild,
                     args: ['selectorContainer']
@@ -3637,11 +3736,20 @@
                     args: ['selectorTooltip']
                 }] } });
 
+    /**
+     * The `Message` component displays a message with additional information such as sender and date, and enables [interaction with the message (i.e. edit or react)](../concepts/message-interactions.mdx).
+     */
     var MessageComponent = /** @class */ (function () {
         function MessageComponent(chatClientService, channelService) {
             this.chatClientService = chatClientService;
             this.channelService = channelService;
+            /**
+             * The list of [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript) that are enabled for the current user, the list of [supported interactions](../concepts/message-interactions.mdx) can be found in our message interaction guide. Unathorized actions won't be displayed on the UI. The [`MessageList`](./MessageListComponent.mdx) component automatically sets this based on [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript).
+             */
             this.enabledMessageActions = [];
+            /**
+             * Determines if the message is being dispalyed in a channel or in a [thread](https://getstream.io/chat/docs/javascript/threads/?language=javascript).
+             */
             this.mode = 'main';
             this.isActionBoxOpen = false;
             this.isReactionSelectorOpen = false;
@@ -3878,13 +3986,25 @@
                     args: ['container']
                 }] } });
 
+    /**
+     * The `Textarea` component is used by the [`MessageInput`](./MessageInputComponent.mdx) component to display the input HTML element where users can type their message.
+     */
     var TextareaComponent = /** @class */ (function () {
         function TextareaComponent(emojiInputService) {
             var _this = this;
             this.emojiInputService = emojiInputService;
             this.class = 'str-chat__textarea';
+            /**
+             * The value of the input HTML element.
+             */
             this.value = '';
+            /**
+             * Emits the current value of the input element when a user types.
+             */
             this.valueChange = new i0.EventEmitter();
+            /**
+             * Emits when a user triggers a message send event (this happens when they hit the `Enter` key).
+             */
             this.send = new i0.EventEmitter();
             this.subscriptions = [];
             this.subscriptions.push(this.emojiInputService.emojiInput$.subscribe(function (emoji) {
@@ -3957,6 +4077,9 @@
                 args: [{ providedIn: 'root' }]
             }], ctorParameters: function () { return []; } });
 
+    /**
+     * The `AutocompleteTextarea` component is used by the [`MessageInput`](./MessageInputComponent.mdx) component to display the input HTML element where users can type their message.
+     */
     var AutocompleteTextareaComponent = /** @class */ (function () {
         function AutocompleteTextareaComponent(channelService, chatClientService, transliterationService, emojiInputService) {
             var _this = this;
@@ -3965,11 +4088,29 @@
             this.transliterationService = transliterationService;
             this.emojiInputService = emojiInputService;
             this.class = 'str-chat__textarea';
+            /**
+             * The value of the input HTML element.
+             */
             this.value = '';
+            /**
+             * If true, users can mention other users in messages. You can also set this input on the [`MessageInput`](./MessageInputComponent.mdx/#inputs-and-outputs) component.
+             */
             this.areMentionsEnabled = true;
+            /**
+             * The scope for user mentions, either members of the current channel of members of the application. You can also set this input on the [`MessageInput`](./MessageInputComponent.mdx/#inputs-and-outputs) component.
+             */
             this.mentionScope = 'channel';
+            /**
+             * Emits the current value of the input element when a user types.
+             */
             this.valueChange = new i0.EventEmitter();
+            /**
+             * Emits when a user triggers a message send event (this happens when they hit the `Enter` key).
+             */
             this.send = new i0.EventEmitter();
+            /**
+             * Emits the array of users that are mentioned in the message, it is updated when a user mentions a new user or deletes a mention.
+             */
             this.userMentions = new i0.EventEmitter();
             this.autocompleteKey = 'autocompleteLabel';
             this.mentionTriggerChar = '@';
@@ -4209,6 +4350,9 @@
             date1.getDate() === date2.getDate());
     };
 
+    /**
+     * The `MessageList` component renders a scrollable list of messages.
+     */
     var MessageListComponent = /** @class */ (function () {
         function MessageListComponent(channelService, chatClientService, imageLoadService) {
             var _this = this;
@@ -4216,14 +4360,17 @@
             this.chatClientService = chatClientService;
             this.imageLoadService = imageLoadService;
             /**
-             * @deprecated https://getstream.io/chat/docs/sdk/angular/components/message_list/#caution-arereactionsenabled-deprecated
+             * @deprecated use [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript) instead. If true, the message reactions are displayed. Users can also react to messages if they have the necessary [channel capability](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript).
              */
             this.areReactionsEnabled = undefined;
             /**
-             * @deprecated https://getstream.io/chat/docs/sdk/angular/components/message_list/#caution-enabledmessageactions-deprecated
+             * @deprecated use [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript) instead. The list of [actions that are enabled](./MessageActionsBoxComponent.mdx), please note that the user also has to have the necessary [channel capabilities](https://getstream.io/chat/docs/javascript/channel_capabilities/?language=javascript) for actions to work. Unathorized actions won't be displayed on the UI. The `MessgaeList` component makes the necessary checks before passing the actions to the `Message` component.
              */
             /* eslint-disable-next-line @angular-eslint/no-input-rename */
             this.enabledMessageActionsInput = undefined;
+            /**
+             * Determines if the message list should display channel messages or [thread messages](https://getstream.io/chat/docs/javascript/threads/?language=javascript).
+             */
             this.mode = 'main';
             this.enabledMessageActions = [];
             this.class = 'str-chat-angular__main-panel-inner str-chat-angular__message-list-host';
@@ -4487,6 +4634,9 @@
                     args: ['parentMessageElement']
                 }] } });
 
+    /**
+     * The `Thread` component represents a [message thread](https://getstream.io/chat/docs/javascript/threads/?language=javascript), it is a container component that displays a thread with a header, [`MessageList`](./MessageListComponent.mdx) and [`MessageInput`](./MessageInputComponent.mdx) components.
+     */
     var ThreadComponent = /** @class */ (function () {
         function ThreadComponent(channelService) {
             var _this = this;