feat(thread-sub-pin-save-toolbar-react): add documentation for thread subscription, pin/save messages, pin conversation and toolbarTrailingView prop + Custom formatter guide in react v7 uikit docs

[PrajwalDhuleCC]

Description

Docs: Pin & Save, Thread Subscription, and Composer Toolbar Trailing View
Documents three v7 features across the React UI Kit docs, plus the toolbarTrailingView composer slot and a custom text-formatter guide.

New pages
components/pinned-messages.mdx — CometChatPinnedMessages (per-conversation pins, opened from the message header).
components/saved-messages.mdx — CometChatSavedMessages (personal, cross-conversation; standalone screen with no built-in trigger).
guide-pin-and-save-messages.mdx — end-to-end pin/save walkthrough.
guide-custom-text-formatter.mdx — minimal color formatter bound to a toolbarTrailingView button, rendered read-only in bubbles.
Updated pages
message-composer — toolbarTrailingView (View Props + Props + example).
message-list — hidePin/Unpin/Save/Unsave/ThreadSubscriptionOption + a "Pin and Save Options" section.
conversations — hidePinConversation, a "Pin Conversation" section (pin indicator, limits, system pins), and the ui:conversation/pin-changed event.
message-bubble — pinned/saved indicators (chrome table, section, CSS selectors).
message-header — onPinnedMessagesClicked / hidePinnedMessagesOption.
thread-header — subscription bell (hideThreadSubscriptionToggle, onThreadSubscriptionChange).
event-system — SDK events (message/pinned|unpinned|saved|unsaved, thread/subscription-changed) and UI events (ui:message/pin-changed, ui:message/save-changed, ui:conversation/pin-changed, ui:thread/subscription-changed).
core-features — "Pin and Save Messages" section + the features.ux.* limit settings.
components-overview — pinned/saved components.
guide-threaded-messages — "Thread Subscription" section.
docs.json — registered the new pages.

Related Issue(s)

Type of Change

• Documentation correction/update
• New documentation
• Improvement to existing documentation
• Typo fix
• Other (please specify)

Checklist

• I have read the CONTRIBUTING document
• My branch name follows the naming convention
• My changes follow the documentation style guide
• I have checked for spelling and grammar errors
• [] All links in my changes are valid and working
• My changes are accurately described in this pull request

Additional Information

Screenshots (if applicable)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
cometchat	🟢 Ready	View Preview	Aug 8, 2026, 3:45 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[raj-dubey1]

Docs review — ⚠️ Request changes (hold until the APIs ship + one fix needed regardless)

Thanks for this! Reviewed the branch end-to-end (structural checks + verified every component/prop/event against the published UI Kit). Structurally it's clean and build-safe, but most of the pin/save/thread-subscription surface documents components and props that don't exist in any published version of @cometchat/chat-uikit-react, so if this merges to main today those pages (and the two guides) won't compile for readers.

✅ What passed

• Build-safe: 0 dangling nav refs, 0 orphaned pages, 0 broken in-content links, 0 missing redirects.
• Genuinely correct content: the multi-attachment composer additions (enableMultipleAttachments, .cometchat-message-composer__tray ships in the CSS), the text-formatter base classes (CometChatTextFormatter, CometChatMentionsFormatter, CometChatMarkdownFormatter, CometChatUrlFormatter), and the event-hook APIs (useCometChatEvents, usePublishEvent) are all real in 7.1.0.

🔴 Blocker — documented components/props/events don't exist in any published UI Kit

