Skip to content

chore: Deprecate legacy AutoComplete, Contextualbar, Sidebar and TopBar components - #2135

Merged
tassoevan merged 5 commits into
mainfrom
refactor/mark-regressions
Jul 30, 2026
Merged

tassoevan merged 5 commits into
mainfrom
refactor/mark-regressions

Conversation

@tassoevan

Copy link
Copy Markdown
Member

Proposed changes (including videos or screenshots)

Marks the legacy component families as deprecated through @deprecated JSDoc, so consumers get IDE and API-report warnings before they are removed. No runtime behavior changes — comments only.

Deprecated Use instead
AutoComplete (@rocket.chat/fuselage) SelectFiltered / MultiSelectFiltered
AutoComplete (@rocket.chat/fuselage-forms) MultiSelectFiltered
Contextualbar* ContextualbarV2*
Sidebar* SidebarV2*
TopBar*, TopBarV2, SidebarTopBar* NavBar

Notes on the mapping:

  • The Contextualbar family is a 1:1 rename, so every component and props type points at its ContextualbarV2* counterpart.
  • The Sidebar family is not 1:1. Where a counterpart exists it is named (for example SidebarItemTimeSidebarV2ItemTimestamp, SidebarItemAvatarSidebarV2ItemAvatarWrapper, SidebarSectionTitleSidebarV2GroupTitle). SidebarItemContainer, SidebarItemWrapper and SidebarItemSubtitle have no V2 equivalent, since V2 restructured them into SidebarV2ItemRow/SidebarV2ItemCol, so those point at the family instead of asserting a replacement.
  • Both TopBar and TopBarV2 are deprecated, so there is no in-family successor; they point at NavBar for app-level navigation.
  • These components are exported as export default memo(X) in the Contextualbar family, where JSDoc on the inner declaration does not attach to the exported symbol. The tags are therefore placed on the export default statements, which is what makes them show up in the API reports.

Issue(s)

Further comments

Verified per commit: yarn build for both affected packages (api-extractor regenerated fuselage.api.md and fuselage-forms.api.md, and the reports confirm every intended export flipped to @public @deprecated and nothing else did), plus yarn lint (0 errors, only the 3 pre-existing react-hooks/exhaustive-deps warnings in MultiSelect/SelectLegacy) and tsc --noEmit.

Unit tests and visual regression were not run — the changes are comments only and do not affect rendered output.

tassoevan and others added 5 commits July 30, 2026 11:44
Mark the `AutoComplete` component and its props type as deprecated in favor
of `SelectFiltered` and `MultiSelectFiltered`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mark the wrapped `AutoComplete` component as deprecated in favor of
`MultiSelectFiltered`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mark all `Contextualbar*` components and their props types as deprecated in
favor of their `ContextualbarV2*` counterparts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mark the legacy `Sidebar*` components and their props types as deprecated in
favor of their `SidebarV2*` counterparts. The `TopBar*` components exported
from the same directory are left untouched, as they are not superseded by
`SidebarV2`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mark every `TopBar*` export, including `TopBarV2` and the `SidebarTopBar*`
aliases, as deprecated in favor of `NavBar` for app-level navigation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Jul 30, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 406169c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
@rocket.chat/fuselage Patch
@rocket.chat/fuselage-forms Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@mergify

mergify Bot commented Jul 30, 2026

Copy link
Copy Markdown

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

@tassoevan
tassoevan merged commit 70fd444 into main Jul 30, 2026
8 checks passed
@tassoevan
tassoevan deleted the refactor/mark-regressions branch July 30, 2026 19:25
@github-actions github-actions Bot mentioned this pull request Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants