@linktr.ee/messaging-react 3.31.0-rc-1785485102 → 3.31.0

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CCtHMrmO.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageBubble=e.MessageBubble;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.optimizeMessagingAttachmentUrl=e.optimizeMessagingAttachmentUrl;exports.resolveConversationParticipant=e.resolveConversationParticipant;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.useComposerLocked=e.useComposerLocked;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CcitzVoW.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageBubble=e.MessageBubble;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.optimizeMessagingAttachmentUrl=e.optimizeMessagingAttachmentUrl;exports.resolveConversationParticipant=e.resolveConversationParticipant;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.useComposerLocked=e.useComposerLocked;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -33,24 +33,37 @@ export declare type AttachmentSourceType = 'image' | 'audio' | 'video' | 'docume
 declare interface AudioAttachmentSharedProps extends MessageAttachmentBaseProps {
     /** Audio source URL (`mp3`, `aac`, `wav`, …). */
     src?: string;
-    /** MIME type hint — gates playability via the player's `canPlayType` probe. */
+    /** MIME type hint — typed onto the inline `<source>` element. */
     mimeType?: string;
     /**
-     * Filename — the download default name for the trailing action, and
-     * part of each control's accessible name.
+     * Filename — used as the download default name (consumed by the
+     * native player's kebab menu). The HTML `<audio>` element doesn't
+     * expose a built-in title slot, so we don't render the filename
+     * inside the bubble itself.
      */
     filename?: string;
     /**
      * Stacked audio. Takes precedence over `src` when set. Each item
-     * renders its own waveform row, vertically stacked inside the same
-     * bubble with an 8px gap. Sent + Received only — the composer surface
-     * accepts a single attachment at a time.
+     * renders its own native `<audio controls>` player, vertically
+     * stacked inside the same bubble with an 8px gap between players.
+     * Sent + Received only — the composer surface accepts a single
+     * attachment at a time.
      */
     items?: MessageAttachmentAudioItem[];
-    /** See `AudioItem.durationSeconds`. Applies to the single-`src` shape. */
-    durationSeconds?: number;
-    /** See `AudioItem.waveformData`. Applies to the single-`src` shape. */
-    waveformData?: number[];
+    /**
+     * `<audio preload>` hint applied to every player on the bubble.
+     * When omitted, the default depends on the rendered shape:
+     *
+     *   - Single audio (no `items`, or `items.length === 1`) →
+     *     `'metadata'` so the native player surfaces duration
+     *     immediately.
+     *   - Stacked audio (`items.length > 1`) → `'none'` so a thread
+     *     of voice memos doesn't fan out N parallel metadata requests
+     *     on first paint.
+     *
+     * Per-track overrides live on `AudioItem.preload`.
+     */
+    preload?: MediaPreloadMode;
 }
 
 /**
@@ -74,6 +87,8 @@ export declare type BroadcastClickHandler = (broadcast: {
     name?: string;
 }) => void;
 
+export declare type BroadcastNameResolver = (broadcastId: string) => string | undefined;
+
 /**
  * Build the meta line shown under the title in compact document / file
  * attachments — `EXT · SIZE` (`PDF · 379.5 KB`). Either part is dropped
@@ -197,7 +212,7 @@ export declare const ChannelView: default_2.NamedExoticComponent<ChannelViewProp
  * Props that MessagingShell passes through to ChannelView.
  * ChannelViewProps is the source of truth for these props.
  */
-declare type ChannelViewPassthroughProps = Pick<ChannelViewProps, 'renderMessageInputActions' | 'renderConversationFooter' | 'CustomChannelEmptyState' | 'onBlockParticipantClick' | 'onReportParticipantClick' | 'dmAgentEnabled' | 'onMessageSent' | 'chatbotVotingEnabled' | 'viewerLanguage' | 'renderChannelBanner' | 'customChannelActions' | 'renderChannelActions' | 'onParticipantNameClick' | 'renderMessage' | 'onMessageLinkClick' | 'onBroadcastClick' | 'showChannelInfo' | 'composerInput'>;
+declare type ChannelViewPassthroughProps = Pick<ChannelViewProps, 'renderMessageInputActions' | 'renderConversationFooter' | 'CustomChannelEmptyState' | 'onBlockParticipantClick' | 'onReportParticipantClick' | 'dmAgentEnabled' | 'onMessageSent' | 'chatbotVotingEnabled' | 'viewerLanguage' | 'renderChannelBanner' | 'customChannelActions' | 'renderChannelActions' | 'onParticipantNameClick' | 'renderMessage' | 'onMessageLinkClick' | 'onBroadcastClick' | 'resolveBroadcastName' | 'showChannelInfo' | 'composerInput'>;
 
 /**
  * ChannelView component props
@@ -388,6 +403,13 @@ export declare interface ChannelViewProps {
      * Hosts own navigation so this shared package never assumes an admin URL.
      */
     onBroadcastClick?: BroadcastClickHandler;
