@orsetra/shared-ui 1.9.1 → 1.10.0

package/components/layout/index.ts

@@ -1,6 +1,7 @@
 // Layout components exports
 export { MainSidebar, type SidebarMode } from './sidebar/main-sidebar'
-export { resolveIcon, type MainMenuItem, type SubMenuItem, type SidebarMenus, type MenuApiResponse, type ApiMenuData, type ApiMainMenuItem, type ApiSubMenuItem, type ApiSubMenu, type OrgInfo, type Project } from './sidebar/data'
+export { resolveIcon, type MainMenuItem, type SubMenuItem, type SidebarMenus, type SidebarMenuMeta, type MenuApiResponse, type ApiMenuData, type ApiMainMenuItem, type ApiSubMenuItem, type ApiSubMenu, type OrgInfo, type Project } from './sidebar/data'
+export { QuickAccessTracker } from './sidebar/quick-access-tracker'
 export { 
   Sidebar,
   SidebarContent,

package/components/layout/layout-container.tsx

@@ -4,7 +4,7 @@ import { useState, useEffect } from "react"
 import { usePathname, useSearchParams, useParams } from "next/navigation"
 import { MainSidebar, type SidebarMode } from "./sidebar/main-sidebar"
 import { Sidebar, SidebarProvider, useSidebar } from "./sidebar/sidebar"
-import { type SidebarMenus, type MainMenuItem, resolveIcon } from "./sidebar/data"
+import { type SidebarMenus, type MainMenuItem, type SidebarMenuMeta, resolveIcon } from "./sidebar/data"
 import { Button } from "../ui"
 import { Logo } from "../ui/logo"
 import { getMenuFromPath } from "../../lib/menu-utils"
@@ -50,6 +50,7 @@ function LayoutContent({
   const [mainMenuItems, setMainMenuItems] = useState<MainMenuItem[]>([])
   const [fetchedSidebarMenus, setFetchedSidebarMenus] = useState<SidebarMenus>({})
   const [sectionLabels, setSectionLabels] = useState<Record<string, string>>({})
+  const [sidebarMenuMeta, setSidebarMenuMeta] = useState<Record<string, SidebarMenuMeta>>({})
 
   useEffect(() => {
     if (!fetchMenus) return
@@ -69,6 +70,7 @@ function LayoutContent({
 
       const menus: SidebarMenus = {}
       const labels: Record<string, string> = {}
+      const meta: Record<string, SidebarMenuMeta> = {}
       Object.entries(subMenus).forEach(([key, subMenu]) => {
         menus[key] = subMenu.items.map((item) => ({
           id: item.id,
@@ -78,9 +80,20 @@ function LayoutContent({
           icon: resolveIcon(item.icon),
         }))
         labels[key] = subMenu.header
+        meta[key] = {
+          header:      subMenu.header,
+          description: subMenu.description,
+          links:       subMenu.links?.map(l => ({
+            label:       l.label,
+            href:        l.href,
+            description: l.description,
+            icon:        l.icon,
+          })),
+        }
       })
       setFetchedSidebarMenus(menus)
       setSectionLabels(labels)
+      setSidebarMenuMeta(meta)
     })
   // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [])
@@ -148,6 +161,7 @@ function LayoutContent({
           mode={isHidden ? "expanded" : mode}
           sidebarMenus={effectiveSidebarMenus}
           mainMenuItems={mainMenuItems}
+          sidebarMenuMeta={sidebarMenuMeta}
         />
 
         <main className="flex-1 bg-ibm-gray-10 min-h-0 overflow-auto">

package/components/layout/sidebar/data.tsx

@@ -36,6 +36,7 @@ import {
   ArrowRightLeft,
   ArrowLeftRight,
   Puzzle,
+  LifeBuoy,
 } from "lucide-react"
 
 export interface MainMenuItem {
@@ -88,9 +89,18 @@ export interface ApiSubMenuItem {
 }
 
 export interface ApiSubMenu {
-  id: string
-  header: string
-  items: ApiSubMenuItem[]
+  id:           string
+  header:       string
+  description?: string
+  /** Resource/doc links shown in the flyout default state (distinct from nav items) */
+  links?:       ApiSubMenuItem[]
+  items:        ApiSubMenuItem[]
+}
+
+export interface SidebarMenuMeta {
+  header?:      string
+  description?: string
+  links?:       Array<{ label: string; href: string; description?: string; icon?: string }>
 }
 
 export interface ApiMenuData {
@@ -150,6 +160,7 @@ const ICON_MAP: Record<string, LucideIcon> = {
   FileText,
   Code,
   Cloud,
+  LifeBuoy,
 }
 
 export function resolveIcon(name: string): LucideIcon {

package/components/layout/sidebar/main-sidebar-flyout.tsx

@@ -3,24 +3,27 @@
 import * as React from "react"
 import { cn } from "../../../lib/utils"
 import type { MainMenuItem, SubMenuItem } from "./data"
+import { resolveIcon } from "./data"
 import { Home, ExternalLink, type LucideIcon } from "lucide-react"
+import type { QuickAccessItem } from "../../../hooks/use-quick-access"
 
 export interface FlyoutDefaultLink {
   label:        string
   href:         string
   description?: string
-  icon?:        LucideIcon
+  icon?:        LucideIcon | string
 }
 
 interface MainSidebarFlyoutProps {
-  item:                 MainMenuItem | null
-  subItems:             SubMenuItem[]
-  onMouseEnter:         () => void
-  onMouseLeave:         () => void
-  main_base_url?:       string
-  defaultTitle?:        string
-  defaultDescription?:  string
-  defaultLinks?:        FlyoutDefaultLink[]
+  item:                MainMenuItem | null
+  subItems:            SubMenuItem[]
+  onMouseEnter:        () => void
+  onMouseLeave:        () => void
+  main_base_url?:      string
+  defaultTitle?:       string
+  defaultDescription?: string
+  defaultLinks?:       FlyoutDefaultLink[]
+  quickAccessItems?:   QuickAccessItem[]
 }
 
 export function MainSidebarFlyout({
@@ -32,6 +35,7 @@ export function MainSidebarFlyout({
   defaultTitle = "Camel X Platform",
   defaultDescription,
   defaultLinks = [],
+  quickAccessItems = [],
 }: MainSidebarFlyoutProps) {
   const homePath = React.useMemo(() => {
     if (!main_base_url) return "/"
@@ -44,6 +48,8 @@ export function MainSidebarFlyout({
     }
   }, [main_base_url])
 
+  const hasQuickAccess = quickAccessItems.length > 0
+
   return (
     <div
       onMouseEnter={onMouseEnter}
@@ -91,48 +97,70 @@ export function MainSidebarFlyout({
             })}
           </nav>
         </>
+      ) : hasQuickAccess ? (
+        /* ── Quick access: pages recently visited ────────────────────────── */
+        <div className="flex flex-col h-full items-center justify-center px-6 gap-6">
+          <div className="w-full">
+            <p className="px-2 pb-1 text-[10px] font-semibold text-text-secondary uppercase tracking-widest">
+              Accès rapide
+            </p>
+            <nav className="space-y-0.5">
+              {quickAccessItems.map((qa) => {
+                const QAIcon = qa.icon ? resolveIcon(qa.icon) : null
+                return (
+                  <a
+                    key={qa.id}
+                    href={qa.href}
+                    className="flex items-center gap-x-3 px-2 py-2 border-l-4 border-transparent hover:bg-ui-background hover:border-interactive transition-colors"
+                  >
+                    {QAIcon
+                      ? <QAIcon className="h-4 w-4 flex-shrink-0 text-text-secondary" />
+                      : <span className="h-4 w-4 flex-shrink-0" />
+                    }
+                    <p className="text-sm font-medium text-text-primary leading-snug truncate">{qa.label}</p>
+                  </a>
+                )
+              })}
+            </nav>
+          </div>
+        </div>
       ) : (
-        /* ── Default state: welcome + CTA + doc links ───────────────────── */
-        <div className="flex flex-col h-full">
-          {/* Header */}
-          <div className="px-5 pt-6 pb-5 border-b border-ui-border flex-shrink-0">
-            <div className="flex items-center gap-2.5 mb-3">
-              <div className="h-8 w-8 rounded-md bg-interactive flex items-center justify-center flex-shrink-0">
-                <Home className="h-4 w-4 text-white" />
-              </div>
-              <span className="text-sm font-semibold text-text-primary truncate">{defaultTitle}</span>
-            </div>
-
+        /* ── Default state: centré verticalement ────────────────────────── */
+        <div className="flex flex-col h-full items-center justify-center px-6 gap-6">
+          {/* Titre + texte + CTA */}
+          <div className="flex flex-col items-center gap-3 w-full">
+            <span className="text-sm font-semibold text-text-primary text-center">{defaultTitle}</span>
             {defaultDescription && (
-              <p className="text-xs text-text-secondary leading-relaxed mb-4">
-                {defaultDescription}
-              </p>
+              <p className="text-xs text-text-secondary text-center leading-relaxed">{defaultDescription}</p>
             )}
-
             <a
               href={homePath}
-              className="flex items-center justify-center gap-2 w-full px-3 py-2 bg-interactive hover:bg-interactive-hover text-white text-sm font-medium transition-colors"
+              className="flex items-center justify-center gap-2 w-full px-3 py-2 border border-interactive text-interactive hover:bg-interactive/10 text-sm font-medium transition-colors"
             >
               <Home className="h-4 w-4 flex-shrink-0" />
               Tableau de bord
             </a>
           </div>
 
-          {/* Doc / resource links */}
+          {/* Liens ressources */}
           {defaultLinks.length > 0 && (
-            <nav className="flex-1 overflow-y-auto px-2 lg:px-3 py-3 space-y-0.5">
+            <nav className="w-full space-y-0.5">
               <p className="px-2 pb-1 text-[10px] font-semibold text-text-secondary uppercase tracking-widest">
                 Ressources
               </p>
               {defaultLinks.map((link, i) => {
-                const LinkIcon = link.icon ?? ExternalLink
                 const isExternal = link.href.startsWith("http://") || link.href.startsWith("https://")
+                const LinkIcon: LucideIcon = !link.icon
+                  ? ExternalLink
+                  : typeof link.icon === "string"
+                    ? resolveIcon(link.icon)
+                    : link.icon
                 return (
                   <a
                     key={i}
                     href={link.href}
                     {...(isExternal ? { target: "_blank", rel: "noopener noreferrer" } : {})}
-                    className="flex items-start gap-x-3 px-2 lg:px-3 py-2 border-l-4 border-transparent hover:bg-ui-background hover:border-interactive transition-colors"
+                    className="flex items-start gap-x-3 px-2 py-2 border-l-4 border-transparent hover:bg-ui-background hover:border-interactive transition-colors"
                   >
                     <LinkIcon className="h-4 w-4 flex-shrink-0 mt-0.5 text-text-secondary" />
                     <div className="min-w-0 flex-1">

package/components/layout/sidebar/main-sidebar.tsx

@@ -4,10 +4,13 @@ import * as React from "react"
 import { cn } from "../../../lib/utils"
 import { Button } from "../../ui/button"
 import { Logo } from "../../ui/logo"
-import { type MainMenuItem, type SidebarMenus } from "./data"
+import { type MainMenuItem, type SidebarMenus, type SidebarMenuMeta } from "./data"
+
+export type { SidebarMenuMeta }
 import { X, Menu, ChevronDown, ChevronRight } from "lucide-react"
 import { useIsMobile } from "../../../hooks/use-mobile"
 import { MainSidebarFlyout, type FlyoutDefaultLink } from "./main-sidebar-flyout"
+import { useQuickAccess } from "../../../hooks/use-quick-access"
 
 export type { FlyoutDefaultLink }
 
@@ -23,9 +26,8 @@ interface MainSidebarProps {
   onSecondarySidebarOpen?: () => void
   sidebarMenus?: SidebarMenus
   mainMenuItems?: MainMenuItem[]
-  flyoutDefaultTitle?:        string
-  flyoutDefaultDescription?:  string
-  flyoutDefaultLinks?:        FlyoutDefaultLink[]
+  /** Per-submenu metadata (header + description) derived from the API menu response. */
+  sidebarMenuMeta?: Record<string, SidebarMenuMeta>
 }
 
 export function MainSidebar({
@@ -38,12 +40,11 @@ export function MainSidebar({
   onSecondarySidebarOpen,
   sidebarMenus = {},
   mainMenuItems = [],
-  flyoutDefaultTitle,
-  flyoutDefaultDescription,
-  flyoutDefaultLinks = [],
+  sidebarMenuMeta = {},
 }: MainSidebarProps) {
   const isMinimized = mode === 'minimized'
   const isMobile = useIsMobile()
+  const { items: quickAccessItems } = useQuickAccess()
 
   // Accordion — mobile only
   const [expandedMenu, setExpandedMenu] = React.useState<string | null>(null)
@@ -153,6 +154,17 @@ export function MainSidebar({
     }
   }
 
+  // Default flyout content derived from the menu metadata
+  const mainMeta     = sidebarMenuMeta["main"] ?? {}
+  const defaultTitle = mainMeta.header      ?? "Camel X Platform"
+  const defaultDesc  = mainMeta.description ?? undefined
+  const defaultLinks: FlyoutDefaultLink[] = (mainMeta.links ?? []).map(l => ({
+    label:       l.label,
+    href:        l.href,
+    description: l.description,
+    icon:        l.icon,
+  }))
+
   const handleSubMenuClick = (e: React.MouseEvent, menuId: string, href: string) => {
     e.preventDefault()
     window.location.href = buildSubItemHref(menuId, href)
@@ -302,9 +314,10 @@ export function MainSidebar({
             onMouseEnter={cancelCloseTimer}
             onMouseLeave={startCloseTimer}
             main_base_url={main_base_url}
-            defaultTitle={flyoutDefaultTitle}
-            defaultDescription={flyoutDefaultDescription}
-            defaultLinks={flyoutDefaultLinks}
+            defaultTitle={defaultTitle}
+            defaultDescription={defaultDesc}
+            defaultLinks={defaultLinks}
+            quickAccessItems={quickAccessItems}
           />
         )}
 

package/components/layout/sidebar/quick-access-tracker.tsx

@@ -0,0 +1,36 @@
+"use client"
+
+import { useEffect, useRef } from "react"
+import { usePathname } from "next/navigation"
+import { useQuickAccess } from "../../../hooks/use-quick-access"
+
+interface QuickAccessTrackerProps {
+  /** Human-readable label shown in the quick-access list */
+  label:    string
+  /** Icon name (resolved via resolveIcon). Defaults to "Box". */
+  icon?:    string
+  /** Set to false to skip tracking this page (e.g. list/index pages) */
+  enabled?: boolean
+}
+
+/**
+ * Drop this inside any page or layout to register that page in the
+ * sidebar's quick-access list. Tracks on mount and whenever pathname changes.
+ * Renders nothing.
+ */
+export function QuickAccessTracker({ label, icon, enabled = true }: QuickAccessTrackerProps) {
+  const pathname = usePathname()
+  const { addItem } = useQuickAccess()
+  // Stable ref so the effect doesn't re-run when addItem reference changes
+  const addRef = useRef(addItem)
+  addRef.current = addItem
+
+  useEffect(() => {
+    if (!enabled || !label || !pathname) return
+    addRef.current({ label, href: pathname, icon })
+  // Re-track whenever the actual page changes
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [pathname, label, icon, enabled])
+
+  return null
+}

package/hooks/index.ts

@@ -3,3 +3,4 @@ export { useAuth } from './use-auth';
 export { useToast } from './use-toast';
 export { useIsMobile } from './use-mobile';
 export { useWebSocket } from './use-websocket';
+export { useQuickAccess, type QuickAccessItem } from './use-quick-access';

package/hooks/use-quick-access.ts

@@ -0,0 +1,74 @@
+"use client"
+
+import { useState, useEffect, useCallback } from "react"
+
+const STORAGE_KEY = "sidebar:quick-access"
+const MAX_ITEMS   = 4
+
+export interface QuickAccessItem {
+  id:    string
+  label: string
+  href:  string
+  icon?: string
+}
+
+function readStorage(): QuickAccessItem[] {
+  if (typeof window === "undefined") return []
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY)
+    if (!raw) return []
+    const parsed = JSON.parse(raw)
+    return Array.isArray(parsed)
+      ? parsed.filter(
+          (i): i is QuickAccessItem =>
+            i && typeof i.id === "string" && typeof i.label === "string" && typeof i.href === "string"
+        )
+      : []
+  } catch {
+    return []
+  }
+}
+
+function writeStorage(items: QuickAccessItem[]): void {
+  try { localStorage.setItem(STORAGE_KEY, JSON.stringify(items)) } catch {}
+}
+
+export function useQuickAccess() {
+  const [items, setItems] = useState<QuickAccessItem[]>(readStorage)
+
+  // Sync across tabs
+  useEffect(() => {
+    const onStorage = (e: StorageEvent) => {
+      if (e.key === STORAGE_KEY) setItems(readStorage())
+    }
+    window.addEventListener("storage", onStorage)
+    return () => window.removeEventListener("storage", onStorage)
+  }, [])
+
+  const addItem = useCallback((item: Omit<QuickAccessItem, "id"> & { id?: string }) => {
+    setItems(prev => {
+      const id   = item.id ?? item.href
+      const next = [
+        { id, label: item.label, href: item.href, icon: item.icon },
+        ...prev.filter(i => i.href !== item.href),
+      ].slice(0, MAX_ITEMS)
+      writeStorage(next)
+      return next
+    })
+  }, [])
+
+  const removeItem = useCallback((href: string) => {
+    setItems(prev => {
+      const next = prev.filter(i => i.href !== href)
+      writeStorage(next)
+      return next
+    })
+  }, [])
+
+  const clearItems = useCallback(() => {
+    setItems([])
+    try { localStorage.removeItem(STORAGE_KEY) } catch {}
+  }, [])
+
+  return { items, addItem, removeItem, clearItems }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orsetra/shared-ui",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Shared UI components for Orsetra platform",
   "main": "./index.ts",
   "types": "./index.ts",