"use client"; import { Button } from "@suphark/ui/components/shared/button/button"; import { FormInvalidNet } from "@suphark/ui/components/shared/form/form-invalid-notice"; import { SkipLink } from "@suphark/ui/components/shared/skip-link"; import { useUiText } from "@suphark/ui/components/shared/ui-text"; import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, } from "@suphark/ui/components/ui/input-group"; import { Separator } from "@suphark/ui/components/ui/separator"; import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, } from "@suphark/ui/components/ui/sheet"; import { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarInset, SidebarProvider, SidebarRail, useSidebar, } from "@suphark/ui/components/ui/sidebar"; import { focusFieldOf } from "@suphark/ui/lib/focus-after-remove"; import { SIDEBAR_PINNED_COOKIE_NAME } from "@suphark/ui/lib/sidebar-cookie"; import { cn } from "@suphark/ui/lib/utils"; import { PanelLeftIcon, Pin, PinOff, Search, X } from "lucide-react"; import Link from "next/link"; import { usePathname } from "next/navigation"; import { type ComponentProps, type CSSProperties, Fragment, type MouseEvent, type ReactNode, useCallback, useEffect, useMemo, useState, } from "react"; import { AppBrand, type AppBrandProps } from "./app-brand"; import { AppNav, type AppNavPinProps } from "./app-nav"; import { BreadcrumbLabelsProvider } from "./breadcrumb-labels"; import { HeaderBreadcrumbs, type HeaderBreadcrumbsProps } from "./header-breadcrumbs"; import { HeaderCrumbs } from "./header-crumb"; import { MobileTabBar, type MobileTabItem } from "./mobile-tab-bar"; import { SubNav } from "./sub-nav"; import { isTabActive, TopTabs, topLevelTabs } from "./top-tabs"; import { type AppNavGroup, searchNav } from "./types"; import { useAppHeaderHeight } from "./use-app-header-height"; export interface AppShellProps { /** * `sidebar` (ค่าเริ่มต้น) = sidebar ซ้าย (supplychain / console ทั่วไป) * `top` = แบบ Clerk dashboard: header มี crumb switchers + actions, แถบแท็บหลักใต้ header, * แท็บที่มีลูก → sub-nav ซ้ายแคบ; `nav` ชั้นแรกกลายเป็นแท็บ, ชั้นสองเป็น sub-nav */ layout?: "sidebar" | "top"; /** * (layout top) ปุ่ม switcher ใน header เรียงจากซ้ายคั่นด้วย `/` — ใส่ `HeaderCrumb` ที่ห่อ DropdownMenu ของแอปเอง * เช่น [องค์กร ⌄, แอป ⌄, ● Production ⌄]; ส่งเป็น array ให้คั่น `/` ให้ หรือส่ง component ที่ render `` เอง; ไม่ส่ง = ชื่อแอปจาก `brand` */ crumbs?: ReactNode[] | ReactNode; /** (layout top) หัวของ sub-nav — ค่าเริ่มต้น = ชื่อแท็บที่ active */ subNavTitle?: ReactNode; /** โลโก้/ชื่อแอปมุมบน sidebar (layout top: โลโก้เล็กหน้า crumbs ลิงก์ไป brand.href) */ brand: AppBrandProps; /** เมนู (ตัดตามสิทธิ์ด้วย `filterNav` ก่อนส่งเข้ามา) */ nav: AppNavGroup[]; /** ช่องค้นหาเมนูใต้โลโก้ (supplychain) */ searchable?: boolean; searchPlaceholder?: string; /** ปุ่ม pin เมนูขึ้น header (แอปเก็บ state เอง) */ pin?: AppNavPinProps; /** ส่วนเพิ่มใน sidebar ใต้โลโก้ เช่น TenantSwitcher / CommandPalette — ซ่อนอัตโนมัติเมื่อยุบเป็นไอคอน */ sidebarHeader?: ReactNode; /** สิ่งที่แสดงแทน `sidebarHeader` ตอนยุบเป็นไอคอน (เช่นปุ่มไอคอน ⌘K) — ไม่ส่ง = ไม่แสดงอะไร */ sidebarHeaderCollapsed?: ReactNode; /** * ส่วนเพิ่มใน `SidebarContent` ก่อน/หลังเมนู — เลื่อนไปกับเมนู (ต่างจาก `sidebarHeader` ที่ตรึงอยู่บน) * เช่น ต้นไม้โฟลเดอร์ + มิเตอร์พื้นที่แบบ Drive (Pi Files); ซ่อนอัตโนมัติเมื่อยุบเป็นไอคอน */ sidebarContentBefore?: ReactNode; sidebarContentAfter?: ReactNode; /** ท้าย sidebar — ปกติคือ `` */ sidebarFooter?: ReactNode; /** * header ของเนื้อหา: `false` = ไม่มี header, `true`/ไม่ส่ง = ปุ่มย่อ/ขยายเมนู + breadcrumb อัตโนมัติ * ส่ง object เพื่อกำหนดเอง */ header?: | boolean | { /** breadcrumb: `false` ปิด, object = ตั้งค่า HeaderBreadcrumbs, ReactNode = ใส่เอง */ breadcrumbs?: false | HeaderBreadcrumbsProps | ReactNode; /** กลางบรรทัด (เช่น pinned menus) */ center?: ReactNode; /** ขวาสุด: notification, feedback, `` … */ actions?: ReactNode; /** แถบเหนือ header เช่น impersonation banner */ banner?: ReactNode; className?: string; }; /** สีแบรนด์ต่อ tenant (ตั้ง --brand บน wrapper → primary/ring/sidebar-primary ตาม) */ brandColor?: string | null; brandForeground?: string | null; /** `icon` (ค่าเริ่มต้น) ยุบเหลือไอคอน · `offcanvas` ซ่อนทั้งแผง · `none` ตรึงตลอด */ collapsible?: ComponentProps["collapsible"]; /** * เปิด sidebar ตอนโหลด — อ่าน cookie ฝั่ง server แล้วส่งมา: * `sidebarDefaultOpen((await cookies()).get(SIDEBAR_COOKIE_NAME)?.value)` (ทั้งสองตัว import จาก `@suphark/ui` ใน server component ได้) */ defaultOpen?: boolean; /** อายุ cookie จำสถานะกาง/ยุบของ sidebar (วินาที) — ค่าเริ่มต้น 7 วัน (`SIDEBAR_COOKIE_MAX_AGE`) */ sidebarCookieMaxAge?: number; /** * ตรึง/เลิกตรึง sidebar ได้ (layout sidebar) — ปุ่มหมุดในหัว sidebar (จอ md ขึ้นไป) แบบ supplychain เดิม * - ตรึง = แผงติดซ้ายดันเนื้อหา ปุ่มย่อ = ซ่อนทั้งแผง (บังคับ `collapsible="offcanvas"`) * - เลิกตรึง = ซ่อนไว้ ปุ่มเมนู/Ctrl+B เปิดเป็นแผ่นลอยทับเนื้อหา ปิดเองเมื่อเลือกเมนู * - มือถือเป็นแผ่นเสมอ · จำค่าใน cookie `SIDEBAR_PINNED_COOKIE_NAME` (อายุตาม `sidebarCookieMaxAge` หรือ 1 ปี) */ sidebarPinnable?: boolean; /** ค่าตั้งต้นของการตรึง (ค่าเริ่มต้น `true`) — `sidebarDefaultOpen((await cookies()).get(SIDEBAR_PINNED_COOKIE_NAME)?.value)` */ sidebarDefaultPinned?: boolean; /** class ของกล่องเนื้อหา (ค่าเริ่มต้น padding ตาม supplychain) */ contentClassName?: string; /** จำกัดความกว้างเนื้อหา เช่น `max-w-5xl` (Pi Auth) — ไม่ส่ง = เต็มจอ (supplychain) */ contentMaxWidth?: string; /** * แถบเมนูล่างบนมือถือ (< md) 3–5 แท็บ — เว้นที่ใต้เนื้อหาให้เอง; เดสก์ท็อปยังใช้ sidebar/แท็บบนตามเดิม * (ยกจาก DueBell MobileNav) · แท็บ `{ label: "เมนู", icon, action: "sidebar" }` = เปิดเมนู sidebar ทั้งหมด (layout sidebar) */ mobileTabs?: ReadonlyArray; /** แถบประกาศเต็มความกว้างเหนือเนื้อหา ใต้ header (เช่น ``) */ banner?: ReactNode; children: ReactNode; } /** * โครงแอปมาตรฐาน: sidebar ซ้าย (shadcn Sidebar — ยุบเป็นไอคอนบนเดสก์ท็อป, Sheet บนมือถือ) + header + เนื้อหา * ยกจาก supplychain (main layout + AppSidebar) และ Pi Auth ConsoleShell — ใช้จาก layout.tsx ของแอปได้ทั้ง server/client * * ```tsx * }> * {children} * * ``` */ export function AppShell(props: AppShellProps) { return ( {props.layout === "top" ? : } ); } /** id ของ
ของ AppShell (sidebar: SidebarInset, top: main ในเนื้อหา) — ใช้อ้างจาก skip link / anchor */ export const APP_MAIN_ID = "app-main"; /** ลิงก์ "ข้ามไปเนื้อหา" ของ AppShell — ใช้ `SkipLink` ตัวเดียวกับที่ export ให้แอปใช้นอก AppShell */ function SkipToMain() { return ( <> {/* ตาข่ายฟอร์ม invalid ทั้งแอป — วางคู่กับ skip link เพราะทั้งสองแบบของ shell เรียกตัวนี้ */} ); } function SidebarShell({ brand, nav, searchable = false, searchPlaceholder = "ค้นหาเมนู…", pin, sidebarHeader, sidebarHeaderCollapsed, sidebarContentBefore, sidebarContentAfter, sidebarFooter, header = true, brandColor, brandForeground, collapsible = "icon", defaultOpen = true, sidebarCookieMaxAge, sidebarPinnable = false, sidebarDefaultPinned = true, contentClassName, contentMaxWidth, mobileTabs, banner, children, }: AppShellProps) { const text = useUiText(); const toggleSidebarLabel = text.toggleSidebar ?? "ย่อ/ขยายเมนู"; const style = brandColor ? ({ "--brand": brandColor, ...(brandForeground ? { "--brand-foreground": brandForeground } : {}), } as CSSProperties) : undefined; const headerOpts = typeof header === "object" ? header : {}; const showHeader = header !== false; const headerRef = useAppHeaderHeight(); const breadcrumbs = headerOpts.breadcrumbs === false ? null : headerOpts.breadcrumbs === undefined || isBreadcrumbOptions(headerOpts.breadcrumbs) ? ( ) : ( headerOpts.breadcrumbs ); return ( // base-ui-ok: defaultOpen อ่านจาก cookie ครั้งเดียวตอน mount — หลังจากนั้น Sidebar จัดการ state เอง (ตั้งใจให้ uncontrolled) {/* SidebarInset ของ shadcn เป็น
อยู่แล้ว (ไม่สร้าง
ซ้อน) — เป้าของ skip link อยู่ที่เนื้อหาใต้ header ไม่งั้นกด "ข้ามไปเนื้อหา" แล้ว Tab ถัดไปยังวนผ่านปุ่มใน header */} {showHeader && ( // data-slot/data-app-header: ความสูงจริง (สูงไม่คงที่: banner, 2 แถวบนมือถือ) ตั้งเป็น --app-header-height ที่ ให้แล้ว
{/* slot ที่อยู่ข้างลูกตัวอื่นต้องมี key — element จาก server component (lazy) ถูกตรวจ key เหมือนรายการ ("Each child in a list should have a unique key") */} {headerOpts.banner}
{/* flex-1 เฉพาะจอกว้าง — ใน flex-col บนมือถือ flex-1 (basis 0) ทำให้ h-12 ไม่มีผล แถวสูงตามปุ่ม (44/32px) */}
{breadcrumbs && ( <>
{breadcrumbs}
)}
{(headerOpts.center || headerOpts.actions) && (
{headerOpts.center && (
{headerOpts.center}
)} {headerOpts.actions && (
{headerOpts.actions}
)}
)}
)} {banner}
{children}
{mobileTabs?.length ? : null}
); } /** layout "top" — header (โลโก้ + crumbs | actions) → แถบแท็บ → [sub-nav ซ้าย?] + เนื้อหา */ function TopShell({ brand, nav, crumbs, subNavTitle, searchable = false, searchPlaceholder = "ค้นหา…", header = true, brandColor, brandForeground, contentClassName, contentMaxWidth, mobileTabs, banner, children, }: AppShellProps) { const pathname = usePathname(); const style = brandColor ? ({ "--brand": brandColor, ...(brandForeground ? { "--brand-foreground": brandForeground } : {}), } as CSSProperties) : undefined; const headerRef = useAppHeaderHeight(); const headerOpts = typeof header === "object" ? header : {}; // breadcrumb ของหน้าใน layout top ปิดเป็นค่าเริ่มต้น (แท็บบอกตำแหน่งอยู่แล้ว) — เปิดด้วย header.breadcrumbs const breadcrumbs = headerOpts.breadcrumbs === undefined || headerOpts.breadcrumbs === false ? null : isBreadcrumbOptions(headerOpts.breadcrumbs) ? ( ) : ( headerOpts.breadcrumbs ); const activeTab = topLevelTabs(nav).find((t) => isTabActive(pathname, t)); const subItems = activeTab?.items ?? []; const hasSubNav = subItems.length > 0; const logo = ( {brand.logo ?? (typeof brand.name === "string" ? brand.name.charAt(0).toUpperCase() : "•")} ); return (
{header !== false && (
{/* key: ดูหมายเหตุใน SidebarShell (element จาก server component ในตำแหน่งรายการ) */} {headerOpts.banner}
{logo} {Array.isArray(crumbs) ? ( {crumbs} ) : crumbs ? (
{crumbs}
) : ( {brand.name} )} {headerOpts.center &&
{headerOpts.center}
} {headerOpts.actions && (
{headerOpts.actions}
)}
)} {banner}
{hasSubNav && ( )}
{breadcrumbs} {children}
{mobileTabs?.length ? : null}
); } /** * แถบเมนูล่างของ layout sidebar — แท็บ `action: "sidebar"` เปิดแผ่นเมนู (Sheet) ของ sidebar * อยู่ใน SidebarProvider จึงเรียก `useSidebar()` ได้ (แอปประกาศ mobileTabs นอก provider / จาก server layout) */ function SidebarMobileTabs({ items }: { items: ReadonlyArray }) { const { setOpenMobile } = useSidebar(); const resolved = useMemo( () => items.map((item) => item.action === "sidebar" && !item.onClick ? { ...item, onClick: () => setOpenMobile(true) } : item, ), [items, setOpenMobile], ); return ; } /** * ปุ่มย่อ/ขยายเมนูในหัวเรื่อง — เขียนเองแทน `SidebarTrigger` ของ shadcn เพราะตัวนั้นฝัง * `Toggle Sidebar` เป็นภาษาอังกฤษไว้ใน children (แทนไม่ได้ * เพราะ JSX children ชนะ props) ตัวนี้ใช้ `UiText` และได้ tooltip จาก `Button` ของแพ็กเกจ * คง `data-sidebar="trigger"` ไว้ให้แอปที่ยิง selector เดิมยังใช้ได้ */ function SidebarToggle({ label }: { label: string }) { const { toggleSidebar } = useSidebar(); return ( ); } /** แผง sidebar — แยกเพื่อใช้ useSidebar (ล้างคำค้นเมื่อยุบ ไม่ให้เมนูถูกกรองทั้งที่มองไม่เห็นช่องค้นหา) */ function ShellSidebar({ brand, nav, searchable, searchPlaceholder, pin, sidebarHeader, sidebarHeaderCollapsed, sidebarContentBefore, sidebarContentAfter, sidebarFooter, collapsible, pinnable = false, defaultPinned = true, pinCookieMaxAge = 60 * 60 * 24 * 365, }: { pinnable?: boolean; defaultPinned?: boolean; pinCookieMaxAge?: number; } & Pick< AppShellProps, | "brand" | "nav" | "searchable" | "searchPlaceholder" | "pin" | "sidebarHeader" | "sidebarHeaderCollapsed" | "sidebarContentBefore" | "sidebarContentAfter" | "sidebarFooter" | "collapsible" >) { const { state, isMobile, open, setOpen } = useSidebar(); const text = useUiText(); const railLabel = text.toggleSidebar ?? "ย่อ/ขยายเมนู"; const [pinned, setPinnedState] = useState(defaultPinned); // ไม่ตรึงบนจอกว้าง = แผ่นลอย (มือถือ Sidebar เป็นแผ่นเองอยู่แล้ว) const floating = pinnable && !pinned && !isMobile; const setPinned = useCallback( (next: boolean) => { // biome-ignore lint/suspicious/noDocumentCookie: ค่าการแสดงผลฝั่ง client แบบเดียวกับ sidebar_state ของ ui/sidebar document.cookie = `${SIDEBAR_PINNED_COOKIE_NAME}=${next}; path=/; max-age=${pinCookieMaxAge}; samesite=lax`; setPinnedState(next); // ตรึง = กางแผงติดซ้าย · เลิกตรึง = ปิด (แผ่นลอยที่เปิดอยู่ปิดไปด้วย) setOpen(next); }, [pinCookieMaxAge, setOpen], ); const pinButton = pinnable ? : null; const [query, setQuery] = useState(""); const collapsed = state === "collapsed" && !isMobile; useEffect(() => { if (collapsed) setQuery(""); }, [collapsed]); const visibleNav = useMemo(() => searchNav(nav, query), [nav, query]); const searching = query.trim().length > 0; const inner = ( <> {pinButton && !searchable ? (
{pinButton}
) : ( )} {searchable && ( // ปุ่มตรึงอยู่ท้ายช่องค้นหาในแถวเดียวกัน (แบบ supplychain เดิม)
setQuery(e.target.value)} /> {query && ( { focusFieldOf(e.currentTarget); setQuery(""); }} aria-label={text.nav?.clearSearch ?? "ล้างคำค้นหาเมนู"} className="size-6 p-0 hover:bg-transparent" > )} {pinButton}
)} {sidebarHeader && (
{sidebarHeader}
)} {sidebarHeaderCollapsed && (
{sidebarHeaderCollapsed}
)}
{sidebarContentBefore && (
{sidebarContentBefore}
)} {/* landmark ของเมนูหลัก — กระโดดถึงด้วยปุ่มนำทางของโปรแกรมอ่านจอได้ */} {sidebarContentAfter && (
{sidebarContentAfter}
)}
{sidebarFooter && {sidebarFooter}} ); if (floating) { // เลือกเมนู (ลิงก์) แล้วปิดแผ่น — ปุ่มขยายกลุ่ม/ปุ่ม pin ไม่ใช่ลิงก์ แผ่นไม่ปิด · Ctrl/Cmd/Shift+คลิก (แท็บใหม่) ไม่ปิด const closeOnLink = (e: MouseEvent) => { if (e.ctrlKey || e.metaKey || e.shiftKey) return; if ((e.target as Element).closest("a[href]")) setOpen(false); }; return ( {text.nav?.main ?? "เมนูหลัก"} {text.nav?.sheetDescription ?? "เลือกหน้าที่ต้องการเปิด"} {inner} ); } return ( {inner} {/* title ของ shadcn เป็นอังกฤษและทำ tooltip ของเบราว์เซอร์ซ้อนกับของเรา → ปิดด้วย title={undefined} */} {collapsible !== "none" && } ); } /** ปุ่มตรึง sidebar (`sidebarPinnable`) — จอ md ขึ้นไป (มือถือเป็นแผ่นเสมอ) · ป้ายคงที่ + aria-pressed, tooltip บอกผล */ function SidebarPinButton({ pinned, onChange, }: { pinned: boolean; onChange: (pinned: boolean) => void; }) { const text = useUiText().sidebarPin; return ( ); } function isBreadcrumbOptions(value: unknown): value is HeaderBreadcrumbsProps { return ( typeof value === "object" && value !== null && !("$$typeof" in (value as object)) && !Array.isArray(value) ); }