t0ng7u
92a0959448
Replace the ad-hoc "workspace" abstraction with a focused, URL-driven
"sidebar view" registry that implements the modern Vercel / Cloudflare
drill-in pattern: clicking a top-level entry (e.g. System Settings)
swaps the sidebar to a contextual workspace, with a `← Back to
Dashboard` affordance, instead of stacking sub-navigation in the root.
Architecture
------------
- types.ts
+ SidebarView — declarative nested view config
(id, pathPattern, parent, getNavGroups)
+ SidebarViewParent — back-navigation descriptor
+ ResolvedSidebarView — { key, view, navGroups } returned by hook
+ SidebarData — slimmed to { navGroups } only
- Workspace — removed (logo/plan never rendered)
- lib/sidebar-view-registry.ts (new, replaces workspace-registry.ts)
+ SIDEBAR_VIEWS array — single source of truth for nested views
+ resolveSidebarView(pathname)
+ getNavGroupsForPath(pathname, t) — back-compat helper for the
command palette
- config/system-settings.config.ts
Refactored to export a single SYSTEM_SETTINGS_VIEW (SidebarView)
with parent `/dashboard/overview` + label `Back to Dashboard`.
- components/sidebar-view-header.tsx (new)
Renders only the back affordance (chevron + label). Uses the
default SidebarMenuButton size so its typography matches the
nav items below; collapses gracefully into icon mode via the
existing tooltip behavior. The redundant "title + icon" row was
removed — workspace context is already carried by the nav groups.
- hooks/use-sidebar-view.ts (new)
Encapsulates view resolution and root-nav filtering:
· matched view → returns its nav groups verbatim (route-level
beforeLoad guards already enforce access);
· no match → returns root nav groups, narrowed by user
role (admin gate) and useSidebarConfig
(admin × user sidebar_modules overlay).
- components/app-sidebar.tsx
Now a thin presentation layer: reads { key, view, navGroups }
from useSidebarView() and orchestrates the view transition via
AnimatePresence + MOTION_VARIANTS.sidebarSlide (respects
prefers-reduced-motion). No logic, no role checks, no path
matching — those live in the hook.
- components/command-menu.tsx
Switched to the new getNavGroupsForPath() API; behavior preserved.
Cleanup
-------
- Deleted layout/context/workspace-context.tsx (zero consumers).
- Deleted layout/lib/workspace-registry.ts and its
workspace-registry.example.ts companion (over-abstracted: name/id
metadata, isInWorkspace / getAllWorkspaces / WORKSPACE_IDS were
registered but never read).
- Removed `workspaces` field from useSidebarData (never consumed
after the top-switcher was dropped).
- Dropped WorkspaceProvider from authenticated-layout.tsx.
- Trimmed dead `Manage and configure` translation key from all six
locale files and from static-keys.ts.
i18n
----
Added the `Back to Dashboard` key to en, zh, fr, ja, ru, vi, and
registered it in static-keys.ts under "Sidebar views".
Verification
------------
- bun run typecheck: passes
- Lint: no new warnings/errors on the touched files
- Adding a new drill-in workspace now only requires registering a
SidebarView in SIDEBAR_VIEWS — no changes to AppSidebar required.
68 lines
2.4 KiB
TypeScript
Vendored
68 lines
2.4 KiB
TypeScript
Vendored
/*
|
|
Copyright (C) 2023-2026 QuantumNous
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
For commercial licensing, please contact support@quantumnous.com
|
|
*/
|
|
/**
|
|
* Public surface of the Layout module.
|
|
*/
|
|
|
|
// Core components
|
|
export { AppHeader } from './components/app-header'
|
|
export { AppSidebar } from './components/app-sidebar'
|
|
export { AuthenticatedLayout } from './components/authenticated-layout'
|
|
export { PublicLayout } from './components/public-layout'
|
|
export { PublicHeader } from './components/public-header'
|
|
export { PublicNavigation } from './components/public-navigation'
|
|
export { HeaderLogo } from './components/header-logo'
|
|
export { NavLinkItem, NavLinkList } from './components/nav-link-item'
|
|
export { Header } from './components/header'
|
|
export { Main } from './components/main'
|
|
export { PageFooterPortal } from './components/page-footer'
|
|
export { NavGroup } from './components/nav-group'
|
|
export { SectionPageLayout } from './components/section-page-layout'
|
|
export { SidebarViewHeader } from './components/sidebar-view-header'
|
|
export { SystemBrand } from './components/system-brand'
|
|
export { TopNav } from './components/top-nav'
|
|
export { MobileDrawer } from './components/mobile-drawer'
|
|
|
|
// Configuration
|
|
export { SYSTEM_SETTINGS_VIEW } from './config/system-settings.config'
|
|
export { defaultTopNavLinks } from './config/top-nav.config'
|
|
|
|
// Constants
|
|
export { MOBILE_DRAWER_ANIMATION, MOBILE_DRAWER_CONFIG } from './constants'
|
|
|
|
// Sidebar view registry
|
|
export {
|
|
getNavGroupsForPath,
|
|
resolveSidebarView,
|
|
} from './lib/sidebar-view-registry'
|
|
|
|
// Type exports (type-only to avoid conflicts with components above)
|
|
export type {
|
|
NavCollapsible,
|
|
NavGroup as NavGroupType,
|
|
NavItem,
|
|
NavLink,
|
|
ResolvedSidebarView,
|
|
SidebarData,
|
|
SidebarView,
|
|
SidebarViewParent,
|
|
TopNavLink,
|
|
} from './types'
|
|
export type { SectionPageLayoutProps } from './components/section-page-layout'
|