@ship-it-ui/ui 0.0.2 → 0.0.4

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ClassValue } from 'clsx';
 export { ClassValue } from 'clsx';
 import * as react from 'react';
-import { useEffect, KeyboardEvent, RefObject, ButtonHTMLAttributes, ReactNode, HTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, AnchorHTMLAttributes, Ref, FC, SVGAttributes } from 'react';
+import { useEffect, KeyboardEvent, RefObject, ButtonHTMLAttributes, ReactNode, HTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes, AnchorHTMLAttributes, Ref, LabelHTMLAttributes, FC, SVGAttributes } from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as RadixCheckbox from '@radix-ui/react-checkbox';
@@ -593,6 +593,37 @@ type KbdProps = HTMLAttributes<HTMLElement>;
  */
 declare const Kbd: react.ForwardRefExoticComponent<KbdProps & react.RefAttributes<HTMLElement>>;
 
+/**
+ * ScrollArea — token-styled scrollbar primitive built on
+ * `@radix-ui/react-scroll-area`. Wraps a viewport with custom scrollbars that
+ * match the design tokens (`--color-text-muted` thumb on `--color-panel-2`
+ * track) and behave consistently across platforms.
+ *
+ * Defaults to `type="hover"` so scrollbars fade in only when the pointer is
+ * over the area, matching the system feel without the OS-default chrome.
+ */
+type ScrollAreaType = 'auto' | 'always' | 'scroll' | 'hover';
+interface ScrollAreaProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onScroll' | 'dir'> {
+    /** Scrollbar visibility behavior. Default `'hover'`. */
+    type?: ScrollAreaType;
+    /** Which scrollbars to render. Default `'vertical'`. */
+    orientation?: 'vertical' | 'horizontal' | 'both';
+    /** Time in ms before scrollbar hides after the last interaction (auto/scroll/hover). */
+    scrollHideDelay?: number;
+    /** Class applied to the inner viewport rather than the outer root. */
+    viewportClassName?: string;
+    /**
+     * Ref to the inner viewport (the scrollable element). Useful when a consumer
+     * wants to drive scroll position imperatively without losing the outer-root
+     * ref forwarded as `ref`.
+     */
+    viewportRef?: Ref<HTMLDivElement>;
+    /** Document direction for RTL handling. */
+    dir?: 'ltr' | 'rtl';
+    children?: ReactNode;
+}
+declare const ScrollArea: react.ForwardRefExoticComponent<ScrollAreaProps & react.RefAttributes<HTMLDivElement>>;
+
 declare const skeletonStyles: (props?: ({
     shape?: "circle" | "line" | "block" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -1170,6 +1201,28 @@ interface DotsProps extends Omit<HTMLAttributes<HTMLElement>, 'onChange'> {
 }
 declare const Dots: react.ForwardRefExoticComponent<DotsProps & react.RefAttributes<HTMLElement>>;
 
+/**
+ * Dropzone — drag-and-drop file capture surface with a click-to-browse
+ * fallback. Manages its own drag-over state and forwards file drops to
+ * `onFiles`. Native `<input type="file">` covers keyboard / a11y.
+ */
+interface DropzoneProps extends Omit<LabelHTMLAttributes<HTMLLabelElement>, 'onDrop' | 'onDragOver' | 'onDragLeave' | 'title'> {
+    /** Fired with the dropped or selected files. */
+    onFiles?: (files: File[]) => void;
+    /** Limit accepted MIME types or extensions. Forwarded to the hidden input + filtered on drop. */
+    accept?: string;
+    /** Allow multiple files. Default true. */
+    multiple?: boolean;
+    /** Heading text. Default "Drop files to ingest". */
+    title?: ReactNode;
+    /** Subtitle / hint text rendered below the title. */
+    description?: ReactNode;
+    /** Glyph at the top of the surface. Default `↥`. */
+    icon?: ReactNode;
+    disabled?: boolean;
+}
+declare const Dropzone: react.ForwardRefExoticComponent<DropzoneProps & react.RefAttributes<HTMLLabelElement>>;
+
 /**
  * EmptyState — placeholder for empty lists, no-results states, and error
  * surfaces. A 48×48 icon plate sits above a title + description and an
@@ -1223,6 +1276,117 @@ interface FileChipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>
 }
 declare const FileChip: react.ForwardRefExoticComponent<FileChipProps & react.RefAttributes<HTMLDivElement>>;
 
+/**
+ * FilterPanel — multi-facet checkbox filter panel. Pass a `facets` array
+ * describing each facet (label, options, optional collapsibility); the panel
+ * renders a header with a reset action, then each facet as a labeled
+ * checkbox group. Selections are emitted as
+ * `Record<facetId, readonly string[]>` and supported in both controlled and
+ * uncontrolled modes — mirroring `Slider` and `NavBar`.
+ *
+ * Reset both invokes the optional `onReset` callback and emits an empty
+ * selection through `onValueChange`, so consumers can drive either signal.
+ */
+interface FilterFacetOption {
+    value: string;
+    label: ReactNode;
+}
+interface FilterFacet {
+    id: string;
+    label: ReactNode;
+    options: ReadonlyArray<FilterFacetOption>;
+    /** Whether the group can collapse. Default `true`. */
+    collapsible?: boolean;
+    /** Initial open state for collapsible groups. Default `true`. */
+    defaultOpen?: boolean;
+}
+type FilterPanelValue = Record<string, ReadonlyArray<string>>;
+interface FilterPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onReset' | 'defaultValue' | 'title'> {
+    facets: ReadonlyArray<FilterFacet>;
+    /** Controlled selection map keyed by facet id. */
+    value?: FilterPanelValue;
+    /** Uncontrolled initial selection map. Default `{}`. */
+    defaultValue?: FilterPanelValue;
+    /** Fires whenever the selection changes — including reset. */
+    onValueChange?: (next: FilterPanelValue) => void;
+    /** Fired when the reset action is invoked, alongside `onValueChange({})`. */
+    onReset?: () => void;
+    /**
+     * Optional per-option counts shown in a trailing pill. Shape:
+     * `{ [facetId]: { [optionValue]: number } }`.
+     */
+    counts?: Record<string, Record<string, number>>;
+    /** Override the header title. Default `'Filter'`. */
+    title?: ReactNode;
+    /** Override the reset button label. Default `'Reset'`. */
+    resetLabel?: ReactNode;
+}
+declare const FilterPanel: react.ForwardRefExoticComponent<FilterPanelProps & react.RefAttributes<HTMLDivElement>>;
+
+/**
+ * RadialProgress — circular SVG progress ring. Renders the percent label in the
+ * center by default; pass `children` to override (e.g., a glyph or a count).
+ *
+ * Tones: accent (default) and ok (auto-applied when value === max).
+ */
+type RadialTone = 'accent' | 'ok' | 'warn' | 'err';
+interface RadialProgressProps extends HTMLAttributes<HTMLDivElement> {
+    /** Current value, 0..max. */
+    value: number;
+    /** Maximum value. Default 100. */
+    max?: number;
+    /** Pixel size of the SVG. Default 64. */
+    size?: number;
+    /** Stroke width. Default 4. */
+    thickness?: number;
+    /** Color tone. Auto-flips to `ok` on completion unless explicitly set. */
+    tone?: RadialTone;
+    /** Replaces the centered percent label. */
+    children?: ReactNode;
+    /** Accessible label. Falls back to `${pct}%`. */
+    'aria-label'?: string;
+}
+declare const RadialProgress: react.ForwardRefExoticComponent<RadialProgressProps & react.RefAttributes<HTMLDivElement>>;
+
+/**
+ * HealthScore — `RadialProgress` + delta indicator + optional breakdown
+ * tooltip. The shape generalizes recurring product surfaces like service
+ * health, deployment confidence, and graph health.
+ *
+ * Delta sign drives the arrow direction and tone (positive = ok, negative =
+ * err) unless an explicit `tone` is set. When a `breakdown` is supplied, the
+ * score wraps in a `HoverCard` that reveals the per-bucket contributions.
+ */
+interface HealthScoreBreakdownEntry {
+    label: ReactNode;
+    value: number;
+    /** Tone for the value text. Defaults to inheriting the parent score tone. */
+    tone?: RadialTone;
+}
+interface HealthScoreProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Current value, 0..max. */
+    value: number;
+    /** Maximum value. Default 100. */
+    max?: number;
+    /**
+     * Signed change vs. the previous period. Positive draws an up-arrow + ok
+     * tone, negative draws a down-arrow + err tone. Pass `0` to render a flat
+     * indicator.
+     */
+    delta?: number;
+    /** Label rendered under the score. */
+    label?: ReactNode;
+    /** Optional per-bucket contributions revealed in a HoverCard. */
+    breakdown?: ReadonlyArray<HealthScoreBreakdownEntry>;
+    /** Pixel size for the RadialProgress. Default 72. */
+    size?: number;
+    /** Color tone for the ring. Auto-derived when omitted. */
+    tone?: RadialTone;
+    /** Accessible label for the score. Defaults to `${pct}% health`. */
+    'aria-label'?: string;
+}
+declare const HealthScore: react.ForwardRefExoticComponent<HealthScoreProps & react.RefAttributes<HTMLDivElement>>;
+
 /**
  * Menubar — desktop-style horizontal menu strip (File, Edit, View, …) built on
  * Radix Menubar. Owns ARIA + keyboard semantics; ShipIt owns styling.
@@ -1244,6 +1408,92 @@ interface MenubarItemProps extends RadixMenubar.MenubarItemProps {
 declare const MenubarItem: react.ForwardRefExoticComponent<MenubarItemProps & react.RefAttributes<HTMLDivElement>>;
 declare const MenubarSeparator: react.ForwardRefExoticComponent<RadixMenubar.MenubarSeparatorProps & react.RefAttributes<HTMLDivElement>>;
 
+/**
+ * NavBar — primary app navigation. The same component renders either as a
+ * horizontal top bar (`orientation="horizontal"`) or as a vertical side rail
+ * (`orientation="vertical"`); both layouts are driven by the same `items`
+ * tree. Items can carry nested `children` to produce dropdowns on
+ * horizontal and expand-collapse groups on vertical. Below `md` the bar
+ * collapses to a hamburger that opens a Drawer rendering the items
+ * vertically (set `responsive={false}` to opt out).
+ *
+ * Active state can be controlled (`value` + `onValueChange`) or uncontrolled
+ * (`defaultValue`). Items with an `href` render as anchors; otherwise as
+ * buttons that fire `onValueChange`.
+ */
+interface NavBarItem {
+    /** Stable identifier — what `value` / `onValueChange` reference. */
+    id: string;
+    label: ReactNode;
+    /** Optional left-of-label icon node. */
+    icon?: ReactNode;
+    /** When set, item renders as an `<a>`; otherwise as a `<button>`. */
+    href?: string;
+    /** Trailing badge text. */
+    badge?: ReactNode;
+    disabled?: boolean;
+    /** Nested items — dropdowns on horizontal, expand-groups on vertical. */
+    children?: NavBarItem[];
+}
+type NavBarOrientation = 'horizontal' | 'vertical';
+interface NavBarProps extends Omit<HTMLAttributes<HTMLElement>, 'defaultValue' | 'title'> {
+    /** Layout direction. Default `'horizontal'`. */
+    orientation?: NavBarOrientation;
+    /** Item tree driving the bar. */
+    items: NavBarItem[];
+    /**
+     * Brand / logo slot rendered at the start. When `responsive` is `true`,
+     * `brand` also seeds the mobile Drawer's accessible name, so it should
+     * include text — e.g. `<><Logo /> ShipIt</>` rather than `<Logo />` alone.
+     * Falls back to `'Navigation'` when omitted.
+     */
+    brand?: ReactNode;
+    /** Trailing slot for secondary actions (avatar, settings, theme toggle, …). */
+    actions?: ReactNode;
+    /** Controlled active item id. */
+    value?: string;
+    /** Uncontrolled initial active item id. */
+    defaultValue?: string;
+    /** Fired when an item is activated. */
+    onValueChange?: (id: string) => void;
+    /** Pixel width of the vertical rail. Default 240. */
+    width?: number;
+    /** Collapse to a hamburger drawer below `md`. Default `true`. */
+    responsive?: boolean;
+}
+declare const NavBar: react.ForwardRefExoticComponent<NavBarProps & react.RefAttributes<HTMLElement>>;
+
+/**
+ * OnboardingChecklist — list of getting-started tasks driven by remote
+ * progress. Each item has a `status` (`pending` / `in-progress` / `done`)
+ * that decides its dot color and label tone, plus an optional `action` slot
+ * (typically a `Button`) rendered on the right.
+ *
+ * The header shows aggregate progress as a `Progress` bar; pass
+ * `progressLabel` to override the default `"{n} of {m} complete"` text.
+ */
+type OnboardingItemStatus = 'pending' | 'in-progress' | 'done';
+interface OnboardingItem {
+    id: string;
+    label: ReactNode;
+    description?: ReactNode;
+    status: OnboardingItemStatus;
+    /** Trailing call-to-action (typically a `Button`). */
+    action?: ReactNode;
+}
+interface OnboardingChecklistProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    items: ReadonlyArray<OnboardingItem>;
+    /** Fires when an item row is clicked. The whole row becomes clickable when supplied. */
+    onItemClick?: (id: string) => void;
+    /** Header heading. Default `'Get started'`. */
+    title?: ReactNode;
+    /** Override the progress label rendered next to the bar. */
+    progressLabel?: ReactNode;
+    /** Hide the aggregate progress bar. */
+    hideProgress?: boolean;
+}
+declare const OnboardingChecklist: react.ForwardRefExoticComponent<OnboardingChecklistProps & react.RefAttributes<HTMLElement>>;
+
 /**
  * Pagination — page selector for paginated lists/tables. Renders prev/next
  * arrows plus a compact range of numbered pages. Use `siblings` to control how
@@ -1288,31 +1538,6 @@ interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'>, Va
 }
 declare const Progress: react.ForwardRefExoticComponent<ProgressProps & react.RefAttributes<HTMLDivElement>>;
 
-/**
- * RadialProgress — circular SVG progress ring. Renders the percent label in the
- * center by default; pass `children` to override (e.g., a glyph or a count).
- *
- * Tones: accent (default) and ok (auto-applied when value === max).
- */
-type RadialTone = 'accent' | 'ok' | 'warn' | 'err';
-interface RadialProgressProps extends HTMLAttributes<HTMLDivElement> {
-    /** Current value, 0..max. */
-    value: number;
-    /** Maximum value. Default 100. */
-    max?: number;
-    /** Pixel size of the SVG. Default 64. */
-    size?: number;
-    /** Stroke width. Default 4. */
-    thickness?: number;
-    /** Color tone. Auto-flips to `ok` on completion unless explicitly set. */
-    tone?: RadialTone;
-    /** Replaces the centered percent label. */
-    children?: ReactNode;
-    /** Accessible label. Falls back to `${pct}%`. */
-    'aria-label'?: string;
-}
-declare const RadialProgress: react.ForwardRefExoticComponent<RadialProgressProps & react.RefAttributes<HTMLDivElement>>;
-
 /**
  * Sidebar — primary app navigation column. A simple flex column with the
  * panel background and a right border. Compose with `<NavItem>` and
@@ -1344,8 +1569,27 @@ declare const NavItem: react.ForwardRefExoticComponent<NavItemProps & react.RefA
 interface NavSectionProps extends HTMLAttributes<HTMLDivElement> {
     /** Eyebrow heading. Rendered uppercase, mono, dim. */
     label: ReactNode;