+    /**
+     * Resolves the current campaign name for a broadcast label. The host must
+     * provide a new resolver reference when a returned name changes so
+     * ChannelView re-renders and publishes the new value to memoized rows. The
+     * stamped message name remains the fallback until this returns a name.
+     */
+    resolveBroadcastName?: BroadcastNameResolver;
     /**
      * Passed to Stream `Channel` as `SendButton`. Required for hosts that replace
      * the send control: `Channel` merges this into `ComponentContext` and an
@@ -529,7 +551,9 @@ export declare function formatFileSize(bytes: number): string;
 
 /**
  * Format a date - shows time for today, relative time for older messages
- * (e.g., "Just now", "2:08 PM" for today, "Yesterday" for yesterday, "2d" for 2 days ago)
+ * (e.g., "Just now", "2:08 PM" for today, "Yesterday" for yesterday,
+ * "Mon" for 2-6 days ago, "Jul 14" for older dates this year,
+ * "Jul 14, 2025" for previous years)
  */
 export declare const formatRelativeTime: (date: Date) => string;
 
@@ -961,7 +985,7 @@ declare type MediaPreloadMode = 'none' | 'metadata' | 'auto';
  *   - Pdf / Audio / File render their compact rows / players in a
  *     vertical stack with an 8px gap between rows. Each row keeps
  *     its own activation target — Pdf opens the carousel-aware
- *     `PdfViewer` at that index, Audio gets its own waveform player,
+ *     `PdfViewer` at that index, Audio gets its own native player,
  *     and File downloads the asset for that row.
  *
  * The Composer surface accepts only a single attachment at a time,
@@ -979,29 +1003,12 @@ declare type MediaPreloadMode = 'none' | 'metadata' | 'auto';
  * download button to the chrome; the Video viewer relies on the
  * native `<video controls>` download menu, and the Pdf viewer
  * inherits the browser's built-in PDF download. Sibling-row Download
- * buttons on Pdf / File and the Audio card's trailing action expose
+ * buttons on Pdf / File and the native `<audio>` controls expose
  * downloads outside the viewer too. The lightbox chrome is styled
  * with plain CSS (`.mes-media-viewer*`) so the package's shipped
  * stylesheet is enough to render the viewer correctly without a
  * Tailwind dependency in the consumer.
  *
- * # Audio requires a `<Channel>` ancestor
- *
- * `MessageAttachment.Audio.*` renders the waveform player card —
- * a 32px play toggle, a 35-bar waveform with a progress fill and a
- * native seek control, the duration, and a 32px trailing action
- * (Remove in the composer, Download once sent). Playback is
- * `stream-chat-react`'s pooled `AudioPlayer`, which is what supplies
- * single-player-at-a-time across a thread, pause-on-navigation and
- * saved-position restore across virtualized remounts.
- *
- * That pool is provided by `<Channel>`. Rendered outside one the card
- * still draws in full, but its play and seek controls are disabled —
- * so a story or a new consumer surface must mount `<Channel>` (or
- * `stream-chat-react`'s `WithAudioPlayback`) for the card to be
- * playable. The waveform bars themselves are styled with plain CSS
- * (`.mes-audio-wave*`), so the shipped stylesheet is enough.
- *
  * # Lazy-loading defaults
  *
  * Media attachments bake in network-friendly defaults for long chat
@@ -1022,12 +1029,13 @@ declare type MediaPreloadMode = 'none' | 'metadata' | 'auto';
  *     `VideoItem.preload` per item). Once the viewer is open the
  *     active item bumps to `preload="metadata"` so duration / the
  *     first frame appear immediately.
