Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
feat(react): add a shared NavRail for the ERP and MES app shells
aashu6c7d2e715c0a
diff --git a/packages/locale/locales/de/mes.po b/packages/locale/locales/de/mes.poindex 7e61b803a5..067e286f03 100644--- a/packages/locale/locales/de/mes.po+++ b/packages/locale/locales/de/mes.po@@ -354,9 +354,6 @@ msgstr "Abschluss läuft"msgid "Connecting"msgstr "Verbindung wird hergestellt"-msgid "Console"-msgstr "Konsole"-msgid "Console Mode"msgstr "Konsolenmodus"@@ -706,9 +703,6 @@ msgstr "Unzureichende Menge"msgid "Inventory adjustment completed"msgstr "Bestandskorrektur abgeschlossen"-msgid "Inventory Adjustments"-msgstr "Bestandskorrekturen"-msgid "is"msgstr "ist"@@ -1111,9 +1105,6 @@ msgstr "Öffnen Sie einen NCR für MRB-Verwendungsentscheid"msgid "Open Jobs"msgstr "Offene Fertigungsaufträge"-msgid "Operations"-msgstr "Arbeitsgänge"-msgid "Operations ended"msgstr "Arbeitsgänge beendet"@@ -1687,9 +1678,6 @@ msgstr "Heute"msgid "Toggle the sidebar"msgstr "Seitenleiste ein-/ausblenden"-msgid "Tools"-msgstr "Werkzeuge"-msgid "Total"msgstr "Gesamtbetrag"diff --git a/packages/locale/locales/en/mes.po b/packages/locale/locales/en/mes.poindex 8271726991..c9dc98e060 100644--- a/packages/locale/locales/en/mes.po+++ b/packages/locale/locales/en/mes.po@@ -354,9 +354,6 @@ msgstr "Completing"msgid "Connecting"msgstr "Connecting"-msgid "Console"-msgstr "Console"-msgid "Console Mode"msgstr "Console Mode"@@ -706,9 +703,6 @@ msgstr "Insufficient quantity"msgid "Inventory adjustment completed"msgstr "Inventory adjustment completed"-msgid "Inventory Adjustments"-msgstr "Inventory Adjustments"-msgid "is"msgstr "is"@@ -1111,9 +1105,6 @@ msgstr "Open an NCR for MRB disposition"msgid "Open Jobs"msgstr "Open Jobs"-msgid "Operations"-msgstr "Operations"-msgid "Operations ended"msgstr "Operations ended"@@ -1687,9 +1678,6 @@ msgstr "Today"msgid "Toggle the sidebar"msgstr "Toggle the sidebar"-msgid "Tools"-msgstr "Tools"-msgid "Total"msgstr "Total"diff --git a/packages/locale/locales/es/mes.po b/packages/locale/locales/es/mes.poindex 9988076bc0..845cc03967 100644--- a/packages/locale/locales/es/mes.po+++ b/packages/locale/locales/es/mes.po@@ -354,9 +354,6 @@ msgstr "Finalizando"msgid "Connecting"msgstr "Conectando"-msgid "Console"-msgstr "Consola"-msgid "Console Mode"msgstr "Modo consola"@@ -706,9 +703,6 @@ msgstr "Cantidad insuficiente"msgid "Inventory adjustment completed"msgstr "Ajuste de inventario completado"-msgid "Inventory Adjustments"-msgstr "Ajustes de inventario"-msgid "is"msgstr "es"@@ -1111,9 +1105,6 @@ msgstr "Abrir un NCR para la disposición de MRB"msgid "Open Jobs"msgstr "Órdenes de trabajo abiertas"-msgid "Operations"-msgstr "Operaciones"-msgid "Operations ended"msgstr "Operaciones finalizadas"@@ -1687,9 +1678,6 @@ msgstr "Hoy"msgid "Toggle the sidebar"msgstr "Alternar la barra lateral"-msgid "Tools"-msgstr "Herramientas"-msgid "Total"msgstr "Total"diff --git a/packages/locale/locales/fr/mes.po b/packages/locale/locales/fr/mes.poindex 776c1a9634..b125dc499d 100644--- a/packages/locale/locales/fr/mes.po+++ b/packages/locale/locales/fr/mes.po@@ -354,9 +354,6 @@ msgstr "Finalisation"msgid "Connecting"msgstr "Connexion..."-msgid "Console"-msgstr "Console"-msgid "Console Mode"msgstr "Mode console"@@ -706,9 +703,6 @@ msgstr "Quantité insuffisante"msgid "Inventory adjustment completed"msgstr "Ajustement de stock terminé"-msgid "Inventory Adjustments"-msgstr "Ajustements de stock"-msgid "is"msgstr "est"@@ -1111,9 +1105,6 @@ msgstr "Ouvrir une NCR pour le traitement du MRB"msgid "Open Jobs"msgstr "Ordres de fabrication ouverts"-msgid "Operations"-msgstr "Opérations"-msgid "Operations ended"msgstr "Opérations terminées"@@ -1687,9 +1678,6 @@ msgstr "Aujourd'hui"msgid "Toggle the sidebar"msgstr "Afficher/masquer la barre latérale"-msgid "Tools"-msgstr "Outils"-msgid "Total"msgstr "Total"diff --git a/packages/locale/locales/hi/mes.po b/packages/locale/locales/hi/mes.poindex 7da14a9d9f..de15dbf5ca 100644--- a/packages/locale/locales/hi/mes.po+++ b/packages/locale/locales/hi/mes.po@@ -354,9 +354,6 @@ msgstr "पूर्ण हो रहा है"msgid "Connecting"msgstr "जुड़ रहा है"-msgid "Console"-msgstr "कंसोल"-msgid "Console Mode"msgstr "कंसोल मोड"@@ -706,9 +703,6 @@ msgstr "अपर्याप्त मात्रा"msgid "Inventory adjustment completed"msgstr "इन्वेंटरी समायोजन पूर्ण हुआ"-msgid "Inventory Adjustments"-msgstr "इन्वेंटरी समायोजन"-msgid "is"msgstr "है"@@ -1111,9 +1105,6 @@ msgstr "MRB निपटान के लिए एक NCR खोलें"msgid "Open Jobs"msgstr "खुली जॉब्स"-msgid "Operations"-msgstr "ऑपरेशन"-msgid "Operations ended"msgstr "ऑपरेशन समाप्त"@@ -1687,9 +1678,6 @@ msgstr "आज"msgid "Toggle the sidebar"msgstr "साइडबार को टॉगल करें"-msgid "Tools"-msgstr "उपकरण"-msgid "Total"msgstr "कुल"diff --git a/packages/locale/locales/it/mes.po b/packages/locale/locales/it/mes.poindex 0a416e95d6..a9584c800c 100644--- a/packages/locale/locales/it/mes.po+++ b/packages/locale/locales/it/mes.po@@ -354,9 +354,6 @@ msgstr "Completamento in corso"msgid "Connecting"msgstr "Collegamento in corso"-msgid "Console"-msgstr "Console"-msgid "Console Mode"msgstr "Modalità Console"@@ -706,9 +703,6 @@ msgstr "Quantità insufficiente"msgid "Inventory adjustment completed"msgstr "Rettifica di magazzino completata"-msgid "Inventory Adjustments"-msgstr "Rettifiche di magazzino"-msgid "is"msgstr "è"@@ -1111,9 +1105,6 @@ msgstr "Apri un NCR per la disposizione MRB"msgid "Open Jobs"msgstr "Ordini di produzione aperti"-msgid "Operations"-msgstr "Operazioni"-msgid "Operations ended"msgstr "Operazioni terminate"@@ -1687,9 +1678,6 @@ msgstr "Oggi"msgid "Toggle the sidebar"msgstr "Attiva/disattiva la barra laterale"-msgid "Tools"-msgstr "Utensili"-msgid "Total"msgstr "Totale"diff --git a/packages/locale/locales/ja/mes.po b/packages/locale/locales/ja/mes.poindex 3daedc5410..0ea8573413 100644--- a/packages/locale/locales/ja/mes.po+++ b/packages/locale/locales/ja/mes.po@@ -354,9 +354,6 @@ msgstr "完了処理中"msgid "Connecting"msgstr "接続中"-msgid "Console"-msgstr "コンソール"-msgid "Console Mode"msgstr "コンソールモード"@@ -706,9 +703,6 @@ msgstr "数量が不足しています"msgid "Inventory adjustment completed"msgstr "在庫調整が完了しました"-msgid "Inventory Adjustments"-msgstr "在庫調整"-msgid "is"msgstr "が次と等しい"@@ -1111,9 +1105,6 @@ msgstr "MRB処置のためにNCRを開く"msgid "Open Jobs"msgstr "オープンな製造指図"-msgid "Operations"-msgstr "工程"-msgid "Operations ended"msgstr "工程が終了しました"@@ -1687,9 +1678,6 @@ msgstr "今日"msgid "Toggle the sidebar"msgstr "サイドバーの表示/非表示を切り替える"-msgid "Tools"-msgstr "工具"-msgid "Total"msgstr "合計"diff --git a/packages/locale/locales/ko/mes.po b/packages/locale/locales/ko/mes.poindex c5aa6315fb..c6156a594d 100644--- a/packages/locale/locales/ko/mes.po+++ b/packages/locale/locales/ko/mes.po@@ -354,9 +354,6 @@ msgstr "완료 처리 중"msgid "Connecting"msgstr "연결 중"-msgid "Console"-msgstr "콘솔"-msgid "Console Mode"msgstr "콘솔 모드"@@ -706,9 +703,6 @@ msgstr "수량 부족"msgid "Inventory adjustment completed"msgstr "재고 조정이 완료되었습니다"-msgid "Inventory Adjustments"-msgstr "재고 조정"-msgid "is"msgstr "같음"@@ -1111,9 +1105,6 @@ msgstr "MRB 처분 결정을 위해 NCR을 여세요"msgid "Open Jobs"msgstr "작업 지시 열기"-msgid "Operations"-msgstr "공정작업"-msgid "Operations ended"msgstr "공정작업 종료됨"@@ -1687,9 +1678,6 @@ msgstr "오늘"msgid "Toggle the sidebar"msgstr "사이드바 전환"-msgid "Tools"-msgstr "공구"-msgid "Total"msgstr "총계"diff --git a/packages/locale/locales/pl/mes.po b/packages/locale/locales/pl/mes.poindex c1a63de87d..242fb0f73d 100644--- a/packages/locale/locales/pl/mes.po+++ b/packages/locale/locales/pl/mes.po@@ -354,9 +354,6 @@ msgstr "Finalizowanie"msgid "Connecting"msgstr "Łączenie"-msgid "Console"-msgstr "Konsola"-msgid "Console Mode"msgstr "Tryb konsoli"@@ -706,9 +703,6 @@ msgstr "Niewystarczająca ilość"msgid "Inventory adjustment completed"msgstr "Korekta zapasów zakończona"-msgid "Inventory Adjustments"-msgstr "Korekty zapasów"-msgid "is"msgstr "jest"@@ -1111,9 +1105,6 @@ msgstr "Otwórz NCR dla dyspozycji MRB"msgid "Open Jobs"msgstr "Otwarte zlecenia produkcyjne"-msgid "Operations"-msgstr "Operacje"-msgid "Operations ended"msgstr "Operacje zakończone"@@ -1687,9 +1678,6 @@ msgstr "Dzisiaj"msgid "Toggle the sidebar"msgstr "Przełącz pasek boczny"-msgid "Tools"-msgstr "Narzędzia"-msgid "Total"msgstr "Suma"diff --git a/packages/locale/locales/pt/mes.po b/packages/locale/locales/pt/mes.poindex b6c3dba565..18a6aa82b4 100644--- a/packages/locale/locales/pt/mes.po+++ b/packages/locale/locales/pt/mes.po@@ -354,9 +354,6 @@ msgstr "Concluindo"msgid "Connecting"msgstr "Conectando"-msgid "Console"-msgstr "Console"-msgid "Console Mode"msgstr "Modo Console"@@ -706,9 +703,6 @@ msgstr "Quantidade insuficiente"msgid "Inventory adjustment completed"msgstr "Ajuste de estoque concluído"-msgid "Inventory Adjustments"-msgstr "Ajustes de Estoque"-msgid "is"msgstr "é"@@ -1111,9 +1105,6 @@ msgstr "Abrir um NCR para disposição MRB"msgid "Open Jobs"msgstr "Ordens de produção abertas"-msgid "Operations"-msgstr "Operações"-msgid "Operations ended"msgstr "Operações encerradas"@@ -1687,9 +1678,6 @@ msgstr "Hoje"msgid "Toggle the sidebar"msgstr "Alternar barra lateral"-msgid "Tools"-msgstr "Ferramentas"-msgid "Total"msgstr "Total"diff --git a/packages/locale/locales/ru/mes.po b/packages/locale/locales/ru/mes.poindex bd15e24369..bfea764a71 100644--- a/packages/locale/locales/ru/mes.po+++ b/packages/locale/locales/ru/mes.po@@ -354,9 +354,6 @@ msgstr "Завершение"msgid "Connecting"msgstr "Подключение"-msgid "Console"-msgstr "Консоль"-msgid "Console Mode"msgstr "Режим консоли"@@ -706,9 +703,6 @@ msgstr "Недостаточное количество"msgid "Inventory adjustment completed"msgstr "Корректировка запасов выполнена"-msgid "Inventory Adjustments"-msgstr "Корректировка запасов"-msgid "is"msgstr "равно"@@ -1111,9 +1105,6 @@ msgstr "Открыть NCR для решения MRB"msgid "Open Jobs"msgstr "Открытые производственные заказы"-msgid "Operations"-msgstr "Операции"-msgid "Operations ended"msgstr "Операции завершены"@@ -1687,9 +1678,6 @@ msgstr "Сегодня"msgid "Toggle the sidebar"msgstr "Открыть/закрыть боковую панель"-msgid "Tools"-msgstr "Инструменты"-msgid "Total"msgstr "Итого"diff --git a/packages/locale/locales/tr/mes.po b/packages/locale/locales/tr/mes.poindex 061671f714..4bd2f4415b 100644--- a/packages/locale/locales/tr/mes.po+++ b/packages/locale/locales/tr/mes.po@@ -354,9 +354,6 @@ msgstr "Tamamlanıyor"msgid "Connecting"msgstr "Bağlanıyor"-msgid "Console"-msgstr "Konsol"-msgid "Console Mode"msgstr "Konsol Modu"@@ -706,9 +703,6 @@ msgstr "Yetersiz miktar"msgid "Inventory adjustment completed"msgstr "Stok düzeltme tamamlandı"-msgid "Inventory Adjustments"-msgstr "Stok düzeltmeleri"-msgid "is"msgstr "eşittir"@@ -1111,9 +1105,6 @@ msgstr "MRB kararı için NCR aç"msgid "Open Jobs"msgstr "Açık İş emirleri"-msgid "Operations"-msgstr "Operasyonlar"-msgid "Operations ended"msgstr "Operasyonlar bitti"@@ -1687,9 +1678,6 @@ msgstr "Bugün"msgid "Toggle the sidebar"msgstr "Kenar çubuğunu aç/kapat"-msgid "Tools"-msgstr "Araçlar"-msgid "Total"msgstr "Toplam"diff --git a/packages/locale/locales/zh/mes.po b/packages/locale/locales/zh/mes.poindex b48a2125ed..0383a977d2 100644--- a/packages/locale/locales/zh/mes.po+++ b/packages/locale/locales/zh/mes.po@@ -354,9 +354,6 @@ msgstr "完成中"msgid "Connecting"msgstr "连接中"-msgid "Console"-msgstr "控制台"-msgid "Console Mode"msgstr "控制台模式"@@ -706,9 +703,6 @@ msgstr "数量不足"msgid "Inventory adjustment completed"msgstr "库存调整已完成"-msgid "Inventory Adjustments"-msgstr "库存调整"-msgid "is"msgstr "是"@@ -1111,9 +1105,6 @@ msgstr "为MRB处置打开NCR"msgid "Open Jobs"msgstr "未结工单"-msgid "Operations"-msgstr "工序"-msgid "Operations ended"msgstr "工序已结束"@@ -1687,9 +1678,6 @@ msgstr "今天"msgid "Toggle the sidebar"msgstr "切换侧栏"-msgid "Tools"-msgstr "工具"-msgid "Total"msgstr "总计"diff --git a/packages/react/AGENTS.md b/packages/react/AGENTS.mdindex 763e8ec7cf..5b37816280 100644--- a/packages/react/AGENTS.md+++ b/packages/react/AGENTS.md@@ -41,6 +41,7 @@ import { Button, Card, HStack, VStack, IconButton, cn } from "@carbon/react";- **Choice screens**: `ChoiceCardGroup` (card radios, `autoFocus` focuses the selected card) and `RadioGroupButton` (radio styled as a secondary Button) give one tab stop + arrow-key select; Enter stays free for the screen's continue action- **Layout**: `VStack` / `HStack` with numeric `spacing` prop (maps to `space-y-*`/`space-x-*`)- **Overlays**: `Drawer`, `Modal`, `ModalDrawer` (unified drawer/modal), `BottomSheet`, `Popover`+- **App nav**: `NavRail` is the primary left nav of both the ERP and MES shells (56px icon rail, expands on mouse hover or when pinned via `SidebarProvider`/⌘B, left drawer below md that closes itself on navigation). Entries are `NavRailItem` (a button, or `asChild` for a trigger/link) and `NavRailLink`; `label` is a string and doubles as the accessible name. Render inside `SidebarProvider`; the shadcn-style `Sidebar*` primitives remain for other layouts- **Data**: `Table` (TanStack), chart components via sub-exports (`@carbon/react/Chart`)- **Rich text**: `@carbon/react/Editor` and `@carbon/react/RichText` (wraps `@carbon/tiptap`)- **Error boundary**: `@carbon/react/ErrorBoundary` — `RootErrorBoundary` (drop-in root `ErrorBoundary` for RR v7 that maps 404 / other HTTP / thrown `Error` to a styled screen) plus its parts (`ErrorScreen`, `GlitchHeading`, `StatusReadout`, `MagneticLink`, `NoiseOverlay`). Wrap it in the app's `Document` and pass `env` so `window.env` is set (the client crashes hydration otherwise). Copy is intentionally hardcoded English, not i18n.diff --git a/packages/react/src/NavRail.tsx b/packages/react/src/NavRail.tsxnew file mode 100644index 0000000000..34c202763e--- /dev/null+++ b/packages/react/src/NavRail.tsx@@ -0,0 +1,262 @@+"use client";++import { Trans } from "@lingui/react/macro";+import { Slot, Slottable } from "@radix-ui/react-slot";+import type { ButtonHTMLAttributes, ReactNode } from "react";+import { forwardRef, useEffect, useState } from "react";+import type { LinkProps } from "react-router";+import { Link, useLocation } from "react-router";+import { Drawer, DrawerContent, DrawerTitle } from "./Drawer";+import { Separator } from "./Separator";+import { useSidebar } from "./Sidebar";+import { cn } from "./utils/cn";+import { VStack } from "./VStack";++export const navRailItemClasses = [+ "relative text-foreground/70 hover:text-foreground",+ "h-10 w-10 group-data-[state=expanded]:w-full",+ "flex items-center rounded-md",+ "group-data-[state=collapsed]:justify-center",+ "group-data-[state=expanded]:-space-x-2",+ "font-medium shrink-0 inline-flex items-center justify-center select-none",+ "disabled:opacity-50",+ "transition-[background-color,color,width] duration-100 ease-out",+ "focus:!outline-none focus:!ring-0 active:!outline-none active:!ring-0",+ "after:pointer-events-none after:absolute after:-inset-[3px] after:rounded-lg after:border after:border-blue-500 after:opacity-0 after:ring-2 after:ring-blue-500/20 after:transition-opacity focus-visible:after:opacity-100 active:after:opacity-0",+ "group/item"+];++/**+ * The primary left navigation shared by the ERP and MES app shells: a 56px+ * icon rail that grows to 208px while a mouse hovers it or while it is pinned+ * open (⌘B / a `SidebarTrigger`), and a left drawer below `md`. Open state+ * comes from `SidebarProvider`, so it must be rendered inside one.+ */+export function NavRail({+ children,+ footer,+ forceExpanded = false,+ disableHover = false+}: {+ children: ReactNode;+ footer?: ReactNode;+ /** Hold the rail open regardless of hover or pin (e.g. while rearranging). */+ forceExpanded?: boolean;+ /** Ignore hover, e.g. while a modal owns the pointer. */+ disableHover?: boolean;+}) {+ const { open, isMobile, openMobile, setOpenMobile } = useSidebar();+ const { pathname } = useLocation();+ const [hovered, setHovered] = useState(false);++ // Links, go-to shortcuts and redirects all land here: whatever navigated,+ // the phone drawer must not stay over the destination.+ // biome-ignore lint/correctness/useExhaustiveDependencies: runs per navigation+ useEffect(() => {+ setOpenMobile(false);+ }, [pathname, setOpenMobile]);++ // A Radix dialog toggles document.body pointer-events, and restoring them on+ // close fires a phantom enter on the rail with no paired leave — leaving it+ // stuck expanded. So hover is ignored while `disableHover` is set and cleared+ // on the frame after it changes (after any phantom event has fired).+ // biome-ignore lint/correctness/useExhaustiveDependencies: keyed on the toggle+ useEffect(() => {+ const raf = requestAnimationFrame(() => setHovered(false));+ return () => cancelAnimationFrame(raf);+ }, [disableHover]);++ const content = (+ <VStack spacing={1} className="flex flex-col justify-between h-full px-2">+ <VStack spacing={1}>{children}</VStack>+ {footer ? <VStack spacing={1}>{footer}</VStack> : null}+ </VStack>+ );++ if (isMobile) {+ return (+ <Drawer open={openMobile} onOpenChange={setOpenMobile}>+ <DrawerContent+ position="left"+ size="content"+ className="w-[17rem] max-w-[85vw] p-0"+ >+ <DrawerTitle className="px-6 py-4">+ <Trans>Navigation</Trans>+ </DrawerTitle>+ <nav+ data-state="expanded"+ className="group flex-1 overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-accent pb-4"+ >+ {content}+ </nav>+ </DrawerContent>+ </Drawer>+ );+ }++ const state = forceExpanded || open || hovered ? "expanded" : "collapsed";++ return (+ // The wrapper (not just the inner nav) grows on expand, so the rail pushes+ // the rest of the layout right instead of floating over it. Sticky so it+ // stays in view in shells whose page scrolls as a whole.+ <div+ data-state={state}+ className={cn(+ "sticky top-0 h-svh flex-col z-50 hidden md:flex shrink-0",+ "w-14 data-[state=expanded]:w-[13rem]",+ "transition-[width] duration-200"+ )}+ >+ <nav+ data-state={state}+ className={cn(+ "bg-background py-2 group z-10 h-full w-full",+ "flex flex-col justify-between",+ "hide-scrollbar overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-accent"+ )}+ onPointerEnter={(event) => {+ // Mouse only: a tap on a touch tablet must not expand the rail.+ if (!disableHover && event.pointerType === "mouse") setHovered(true);+ }}+ onPointerLeave={(event) => {+ if (event.pointerType === "mouse") setHovered(false);+ }}+ >+ {content}+ </nav>+ </div>+ );+}++type NavRailItemProps = Omit<+ ButtonHTMLAttributes<HTMLButtonElement>,+ "children"+> & {+ icon: ReactNode;+ /** Also the accessible name; the visible label span is aria-hidden. */+ label: string;+ isActive?: boolean;+ tag?: ReactNode;+ /** Shown at the right edge only while expanded (e.g. a shortcut hint). */+ trailing?: ReactNode;+ asChild?: boolean;+ children?: ReactNode;+};++/**+ * One rail entry. A `<button>` by default; with `asChild` the child element+ * becomes the item, so a `Link` or a Radix trigger keeps its own semantics.+ */+export const NavRailItem = forwardRef<HTMLButtonElement, NavRailItemProps>(+ (+ {+ icon,+ label,+ isActive = false,+ tag,+ trailing,+ asChild = false,+ className,+ children,+ ...props+ },+ ref+ ) => {+ const Comp = asChild ? Slot : "button";++ return (+ <Comp+ ref={ref}+ type={asChild ? undefined : "button"}+ aria-label={label}+ {...props}+ className={cn(+ navRailItemClasses,+ isActive+ ? "bg-active text-active-foreground dark:shadow-button-base"+ : "hover:bg-active/60 hover:text-active-foreground",+ className+ )}+ >+ {/* A 16px icon centred in this 24px box sits where a `left-3 top-3`+ icon would; the box also fits an `Avatar size="xs"`. */}+ <span className="absolute left-2 top-2 flex size-6 items-center justify-center [&>svg]:size-4">+ {icon}+ </span>+ {tag ? (+ <span className="absolute top-1 right-1 min-w-4 h-4 px-1 rounded-full bg-primary text-primary-foreground text-[10px] font-medium leading-4 text-center tabular-nums">+ {tag}+ </span>+ ) : null}+ <span+ aria-hidden+ className={cn(+ "min-w-[128px] text-sm text-left",+ "absolute left-7 group-data-[state=expanded]:left-12",+ "opacity-0 group-data-[state=expanded]:opacity-100"+ )}+ >+ {label}+ </span>+ {trailing ? (+ <span+ className={cn(+ "pointer-events-none absolute right-3 top-1/2 -translate-y-1/2",+ "opacity-0 transition-opacity duration-100 group-data-[state=expanded]:opacity-100"+ )}+ >+ {trailing}+ </span>+ ) : null}+ <Slottable>{children}</Slottable>+ </Comp>+ );+ }+);+NavRailItem.displayName = "NavRailItem";++export function NavRailLink({+ to,+ icon,+ label,+ isActive = false,+ tag,+ external = false,+ target,+ rel+}: {+ to: string;+ icon: ReactNode;+ label: string;+ isActive?: boolean;+ tag?: ReactNode;+ external?: boolean;+ target?: LinkProps["target"];+ rel?: string;+}) {+ return (+ <NavRailItem+ asChild+ icon={icon}+ label={label}+ isActive={isActive}+ tag={tag}+ >+ <Link+ to={to}+ target={target}+ rel={rel}+ aria-current={isActive ? "page" : undefined}+ prefetch={external ? "none" : "intent"}+ />+ </NavRailItem>+ );+}++export function NavRailDivider() {+ return (+ <Separator className="my-1 mx-auto w-6 group-data-[state=expanded]:w-full transition-[width] duration-200" />+ );+}diff --git a/packages/react/src/index.tsx b/packages/react/src/index.tsxindex f71cee0016..709d2da7dd 100644--- a/packages/react/src/index.tsx+++ b/packages/react/src/index.tsx@@ -239,6 +239,13 @@ import {} from "./ModalDrawer";import type { MultiSelectProps } from "./MultiSelect";import { MultiSelect } from "./MultiSelect";+import {+ NavRail,+ NavRailDivider,+ NavRailItem,+ NavRailLink,+ navRailItemClasses+} from "./NavRail";import type { NumberFieldProps } from "./Number";import {NumberDecrementStepper,@@ -546,6 +553,11 @@ export {NumberDecrementStepper,NumberField,NumberIncrementStepper,+ NavRail,+ NavRailDivider,+ NavRailItem,+ NavRailLink,+ navRailItemClasses,NumberInput,NumberInputGroup,NumberInputStepper,