stream-chat-react-native-core 9.0.0-beta.37 → 9.0.0-beta.38

package/lib/typescript/contexts/componentsContext/defaultComponents.d.ts

@@ -1,10 +1,18 @@
 import React from 'react';
+import { ImageProps, TextInputProps } from 'react-native';
+import type { LocalMessage, UserResponse } from 'stream-chat';
+import type { MessageTextProps } from '../../components/Message/MessageItemView/MessageTextContainer';
 import type { MessageActionsProps } from '../../contexts/overlayContext/MessageOverlayHostLayer';
 /**
- * All default component implementations used across the SDK.
- * These are the components used when no overrides are provided via WithComponents.
+ * Normalizes each component entry to React.ComponentType<P>, stripping
+ * extra inferred properties (like `displayName: string` from runtime
+ * assignments) that would otherwise leak into the override types and
+ * force integrators to match them.
  */
-export declare const DEFAULT_COMPONENTS: {
+type NormalizeComponents<T> = {
+    [K in keyof T]: T[K] extends React.ComponentType<infer P> ? React.ComponentType<P> : T[K];
+};
+declare const components: {
     Attachment: (props: import("../../components/Attachment/Attachment").AttachmentProps) => React.JSX.Element | null;
     AttachButton: {
         (props: import("../../components/MessageInput/components/InputButtons/AttachButton").AttachButtonProps): React.JSX.Element;
@@ -279,20 +287,40 @@ export declare const DEFAULT_COMPONENTS: {
     };
     ImageGalleryVideoControls: React.MemoExoticComponent<(props: import("../..").ImageGalleryVideoControlProps) => React.JSX.Element>;
     MessageOverlayBackground: () => React.JSX.Element;
-    ImageComponent: React.ComponentType<any>;
-    AttachmentPickerIOSSelectMorePhotos: React.ComponentType<any> | undefined;
-    ChatLoadingIndicator: React.ComponentType<any> | null | undefined;
-    CreatePollContent: React.ComponentType<any> | undefined;
-    MessageActions: React.ComponentType<MessageActionsProps> | undefined;
-    Input: React.ComponentType<any> | undefined;
-    ListHeaderComponent: React.ComponentType<any> | undefined;
-    MessageContentBottomView: React.ComponentType<any> | undefined;
-    MessageContentLeadingView: React.ComponentType<any> | undefined;
-    MessageContentTopView: React.ComponentType<any> | undefined;
-    MessageContentTrailingView: React.ComponentType<any> | undefined;
-    MessageLocation: React.ComponentType<any> | undefined;
-    MessageSpacer: React.ComponentType<any> | undefined;
-    MessageText: React.ComponentType<any> | undefined;
-    PollContent: React.ComponentType<any> | undefined;
+    ImageComponent: React.ComponentType<ImageProps>;
 };
+/**
+ * Optional component slots that have no default implementation.
+ * These are `undefined` unless the integrator provides them via WithComponents.
+ */
+export interface OptionalComponentOverrides {
+    AttachmentPickerIOSSelectMorePhotos?: React.ComponentType;
+    ChatLoadingIndicator?: React.ComponentType | null;
+    CreatePollContent?: React.ComponentType;
+    Input?: React.ComponentType<{
+        additionalTextInputProps?: TextInputProps;
+        getUsers: () => UserResponse[];
+    }>;
+    ListHeaderComponent?: React.ComponentType;
+    MessageActions?: React.ComponentType<MessageActionsProps>;
+    MessageContentBottomView?: React.ComponentType;
+    MessageContentLeadingView?: React.ComponentType;
+    MessageContentTopView?: React.ComponentType;
+    MessageContentTrailingView?: React.ComponentType;
+    MessageLocation?: React.ComponentType<{
+        message: LocalMessage;
+    }>;
+    MessageSpacer?: React.ComponentType;
+    MessageText?: React.ComponentType<MessageTextProps>;
+    PollContent?: React.ComponentType;
+}
+/**
+ * All default component implementations used across the SDK.
+ * These are the components used when no overrides are provided via WithComponents.
+ *
+ * The `NormalizeComponents` cast ensures that internal details like
+ * `displayName: string` don't leak into the public override types.
+ */
+export declare const DEFAULT_COMPONENTS: NormalizeComponents<typeof components>;
+export {};
 //# sourceMappingURL=defaultComponents.d.ts.map

package/lib/typescript/contexts/componentsContext/defaultComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultComponents.d.ts","sourceRoot":"","sources":["../../../../src/contexts/componentsContext/defaultComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAkJ1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAuJJ,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC;yCAIC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;0BAEnD,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;uBAE9C,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;oBACvC,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,GAAG,SAAS;WAE7D,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;yBAEtB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;8BAE/B,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;+BAEnC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;2BAExC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;gCAE/B,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;qBAE/C,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;mBAEtC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;iBAEtC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;iBAEpC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS;CAC/D,CAAC"}
+{"version":3,"file":"defaultComponents.d.ts","sourceRoot":"","sources":["../../../../src/contexts/componentsContext/defaultComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAS,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AAiFtG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAEjG;;;;;GAKG;AACH,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1F,CAAC;AAEF,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsJW,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,mCAAmC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC1D,oBAAoB,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAClD,iBAAiB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC1B,wBAAwB,CAAC,EAAE,cAAc,CAAC;QAC1C,QAAQ,EAAE,MAAM,YAAY,EAAE,CAAC;KAChC,CAAC,CAAC;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC1C,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC1D,wBAAwB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC/C,yBAAyB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAChD,qBAAqB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5C,0BAA0B,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACjD,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IACjE,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACpC,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAAC,OAAO,UAAU,CAAc,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stream-chat-react-native-core",
   "description": "The official React Native and Expo components for Stream Chat, a service for building chat applications",
-  "version": "9.0.0-beta.37",
+  "version": "9.0.0-beta.38",
   "author": {
     "company": "Stream.io Inc",
     "name": "Stream.io Inc"

package/src/contexts/componentsContext/ComponentsContext.tsx

@@ -9,7 +9,8 @@ import React, { PropsWithChildren, useContext, useMemo } from 'react';
  */
 export type ComponentOverrides = Partial<
   (typeof import('./defaultComponents'))['DEFAULT_COMPONENTS']
->;
+> &
+  import('./defaultComponents').OptionalComponentOverrides;
 
 const ComponentsContext = React.createContext<ComponentOverrides>({});
 

package/src/contexts/componentsContext/defaultComponents.ts

@@ -1,5 +1,7 @@
 import React from 'react';
-import { Image } from 'react-native';
+import { Image, ImageProps, TextInputProps } from 'react-native';
+
+import type { LocalMessage, UserResponse } from 'stream-chat';
 
 import { Attachment } from '../../components/Attachment/Attachment';
 import { AudioAttachment } from '../../components/Attachment/Audio';
@@ -64,6 +66,7 @@ import { MessageReplies } from '../../components/Message/MessageItemView/Message
 import { MessageRepliesAvatars } from '../../components/Message/MessageItemView/MessageRepliesAvatars';
 import { MessageStatus } from '../../components/Message/MessageItemView/MessageStatus';
 import { MessageSwipeContent } from '../../components/Message/MessageItemView/MessageSwipeContent';
+import type { MessageTextProps } from '../../components/Message/MessageItemView/MessageTextContainer';
 import { MessageTimestamp } from '../../components/Message/MessageItemView/MessageTimestamp';
 import { ReactionListBottom } from '../../components/Message/MessageItemView/ReactionList/ReactionListBottom';
 import { ReactionListClustered } from '../../components/Message/MessageItemView/ReactionList/ReactionListClustered';
@@ -147,10 +150,16 @@ import { DefaultMessageOverlayBackground } from '../../contexts/overlayContext/M
 import type { MessageActionsProps } from '../../contexts/overlayContext/MessageOverlayHostLayer';
 
 /**
- * All default component implementations used across the SDK.
- * These are the components used when no overrides are provided via WithComponents.
+ * Normalizes each component entry to React.ComponentType<P>, stripping
+ * extra inferred properties (like `displayName: string` from runtime
+ * assignments) that would otherwise leak into the override types and
+ * force integrators to match them.
  */
-export const DEFAULT_COMPONENTS = {
+type NormalizeComponents<T> = {
+  [K in keyof T]: T[K] extends React.ComponentType<infer P> ? React.ComponentType<P> : T[K];
+};
+
+const components = {
   Attachment,
   AttachButton,
   AttachmentPickerContent,
@@ -300,35 +309,38 @@ export const DEFAULT_COMPONENTS = {
   MessageOverlayBackground: DefaultMessageOverlayBackground,
 
   // Image
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  ImageComponent: Image as React.ComponentType<any>,
-
-  // Optional overrides (no defaults — undefined unless user provides via WithComponents)
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  AttachmentPickerIOSSelectMorePhotos: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  ChatLoadingIndicator: undefined as React.ComponentType<any> | null | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  CreatePollContent: undefined as React.ComponentType<any> | undefined,
-  MessageActions: undefined as React.ComponentType<MessageActionsProps> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  Input: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  ListHeaderComponent: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageContentBottomView: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageContentLeadingView: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageContentTopView: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageContentTrailingView: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageLocation: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageSpacer: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  MessageText: undefined as React.ComponentType<any> | undefined,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  PollContent: undefined as React.ComponentType<any> | undefined,
+  ImageComponent: Image as React.ComponentType<ImageProps>,
 };
+
+/**
+ * Optional component slots that have no default implementation.
+ * These are `undefined` unless the integrator provides them via WithComponents.
+ */
+export interface OptionalComponentOverrides {
+  AttachmentPickerIOSSelectMorePhotos?: React.ComponentType;
+  ChatLoadingIndicator?: React.ComponentType | null;
+  CreatePollContent?: React.ComponentType;
+  Input?: React.ComponentType<{
+    additionalTextInputProps?: TextInputProps;
+    getUsers: () => UserResponse[];
+  }>;
+  ListHeaderComponent?: React.ComponentType;
+  MessageActions?: React.ComponentType<MessageActionsProps>;
+  MessageContentBottomView?: React.ComponentType;
+  MessageContentLeadingView?: React.ComponentType;
+  MessageContentTopView?: React.ComponentType;
+  MessageContentTrailingView?: React.ComponentType;
+  MessageLocation?: React.ComponentType<{ message: LocalMessage }>;
+  MessageSpacer?: React.ComponentType;
+  MessageText?: React.ComponentType<MessageTextProps>;
+  PollContent?: React.ComponentType;
+}
+
+/**
+ * All default component implementations used across the SDK.
+ * These are the components used when no overrides are provided via WithComponents.
+ *
+ * The `NormalizeComponents` cast ensures that internal details like
+ * `displayName: string` don't leak into the public override types.
+ */
+export const DEFAULT_COMPONENTS: NormalizeComponents<typeof components> = components;

package/src/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "9.0.0-beta.37"
+  "version": "9.0.0-beta.38"
 }

package/lib/commonjs/contexts/componentsContext/PLAN.md

@@ -1,148 +0,0 @@
-# WithComponents — Component Override System
-
-## Design Principle
-
-**All components are read from `useComponentsContext()`. All other contexts only provide data + APIs — never components.**
-
-## Current State (Completed)
-
-### What was done
-
-1. **Created `ComponentsContext`** — `WithComponents` provider, `useComponentsContext()` hook, `ComponentOverrides` type
-2. **Created `defaultComponents.ts`** — centralized map of all ~130 default components
-3. **Stripped component keys** from all existing context types: `MessagesContextValue`, `InputMessageInputContextValue`, `ChannelContextValue`, `ChannelsContextValue`, `AttachmentPickerContextValue`, `ThreadsContextValue`, `ImageGalleryContextValue`
-4. **Simplified `useCreate*Context` hooks** — no longer receive or forward component params
-5. **Simplified `Channel.tsx`** — removed ~90 component imports, prop defaults, forwarding lines
-6. **Simplified `ChannelList.tsx`** — removed ~19 component props
-7. **Updated ~80 consumer files** — switched from old context hooks to `useComponentsContext()`
-8. **Removed component override props** from ALL individual components
-9. **Updated all 3 example apps** (SampleApp, ExpoMessaging, TypeScriptMessaging)
-10. **Updated ~45 documentation pages** across docs-content repo
-11. **Merged with develop** and resolved conflicts
-
-### Architecture
-
-```
-User: <WithComponents overrides={{ Message: Custom }}>
-  ↓
-ComponentsContext (merges parent + overrides, inner wins)
-  ↓
-useComponentsContext() → { ...DEFAULT_COMPONENTS, ...overrides }
-  ↓
-Consumer: const { Message } = useComponentsContext()
-```
-
-### Key Files
-
-| File                    | Purpose                                                                                                                                   |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `ComponentsContext.tsx` | ~60 lines. `ComponentOverrides` type (derived from `typeof DEFAULT_COMPONENTS`), `WithComponents` provider, `useComponentsContext()` hook |
-| `defaultComponents.ts`  | ~300 lines. Single source of truth for all default component mappings. Adding a new component here auto-extends `ComponentOverrides`      |
-
-### Type System
-
-`ComponentOverrides` is derived automatically:
-
-```ts
-export type ComponentOverrides = Partial<(typeof import('./defaultComponents'))['DEFAULT_COMPONENTS']>;
-```
-
-No manual type maintenance — add a component to `DEFAULT_COMPONENTS` and the type updates.
-
-### Circular Dependency Handling
-
-`defaultComponents.ts` → imports components → components import `useComponentsContext` from `ComponentsContext.tsx`.
-
-Broken by lazy-loading defaults in the hook:
-
-```ts
-let cachedDefaults: ComponentOverrides | undefined;
-const getDefaults = () => {
-  if (!cachedDefaults) {
-    cachedDefaults = require('./defaultComponents').DEFAULT_COMPONENTS;
-  }
-  return cachedDefaults;
-};
-```
-
-### Naming Conventions
-
-Some component keys differ from their default component names to avoid collisions:
-
-| Override Key                            | Default Component                       | Why renamed                                                |
-| --------------------------------------- | --------------------------------------- | ---------------------------------------------------------- |
-| `FileAttachmentIcon`                    | `FileIcon`                              | Clarity                                                    |
-| `ChannelListLoadingIndicator`           | `ChannelListLoadingIndicator`           | Split from shared `LoadingIndicator` — renders skeleton UI |
-| `MessageListLoadingIndicator`           | `LoadingIndicator`                      | Split from shared `LoadingIndicator` — renders text        |
-| `ChatLoadingIndicator`                  | `undefined`                             | Optional, no default                                       |
-| `ThreadMessageComposer`                 | `MessageComposer`                       | Avoid collision with `MessageComposer` component name      |
-| `ThreadListComponent`                   | `DefaultThreadListComponent`            | Avoid collision with exported `ThreadList`                 |
-| `StartAudioRecordingButton`             | `AudioRecordingButton`                  | Historical naming                                          |
-| `ChannelPreview`                        | `ChannelPreviewView`                    | ChannelList preview item                                   |
-| `ChannelPreviewAvatar`                  | `ChannelAvatar`                         | ChannelList preview avatar                                 |
-| `ChannelListFooterLoadingIndicator`     | `ChannelListFooterLoadingIndicator`     | ChannelList footer                                         |
-| `ChannelListHeaderErrorIndicator`       | `ChannelListHeaderErrorIndicator`       | ChannelList header                                         |
-| `ChannelListHeaderNetworkDownIndicator` | `ChannelListHeaderNetworkDownIndicator` | ChannelList header                                         |
-
-### Optional Components (no default)
-
-These exist in `DEFAULT_COMPONENTS` as `undefined` with `React.ComponentType<any> | undefined` type assertions:
-
-`AttachmentPickerIOSSelectMorePhotos`, `ChatLoadingIndicator`, `CreatePollContent`, `ImageComponent`, `Input`, `ListHeaderComponent`, `MessageActions`, `MessageContentBottomView`, `MessageContentLeadingView`, `MessageContentTopView`, `MessageContentTrailingView`, `MessageLocation`, `MessageSpacer`, `MessageText`, `PollContent`
-
-### Shared Component Keys (audited)
-
-Some keys were used in multiple contexts before the refactor. Audit results:
-
-| Key                     | Used By               | Same Default?                                               | Resolution                                                                  |
-| ----------------------- | --------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------- |
-| `EmptyStateIndicator`   | Channel + ChannelList | Yes (differentiates via `listType` prop)                    | Single key ✅                                                               |
-| `LoadingErrorIndicator` | Channel + ChannelList | Yes (differentiates via `listType` prop)                    | Single key ✅                                                               |
-| `LoadingIndicator`      | Channel + ChannelList | **No** — Channel used text-based, ChannelList used skeleton | Split into `MessageListLoadingIndicator` + `ChannelListLoadingIndicator` ✅ |
-
-### API Alignment with stream-chat-react
-
-| Aspect    | React Native                        | React Web                              |
-| --------- | ----------------------------------- | -------------------------------------- |
-| Provider  | `WithComponents`                    | `WithComponents`                       |
-| Prop name | `overrides`                         | `overrides`                            |
-| Hook      | `useComponentsContext()`            | `useComponentContext()`                |
-| Type      | `ComponentOverrides` (auto-derived) | `ComponentContextValue` (hand-written) |
-| Defaults  | Lazy-loaded via `require()`         | Set at `Channel` level                 |
-| Merge     | `useMemo`                           | Plain spread (no memo)                 |
-
-## Known Issues / Future Work
-
-### Pre-existing Test Failures (not caused by this work)
-
-These test suites fail on `develop` too:
-
-- `offline-support/index.test.ts` — timeout
-- `ChannelList.test.js` — filter race condition (`channel.countUnread` mock missing)
-- `isAttachmentEqualHandler.test.js`, `MessageContent.test.js`, `MessageTextContainer.test.tsx`, `MessageUserReactions.test.tsx`, `ChannelPreview.test.tsx` — various pre-existing issues
-
-### Linter Interaction
-
-`@typescript-eslint/no-unused-vars` (warn, max-warnings 0) aggressively strips unused type keys. When adding new keys to `ComponentOverrides`, the type and its consumer must land in the same edit — otherwise the linter removes the key between saves.
-
-Since `ComponentOverrides` is now auto-derived from `DEFAULT_COMPONENTS`, this is no longer an issue for the type itself. But be aware when adding optional components (`undefined as React.ComponentType<any> | undefined`).
-
-### `contexts/index.ts` Barrel Export
-
-The `export * from './componentsContext/ComponentsContext'` line in `contexts/index.ts` was stripped by the linter multiple times during development. If `WithComponents` becomes unexportable from the package, check this barrel file first.
-
-### Documentation
-
-Docs PR: https://github.com/GetStream/docs-content/pull/1169
-
-Updated ~45 pages across:
-
-- Core teaching pages (custom_components, message-customization, etc.)
-- Component reference pages (channel-list, message-list, message-composer, etc.)
-- Context docs (stripped component keys from 7 context pages)
-- Migration guide (upgrading-from-v8.md — comprehensive WithComponents section)
-- Advanced guides (audio, AI, image-picker, etc.)
-
-### SDK PR
-
-https://github.com/GetStream/stream-chat-react-native/pull/3542

package/lib/module/contexts/componentsContext/PLAN.md

@@ -1,148 +0,0 @@
-# WithComponents — Component Override System
-
-## Design Principle
-
-**All components are read from `useComponentsContext()`. All other contexts only provide data + APIs — never components.**
-
-## Current State (Completed)
-
-### What was done
-
-1. **Created `ComponentsContext`** — `WithComponents` provider, `useComponentsContext()` hook, `ComponentOverrides` type
-2. **Created `defaultComponents.ts`** — centralized map of all ~130 default components
-3. **Stripped component keys** from all existing context types: `MessagesContextValue`, `InputMessageInputContextValue`, `ChannelContextValue`, `ChannelsContextValue`, `AttachmentPickerContextValue`, `ThreadsContextValue`, `ImageGalleryContextValue`
-4. **Simplified `useCreate*Context` hooks** — no longer receive or forward component params
-5. **Simplified `Channel.tsx`** — removed ~90 component imports, prop defaults, forwarding lines
-6. **Simplified `ChannelList.tsx`** — removed ~19 component props
-7. **Updated ~80 consumer files** — switched from old context hooks to `useComponentsContext()`
-8. **Removed component override props** from ALL individual components
-9. **Updated all 3 example apps** (SampleApp, ExpoMessaging, TypeScriptMessaging)
-10. **Updated ~45 documentation pages** across docs-content repo
-11. **Merged with develop** and resolved conflicts
-
-### Architecture
-
-```
-User: <WithComponents overrides={{ Message: Custom }}>
-  ↓
-ComponentsContext (merges parent + overrides, inner wins)
-  ↓
-useComponentsContext() → { ...DEFAULT_COMPONENTS, ...overrides }
-  ↓
-Consumer: const { Message } = useComponentsContext()
-```
-
-### Key Files
-
-| File                    | Purpose                                                                                                                                   |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `ComponentsContext.tsx` | ~60 lines. `ComponentOverrides` type (derived from `typeof DEFAULT_COMPONENTS`), `WithComponents` provider, `useComponentsContext()` hook |
-| `defaultComponents.ts`  | ~300 lines. Single source of truth for all default component mappings. Adding a new component here auto-extends `ComponentOverrides`      |
-
-### Type System
-
-`ComponentOverrides` is derived automatically:
-
-```ts
-export type ComponentOverrides = Partial<(typeof import('./defaultComponents'))['DEFAULT_COMPONENTS']>;
-```
-
-No manual type maintenance — add a component to `DEFAULT_COMPONENTS` and the type updates.
-
-### Circular Dependency Handling
-
-`defaultComponents.ts` → imports components → components import `useComponentsContext` from `ComponentsContext.tsx`.
-
-Broken by lazy-loading defaults in the hook:
-
-```ts
-let cachedDefaults: ComponentOverrides | undefined;
-const getDefaults = () => {
-  if (!cachedDefaults) {
-    cachedDefaults = require('./defaultComponents').DEFAULT_COMPONENTS;
-  }
-  return cachedDefaults;
-};
-```
-
-### Naming Conventions
-
-Some component keys differ from their default component names to avoid collisions:
-
-| Override Key                            | Default Component                       | Why renamed                                                |
-| --------------------------------------- | --------------------------------------- | ---------------------------------------------------------- |
-| `FileAttachmentIcon`                    | `FileIcon`                              | Clarity                                                    |
-| `ChannelListLoadingIndicator`           | `ChannelListLoadingIndicator`           | Split from shared `LoadingIndicator` — renders skeleton UI |
-| `MessageListLoadingIndicator`           | `LoadingIndicator`                      | Split from shared `LoadingIndicator` — renders text        |
-| `ChatLoadingIndicator`                  | `undefined`                             | Optional, no default                                       |
-| `ThreadMessageComposer`                 | `MessageComposer`                       | Avoid collision with `MessageComposer` component name      |
-| `ThreadListComponent`                   | `DefaultThreadListComponent`            | Avoid collision with exported `ThreadList`                 |
-| `StartAudioRecordingButton`             | `AudioRecordingButton`                  | Historical naming                                          |
-| `ChannelPreview`                        | `ChannelPreviewView`                    | ChannelList preview item                                   |
-| `ChannelPreviewAvatar`                  | `ChannelAvatar`                         | ChannelList preview avatar                                 |
-| `ChannelListFooterLoadingIndicator`     | `ChannelListFooterLoadingIndicator`     | ChannelList footer                                         |
-| `ChannelListHeaderErrorIndicator`       | `ChannelListHeaderErrorIndicator`       | ChannelList header                                         |
-| `ChannelListHeaderNetworkDownIndicator` | `ChannelListHeaderNetworkDownIndicator` | ChannelList header                                         |
-
-### Optional Components (no default)
-
-These exist in `DEFAULT_COMPONENTS` as `undefined` with `React.ComponentType<any> | undefined` type assertions:
-
-`AttachmentPickerIOSSelectMorePhotos`, `ChatLoadingIndicator`, `CreatePollContent`, `ImageComponent`, `Input`, `ListHeaderComponent`, `MessageActions`, `MessageContentBottomView`, `MessageContentLeadingView`, `MessageContentTopView`, `MessageContentTrailingView`, `MessageLocation`, `MessageSpacer`, `MessageText`, `PollContent`
-
-### Shared Component Keys (audited)
-
-Some keys were used in multiple contexts before the refactor. Audit results:
-
-| Key                     | Used By               | Same Default?                                               | Resolution                                                                  |
-| ----------------------- | --------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------- |
-| `EmptyStateIndicator`   | Channel + ChannelList | Yes (differentiates via `listType` prop)                    | Single key ✅                                                               |
-| `LoadingErrorIndicator` | Channel + ChannelList | Yes (differentiates via `listType` prop)                    | Single key ✅                                                               |
-| `LoadingIndicator`      | Channel + ChannelList | **No** — Channel used text-based, ChannelList used skeleton | Split into `MessageListLoadingIndicator` + `ChannelListLoadingIndicator` ✅ |
-
-### API Alignment with stream-chat-react
-
-| Aspect    | React Native                        | React Web                              |
-| --------- | ----------------------------------- | -------------------------------------- |
-| Provider  | `WithComponents`                    | `WithComponents`                       |
-| Prop name | `overrides`                         | `overrides`                            |
-| Hook      | `useComponentsContext()`            | `useComponentContext()`                |
-| Type      | `ComponentOverrides` (auto-derived) | `ComponentContextValue` (hand-written) |
-| Defaults  | Lazy-loaded via `require()`         | Set at `Channel` level                 |
-| Merge     | `useMemo`                           | Plain spread (no memo)                 |
-
-## Known Issues / Future Work
-
-### Pre-existing Test Failures (not caused by this work)
-
-These test suites fail on `develop` too:
-
-- `offline-support/index.test.ts` — timeout
-- `ChannelList.test.js` — filter race condition (`channel.countUnread` mock missing)
-- `isAttachmentEqualHandler.test.js`, `MessageContent.test.js`, `MessageTextContainer.test.tsx`, `MessageUserReactions.test.tsx`, `ChannelPreview.test.tsx` — various pre-existing issues
-
-### Linter Interaction
-
-`@typescript-eslint/no-unused-vars` (warn, max-warnings 0) aggressively strips unused type keys. When adding new keys to `ComponentOverrides`, the type and its consumer must land in the same edit — otherwise the linter removes the key between saves.
-
-Since `ComponentOverrides` is now auto-derived from `DEFAULT_COMPONENTS`, this is no longer an issue for the type itself. But be aware when adding optional components (`undefined as React.ComponentType<any> | undefined`).
-
-### `contexts/index.ts` Barrel Export
-
-The `export * from './componentsContext/ComponentsContext'` line in `contexts/index.ts` was stripped by the linter multiple times during development. If `WithComponents` becomes unexportable from the package, check this barrel file first.
-
-### Documentation
-
-Docs PR: https://github.com/GetStream/docs-content/pull/1169
-
-Updated ~45 pages across:
-
-- Core teaching pages (custom_components, message-customization, etc.)
-- Component reference pages (channel-list, message-list, message-composer, etc.)
-- Context docs (stripped component keys from 7 context pages)
-- Migration guide (upgrading-from-v8.md — comprehensive WithComponents section)
-- Advanced guides (audio, AI, image-picker, etc.)
-
-### SDK PR
-
-https://github.com/GetStream/stream-chat-react-native/pull/3542