BrightWeb UI component inventory

Last updated

Source file

docs/ui-components.md

This inventory records the reusable visual APIs included in the current release line through Brief 46. “Used by” names package consumers rather than individual files. A dash in the MQ origin column means the component is a platform primitive or predates the file-by-file MQ translation ledgers.

Tier definitions:

  • primitive — low-level control or compound control family.
  • pattern — reusable composition with BrightWeb layout or semantic styling.
  • surface — route-, shell-, or module-level experience.

@brightweblabs/ui

ComponentPackagePathTier (primitive / pattern / surface)Used by (packages)MQ origin (file)Notes
Button, buttonVariants@brightweblabs/uipackages/ui/src/components/button.tsxprimitiveapp-shell, module-admin, module-crm, module-projects, platform-preview—Canonical button element and variants.
Checkbox@brightweblabs/uipackages/ui/src/components/checkbox.tsxprimitivemodule-admin, module-crm, module-projects—Native-input wrapper; deliberately emits the same input markup as the controls normalized in Brief 27.
Input@brightweblabs/uipackages/ui/src/components/input.tsxprimitivemodule-projects—Styled text input. Literal preview playground fields remain app-owned because their classes differ.
Label@brightweblabs/uipackages/ui/src/components/label.tsxprimitivemodule-projects—Radix-backed form label.
Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSet@brightweblabs/uipackages/ui/src/components/field.tsxpatterncore-auth, module-projects—Form layout family. Associate FieldLabel with its control by pairing htmlFor and id; associate supporting or error copy with aria-describedby, and expose invalid state with aria-invalid.
PasswordInput@brightweblabs/uipackages/ui/src/components/password-input.tsxpatterndownstream apps—Input with visibility control.
PasswordStrength@brightweblabs/uipackages/ui/src/components/password-strength.tsxpatterndownstream apps—Password-policy feedback.
PhoneInput@brightweblabs/uipackages/ui/src/components/phone-input.tsxpatternmodule-crm, module-projects—International phone control.
SearchField@brightweblabs/uipackages/ui/src/components/search-field.tsxpatternmodule-crm, module-projects—Search input with clear action. Toolbar search chips keep their literal MQ pill composition because markup and dimensions differ.
Badge, badgeVariants@brightweblabs/uipackages/ui/src/components/badge.tsxprimitivemodule-admin, module-crm—Generic badge.
StatusPill@brightweblabs/uipackages/ui/src/components/status-pill.tsxpatternmodule-crm, platform-preview—Token-driven status pill. Projects state, task, and visibility pills retain literal MQ markup where their size/tone recipes differ.
RoleBadge@brightweblabs/uipackages/ui/src/components/role-badge.tsxpatterndownstream apps—Generic role label and token resolver. Projects MemberRoleBadge retains MQ-specific role-color behavior.
Avatar, AvatarImage, AvatarFallback, AvatarBadge, AvatarGroup, AvatarGroupCount@brightweblabs/uipackages/ui/src/components/avatar.tsxprimitiveUI patterns, downstream apps—Radix avatar family.
InitialsAvatar@brightweblabs/uipackages/ui/src/components/initials-avatar.tsxpatterndownstream apps—General initials avatar. Shell account avatars and Projects ProjectOwnerAvatar retain literal class and fallback behavior.
CoverHeader@brightweblabs/uipackages/ui/src/components/cover-header.tsxpatterncore-auth, module-projects, downstream apps—Shared light cover-header composition with optional artwork and a content container; used by client account and project identity surfaces.
Separator@brightweblabs/uipackages/ui/src/components/separator.tsxprimitiveapp-shell, downstream apps—Radix separator.
Tooltip, TooltipContent, TooltipProvider, TooltipTrigger@brightweblabs/uipackages/ui/src/components/tooltip.tsxprimitiveapp-shell, module-projectscomponents/ui/tooltip.tsxCanonical tooltip family used by translated MQ surfaces.
Popover, PopoverTrigger, PopoverContent, PopoverAnchor@brightweblabs/uipackages/ui/src/components/popover.tsxprimitivemodule-crm, module-projects—Radix popover family.
DropdownMenu family@brightweblabs/uipackages/ui/src/components/dropdown-menu.tsxprimitiveapp-shell, module-admin, module-crm, module-projects—Includes portal, trigger, content, group, label, item, checkbox/radio items, separator, shortcut, and sub-menu exports.
Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription@brightweblabs/uipackages/ui/src/components/sheet.tsxprimitiveapp-shell, module-crm, module-projectscomponents/ui/sheet.tsxRadix dialog-backed sheet family.
AlertDialog family@brightweblabs/uipackages/ui/src/components/alert-dialog.tsxprimitivemodule-admin, module-crm, module-projectscomponents/ui/alert-dialog.tsxRoot, trigger, portal, overlay, content, header, footer, title, description, action, and cancel.
Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption@brightweblabs/uipackages/ui/src/components/table.tsxprimitivemodule-admin, module-crm—Canonical semantic table family. Dashboard and Projects board/task layouts keep MQ’s non-table grid/list markup.
Pagination family@brightweblabs/uipackages/ui/src/components/pagination.tsxprimitivedownstream apps—Root, content, item, link, previous, next, and ellipsis exports.
TablePagination@brightweblabs/uipackages/ui/src/components/table-pagination.tsxpatternmodule-crm, module-projects—Shared page window and navigation; Projects wraps it only to bind dictionary text and controller state.
Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent@brightweblabs/uipackages/ui/src/components/card.tsxprimitivedownstream apps—Generic card family. MQ surfaces may keep literal surface recipes when padding or border markup differs.
SurfaceCard@brightweblabs/uipackages/ui/src/components/surface-card.tsxpatternmodule-crm, platform-preview—Canonical BrightWeb surface. Projects ProjectSurfaceCard retains MQ-specific classes and section slots.
SectionHeading@brightweblabs/uipackages/ui/src/components/section-heading.tsxpatternmodule-crm, platform-preview—General icon/title/subtitle/action heading. Dashboard and Projects section headings preserve their distinct MQ markup.
StatTile, StatValue@brightweblabs/uipackages/ui/src/components/stat-tile.tsxpatternplatform-preview—General metric tile. Projects overview stats preserve a denser literal MQ composition.
KpiBreakdownBar@brightweblabs/uipackages/ui/src/components/kpi-breakdown-bar.tsxpatternmodule-crm—Shared token-driven breakdown. AppDashboard’s local bar is retained because MQ’s DOM, animation, and labels differ.
EmptyState@brightweblabs/uipackages/ui/src/components/empty-state.tsxpatternmodule-crm—General icon/title/hint/action empty state. Alerts, dashboard, and Projects keep compact or in-card literal empty states with different markup.
ActionButton, actionClassName@brightweblabs/uipackages/ui/src/components/action.tsxpatterndownstream appscomponents/app/portal-action.tsxGeneral action treatment; dashboard owns its exact portal action link.
ActivityMessage@brightweblabs/uipackages/ui/src/components/activity-message.tsxpatternmodule-crm, module-projects—Renders structured activity message segments.
Skeleton, SkeletonLine, SkeletonText, SkeletonCard, SkeletonCircle@brightweblabs/uipackages/ui/src/components/skeleton.tsxprimitiveapp-shell, module-crm, module-projectscomponents/ui/skeleton.tsxShared loading primitives.
TableRowsSkeleton@brightweblabs/uipackages/ui/src/components/skeleton-table.tsxpatternmodule-crm—Table-shaped loading rows.
Calendar, CalendarDayButton@brightweblabs/uipackages/ui/src/components/calendar.tsxprimitivemodule-projects—React DayPicker calendar.
ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle@brightweblabs/uipackages/ui/src/components/chart.tsxpatterndownstream apps—Recharts context and presentation family.
Breadcrumb family@brightweblabs/uipackages/ui/src/components/breadcrumb.tsxprimitivedownstream apps—Root, list, item, link, page, separator, and ellipsis exports.
Toaster@brightweblabs/uipackages/ui/src/components/sonner.tsxsurfaceplatform-preview, downstream apps—Theme-aware Sonner host.

