@kinetixui/ui 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -1295,7 +1295,143 @@ 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>>;
+
+/**
+ * Marquee — an auto-scrolling horizontal ticker (logo strip, testimonials),
+ * pausing on hover and respecting `prefers-reduced-motion`. Lifted out of
+ * the marketing site's `reveal.tsx` (`.kx-marquee`/`.kx-marquee-track` in
+ * its `globals.css`) into a portable component: the site version leaned on
+ * a hand-written CSS file a CLI-installed app wouldn't have, so this port
+ * moves the keyframe onto the shared Tailwind preset (`animate-marquee`,
+ * `motion-reduce:animate-none`) instead. Also fixes an accessibility gap
+ * in the site version, which marked *both* content copies `aria-hidden`
+ * (hiding the marquee from screen readers entirely) — only the duplicate
+ * copy needed for the seamless loop is hidden here; the first copy stays
+ * in the accessible DOM flow. Gap-fill addition (not in the original
+ * Figma source).
+ */
+interface MarqueeProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** seconds for one full loop */
+    durationSeconds?: number;
+    pauseOnHover?: boolean;
+}
+declare const Marquee: React$1.ForwardRefExoticComponent<MarqueeProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * ComparisonSlider — a drag handle wiping between two stacked layers
+ * (before/after image, redesign preview, …). Built on Radix's `Slider`
+ * for the drag + keyboard + ARIA behavior (a plain 0–100 value), but
+ * fully custom-drawn: Radix's own `Range` fill can't be reused as the
+ * divider line (it's Radix's own inline `width` style, which would win
+ * over any Tailwind width class), so the line is a separate element
+ * positioned from the same value instead. Gap-fill addition (not in the
+ * original Figma source).
+ */
+interface ComparisonSliderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    before: React$1.ReactNode;
+    after: React$1.ReactNode;
+    beforeLabel?: React$1.ReactNode;
+    afterLabel?: React$1.ReactNode;
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (value: number) => void;
+}
+declare const ComparisonSlider: React$1.ForwardRefExoticComponent<ComparisonSliderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PageHeader — title + optional breadcrumb + description + action
+ * cluster + optional tabs row. A recipe every docs/app screen re-lays
+ * out by hand; `breadcrumb`/`actions`/`tabs` are plain slots so callers
+ * compose their own `Breadcrumb`/`Button`/`Tabs` (or `SegmentedControl`)
+ * into them rather than PageHeader re-implementing any of those. Gap-fill
+ * addition (not in the original Figma source).
+ */
+interface PageHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title"> {
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    breadcrumb?: React$1.ReactNode;
+    actions?: React$1.ReactNode;
+    tabs?: React$1.ReactNode;
+}
+declare const PageHeader: React$1.ForwardRefExoticComponent<PageHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /** 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, ComparisonSlider, type ComparisonSliderProps, 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, Marquee, type MarqueeProps, 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, PageHeader, type PageHeaderProps, 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,293 @@ 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";
+
+// src/components/marquee.tsx
+import * as React74 from "react";
+import { jsx as jsx79, jsxs as jsxs45 } from "react/jsx-runtime";
+var Marquee = React74.forwardRef(
+  ({ className, children, durationSeconds = 32, pauseOnHover = true, style, ...props }, ref) => /* @__PURE__ */ jsx79(
+    "div",
+    {
+      ref,
+      className: cn(
+        "group relative flex overflow-hidden",
+        "[mask-image:linear-gradient(90deg,transparent,black_8%,black_92%,transparent)]",
+        className
+      ),
+      style: { ["--marquee-duration"]: `${durationSeconds}s`, ...style },
+      ...props,
+      children: /* @__PURE__ */ jsxs45(
+        "div",
+        {
+          className: cn(
+            "flex w-max animate-marquee motion-reduce:animate-none",
+            pauseOnHover && "group-hover:[animation-play-state:paused]"
+          ),
+          children: [
+            /* @__PURE__ */ jsx79("div", { className: "flex shrink-0 items-center", children }),
+            /* @__PURE__ */ jsx79("div", { "aria-hidden": "true", className: "flex shrink-0 items-center", children })
+          ]
+        }
+      )
+    }
+  )
+);
+Marquee.displayName = "Marquee";
+
+// src/components/comparison-slider.tsx
+import * as React75 from "react";
+import * as SliderPrimitive2 from "@radix-ui/react-slider";
+import { GripVertical as GripVertical2 } from "lucide-react";
+import { jsx as jsx80, jsxs as jsxs46 } from "react/jsx-runtime";
+var ComparisonSlider = React75.forwardRef(
+  ({ className, before, after, beforeLabel, afterLabel, value, defaultValue = 50, onValueChange, ...props }, ref) => {
+    const [internal, setInternal] = React75.useState(defaultValue);
+    const current = value ?? internal;
+    const handleChange = (vals) => {
+      const v = vals[0] ?? current;
+      setInternal(v);
+      onValueChange?.(v);
+    };
+    return /* @__PURE__ */ jsxs46(
+      "div",
+      {
+        ref,
+        className: cn(
+          "relative aspect-video w-full select-none overflow-hidden rounded-md bg-muted font-sans",
+          "[&_img]:size-full [&_img]:object-cover [&_video]:size-full [&_video]:object-cover",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx80("div", { className: "absolute inset-0", children: before }),
+          /* @__PURE__ */ jsx80("div", { className: "absolute inset-0 overflow-hidden", style: { clipPath: `inset(0 0 0 ${current}%)` }, children: after }),
+          /* @__PURE__ */ jsx80(
+            "div",
+            {
+              "aria-hidden": true,
+              className: "absolute inset-y-0 w-0.5 -translate-x-1/2 bg-background shadow-sm",
+              style: { left: `${current}%` }
+            }
+          ),
+          beforeLabel && /* @__PURE__ */ jsx80("span", { className: "absolute left-2 top-2 rounded bg-background/80 px-2 py-0.5 text-label-sm text-foreground backdrop-blur-sm", children: beforeLabel }),
+          afterLabel && /* @__PURE__ */ jsx80("span", { className: "absolute right-2 top-2 rounded bg-background/80 px-2 py-0.5 text-label-sm text-foreground backdrop-blur-sm", children: afterLabel }),
+          /* @__PURE__ */ jsxs46(
+            SliderPrimitive2.Root,
+            {
+              value: [current],
+              onValueChange: handleChange,
+              max: 100,
+              step: 0.1,
+              className: "absolute inset-0 flex touch-none items-center",
+              children: [
+                /* @__PURE__ */ jsx80(SliderPrimitive2.Track, { className: "relative h-full w-full grow bg-transparent", children: /* @__PURE__ */ jsx80(SliderPrimitive2.Range, { className: "absolute h-full bg-transparent" }) }),
+                /* @__PURE__ */ jsx80(
+                  SliderPrimitive2.Thumb,
+                  {
+                    "aria-label": "Comparison position",
+                    className: "flex size-8 shrink-0 items-center justify-center rounded-full border-2 border-background bg-background/90 text-foreground shadow-md outline-none focus-visible:ring-2 focus-visible:ring-ring",
+                    children: /* @__PURE__ */ jsx80(GripVertical2, { className: "size-4" })
+                  }
+                )
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+ComparisonSlider.displayName = "ComparisonSlider";
+
+// src/components/page-header.tsx
+import * as React76 from "react";
+import { jsx as jsx81, jsxs as jsxs47 } from "react/jsx-runtime";
+var PageHeader = React76.forwardRef(
+  ({ className, title, description, breadcrumb, actions, tabs, ...props }, ref) => /* @__PURE__ */ jsxs47(
+    "div",
+    {
+      ref,
+      className: cn("flex flex-col gap-4 border-b border-border pb-6 font-sans", className),
+      ...props,
+      children: [
+        breadcrumb && /* @__PURE__ */ jsx81("div", { className: "text-body-sm", children: breadcrumb }),
+        /* @__PURE__ */ jsxs47("div", { className: "flex flex-wrap items-start justify-between gap-4", children: [
+          /* @__PURE__ */ jsxs47("div", { className: "flex min-w-0 flex-col gap-1", children: [
+            /* @__PURE__ */ jsx81("h1", { className: "text-headline-sm font-medium text-foreground", children: title }),
+            description && /* @__PURE__ */ jsx81("p", { className: "text-body-md text-muted-foreground", children: description })
+          ] }),
+          actions && /* @__PURE__ */ jsx81("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: actions })
+        ] }),
+        tabs && /* @__PURE__ */ jsx81("div", { className: "-mb-6", children: tabs })
+      ]
+    }
+  )
+);
+PageHeader.displayName = "PageHeader";
 export {
   Accordion,
   AccordionContent,
@@ -4074,6 +4361,7 @@ export {
   AvatarGroup,
   AvatarImage,
   Badge,
+  Banner,
   Breadcrumb,
   BreadcrumbEllipsis,
   BreadcrumbItem,
@@ -4118,6 +4406,7 @@ export {
   CommandList,
   CommandSeparator,
   CommandShortcut,
+  ComparisonSlider,
   ContextMenu,
   ContextMenuCheckboxItem,
   ContextMenuContent,
@@ -4135,6 +4424,8 @@ export {
   ContextMenuTrigger,
   DataTable,
   DatePicker,
+  DescriptionList,
+  DescriptionListItem,
   Dialog,
   DialogClose,
   DialogContent,
@@ -4215,6 +4506,7 @@ export {
   Label2 as Label,
   List3 as List,
   ListItem,
+  Marquee,
   Menubar,
   MenubarCheckboxItem,
   MenubarContent,
@@ -4246,6 +4538,7 @@ export {
   NavigationMenuTrigger,
   NavigationMenuViewport,
   NumberInput,
+  PageHeader,
   Pagination,
   PaginationContent,
   PaginationEllipsis,
@@ -4268,6 +4561,8 @@ export {
   ResizablePanelGroup,
   ScrollArea,
   ScrollBar,
+  SegmentedControl,
+  SegmentedControlItem,
   Select,
   SelectContent,
   SelectGroup,
@@ -4325,6 +4620,7 @@ export {
   TabsTrigger,
   Tag,
   Textarea,
+  Timeline,
   Toaster,
   Toggle,
   ToggleGroup,
@@ -4334,6 +4630,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.11.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.11.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/comparison-slider.tsx

@@ -0,0 +1,98 @@
+"use client";
+
+import * as React from "react";
+import * as SliderPrimitive from "@radix-ui/react-slider";
+import { GripVertical } from "lucide-react";
+import { cn } from "../lib/utils";
+
+/**
+ * ComparisonSlider — a drag handle wiping between two stacked layers
+ * (before/after image, redesign preview, …). Built on Radix's `Slider`
+ * for the drag + keyboard + ARIA behavior (a plain 0–100 value), but
+ * fully custom-drawn: Radix's own `Range` fill can't be reused as the
+ * divider line (it's Radix's own inline `width` style, which would win
+ * over any Tailwind width class), so the line is a separate element
+ * positioned from the same value instead. Gap-fill addition (not in the
+ * original Figma source).
+ */
+export interface ComparisonSliderProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+  before: React.ReactNode;
+  after: React.ReactNode;
+  beforeLabel?: React.ReactNode;
+  afterLabel?: React.ReactNode;
+  value?: number;
+  defaultValue?: number;
+  onValueChange?: (value: number) => void;
+}
+
+const ComparisonSlider = React.forwardRef<HTMLDivElement, ComparisonSliderProps>(
+  (
+    { className, before, after, beforeLabel, afterLabel, value, defaultValue = 50, onValueChange, ...props },
+    ref,
+  ) => {
+    const [internal, setInternal] = React.useState(defaultValue);
+    const current = value ?? internal;
+
+    const handleChange = (vals: number[]) => {
+      const v = vals[0] ?? current;
+      setInternal(v);
+      onValueChange?.(v);
+    };
+
+    return (
+      <div
+        ref={ref}
+        className={cn(
+          "relative aspect-video w-full select-none overflow-hidden rounded-md bg-muted font-sans",
+          "[&_img]:size-full [&_img]:object-cover [&_video]:size-full [&_video]:object-cover",
+          className,
+        )}
+        {...props}
+      >
+        <div className="absolute inset-0">{before}</div>
+        <div className="absolute inset-0 overflow-hidden" style={{ clipPath: `inset(0 0 0 ${current}%)` }}>
+          {after}
+        </div>
+
+        <div
+          aria-hidden
+          className="absolute inset-y-0 w-0.5 -translate-x-1/2 bg-background shadow-sm"
+          style={{ left: `${current}%` }}
+        />
+
+        {beforeLabel && (
+          <span className="absolute left-2 top-2 rounded bg-background/80 px-2 py-0.5 text-label-sm text-foreground backdrop-blur-sm">
+            {beforeLabel}
+          </span>
+        )}
+        {afterLabel && (
+          <span className="absolute right-2 top-2 rounded bg-background/80 px-2 py-0.5 text-label-sm text-foreground backdrop-blur-sm">
+            {afterLabel}
+          </span>
+        )}
+
+        <SliderPrimitive.Root
+          value={[current]}
+          onValueChange={handleChange}
+          max={100}
+          step={0.1}
+          className="absolute inset-0 flex touch-none items-center"
+        >
+          <SliderPrimitive.Track className="relative h-full w-full grow bg-transparent">
+            <SliderPrimitive.Range className="absolute h-full bg-transparent" />
+          </SliderPrimitive.Track>
+          <SliderPrimitive.Thumb
+            aria-label="Comparison position"
+            className="flex size-8 shrink-0 items-center justify-center rounded-full border-2 border-background bg-background/90 text-foreground shadow-md outline-none focus-visible:ring-2 focus-visible:ring-ring"
+          >
+            <GripVertical className="size-4" />
+          </SliderPrimitive.Thumb>
+        </SliderPrimitive.Root>
+      </div>
+    );
+  },
+);
+ComparisonSlider.displayName = "ComparisonSlider";
+
+export { ComparisonSlider };

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/marquee.tsx

@@ -0,0 +1,57 @@
+"use client";
+
+import * as React from "react";
+import { cn } from "../lib/utils";
+
+/**
+ * Marquee — an auto-scrolling horizontal ticker (logo strip, testimonials),
+ * pausing on hover and respecting `prefers-reduced-motion`. Lifted out of
+ * the marketing site's `reveal.tsx` (`.kx-marquee`/`.kx-marquee-track` in
+ * its `globals.css`) into a portable component: the site version leaned on
+ * a hand-written CSS file a CLI-installed app wouldn't have, so this port
+ * moves the keyframe onto the shared Tailwind preset (`animate-marquee`,
+ * `motion-reduce:animate-none`) instead. Also fixes an accessibility gap
+ * in the site version, which marked *both* content copies `aria-hidden`
+ * (hiding the marquee from screen readers entirely) — only the duplicate
+ * copy needed for the seamless loop is hidden here; the first copy stays
+ * in the accessible DOM flow. Gap-fill addition (not in the original
+ * Figma source).
+ */
+export interface MarqueeProps extends React.HTMLAttributes<HTMLDivElement> {
+  /** seconds for one full loop */
+  durationSeconds?: number;
+  pauseOnHover?: boolean;
+}
+
+const Marquee = React.forwardRef<HTMLDivElement, MarqueeProps>(
+  ({ className, children, durationSeconds = 32, pauseOnHover = true, style, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn(
+        "group relative flex overflow-hidden",
+        "[mask-image:linear-gradient(90deg,transparent,black_8%,black_92%,transparent)]",
+        className,
+      )}
+      style={{ ["--marquee-duration" as string]: `${durationSeconds}s`, ...style }}
+      {...props}
+    >
+      {/* the track is 2x content width (two copies side by side); animating it
+          exactly -50% of its own width moves it one content-width, which is
+          what makes the loop seamless when it snaps back to 0. */}
+      <div
+        className={cn(
+          "flex w-max animate-marquee motion-reduce:animate-none",
+          pauseOnHover && "group-hover:[animation-play-state:paused]",
+        )}
+      >
+        <div className="flex shrink-0 items-center">{children}</div>
+        <div aria-hidden="true" className="flex shrink-0 items-center">
+          {children}
+        </div>
+      </div>
+    </div>
+  ),
+);
+Marquee.displayName = "Marquee";
+
+export { Marquee };

package/src/components/page-header.tsx

@@ -0,0 +1,43 @@
+"use client";
+
+import * as React from "react";
+import { cn } from "../lib/utils";
+
+/**
+ * PageHeader — title + optional breadcrumb + description + action
+ * cluster + optional tabs row. A recipe every docs/app screen re-lays
+ * out by hand; `breadcrumb`/`actions`/`tabs` are plain slots so callers
+ * compose their own `Breadcrumb`/`Button`/`Tabs` (or `SegmentedControl`)
+ * into them rather than PageHeader re-implementing any of those. Gap-fill
+ * addition (not in the original Figma source).
+ */
+export interface PageHeaderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+  title: React.ReactNode;
+  description?: React.ReactNode;
+  breadcrumb?: React.ReactNode;
+  actions?: React.ReactNode;
+  tabs?: React.ReactNode;
+}
+
+const PageHeader = React.forwardRef<HTMLDivElement, PageHeaderProps>(
+  ({ className, title, description, breadcrumb, actions, tabs, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn("flex flex-col gap-4 border-b border-border pb-6 font-sans", className)}
+      {...props}
+    >
+      {breadcrumb && <div className="text-body-sm">{breadcrumb}</div>}
+      <div className="flex flex-wrap items-start justify-between gap-4">
+        <div className="flex min-w-0 flex-col gap-1">
+          <h1 className="text-headline-sm font-medium text-foreground">{title}</h1>
+          {description && <p className="text-body-md text-muted-foreground">{description}</p>}
+        </div>
+        {actions && <div className="flex shrink-0 flex-wrap items-center gap-2">{actions}</div>}
+      </div>
+      {tabs && <div className="-mb-6">{tabs}</div>}
+    </div>
+  ),
+);
+PageHeader.displayName = "PageHeader";
+
+export { PageHeader };

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,20 @@ 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 { Marquee, type MarqueeProps } from "./components/marquee";
+export { ComparisonSlider, type ComparisonSliderProps } from "./components/comparison-slider";
+export { PageHeader, type PageHeaderProps } from "./components/page-header";
 
 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/ComparisonSlider.stories.tsx

@@ -0,0 +1,27 @@
+/* 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 { ComparisonSlider } from "@kinetixui/ui";
+
+const Demo = () => (
+    <ComparisonSlider
+      className="w-full max-w-md"
+      beforeLabel="Before"
+      afterLabel="After"
+      before={<div className="flex size-full items-center justify-center bg-muted text-body-sm text-muted-foreground">Original</div>}
+      after={<div className="flex size-full items-center justify-center bg-primary/15 text-body-sm text-primary">Redesign</div>}
+    />
+  );
+
+const meta = {
+  title: "Controls & Actions/ComparisonSlider",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<ComparisonSlider\\n  beforeLabel=\"Before\"\\n  afterLabel=\"After\"\\n  before={<img src=\"/before.jpg\" alt=\"\" />}\\n  after={<img src=\"/after.jpg\" alt=\"\" />}\\n/>", 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/Marquee.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 { Marquee } from "@kinetixui/ui";
+
+const Demo = () => (
+    <Marquee durationSeconds={18} className="w-full max-w-md">
+      {["React", "SwiftUI", "Jetpack Compose", "Flutter"].map((p) => (
+        <span key={p} className="flex items-center gap-2 px-4 text-body-sm text-muted-foreground">
+          <span className="size-1.5 rounded-full bg-primary" />
+          {p}
+        </span>
+      ))}
+    </Marquee>
+  );
+
+const meta = {
+  title: "Data Display/Marquee",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<Marquee durationSeconds={18}>\\n  {items.map((item) => (\\n    <span key={item}>{item}</span>\\n  ))}\\n</Marquee>", language: "tsx" } },
+  },
+} satisfies Meta;
+
+export default meta;
+
+export const Default: StoryObj<typeof meta> = { render: () => <Demo /> };

package/src/stories/PageHeader.stories.tsx

@@ -0,0 +1,47 @@
+/* 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 { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, PageHeader } from "@kinetixui/ui";
+import { Settings } from "lucide-react";
+
+const Demo = () => (
+    <PageHeader
+      className="w-full"
+      breadcrumb={
+        <Breadcrumb>
+          <BreadcrumbList>
+            <BreadcrumbItem>
+              <BreadcrumbLink href="#">Projects</BreadcrumbLink>
+            </BreadcrumbItem>
+            <BreadcrumbSeparator />
+            <BreadcrumbItem>
+              <BreadcrumbPage>KinetixUI</BreadcrumbPage>
+            </BreadcrumbItem>
+          </BreadcrumbList>
+        </Breadcrumb>
+      }
+      title="KinetixUI"
+      description="One token architecture, in motion across every platform."
+      actions={
+        <>
+          <Button variant="Outline" size="sm">
+            Settings
+          </Button>
+          <Button size="sm">Deploy</Button>
+        </>
+      }
+    />
+  );
+
+const meta = {
+  title: "Navigation/PageHeader",
+  parameters: {
+    layout: "centered",
+    docs: { source: { code: "<PageHeader\\n  breadcrumb={<Breadcrumb>...</Breadcrumb>}\\n  title=\"KinetixUI\"\\n  description=\"One token architecture, in motion across every platform.\"\\n  actions={<><Button variant=\"Outline\" size=\"sm\">Settings</Button><Button size=\"sm\">Deploy</Button></>}\\n/>", 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 /> };

package/tailwind.config.ts

@@ -127,11 +127,13 @@ export default {
         "accordion-down": { from: { height: "0" }, to: { height: "var(--radix-accordion-content-height)" } },
         "accordion-up": { from: { height: "var(--radix-accordion-content-height)" }, to: { height: "0" } },
         "caret-blink": { "0%,70%,100%": { opacity: "1" }, "20%,50%": { opacity: "0" } },
+        marquee: { from: { transform: "translateX(0)" }, to: { transform: "translateX(-50%)" } },
       },
       animation: {
         "accordion-down": "accordion-down 0.2s ease-out",
         "accordion-up": "accordion-up 0.2s ease-out",
         "caret-blink": "caret-blink 1.25s ease-out infinite",
+        marquee: "marquee var(--marquee-duration, 32s) linear infinite",
       },
     },
   },