feat(ui): complete phase 4 Poyraz UI foundation

components/layout/app-shell.tsx

@@ -1,16 +1,43 @@
 "use client";
 
 import { signOut } from "@/app/login/actions";
-import { IconButton } from "@/components/ui/button";
-import { Card, CardContent } from "@/components/ui/card";
-import { PendingLink } from "@/components/ui/pending-link";
-import { cn } from "@/lib/utils";
-import { ChevronUp, LogOut, Menu, Settings } from "lucide-react";
+import {
+  Card,
+  CardContent,
+  Typography,
+} from "poyraz-ui/atoms";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "poyraz-ui/molecules";
+import {
+  SidebarBranding,
+  SidebarContent,
+  SidebarFooter,
+  SidebarGroup,
+  SidebarGroupLabel,
+  SidebarHeader,
+  SidebarMenu,
+  SidebarMenuItem,
+  SidebarPanel,
+  SidebarProvider,
+  SidebarRail,
+  SidebarTrigger,
+  SidebarUserProfile,
+  useSidebar,
+} from "poyraz-ui/organisms";
+import { ChevronUp, LogOut, Settings } from "lucide-react";
 import type { LucideIcon } from "lucide-react";
 import Image from "next/image";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
-import { useEffect, useRef, useState } from "react";
 
 export type AppShellNavItem = {
   title: string;
@@ -23,6 +50,13 @@ export type AppShellNavGroup = {
   items: AppShellNavItem[];
 };
 
+export type AppShellBranding = {
+  applicationName: string;
+  organizationName: string | null;
+  lightLogoUrl: string | null;
+  darkLogoUrl: string | null;
+};
+
 type ShellUser = {
   email: string;
   displayName: string;
@@ -31,6 +65,7 @@ type ShellUser = {
 };
 
 type AppShellProps = {
+  branding: AppShellBranding;
   children: React.ReactNode;
   homeHref: string;
   navGroups: AppShellNavGroup[];
@@ -40,6 +75,7 @@ type AppShellProps = {
 };
 
 export function AppShell({
+  branding,
   children,
   homeHref,
   navGroups,
@@ -48,173 +84,206 @@ export function AppShell({
   progress,
 }: AppShellProps) {
   const pathname = usePathname();
-  const [mobileSidebarState, setMobileSidebarState] = useState({
-    open: false,
-    pathname,
-  });
-  const isMobileSidebarOpen =
-    mobileSidebarState.open && mobileSidebarState.pathname === pathname;
+  const sidebarProps = { branding, homeHref, navGroups, pathname, progress, settingsHref, user };
 
   return (
-    <div className="min-h-screen bg-background text-foreground">
-      <a
-        href="#main-content"
-        className="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-[90] focus:rounded-md focus:bg-surface focus:px-4 focus:py-2 focus:text-sm focus:font-medium focus:shadow-lg focus:ring-2 focus:ring-ring"
-      >
-        Ana içeriğe geç
-      </a>
-      <div className="flex min-h-screen">
-        <AppSidebar
-          homeHref={homeHref}
-          navGroups={navGroups}
-          pathname={pathname}
-          progress={progress}
-          settingsHref={settingsHref}
-          user={user}
-          className="sticky top-0 hidden h-screen shrink-0 self-stretch lg:flex"
-        />
+    <TooltipProvider>
+      <div className="min-h-screen bg-background text-foreground">
+        <a
+          href="#main-content"
+          className="sr-only focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:z-[90] focus:rounded-md focus:bg-surface focus:px-4 focus:py-2 focus:text-sm focus:font-medium focus:shadow-lg focus:ring-2 focus:ring-focus-ring"
+        >
+          Ana içeriğe geç
+        </a>
 
-        {isMobileSidebarOpen ? (
-          <button
-            type="button"
-            aria-label="Menüyü kapat"
-            className="fixed inset-0 z-40 bg-black/50 backdrop-blur-sm lg:hidden"
-            onClick={() => setMobileSidebarState({ open: false, pathname })}
-          />
-        ) : null}
+        <div className="flex min-h-screen">
+          <DesktopSidebar {...sidebarProps} />
 
-        <AppSidebar
-          homeHref={homeHref}
-          navGroups={navGroups}
-          pathname={pathname}
-          progress={progress}
-          settingsHref={settingsHref}
-          user={user}
-          className={cn(
-            "fixed inset-y-0 left-0 z-50 transition-transform duration-200 ease-out lg:hidden",
-            isMobileSidebarOpen ? "translate-x-0" : "-translate-x-full",
-          )}
-          onNavigate={() => setMobileSidebarState({ open: false, pathname })}
-        />
-
-        <div className="flex min-w-0 flex-1 flex-col">
-          <header className="sticky top-0 z-30 flex h-14 items-center justify-between border-b border-border bg-surface/95 px-4 backdrop-blur lg:hidden">
-            <Link href={homeHref} className="flex items-center gap-2 font-semibold">
-              <Image
-                src="/logo/blackLogoLong.png"
-                alt="Neta"
-                width={120}
-                height={32}
-                className="h-8 w-auto object-contain"
-                style={{ width: "auto" }}
-                priority
-              />
-            </Link>
-            <IconButton
-              label="Menüyü aç"
-              variant="outline"
-              onClick={() => setMobileSidebarState({ open: true, pathname })}
-            >
-              <Menu className="h-4 w-4" />
-            </IconButton>
-          </header>
-
-          <main id="main-content" className="min-w-0 flex-1 p-4 lg:p-8">
-            {children}
-          </main>
+          <div className="flex min-w-0 flex-1 flex-col">
+            <MobileSidebar {...sidebarProps} />
+            <main id="main-content" className="min-w-0 flex-1 p-4 lg:p-8">
+              {children}
+            </main>
+          </div>
         </div>
       </div>
-    </div>
+    </TooltipProvider>
   );
 }
 
-function AppSidebar({
-  homeHref,
-  navGroups,
-  pathname,
-  progress,
-  settingsHref,
-  user,
-  onNavigate,
-  className,
-}: {
+type SidebarCompositionProps = {
+  branding: AppShellBranding;
   homeHref: string;
   navGroups: AppShellNavGroup[];
   pathname: string;
   progress?: number;
   settingsHref: string;
   user: ShellUser;
-  onNavigate?: () => void;
-  className?: string;
-}) {
+};
+
+function DesktopSidebar(props: SidebarCompositionProps) {
   return (
-    <aside
-      className={cn(
-        "flex h-dvh w-[280px] max-w-[82vw] flex-col overflow-hidden border-r border-border bg-surface",
-        className,
-      )}
-    >
-      <div className="shrink-0 px-6 py-3">
-        <Link href={homeHref} className="flex w-full items-center justify-center">
-          <Image
-            src="/logo/blackLogoLong.png"
-            alt="Neta"
-            width={160}
-            height={48}
-            className="h-12 w-auto object-contain"
-            style={{ width: "auto" }}
-            priority
+    <SidebarProvider variant="collapsible">
+      <SidebarPanel className="sticky top-0 hidden h-screen shrink-0 self-stretch lg:flex">
+        <SidebarComposition {...props} />
+        <SidebarRail aria-label="Kenar çubuğunu daralt veya genişlet" />
+      </SidebarPanel>
+    </SidebarProvider>
+  );
+}
+
+function MobileSidebar(props: SidebarCompositionProps) {
+  return (
+    <SidebarProvider variant="floating">
+      <header className="sticky top-0 z-30 flex h-14 items-center justify-between border-b border-border bg-surface/95 px-4 backdrop-blur lg:hidden">
+        <Link href={props.homeHref} className="min-w-0">
+          <MobileBrand branding={props.branding} />
+        </Link>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <SidebarTrigger action="mobile" aria-label="Ana menüyü aç veya kapat" />
+          </TooltipTrigger>
+          <TooltipContent>Menü</TooltipContent>
+        </Tooltip>
+      </header>
+
+      <SidebarPanel className="h-dvh max-w-[82vw] lg:hidden">
+        <SidebarComposition {...props} />
+      </SidebarPanel>
+    </SidebarProvider>
+  );
+}
+
+function SidebarComposition({
+  branding,
+  homeHref,
+  navGroups,
+  pathname,
+  progress,
+  settingsHref,
+  user,
+}: SidebarCompositionProps) {
+  return (
+    <>
+      <SidebarHeader>
+        <Link href={homeHref} className="min-w-0 flex-1" aria-label={`${branding.applicationName} ana sayfa`}>
+          <SidebarBranding
+            logo={<BrandMark branding={branding} />}
+            title={branding.applicationName}
+            subtitle={branding.organizationName ?? "Freelancer portalı"}
           />
         </Link>
-      </div>
+        <Tooltip>
+          <TooltipTrigger asChild>
+            <SidebarTrigger
+              className="hidden lg:inline-flex"
+              aria-label="Kenar çubuğunu daralt veya genişlet"
+            />
+          </TooltipTrigger>
+          <TooltipContent>Kenar çubuğunu daralt</TooltipContent>
+        </Tooltip>
+      </SidebarHeader>
 
-      <div className="h-px bg-border" />
+      <SidebarContent scrollMode="fade">
+        <SidebarNavigation
+          homeHref={homeHref}
+          navGroups={navGroups}
+          pathname={pathname}
+        />
+      </SidebarContent>
 
-      <nav className="tiny-scrollbar min-h-0 flex-1 overflow-y-auto px-4 py-5">
-        {navGroups.map((group, groupIndex) => (
-          <section key={group.title} className={cn(groupIndex > 0 && "mt-6")}>
-            <h2 className="px-2 text-[11px] font-semibold uppercase leading-6 text-muted-foreground">
-              {group.title}
-            </h2>
-            <ul className="mt-2 space-y-1">
-              {group.items.map((item) => {
-                const isActive =
-                  item.href === homeHref
-                    ? pathname === homeHref
-                    : item.href
-                      ? pathname === item.href || pathname.startsWith(`${item.href}/`)
-                      : false;
-                const Icon = item.icon;
-
-                return (
-                  <li key={item.href || item.title}>
-                    <PendingLink
-                      href={item.href || "#"}
-                      onClick={onNavigate}
-                      aria-current={isActive ? "page" : undefined}
-                      className={cn(
-                        "flex h-10 items-center gap-3 rounded-md px-3 text-sm font-medium text-muted-foreground transition-colors",
-                        "hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
-                        isActive && "bg-primary/10 text-primary",
-                      )}
-                      showSpinner
-                    >
-                      {Icon ? <Icon className="h-4 w-4 shrink-0" /> : null}
-                      <span className="truncate">{item.title}</span>
-                    </PendingLink>
-                  </li>
-                );
-              })}
-            </ul>
-          </section>
-        ))}
-      </nav>
-
-      <div className="mt-auto flex shrink-0 flex-col gap-4 border-t border-border px-4 py-4">
+      <SidebarFooter className="flex flex-col gap-3">
         {typeof progress === "number" ? <ProgressSummary progress={progress} /> : null}
-        <AccountMenu user={user} settingsHref={settingsHref} onNavigate={onNavigate} />
-      </div>
-    </aside>
+        <AccountMenu user={user} settingsHref={settingsHref} />
+      </SidebarFooter>
+    </>
+  );
+}
+
+function SidebarNavigation({
+  homeHref,
+  navGroups,
+  pathname,
+}: Pick<SidebarCompositionProps, "homeHref" | "navGroups" | "pathname">) {
+  const { setMobileOpen, variant } = useSidebar();
+
+  return navGroups.map((group) => (
+    <SidebarGroup key={group.title}>
+      <SidebarGroupLabel>{group.title}</SidebarGroupLabel>
+      <SidebarMenu>
+        {group.items.map((item) => {
+          const active =
+            item.href === homeHref
+              ? pathname === homeHref
+              : item.href
+                ? pathname === item.href || pathname.startsWith(`${item.href}/`)
+                : false;
+          const Icon = item.icon;
+
+          return (
+            <SidebarMenuItem
+              key={item.href || item.title}
+              href={item.href || "#"}
+              active={active}
+              icon={Icon ? <Icon className="h-4 w-4" aria-hidden="true" /> : undefined}
+              onClick={() => {
+                if (variant === "floating") setMobileOpen(false);
+              }}
+            >
+              {item.title}
+            </SidebarMenuItem>
+          );
+        })}
+      </SidebarMenu>
+    </SidebarGroup>
+  ));
+}
+
+function BrandMark({ branding }: { branding: AppShellBranding }) {
+  const logoUrl = branding.lightLogoUrl ?? branding.darkLogoUrl;
+
+  if (!logoUrl) {
+    return (
+      <span className="flex h-full w-full items-center justify-center text-sm font-bold text-primary">
+        {branding.applicationName.slice(0, 1).toLocaleUpperCase("tr-TR")}
+      </span>
+    );
+  }
+
+  return (
+    <span className="flex h-full w-full items-center justify-center">
+      <Image
+        src={logoUrl}
+        alt=""
+        width={32}
+        height={32}
+        unoptimized
+        className={branding.darkLogoUrl ? "h-full w-full object-contain dark:hidden" : "h-full w-full object-contain"}
+      />
+      {branding.darkLogoUrl ? (
+        <Image
+          src={branding.darkLogoUrl}
+          alt=""
+          width={32}
+          height={32}
+          unoptimized
+          className="hidden h-full w-full object-contain dark:block"
+        />
+      ) : null}
+    </span>
+  );
+}
+
+function MobileBrand({ branding }: { branding: AppShellBranding }) {
+  return (
+    <div className="flex min-w-0 items-center gap-2">
+      <span className="flex h-8 w-8 shrink-0 items-center justify-center overflow-hidden rounded-sm border border-border bg-muted">
+        <BrandMark branding={branding} />
+      </span>
+      <Typography component="span" variant="small" className="truncate font-semibold">
+        {branding.applicationName}
+      </Typography>
+    </div>
   );
 }
 
@@ -222,16 +291,25 @@ function ProgressSummary({ progress }: { progress: number }) {
   const normalizedProgress = Math.max(0, Math.min(100, progress));
 
   return (
-    <Card className="overflow-hidden border-primary/10 bg-primary/5 shadow-none">
-      <CardContent className="space-y-3 p-4">
-        <div className="text-sm font-semibold text-foreground">Proje ilerlemesi</div>
+    <Card variant="soft" className="w-full overflow-hidden border-primary/10 shadow-none">
+      <CardContent className="space-y-3 p-3">
+        <Typography variant="small" className="font-semibold">
+          Proje ilerlemesi
+        </Typography>
         <div className="space-y-1.5">
-          <div className="flex items-center justify-between text-xs font-medium">
-            <span className="text-primary">%{normalizedProgress} tamamlandı</span>
-          </div>
-          <div className="h-2 w-full overflow-hidden rounded-full bg-primary/10">
+          <Typography variant="caption" className="font-medium text-primary">
+            %{normalizedProgress} tamamlandı
+          </Typography>
+          <div
+            role="progressbar"
+            aria-label="Proje ilerlemesi"
+            aria-valuemin={0}
+            aria-valuemax={100}
+            aria-valuenow={normalizedProgress}
+            className="h-2 w-full overflow-hidden rounded-full bg-primary-muted"
+          >
             <div
-              className="h-full rounded-full bg-primary transition-[width] duration-700 ease-out"
+              className="h-full rounded-full bg-primary transition-[width] duration-700 ease-out motion-reduce:transition-none"
               style={{ width: `${normalizedProgress}%` }}
             />
           </div>
@@ -241,110 +319,42 @@ function ProgressSummary({ progress }: { progress: number }) {
   );
 }
 
-function AccountMenu({
-  user,
-  settingsHref,
-  onNavigate,
-}: {
-  user: ShellUser;
-  settingsHref: string;
-  onNavigate?: () => void;
-}) {
-  const [open, setOpen] = useState(false);
-  const menuRef = useRef<HTMLDivElement>(null);
-  const buttonRef = useRef<HTMLButtonElement>(null);
-
-  useEffect(() => {
-    function handlePointerDown(event: PointerEvent) {
-      if (!menuRef.current?.contains(event.target as Node)) {
-        setOpen(false);
-      }
-    }
-
-    function handleKeyDown(event: KeyboardEvent) {
-      if (event.key === "Escape") {
-        setOpen(false);
-        buttonRef.current?.focus();
-      }
-    }
-
-    document.addEventListener("pointerdown", handlePointerDown);
-    document.addEventListener("keydown", handleKeyDown);
-    return () => {
-      document.removeEventListener("pointerdown", handlePointerDown);
-      document.removeEventListener("keydown", handleKeyDown);
-    };
-  }, []);
-
+function AccountMenu({ user, settingsHref }: { user: ShellUser; settingsHref: string }) {
   return (
-    <div ref={menuRef} className="relative">
-      <button
-        ref={buttonRef}
-        type="button"
-        aria-expanded={open}
-        aria-haspopup="menu"
-        className="flex w-full items-center gap-3 rounded-md p-2 text-left transition-colors hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-        onClick={() => setOpen((current) => !current)}
-      >
-        <UserAvatar user={user} />
-        <div className="min-w-0 flex-1">
-          <div className="truncate text-sm font-medium text-foreground">{user.displayName}</div>
-          <div className="truncate text-xs text-muted-foreground">{user.email}</div>
-        </div>
-        <ChevronUp className="h-4 w-4 shrink-0 text-muted-foreground" />
-      </button>
-
-      {open ? (
-        <div
-          role="menu"
-          className="absolute bottom-[calc(100%+0.5rem)] left-0 z-[70] w-full rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-lg"
+    <DropdownMenu>
+      <DropdownMenuTrigger asChild>
+        <button
+          type="button"
+          aria-label="Hesap menüsünü aç"
+          className="flex w-full items-center gap-2 rounded-sm p-1 text-left outline-none transition-colors hover:bg-accent focus-visible:ring-2 focus-visible:ring-focus-ring"
         >
-          <PendingLink
-            href={settingsHref}
-            role="menuitem"
-            onClick={() => {
-              setOpen(false);
-              onNavigate?.();
-            }}
-            className="flex h-9 items-center gap-2 rounded-sm px-3 text-sm hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-            showSpinner
+          <SidebarUserProfile
+            className="min-w-0 flex-1"
+            name={user.displayName}
+            role={user.email}
+            avatarUrl={user.avatarUrl ?? undefined}
+            initials={user.shortName}
+          />
+          <ChevronUp className="h-4 w-4 shrink-0 text-muted-foreground" aria-hidden="true" />
+        </button>
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="end" side="top" className="min-w-52">
+        <DropdownMenuItem asChild media={<Settings className="h-4 w-4" aria-hidden="true" />}>
+          <Link href={settingsHref}>Ayarlar</Link>
+        </DropdownMenuItem>
+        <DropdownMenuSeparator />
+        <form action={signOut}>
+          <DropdownMenuItem
+            asChild
+            media={<LogOut className="h-4 w-4" aria-hidden="true" />}
+            className="text-destructive"
           >
-            <Settings className="h-4 w-4" />
-            Ayarlar
-          </PendingLink>
-          <div className="my-1 h-px bg-border" />
-          <form action={signOut}>
-            <button
-              type="submit"
-              role="menuitem"
-              className="flex h-9 w-full items-center gap-2 rounded-sm px-3 text-left text-sm text-destructive hover:bg-accent focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-            >
-              <LogOut className="h-4 w-4" />
+            <button type="submit" className="w-full">
               Çıkış yap
             </button>
-          </form>
-        </div>
-      ) : null}
-    </div>
-  );
-}
-
-function UserAvatar({ user }: { user: ShellUser }) {
-  if (user.avatarUrl) {
-    return (
-      <Image
-        src={user.avatarUrl}
-        alt=""
-        width={36}
-        height={36}
-        className="h-9 w-9 rounded-full object-cover"
-      />
-    );
-  }
-
-  return (
-    <span className="flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-primary/10 text-xs font-semibold text-primary">
-      {user.shortName}
-    </span>
+          </DropdownMenuItem>
+        </form>
+      </DropdownMenuContent>
+    </DropdownMenu>
   );
 }

components/layout/dashboard-shell.tsx

@@ -1,9 +1,10 @@
 "use client";
 
-import { AppShell } from "@/components/layout/app-shell";
+import { AppShell, type AppShellBranding } from "@/components/layout/app-shell";
 import { sidebarData } from "@/config/sidebar";
 
 type DashboardShellProps = {
+  branding: AppShellBranding;
   children: React.ReactNode;
   user: {
     email: string;
@@ -13,9 +14,9 @@ type DashboardShellProps = {
   };
 };
 
-export function DashboardShell({ children, user }: DashboardShellProps) {
+export function DashboardShell({ branding, children, user }: DashboardShellProps) {
   return (
-    <AppShell homeHref="/" navGroups={sidebarData} settingsHref="/settings" user={user}>
+    <AppShell branding={branding} homeHref="/" navGroups={sidebarData} settingsHref="/settings" user={user}>
       {children}
     </AppShell>
   );

components/layout/portal-shell.tsx

@@ -1,9 +1,10 @@
 "use client";
 
-import { AppShell } from "@/components/layout/app-shell";
+import { AppShell, type AppShellBranding } from "@/components/layout/app-shell";
 import { portalSidebarData } from "@/config/portal-sidebar";
 
 type PortalShellProps = {
+  branding: AppShellBranding;
   children: React.ReactNode;
   user: {
     email: string;
@@ -14,9 +15,10 @@ type PortalShellProps = {
   progress?: number;
 };
 
-export function PortalShell({ children, user, progress }: PortalShellProps) {
+export function PortalShell({ branding, children, user, progress }: PortalShellProps) {
   return (
     <AppShell
+      branding={branding}
       homeHref="/portal"
       navGroups={portalSidebarData}
       settingsHref="/portal/settings"