@brightweblabs/app-shell

ComponentPackagePathTier (primitive / pattern / surface)Used by (packages)MQ origin (file)Notes
AppShellFrame@brightweblabs/app-shellpackages/app-shell/src/components/app-shell-frame.tsxsurfaceplatform-preview—Canonical shell frame for desktop sidebar, header, mobile nav, and content.
DesktopSidebar@brightweblabs/app-shellpackages/app-shell/src/components/desktop-sidebar.tsxsurfaceplatform-preview—Desktop navigation and account surface.
MobileNav@brightweblabs/app-shellpackages/app-shell/src/components/mobile-nav.tsxsurfaceplatform-preview—Mobile primary/tools/module navigation.
AppHeader@brightweblabs/app-shellpackages/app-shell/src/components/app-header.tsxsurfaceplatform-preview—Breadcrumb/title/contextual-toolbar/utility header.
AlertsMenu@brightweblabs/app-shellpackages/app-shell/src/components/alerts-menu.tsxsurfaceAppHeader, platform-preview—Notification popover. Its compact empty state intentionally differs from EmptyState.
AccountMenu@brightweblabs/app-shellpackages/app-shell/src/components/account-menu.tsxsurfaceDesktopSidebar—Account, role, theme, and sign-out popover. Literal account avatar markup is retained.
ThemeMenu@brightweblabs/app-shellpackages/app-shell/src/components/theme-menu.tsxpatternAccountMenu—Theme selection menu.
ThemeProvider, ThemeScript, useTheme@brightweblabs/app-shellpackages/app-shell/src/themesurfaceplatform-preview, downstream apps—Persistent light/dark/system controller, pre-hydration document script, root synchronization, and consumer hook.
useShellNavState, createShellNavState, shellNavStateReducer@brightweblabs/app-shellpackages/app-shell/src/use-shell-nav-state.tspatternAppShellFrame, downstream shells—Registration-keyed navigation state with pathname-aware groups and collapse resets.
SidebarNavLink, SidebarSectionToggle, SidebarSubNavLink@brightweblabs/app-shellpackages/app-shell/src/components/nav-primitives.tsxpatternDesktopSidebar—Internal sidebar navigation patterns.
MobileNavPill, MobileTogglePill@brightweblabs/app-shellpackages/app-shell/src/components/nav-primitives.tsxpatternMobileNav—Internal mobile navigation pills; not status pills.
ToolbarNewMenu, ToolbarFilterToggle, ToolbarFiltersPill, ToolbarDropdownChip, ToolbarSearchRefreshPill@brightweblabs/app-shellpackages/app-shell/src/components/toolbar-shared.tsxpatternmodule-crm, module-projects, platform-preview—Canonical shell toolbar compositions. Module filter contents remain literal within the shared containers.
AppSheetHeader, AppSheetBody, AppSheetFooter, SheetSection@brightweblabs/app-shellpackages/app-shell/src/components/app-sheet.tsxpatternmodule-crm, module-projectscomponents/app/app-sheet.tsx, components/app/sheet-section.tsShared application-sheet structure and class recipes.
DashboardActionLink@brightweblabs/app-shellpackages/app-shell/src/dashboard/primitives.tsxpatternAppDashboardcomponents/app/portal-action.tsxDashboard’s literal link treatment differs from UI ActionButton.
DashboardSectionHeading@brightweblabs/app-shellpackages/app-shell/src/dashboard/primitives.tsxpatternAppDashboardcomponents/app/portal-section-heading.tsxDashboard’s exact MQ heading composition.
AppDashboard, DashboardClient@brightweblabs/app-shellpackages/app-shell/src/dashboard/dashboard-client.tsxsurfaceplatform-preview; module contributions from module-crm and module-projectsapp/(app)/dashboard/dashboard-client.tsxAliases for the aggregate dashboard surface. Local KPI bars, tags, contact avatars, empty states, and task grids remain literal for parity.
DashboardLoading@brightweblabs/app-shellpackages/app-shell/src/dashboard/dashboard-loading.tsxsurfaceplatform-previewapp/(app)/dashboard/loading.tsxDashboard route fallback.
NotFoundPage, createAppShellStatusPages@brightweblabs/app-shellpackages/app-shell/src/status-pages/surfaceplatform-preview, downstream appsapp/not-found.tsxStandalone tokenized 404 frame with dictionary copy and configurable back action. createAppShellStatusPages({ brand }) binds shared shell branding; ShellBrand.statusPageLogo can supply separate light/dark assets and falls back to collapsedLogo. An explicit brandLogo prop still overrides configured branding.
ErrorPage@brightweblabs/app-shellpackages/app-shell/src/status-pages/error-page.tsxsurfaceplatform-preview, downstream appsapp/(app)/error.tsxClient error-boundary surface retaining reset/retry behavior and a configurable home action.

