BrightWeb UI component inventory
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
| Component | Package | Path | Tier (primitive / pattern / surface) | Used by (packages) | MQ origin (file) | Notes |
|---|---|---|---|---|---|---|
Button, buttonVariants | @brightweblabs/ui | packages/ui/src/components/button.tsx | primitive | app-shell, module-admin, module-crm, module-projects, platform-preview | — | Canonical button element and variants. |
Checkbox | @brightweblabs/ui | packages/ui/src/components/checkbox.tsx | primitive | module-admin, module-crm, module-projects | — | Native-input wrapper; deliberately emits the same input markup as the controls normalized in Brief 27. |
Input | @brightweblabs/ui | packages/ui/src/components/input.tsx | primitive | module-projects | — | Styled text input. Literal preview playground fields remain app-owned because their classes differ. |
Label | @brightweblabs/ui | packages/ui/src/components/label.tsx | primitive | module-projects | — | Radix-backed form label. |
Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSet | @brightweblabs/ui | packages/ui/src/components/field.tsx | pattern | core-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/ui | packages/ui/src/components/password-input.tsx | pattern | downstream apps | — | Input with visibility control. |
PasswordStrength | @brightweblabs/ui | packages/ui/src/components/password-strength.tsx | pattern | downstream apps | — | Password-policy feedback. |
PhoneInput | @brightweblabs/ui | packages/ui/src/components/phone-input.tsx | pattern | module-crm, module-projects | — | International phone control. |
SearchField | @brightweblabs/ui | packages/ui/src/components/search-field.tsx | pattern | module-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/ui | packages/ui/src/components/badge.tsx | primitive | module-admin, module-crm | — | Generic badge. |
StatusPill | @brightweblabs/ui | packages/ui/src/components/status-pill.tsx | pattern | module-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/ui | packages/ui/src/components/role-badge.tsx | pattern | downstream apps | — | Generic role label and token resolver. Projects MemberRoleBadge retains MQ-specific role-color behavior. |
Avatar, AvatarImage, AvatarFallback, AvatarBadge, AvatarGroup, AvatarGroupCount | @brightweblabs/ui | packages/ui/src/components/avatar.tsx | primitive | UI patterns, downstream apps | — | Radix avatar family. |
InitialsAvatar | @brightweblabs/ui | packages/ui/src/components/initials-avatar.tsx | pattern | downstream apps | — | General initials avatar. Shell account avatars and Projects ProjectOwnerAvatar retain literal class and fallback behavior. |
CoverHeader | @brightweblabs/ui | packages/ui/src/components/cover-header.tsx | pattern | core-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/ui | packages/ui/src/components/separator.tsx | primitive | app-shell, downstream apps | — | Radix separator. |
Tooltip, TooltipContent, TooltipProvider, TooltipTrigger | @brightweblabs/ui | packages/ui/src/components/tooltip.tsx | primitive | app-shell, module-projects | components/ui/tooltip.tsx | Canonical tooltip family used by translated MQ surfaces. |
Popover, PopoverTrigger, PopoverContent, PopoverAnchor | @brightweblabs/ui | packages/ui/src/components/popover.tsx | primitive | module-crm, module-projects | — | Radix popover family. |
DropdownMenu family | @brightweblabs/ui | packages/ui/src/components/dropdown-menu.tsx | primitive | app-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/ui | packages/ui/src/components/sheet.tsx | primitive | app-shell, module-crm, module-projects | components/ui/sheet.tsx | Radix dialog-backed sheet family. |
AlertDialog family | @brightweblabs/ui | packages/ui/src/components/alert-dialog.tsx | primitive | module-admin, module-crm, module-projects | components/ui/alert-dialog.tsx | Root, trigger, portal, overlay, content, header, footer, title, description, action, and cancel. |
Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption | @brightweblabs/ui | packages/ui/src/components/table.tsx | primitive | module-admin, module-crm | — | Canonical semantic table family. Dashboard and Projects board/task layouts keep MQ’s non-table grid/list markup. |
Pagination family | @brightweblabs/ui | packages/ui/src/components/pagination.tsx | primitive | downstream apps | — | Root, content, item, link, previous, next, and ellipsis exports. |
TablePagination | @brightweblabs/ui | packages/ui/src/components/table-pagination.tsx | pattern | module-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/ui | packages/ui/src/components/card.tsx | primitive | downstream apps | — | Generic card family. MQ surfaces may keep literal surface recipes when padding or border markup differs. |
SurfaceCard | @brightweblabs/ui | packages/ui/src/components/surface-card.tsx | pattern | module-crm, platform-preview | — | Canonical BrightWeb surface. Projects ProjectSurfaceCard retains MQ-specific classes and section slots. |
SectionHeading | @brightweblabs/ui | packages/ui/src/components/section-heading.tsx | pattern | module-crm, platform-preview | — | General icon/title/subtitle/action heading. Dashboard and Projects section headings preserve their distinct MQ markup. |
StatTile, StatValue | @brightweblabs/ui | packages/ui/src/components/stat-tile.tsx | pattern | platform-preview | — | General metric tile. Projects overview stats preserve a denser literal MQ composition. |
KpiBreakdownBar | @brightweblabs/ui | packages/ui/src/components/kpi-breakdown-bar.tsx | pattern | module-crm | — | Shared token-driven breakdown. AppDashboard’s local bar is retained because MQ’s DOM, animation, and labels differ. |
EmptyState | @brightweblabs/ui | packages/ui/src/components/empty-state.tsx | pattern | module-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/ui | packages/ui/src/components/action.tsx | pattern | downstream apps | components/app/portal-action.tsx | General action treatment; dashboard owns its exact portal action link. |
ActivityMessage | @brightweblabs/ui | packages/ui/src/components/activity-message.tsx | pattern | module-crm, module-projects | — | Renders structured activity message segments. |
Skeleton, SkeletonLine, SkeletonText, SkeletonCard, SkeletonCircle | @brightweblabs/ui | packages/ui/src/components/skeleton.tsx | primitive | app-shell, module-crm, module-projects | components/ui/skeleton.tsx | Shared loading primitives. |
TableRowsSkeleton | @brightweblabs/ui | packages/ui/src/components/skeleton-table.tsx | pattern | module-crm | — | Table-shaped loading rows. |
Calendar, CalendarDayButton | @brightweblabs/ui | packages/ui/src/components/calendar.tsx | primitive | module-projects | — | React DayPicker calendar. |
ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle | @brightweblabs/ui | packages/ui/src/components/chart.tsx | pattern | downstream apps | — | Recharts context and presentation family. |
Breadcrumb family | @brightweblabs/ui | packages/ui/src/components/breadcrumb.tsx | primitive | downstream apps | — | Root, list, item, link, page, separator, and ellipsis exports. |
Toaster | @brightweblabs/ui | packages/ui/src/components/sonner.tsx | surface | platform-preview, downstream apps | — | Theme-aware Sonner host. |
@brightweblabs/app-shell
| Component | Package | Path | Tier (primitive / pattern / surface) | Used by (packages) | MQ origin (file) | Notes |
|---|---|---|---|---|---|---|
AppShellFrame | @brightweblabs/app-shell | packages/app-shell/src/components/app-shell-frame.tsx | surface | platform-preview | — | Canonical shell frame for desktop sidebar, header, mobile nav, and content. |
DesktopSidebar | @brightweblabs/app-shell | packages/app-shell/src/components/desktop-sidebar.tsx | surface | platform-preview | — | Desktop navigation and account surface. |
MobileNav | @brightweblabs/app-shell | packages/app-shell/src/components/mobile-nav.tsx | surface | platform-preview | — | Mobile primary/tools/module navigation. |
AppHeader | @brightweblabs/app-shell | packages/app-shell/src/components/app-header.tsx | surface | platform-preview | — | Breadcrumb/title/contextual-toolbar/utility header. |
AlertsMenu | @brightweblabs/app-shell | packages/app-shell/src/components/alerts-menu.tsx | surface | AppHeader, platform-preview | — | Notification popover. Its compact empty state intentionally differs from EmptyState. |
AccountMenu | @brightweblabs/app-shell | packages/app-shell/src/components/account-menu.tsx | surface | DesktopSidebar | — | Account, role, theme, and sign-out popover. Literal account avatar markup is retained. |
ThemeMenu | @brightweblabs/app-shell | packages/app-shell/src/components/theme-menu.tsx | pattern | AccountMenu | — | Theme selection menu. |
ThemeProvider, ThemeScript, useTheme | @brightweblabs/app-shell | packages/app-shell/src/theme | surface | platform-preview, downstream apps | — | Persistent light/dark/system controller, pre-hydration document script, root synchronization, and consumer hook. |
useShellNavState, createShellNavState, shellNavStateReducer | @brightweblabs/app-shell | packages/app-shell/src/use-shell-nav-state.ts | pattern | AppShellFrame, downstream shells | — | Registration-keyed navigation state with pathname-aware groups and collapse resets. |
SidebarNavLink, SidebarSectionToggle, SidebarSubNavLink | @brightweblabs/app-shell | packages/app-shell/src/components/nav-primitives.tsx | pattern | DesktopSidebar | — | Internal sidebar navigation patterns. |
MobileNavPill, MobileTogglePill | @brightweblabs/app-shell | packages/app-shell/src/components/nav-primitives.tsx | pattern | MobileNav | — | Internal mobile navigation pills; not status pills. |
ToolbarNewMenu, ToolbarFilterToggle, ToolbarFiltersPill, ToolbarDropdownChip, ToolbarSearchRefreshPill | @brightweblabs/app-shell | packages/app-shell/src/components/toolbar-shared.tsx | pattern | module-crm, module-projects, platform-preview | — | Canonical shell toolbar compositions. Module filter contents remain literal within the shared containers. |
AppSheetHeader, AppSheetBody, AppSheetFooter, SheetSection | @brightweblabs/app-shell | packages/app-shell/src/components/app-sheet.tsx | pattern | module-crm, module-projects | components/app/app-sheet.tsx, components/app/sheet-section.ts | Shared application-sheet structure and class recipes. |
DashboardActionLink | @brightweblabs/app-shell | packages/app-shell/src/dashboard/primitives.tsx | pattern | AppDashboard | components/app/portal-action.tsx | Dashboard’s literal link treatment differs from UI ActionButton. |
DashboardSectionHeading | @brightweblabs/app-shell | packages/app-shell/src/dashboard/primitives.tsx | pattern | AppDashboard | components/app/portal-section-heading.tsx | Dashboard’s exact MQ heading composition. |
AppDashboard, DashboardClient | @brightweblabs/app-shell | packages/app-shell/src/dashboard/dashboard-client.tsx | surface | platform-preview; module contributions from module-crm and module-projects | app/(app)/dashboard/dashboard-client.tsx | Aliases for the aggregate dashboard surface. Local KPI bars, tags, contact avatars, empty states, and task grids remain literal for parity. |
DashboardLoading | @brightweblabs/app-shell | packages/app-shell/src/dashboard/dashboard-loading.tsx | surface | platform-preview | app/(app)/dashboard/loading.tsx | Dashboard route fallback. |
NotFoundPage, createAppShellStatusPages | @brightweblabs/app-shell | packages/app-shell/src/status-pages/ | surface | platform-preview, downstream apps | app/not-found.tsx | Standalone 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-shell | packages/app-shell/src/status-pages/error-page.tsx | surface | platform-preview, downstream apps | app/(app)/error.tsx | Client error-boundary surface retaining reset/retry behavior and a configurable home action. |
@brightweblabs/core-auth surfaces
| Component | Package | Path | Tier (primitive / pattern / surface) | Used by (packages) | MQ origin (file) | Notes |
|---|---|---|---|---|---|---|
AuthLayout, AuthCard, AuthHeading, AuthNotice | @brightweblabs/core-auth/ui | packages/core-auth/src/ui/auth-layout.tsx | pattern | core-auth screens | MQ auth layout and global auth rules | Shared branded frame, vessel, heading, and feedback compositions. |
AuthUiProvider, useAuthUi, createAuthUiClient | @brightweblabs/core-auth/ui | packages/core-auth/src/ui/context.tsx, packages/core-auth/src/ui/client.ts | pattern | platform-preview, downstream auth routes | — | Injectable dictionary, route, and browser-client boundary; UI components do not import Supabase. |
LoginPage, ForgotPasswordPage, ResetPasswordPage, SignupPage | @brightweblabs/core-auth/ui | packages/core-auth/src/ui/*-page.tsx | surface | platform-preview, downstream apps | Matching MQ auth routes | Packaged credential and recovery surfaces with invite-only signup as the default policy. |
InvitePage, ConfirmedPage, PostLoginPage | @brightweblabs/core-auth/ui | packages/core-auth/src/ui/invite-page.tsx, confirmed-page.tsx, post-login-page.tsx | surface | platform-preview, downstream apps | Matching MQ auth routes | Organization/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.
| Component | Package | Path | Tier (primitive / pattern / surface) | Used by (packages) | MQ origin (file) | Notes |
|---|---|---|---|---|---|---|
AdminUsersClient, AdminUsersLoading, AdminToolbarControls, AdminRolePill | @brightweblabs/module-admin/ui | packages/module-admin/src/ui/ | surface | platform-preview | MQ admin users route and components | Injectable 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/ui | packages/module-crm/src/ui/dashboard.tsx | surface | platform-preview | — (pre-ledger CRM port) | CRM aggregate surface. |
CrmContactsTable | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/contacts-table.tsx | surface | module-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/ui | packages/module-crm/src/ui/dashboard-sidebar.tsx | surface | module-crm | — (pre-ledger CRM port) | CRM timeline/organization sidebar cards. |
CrmActivityCard | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/activity-card.tsx | pattern | module-crm, app-shell dashboard contribution | — (pre-ledger CRM port) | CRM activity row/card. |
CrmFunnelStats | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/funnel-stats.tsx | pattern | module-crm, app-shell dashboard contribution | — (pre-ledger CRM port) | Funnel metric pattern using shared KPI breakdown. |
CrmTimeline, CrmTimelineBrowser | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/timeline.tsx, packages/module-crm/src/ui/timeline-browser.tsx | surface | module-crm | — (pre-ledger CRM port) | Embedded timeline plus searchable sheet browser. |
CrmOrganizationsBrowser, CrmOrganizationSheet | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/organizations-browser.tsx, packages/module-crm/src/ui/organization-sheet.tsx | surface | module-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/ui | packages/module-orgs/src/ui/organization-create-sheet.tsx | surface | module-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/ui | packages/module-crm/src/ui/contact-dialog.tsx, packages/module-crm/src/ui/status-dialog.tsx, packages/module-crm/src/ui/delete-dialog.tsx | surface | module-crm | — (pre-ledger CRM port) | CRM mutation dialogs. Stage selectors retain literal interactive pill markup. |
CrmReport, CrmReportPage, CrmReportBanner | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/report.tsx, packages/module-crm/src/ui/report-banner.tsx | surface | platform-preview, module-crm | — (pre-ledger CRM port) | Report page and dashboard banner. |
CrmToolbarSearchChip, CrmToolbarFiltersPill, CrmToolbarCreateMenu, CrmToolbarControls | @brightweblabs/module-crm/ui | packages/module-crm/src/ui/toolbar-controls.tsx | pattern | platform-preview, module-crm | — (pre-ledger CRM port) | Binds CRM state and dictionary to app-shell toolbar patterns. |
ProjectsPage, ProjectsPortfolioRoot | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/projects-page.tsx, packages/module-projects/src/ui/projects-portfolio/projects-portfolio-root.tsx | surface | platform-preview | projetos/page.tsx, projetos/_components/projects-portfolio/projects-portfolio-root.tsx | Projects portfolio route and client root. |
ProjectsPortfolioList, ProjectsPortfolioStats, ProjectsPortfolioPagination, ProjectsPortfolioModals | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/projects-portfolio/ | pattern | module-projects | projetos/_components/projects-portfolio/* | Portfolio sub-surfaces. Pagination wraps shared TablePagination without changing its markup. |
ProjectDetailPage, ProjectDetailDataProvider | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/project-detail-page.tsx, packages/module-projects/src/ui/project-detail-data-provider.tsx | surface | platform-preview | projetos/[projectId]/page.tsx, projetos/[projectId]/_components/project-detail-data-provider.tsx | Project detail composition and data context. |
ProjectDetailHero, ProjectDetailMetadataStrip, ProjectDetailTeamCard | internal to @brightweblabs/module-projects | packages/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.tsx | surface | module-projects | Matching files under projetos/[projectId]/_components/ | Literal MQ detail sections composed by the public ProjectDetailPage; internal prop contracts are not supported API. |
ProjectMilestonesAndTasksCards, ProjectMilestonesAndTasksLists | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/project-detail-editable-cards.tsx, packages/module-projects/src/ui/project-milestone-task-lists.tsx | surface | module-projects | Matching files under projetos/[projectId]/_components/ | Internal detail-page compositions. Their compact section-empty markup differs from UI EmptyState. |
ProjectActivityCard | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/project-activity-card.tsx | pattern | module-projects | projetos/[projectId]/_components/project-activity-card.tsx | Supported activity-card surface. |
ProjectRecentActivity, ActivityChangeRows | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/project-recent-activity.tsx, packages/module-projects/src/ui/shared/activity-change-rows.tsx | pattern | module-projects | MQ activity composition | Implementation details of ProjectActivityCard; not exported. |
ProjectLinksCard | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/project-links-card.tsx | surface | module-projects | projetos/[projectId]/_components/project-links-card.tsx | Internal 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/ui | packages/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.tsx | surface | platform-preview | projetos/[projectId]/quadro/* | Literal board surface and toolbar binding. |
ProjectTasksPage, ProjectBoardPage | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/project-tasks-page.tsx | surface | platform-preview | projetos/[projectId]/tarefas/page.tsx, projetos/[projectId]/quadro/page.tsx | Public aliases sharing one task/board route composition. |
CreateProjectSheet, CreateProjectTaskSheet | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/create-project-sheet.tsx, packages/module-projects/src/ui/create-project-task-sheet.tsx | surface | module-projects | projetos/_components/create-project-sheet.tsx, projetos/_components/create-project-task-sheet.tsx | Mounted through the public portfolio surface; their form props are not supported API. |
ProjectEditSheet, ProjectMembersEditSheet, ProjectStatusQuickAction | internal to @brightweblabs/module-projects | packages/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.tsx | surface | module-projects | Matching files under projetos/[projectId]/_components/ | Internal edit/membership/status surfaces. Confirmation-button styling stays literal. |
ProjectMilestoneCreateSheet, ProjectTaskCreateSheet, ProjectLinkCreateSheet, ProjectDetailCreateSheetsMount | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/project-detail-create-sheets/ | surface | module-projects | Matching directory under projetos/[projectId]/_components/ | Lazily mounted implementation details of public detail/task surfaces. |
ProjectStateBadge, ProjectStatusBadge, ProjectHealthBadge | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/project-state-badge.tsx | pattern | module-projects | projetos/_components/project-state-badge.tsx | MQ-specific hero/default surfaces use tintPill; not interchangeable with generic StatusPill. |
ProjectPill, ProjectDotPill | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/project-pill.tsx | pattern | module-projects | components/projects/project-pill.tsx | Base Projects pill geometry; internal styling contract. |
ProjectOwnerAvatar | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/project-owner-avatar.tsx | pattern | module-projects | components/projects/project-owner-avatar.tsx | Role-colored literal avatar used inside public compositions; not exported independently. |
MemberRoleBadge | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/member-role-badge.tsx | pattern | module-projects | components/projects/member-role-badge.tsx | Internal Projects role palette and labels. |
ProjectProgressBar | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/project-progress.tsx | pattern | module-projects | components/projects/project-progress.tsx | Internal project progress recipe. |
ProjectSummaryCard, ProjectSummaryCardSkeleton | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/shared/project-summary-card.tsx, packages/module-projects/src/ui/shared/project-summary-card-skeleton.tsx | pattern | module-projects, app-shell | components/projects/project-summary-card.tsx, components/projects/project-summary-card-skeleton.tsx | Injected into AppDashboard through module registration. |
ProjectSurfaceCard, ProjectSurfaceSectionHeader | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/project-surface-card.tsx | pattern | module-projects | components/projects/project-surface-card.tsx | Internal Projects surface composition; differs from UI SurfaceCard and SectionHeading. |
TaskPriorityTag, TaskStatusTag, TaskDueMeta | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/shared/task-tags.tsx | pattern | module-projects, app-shell | components/projects/task-tags.tsx | Supported task-specific tags/meta used by downstream dashboard contributions. |
TaskTag, TaskMilestoneMeta, TaskAssigneeMeta | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/task-tags.tsx | pattern | module-projects | components/projects/task-tags.tsx | Internal building blocks; their props are not frozen as public API. |
SectionEmptyState, SectionLoadingState | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/section-feedback.tsx | pattern | module-projects | components/projects/section-feedback.tsx | Internal compact section feedback, intentionally distinct from UI EmptyState. |
SectionIconButton, SectionAddButton | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/section-icon-button.tsx | pattern | module-projects | components/projects/section-icon-button.tsx | Internal Projects section actions. |
ContactActionButtons | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/shared/contact-action-buttons.tsx | pattern | module-projects | components/projects/contact-action-buttons.tsx | Internal email/phone action pair. |
FormSection, SelectField, DateField | internal to @brightweblabs/module-projects | packages/module-projects/src/ui/project-create/shared-fields.tsx | pattern | module-projects | projetos/_components/project-create/shared-fields.tsx | Internal project-creation fields. |
ProjectsToolbarControls | @brightweblabs/module-projects/ui | packages/module-projects/src/ui/toolbar-controls.tsx | pattern | platform-preview | MQ Projects toolbar composition | Binds Projects filters and creation actions to app-shell toolbar containers. |
Brief 27 changelog
REMOVED
| Item | Former location | Reason |
|---|---|---|
ProjectActivityCardLoader | packages/module-projects/src/ui/project-activity-card-loader.tsx:1 | Orphaned translated wrapper; no import, public export, route, test, contract, or documentation consumer beyond the stale translation ledger. |
ProjectDetailStatsStrip | packages/module-projects/src/ui/project-detail-stats-strip.tsx:1 | Orphaned alternate detail strip; the live detail composition uses the editable cards and metadata strip. |
| Legacy Projects playground page | apps/platform-preview/app/playground/projects/page.tsx:1 | Superseded by the packaged /projects, detail, board, and task previews; it was no longer linked by preview module configuration. |
--project-ui-color-65 | packages/module-projects/tokens.css:69 | Definition-only token with no static or computed consumer. |
--project-ui-color-66 | packages/module-projects/tokens.css:70 | Definition-only token with no static or computed consumer. |
--project-ui-color-81 | packages/module-projects/tokens.css:85 | Definition-only token with no static or computed consumer. |
--project-ui-color-82 | packages/module-projects/tokens.css:86 | Definition-only token with no static or computed consumer. |
.project-chip-code | packages/module-projects/tokens.css:159 | Unused class; no component or app applied it. |
.project-group-title | packages/module-projects/tokens.css:283 | Unused 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
| Replacement | Location | Parity statement |
|---|---|---|
Raw admin select-all checkbox → UI Checkbox | packages/module-admin/src/users-client.tsx:353 | Same native input, props, classes, and event handler. |
Raw admin row checkbox → UI Checkbox | packages/module-admin/src/users-client.tsx:384 | Same native input, props, classes, and event handler. |
Raw CRM select-all checkbox → UI Checkbox | packages/module-crm/src/ui/contacts-table.tsx:182 | Same native input, props, classes, and event handler. |
Raw CRM row checkbox → UI Checkbox | packages/module-crm/src/ui/contacts-table.tsx:206 | Same native input, props, classes, and event handler. |
Raw Projects member checkbox → UI Checkbox | packages/module-projects/src/ui/create-project-sheet.tsx:813 | Same 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
Fieldfamily, pairFieldLabel htmlForwith the controlid; usearia-describedbyfor descriptions or errors andaria-invalidfor 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-accessiblein neutral, dark, and MQ themes. Decorative or nonessential muted treatments may continue to usetext-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-authexports invitation detail, registration, and acceptance handler factories.@brightweblabs/module-adminexports the admin invitation list/create/revoke/register lifecycle and matching route handlers.@brightweblabs/module-orgsexports 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/contactsendpoints. 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.