Verified against @cometchat/chat-uikit-react@7.1.0 (= npm latest; every prerelease tag — beta/alpha/legacy — points to an older build, so nothing unreleased-and-ahead could contain these). Checked the bundled dist/index.d.ts, the runtime chunk, and the shipped dist/*.css. Grep returns zero matches for all of the following (real symbols like CometChatMessageComposer match fine):

• Two whole components don't exist: CometChatPinnedMessages and CometChatSavedMessages — not in the export list, no CSS. This makes pinned-messages.mdx, saved-messages.mdx, and guide-pin-and-save-messages.mdx document non-existent components. guide-custom-text-formatter.mdx also imports CometChatPinnedMessages.
• toolbarTrailingView doesn't exist on the MessageComposer (0 occurrences). Both message-composer.mdx and the entire payoff of guide-custom-text-formatter.mdx depend on it — the guide won't compile.
• All pin/save/subscription props are absent across message-list / message-header / conversations / thread-header: hidePinMessageOption, hideUnpinMessageOption, hideSaveMessageOption, hideUnsaveMessageOption, hideThreadSubscriptionOption, hidePinConversation, onPinnedMessagesClicked, hidePinnedMessagesOption, hideThreadSubscriptionToggle, onThreadSubscriptionChange.
• Fabricated events in event-system.mdx: SDK events message/pinned|unpinned|saved|unsaved and UI events ui:message/pin-changed, ui:message/save-changed, ui:conversation/pin-changed, ui:thread/subscription-changed aren't in the event union.
• CSS selectors for the pinned/saved bubble indicators and conversations__item-pin-indicator aren't in any shipped stylesheet.

🟠 Separately — a factual error to fix regardless of release timing

message-list.mdx marks parentMessageId as "Deprecated — pass parentMessage instead" (lines 35–38 and 756–758) and documents parentMessage: CometChat.BaseMessage as a MessageList prop. In shipped 7.1.0 this is inverted: MessageList's real prop is parentMessageId (current, not deprecated), and parentMessage exists only on ThreadHeader — it is not a MessageList prop. As written this would send every threaded-messages integrator to a prop that doesn't exist and away from the one that does. Please correct this even if the pin/save pages are held.

Ask

If these document an upcoming UI Kit release: hold/gate this PR until that version ships, pin the install/examples to it, and re-verify the exact component/prop names against the shipped build before publishing. Linking the UI Kit version/PR here would let us confirm quickly. The parentMessage/parentMessageId item should be fixed regardless.

_{🤖 Automated docs-PR review (structural script + API verification against the published package). Flagging for a human to confirm the release timing.}

[raj-dubey1]

Docs review — structure passes; one release-timing blocker risk

Mechanical / structural checks: all clear.

• Build is safe — 0 dangling nav refs; all 4 new pages are registered in docs.json and resolve.
• Redirect coverage complete — add-only PR (0 removed, 0 renamed), so no live URL dies; 0 chained 404s.
• 0 orphans, 0 broken internal links across the scanned ui-kit/react/ tree; all section anchors resolve.
• No TODO/FIXME/placeholders; no version/package drift; content is internally consistent (event names, payloads, optimistic-vs-network-confirmed semantics, pin-vs-save distinction all agree across pages).

⚠️ Blocker risk — documentation is ahead of the published packages. The entire documented feature surface is absent from the latest published releases, verified by grepping the packages directly:

• @cometchat/chat-uikit-react@7.1.0 contains none of: CometChatPinnedMessages, CometChatSavedMessages, toolbarTrailingView, hidePin*/hideSave*/hideUnsave*, onPinnedMessagesClicked, hidePinnedMessagesOption, hideThreadSubscription*, onThreadSubscription*. (usePublishEvent and CometChatTextFormatter, used by the custom-formatter guide, do exist — that guide is fine.)
• @cometchat/chat-sdk-javascript@4.1.14 has none of: pinMessage, unpinMessage, saveMessage, unsaveMessage, pinConversation, unpinConversation, isPinned, isSaved, getPinnedAt, getSavedAt, MessagesRequestBuilder.setPinned/.setSaved.

Affected examples: the SDK-call table + PinButton example in guide-pin-and-save-messages.mdx:162-198, the setPinned(true)/setSaved(true) filtering examples in pinned-messages.mdx:201-214 and saved-messages.mdx:160-172, and component/prop references across all four new feature pages.

Recommendation: If this PR is timed to land with the UI Kit / SDK release that ships these APIs, the content is accurate and merge is clean — treat this as a scheduling gate. If it would publish while the packages still lack these symbols, every code example fails to import/compile for readers; hold until the release ships. No redirect changes needed (add-only).

[jitvarpatil]

Docs review — ✅ Approve (one should-fix)

The React v7 UI Kit entry in this feature family (15 files, +1,836/−15) — two new component pages, two new guides, and updates across the component docs. Structurally clean, and every documented symbol verifies against the published package.