@brightweblabs/core-auth surfaces

ComponentPackagePathTier (primitive / pattern / surface)Used by (packages)MQ origin (file)Notes
AuthLayout, AuthCard, AuthHeading, AuthNotice@brightweblabs/core-auth/uipackages/core-auth/src/ui/auth-layout.tsxpatterncore-auth screensMQ auth layout and global auth rulesShared branded frame, vessel, heading, and feedback compositions.
AuthUiProvider, useAuthUi, createAuthUiClient@brightweblabs/core-auth/uipackages/core-auth/src/ui/context.tsx, packages/core-auth/src/ui/client.tspatternplatform-preview, downstream auth routes—Injectable dictionary, route, and browser-client boundary; UI components do not import Supabase.
LoginPage, ForgotPasswordPage, ResetPasswordPage, SignupPage@brightweblabs/core-auth/uipackages/core-auth/src/ui/*-page.tsxsurfaceplatform-preview, downstream appsMatching MQ auth routesPackaged credential and recovery surfaces with invite-only signup as the default policy.
InvitePage, ConfirmedPage, PostLoginPage@brightweblabs/core-auth/uipackages/core-auth/src/ui/invite-page.tsx, confirmed-page.tsx, post-login-page.tsxsurfaceplatform-preview, downstream appsMatching MQ auth routesOrganization/admin invitation, confirmation, and guarded post-login routing surfaces. The injected client now covers invitation details, registration, signed-in acceptance, and the post-login invitation handoff.

Module UI surfaces and shared patterns

The package column names an importable public barrel only for supported exports. Rows marked internal to @brightweblabs/module-projects document package-owned implementation details; they are deliberately absent from @brightweblabs/module-projects/ui so their internal props do not become public API.

ComponentPackagePathTier (primitive / pattern / surface)Used by (packages)MQ origin (file)Notes
AdminUsersClient, AdminUsersLoading, AdminToolbarControls, AdminRolePill@brightweblabs/module-admin/uipackages/module-admin/src/ui/surfaceplatform-previewMQ admin users route and componentsInjectable users/roles/invitations surface with packaged loading and shell toolbar controls. Invitation data is backed by the packaged list/create/revoke lifecycle and admin registration handlers.
CrmDashboard@brightweblabs/module-crm/uipackages/module-crm/src/ui/dashboard.tsxsurfaceplatform-preview— (pre-ledger CRM port)CRM aggregate surface.
CrmContactsTable@brightweblabs/module-crm/uipackages/module-crm/src/ui/contacts-table.tsxsurfacemodule-crm— (pre-ledger CRM port)Uses shared Table, Checkbox, StatusPill, and TablePagination. Its icon-led no-data table cell differs from general EmptyState.
CrmDashboardSidebar@brightweblabs/module-crm/uipackages/module-crm/src/ui/dashboard-sidebar.tsxsurfacemodule-crm— (pre-ledger CRM port)CRM timeline/organization sidebar cards.
CrmActivityCard@brightweblabs/module-crm/uipackages/module-crm/src/ui/activity-card.tsxpatternmodule-crm, app-shell dashboard contribution— (pre-ledger CRM port)CRM activity row/card.
CrmFunnelStats@brightweblabs/module-crm/uipackages/module-crm/src/ui/funnel-stats.tsxpatternmodule-crm, app-shell dashboard contribution— (pre-ledger CRM port)Funnel metric pattern using shared KPI breakdown.
CrmTimeline, CrmTimelineBrowser@brightweblabs/module-crm/uipackages/module-crm/src/ui/timeline.tsx, packages/module-crm/src/ui/timeline-browser.tsxsurfacemodule-crm— (pre-ledger CRM port)Embedded timeline plus searchable sheet browser.
CrmOrganizationsBrowser, CrmOrganizationSheet@brightweblabs/module-crm/uipackages/module-crm/src/ui/organizations-browser.tsx, packages/module-crm/src/ui/organization-sheet.tsxsurfacemodule-crm— (pre-ledger CRM port)Organization browser and edit sheet. Create and edit submissions persist through the packaged @brightweblabs/module-orgs POST/PATCH handlers rather than preview-local state.
OrganizationCreateSheet@brightweblabs/module-orgs/uipackages/module-orgs/src/ui/organization-create-sheet.tsxsurfacemodule-crm, module-projects, downstream apps—Shared organization-creation sheet with optional invitations, semantic selectors, validation, and dirty-draft discard confirmation.
CrmContactDialog, CrmStatusDialog, CrmDeleteDialog@brightweblabs/module-crm/uipackages/module-crm/src/ui/contact-dialog.tsx, packages/module-crm/src/ui/status-dialog.tsx, packages/module-crm/src/ui/delete-dialog.tsxsurfacemodule-crm— (pre-ledger CRM port)CRM mutation dialogs. Stage selectors retain literal interactive pill markup.
CrmReport, CrmReportPage, CrmReportBanner@brightweblabs/module-crm/uipackages/module-crm/src/ui/report.tsx, packages/module-crm/src/ui/report-banner.tsxsurfaceplatform-preview, module-crm— (pre-ledger CRM port)Report page and dashboard banner.
CrmToolbarSearchChip, CrmToolbarFiltersPill, CrmToolbarCreateMenu, CrmToolbarControls@brightweblabs/module-crm/uipackages/module-crm/src/ui/toolbar-controls.tsxpatternplatform-preview, module-crm— (pre-ledger CRM port)Binds CRM state and dictionary to app-shell toolbar patterns.
ProjectsPage, ProjectsPortfolioRoot@brightweblabs/module-projects/uipackages/module-projects/src/ui/projects-page.tsx, packages/module-projects/src/ui/projects-portfolio/projects-portfolio-root.tsxsurfaceplatform-previewprojetos/page.tsx, projetos/_components/projects-portfolio/projects-portfolio-root.tsxProjects portfolio route and client root.
ProjectsPortfolioList, ProjectsPortfolioStats, ProjectsPortfolioPagination, ProjectsPortfolioModals@brightweblabs/module-projects/uipackages/module-projects/src/ui/projects-portfolio/patternmodule-projectsprojetos/_components/projects-portfolio/*Portfolio sub-surfaces. Pagination wraps shared TablePagination without changing its markup.
ProjectDetailPage, ProjectDetailDataProvider@brightweblabs/module-projects/uipackages/module-projects/src/ui/project-detail-page.tsx, packages/module-projects/src/ui/project-detail-data-provider.tsxsurfaceplatform-previewprojetos/[projectId]/page.tsx, projetos/[projectId]/_components/project-detail-data-provider.tsxProject detail composition and data context.
ProjectDetailHero, ProjectDetailMetadataStrip, ProjectDetailTeamCardinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-detail-hero.tsx, packages/module-projects/src/ui/project-detail-metadata-strip.tsx, packages/module-projects/src/ui/project-detail-team-card.tsxsurfacemodule-projectsMatching files under projetos/[projectId]/_components/Literal MQ detail sections composed by the public ProjectDetailPage; internal prop contracts are not supported API.
ProjectMilestonesAndTasksCards, ProjectMilestonesAndTasksListsinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-detail-editable-cards.tsx, packages/module-projects/src/ui/project-milestone-task-lists.tsxsurfacemodule-projectsMatching files under projetos/[projectId]/_components/Internal detail-page compositions. Their compact section-empty markup differs from UI EmptyState.
ProjectActivityCard@brightweblabs/module-projects/uipackages/module-projects/src/ui/project-activity-card.tsxpatternmodule-projectsprojetos/[projectId]/_components/project-activity-card.tsxSupported activity-card surface.
ProjectRecentActivity, ActivityChangeRowsinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-recent-activity.tsx, packages/module-projects/src/ui/shared/activity-change-rows.tsxpatternmodule-projectsMQ activity compositionImplementation details of ProjectActivityCard; not exported.
ProjectLinksCardinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-links-card.tsxsurfacemodule-projectsprojetos/[projectId]/_components/project-links-card.tsxInternal detail-page section. Link visibility pills and its empty state remain literal because shared patterns do not emit the same structure.
ProjectBoardKanban, ProjectBoardLoading, ProjectBoardToolbarControls@brightweblabs/module-projects/uipackages/module-projects/src/ui/project-board-kanban.tsx, packages/module-projects/src/ui/project-board-loading.tsx, packages/module-projects/src/ui/project-board-toolbar-controls.tsxsurfaceplatform-previewprojetos/[projectId]/quadro/*Literal board surface and toolbar binding.
ProjectTasksPage, ProjectBoardPage@brightweblabs/module-projects/uipackages/module-projects/src/ui/project-tasks-page.tsxsurfaceplatform-previewprojetos/[projectId]/tarefas/page.tsx, projetos/[projectId]/quadro/page.tsxPublic aliases sharing one task/board route composition.
CreateProjectSheet, CreateProjectTaskSheetinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/create-project-sheet.tsx, packages/module-projects/src/ui/create-project-task-sheet.tsxsurfacemodule-projectsprojetos/_components/create-project-sheet.tsx, projetos/_components/create-project-task-sheet.tsxMounted through the public portfolio surface; their form props are not supported API.
ProjectEditSheet, ProjectMembersEditSheet, ProjectStatusQuickActioninternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-edit-sheet.tsx, packages/module-projects/src/ui/project-members-edit-sheet.tsx, packages/module-projects/src/ui/project-status-quick-action.tsxsurfacemodule-projectsMatching files under projetos/[projectId]/_components/Internal edit/membership/status surfaces. Confirmation-button styling stays literal.
ProjectMilestoneCreateSheet, ProjectTaskCreateSheet, ProjectLinkCreateSheet, ProjectDetailCreateSheetsMountinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-detail-create-sheets/surfacemodule-projectsMatching directory under projetos/[projectId]/_components/Lazily mounted implementation details of public detail/task surfaces.
ProjectStateBadge, ProjectStatusBadge, ProjectHealthBadge@brightweblabs/module-projects/uipackages/module-projects/src/ui/project-state-badge.tsxpatternmodule-projectsprojetos/_components/project-state-badge.tsxMQ-specific hero/default surfaces use tintPill; not interchangeable with generic StatusPill.
ProjectPill, ProjectDotPillinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/project-pill.tsxpatternmodule-projectscomponents/projects/project-pill.tsxBase Projects pill geometry; internal styling contract.
ProjectOwnerAvatarinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/project-owner-avatar.tsxpatternmodule-projectscomponents/projects/project-owner-avatar.tsxRole-colored literal avatar used inside public compositions; not exported independently.
MemberRoleBadgeinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/member-role-badge.tsxpatternmodule-projectscomponents/projects/member-role-badge.tsxInternal Projects role palette and labels.
ProjectProgressBarinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/project-progress.tsxpatternmodule-projectscomponents/projects/project-progress.tsxInternal project progress recipe.
ProjectSummaryCard, ProjectSummaryCardSkeleton@brightweblabs/module-projects/uipackages/module-projects/src/ui/shared/project-summary-card.tsx, packages/module-projects/src/ui/shared/project-summary-card-skeleton.tsxpatternmodule-projects, app-shellcomponents/projects/project-summary-card.tsx, components/projects/project-summary-card-skeleton.tsxInjected into AppDashboard through module registration.
ProjectSurfaceCard, ProjectSurfaceSectionHeaderinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/project-surface-card.tsxpatternmodule-projectscomponents/projects/project-surface-card.tsxInternal Projects surface composition; differs from UI SurfaceCard and SectionHeading.
TaskPriorityTag, TaskStatusTag, TaskDueMeta@brightweblabs/module-projects/uipackages/module-projects/src/ui/shared/task-tags.tsxpatternmodule-projects, app-shellcomponents/projects/task-tags.tsxSupported task-specific tags/meta used by downstream dashboard contributions.
TaskTag, TaskMilestoneMeta, TaskAssigneeMetainternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/task-tags.tsxpatternmodule-projectscomponents/projects/task-tags.tsxInternal building blocks; their props are not frozen as public API.
SectionEmptyState, SectionLoadingStateinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/section-feedback.tsxpatternmodule-projectscomponents/projects/section-feedback.tsxInternal compact section feedback, intentionally distinct from UI EmptyState.
SectionIconButton, SectionAddButtoninternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/section-icon-button.tsxpatternmodule-projectscomponents/projects/section-icon-button.tsxInternal Projects section actions.
ContactActionButtonsinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/shared/contact-action-buttons.tsxpatternmodule-projectscomponents/projects/contact-action-buttons.tsxInternal email/phone action pair.
FormSection, SelectField, DateFieldinternal to @brightweblabs/module-projectspackages/module-projects/src/ui/project-create/shared-fields.tsxpatternmodule-projectsprojetos/_components/project-create/shared-fields.tsxInternal project-creation fields.
ProjectsToolbarControls@brightweblabs/module-projects/uipackages/module-projects/src/ui/toolbar-controls.tsxpatternplatform-previewMQ Projects toolbar compositionBinds Projects filters and creation actions to app-shell toolbar containers.

Brief 27 changelog

REMOVED

ItemFormer locationReason
ProjectActivityCardLoaderpackages/module-projects/src/ui/project-activity-card-loader.tsx:1Orphaned translated wrapper; no import, public export, route, test, contract, or documentation consumer beyond the stale translation ledger.
ProjectDetailStatsStrippackages/module-projects/src/ui/project-detail-stats-strip.tsx:1Orphaned alternate detail strip; the live detail composition uses the editable cards and metadata strip.
Legacy Projects playground pageapps/platform-preview/app/playground/projects/page.tsx:1Superseded by the packaged /projects, detail, board, and task previews; it was no longer linked by preview module configuration.
--project-ui-color-65packages/module-projects/tokens.css:69Definition-only token with no static or computed consumer.
--project-ui-color-66packages/module-projects/tokens.css:70Definition-only token with no static or computed consumer.
--project-ui-color-81packages/module-projects/tokens.css:85Definition-only token with no static or computed consumer.
--project-ui-color-82packages/module-projects/tokens.css:86Definition-only token with no static or computed consumer.
.project-chip-codepackages/module-projects/tokens.css:159Unused class; no component or app applied it.
.project-group-titlepackages/module-projects/tokens.css:283Unused class; no component or app applied it.

The stale member-initials-avatar.tsx entry in docs/internal/brief-23-translation-table.md:62 was corrected to the live ProjectOwnerAvatar normalization. The two removed component rows in that ledger now record their Brief 27 disposition.

NORMALIZED

ReplacementLocationParity statement
Raw admin select-all checkbox → UI Checkboxpackages/module-admin/src/users-client.tsx:353Same native input, props, classes, and event handler.
Raw admin row checkbox → UI Checkboxpackages/module-admin/src/users-client.tsx:384Same native input, props, classes, and event handler.
Raw CRM select-all checkbox → UI Checkboxpackages/module-crm/src/ui/contacts-table.tsx:182Same native input, props, classes, and event handler.
Raw CRM row checkbox → UI Checkboxpackages/module-crm/src/ui/contacts-table.tsx:206Same native input, props, classes, and event handler.
Raw Projects member checkbox → UI Checkboxpackages/module-projects/src/ui/create-project-sheet.tsx:813Same native input, id, props, classes, and event handler.

tests/ui-hygiene.test.ts enforces that package and preview source cannot introduce another raw <input type="checkbox"> outside the UI primitive.

Accessibility contract

  • Every visible form label must have a stable accessible-name association. With the shared Field family, pair FieldLabel htmlFor with the control id; use aria-describedby for descriptions or errors and aria-invalid for validation state.
  • Motion-heavy transitions, skeleton shimmer, and package-specific entrance animations honor prefers-reduced-motion: reduce. The base theme collapses animation and transition timing, while package recipes provide static fallbacks where simply shortening timing would hide content.
  • Secondary copy that must meet text contrast requirements uses text-foreground-muted-accessible, backed by --foreground-muted-accessible in neutral, dark, and MQ themes. Decorative or nonessential muted treatments may continue to use text-muted-foreground.
  • Phone input country selection remains keyboard-operable through its native buttons and listbox semantics, including focus restoration after selection.

Non-visual module integration added in this release

The invitation and organization-save work has a visual entry point in the surfaces above, but its persistence contract is package-owned:

  • @brightweblabs/core-auth exports invitation detail, registration, and acceptance handler factories.
  • @brightweblabs/module-admin exports the admin invitation list/create/revoke/register lifecycle and matching route handlers.
  • @brightweblabs/module-orgs exports organization create/update functions and POST/PATCH handlers, plus the organization invitation list/create/revoke/register/accept lifecycle.

Known implementation TODOs

  • apps/platform-preview/app/(shell)/projects/page.tsx — TODO(projects-live) tracks replacing the deterministic Projects preview data with live /api/projects, /stats, /organizations, /clients, and /contacts endpoints. It remains intentionally unresolved because wiring live data would change preview behavior.
  • packages/core-auth/src/ui/signup-page.tsx — TODO(core-auth) tracks open registration after its profile and role policy is defined. Invite-only signup remains the explicit current product policy, so cleanup does not remove or implement this marker.

No other TODO or FIXME markers remain under apps/platform-preview, packages, or docs.