- *   - **Audio** — no audio bytes are fetched until the user presses
- *     play: the pooled `AudioPlayer` acquires the shared `<audio>`
- *     element lazily. A card whose `durationSeconds` is unknown makes
- *     one `preload="metadata"` header request to fill the duration
- *     slot; supplying `durationSeconds` (which `StreamAttachmentMessage`
- *     maps from the attachment's persisted `duration`) avoids even that.
+ *   - **Audio** — a single audio bubble defaults to
+ *     `preload="metadata"` so the native player surfaces duration
+ *     immediately. A stacked audio bubble (`items.length > 1`)
+ *     defaults to `preload="none"` for every player so a thread of
+ *     voice memos doesn't fan out N parallel metadata requests on
+ *     first paint. Override via the attachment's `preload` prop
+ *     (or `AudioItem.preload` per track).
  *   - **Pdf** / **File** — no inline media element to throttle; the
  *     bubble renders compact rows that download / open lazily on
  *     activation. No `loading` / `preload` props on these surfaces.
@@ -1072,40 +1080,28 @@ export declare interface MessageAttachmentAudioComposerProps extends ComposerExt
     src?: string;
     mimeType?: string;
     filename?: string;
-    /** See `AudioItem.durationSeconds`. */
-    durationSeconds?: number;
-    /** See `AudioItem.waveformData`. */
-    waveformData?: number[];
+    /** See `AudioAttachmentSharedProps.preload`. */
+    preload?: MediaPreloadMode;
 }
 
 /** A single audio file inside an Audio attachment (single or stacked). */
 export declare interface MessageAttachmentAudioItem {
     src: string;
-    /** MIME type hint — gates playability via the player's `canPlayType` probe. */
+    /** MIME type hint — typed onto the inline `<source>` element. */
     mimeType?: string;
     /**
-     * Filename — the download default name for the card's trailing
-     * action, and part of the card's accessible name.
+     * Filename — used as the download default name (consumed by the
+     * native player's kebab menu).
      */
     filename?: string;
     /**
-     * Track length in seconds. Rendered as `MM:SS` before playback
-     * starts, so the duration is correct on first paint with no network
-     * request. Sourced from the Stream attachment's `duration` field,
-     * which the composer writes at send time. When omitted the card
-     * shows `--:--` until a one-shot `loadedmetadata` probe resolves.
+     * Per-track override for the `<audio preload>` hint. Defaults to
+     * the parent attachment's `preload` value, which itself defaults
+     * to `'metadata'` for a single audio (so the native player can
+     * surface duration immediately) and `'none'` for a stacked thread
+     * (so a fan-out of metadata requests doesn't happen on first paint).
      */
-    durationSeconds?: number;
-    /**
-     * Waveform amplitudes, each `0..1`, in track order. Resampled to the
-     * rendered bar count, so any length is accepted. Sourced from the
-     * Stream attachment's `waveform_data`, which the composer computes
-     * from the local file and writes at send time.
-     *
-     * When omitted, the card renders a flat placeholder row: every bar at
-     * the minimum height, with the progress fill still tracking playback.
-     */
-    waveformData?: number[];
+    preload?: MediaPreloadMode;
 }
 
 export declare type MessageAttachmentAudioReceivedProps = AudioAttachmentSharedProps;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as e, b as t, C as i, c as o, d as n, e as m, F as r, f as g, L as l, h as M, M as c, i as u, j as L, k as h, l as p, m as d, n as v, p as C, q as A, s as k, t as F, u as b, v as P, w as f, x, o as y, y as z, z as B, B as S, D as q, E as D, G as E, H as V, I as w } from "./index-B96WLmx6.js";
