@kinetixui/ui 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -1295,7 +1295,84 @@ interface NativeSelectOptGroupProps extends React$1.OptgroupHTMLAttributes<HTMLO
 }
 declare const NativeSelectOptGroup: React$1.ForwardRefExoticComponent<NativeSelectOptGroupProps & React$1.RefAttributes<HTMLOptGroupElement>>;
 
+/**
+ * DescriptionList — `<dl>` term/detail rows with the site's own spec-sheet
+ * skin (mono, uppercase, tracked term labels; a divided rounded shell).
+ * Lifted out of two hand-rolled call sites — `ComponentMeta`'s doc-page
+ * spec strip and the homepage's "spec" card — into a reusable component.
+ * Gap-fill addition (not in the original Figma source).
+ */
+declare const DescriptionList: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDListElement> & React$1.RefAttributes<HTMLDListElement>>;
+interface DescriptionListItemProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "children"> {
+    term: React$1.ReactNode;
+    children: React$1.ReactNode;
+    /** `row` (default) puts the term and value side by side; `stacked` puts the value below a full-width term — better for long values. */
+    layout?: "row" | "stacked";
+}
+declare const DescriptionListItem: React$1.ForwardRefExoticComponent<DescriptionListItemProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Banner — a full-bleed, page-level notice (info/promo/maintenance),
+ * optionally dismissible and stickied to the top of the viewport. Distinct
+ * from `Alert` (in-flow, static) and `Sonner` (transient toast): Banner is
+ * edge-to-edge and persistent until dismissed. Distinct from `Inform`
+ * (contained, rounded inline card): Banner has no rounded corners or own
+ * width — it spans whatever it's placed in, typically the full viewport.
+ * Reuses `Inform`'s intent taxonomy and icon set for a consistent look.
+ * Gap-fill addition (not in the original Figma source).
+ */
+declare const bannerVariants: (props?: ({
+    variant?: "success" | "warning" | "error" | "information" | "action" | null | undefined;
+    sticky?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BannerProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bannerVariants> {
+    hideIcon?: boolean;
+    onDismiss?: () => void;
+    /** optional CTA rendered inline after the message */
+    action?: {
+        label: React$1.ReactNode;
+        onClick?: () => void;
+    };
+}
+declare const Banner: React$1.ForwardRefExoticComponent<BannerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * SegmentedControl — an iOS-style single-select strip. Functionally
+ * `ToggleGroup type="single"`: a thin, documented preset over the same
+ * Radix primitive with the segmented look (`Tabs`' `TabsList`/
+ * `TabsTrigger` visual treatment — filled track, raised active segment)
+ * instead of `Toggle`'s individually-outlined-button look. `type="single"`
+ * is fixed, not exposed — a segmented control that could go fully
+ * unselected or multi-select isn't the pattern. Gap-fill addition (not in
+ * the original Figma source).
+ */
+type SegmentedControlProps = Omit<ToggleGroupPrimitive.ToggleGroupSingleProps, "type">;
+declare const SegmentedControl: React$1.ForwardRefExoticComponent<SegmentedControlProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const SegmentedControlItem: React$1.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.ToggleGroupItemProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Timeline — ordered events down a rail (dot, connector, time, content).
+ * `alternating` lays content left/right of a centered rail (desktop);
+ * the default is a single left-aligned rail. Same rail/dot/connector
+ * technique as `Stepper`, but for a history/activity log rather than a
+ * progress indicator — no complete/current/upcoming states, an array of
+ * arbitrary events instead. Gap-fill addition (not in the original Figma
+ * source).
+ */
+interface TimelineItem {
+    time?: React$1.ReactNode;
+    title: React$1.ReactNode;
+    content?: React$1.ReactNode;
+    /** custom dot content — defaults to a filled circle */
+    icon?: React$1.ReactNode;
+}
+interface TimelineProps extends React$1.HTMLAttributes<HTMLOListElement> {
+    items: TimelineItem[];
+    alternating?: boolean;
+}
+declare const Timeline: React$1.ForwardRefExoticComponent<TimelineProps & React$1.RefAttributes<HTMLOListElement>>;
+
 /** Merges Tailwind class names, resolving conflicts (clsx + tailwind-merge). */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppBar, AppBarActions, AppBarBrand, AppBarLink, type AppBarLinkProps, AppBarNav, AspectRatio, AudioPlayer, type AudioPlayerProps, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, type ButtonGroupProps, ButtonGroupSeparator, type ButtonGroupSeparatorProps, ButtonGroupText, type ButtonProps, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockFile, type CodeBlockProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataTable, DatePicker, type DatePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, type EmptyMediaProps, EmptyTitle, Fab, type FabProps, Field, FieldControl, FieldDescription, FieldLabel, FieldMessage, FileUpload, FileUploadItem, type FileUploadItemProps, type FileUploadProps, Footer, FooterBottom, FooterColumn, type FooterColumnProps, FooterLink, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, Image, type ImageProps, Inform, type InformProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, Kbd, KbdGroup, type KbdGroupProps, type KbdProps, Label, List, ListItem, type ListItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Metric, type MetricProps, Modal, type ModalProps, type ModalType, NativeSelect, NativeSelectOptGroup, type NativeSelectOptGroupProps, NativeSelectOption, type NativeSelectOptionProps, type NativeSelectProps, NavigationBar, type NavigationBarProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberInput, type NumberInputProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PasswordInput, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, Quote, type QuoteProps, RadioGroup, RadioGroupItem, Rating, type RatingProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarProvider, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Spinner, type SpinnerProps, Stepper, type StepperProps, type StepperStep, Switch, TabBar, TabBarItem, type TabBarItemProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, type TableOfContentsProps, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Tag, type TagProps, Textarea, type TextareaProps, Toaster, type TocItem, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UploadFile, badgeVariants, buttonVariants, cn, emptyMediaVariants, fabVariants, formatBytes, informVariants, inputVariants, messageVariants, nativeSelectVariants, navigationMenuTriggerStyle, spinnerVariants, tagVariants, textareaVariants, toggleVariants, useAppBar, useFormField, useSidebar };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppBar, AppBarActions, AppBarBrand, AppBarLink, type AppBarLinkProps, AppBarNav, AspectRatio, AudioPlayer, type AudioPlayerProps, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, Banner, type BannerProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, type ButtonGroupProps, ButtonGroupSeparator, type ButtonGroupSeparatorProps, ButtonGroupText, type ButtonProps, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockFile, type CodeBlockProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataTable, DatePicker, type DatePickerProps, DescriptionList, DescriptionListItem, type DescriptionListItemProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, type EmptyMediaProps, EmptyTitle, Fab, type FabProps, Field, FieldControl, FieldDescription, FieldLabel, FieldMessage, FileUpload, FileUploadItem, type FileUploadItemProps, type FileUploadProps, Footer, FooterBottom, FooterColumn, type FooterColumnProps, FooterLink, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, Image, type ImageProps, Inform, type InformProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, Kbd, KbdGroup, type KbdGroupProps, type KbdProps, Label, List, ListItem, type ListItemProps, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Metric, type MetricProps, Modal, type ModalProps, type ModalType, NativeSelect, NativeSelectOptGroup, type NativeSelectOptGroupProps, NativeSelectOption, type NativeSelectOptionProps, type NativeSelectProps, NavigationBar, type NavigationBarProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberInput, type NumberInputProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PasswordInput, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, Quote, type QuoteProps, RadioGroup, RadioGroupItem, Rating, type RatingProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, SegmentedControl, SegmentedControlItem, type SegmentedControlProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarProvider, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Spinner, type SpinnerProps, Stepper, type StepperProps, type StepperStep, Switch, TabBar, TabBarItem, type TabBarItemProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, type TableOfContentsProps, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Tag, type TagProps, Textarea, type TextareaProps, Timeline, type TimelineItem, type TimelineProps, Toaster, type TocItem, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UploadFile, badgeVariants, bannerVariants, buttonVariants, cn, emptyMediaVariants, fabVariants, formatBytes, informVariants, inputVariants, messageVariants, nativeSelectVariants, navigationMenuTriggerStyle, spinnerVariants, tagVariants, textareaVariants, toggleVariants, useAppBar, useFormField, useSidebar };