✅ API verified against published @cometchat/chat-uikit-react@7.2.0

CometChatPinnedMessages · CometChatSavedMessages · toolbarTrailingView · CometChatTextFormatter · CometChatEventsProvider · CometChatAttachmentHideOptions — all present.

Structure: all 4 new pages wired into nav; 0 nav breaks, 0 orphans, 0 broken links, redirects +0; no placeholders/TODOs across 1,836 new lines.

🟡 Should-fix — no minimum version stated

Package	Present in	Absent in
@cometchat/chat-uikit-react	7.2.0 only	7.1.0

Both CometChatPinnedMessages and toolbarTrailingView are absent from 7.1.0 — the previously-latest release. Anyone on 7.1.0 following these pages gets "component doesn't exist" errors with no explanation.

<Note>
**Available since v7.2.0** — pin, save, and `toolbarTrailingView` require
`@cometchat/chat-uikit-react` v7.2.0 or later. See [Getting Started](/ui-kit/react/overview) to upgrade.
</Note>

🔁 Pattern worth fixing at the template level

Three PRs, three platforms, same omission — and in every case the feature exists only in the single newest release:

PR	Platform	Requires	Absent in (previously latest)
#461	Flutter	cometchat_sdk 5.0.7 / cometchat_chat_uikit 6.1.1	5.0.6 / 6.1.0
#493	React Native	chat-sdk-react-native 4.1.0	4.0.29
#464	React	chat-uikit-react 7.2.0	7.1.0

That's less three oversights than a missing step in how this feature set is being documented. The transcription rollout (#487) got it right on all 5 platforms, so the pattern already exists in-repo — worth adding the availability callout to the page template before the Android/iOS versions land, rather than retrofitting it five times.

Content is accurate and well-structured throughout. Approving on the assumption the version note lands here or in a quick follow-up. 🚀

_{🤖 Automated docs review (Mintlify link/redirect/nav checks + API verification against published @cometchat/chat-uikit-react).}

[jitvarpatil]

Docs review — ✅ Approve (one should-fix)

The React v7 UI Kit entry in this feature family (15 files, +1,836/−15) — two new component pages, two new guides, and updates across the component docs. Structurally clean, and every documented symbol verifies against the published package.

✅ API verified against published @cometchat/chat-uikit-react@7.2.0

CometChatPinnedMessages · CometChatSavedMessages · toolbarTrailingView · CometChatTextFormatter · CometChatEventsProvider · CometChatAttachmentHideOptions — all present.

Structure: all 4 new pages wired into nav; 0 nav breaks, 0 orphans, 0 broken links, redirects +0; no placeholders/TODOs across 1,836 new lines.

🟡 Should-fix — no minimum version stated

Package	Present in	Absent in
@cometchat/chat-uikit-react	7.2.0 only	7.1.0

Both CometChatPinnedMessages and toolbarTrailingView are absent from 7.1.0 — the previously-latest release. Anyone on 7.1.0 following these pages gets "component doesn't exist" errors with no explanation.

<Note>
**Available since v7.2.0** — pin, save, and `toolbarTrailingView` require
`@cometchat/chat-uikit-react` v7.2.0 or later. See [Getting Started](/ui-kit/react/overview) to upgrade.
</Note>

🔁 Pattern worth fixing at the template level

Three PRs, three platforms, same omission — and in every case the feature exists only in the single newest release:

PR	Platform	Requires	Absent in (previously latest)
#461	Flutter	cometchat_sdk 5.0.7 / cometchat_chat_uikit 6.1.1	5.0.6 / 6.1.0
#493	React Native	chat-sdk-react-native 4.1.0	4.0.29
#464	React	chat-uikit-react 7.2.0	7.1.0

That's less three oversights than a missing step in how this feature set is being documented. The transcription rollout (#487) got it right on all 5 platforms, so the pattern already exists in-repo — worth adding the availability callout to the page template before the Android/iOS versions land, rather than retrofitting it five times.

Content is accurate and well-structured throughout. Approving on the assumption the version note lands here or in a quick follow-up. 🚀

_{🤖 Automated docs review (Mintlify link/redirect/nav checks + API verification against published @cometchat/chat-uikit-react).}