+import { a as e, b as t, C as i, c as o, d as n, e as m, F as r, f as g, L as l, h as M, M as c, i as u, j as L, k as h, l as p, m as d, n as v, p as C, q as A, s as k, t as F, u as b, v as P, w as f, x, o as y, y as z, z as B, B as S, D as q, E as D, G as E, H as V, I as w } from "./index-CN3errpB.js";
 export {
   e as ActionButton,
   t as Avatar,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/messaging-react",
-  "version": "3.31.0-rc-1785485102",
+  "version": "3.31.0",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@linktr.ee/component-library": "11.8.6",
-    "@linktr.ee/messaging-core": "2.3.0-rc-1785485102",
+    "@linktr.ee/messaging-core": "^2.2.0",
     "@linktr.ee/messaging-taxonomy": "^0.5.0",
     "@phosphor-icons/react": "^2.1.10",
     "culori": "^4.0.2"

package/src/components/ChannelView.broadcast-name.integration.test.tsx

@@ -0,0 +1,116 @@
+import { act, render, screen } from '@testing-library/react'
+import React, { useEffect } from 'react'
+import { Channel as StreamChannel, StreamChat } from 'stream-chat'
+import { Channel, Chat } from 'stream-chat-react'
+import { describe, expect, it, vi } from 'vitest'
+
+import { ChannelView } from './ChannelView'
+
+const message = {
+  id: 'message-1',
+  cid: 'messaging:channel-1',
+  type: 'regular',
+  text: 'July class details',
+  status: 'received',
+  user: { id: 'linker-1', name: 'Linker' },
+  metadata: {
+    broadcast_id: 'broadcast-1',
+    broadcast_name: 'July 9th Class attendees',
+  },
+  attachments: [],
+  latest_reactions: [],
+  own_reactions: [],
+  reaction_counts: {},
+  reaction_scores: {},
+  reply_count: 0,
+  mentioned_users: [],
+  created_at: new Date(),
+  updated_at: new Date(),
+}
+
+const createChannel = () => {
+  const client = new StreamChat('mock-api-key', {
+    allowServerSideConnect: true,
+  })
+  client.userID = 'linker-1'
+  client.user = { id: 'linker-1', name: 'Linker' }
+
+  const channel = client.channel('messaging', 'channel-1')
+  channel.initialized = true
+  channel.state.messages = [message] as never
+  channel.state.members = {
+    'linker-1': {
+      user: { id: 'linker-1', name: 'Linker' },
+      user_id: 'linker-1',
+      role: 'owner',
+    },
+    'visitor-1': {
+      user: { id: 'visitor-1', name: 'Visitor' },
+      user_id: 'visitor-1',
+      role: 'member',
+    },
+  } as never
+
+  return { channel, client }
+}
+
+describe('ChannelView broadcast-name resolution', () => {
+  it('updates an existing Stream message row when the resolved name arrives', async () => {
+    const { channel, client } = createChannel()
+    const firstResolver = () => undefined
+    const secondResolver = () => 'July 9th Class absentee'
+    const mounts = vi.fn()
+    const unmounts = vi.fn()
+
+    const RowProbe = ({ children }: { children: React.ReactNode }) => {
+      useEffect(() => {
+        mounts()
+        return unmounts
+      }, [])
+      return <>{children}</>
+    }
+    const renderMessage = (messageNode: React.ReactElement) => (
+      <RowProbe>{messageNode}</RowProbe>
+    )
+
+    let rerender!: ReturnType<typeof render>['rerender']
+    await act(async () => {
+      rerender = render(
+        <Chat client={client}>
+          <Channel channel={channel as StreamChannel}>
+            <ChannelView
+              channel={channel as StreamChannel}
+              resolveBroadcastName={firstResolver}
+              renderMessage={renderMessage}
+            />
+          </Channel>
+        </Chat>
+      ).rerender
+    })
+
+    expect(
+      screen.getByTestId('sent-message-broadcast-status')
+    ).toHaveTextContent('July 9th Class attendees')
+    expect(mounts).toHaveBeenCalledOnce()
+
+    act(() => {
+      rerender(
+        <Chat client={client}>
+          <Channel channel={channel as StreamChannel}>
+            <ChannelView
+              channel={channel as StreamChannel}
+              resolveBroadcastName={secondResolver}
+              renderMessage={renderMessage}
+            />
+          </Channel>
+        </Chat>
+      )
+    })
+
+    expect(
+      screen.getByTestId('sent-message-broadcast-status')
+    ).toHaveTextContent('July 9th Class absentee')
+    expect(mounts).toHaveBeenCalledOnce()
+    expect(unmounts).not.toHaveBeenCalled()
+  })
+})

package/src/components/ChannelView.tsx

@@ -16,6 +16,10 @@ import type { ChannelViewProps } from '../types'
 import { ChannelHeaderRedesign } from './ChannelHeaderRedesign'
 import { CustomDateSeparator } from './CustomDateSeparator'
 import { CustomMessage } from './CustomMessage'
+import {
+  BroadcastNameContext,
+  useBroadcastNamesById,
+} from './CustomMessage/BroadcastNameContext'
 import { CustomMessageActions } from './CustomMessage/CustomMessageActions'
 import { CustomMessageInput } from './CustomMessageInput'
 import { CustomSystemMessage } from './CustomSystemMessage'
@@ -57,6 +61,7 @@ const ChannelViewInner: React.FC<{
   showChannelInfo?: boolean
   onParticipantNameClick?: () => void
   onBroadcastClick?: ChannelViewProps['onBroadcastClick']
+  resolveBroadcastName?: ChannelViewProps['resolveBroadcastName']
   composerInput?: ChannelViewProps['composerInput']
 }> = ({
   onBack,
@@ -84,9 +89,10 @@ const ChannelViewInner: React.FC<{
   showChannelInfo = true,
   onParticipantNameClick,
   onBroadcastClick,
+  resolveBroadcastName,
   composerInput,
 }) => {
-  const { channel } = useChannelStateContext()
+  const { channel, messages } = useChannelStateContext()
   const onBroadcastClickRef = useRef(onBroadcastClick)
   useEffect(() => {
     onBroadcastClickRef.current = onBroadcastClick
@@ -99,6 +105,12 @@ const ChannelViewInner: React.FC<{
   const messageBroadcastClick = onBroadcastClick
     ? stableOnBroadcastClick
     : undefined
+  // Resolve outside memoized Stream rows so new campaign names publish without
+  // remounting the rows.
+  const broadcastNamesById = useBroadcastNamesById(
+    messages,
+    resolveBroadcastName
+  )
 
   const hasVisibleMessages = channel.state.messages.some(
     (message) => message.type !== 'deleted'
@@ -153,7 +165,7 @@ const ChannelViewInner: React.FC<{
   )
 
   return (
-    <>
+    <BroadcastNameContext.Provider value={broadcastNamesById}>
       <WithComponents
         overrides={{
           Message: MessageOverride,
@@ -265,7 +277,7 @@ const ChannelViewInner: React.FC<{
           )}
         </Window>
       </WithComponents>
-    </>
+    </BroadcastNameContext.Provider>
   )
 }
 
@@ -308,6 +320,7 @@ export const ChannelView = React.memo<ChannelViewProps>(
     showChannelInfo = true,
     onParticipantNameClick,
     onBroadcastClick,
+    resolveBroadcastName,
     composerInput,
   }) => {
     // Custom send message handler that:
@@ -422,6 +435,7 @@ export const ChannelView = React.memo<ChannelViewProps>(
               showChannelInfo={showChannelInfo}
               onParticipantNameClick={onParticipantNameClick}
               onBroadcastClick={onBroadcastClick}
+              resolveBroadcastName={resolveBroadcastName}
               composerInput={composerInput}
             />
           </Channel>

package/src/components/CustomLinkPreviewList/CustomLinkPreviewList.test.tsx

@@ -64,6 +64,21 @@ describe('CustomLinkPreviewList', () => {
     expect(screen.queryByRole('img')).toBeNull()
   })
 
+  it('is not a scroller of its own: the composer card scrolls as one piece (MES-1037)', () => {
+    // The inverted layout contract — see this component's doc comment. While
+    // this list scrolled and shrank on its own, a staged preview was cropped to
+    // keep the textarea above the keyboard instead of scrolling with it.
+    const { container } = stage({
+      status: LinkPreviewStatus.LOADED,
+      title: 'Example story',
+      image_url: 'https://cdn.example.com/story.jpg',
+    })
+
+    const list = container.querySelector('.messaging-link-preview-list')
+    expect(list).not.toHaveClass('overflow-y-auto')
+    expect(list).not.toHaveClass('min-h-0')
+  })
+
   it('is dismiss-only: the staged card never navigates', () => {
     // The deliberate behaviour change in MES-1349 — see this component's own
     // doc comment for why (MES-1358 §7 Q7, touch hazard). Asserted so the

package/src/components/CustomLinkPreviewList/index.tsx

@@ -52,14 +52,15 @@ export const CustomLinkPreviewList = () => {
   if (!showLinkPreviews) return null
 
   return (
-    // Layout contract: this list is the composer's *shrinkable* region. The
-    // mobile visitor surface sizes itself to the keyboard-shrunk
-    // visualViewport, so when vertical space runs out this container gives
-    // way (min-h-0) and scrolls, while the textarea + send row stays visible
-    // (shrink-0 in CustomMessageInput). Each card is wrapped in a shrink-0
-    // block so it keeps its intrinsic height and the container scrolls — a
-    // bare flex-column child would be shrunk on the column axis and its
-    // fixed-height hero would spill out of the collapsed card box.
+    // Layout contract: this list is NOT a scrollable or shrinkable region. It
+    // used to be the composer's one squeezable box, giving way (min-h-0) and
+    // scrolling on its own so the textarea row could stay pinned above the
+    // keyboard. That cropped the preview to make room for the input, which read
+    // as the preview being cut off; MES-1037 inverted it. The composer card
+    // (`.central-container`) is now the single capped scroll container and this
+    // list scrolls as one piece with the textarea inside it, so the preview
+    // always keeps its full height and only the visible slice of it changes.
+    // Do not reintroduce a nested scroller or a min-h-0 here.
     //
     // Horizontally the card does NOT shrink, deliberately. `CardShell` bakes
     // Figma's `w-[290px]` and there is exactly one width, in the toolkit
@@ -89,12 +90,12 @@ export const CustomLinkPreviewList = () => {
     // viewport. That is the whole trade: deform every narrow surface, or leave
     // one sub-floor device class awkward.
     //
-    // It is awkward, not broken. Setting only `overflow-y` promotes the other
-    // axis, so `overflow-x` computes to `auto` and the region scrolls sideways
-    // instead of spilling; at 320px the dismiss button's right edge lands ~6px
-    // past the fold, reachable by scrolling. That residue belongs to whoever
-    // owns the mobile layout contract, not to this component.
-    <div className="messaging-link-preview-list flex min-h-0 flex-col items-stretch w-full gap-2 overflow-y-auto overscroll-contain">
+    // It is awkward, not broken. The card above sets only `overflow-y`, which
+    // promotes the other axis, so its `overflow-x` computes to `auto` and it
+    // scrolls sideways instead of spilling; at 320px the dismiss button's right
+    // edge lands ~6px past the fold, reachable by scrolling. That residue
+    // belongs to whoever owns the mobile layout contract, not to this component.
+    <div className="messaging-link-preview-list flex flex-col items-stretch w-full gap-2">
       {stateLinkPreviews.map((linkPreview) => {
         // A LOADING preview has no `image_url` yet, so keying the layout off
         // the image alone rendered the skeleton as two bare text bars and then
@@ -104,18 +105,15 @@ export const CustomLinkPreviewList = () => {
         const isLoading = LinkPreviewsManager.previewIsLoading(linkPreview)
 
         return (
-          <div key={linkPreview.og_scrape_url} className="w-full shrink-0">
-            <LinkAttachment.Composer
-              title={linkPreview.title}
-              url={linkPreview.og_scrape_url}
-              thumbnailUrl={linkPreview.image_url}
-              layout={
-                isLoading || linkPreview.image_url ? 'featured' : 'classic'
-              }
-              status={isLoading ? 'loading' : 'ready'}
-              onDismiss={() => handleDismiss(linkPreview.og_scrape_url)}
-            />
-          </div>
+          <LinkAttachment.Composer
+            key={linkPreview.og_scrape_url}
+            title={linkPreview.title}
+            url={linkPreview.og_scrape_url}
+            thumbnailUrl={linkPreview.image_url}
+            layout={isLoading || linkPreview.image_url ? 'featured' : 'classic'}
+            status={isLoading ? 'loading' : 'ready'}
+            onDismiss={() => handleDismiss(linkPreview.og_scrape_url)}
+          />
         )
       })}
     </div>

package/src/components/CustomMessage/BroadcastNameContext.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it, vi } from 'vitest'
+
+import { buildBroadcastNamesById } from './BroadcastNameContext'
+
+describe('buildBroadcastNamesById', () => {
+  it('returns undefined when no resolver is provided', () => {
+    expect(
+      buildBroadcastNamesById(
+        [{ metadata: { broadcast_id: 'broadcast-1' } }],
+        undefined
+      )
+    ).toBeUndefined()
+  })
+
+  it('resolves each unique broadcast id once', () => {
+    const resolveBroadcastName = vi.fn((id: string) => `name-for-${id}`)
+
+    expect(
+      buildBroadcastNamesById(
+        [
+          { metadata: { broadcast_id: 'broadcast-1' } },
+          { metadata: { broadcast_id: 'broadcast-1' } },
+          { metadata: { broadcast_id: 'broadcast-2' } },
+          { metadata: {} },
+        ],
+        resolveBroadcastName
+      )
+    ).toEqual({
+      'broadcast-1': 'name-for-broadcast-1',
+      'broadcast-2': 'name-for-broadcast-2',
+    })
+    expect(resolveBroadcastName).toHaveBeenCalledTimes(2)
+  })
+
+  it('omits ids the resolver cannot resolve yet', () => {
+    expect(
+      buildBroadcastNamesById(
+        [{ metadata: { broadcast_id: 'broadcast-1' } }],
+        () => undefined
+      )
+    ).toBeUndefined()
+  })
+})