package/dist/index.js

@@ -4043,6 +4043,169 @@ var NativeSelectOptGroup = React69.forwardRef(
   ({ ...props }, ref) => /* @__PURE__ */ jsx74("optgroup", { ref, ...props })
 );
 NativeSelectOptGroup.displayName = "NativeSelectOptGroup";
+
+// src/components/description-list.tsx
+import * as React70 from "react";
+import { jsx as jsx75, jsxs as jsxs42 } from "react/jsx-runtime";
+var DescriptionList = React70.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsx75(
+    "dl",
+    {
+      ref,
+      className: cn("divide-y divide-border rounded-lg border border-border bg-muted/20", className),
+      ...props
+    }
+  )
+);
+DescriptionList.displayName = "DescriptionList";
+var DescriptionListItem = React70.forwardRef(
+  ({ className, term, children, layout = "row", ...props }, ref) => /* @__PURE__ */ jsxs42(
+    "div",
+    {
+      ref,
+      className: cn("gap-3 px-3.5 py-2.5", layout === "row" ? "flex items-baseline" : "flex flex-col", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx75(
+          "dt",
+          {
+            className: cn(
+              "shrink-0 font-mono text-[10px] uppercase tracking-[0.14em] text-muted-foreground",
+              layout === "row" && "w-24"
+            ),
+            children: term
+          }
+        ),
+        /* @__PURE__ */ jsx75("dd", { className: "min-w-0 text-body-sm text-foreground", children })
+      ]
+    }
+  )
+);
+DescriptionListItem.displayName = "DescriptionListItem";
+
+// src/components/banner.tsx
+import * as React71 from "react";
+import { cva as cva20 } from "class-variance-authority";
+import { CircleAlert as CircleAlert3, CircleCheck as CircleCheck3, Info as Info3, TriangleAlert as TriangleAlert4, X as X8 } from "lucide-react";
+import { jsx as jsx76, jsxs as jsxs43 } from "react/jsx-runtime";
+var bannerVariants = cva20(
+  "flex w-full items-start gap-2.5 border-b px-4 py-3 text-body-sm font-sans [&>svg]:mt-0.5 [&>svg]:size-4 [&>svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        information: "border-info/20 bg-info/10 text-info",
+        warning: "border-warning/25 bg-warning/15 text-warning",
+        success: "border-success/25 bg-success/15 text-success",
+        error: "border-destructive/20 bg-destructive/10 text-destructive",
+        action: "border-transparent bg-foreground text-background"
+      },
+      sticky: {
+        true: "sticky top-0 z-40",
+        false: ""
+      }
+    },
+    defaultVariants: { variant: "information", sticky: false }
+  }
+);
+var ICON2 = {
+  information: Info3,
+  warning: TriangleAlert4,
+  success: CircleCheck3,
+  error: CircleAlert3,
+  action: Info3
+};
+var Banner = React71.forwardRef(
+  ({ className, variant = "information", sticky, hideIcon, onDismiss, action, children, ...props }, ref) => {
+    const Icon2 = ICON2[variant ?? "information"];
+    return /* @__PURE__ */ jsxs43("div", { ref, role: "banner", className: cn(bannerVariants({ variant, sticky }), className), ...props, children: [
+      !hideIcon && /* @__PURE__ */ jsx76(Icon2, {}),
+      /* @__PURE__ */ jsxs43("div", { className: "mx-auto flex min-w-0 max-w-4xl flex-1 flex-wrap items-center justify-center gap-x-3 gap-y-1 text-center", children: [
+        /* @__PURE__ */ jsx76("span", { children }),
+        action && /* @__PURE__ */ jsx76(
+          "button",
+          {
+            type: "button",
+            onClick: action.onClick,
+            className: "inline-flex shrink-0 items-center gap-1.5 text-label-md font-medium underline-offset-2 outline-none hover:underline focus-visible:underline",
+            children: action.label
+          }
+        )
+      ] }),
+      onDismiss && /* @__PURE__ */ jsx76(
+        "button",
+        {
+          type: "button",
+          onClick: onDismiss,
+          "aria-label": "Dismiss",
+          className: "-m-0.5 shrink-0 rounded-[2px] p-0.5 opacity-muted outline-none transition-opacity hover:opacity-visible focus-visible:opacity-visible focus-visible:ring-1 focus-visible:ring-current",
+          children: /* @__PURE__ */ jsx76(X8, { className: "size-3.5" })
+        }
+      )
+    ] });
+  }
+);
+Banner.displayName = "Banner";
+
+// src/components/segmented-control.tsx
+import * as React72 from "react";
+import * as ToggleGroupPrimitive2 from "@radix-ui/react-toggle-group";
+import { jsx as jsx77 } from "react/jsx-runtime";
+var SegmentedControl = React72.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx77(
+  ToggleGroupPrimitive2.Root,
+  {
+    ref,
+    type: "single",
+    className: cn("inline-flex items-center rounded-lg bg-muted p-1 font-sans", className),
+    ...props
+  }
+));
+SegmentedControl.displayName = "SegmentedControl";
+var SegmentedControlItem = React72.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx77(
+  ToggleGroupPrimitive2.Item,
+  {
+    ref,
+    className: cn(
+      "inline-flex flex-1 items-center justify-center whitespace-nowrap rounded-md px-3 py-1 text-label-md font-medium text-muted-foreground transition-all",
+      "outline-none focus-visible:ring-2 focus-visible:ring-ring",
+      "disabled:pointer-events-none disabled:opacity-disabled",
+      "data-[state=on]:bg-background data-[state=on]:text-foreground data-[state=on]:shadow-sm",
+      className
+    ),
+    ...props
+  }
+));
+SegmentedControlItem.displayName = "SegmentedControlItem";
+
+// src/components/timeline.tsx
+import * as React73 from "react";
+import { jsx as jsx78, jsxs as jsxs44 } from "react/jsx-runtime";
+var Body = ({ item, align }) => /* @__PURE__ */ jsxs44("div", { className: cn("pb-6", align === "right" && "text-right"), children: [
+  item.time && /* @__PURE__ */ jsx78("p", { className: "text-label-sm text-muted-foreground", children: item.time }),
+  /* @__PURE__ */ jsx78("p", { className: "text-label-md font-medium text-foreground", children: item.title }),
+  item.content && /* @__PURE__ */ jsx78("div", { className: "text-body-sm text-muted-foreground", children: item.content })
+] });
+var Rail = ({ item, isLast }) => /* @__PURE__ */ jsxs44("div", { className: "flex flex-col items-center", children: [
+  /* @__PURE__ */ jsx78("span", { className: "flex size-2.5 shrink-0 items-center justify-center rounded-full bg-primary", children: item.icon }),
+  !isLast && /* @__PURE__ */ jsx78("span", { "aria-hidden": true, className: "my-1 w-px flex-1 bg-border" })
+] });
+var Timeline = React73.forwardRef(
+  ({ className, items, alternating = false, ...props }, ref) => /* @__PURE__ */ jsx78("ol", { ref, className: cn("flex flex-col font-sans", className), ...props, children: items.map((item, i) => {
+    const isLast = i === items.length - 1;
+    if (!alternating) {
+      return /* @__PURE__ */ jsxs44("li", { className: "grid grid-cols-[auto_1fr] gap-x-3", children: [
+        /* @__PURE__ */ jsx78(Rail, { item, isLast }),
+        /* @__PURE__ */ jsx78(Body, { item, align: "left" })
+      ] }, i);
+    }
+    const onRight = i % 2 === 0;
+    return /* @__PURE__ */ jsxs44("li", { className: "grid grid-cols-[1fr_auto_1fr] gap-x-4", children: [
+      onRight ? /* @__PURE__ */ jsx78("div", {}) : /* @__PURE__ */ jsx78(Body, { item, align: "right" }),
+      /* @__PURE__ */ jsx78(Rail, { item, isLast }),
+      onRight ? /* @__PURE__ */ jsx78(Body, { item, align: "left" }) : /* @__PURE__ */ jsx78("div", {})
+    ] }, i);
+  }) })
+);
+Timeline.displayName = "Timeline";
 export {
   Accordion,
   AccordionContent,
@@ -4074,6 +4237,7 @@ export {
   AvatarGroup,
   AvatarImage,
   Badge,
+  Banner,
   Breadcrumb,
   BreadcrumbEllipsis,
   BreadcrumbItem,
@@ -4135,6 +4299,8 @@ export {
   ContextMenuTrigger,
   DataTable,
   DatePicker,
+  DescriptionList,
+  DescriptionListItem,
   Dialog,
   DialogClose,
   DialogContent,
@@ -4268,6 +4434,8 @@ export {
   ResizablePanelGroup,
   ScrollArea,
   ScrollBar,
+  SegmentedControl,
+  SegmentedControlItem,
   Select,
   SelectContent,
   SelectGroup,
@@ -4325,6 +4493,7 @@ export {
   TabsTrigger,
   Tag,
   Textarea,
+  Timeline,
   Toaster,
   Toggle,
   ToggleGroup,
@@ -4334,6 +4503,7 @@ export {
   TooltipProvider,
   TooltipTrigger,
   badgeVariants,
+  bannerVariants,
   buttonVariants,
   cn,
   emptyMediaVariants,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinetixui/ui",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "private": false,
   "description": "KinetixUI React components — CVA + Radix + Tailwind on the KinetixUI token contract. Also distributed via the kinetixui CLI as a component registry.",
   "keywords": [
@@ -90,7 +90,7 @@
     "react-dom": ">=18"
   },
   "devDependencies": {
-    "@kinetixui/tokens": "0.9.0",
+    "@kinetixui/tokens": "0.10.0",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.7",

package/src/components/banner.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+import { CircleAlert, CircleCheck, Info, TriangleAlert, X } from "lucide-react";
+import { cn } from "../lib/utils";
+
+/**
+ * Banner — a full-bleed, page-level notice (info/promo/maintenance),
+ * optionally dismissible and stickied to the top of the viewport. Distinct
+ * from `Alert` (in-flow, static) and `Sonner` (transient toast): Banner is
+ * edge-to-edge and persistent until dismissed. Distinct from `Inform`
+ * (contained, rounded inline card): Banner has no rounded corners or own
+ * width — it spans whatever it's placed in, typically the full viewport.
+ * Reuses `Inform`'s intent taxonomy and icon set for a consistent look.
+ * Gap-fill addition (not in the original Figma source).
+ */
+const bannerVariants = cva(
+  "flex w-full items-start gap-2.5 border-b px-4 py-3 text-body-sm font-sans [&>svg]:mt-0.5 [&>svg]:size-4 [&>svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        information: "border-info/20 bg-info/10 text-info",
+        warning: "border-warning/25 bg-warning/15 text-warning",
+        success: "border-success/25 bg-success/15 text-success",
+        error: "border-destructive/20 bg-destructive/10 text-destructive",
+        action: "border-transparent bg-foreground text-background",
+      },
+      sticky: {
+        true: "sticky top-0 z-40",
+        false: "",
+      },
+    },
+    defaultVariants: { variant: "information", sticky: false },
+  },
+);
+
+const ICON = {
+  information: Info,
+  warning: TriangleAlert,
+  success: CircleCheck,
+  error: CircleAlert,
+  action: Info,
+} as const;
+
+export interface BannerProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof bannerVariants> {
+  hideIcon?: boolean;
+  onDismiss?: () => void;
+  /** optional CTA rendered inline after the message */
+  action?: { label: React.ReactNode; onClick?: () => void };
+}
+
+const Banner = React.forwardRef<HTMLDivElement, BannerProps>(
+  ({ className, variant = "information", sticky, hideIcon, onDismiss, action, children, ...props }, ref) => {
+    const Icon = ICON[variant ?? "information"];
+    return (
+      <div ref={ref} role="banner" className={cn(bannerVariants({ variant, sticky }), className)} {...props}>
+        {!hideIcon && <Icon />}
+        <div className="mx-auto flex min-w-0 max-w-4xl flex-1 flex-wrap items-center justify-center gap-x-3 gap-y-1 text-center">
+          <span>{children}</span>
+          {action && (
+            <button
+              type="button"
+              onClick={action.onClick}
+              className="inline-flex shrink-0 items-center gap-1.5 text-label-md font-medium underline-offset-2 outline-none hover:underline focus-visible:underline"
+            >
+              {action.label}
+            </button>
+          )}
+        </div>
+        {onDismiss && (
+          <button
+            type="button"
+            onClick={onDismiss}
+            aria-label="Dismiss"
+            className="-m-0.5 shrink-0 rounded-[2px] p-0.5 opacity-muted outline-none transition-opacity hover:opacity-visible focus-visible:opacity-visible focus-visible:ring-1 focus-visible:ring-current"
+          >
+            <X className="size-3.5" />
+          </button>
+        )}
+      </div>
+    );
+  },
+);
+Banner.displayName = "Banner";
+
+export { Banner, bannerVariants };

package/src/components/description-list.tsx

@@ -0,0 +1,52 @@
+"use client";
+
+import * as React from "react";
+import { cn } from "../lib/utils";
+
+/**
+ * DescriptionList — `<dl>` term/detail rows with the site's own spec-sheet
+ * skin (mono, uppercase, tracked term labels; a divided rounded shell).
+ * Lifted out of two hand-rolled call sites — `ComponentMeta`'s doc-page
+ * spec strip and the homepage's "spec" card — into a reusable component.
+ * Gap-fill addition (not in the original Figma source).
+ */
+const DescriptionList = React.forwardRef<HTMLDListElement, React.HTMLAttributes<HTMLDListElement>>(
+  ({ className, ...props }, ref) => (
+    <dl
+      ref={ref}
+      className={cn("divide-y divide-border rounded-lg border border-border bg-muted/20", className)}
+      {...props}
+    />
+  ),
+);
+DescriptionList.displayName = "DescriptionList";
+
+export interface DescriptionListItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  term: React.ReactNode;
+  children: React.ReactNode;
+  /** `row` (default) puts the term and value side by side; `stacked` puts the value below a full-width term — better for long values. */
+  layout?: "row" | "stacked";
+}
+
+const DescriptionListItem = React.forwardRef<HTMLDivElement, DescriptionListItemProps>(
+  ({ className, term, children, layout = "row", ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn("gap-3 px-3.5 py-2.5", layout === "row" ? "flex items-baseline" : "flex flex-col", className)}
+      {...props}
+    >
+      <dt
+        className={cn(
+          "shrink-0 font-mono text-[10px] uppercase tracking-[0.14em] text-muted-foreground",
+          layout === "row" && "w-24",
+        )}
+      >
+        {term}
+      </dt>
+      <dd className="min-w-0 text-body-sm text-foreground">{children}</dd>
+    </div>
+  ),
+);
+DescriptionListItem.displayName = "DescriptionListItem";
+
+export { DescriptionList, DescriptionListItem };

package/src/components/segmented-control.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import * as React from "react";
+import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { cn } from "../lib/utils";
+
+/**
+ * SegmentedControl — an iOS-style single-select strip. Functionally
+ * `ToggleGroup type="single"`: a thin, documented preset over the same
+ * Radix primitive with the segmented look (`Tabs`' `TabsList`/
+ * `TabsTrigger` visual treatment — filled track, raised active segment)
+ * instead of `Toggle`'s individually-outlined-button look. `type="single"`
+ * is fixed, not exposed — a segmented control that could go fully
+ * unselected or multi-select isn't the pattern. Gap-fill addition (not in
+ * the original Figma source).
+ */
+export type SegmentedControlProps = Omit<ToggleGroupPrimitive.ToggleGroupSingleProps, "type">;
+
+const SegmentedControl = React.forwardRef<
+  React.ElementRef<typeof ToggleGroupPrimitive.Root>,
+  SegmentedControlProps
+>(({ className, ...props }, ref) => (
+  <ToggleGroupPrimitive.Root
+    ref={ref}
+    type="single"
+    className={cn("inline-flex items-center rounded-lg bg-muted p-1 font-sans", className)}
+    {...props}
+  />
+));
+SegmentedControl.displayName = "SegmentedControl";
+
+const SegmentedControlItem = React.forwardRef<
+  React.ElementRef<typeof ToggleGroupPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Item>
+>(({ className, ...props }, ref) => (
+  <ToggleGroupPrimitive.Item
+    ref={ref}
+    className={cn(
+      "inline-flex flex-1 items-center justify-center whitespace-nowrap rounded-md px-3 py-1 text-label-md font-medium text-muted-foreground transition-all",
+      "outline-none focus-visible:ring-2 focus-visible:ring-ring",
+      "disabled:pointer-events-none disabled:opacity-disabled",
+      "data-[state=on]:bg-background data-[state=on]:text-foreground data-[state=on]:shadow-sm",
+      className,
+    )}
+    {...props}
+  />
+));
+SegmentedControlItem.displayName = "SegmentedControlItem";
+
+export { SegmentedControl, SegmentedControlItem };

package/src/components/timeline.tsx

@@ -0,0 +1,70 @@
+"use client";
+
+import * as React from "react";
+import { cn } from "../lib/utils";
+
+/**
+ * Timeline — ordered events down a rail (dot, connector, time, content).
+ * `alternating` lays content left/right of a centered rail (desktop);
+ * the default is a single left-aligned rail. Same rail/dot/connector
+ * technique as `Stepper`, but for a history/activity log rather than a
+ * progress indicator — no complete/current/upcoming states, an array of
+ * arbitrary events instead. Gap-fill addition (not in the original Figma
+ * source).
+ */
+export interface TimelineItem {
+  time?: React.ReactNode;
+  title: React.ReactNode;
+  content?: React.ReactNode;
+  /** custom dot content — defaults to a filled circle */
+  icon?: React.ReactNode;
+}
+
+export interface TimelineProps extends React.HTMLAttributes<HTMLOListElement> {
+  items: TimelineItem[];
+  alternating?: boolean;
+}
+
+const Body = ({ item, align }: { item: TimelineItem; align: "left" | "right" }) => (
+  <div className={cn("pb-6", align === "right" && "text-right")}>
+    {item.time && <p className="text-label-sm text-muted-foreground">{item.time}</p>}
+    <p className="text-label-md font-medium text-foreground">{item.title}</p>
+    {item.content && <div className="text-body-sm text-muted-foreground">{item.content}</div>}
+  </div>
+);
+
+const Rail = ({ item, isLast }: { item: TimelineItem; isLast: boolean }) => (
+  <div className="flex flex-col items-center">
+    <span className="flex size-2.5 shrink-0 items-center justify-center rounded-full bg-primary">{item.icon}</span>
+    {!isLast && <span aria-hidden className="my-1 w-px flex-1 bg-border" />}
+  </div>
+);
+
+const Timeline = React.forwardRef<HTMLOListElement, TimelineProps>(
+  ({ className, items, alternating = false, ...props }, ref) => (
+    <ol ref={ref} className={cn("flex flex-col font-sans", className)} {...props}>
+      {items.map((item, i) => {
+        const isLast = i === items.length - 1;
+        if (!alternating) {
+          return (
+            <li key={i} className="grid grid-cols-[auto_1fr] gap-x-3">
+              <Rail item={item} isLast={isLast} />
+              <Body item={item} align="left" />
+            </li>
+          );
+        }
+        const onRight = i % 2 === 0;
+        return (
+          <li key={i} className="grid grid-cols-[1fr_auto_1fr] gap-x-4">
+            {onRight ? <div /> : <Body item={item} align="right" />}
+            <Rail item={item} isLast={isLast} />
+            {onRight ? <Body item={item} align="left" /> : <div />}
+          </li>
+        );
+      })}
+    </ol>
+  ),
+);
+Timeline.displayName = "Timeline";
+
+export { Timeline };

package/src/index.ts

@@ -339,5 +339,17 @@ export {
   type NativeSelectOptionProps,
   type NativeSelectOptGroupProps,
 } from "./components/native-select";
+export {
+  DescriptionList,
+  DescriptionListItem,
+  type DescriptionListItemProps,
+} from "./components/description-list";
+export { Banner, bannerVariants, type BannerProps } from "./components/banner";
+export {
+  SegmentedControl,
+  SegmentedControlItem,
+  type SegmentedControlProps,
+} from "./components/segmented-control";
+export { Timeline, type TimelineItem, type TimelineProps } from "./components/timeline";
 
 export { cn } from "./lib/utils";

package/src/stories/Banner.stories.tsx

@@ -0,0 +1,28 @@
+/* AUTO-GENERATED by scripts/gen-stories.mjs — do not edit.
+   Source of truth: apps/web/src/registry/demos.tsx */
+import * as React from "react";
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Banner } from "@kinetixui/ui";
+
+const Demo = () => (
+    <div className="flex w-full flex-col gap-3">
+      <Banner variant="information" onDismiss={() => {}} action={{ label: "Learn more" }}>
+        A new version of KinetixUI is available.
+      </Banner>
+      <Banner variant="action" action={{ label: "Upgrade" }}>
+        You&rsquo;re on the free plan — upgrade for unlimited projects.
+      </Banner>
+    </div>
+  );
+
+const meta = {
+  title: "Feedback/Banner",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<Banner variant=\"information\" onDismiss={close} action={{ label: \"Learn more\" }}>\\n  A new version of KinetixUI is available.\\n</Banner>", language: "tsx" } },
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const Default: StoryObj<typeof meta> = { render: () => <Demo /> };

package/src/stories/DescriptionList.stories.tsx

@@ -0,0 +1,26 @@
+/* AUTO-GENERATED by scripts/gen-stories.mjs — do not edit.
+   Source of truth: apps/web/src/registry/demos.tsx */
+import * as React from "react";
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Avatar, DescriptionList, DescriptionListItem } from "@kinetixui/ui";
+
+const Demo = () => (
+    <DescriptionList className="w-full max-w-sm">
+      <DescriptionListItem term="Category">Data Display</DescriptionListItem>
+      <DescriptionListItem term="Built on">Radix Avatar</DescriptionListItem>
+      <DescriptionListItem term="Platforms">React, SwiftUI, Compose, Flutter</DescriptionListItem>
+      <DescriptionListItem term="CLI">npx @kinetixui/cli add avatar</DescriptionListItem>
+    </DescriptionList>
+  );
+
+const meta = {
+  title: "Data Display/DescriptionList",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<DescriptionList>\\n  <DescriptionListItem term=\"Category\">Data Display</DescriptionListItem>\\n  <DescriptionListItem term=\"Built on\">Radix Avatar</DescriptionListItem>\\n</DescriptionList>", language: "tsx" } },
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const Default: StoryObj<typeof meta> = { render: () => <Demo /> };