+    /** Optional leading glyph or icon node next to the eyebrow. */
+    icon?: ReactNode;
     /** Optional trailing element next to the heading (e.g., a `+` add affordance). */
     action?: ReactNode;
+    /**
+     * When true, the eyebrow becomes a button that toggles the body. The body
+     * is hidden when closed. Default `false` — the eyebrow stays static.
+     */
+    collapsible?: boolean;
+    /** Uncontrolled initial open state. Default `true`. Ignored when `open` is provided. */
+    defaultOpen?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Fires when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Pixel indent applied to the body. Useful when this section nests other
+     * sections — the indent visually anchors children to the eyebrow above.
+     * A subtle left rail is drawn alongside the indent. Default `0`.
+     */
+    indent?: number;
 }
 declare const NavSection: react.ForwardRefExoticComponent<NavSectionProps & react.RefAttributes<HTMLDivElement>>;
 
@@ -1471,6 +1715,53 @@ interface TimelineItemProps extends HTMLAttributes<HTMLLIElement> {
 }
 declare const TimelineItem: react.ForwardRefExoticComponent<TimelineItemProps & react.RefAttributes<HTMLLIElement>>;
 
+/**
+ * formatRelative — compact "x ago" / "in x" formatter used by ActivityTimeline
+ * and any other surface that wants to print typed event timestamps. Always
+ * returns a short, ASCII string; if you need locale-aware formatting reach for
+ * `Intl.RelativeTimeFormat` instead.
+ *
+ * The `now` argument is injectable so callers can render deterministically in
+ * tests and during SSR. Invalid or unparseable inputs return an empty string
+ * (note: `0` is a valid timestamp — the Unix epoch — and renders as a real
+ * relative time).
+ */
+declare function formatRelative(input: Date | string | number, now?: Date): string;
+
+/**
+ * ActivityTimeline — typed-event variant of `Timeline`. Each event carries
+ * an optional `icon`, an `actor` (name + avatar slot), a `title`, an `at`
+ * timestamp formatted relative to `relativeNow`, and an optional `payload`
+ * preview. Tone drives the marker color.
+ *
+ * The component is presentation-only — supply your own data adapter to map
+ * domain events to `ActivityEvent`s.
+ */
+interface ActivityActor {
+    name: ReactNode;
+    /** Typically an `<Avatar>` or `<IconGlyph>`. */
+    avatar?: ReactNode;
+}
+interface ActivityEvent {
+    id: string;
+    /** Leading icon next to the marker. Often an `<IconGlyph>`. */
+    icon?: ReactNode;
+    actor?: ActivityActor;
+    title: ReactNode;
+    /** Event time. Renders relative to `relativeNow`. */
+    at: Date | string | number;
+    /** Optional inline preview (e.g. a diff snippet or a payload summary). */
+    payload?: ReactNode;
+    /** Marker color tone. Default `accent`. */
+    tone?: TimelineEventTone;
+}
+interface ActivityTimelineProps extends HTMLAttributes<HTMLOListElement> {
+    events: ReadonlyArray<ActivityEvent>;
+    /** Reference time for relative formatting. Injectable for tests/SSR. */
+    relativeNow?: Date;
+}
+declare const ActivityTimeline: react.ForwardRefExoticComponent<ActivityTimelineProps & react.RefAttributes<HTMLOListElement>>;
+
 /**
  * Topbar — slim header strip across the top of an app surface. The title
  * lives on the left, the rest of the row is yours via `actions` (search,
@@ -1513,4 +1804,71 @@ interface TreeProps extends Omit<HTMLAttributes<HTMLUListElement>, 'onSelect'> {
 }
 declare const Tree: react.ForwardRefExoticComponent<TreeProps & react.RefAttributes<HTMLUListElement>>;
 
-export { Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, type AlertDialogProps, AlertDialogRoot, AlertDialogTrigger, type AlertProps, type AlertTone, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, Calendar, type CalendarProps, Card, CardLink, type CardLinkProps, type CardProps, Checkbox, type CheckboxProps, Chip, type ChipProps, Combobox, type ComboboxOption, type ComboboxProps, CommandPalette, type CommandPaletteGroup, type CommandPaletteItem, type CommandPaletteProps, ContextMenu, ContextMenuContent, ContextMenuItem, type ContextMenuItemProps, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuTrigger, Crumb, type CrumbProps, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, DatePicker, type DatePickerProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogOverlay, DialogPortal, type DialogProps, DialogRoot, DialogTrigger, Dots, type DotsProps, Drawer, type DrawerProps, type DrawerSide, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRoot, DropdownMenuTrigger, EmptyState, type EmptyStateProps, FAB, type FABProps, Field, type FieldProps, FileChip, type FileChipProps, HoverCard, HoverCardContent, HoverCardPortal, type HoverCardProps, HoverCardRoot, HoverCardTrigger, IconButton, type IconButtonProps, Input, type InputProps, Kbd, type KbdProps, MenuCheckboxItem, MenuItem, type MenuItemProps, MenuSeparator, Menubar, MenubarContent, MenubarItem, type MenubarItemProps, MenubarMenu, MenubarSeparator, MenubarTrigger, NavItem, type NavItemProps, NavSection, type NavSectionProps, type NormalizedOption, OTP, type OTPHandle, type OTPProps, Pagination, type PaginationProps, Popover, PopoverAnchor, PopoverArrow, PopoverClose, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Progress, type ProgressProps, RadialProgress, type RadialProgressProps, type RadialTone, Radio, RadioGroup, type RadioGroupProps, type RadioProps, SearchInput, type SearchInputProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectTrigger, SelectValue, Sheet, type SheetProps, Sidebar, type SidebarProps, Skeleton, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, Slider, type SliderProps, Sparkline, type SparklineProps, Spinner, type SpinnerProps, SplitButton, type SplitButtonProps, StatCard, type StatCardProps, type StatTrend, StatusDot, type StatusDotProps, type StatusState, type StepState, Stepper, type StepperProps, type StepperStep, Switch, type SwitchProps, Tab, type TabProps, Tabs, TabsContent, TabsList, type TabsProps, type TabsVariantProps, Tag, type TagProps, Textarea, type TextareaProps, type Theme, Timeline, type TimelineEvent, type TimelineEventTone, TimelineItem, type TimelineItemProps, type TimelineProps, ToastCard, type ToastInput, ToastProvider, type ToastVariant, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, Topbar, type TopbarProps, Tree, type TreeItem, type TreeProps, type UseControllableStateProps, type UseKeyboardListOptions, type UseKeyboardListResult, badgeStyles, buttonStyles, cardStyles, cn, filterCommandItems, iconButtonStyles, useControllableState, useDisclosure, useEscape, useIsomorphicLayoutEffect, useKeyboardList, useOutsideClick, useTheme, useToast };
+/**
+ * WizardDialog — modal multi-step flow. Composes `Dialog`, `Stepper`, and
+ * Next/Back navigation around a `steps` array. Each step's content can be a
+ * static node or a render function that receives the wizard context, which
+ * is useful for steps that need to read or drive the navigation imperatively.
+ *
+ * `canAdvance` lets a step gate the Next button (e.g. when a form field is
+ * empty). When the last step's Next is clicked, the wizard calls
+ * `onComplete()` and lets the consumer close the dialog from there.
+ */
+interface WizardContext {
+    current: number;
+    total: number;
+    goNext: () => void;
+    goBack: () => void;
+    goTo: (index: number) => void;
+    isFirst: boolean;
+    isLast: boolean;
+}
+interface WizardStep {
+    /** Stable id. Used as the React key and the Stepper id. */
+    id: string;
+    /** Visible label in the Stepper. */
+    label: string;
+    /**
+     * Step body. Pass a node for static content or a function for content that
+     * needs the wizard context (e.g. to disable a Next button from inside).
+     */
+    content: ReactNode | ((ctx: WizardContext) => ReactNode);
+    /**
+     * Predicate that gates the Next button for this step. Receives the wizard
+     * context. Default: always true (Next is enabled).
+     */
+    canAdvance?: (ctx: WizardContext) => boolean;
+}
+interface WizardDialogProps {
+    /** Controlled open state. */
+    open?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Fires when the dialog open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Ordered list of wizard steps. */
+    steps: ReadonlyArray<WizardStep>;
+    /** Step index to start at. Default 0. */
+    initialStep?: number;
+    /** Fires when Next is clicked on the last step. The consumer typically closes the dialog here. */
+    onComplete?: () => void;
+    /** Dialog title (visible heading). */
+    title?: ReactNode;
+    /** Dialog description (rendered below the title for assistive tech). */
+    description?: ReactNode;
+    /** Pixel max-width of the dialog panel. Default 560. */
+    width?: number | string;
+    /** Override the Next button label. Default `'Next'`. */
+    nextLabel?: ReactNode;
+    /** Override the Next button label on the last step. Default `'Done'`. */
+    completeLabel?: ReactNode;
+    /** Override the Back button label. Default `'Back'`. */
+    backLabel?: ReactNode;
+    /** Optional cancel slot rendered in the footer alongside the navigation. */
+    cancelLabel?: ReactNode;
+    /** Fires when the cancel button is pressed. The consumer typically closes the dialog. */
+    onCancel?: () => void;
+}
+declare const WizardDialog: react.ForwardRefExoticComponent<WizardDialogProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type ActivityActor, type ActivityEvent, ActivityTimeline, type ActivityTimelineProps, Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, type AlertDialogProps, AlertDialogRoot, AlertDialogTrigger, type AlertProps, type AlertTone, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, Breadcrumbs, type BreadcrumbsProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, Calendar, type CalendarProps, Card, CardLink, type CardLinkProps, type CardProps, Checkbox, type CheckboxProps, Chip, type ChipProps, Combobox, type ComboboxOption, type ComboboxProps, CommandPalette, type CommandPaletteGroup, type CommandPaletteItem, type CommandPaletteProps, ContextMenu, ContextMenuContent, ContextMenuItem, type ContextMenuItemProps, ContextMenuPortal, ContextMenuRoot, ContextMenuSeparator, ContextMenuTrigger, Crumb, type CrumbProps, DataTable, type DataTableColumn, type DataTableProps, type DataTableSort, DatePicker, type DatePickerProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogOverlay, DialogPortal, type DialogProps, DialogRoot, DialogTrigger, Dots, type DotsProps, Drawer, type DrawerProps, type DrawerSide, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRoot, DropdownMenuTrigger, Dropzone, type DropzoneProps, EmptyState, type EmptyStateProps, FAB, type FABProps, Field, type FieldProps, FileChip, type FileChipProps, type FilterFacet, type FilterFacetOption, FilterPanel, type FilterPanelProps, type FilterPanelValue, HealthScore, type HealthScoreBreakdownEntry, type HealthScoreProps, HoverCard, HoverCardContent, HoverCardPortal, type HoverCardProps, HoverCardRoot, HoverCardTrigger, IconButton, type IconButtonProps, Input, type InputProps, Kbd, type KbdProps, MenuCheckboxItem, MenuItem, type MenuItemProps, MenuSeparator, Menubar, MenubarContent, MenubarItem, type MenubarItemProps, MenubarMenu, MenubarSeparator, MenubarTrigger, NavBar, type NavBarItem, type NavBarOrientation, type NavBarProps, NavItem, type NavItemProps, NavSection, type NavSectionProps, type NormalizedOption, OTP, type OTPHandle, type OTPProps, OnboardingChecklist, type OnboardingChecklistProps, type OnboardingItem, type OnboardingItemStatus, Pagination, type PaginationProps, Popover, PopoverAnchor, PopoverArrow, PopoverClose, PopoverContent, PopoverPortal, PopoverRoot, PopoverTrigger, Progress, type ProgressProps, RadialProgress, type RadialProgressProps, type RadialTone, Radio, RadioGroup, type RadioGroupProps, type RadioProps, ScrollArea, type ScrollAreaProps, type ScrollAreaType, SearchInput, type SearchInputProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectTrigger, SelectValue, Sheet, type SheetProps, Sidebar, type SidebarProps, Skeleton, SkeletonGroup, type SkeletonGroupProps, type SkeletonProps, Slider, type SliderProps, Sparkline, type SparklineProps, Spinner, type SpinnerProps, SplitButton, type SplitButtonProps, StatCard, type StatCardProps, type StatTrend, StatusDot, type StatusDotProps, type StatusState, type StepState, Stepper, type StepperProps, type StepperStep, Switch, type SwitchProps, Tab, type TabProps, Tabs, TabsContent, TabsList, type TabsProps, type TabsVariantProps, Tag, type TagProps, Textarea, type TextareaProps, type Theme, Timeline, type TimelineEvent, type TimelineEventTone, TimelineItem, type TimelineItemProps, type TimelineProps, ToastCard, type ToastInput, ToastProvider, type ToastVariant, Tooltip, TooltipArrow, TooltipContent, TooltipPortal, type TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, Topbar, type TopbarProps, Tree, type TreeItem, type TreeProps, type UseControllableStateProps, type UseKeyboardListOptions, type UseKeyboardListResult, type WizardContext, WizardDialog, type WizardDialogProps, type WizardStep, badgeStyles, buttonStyles, cardStyles, cn, filterCommandItems, formatRelative, iconButtonStyles, useControllableState, useDisclosure, useEscape, useIsomorphicLayoutEffect, useKeyboardList, useOutsideClick, useTheme, useToast };