stream-chat-react-native-core 10.0.0-rc.1 → 10.0.0-rc.2

package/src/components/ui/Button/hooks/useButtonStyles.ts

@@ -27,10 +27,11 @@ export type ButtonStyle = {
 export type ButtonStylesConfig = Pick<ButtonProps, 'variant' | 'type'>;
 
 /**
- * Returns the styles for the button based on the button style and type.
- * @param buttonStyle - The style of the button.
- * @param type - The type of the button.
- * @returns The styles for the button.
+ * Returns the colors for a button variant and type.
+ *
+ * @param params.variant The button variant.
+ * @param params.type The button type.
+ * @returns The button style for that combination.
  */
 export const useButtonStyles = ({ variant, type }: ButtonStylesConfig) => {
   const {

package/src/components/ui/GiphyChip.tsx

@@ -27,7 +27,6 @@ export const GiphyChip = () => {
 
   const onPressHandler = () => {
     textComposer.clearCommand();
-    // messageComposer?.restore();
   };
 
   return (

package/src/components/ui/Input/Input.tsx

@@ -52,8 +52,8 @@ export type InputProps = TextInputProps & {
   containerStyle?: StyleProp<ViewStyle>;
 };
 
-// Explicitly annotated: the inferred type of a `forwardRef` component inlines React Native's
-// internal style/instance helper types, which cannot be named in the emitted declarations (TS2883).
+// Annotated because the inferred `forwardRef` type inlines React Native internal types that the
+// emitted declarations cannot name (TS2883).
 export const Input: React.ForwardRefExoticComponent<
   InputProps & React.RefAttributes<TextInputRef>
 > = React.forwardRef<TextInputRef, InputProps>(function Input(

package/src/components/ui/SpeedSettingsButton.tsx

@@ -6,17 +6,11 @@ import { useTheme } from '../../contexts/themeContext/ThemeContext';
 import { primitives } from '../../theme';
 
 export type SpeedSettingsButtonProps = {
-  /**
-   * The current playback rate.
-   */
+  /** Current playback rate. */
   currentPlaybackRate: number;
-  /**
-   * The function to be called when the button is pressed.
-   */
+  /** Called when the button is pressed. */
   onPress: () => void;
-  /**
-   * The style of the container.
-   */
+  /** Style of the container. */
   containerStyle?: StyleProp<ViewStyle>;
 };
 

package/src/contexts/__tests__/index.test.tsx

@@ -9,13 +9,17 @@ import {
   useChannelsContext,
   useChatContext,
   useBottomSheetContext,
+  useCreatePollContentContext,
   useImageGalleryContext,
+  useMessageInputContext,
   useMessagesContext,
   useOverlayContext,
   useOwnCapabilitiesContext,
+  usePollContext,
   useTheme,
   useThreadContext,
 } from '../';
+import { useMessageListItemContext } from '../messageListItemContext/MessageListItemContext';
 
 jest.mock('../utils/isTestEnvironment', () => ({ isTestEnvironment: jest.fn(() => false) }));
 jest.spyOn(console, 'error').mockImplementation();
@@ -28,39 +32,55 @@ describe('contexts hooks in a component throws an error with message when not wr
   it.each([
     [
       useOverlayContext,
-      'The useOverlayContext hook was called outside the OverlayContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#overlay-provider',
+      'The useOverlayContext hook was called outside the OverlayContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/overlay-provider/',
     ],
     [
       useOwnCapabilitiesContext,
-      'The useOwnCapabilitiesContext hook was called outside the Channel Component. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#channel',
+      'The useOwnCapabilitiesContext hook was called outside the Channel Component. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
     ],
     [
       useTheme,
-      'The useThemeContext hook was called outside the ThemeContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#overlay-provider',
+      'The useThemeContext hook was called outside the ThemeContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/overlay-provider/',
     ],
     [
       useChannelContext,
-      'The useChannelContext hook was called outside of the ChannelContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#channel',
+      'The useChannelContext hook was called outside of the ChannelContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
     ],
     [
       useChannelsContext,
-      'The useChannelsContext hook was called outside of the ChannelsContext provider. Make sure you have configured ChannelList component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#channel-list',
+      'The useChannelsContext hook was called outside of the ChannelsContext provider. Make sure you have configured ChannelList component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel-list/',
     ],
     [
       useChatContext,
-      'The useChatContext hook was called outside the ChatContext Provider. Make sure you have configured Chat component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#chat',
+      'The useChatContext hook was called outside the ChatContext Provider. Make sure you have configured Chat component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/chat/',
     ],
     [
       useImageGalleryContext,
-      'The useImageGalleryContext hook was called outside the ImageGalleryContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#overlay-provider',
+      'The useImageGalleryContext hook was called outside the ImageGalleryContext Provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/overlay-provider/',
     ],
     [
       useMessagesContext,
-      'The useMessagesContext hook was called outside of the MessagesContext provider. Make sure you have configured MessageList component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#message-list',
+      'The useMessagesContext hook was called outside of the MessagesContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
     ],
     [
       useAttachmentPickerContext,
-      'The useAttachmentPickerContext hook was called outside the AttachmentPickerContext provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#overlay-provider',
+      'The useAttachmentPickerContext hook was called outside the AttachmentPickerContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
+    ],
+    [
+      useMessageInputContext,
+      'The useMessageInputContext hook was called outside of the MessageInputContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
+    ],
+    [
+      useMessageListItemContext,
+      'The useMessageListItemContext hook was called outside of the MessageListItemContext provider. Make sure you have configured MessageList component correctly - https://getstream.io/chat/docs/sdk/react-native/ui-components/message-list/',
+    ],
+    [
+      usePollContext,
+      'The usePollContext hook was called outside of the PollContext provider. Make sure you have configured the Poll component correctly - https://getstream.io/chat/docs/sdk/react-native/ui-components/poll/',
+    ],
+    [
+      useCreatePollContentContext,
+      'The useCreatePollContentContext hook was called outside of the CreatePollContentContext provider. Make sure you have configured the CreatePoll component correctly - https://getstream.io/chat/docs/sdk/react-native/ui-components/create-poll/',
     ],
     [
       useBottomSheetContext,

package/src/contexts/accessibilityContext/AccessibilityContext.tsx

@@ -26,31 +26,27 @@ type TimeoutByPriority = {
 /** Tri-state for gesture-alternative toggles. */
 export type A11yMode = 'auto' | 'always' | 'never';
 
-/**
- * Resolved predicate stored on the context - consumers call `(message)` and
- * receive the boolean directly.
- */
+/** Resolved predicate stored on the context: consumers call it with a message. */
 export type HasInteractiveAccessibilityContent = (message: LocalMessage) => boolean;
 
 /**
- * Integrator facing override shape. Receives the SDK's baseline boolean as the
- * second argument so overrides can extend rather than replace:
+ * Integrator override. Receives the SDK's baseline boolean as the second argument, so an override
+ * can extend it:
  *
  * ```
  *   hasInteractiveAccessibilityContent: (message, defaultValue) =>
  *     defaultValue || !!message.my_custom_field
  * ```
  *
- * To replace fully, ignore the second argument. Must be stable across renders
- * an unstable function will rerender every Message context consumer on every
- * downstream render.
+ * To replace the baseline, ignore the second argument. Must be stable across renders: an unstable
+ * function re-renders every message context consumer.
  */
 export type HasInteractiveAccessibilityContentConfig = (
   message: LocalMessage,
   defaultValue: boolean,
 ) => boolean;
 
-/** SDK baseline — true when the message renders interactive children. */
+/** SDK baseline: true when the message renders interactive children. */
 const defaultHasInteractiveAccessibilityContent: HasInteractiveAccessibilityContent = (message) =>
   !!(
     message.poll_id ||
@@ -61,36 +57,36 @@ const defaultHasInteractiveAccessibilityContent: HasInteractiveAccessibilityCont
 
 export type AccessibilityConfig = {
   /**
-   * Master toggle. Default FALSE — integrators must opt in. When false, the SDK
-   * behaves exactly as it does today; no a11y attributes are added, no announcer
-   * mounts, no listeners attached.
+   * Master toggle. Defaults to false, so integrators opt in. When false, no accessibility
+   * attributes are added, no announcer mounts and no listeners attach.
    */
   enabled?: boolean;
-  /** For testing — force "screen reader on" UI even when no SR is active. */
+  /** For testing: forces the screen reader UI even when no screen reader is active. */
   forceScreenReaderMode?: boolean;
-  /** Announce new messages via the announcer. Default true (when enabled). */
+  /** Announces new messages. Defaults to true. */
   announceNewMessages?: boolean;
-  /** Announce typing indicator. Default false (noisy on mobile). */
+  /** Announces the typing indicator. Defaults to false, as it is noisy on mobile. */
   announceTypingIndicator?: boolean;
-  /** Announce connection state (offline/online). Default true. */
+  /** Announces connection state changes. Defaults to true. */
   announceConnectionState?: boolean;
-  /** Audio recorder gesture-alternative. 'auto' (default), 'always', 'never'. */
+  /** Gesture alternative for the audio recorder. Defaults to `'auto'`. */
   audioRecorderTapMode?: A11yMode;
-  /** Image gallery gesture-alternative. 'auto' (default), 'always', 'never'. */
+  /** Gesture alternative for the image gallery. Defaults to `'auto'`. */
   imageGalleryScreenReaderMode?: A11yMode;
-  /** Message actions trigger. 'long-press' (no alt button), 'auto' (default — show button when SR is on), 'always-button'. */
+  /**
+   * How message actions open: `'long-press'` (no extra button), `'always-button'`, or `'auto'`
+   * (a button while a screen reader is on). Defaults to `'auto'`.
+   */
   messageActionsTrigger?: 'long-press' | 'auto' | 'always-button';
   /**
-   * Override the SDK's "this message has interactive children" decision.
-   * Will control what it means for a message to have interactive content.
-   * This affects the way we mark the message bubble as accessible and whether
-   * we let the children handle it on their own or whether we want the bubble to
-   * handle everything. See {@link HasInteractiveAccessibilityContentConfig}.
+   * Overrides whether a message counts as having interactive children, which decides if the
+   * children or the bubble handle accessibility.
+   * See {@link HasInteractiveAccessibilityContentConfig}.
    */
   hasInteractiveAccessibilityContent?: HasInteractiveAccessibilityContentConfig;
 };
 
-/** Fully-resolved config — every field is populated with its default. */
+/** Fully resolved config: every field is populated with its default. */
 export type ResolvedAccessibilityConfig = Required<
   Omit<AccessibilityConfig, 'hasInteractiveAccessibilityContent'>
 > & {

package/src/contexts/attachmentPickerContext/AttachmentPickerContext.tsx

@@ -21,11 +21,8 @@ export type AttachmentPickerContextValue = Pick<
   'attachmentSelectionBarHeight' | 'attachmentPickerBottomSheetHeight'
 > & {
   /**
-   * `bottomInset` determine the height of the `AttachmentPicker` and the underlying shift to the `MessageList` when it is opened.
-   * This can be set via the `bottomInset` prop on the `Channel` component.
-   *
-   * Please check [OverlayProvider](https://github.com/GetStream/stream-chat-react-native/wiki/Cookbook-v3.0#overlayprovider) section in Cookbook
-   * for more details.
+   * Determines the height of the `AttachmentPicker` and how far the `MessageList` shifts when it
+   * opens. Set via the `bottomInset` prop on `Channel`.
    */
   bottomInset: number;
   bottomSheetRef: React.RefObject<BottomSheet | null>;
@@ -34,17 +31,15 @@ export type AttachmentPickerContextValue = Pick<
   topInset: number;
 
   /**
-   * When `true`, the native image picker is used instead of the in-app image gallery.
-   * The attachment picker itself (with its attachment type selection bar) is still rendered.
-   * To not render the attachment picker at all, set `shouldRenderAttachmentPicker` to `false`.
+   * Uses the native image picker in place of the in-app image gallery. The attachment picker and
+   * its selection bar still render; set `shouldRenderAttachmentPicker` to false to hide them.
    */
   disableAttachmentPicker?: boolean;
   /**
-   * Whether the attachment picker should be rendered at all. Defaults to `true`.
+   * Whether the attachment picker renders at all. Defaults to true.
    *
-   * Can be set to `false` if attachment picker is not used. `openAttachmentPicker` then
-   * does nothing. The attach button is still shown, so it needs to either be hidden it or set
-   * `handleAttachButtonPress` to override what it does.
+   * When false, `openAttachmentPicker` does nothing and the attach button is still shown, so hide
+   * it or override its action with `handleAttachButtonPress`.
    */
   shouldRenderAttachmentPicker?: boolean;
   attachmentPickerStore: AttachmentPickerStore;
@@ -92,7 +87,7 @@ export const useAttachmentPickerContext = () => {
 
   if (contextValue === DEFAULT_BASE_CONTEXT_VALUE && !isTestEnvironment()) {
     throw new Error(
-      'The useAttachmentPickerContext hook was called outside the AttachmentPickerContext provider. Make sure you have configured OverlayProvider component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#overlay-provider',
+      'The useAttachmentPickerContext hook was called outside the AttachmentPickerContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
     );
   }
 

package/src/contexts/bottomSheetContext/BottomSheetContext.tsx

@@ -7,29 +7,18 @@ import { isTestEnvironment } from '../utils/isTestEnvironment';
 
 export type BottomSheetContextValue = {
   /**
-   * Callback that will safely close the modal while preserving animation
-   * timing and respecting actions finishing before the close is invoked.
+   * Closes the modal with its animation.
    *
-   * @param closeAnimationFinishedCallback {function} - a callback that is
-   * going to be invoked when the closing animation finishes (but not necessarily
-   * when the modal is actually dismissed)
-   * @returns void
+   * @param closeAnimationFinishedCallback Runs when the closing animation finishes, not
+   * necessarily when the modal is dismissed.
    */
   close: (closeAnimationFinishedCallback?: () => void) => void;
   /**
-   * A callback that will safely dismiss the modal, while preserving animation timing
-   * and respecting actions finishing before the close is invoked. Very similar to `close`,
-   * however it takes an extra step to make sure that the modal is actually dismissed
-   * before its callback is invoked. This is mostly useful for iOS, where for certain
-   * libraries (i.e `react-native-image-picker`) you aren't able to open both a RN modal
-   * and its internal `UIImagePickerController` at the same time and you have to wait
-   * for `onDismiss` to be fired internally.
+   * Like `close`, but the callback runs only once the modal is actually dismissed. Use it on iOS to
+   * present another native modal (such as `react-native-image-picker`) from the callback. It
+   * behaves like `close` on Android.
    *
-   * It will work exactly the same as `close` for Android as this is not an issue there.
-   *
-   * @param closeAnimationFinishedCallback {function} - a callback that is
-   * going to be invoked when the dismissal of the modal finishes
-   * @returns void
+   * @param dismissFinishedCallback Runs when the modal is dismissed.
    */
   dismiss: (dismissFinishedCallback?: () => void) => void;
   currentSnapIndex: SharedValue<number>;

package/src/contexts/channelAddMembersContext/ChannelAddMembersContext.tsx

@@ -14,23 +14,15 @@ import { isTestEnvironment } from '../utils/isTestEnvironment';
 export type ChannelAddMembersContextValue = {
   selectionStore: SelectionStore;
   searchSource: UserSearchSource;
-  /**
-   * Adds the currently selected members to the channel. Resolves on success and
-   * rejects if the request fails.
-   */
+  /** Adds the selected members to the channel. Rejects if the request fails. */
   submit: () => Promise<void>;
 };
 
-/**
- * Props for the {@link ChannelAddMembersProvider} that seed the add-members
- * configuration into the context.
- */
+/** Props of the {@link ChannelAddMembersProvider}. */
 export type ChannelAddMembersProviderProps = PropsWithChildren<{
   /**
-   * A custom `UserSearchSource` used to query and paginate the users to add.
-   * Overrides the source the provider creates by default (pre-configured to
-   * autocomplete by `name`). The provider uses it as-is, so the consumer owns
-   * its activation/sorting.
+   * Custom `UserSearchSource` (the default autocompletes by `name`) that queries and paginates the
+   * users to add. It is used as-is, so the consumer owns its activation and sorting.
    */
   searchSource?: UserSearchSource;
 }>;
@@ -41,8 +33,8 @@ export const ChannelAddMembersContext = React.createContext(
 
 /**
  * Builds the {@link ChannelAddMembersContextValue}. Rendered inside the
- * {@link NotificationTargetProvider} so that notifications emitted by `submit`
- * (via {@link useChannelActions}) resolve to the add-members host.
+ * {@link NotificationTargetProvider} so notifications from `submit` resolve to the add-members
+ * host.
  */
 const ChannelAddMembersContextProviderInner = ({
   children,
@@ -53,7 +45,6 @@ const ChannelAddMembersContextProviderInner = ({
   const { addMembers } = useChannelActions(channel);
   const [selectionStore] = useState(() => new SelectionStore());
   const [searchSource] = useState(() => {
-    // A custom source is used as-is; the consumer owns its activation/sorting.
     if (searchSourceProp) {
       return searchSourceProp;
     }

package/src/contexts/channelContext/ChannelContext.tsx

@@ -8,58 +8,30 @@ import { isTestEnvironment } from '../utils/isTestEnvironment';
 
 export type ChannelContextValue = {
   /**
-   * Instance of channel object from stream-chat package.
-   *
-   * Please check the docs around how to create or query channel - https://getstream.io/chat/docs/javascript/creating_channels/?language=javascript
-   *
-   * ```
-   * import { StreamChat, Channel } from 'stream-chat';
-   * import { Chat, Channel} from 'stream-chat-react-native';
-   *
-   * const client = StreamChat.getInstance('api_key');
-   * await client.connectUser('user_id', 'user_token');
-   * const channel = client.channel('messaging', 'channel_id');
-   * await channel.watch();
-   *
-   * <Chat client={client}>
-   *  <Channel channel={channel}>
-   *  </Channel>
-   * </Chat>
-   * ```
+   * The `stream-chat` channel instance.
    *
    * @overrideType Channel
    */
   channel: Channel;
-  /**
-   * When set to true, reactions will be limited to 1 per user. If user selects another reaction
-   * then his previous reaction will be removed and replaced with new one.
-   *
-   * This is similar to reaction UX on [iMessage application](https://en.wikipedia.org/wiki/IMessage).
-   */
+  /** Limits users to one reaction; picking another replaces the previous. Defaults to false. */
   enforceUniqueReaction: boolean;
   /**
-   * Render the inline date separator above a system message when that message is the first of
-   * its day. Off by default: without it a system message on a day boundary consumes the boundary
-   * and renders nothing, so that day gets no separator at all.
+   * Renders the inline date separator above a system message that is the first of its day.
+   * Defaults to false: a system message on a day boundary then renders no separator for that day.
    */
   allowDateSeparatorForSystemMessages: boolean;
-  /**
-   * Hide inline date separators on channel
-   */
+  /** Hides the inline date separators. Defaults to false. */
   hideDateSeparators: boolean;
   hideStickyDateHeader: boolean;
   /**
-   * Returns true when Channel is about to load an initial targeted message.
+   * Returns true when `Channel` is about to load an initial targeted message.
    *
    * @internal
    */
   hasPendingInitialTargetLoad?: () => boolean;
   disabled?: boolean;
   enableMessageGroupingByUser?: boolean;
-  /**
-   * Maximum time in milliseconds that should occur between messages
-   * to still consider them grouped together
-   */
+  /** Maximum time in milliseconds between messages that are still grouped together. */
   maxTimeBetweenGroupedMessages?: number;
 };
 
@@ -83,7 +55,7 @@ export const useChannelContext = () => {
 
   if (contextValue === DEFAULT_BASE_CONTEXT_VALUE && !isTestEnvironment()) {
     throw new Error(
-      'The useChannelContext hook was called outside of the ChannelContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/reactnative/basics/hello_stream_chat/#channel',
+      'The useChannelContext hook was called outside of the ChannelContext provider. Make sure you have configured Channel component correctly - https://getstream.io/chat/docs/sdk/react-native/core-components/channel/',
     );
   }
 

package/src/contexts/channelDetailsContext/channelDetailsContext.tsx

@@ -8,9 +8,7 @@ import { isTestEnvironment } from '../utils/isTestEnvironment';
 
 export type ChannelDetailsContextValue = {
   channel: Channel;
-  /**
-   * Signals all ChannelDetails modals to close themselves.
-   */
+  /** Signals all channel details modals to close. */
   closeModals: () => void;
   signalStore: SignalStore;
 };

package/src/contexts/channelEditDetailsContext/ChannelEditDetailsContext.tsx

@@ -15,31 +15,19 @@ import { isTestEnvironment } from '../utils/isTestEnvironment';
 
 export type ChannelEditDetailsContextValue = {
   store: EditChannelDetailsStore;
-  /**
-   * Saves the edited channel details (name and/or image). Resolves once every
-   * update succeeds and rejects if any of them fail.
-   */
+  /** Saves the edited name and/or image. Rejects with an `AggregateError` if any update fails. */
   submit: () => Promise<void>;
-  /**
-   * Compress image with quality (from 0 to 1, where 1 is best quality) applied
-   * to the channel image picked during editing.
-   */
+  /** Compression quality from 0 to 1 (1 is best) for the channel image picked while editing. */
   compressImageQuality?: number;
-  /** Override the upload request used to upload the channel image. */
+  /** Overrides the request that uploads the channel image. */
   doFileUploadRequest?: GlobalFileUploadRequest;
 };
 
-/**
- * Props for the {@link ChannelEditDetailsProvider} that seed the edit flow
- * configuration into the context.
- */
+/** Props of the {@link ChannelEditDetailsProvider}. */
 export type ChannelEditDetailsProviderProps = PropsWithChildren<{
-  /**
-   * Compress image with quality (from 0 to 1, where 1 is best quality) applied
-   * to the channel image picked during editing.
-   */
+  /** Compression quality from 0 to 1 (1 is best) for the channel image picked while editing. */
   compressImageQuality?: number;
-  /** Override the upload request used to upload the channel image. */
+  /** Overrides the request that uploads the channel image. */
   doFileUploadRequest?: GlobalFileUploadRequest;
 }>;
 
@@ -49,8 +37,8 @@ export const ChannelEditDetailsContext = React.createContext(
 
 /**
  * Builds the {@link ChannelEditDetailsContextValue}. Rendered inside the
- * {@link NotificationTargetProvider} so that notifications emitted by `submit`
- * (via {@link useChannelActions}) resolve to the channel edit details host.
+ * {@link NotificationTargetProvider} so notifications from `submit` resolve to the edit details
+ * host.
  */
 const ChannelEditDetailsContextProviderInner = ({
   children,
@@ -97,10 +85,9 @@ const ChannelEditDetailsContextProviderInner = ({
 };
 
 /**
- * Creates and provides an {@link EditChannelDetailsStore} snapshotted from the
- * channel in the {@link ChannelDetailsContext}. Mount this once per edit session — the store captures the
- * channel's name/image at construction and does not track later WebSocket
- * updates, so an inbound `channel.updated` does not clobber in-progress edits.
+ * Provides an {@link EditChannelDetailsStore} snapshotted from the channel in the
+ * {@link ChannelDetailsContext}. Mount it once per edit session: the store does not track later
+ * `channel.updated` events, so they cannot overwrite in-progress edits.
  */
 export const ChannelEditDetailsProvider = ({
   children,

package/src/contexts/channelFileAttachmentListContext/ChannelFileAttachmentListContext.tsx

@@ -30,7 +30,7 @@ export const ChannelFileAttachmentListProvider = ({
     source.messageSearchFilters = {
       $or: [{ 'attachments.type': 'file' }, { 'attachments.type': 'audio' }],
     };
-    // Newest first so the list groups cleanly under month section headers.
+    // Newest first, so the list groups under month section headers.
     source.messageSearchSort = [{ field: 'created_at', direction: -1 }];
     source.activate();
     return source;

package/src/contexts/channelMediaListContext/ChannelMediaListContext.tsx

@@ -31,7 +31,7 @@ export const ChannelMediaListProvider = ({
       'attachments.type': { $in: ['image', 'video'] },
       type: undefined,
     };
-    // Newest media first so the grid reads top-to-bottom from most recent.
+    // Newest first.
     source.messageSearchSort = [{ field: 'created_at', direction: -1 }];
     source.activate();
     return source;