package/src/stories/SegmentedControl.stories.tsx

@@ -0,0 +1,25 @@
+/* AUTO-GENERATED by scripts/gen-stories.mjs — do not edit.
+   Source of truth: apps/web/src/registry/demos.tsx */
+import * as React from "react";
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { List, SegmentedControl, SegmentedControlItem } from "@kinetixui/ui";
+
+const Demo = () => (
+    <SegmentedControl defaultValue="grid" className="w-full max-w-xs">
+      <SegmentedControlItem value="list">List</SegmentedControlItem>
+      <SegmentedControlItem value="grid">Grid</SegmentedControlItem>
+      <SegmentedControlItem value="board">Board</SegmentedControlItem>
+    </SegmentedControl>
+  );
+
+const meta = {
+  title: "Controls & Actions/SegmentedControl",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<SegmentedControl defaultValue=\"grid\">\\n  <SegmentedControlItem value=\"list\">List</SegmentedControlItem>\\n  <SegmentedControlItem value=\"grid\">Grid</SegmentedControlItem>\\n  <SegmentedControlItem value=\"board\">Board</SegmentedControlItem>\\n</SegmentedControl>", language: "tsx" } },
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const Default: StoryObj<typeof meta> = { render: () => <Demo /> };

package/src/stories/Timeline.stories.tsx

@@ -0,0 +1,28 @@
+/* AUTO-GENERATED by scripts/gen-stories.mjs — do not edit.
+   Source of truth: apps/web/src/registry/demos.tsx */
+import * as React from "react";
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { SegmentedControl, Timeline } from "@kinetixui/ui";
+
+const Demo = () => (
+    <Timeline
+      className="w-full max-w-sm"
+      items={[
+        { time: "2 hours ago", title: "Deployed to production", content: "v0.9.0 shipped." },
+        { time: "Yesterday", title: "Opened PR #100", content: "feat(ui): add SegmentedControl" },
+        { time: "3 days ago", title: "Project created" },
+      ]}
+    />
+  );
+
+const meta = {
+  title: "Data Display/Timeline",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<Timeline\\n  items={[\\n    { time: \"2 hours ago\", title: \"Deployed to production\", content: \"v0.9.0 shipped.\" },\\n    { time: \"Yesterday\", title: \"Opened PR #100\" },\\n  ]}\\n/>", language: "tsx" } },
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const Default: StoryObj<typeof meta> = { render: () => <Demo /> };