@reopt-ai/opt-ui 1.4.1

package/dist/index.d.ts

@@ -0,0 +1,2351 @@
+import { D as DateRange, I as IconDef } from './index-Slu5hOj1.js';
+export { A as AccordionContent, a as AccordionItem, b as AccordionRoot, c as AccordionTrigger, d as Alert, e as AlertDialogPanel, f as AlertDialogPanelProps, g as AlertProps, h as Avatar, i as AvatarGroup, j as AvatarGroupProps, k as AvatarProps, B as Badge, l as BadgeProps, m as BlockBaseProps, n as BlockLayout, o as BlockLayoutProps, p as Breadcrumb, q as BreadcrumbItem, r as BreadcrumbProps, s as Button, t as ButtonProps, C as Card, u as CardContent, v as CardContentProps, w as CardDescription, x as CardDescriptionProps, y as CardFooter, z as CardFooterProps, E as CardHeader, F as CardHeaderProps, G as CardProps, H as CardTitle, J as CardTitleProps, K as Checkbox, L as CheckboxGroup, M as CheckboxGroupProps, N as CheckboxProps, O as CircularProgress, P as CircularProgressProps, Q as ColorPicker, R as ColorPickerProps, S as ComboboxEmpty, T as ComboboxGroup, U as ComboboxGroupLabel, V as ComboboxInput, W as ComboboxItem, X as ComboboxPopover, Y as ComboboxRoot, Z as ComparisonMode, _ as CompositeZone, $ as ConditionBuilder, a0 as ConditionBuilderProps, a1 as ConditionDef, a2 as ConditionGroup, a3 as ConditionOperator, a4 as ConditionTypeRenderer, a5 as Container, a6 as ContainerProps, a7 as DEFAULT_PRESETS, a8 as DateGranularity, a9 as DateRangePicker, aa as DateRangePickerProps, ab as DateRangePreset, ac as DialogBody, ad as DialogBodyProps, ae as DialogDescription, af as DialogDisclosure, ag as DialogDismiss, ah as DialogFooter, ai as DialogFooterProps, aj as DialogHeader, ak as DialogHeaderProps, al as DialogHeading, am as DialogPanel, an as DialogRoot, ao as DialogSize, ap as DisclosureContent, aq as DisclosureRoot, ar as DisclosureTrigger, as as DrawerClose, at as DrawerPanel, au as DrawerPanelProps, av as DrawerRoot, aw as DrawerSide, ax as DrawerSize, ay as DropdownContent, az as DropdownItem, aA as DropdownMenu, aB as DropdownSeparator, aC as DropdownTrigger, aD as EmptyState, aE as EmptyStateAction, aF as EmptyStateProps, aG as FormCheckbox, aH as FormColorPicker, aI as FormColorPickerProps, aJ as FormControl, aK as FormDateRangePicker, aL as FormDateRangePickerProps, aM as FormDescription, aN as FormError, aO as FormField, aP as FormGroup, aQ as FormGroupLabel, aR as FormIconPicker, aS as FormIconPickerProps, aT as FormInput, aU as FormLabel, aV as FormNumberInput, aW as FormNumberInputProps, aX as FormProvider, aY as FormPush, aZ as FormRadio, a_ as FormRadioGroup, a$ as FormRemove, b0 as FormReset, b1 as FormRoot, b2 as FormSelect, b3 as FormSelectItem, b4 as FormSelectPopover, b5 as FormSelectProps, b6 as FormSlider, b7 as FormSliderProps, b8 as FormStarRating, b9 as FormStarRatingProps, ba as FormSubmit, bb as FormSwitch, bc as FormSwitchProps, bd as FormTagInput, be as FormTagInputProps, bf as FormTextarea, bg as FormTextareaProps, bh as Heading, bi as HeadingLevel, bj as HeadingProps, bk as HeadingRole, bl as IconPicker, bm as IconPickerProps, bn as Input, bo as InputProps, bp as Kbd, bq as KbdProps, br as Logo, bs as LogoProps, bt as MenuButtonArrow, bu as MenuItem, bv as MenuItemCheckbox, bw as MenuItemRadio, bx as MenuPopover, by as MenuRoot, bz as MenuSeparator, bA as MenuTrigger, bB as MenubarContainer, bC as MenubarRoot, bD as Meter, bE as MeterProps, bF as NumberInput, bG as NumberInputProps, bH as OtpField, bI as OtpFieldProps, bJ as PageHeader, bK as PageHeaderProps, bL as Pagination, bM as PaginationProps, bN as PopoverClose, bO as PopoverContent, bP as PopoverContentProps, bQ as PopoverRoot, bR as PopoverTrigger, bS as Progress, bT as ProgressProps, bU as Radio, bV as RadioGroup, bW as RadioGroupProps, bX as RadioProps, bY as ResizableHandle, bZ as ResizableHandleProps, b_ as ResizablePanel, b$ as ResizablePanelGroup, c0 as ResizablePanelGroupProps, c1 as ResizablePanelProps, c2 as SHADER_OVERLAY_PARAM_KEYS, c3 as SHADER_PARAM_FALLBACK, c4 as SHADER_PARAM_KEYS, c5 as SHADER_PRESETS, c6 as SHADER_PRESET_IDS, c7 as ScrollArea, c8 as ScrollAreaProps, c9 as Section, ca as SectionProps, cb as SelectItem, cc as SelectLabel, cd as SelectPopover, ce as SelectRoot, cf as SelectTrigger, cg as Separator, ch as SeparatorProps, ci as ShaderParamKey, cj as ShaderParamSpec, ck as ShaderPreset, cl as ShaderPresetCategory, cm as ShaderPresetId, cn as ShaderSurface, co as ShaderSurfaceHandle, cp as ShaderSurfaceProps, cq as Skeleton, cr as SkeletonAvatar, cs as SkeletonCard, ct as SkeletonProps, cu as SkeletonTable, cv as SkeletonText, cw as Slider, cx as SliderProps, cy as Spinner, cz as SpinnerProps, cA as StarRating, cB as StarRatingProps, cC as StatCard, cD as StatCardProps, cE as StepBuilder, cF as StepBuilderProps, cG as StepDef, m as SurfaceBaseProps, n as SurfaceLayout, o as SurfaceLayoutProps, cH as Switch, cI as SwitchProps, cJ as Tab, cK as TabList, cL as TabPanel, cM as TabsRoot, cN as TagInput, cO as TagInputProps, cP as Text, cQ as TextElement, cR as TextProps, cS as TextRole, cT as TextTone, cU as Textarea, cV as TextareaProps, cW as Toggle, cX as ToggleGroup, cY as ToggleGroupProps, cZ as ToggleProps, c_ as ToolbarButton, c$ as ToolbarContainer, d0 as ToolbarRoot, d1 as ToolbarSeparator, d2 as Tooltip, d3 as TooltipAnchor, d4 as TooltipProvider, d5 as VirtualList, d6 as VirtualListProps, d7 as createBlock, d7 as createSurface, d8 as getShaderFragment, d9 as getShaderPreset } from './index-Slu5hOj1.js';
+import { FormErrors, CommandRootProps, CommandEmptyProps, CommandGroupProps, CommandInputProps as CommandInputProps$1, CommandItemProps, CommandListProps, CommandSeparatorProps } from '@reopt-ai/opt-ui-primitives';
+export { AccordionContentProps, AccordionItemProps, AccordionRootProps, AccordionTriggerProps, Composite, CompositeItem, CompositeProvider, CompositeRow, FormErrors, FormStoreInstance, FormStoreOptions, ValidateOn, useFieldValue, useFormContext, useFormStore } from '@reopt-ai/opt-ui-primitives';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { Component, ReactNode, ErrorInfo, ComponentPropsWithoutRef } from 'react';
+export * from '@reopt-ai/opt-charts';
+export { EventSparkline, EventSparklineLabels, EventSparklineProps, MetricsCard, MetricsCardProps, ReportWidget, ReportWidgetConfig, ReportWidgetLabels, ReportWidgetProps, ReportWidgetType, TrendChart, TrendChartProps } from '@reopt-ai/opt-charts';
+export { A as AppMenubar, a as AppMenubarProps, B as BranchSelect, b as BranchSelectProps, C as ColumnDef, c as CommandPalette, d as CommandPaletteProps, e as CommandPaletteTrigger, f as CommandPaletteTriggerProps, g as ContentTabs, h as ContentTabsProps, D as DashboardGrid, i as DashboardGridProps, j as DataTable, k as DataTableProps, l as DeploymentTimeline, m as DeploymentTimelineProps, n as DomainTable, o as DomainTableProps, E as EditorToolbar, p as EditorToolbarProps, q as EnvPanel, r as EnvPanelProps, F as FailureList, s as FailureListLabels, t as FailureListProps, u as FaqAccordion, v as FaqAccordionProps, K as KeyValueEditor, w as KeyValueEditorLabels, x as KeyValueEditorProps, y as KeyValueEntry, N as NotificationToast, P as ProjectSwitcher, z as ProjectSwitcherProps, S as SearchCombobox, G as SearchComboboxProps, H as SettingsForm, I as SettingsFormProps, J as SidebarNav, L as SidebarNavProps, M as StatusSelect, O as StatusSelectProps, T as ToastAction, Q as ToastContextValue, R as ToastMessage, U as ToastProvider, V as ToastProviderProps, W as ToastVariant, X as WorkflowCanvas, Y as WorkflowCanvasConnection, Z as WorkflowCanvasProps, _ as WorkflowCanvasStep, $ as toast, a0 as useToast } from './index-BZ_lBlO1.js';
+import { T as TaskDef, A as ActivityDef, F as FilterGroupDef, Q as QuickActionDef, a as TeamMemberDef, b as FormFieldDef, E as ExportColumn, c as ExportFormat, S as StatCard, d as TabDef, C as ChatConversationDef, e as ChatModelDef, f as ChatStylePresetDef, g as ChatMessageDef } from './types-D4-0lwaE.js';
+export { B as BranchDef, h as ChartConfig, i as ChartDataPoint, j as ChartMargin, k as ChartSeriesDef, l as CommandDef, D as DeploymentStep, m as DomainDef, n as EnvGroupDef, o as EnvVarDef, p as FailureItem, q as FaqItem, r as FilterOption, M as MenuDef, s as MenuItemDef, N as NavItem, t as NavItemDef, P as ProjectDef, u as SelectOption, v as TableColumn, w as TimePreset, x as ToastOptions, y as ToolbarButtonDef } from './types-D4-0lwaE.js';
+import { PaletteConfig, OptTokenName } from '@reopt-ai/opt-palette';
+import { ClassValue } from 'clsx';
+
+/**
+ * Adapter for schema-based validation (Zod, Valibot, or any library with safeParse).
+ * No direct dependency on any schema library.
+ *
+ * @example
+ * ```ts
+ * import { schemaValidator } from "@reopt-ai/opt-ui";
+ * import { z } from "zod";
+ *
+ * const form = useFormStore({
+ *   defaultValues: { email: "", age: 0 },
+ *   validate: schemaValidator(z.object({
+ *     email: z.string().email("유효한 이메일을 입력하세요"),
+ *     age: z.number().min(1, "나이를 입력하세요"),
+ *   })),
+ * });
+ * ```
+ */
+interface ParseSuccess {
+    success: true;
+}
+interface ParseFailure {
+    success: false;
+    error: {
+        issues: {
+            path: (string | number)[];
+            message: string;
+        }[];
+    };
+}
+type ParseResult = ParseSuccess | ParseFailure;
+/**
+ * Minimal interface satisfied by Zod schemas, Valibot schemas, and similar
+ * libraries that implement `safeParse`. No runtime dependency required.
+ */
+interface SchemaLike {
+    safeParse(data: unknown): ParseResult;
+}
+/** Handles schema validator. */
+declare function schemaValidator<V extends Record<string, unknown>>(schema: SchemaLike): (values: V) => FormErrors;
+
+/** Props for the error boundary component. */
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    onError?: (error: Error, info: ErrorInfo) => void;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    static displayName: string;
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+}
+
+/** Renders the `Command` component. */
+declare function Command({ className, ...props }: CommandRootProps): react_jsx_runtime.JSX.Element;
+/** Props for the `CommandDialog` component. */
+interface CommandDialogProps {
+    /** Open state. */
+    open: boolean;
+    /** Open state setter. */
+    onOpenChange: (open: boolean) => void;
+    /** Accessible title (visually hidden by default). */
+    title?: string;
+    /** Accessible description (visually hidden by default). */
+    description?: string;
+    /** Optional className for the dialog panel. */
+    className?: string;
+    /** Optional className for the inner Command root. */
+    commandClassName?: string;
+    /** Filter behaviour passed through to the inner Command root. */
+    shouldFilter?: CommandRootProps["shouldFilter"];
+    filter?: CommandRootProps["filter"];
+    children: ReactNode;
+}
+/** Renders a Command in a dialog overlay, à la Cmd+K palette. */
+declare function CommandDialog({ open, onOpenChange, title, description, className, commandClassName, shouldFilter, filter, children, }: CommandDialogProps): react_jsx_runtime.JSX.Element;
+/** Props for the `CommandInput` component. */
+interface CommandInputProps extends CommandInputProps$1 {
+    /** Trailing content rendered on the right side (e.g. ESC kbd). */
+    trailing?: ReactNode;
+    /** Optional className for the input wrapper. */
+    wrapperClassName?: string;
+}
+/** Renders the `CommandInput` component with a leading search icon. */
+declare function CommandInput({ className, trailing, wrapperClassName, placeholder, "aria-label": ariaLabel, ...props }: CommandInputProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandList` component. */
+declare function CommandList({ className, "aria-label": ariaLabel, ...props }: CommandListProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandEmpty` component. */
+declare function CommandEmpty({ className, ...props }: CommandEmptyProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandGroup` component with an optional heading. */
+declare function CommandGroup({ className, heading, ...props }: CommandGroupProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandSeparator` component. */
+declare function CommandSeparator({ className, ...props }: CommandSeparatorProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandItem` component. */
+declare function CommandItem({ className, ...props }: CommandItemProps): react_jsx_runtime.JSX.Element;
+/** Renders the `CommandShortcut` component (right-aligned hint). */
+declare function CommandShortcut({ className, ...props }: ComponentPropsWithoutRef<"span">): react_jsx_runtime.JSX.Element;
+
+/** Props for {@link PageAside}. */
+interface PageAsideProps {
+    /** Content rendered in the sticky top slot (e.g. package switcher). */
+    header?: ReactNode;
+    /** Main scrollable nav area. */
+    children: ReactNode;
+    /** Content rendered in the bottom slot (e.g. version label). */
+    footer?: ReactNode;
+    /**
+     * Width utility class. Defaults to `w-60`. Pass `"w-56"`, `"w-64"`, etc.
+     */
+    widthClassName?: string;
+    /** `aria-label` for the underlying `<aside>`. */
+    label?: string;
+    /** Hide aside below `md` breakpoint. Defaults to true. */
+    hideOnMobile?: boolean;
+    className?: string;
+    /** Override the header slot's chrome (default: `px-3 py-3`). */
+    headerClassName?: string;
+    /** Override the body slot's chrome (default: `px-3 py-3`). */
+    bodyClassName?: string;
+    /** Override the footer slot's chrome (default: `px-4 py-3`). */
+    footerClassName?: string;
+}
+/**
+ * Sticky page-level sidebar chrome. Owns position/border/surface and a
+ * three-slot layout (header / scroll body / footer). Doesn't prescribe the
+ * nav surface — drop `SidebarNav`, custom tree, tag list, etc. into `children`.
+ */
+declare function PageAside({ header, children, footer, widthClassName, label, hideOnMobile, className, headerClassName, bodyClassName, footerClassName, }: PageAsideProps): react_jsx_runtime.JSX.Element;
+declare namespace PageAside {
+    var displayName: string;
+}
+
+/** Localized labels for the task list component. */
+interface TaskListLabels {
+    title?: string;
+    emptyMessage?: string;
+    completedOf?: string;
+    priority?: {
+        low?: string;
+        medium?: string;
+        high?: string;
+        urgent?: string;
+    };
+    status?: {
+        todo?: string;
+        "in-progress"?: string;
+        review?: string;
+        done?: string;
+    };
+    moreItems?: string;
+}
+/** Props for the task list component. */
+interface TaskListProps {
+    tasks: TaskDef[];
+    title?: string;
+    onTaskClick?: (task: TaskDef) => void;
+    onTaskStatusChange?: (task: TaskDef, completed: boolean) => void;
+    emptyMessage?: string;
+    showSubtasks?: boolean;
+    /** Maximum number of tasks to display */
+    maxItems?: number;
+    /** Custom labels for i18n support */
+    labels?: TaskListLabels;
+    className?: string;
+}
+/** Renders the task list component. */
+declare function TaskList({ tasks, title, onTaskClick, onTaskStatusChange, emptyMessage, showSubtasks, maxItems, labels: customLabels, className, }: TaskListProps): react_jsx_runtime.JSX.Element;
+
+interface TimeAgoLabels {
+    justNow: string;
+    minutesAgo: string;
+    hoursAgo: string;
+    daysAgo: string;
+}
+interface ActivityVerbLabels {
+    created: string;
+    updated: string;
+    completed: string;
+    commented: string;
+    assigned: string;
+    deployed: string;
+    merged: string;
+}
+/** Localized labels for the activity feed component. */
+interface ActivityFeedLabels {
+    title?: string;
+    emptyMessage?: string;
+    moreItems?: string;
+    timeAgo?: Partial<TimeAgoLabels>;
+    activityVerbs?: Partial<ActivityVerbLabels>;
+}
+/** Props for the activity feed component. */
+interface ActivityFeedProps {
+    activities: ActivityDef[];
+    title?: string;
+    maxItems?: number;
+    onActivityClick?: (activity: ActivityDef) => void;
+    /** Called when "show more" button is clicked */
+    onShowMore?: () => void;
+    emptyMessage?: string;
+    /** Custom labels for i18n support */
+    labels?: ActivityFeedLabels;
+    /** Locale for date formatting (default: 'ko-KR') */
+    locale?: string;
+    /** Show loading state */
+    loading?: boolean;
+    /** Layout style: list (default) shows time below, compact shows time inline */
+    layout?: "list" | "compact";
+    /** Render action buttons for each activity item */
+    renderActions?: (activity: ActivityDef) => ReactNode;
+    className?: string;
+}
+/** Renders the activity feed component. */
+declare function ActivityFeed({ activities, title, maxItems, onActivityClick, onShowMore, emptyMessage, labels: customLabels, locale, loading, layout, renderActions, className, }: ActivityFeedProps): react_jsx_runtime.JSX.Element;
+declare namespace ActivityFeed {
+    var displayName: string;
+}
+
+/** Localized labels for the filter bar component. */
+interface FilterBarLabels {
+    clearAll?: string;
+    searchPlaceholder?: string;
+}
+/**
+ * Composable filter bar supporting 5 filter types:
+ * - `search`: Free-text input with debounce
+ * - `select`: Single-value dropdown
+ * - `multiselect`: Multi-value checkbox dropdown with popover
+ * - `toggle`: Boolean switch
+ * - `dateRange`: Date range picker
+ *
+ * Each filter is defined via `FilterGroupDef` (see lib/types.ts).
+ * The parent component manages filter state and passes it back via `onFilterChange`.
+ */
+interface FilterBarProps {
+    filters: FilterGroupDef[];
+    onFilterChange?: (filterId: string, value: string | string[] | boolean) => void;
+    onDateRangeChange?: (filterId: string, range: DateRange) => void;
+    onClearAll?: () => void;
+    labels?: FilterBarLabels;
+    /** Slot next to Clear All button (e.g. SavedFilters) */
+    presetActions?: ReactNode;
+    className?: string;
+}
+/** Renders the filter bar component. */
+declare function FilterBar({ filters, onFilterChange, onDateRangeChange, onClearAll, labels: customLabels, presetActions, className, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+
+/** Localized labels for the quick actions component. */
+interface QuickActionsLabels {
+    title?: string;
+}
+/** Props for the quick actions component. */
+interface QuickActionsProps {
+    actions: QuickActionDef[];
+    title?: string;
+    layout?: "grid" | "list";
+    columns?: 2 | 3 | 4;
+    /** Show descriptions in grid layout via tooltip */
+    showDescriptionInGrid?: boolean;
+    /** Enable keyboard shortcut bindings for actions with shortcuts defined */
+    bindShortcuts?: boolean;
+    /** Custom labels for i18n support */
+    labels?: QuickActionsLabels;
+    className?: string;
+}
+/** Renders the quick actions component. */
+declare function QuickActions({ actions, title, layout, columns, showDescriptionInGrid, bindShortcuts, labels: customLabels, className, }: QuickActionsProps): react_jsx_runtime.JSX.Element;
+declare namespace QuickActions {
+    var displayName: string;
+}
+
+/** Localized labels for the team member list component. */
+interface TeamMemberListLabels {
+    title?: string;
+    emptyMessage?: string;
+    onlineCount?: string;
+    moreMembers?: string;
+    moreCompact?: string;
+    status?: {
+        online?: string;
+        away?: string;
+        busy?: string;
+        offline?: string;
+    };
+}
+/** Props for the team member list component. */
+interface TeamMemberListProps {
+    members: TeamMemberDef[];
+    title?: string;
+    layout?: "list" | "compact" | "avatars-only";
+    maxDisplay?: number;
+    onMemberClick?: (member: TeamMemberDef) => void;
+    /** Called when "more" button is clicked */
+    onShowMore?: () => void;
+    emptyMessage?: string;
+    /** Custom labels for i18n support */
+    labels?: TeamMemberListLabels;
+    className?: string;
+}
+/** Renders the team member list component. */
+declare function TeamMemberList({ members, title, layout, maxDisplay, onMemberClick, onShowMore, emptyMessage, labels: customLabels, className, }: TeamMemberListProps): react_jsx_runtime.JSX.Element;
+
+/** Localized labels for the auth form component. */
+interface AuthFormLabels {
+    loginTitle?: string;
+    signupTitle?: string;
+    emailLabel?: string;
+    passwordLabel?: string;
+    confirmPasswordLabel?: string;
+    rememberMeLabel?: string;
+    loginButton?: string;
+    signupButton?: string;
+    emailRequired?: string;
+    emailInvalid?: string;
+    passwordRequired?: string;
+    passwordMinLength?: string;
+    passwordMismatch?: string;
+}
+/** Props for the auth form component. */
+interface AuthFormProps {
+    defaultMode?: "login" | "signup";
+    mode?: "login" | "signup";
+    onModeChange?: (mode: "login" | "signup") => void;
+    showRememberMe?: boolean;
+    minPasswordLength?: number;
+    onSubmit?: (values: {
+        email: string;
+        password: string;
+        confirmPassword?: string;
+        rememberMe?: boolean;
+        mode: "login" | "signup";
+    }) => void;
+    /** Custom fields rendered between email and password (e.g., name fields for signup) */
+    renderExtraFields?: (mode: "login" | "signup") => ReactNode;
+    labels?: AuthFormLabels;
+    ariaLabel?: string;
+}
+/** Renders the auth form component. */
+declare function AuthForm({ defaultMode, mode: controlledMode, onModeChange, showRememberMe, minPasswordLength, onSubmit, renderExtraFields, labels, ariaLabel, }: AuthFormProps): react_jsx_runtime.JSX.Element;
+
+/** Localized labels for the dynamic field form component. */
+interface DynamicFieldFormLabels {
+    addButton?: string;
+    submitButton?: string;
+    removeAriaLabel?: string;
+    itemLabel?: string;
+    itemPlaceholder?: string;
+    itemRequired?: string;
+}
+/** Props for the dynamic field form component. */
+interface DynamicFieldFormProps {
+    initialCount?: number;
+    minFields?: number;
+    maxFields?: number;
+    fieldType?: "text" | "email" | "url" | "number";
+    validateField?: (value: string, index: number) => string | undefined;
+    onSubmit?: (values: string[]) => void;
+    onFieldsChange?: (count: number) => void;
+    labels?: DynamicFieldFormLabels;
+    ariaLabel?: string;
+}
+/** Renders the dynamic field form component. */
+declare function DynamicFieldForm({ initialCount, minFields, maxFields, fieldType, validateField, onSubmit, onFieldsChange, labels, ariaLabel, }: DynamicFieldFormProps): react_jsx_runtime.JSX.Element;
+
+/** Localized labels for the file upload form component. */
+interface FileUploadFormLabels {
+    titleLabel?: string;
+    titlePlaceholder?: string;
+    titleRequired?: string;
+    descriptionLabel?: string;
+    descriptionPlaceholder?: string;
+    fileLabel?: string;
+    submitButton?: string;
+    successMessage?: string;
+    columnMappingLabel?: string;
+}
+/** Props for the file upload form component. */
+interface FileUploadFormProps {
+    accept?: string;
+    showPreview?: boolean;
+    showFileInfo?: boolean;
+    showDescription?: boolean;
+    descriptionRows?: number;
+    titleRequired?: boolean;
+    maxFileSize?: number;
+    onSubmit?: (values: {
+        title: string;
+        description: string;
+        file: File | null;
+    }) => void;
+    onFileChange?: (file: File | null) => void;
+    /** Called after file is selected to allow parsing/preview. Return ReactNode to show column mapping UI. */
+    onPreview?: (file: File) => void;
+    /** Custom column mapping UI rendered after file selection */
+    columnMapping?: ReactNode;
+    labels?: FileUploadFormLabels;
+    ariaLabel?: string;
+}
+/** Renders the file upload form component. */
+declare function FileUploadForm({ accept, showPreview, showFileInfo, showDescription, descriptionRows, titleRequired, maxFileSize, onSubmit, onFileChange, onPreview, columnMapping, labels, ariaLabel, }: FileUploadFormProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the wizard step shape. */
+interface WizardStepDef {
+    id: string;
+    label: string;
+    fields: string[];
+}
+/** Localized labels for the wizard form component. */
+interface WizardFormLabels {
+    stepsLabel?: string;
+    backButton?: string;
+    nextButton?: string;
+    submitButton?: string;
+    successMessage?: string;
+    resetLink?: string;
+    reviewTitle?: string;
+    emptyValue?: string;
+}
+/** Props for the wizard form component. */
+interface WizardFormProps {
+    fields: FormFieldDef[];
+    steps: WizardStepDef[];
+    showReview?: boolean;
+    onSubmit?: (values: Record<string, unknown>) => void;
+    onStepChange?: (stepIndex: number) => void;
+    resetOnSuccess?: boolean;
+    labels?: WizardFormLabels;
+    ariaLabel?: string;
+}
+/** Renders the wizard form component. */
+declare function WizardForm({ fields, steps, showReview, onSubmit, onStepChange, resetOnSuccess, labels, ariaLabel, }: WizardFormProps): react_jsx_runtime.JSX.Element;
+
+/** Popular icon names for picker UIs */
+declare const POPULAR_ICONS: readonly ["click", "eye", "search", "user", "shopping-cart", "credit-card", "heart", "star", "bell", "download", "upload", "share", "mail", "settings", "globe", "zap", "trending-up", "bar-chart", "check-circle", "x-circle"];
+/** Color presets for event icon backgrounds */
+declare const COLOR_PRESETS: readonly ["#3b82f6", "#8b5cf6", "#ec4899", "#ef4444", "#f59e0b", "#10b981", "#06b6d4", "#6366f1", "#f97316", "#14b8a6"];
+/** Props for the event icon component. */
+interface EventIconProps {
+    /** Semantic icon key, legacy icon key, or ReactNode */
+    icon: string | react.ReactNode;
+    /** Custom icon color; when omitted, theme accent tokens are used */
+    color?: string;
+    /** Icon size */
+    size?: "sm" | "md" | "lg";
+    className?: string;
+    labels?: EventIconLabels;
+}
+/** Localized labels for the event icon component. */
+interface EventIconLabels {
+    eventLabelPrefix?: string;
+    defaultAriaLabel?: string;
+}
+/** Renders the event icon component. */
+declare function EventIcon({ icon, color, size, className, labels: customLabels, }: EventIconProps): react_jsx_runtime.JSX.Element;
+declare namespace EventIcon {
+    var displayName: string;
+}
+
+/** Type definition for connection status. */
+type ConnectionStatus = "connected" | "disconnected" | "connecting" | "error";
+/** Props for the connection indicator component. */
+interface ConnectionIndicatorProps {
+    status: ConnectionStatus;
+    label?: string;
+    showLabel?: boolean;
+    className?: string;
+}
+/** Renders the connection indicator component. */
+declare function ConnectionIndicator({ status, label, showLabel, className, }: ConnectionIndicatorProps): react_jsx_runtime.JSX.Element;
+declare namespace ConnectionIndicator {
+    var displayName: string;
+}
+
+/** Defines the floating action shape. */
+interface FloatingAction {
+    id: string;
+    label: string;
+    icon?: react.ReactNode;
+    variant?: "default" | "primary" | "danger";
+    disabled?: boolean;
+}
+/** Props for the floating action bar component. */
+interface FloatingActionBarProps {
+    actions: FloatingAction[];
+    selectedCount?: number;
+    onAction: (actionId: string) => void;
+    onDismiss?: () => void;
+    className?: string;
+    labels?: FloatingActionBarLabels;
+}
+/** Localized labels for the floating action bar component. */
+interface FloatingActionBarLabels {
+    toolbarAriaLabel?: string;
+    selectedLabel?: (count: number) => string;
+    dismissAriaLabel?: string;
+}
+/** Renders the floating action bar component. */
+declare function FloatingActionBar({ actions, selectedCount, onAction, onDismiss, className, labels: customLabels, }: FloatingActionBarProps): react_jsx_runtime.JSX.Element | null;
+declare namespace FloatingActionBar {
+    var displayName: string;
+}
+
+/** Defines the template shape. */
+interface TemplateDef {
+    id: string;
+    name: string;
+    description?: string;
+    icon?: react.ReactNode;
+    category?: string;
+    featured?: boolean;
+    tags?: string[];
+}
+/** Localized labels for the template picker component. */
+interface TemplatePickerLabels {
+    ariaLabel?: string;
+    defaultCategory?: string;
+    searchPlaceholder?: string;
+    featuredBadge?: string;
+}
+/** Props for the template picker component. */
+interface TemplatePickerProps {
+    templates: TemplateDef[];
+    selected?: string;
+    onSelect: (templateId: string) => void;
+    labels?: TemplatePickerLabels;
+    showSearch?: boolean;
+    className?: string;
+}
+/** Renders the template picker component. */
+declare function TemplatePicker({ templates, selected, onSelect, labels: customLabels, showSearch, className, }: TemplatePickerProps): react_jsx_runtime.JSX.Element;
+declare namespace TemplatePicker {
+    var displayName: string;
+}
+
+/** Localized labels for the code snippet viewer component. */
+interface CodeSnippetViewerLabels {
+    copy?: string;
+    copied?: string;
+    codeRegion?: string;
+}
+/** Visual tone options for code snippet syntax surfaces. */
+type CodeSnippetSyntaxTheme = "default" | "muted" | "dark" | "terminal";
+/** Props for the code snippet viewer component. */
+interface CodeSnippetViewerProps {
+    code: string;
+    language?: string;
+    title?: string;
+    showLineNumbers?: boolean;
+    showCopyButton?: boolean;
+    maxHeight?: number;
+    syntaxTheme?: CodeSnippetSyntaxTheme;
+    className?: string;
+    labels?: CodeSnippetViewerLabels;
+}
+/** Renders the code snippet viewer component. */
+declare function CodeSnippetViewer({ code, language, title, showLineNumbers, showCopyButton, maxHeight, syntaxTheme, className, labels: customLabels, }: CodeSnippetViewerProps): react_jsx_runtime.JSX.Element;
+declare namespace CodeSnippetViewer {
+    var displayName: string;
+}
+
+/** Defines the property shape. */
+interface PropertyDef {
+    name: string;
+    type: string;
+    description?: string;
+    exampleValue?: string;
+    eventCount?: number;
+}
+/** Defines the property group shape. */
+interface PropertyGroup {
+    name: string;
+    properties: PropertyDef[];
+}
+/** Localized labels for the property explorer component. */
+interface PropertyExplorerLabels {
+    searchPlaceholder?: string;
+    noPropertiesFound?: string;
+}
+/** Props for the property explorer component. */
+interface PropertyExplorerProps {
+    groups: PropertyGroup[];
+    onSelect?: (property: PropertyDef) => void;
+    className?: string;
+    labels?: PropertyExplorerLabels;
+}
+/** Renders the property explorer component. */
+declare function PropertyExplorer({ groups, onSelect, className, labels: customLabels, }: PropertyExplorerProps): react_jsx_runtime.JSX.Element;
+declare namespace PropertyExplorer {
+    var displayName: string;
+}
+
+/** Localized labels for the query results table component. */
+interface QueryResultsTableLabels {
+    emptyMessage?: string;
+    loadingMessage?: string;
+    rowsSuffix?: string;
+}
+/** Props for the query results table component. */
+interface QueryResultsTableProps {
+    columns: string[];
+    rows: Array<Record<string, unknown>>;
+    maxHeight?: number;
+    emptyMessage?: string;
+    loading?: boolean;
+    error?: string;
+    labels?: QueryResultsTableLabels;
+    className?: string;
+}
+/** Renders the query results table component. */
+declare function QueryResultsTable({ columns, rows, maxHeight, emptyMessage, loading, error, labels: customLabels, className, }: QueryResultsTableProps): react_jsx_runtime.JSX.Element;
+declare namespace QueryResultsTable {
+    var displayName: string;
+}
+
+/** Defines the alert condition shape. */
+interface AlertCondition {
+    metric: string;
+    operator: "gt" | "lt" | "eq" | "gte" | "lte";
+    threshold: number;
+}
+/** Configuration for alert. */
+interface AlertConfig {
+    name: string;
+    conditions: AlertCondition[];
+    channels: string[];
+    frequency: "realtime" | "hourly" | "daily";
+    enabled: boolean;
+}
+/** Localized labels for the alert builder component. */
+interface AlertBuilderLabels {
+    alertNameLabel?: string;
+    conditionsLabel?: string;
+    metricLabel?: string;
+    operatorLabel?: string;
+    thresholdLabel?: string;
+    removeConditionLabel?: string;
+    addConditionButton?: string;
+    checkFrequencyLabel?: string;
+    notificationChannelsLabel?: string;
+    emptyMessage?: string;
+}
+/** Props for the alert builder component. */
+interface AlertBuilderProps {
+    value: AlertConfig;
+    onChange: (config: AlertConfig) => void;
+    metrics?: string[];
+    /** Dynamic event options for the metric selector. When provided, overrides `metrics`. */
+    eventOptions?: {
+        id: string;
+        name: string;
+    }[];
+    channels?: {
+        id: string;
+        label: string;
+    }[];
+    labels?: AlertBuilderLabels;
+    className?: string;
+}
+/** Renders the alert builder component. */
+declare function AlertBuilder({ value, onChange, metrics, eventOptions, channels, labels: customLabels, className, }: AlertBuilderProps): react_jsx_runtime.JSX.Element;
+declare namespace AlertBuilder {
+    var displayName: string;
+}
+
+/** Localized labels for the sql editor component. */
+interface SqlEditorLabels {
+    placeholder?: string;
+    runHint?: string;
+    runButton?: string;
+}
+/** Props for the sql editor component. */
+interface SqlEditorProps {
+    value: string;
+    onChange: (sql: string) => void;
+    onRun?: (sql: string) => void;
+    placeholder?: string;
+    readOnly?: boolean;
+    height?: number;
+    labels?: SqlEditorLabels;
+    className?: string;
+}
+/** Renders the sql editor component. */
+declare function SqlEditor({ value, onChange, onRun, placeholder, readOnly, height, labels: customLabels, className, }: SqlEditorProps): react_jsx_runtime.JSX.Element;
+declare namespace SqlEditor {
+    var displayName: string;
+}
+
+/** Defines the event meta shape. */
+interface EventMeta {
+    name: string;
+    displayName: string;
+    icon: string;
+    color: string;
+    tags: string[];
+    description: string;
+}
+/** Props for the event meta editor component. */
+interface EventMetaEditorProps {
+    value: EventMeta;
+    onChange: (meta: EventMeta) => void;
+    icons?: IconDef[];
+    className?: string;
+    labels?: EventMetaEditorLabels;
+}
+/** Localized labels for the event meta editor component. */
+interface EventMetaEditorLabels {
+    icon?: string;
+    color?: string;
+    name?: string;
+    displayName?: string;
+    description?: string;
+    tags?: string;
+    namePlaceholder?: string;
+    displayNamePlaceholder?: string;
+    descriptionPlaceholder?: string;
+    tagsPlaceholder?: string;
+    emptyTagsMessage?: string;
+}
+/** Renders the event meta editor component. */
+declare function EventMetaEditor({ value, onChange, icons, className, labels: customLabels, }: EventMetaEditorProps): react_jsx_runtime.JSX.Element;
+declare namespace EventMetaEditor {
+    var displayName: string;
+}
+
+/** Defines the widget shape. */
+interface WidgetDef {
+    id: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW?: number;
+    minH?: number;
+    content: react.ReactNode;
+}
+/** Props for the widget grid component. */
+interface WidgetGridProps {
+    widgets: WidgetDef[];
+    cols?: number;
+    rowHeight?: number;
+    gap?: number;
+    onLayoutChange?: (layout: Array<{
+        id: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>) => void;
+    /** Enable drag-to-reorder */
+    editable?: boolean;
+    /** Called when a widget is dragged to a new position */
+    onReorder?: (widgetId: string, fromIndex: number, toIndex: number) => void;
+    labels?: WidgetGridLabels;
+    className?: string;
+}
+/** Localized labels for the widget grid component. */
+interface WidgetGridLabels {
+    emptyMessage?: string;
+}
+/** Renders the widget grid component. */
+declare function WidgetGrid({ widgets, cols, rowHeight, gap, editable, onReorder, labels: customLabels, className, }: WidgetGridProps): react_jsx_runtime.JSX.Element;
+declare namespace WidgetGrid {
+    var displayName: string;
+}
+
+/** Type definition for report builder chart type. */
+type ReportBuilderChartType = "line" | "bar" | "pie" | "gauge" | "scatter" | "number" | "table" | "funnel" | "retention";
+/** Defines the chart type shape. */
+interface ChartTypeDef {
+    type: ReportBuilderChartType;
+    label: string;
+    icon: string;
+}
+/** Type definition for report builder step. */
+type ReportBuilderStep = "type" | "config" | "style" | "preview";
+/** Defines the data source shape. */
+interface DataSourceDef {
+    id: string;
+    label: string;
+    description?: string;
+}
+/** Localized labels for the report builder component. */
+interface ReportBuilderLabels {
+    /** Stepper label */
+    stepsLabel?: string;
+    /** Step labels */
+    stepType?: string;
+    stepConfig?: string;
+    stepStyle?: string;
+    stepPreview?: string;
+    /** Button labels */
+    nextButton?: string;
+    backButton?: string;
+    saveButton?: string;
+    cancelButton?: string;
+    /** Field labels */
+    reportNameLabel?: string;
+    reportNamePlaceholder?: string;
+    reportDescriptionLabel?: string;
+    reportDescriptionPlaceholder?: string;
+    dataSourceLabel?: string;
+    dataSourcePlaceholder?: string;
+    chartTypeHeading?: string;
+    /** Empty state */
+    noPreview?: string;
+    noConfigForm?: string;
+    noStyleForm?: string;
+}
+/**
+ * 4-step wizard for building custom reports:
+ * 1. **Type** — Select chart type from a grid of options
+ * 2. **Config** — Configure data source and chart-specific fields (slot: `configForm`)
+ * 3. **Style** — Adjust visual styling (slot: `styleForm`)
+ * 4. **Preview** — Live preview of the report (slot: `preview`)
+ *
+ * Steps 2-4 accept ReactNode slots so the parent can inject domain-specific forms.
+ */
+interface ReportBuilderProps {
+    /** Available chart types. Defaults to the built-in 9 types. */
+    chartTypes?: ChartTypeDef[];
+    /** Available data sources. */
+    dataSources?: DataSourceDef[];
+    /** Called when the user saves the report. */
+    onSave?: (report: {
+        name: string;
+        description: string;
+        chartType: ReportBuilderChartType;
+        dataSourceId: string;
+    }) => void;
+    /** Called when the user cancels. */
+    onCancel?: () => void;
+    /** ReactNode slot for chart-specific data configuration (step 2). */
+    configForm?: react.ReactNode;
+    /** ReactNode slot for chart-specific style configuration (step 3). */
+    styleForm?: react.ReactNode;
+    /** ReactNode slot for the live chart preview (step 4). */
+    preview?: react.ReactNode;
+    /** Called when the selected chart type changes. */
+    onChartTypeChange?: (type: ReportBuilderChartType) => void;
+    /** Called when the selected data source changes. */
+    onDataSourceChange?: (dataSourceId: string) => void;
+    /** Called when the current step changes. */
+    onStepChange?: (step: ReportBuilderStep) => void;
+    /** Externally controlled chart type selection. */
+    selectedChartType?: ReportBuilderChartType;
+    /** Externally controlled data source. */
+    selectedDataSource?: string;
+    /** Label overrides. */
+    labels?: ReportBuilderLabels;
+    /** Additional CSS classes. */
+    className?: string;
+}
+/** Renders the report builder component. */
+declare function ReportBuilder({ chartTypes, dataSources, onSave, onCancel, configForm, styleForm, preview, onChartTypeChange, onDataSourceChange, onStepChange, selectedChartType: controlledChartType, selectedDataSource: controlledDataSource, labels: customLabels, className, }: ReportBuilderProps): react_jsx_runtime.JSX.Element;
+declare namespace ReportBuilder {
+    var displayName: string;
+}
+
+/** Defines the audit change shape. */
+interface AuditChange {
+    field: string;
+    before: string;
+    after: string;
+}
+/** Defines the audit entry shape. */
+interface AuditEntry$1 {
+    id: string;
+    timestamp: string;
+    actor: string;
+    action: "created" | "updated" | "deleted";
+    summary: string;
+    changes?: AuditChange[];
+}
+/** Localized labels for the audit timeline component. */
+interface AuditTimelineLabels {
+    title?: string;
+    empty?: string;
+    expand?: string;
+    collapse?: string;
+    created?: string;
+    updated?: string;
+    deleted?: string;
+    fieldHeader?: string;
+    beforeHeader?: string;
+    afterHeader?: string;
+    diffArrow?: string;
+}
+/** Props for the audit timeline component. */
+interface AuditTimelineProps {
+    entries: AuditEntry$1[];
+    labels?: AuditTimelineLabels;
+    className?: string;
+    onEntryClick?: (entry: AuditEntry$1) => void;
+}
+/** Renders the audit timeline component. */
+declare function AuditTimeline({ entries, labels: customLabels, className, onEntryClick, }: AuditTimelineProps): react_jsx_runtime.JSX.Element;
+declare namespace AuditTimeline {
+    var displayName: string;
+}
+
+/** Type definition for segment condition type. */
+type SegmentConditionType = "event" | "property" | "cohort" | "custom";
+/** Defines the segment condition shape. */
+interface SegmentCondition {
+    id: string;
+    type: SegmentConditionType;
+    field: string;
+    operator: string;
+    value: string;
+}
+/** Defines the segment group shape. */
+interface SegmentGroup {
+    id: string;
+    combinator: "and" | "or";
+    conditions: SegmentCondition[];
+}
+/** Props for the segment builder component. */
+interface SegmentBuilderProps {
+    groups: SegmentGroup[];
+    onChange: (groups: SegmentGroup[]) => void;
+    eventOptions?: string[];
+    propertyOptions?: string[];
+    cohortOptions?: string[];
+    className?: string;
+    labels?: SegmentBuilderLabels;
+}
+/** Localized labels for the segment builder component. */
+interface SegmentBuilderLabels {
+    match?: string;
+    ofTheFollowing?: string;
+    groupLabel?: string;
+    conditionLabel?: string;
+    useOrCombinatorAriaLabel?: string;
+    conditionTypeLabel?: string;
+    fieldLabel?: string;
+    customFieldLabel?: string;
+    operatorLabel?: string;
+    valueLabel?: string;
+    removeGroupAriaLabel?: string;
+    removeConditionAriaLabel?: string;
+    addCondition?: string;
+    addGroup?: string;
+}
+/** Renders the segment builder component. */
+declare function SegmentBuilder({ groups, onChange, eventOptions, propertyOptions, cohortOptions, className, labels: customLabels, }: SegmentBuilderProps): react_jsx_runtime.JSX.Element;
+declare namespace SegmentBuilder {
+    var displayName: string;
+}
+
+/** Type definition for insight severity. */
+type InsightSeverity = "critical" | "warning" | "info";
+/** Defines the insight item shape. */
+interface InsightItem {
+    id: string;
+    type: string;
+    title: string;
+    description: string;
+    severity: InsightSeverity;
+    eventName?: string;
+    metrics?: Record<string, string | number>;
+    dismissed?: boolean;
+}
+/** Defines the insights stat shape. */
+interface InsightsStat {
+    id: string;
+    label: string;
+    count: number;
+    severity?: InsightSeverity | "total";
+}
+/** Defines the detection type shape. */
+interface DetectionTypeDef {
+    id: string;
+    label: string;
+    enabled: boolean;
+}
+/** Configuration for detection. */
+interface DetectionConfig {
+    days?: number;
+    zScoreThreshold?: number;
+}
+/** Localized labels for the insights panel component. */
+interface InsightsPanelLabels {
+    title?: string;
+    dismiss?: string;
+    showDismissed?: string;
+    hideDismissed?: string;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    detectionTitle?: string;
+    daysLabel?: string;
+    zScoreLabel?: string;
+}
+/** Props for the insights panel component. */
+interface InsightsPanelProps {
+    insights: InsightItem[];
+    stats?: InsightsStat[];
+    /** Detection type toggles (e.g., volume_anomaly, new_event, etc.) */
+    detectionTypes?: DetectionTypeDef[];
+    onDetectionTypeToggle?: (typeId: string, enabled: boolean) => void;
+    /** Detection parameters (lookback days, z-score threshold) */
+    detectionConfig?: DetectionConfig;
+    onDetectionConfigChange?: (config: DetectionConfig) => void;
+    onDismiss?: (id: string) => void;
+    onInsightClick?: (insight: InsightItem) => void;
+    onStatClick?: (statId: string) => void;
+    header?: react.ReactNode;
+    actions?: react.ReactNode;
+    labels?: InsightsPanelLabels;
+    className?: string;
+}
+/** Renders the insights panel component. */
+declare function InsightsPanel({ insights, stats, detectionTypes, onDetectionTypeToggle, detectionConfig, onDetectionConfigChange, onDismiss, onInsightClick, onStatClick, header, actions, labels: customLabels, className, }: InsightsPanelProps): react_jsx_runtime.JSX.Element;
+declare namespace InsightsPanel {
+    var displayName: string;
+}
+
+/** Defines the time preset shape. */
+interface TimePresetDef {
+    label: string;
+    days: number;
+}
+/** Localized labels for the time range selector component. */
+interface TimeRangeSelectorLabels {
+    title?: string;
+    placeholder?: string;
+}
+/** Props for the time range selector component. */
+interface TimeRangeSelectorProps {
+    value?: DateRange;
+    onChange?: (range: DateRange) => void;
+    presets?: TimePresetDef[];
+    labels?: TimeRangeSelectorLabels;
+    className?: string;
+}
+/** Renders the time range selector component. */
+declare function TimeRangeSelector({ value, onChange, presets, labels, className, }: TimeRangeSelectorProps): react_jsx_runtime.JSX.Element;
+declare namespace TimeRangeSelector {
+    var displayName: string;
+}
+
+/** Localized labels for the export button component. */
+interface ExportButtonLabels {
+    export?: string;
+    csv?: string;
+    json?: string;
+    pdf?: string;
+    guidedTitle?: string;
+    guidedDescription?: (rows: number, format: string) => string;
+    format?: string;
+    cancel?: string;
+}
+/** Props for the export button component. */
+interface ExportButtonProps {
+    data: Record<string, unknown>[];
+    columns?: ExportColumn[];
+    fileName?: string;
+    formats?: ExportFormat[];
+    onExport?: (format: ExportFormat) => void;
+    labels?: ExportButtonLabels;
+    /** Show a step-by-step dialog instead of a dropdown */
+    guided?: boolean;
+    className?: string;
+}
+/** Renders the export button component. */
+declare function ExportButton({ data, columns, fileName, formats, onExport, labels: customLabels, guided, className, }: ExportButtonProps): react_jsx_runtime.JSX.Element;
+declare namespace ExportButton {
+    var displayName: string;
+}
+
+/** Props for the loading overlay component. */
+interface LoadingOverlayProps extends react.HTMLAttributes<HTMLDivElement> {
+    loading: boolean;
+    children: react.ReactNode;
+    label?: string;
+}
+/** Renders the loading overlay component. */
+declare function LoadingOverlay({ loading, children, label, className, ...props }: LoadingOverlayProps): react_jsx_runtime.JSX.Element;
+declare namespace LoadingOverlay {
+    var displayName: string;
+}
+
+/** Localized labels for the summary row component. */
+interface SummaryRowLabels {
+    emptyTitle?: string;
+    emptyDescription?: string;
+}
+/** Props for the summary row component. */
+interface SummaryRowProps {
+    stats: StatCard[];
+    columns?: 2 | 3 | 4;
+    onStatClick?: (stat: StatCard) => void;
+    formatValue?: (stat: StatCard) => string;
+    durationFractionDigits?: number;
+    percentageFractionDigits?: number;
+    loading?: boolean;
+    labels?: SummaryRowLabels;
+    className?: string;
+}
+/** Renders the summary row component. */
+declare function SummaryRow({ stats, columns, onStatClick, formatValue, durationFractionDigits, percentageFractionDigits, loading, labels: customLabels, className, }: SummaryRowProps): react_jsx_runtime.JSX.Element;
+declare namespace SummaryRow {
+    var displayName: string;
+}
+
+/** Defines the comparison option shape. */
+interface ComparisonOption {
+    value: string;
+    label: string;
+}
+/** Localized labels for the comparison selector component. */
+interface ComparisonSelectorLabels {
+    groupLabel?: string;
+    selectorA?: string;
+    selectorB?: string;
+    swap?: string;
+    maxReached?: string;
+}
+/** Props for the comparison selector component. */
+interface ComparisonSelectorProps {
+    segments: ComparisonOption[];
+    valueA?: string;
+    valueB?: string;
+    onChangeA?: (value: string) => void;
+    onChangeB?: (value: string) => void;
+    /** Multi-select mode: selected values (overrides A/B selectors) */
+    values?: string[];
+    /** Called when multi-select values change */
+    onValuesChange?: (values: string[]) => void;
+    /** Maximum selectable items in multi-select mode (default: 5) */
+    maxItems?: number;
+    labels?: ComparisonSelectorLabels;
+    className?: string;
+}
+/** Renders the comparison selector component. */
+declare function ComparisonSelector({ segments, valueA, valueB, onChangeA, onChangeB, values, onValuesChange, maxItems, labels: customLabels, className, }: ComparisonSelectorProps): react_jsx_runtime.JSX.Element;
+declare namespace ComparisonSelector {
+    var displayName: string;
+}
+
+/**
+ * presets/index.ts
+ *
+ * Single registry of theme preset metadata. Each entry pairs a stable id
+ * (used in `<html data-theme>` and localStorage) with display metadata and an
+ * optional `PaletteConfig` that approximates the preset's seed for the
+ * ThemeSwitcher swatch row and "clone to custom" workflow.
+ *
+ * Token values themselves currently live in the sibling `*.css` files. A
+ * follow-up sub-phase will migrate the full token tables into this file and
+ * have a codegen step emit the CSS, but the metadata layer is enough to
+ * unblock dynamic ThemeSwitcher rendering and type-safe preset id unions.
+ */
+
+interface ThemeDescriptor {
+    /** Stable id used in `<html data-theme="...">` and localStorage. */
+    readonly id: string;
+    /** Human-readable label shown in ThemeSwitcher. */
+    readonly label: string;
+    /** Short description shown under the label. */
+    readonly description: string;
+    /**
+     * Optional engine input that approximates this preset. Used by
+     * ThemeSwitcher to derive swatches when `switcherSwatches` is omitted, and
+     * as the starting point when a user clones a preset into a custom palette.
+     * Codegen does NOT consume this in the current phase — the static `*.css`
+     * file remains the source of token values.
+     */
+    readonly palette?: PaletteConfig;
+    /**
+     * Three CSS color strings for the ThemeSwitcher swatch row. Falls back to
+     * the live `--opt-accent` / `--opt-surface` / `--opt-text` tokens when
+     * omitted.
+     */
+    readonly switcherSwatches?: readonly [string, string, string];
+    /** Disable dark variant generation entirely. */
+    readonly forceLightOnly?: boolean;
+}
+declare const THEME_REGISTRY: {
+    readonly default: ThemeDescriptor;
+    readonly minimal: ThemeDescriptor;
+    readonly natural: ThemeDescriptor;
+    readonly pro: ThemeDescriptor;
+    readonly "mono-dark": ThemeDescriptor;
+};
+/** Compile-time-derived union of registered preset ids. */
+type ThemePresetId = keyof typeof THEME_REGISTRY;
+/** All registered preset ids in declaration order. */
+declare const THEME_PRESET_IDS: ThemePresetId[];
+/** Look up a descriptor by id. Returns `undefined` for unknown ids. */
+declare function getThemeDescriptor(id: string): ThemeDescriptor | undefined;
+/** Type guard for a known preset id. */
+declare function isThemePresetId(id: string): id is ThemePresetId;
+/** Preset ids that suppress dark mode generation. */
+declare const FORCE_LIGHT_PRESET_IDS: ReadonlySet<ThemePresetId>;
+
+/** Theme preset id — alias of `ThemePresetId` from the registry. */
+type ThemePreset = ThemePresetId;
+declare const THEME_MODE_VALUES: readonly ["light", "dark", "system"];
+/** Type definition for theme mode. */
+type ThemeMode = (typeof THEME_MODE_VALUES)[number];
+/** Runtime constraints for apps that expose only a subset of opt-ui theming. */
+interface ThemeRuntimeOptions {
+    /**
+     * Force the root theme to one preset regardless of stored preset/generated
+     * theme state. Mode is still resolved normally unless constrained.
+     */
+    lockedPreset?: ThemePreset;
+    /**
+     * Restrict mode reads/writes to a smaller set, e.g. `["light", "dark"]`.
+     * The first value becomes the fallback when the stored/default mode is not
+     * allowed.
+     */
+    allowedModes?: readonly ThemeMode[];
+}
+/**
+ * Compound theme value applied to `<html data-theme>`. Derived from the
+ * registered preset ids: `<id>` (light) or `<id>-dark` (dark). Force-light
+ * presets only emit the bare id form.
+ */
+type CompoundTheme = `${ThemePreset}` | `${ThemePreset}-dark`;
+/**
+ * Presets that force light mode regardless of system dark/light preference.
+ * Mirrors `FORCE_LIGHT_PRESET_IDS` from `./presets` — kept as alias for
+ * existing imports.
+ */
+declare const FORCE_LIGHT_PRESETS: ReadonlySet<ThemePreset>;
+/** All valid compound theme names. Useful for static enumeration. */
+declare const ALL_COMPOUND_THEMES: CompoundTheme[];
+interface ThemeStorageReader {
+    getItem(key: string): string | null;
+}
+/** Compute compound theme name from preset + resolved mode. */
+declare function getCompoundTheme(preset: ThemePreset, resolvedMode: "light" | "dark"): CompoundTheme;
+/** Handles resolve theme mode. */
+declare function resolveThemeMode(preset: ThemePreset, mode: ThemeMode, systemDark: boolean): "light" | "dark";
+/** Handles read stored theme. */
+declare function readStoredTheme(storage: ThemeStorageReader, defaultPreset: ThemePreset, defaultMode: ThemeMode, options?: {
+    migrateLegacy?: boolean;
+}): {
+    preset: ThemePreset;
+    mode: ThemeMode;
+};
+/** Normalize a mode against an optional allowed-mode list. */
+declare function coerceThemeMode(mode: ThemeMode, allowedModes: readonly ThemeMode[] | undefined, fallback?: ThemeMode): ThemeMode;
+/**
+ * Build the inline `<head>` boot script that paints the correct theme before
+ * React mounts. Two paths:
+ *
+ * 1. **Generated** — when both `opt-theme-spec` (kind: "generated") and
+ *    `opt-theme-tokens` are present and well-formed, a `<style id="…">` tag
+ *    is inserted with the cached tokens and `<html data-theme>` is set to the
+ *    generated id (with optional `-dark` suffix). This bypasses opt-palette
+ *    at startup so first paint is instant.
+ * 2. **Preset (legacy)** — falls through to the existing preset selector,
+ *    including legacy `opt-theme` → `opt-preset` migration.
+ *
+ * Returned as a single minified line; intended for `dangerouslySetInnerHTML`.
+ */
+declare function createThemeBootScript(defaultPreset?: ThemePreset, defaultMode?: ThemeMode, options?: ThemeRuntimeOptions): string;
+
+/**
+ * theme-types.ts
+ *
+ * Discriminated union covering every way a consumer can describe a theme:
+ * a registered preset id, an inline `PaletteConfig` to feed the engine, or
+ * a fully formed `ThemeDescriptor`. Shared by `OptThemeProvider` and
+ * `ShellProvider` so generated themes built in the harness layer can be
+ * promoted into the global tree without translation.
+ */
+
+/**
+ * Sparse token overrides applied on top of the resolved theme. `light` and
+ * `dark` apply only to that mode; `shared` applies to both (handy for
+ * typography or radius tokens that should not invert).
+ */
+interface ThemeOverrides {
+    light?: Record<string, string>;
+    dark?: Record<string, string>;
+    shared?: Record<string, string>;
+}
+/** Canonical, typo-safe token map for authored product theme overrides. */
+type CanonicalThemeTokenMap = Partial<Record<OptTokenName, string>>;
+/** Mode-aware overrides restricted to the canonical token catalog. */
+interface CanonicalThemeOverrides {
+    light?: CanonicalThemeTokenMap;
+    dark?: CanonicalThemeTokenMap;
+    shared?: CanonicalThemeTokenMap;
+}
+/**
+ * Author canonical theme overrides with token-name autocomplete.
+ * ThemeOverrides remains broad for backward compatibility with older custom
+ * variables; new themes should use this helper as the governed entry point.
+ */
+declare function defineThemeOverrides(overrides: CanonicalThemeOverrides): CanonicalThemeOverrides;
+/** Reference an entry of `THEME_REGISTRY` by id. */
+interface PresetThemeSpec {
+    kind: "preset";
+    preset: ThemePresetId;
+    overrides?: ThemeOverrides;
+}
+/**
+ * Inline `PaletteConfig` consumed by the opt-palette engine to produce a
+ * canonical token palette at runtime.
+ */
+interface GeneratedThemeSpec {
+    kind: "generated";
+    /** Stable id used in `<html data-theme>` and the `<style>` selector. */
+    id?: string;
+    label?: string;
+    palette: PaletteConfig;
+    overrides?: ThemeOverrides;
+    forceLightOnly?: boolean;
+}
+/** Pass an already-built `ThemeDescriptor`. */
+interface DescriptorThemeSpec {
+    kind: "descriptor";
+    descriptor: ThemeDescriptor;
+    overrides?: ThemeOverrides;
+}
+/** Discriminated union covering every supported way to describe a theme. */
+type ThemeSpec = PresetThemeSpec | GeneratedThemeSpec | DescriptorThemeSpec;
+/** Construct a `PresetThemeSpec` — convenience for the common case. */
+declare function presetTheme(preset: ThemePresetId, overrides?: ThemeOverrides): PresetThemeSpec;
+/** Construct a `GeneratedThemeSpec` from an inline `PaletteConfig`. */
+declare function generatedTheme(palette: PaletteConfig, options?: Omit<GeneratedThemeSpec, "kind" | "palette">): GeneratedThemeSpec;
+/** True when `spec` references a registered preset id. */
+declare function isPresetSpec(spec: ThemeSpec): spec is PresetThemeSpec;
+/** True when `spec` carries an inline `PaletteConfig`. */
+declare function isGeneratedSpec(spec: ThemeSpec): spec is GeneratedThemeSpec;
+/** True when `spec` wraps a fully-formed `ThemeDescriptor`. */
+declare function isDescriptorSpec(spec: ThemeSpec): spec is DescriptorThemeSpec;
+/**
+ * Resolve a `ThemeSpec` down to a single descriptor + overrides pair. The
+ * returned descriptor is always sourced from the registry or the spec itself —
+ * the caller is responsible for engine-driven token generation when the
+ * descriptor only carries a `palette`.
+ */
+interface ResolvedThemeSpec {
+    descriptor: ThemeDescriptor;
+    overrides?: ThemeOverrides;
+}
+
+interface ThemeContextValue {
+    /** Active theme spec — preset or generated. */
+    theme: ThemeSpec;
+    /** Replace the active theme spec. No-op when controlled. */
+    setTheme: (spec: ThemeSpec) => void;
+    /**
+     * Last known preset id. Mirrors `theme.preset` when active spec is preset;
+     * otherwise reflects the most recent preset (useful for "back to preset").
+     */
+    preset: ThemePresetId;
+    /** Convenience: equivalent to `setTheme({ kind: "preset", preset })`. */
+    setPreset: (preset: ThemePresetId) => void;
+    mode: ThemeMode;
+    setMode: (mode: ThemeMode) => void;
+    resolvedMode: "light" | "dark";
+    /** True when `controlledTheme` prop is provided. setTheme is a no-op. */
+    isControlled: boolean;
+    /** True when the active spec (effective, including stack) is generated. */
+    isGenerated: boolean;
+    /**
+     * True when the effective theme comes from the promotion stack instead of
+     * persistence. Useful for surfaces that want to show "Preview" affordances.
+     */
+    isPromoted: boolean;
+}
+/** Props for `OptThemeProvider`. */
+interface OptThemeProviderProps {
+    children: React.ReactNode;
+    /**
+     * Initial theme spec used when nothing is persisted. Takes precedence over
+     * `defaultPreset`. Defaults to `{ kind: "preset", preset: defaultPreset }`.
+     */
+    defaultTheme?: ThemeSpec;
+    /**
+     * Fully controlled mode. When provided the provider mirrors this spec into
+     * the DOM but ignores localStorage and `setTheme` mutations. Useful for
+     * preview surfaces (e.g. the harness builder's "Apply globally").
+     */
+    controlledTheme?: ThemeSpec;
+    /**
+     * Legacy alias for `defaultTheme = { kind: "preset", preset: defaultPreset }`.
+     * Kept for backward compatibility with existing call sites.
+     */
+    defaultPreset?: ThemePreset;
+    defaultMode?: ThemeMode;
+    /**
+     * Force the root theme to a single preset while still allowing mode changes.
+     * Stored preset/generated themes are ignored while this is set.
+     */
+    lockedPreset?: ThemeRuntimeOptions["lockedPreset"];
+    /** Restrict the provider to a subset of modes, e.g. light/black only. */
+    allowedModes?: ThemeRuntimeOptions["allowedModes"];
+    /**
+     * Whether descendants may push transient themes onto the global stack.
+     * Defaults to true for backward compatibility.
+     */
+    allowThemePromotion?: boolean;
+}
+/** Renders the opt theme provider component. */
+declare function OptThemeProvider({ children, defaultTheme, controlledTheme, defaultPreset, defaultMode, lockedPreset, allowedModes, allowThemePromotion, }: OptThemeProviderProps): react_jsx_runtime.JSX.Element;
+/** Provides opt theme. */
+declare function useOptTheme(): ThemeContextValue;
+/** Reads opt theme context when present without requiring a provider. */
+declare function useOptionalOptTheme(): ThemeContextValue | undefined;
+
+/**
+ * theme-serialize.ts
+ *
+ * Pure helpers that turn a `ThemeSpec` into the artifacts the runtime needs:
+ * resolved descriptor + mode, computed token maps for generated palettes, and
+ * `<style>` CSS strings ready to be injected into `<head>`.
+ *
+ * Kept side-effect free so the boot script and the provider can share the
+ * same logic without dragging React into the client bundle's critical path.
+ */
+
+/** Element id used for the global generated theme style tag. */
+declare const GLOBAL_THEME_STYLE_ID = "opt-global-theme";
+/** localStorage key for the persisted ThemeSpec (generated mode). */
+declare const THEME_SPEC_STORAGE_KEY = "opt-theme-spec";
+/**
+ * localStorage key for the cached, pre-serialized token maps that match the
+ * spec under `THEME_SPEC_STORAGE_KEY`. The boot script reads this directly so
+ * it can inline tokens without invoking opt-palette at startup.
+ */
+declare const THEME_TOKENS_STORAGE_KEY = "opt-theme-tokens";
+/** Stable id used for unnamed generated themes. */
+declare const GENERATED_THEME_ID_DEFAULT = "generated";
+/**
+ * Stable id used in `<html data-theme>` and the `<style>` selector.
+ * - preset → the preset id (force-light) or `${id}` / `${id}-dark`
+ * - generated → `spec.id ?? "generated"` with `-dark` suffix when applicable
+ * - descriptor → `descriptor.id` with same suffix logic
+ */
+declare function getCompoundIdForSpec(spec: ThemeSpec, resolvedMode: "light" | "dark", forceLightOnly: boolean): string;
+/** Whether the given spec emits dark variants at all. */
+declare function isForceLightSpec(spec: ThemeSpec): boolean;
+/** Computed token bundle for a generated theme. `dark` is `null` when force-light. */
+interface GeneratedTokens {
+    id: string;
+    light: Record<string, string>;
+    dark: Record<string, string> | null;
+}
+/**
+ * Compute the inline tokens for a `GeneratedThemeSpec` or
+ * `DescriptorThemeSpec` whose descriptor carries a `palette`. Returns `null`
+ * for preset specs (their tokens live in the static CSS files).
+ */
+declare function computeGeneratedTokens(spec: ThemeSpec): GeneratedTokens | null;
+/**
+ * Serialize a token record into a CSS rule body — `--name:value;...` — without
+ * surrounding selector or braces. Values are not escaped; callers are
+ * responsible for trusted input. Boot script and provider both rely on this
+ * shape.
+ */
+declare function serializeTokenBody(tokens: Record<string, string>): string;
+/**
+ * Build a CSS rule scoped to `[data-theme="<id>"]`.
+ */
+declare function serializeThemeRule(themeId: string, tokens: Record<string, string>): string;
+/**
+ * Build the full CSS for a generated theme style tag — covers light + dark
+ * selectors based on the computed tokens. Caller chooses the id used in
+ * the selector (typically the spec base id).
+ */
+declare function serializeGeneratedTheme(tokens: GeneratedTokens): string;
+/**
+ * Resolve a spec into its descriptor counterpart. Preset specs map to
+ * `THEME_REGISTRY[preset]`. Generated specs are wrapped into a synthetic
+ * descriptor so callers can treat them uniformly.
+ */
+declare function resolveDescriptor(spec: ThemeSpec): ThemeDescriptor;
+/**
+ * Validate a `ThemeSpec` parsed from localStorage. Returns the spec on
+ * success or `null` if any required field is missing or the preset id is
+ * unknown. Defensive parsing — never throws.
+ */
+declare function safeParseStoredSpec(json: string | null): ThemeSpec | null;
+/** Cached token payload as written to `opt-theme-tokens`. */
+interface StoredTokenCache {
+    id: string;
+    light: Record<string, string>;
+    dark?: Record<string, string>;
+}
+/**
+ * Parse the cached token payload from localStorage. Returns `null` on any
+ * shape mismatch — caller will recompute from the spec.
+ */
+declare function safeParseStoredTokens(json: string | null): StoredTokenCache | null;
+/** Build the storage payload that pairs with `opt-theme-spec`. */
+declare function buildTokenCache(tokens: GeneratedTokens): StoredTokenCache;
+
+/** A single entry on the theme promotion stack. */
+interface ThemeStackEntry {
+    /** Stable owner id (e.g. harness id) — used to dedupe and pop. */
+    id: string;
+    /** Spec the owner wants applied while it is mounted. */
+    spec: ThemeSpec;
+}
+/**
+ * Imperative API exposed by `OptThemeProvider` to descendants that want to
+ * temporarily override the global theme without owning persistence (e.g. the
+ * harness builder previewing a generated palette).
+ *
+ * Contract:
+ *   - `pushTheme(id, spec)` re-pushes (replacing) any existing entry with the
+ *     same id, preserving stack order otherwise.
+ *   - `popTheme(id)` removes the entry with the given id, no-op if absent.
+ *   - The top of the stack wins. When the stack is empty the provider falls
+ *     back to its `controlledTheme` prop, then to its persisted state.
+ */
+interface OptThemeController {
+    pushTheme: (id: string, spec: ThemeSpec) => void;
+    popTheme: (id: string) => void;
+}
+declare const OptThemeControllerContext: react.Context<OptThemeController | null>;
+/**
+ * Reads the controller exposed by the nearest `OptThemeProvider`. Returns
+ * `null` when used outside a provider — callers should treat that as "no
+ * promotion available" and behave as if scope === "override".
+ */
+declare function useOptThemeController(): OptThemeController | null;
+
+/** Localized labels for the theme switcher component. */
+interface ThemeSwitcherLabels {
+    /** Section heading shown above the preset grid. */
+    heading?: string;
+    /** Localized labels for the mode toggle (light/dark/system). */
+    modeLabels?: Partial<Record<ThemeMode, string>>;
+    /** Suffix added to the active preset's swatch button (a11y only). */
+    activeSuffix?: string;
+}
+/** Props for the theme switcher component. */
+interface ThemeSwitcherProps {
+    className?: string;
+    labels?: ThemeSwitcherLabels;
+    variant?: "default" | "compact";
+    /** Slot for custom CSS variable editor (e.g. ColorPicker panel) */
+    customPresetEditor?: React.ReactNode;
+    /**
+     * Controlled preset for local preview surfaces. When provided, preset
+     * changes call `onPresetChange` instead of mutating the global provider.
+     */
+    preset?: ThemePresetId;
+    onPresetChange?: (preset: ThemePresetId) => void;
+    /** Controlled mode for local preview surfaces. */
+    mode?: ThemeMode;
+    onModeChange?: (mode: ThemeMode) => void;
+}
+/** Renders the theme switcher component. */
+declare function ThemeSwitcher({ className, labels: userLabels, variant, customPresetEditor, preset: controlledPreset, onPresetChange, mode: controlledMode, onModeChange, }: ThemeSwitcherProps): react_jsx_runtime.JSX.Element | null;
+declare namespace ThemeSwitcher {
+    var displayName: string;
+}
+
+/** Defines the prompt variable shape. */
+interface PromptVariable {
+    name: string;
+    label: string;
+    placeholder?: string;
+    defaultValue?: string;
+}
+/** Localized labels for the prompt template component. */
+interface PromptTemplateLabels {
+    copy?: string;
+    copied?: string;
+    copyFailed?: string;
+}
+/** Props for the prompt template component. */
+interface PromptTemplateProps {
+    title: string;
+    description?: string;
+    template: string;
+    variables?: PromptVariable[];
+    className?: string;
+    labels?: PromptTemplateLabels;
+}
+/** Renders the prompt template component. */
+declare function PromptTemplate({ title, description, template, variables, className, labels: customLabels, }: PromptTemplateProps): react_jsx_runtime.JSX.Element;
+declare namespace PromptTemplate {
+    var displayName: string;
+}
+
+interface SidebarContextValue {
+    collapsed: boolean;
+    collapsible: boolean;
+    setCollapsed: (value: boolean) => void;
+    toggle: () => void;
+    width: number;
+    collapsedWidth: number;
+}
+/** Provides sidebar. */
+declare function useSidebar(): SidebarContextValue;
+/** Props for the sidebar component. */
+interface SidebarProps {
+    children: react.ReactNode;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    collapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    width?: number;
+    collapsedWidth?: number;
+    className?: string;
+    side?: "left" | "right";
+    /** aside에 적용할 aria-label */
+    label?: string;
+}
+declare function SidebarHeader({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace SidebarHeader {
+    var displayName: string;
+}
+declare function SidebarContent({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace SidebarContent {
+    var displayName: string;
+}
+declare function SidebarFooter({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace SidebarFooter {
+    var displayName: string;
+}
+declare function SidebarTrigger({ className, children, }: {
+    className?: string;
+    children?: react.ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare namespace SidebarTrigger {
+    var displayName: string;
+}
+interface SidebarGroupProps {
+    children: react.ReactNode;
+    /** 그룹 레이블. 접힌 상태에서 숨겨짐 */
+    label?: string;
+    className?: string;
+}
+declare function SidebarGroup({ children, label, className }: SidebarGroupProps): react_jsx_runtime.JSX.Element;
+declare namespace SidebarGroup {
+    var displayName: string;
+}
+interface SidebarItemProps {
+    children: react.ReactNode;
+    /** 아이콘 (접힌 상태에서도 표시) */
+    icon?: react.ReactNode;
+    /** 활성 상태 */
+    active?: boolean;
+    /** 클릭 핸들러 */
+    onClick?: () => void;
+    /** 링크 URL — 설정 시 <a> 태그로 렌더링 */
+    href?: string;
+    /** 접힌 상태에서 표시할 툴팁 텍스트 */
+    tooltip?: string;
+    /** 우측 배지 (숫자 또는 ReactNode). 접힌 상태에서 아이콘 위 dot으로 축소 */
+    badge?: react.ReactNode;
+    className?: string;
+}
+declare function SidebarItem({ children, icon, active, onClick, href, tooltip, badge, className, }: SidebarItemProps): react_jsx_runtime.JSX.Element;
+declare namespace SidebarItem {
+    var displayName: string;
+}
+declare function SidebarSeparator({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace SidebarSeparator {
+    var displayName: string;
+}
+declare function SidebarRoot({ children, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, width, collapsedWidth, className, side, label, }: SidebarProps): react_jsx_runtime.JSX.Element;
+declare namespace SidebarRoot {
+    var displayName: string;
+}
+declare const Sidebar: typeof SidebarRoot & {
+    Header: typeof SidebarHeader;
+    Content: typeof SidebarContent;
+    Footer: typeof SidebarFooter;
+    Trigger: typeof SidebarTrigger;
+    Group: typeof SidebarGroup;
+    Item: typeof SidebarItem;
+    Separator: typeof SidebarSeparator;
+};
+
+declare function AppShellHeader({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace AppShellHeader {
+    var displayName: string;
+}
+declare function AppShellSidebar({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace AppShellSidebar {
+    var displayName: string;
+}
+declare function AppShellContent({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace AppShellContent {
+    var displayName: string;
+}
+declare function AppShellFooter({ children, className, }: {
+    children: react.ReactNode;
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+declare namespace AppShellFooter {
+    var displayName: string;
+}
+/** Props for the app shell component. */
+interface AppShellProps {
+    children: react.ReactNode;
+    className?: string;
+    labels?: AppShellLabels;
+}
+/** Localized labels for the app shell component. */
+type AppShellLabels = Record<never, never>;
+declare function AppShellRoot({ children, className }: AppShellProps): react_jsx_runtime.JSX.Element | null;
+declare namespace AppShellRoot {
+    var displayName: string;
+}
+declare const AppShell: typeof AppShellRoot & {
+    Header: typeof AppShellHeader;
+    Sidebar: typeof AppShellSidebar;
+    Content: typeof AppShellContent;
+    Footer: typeof AppShellFooter;
+};
+
+/** Props for the confirm dialog component. */
+interface ConfirmDialogProps {
+    open: boolean;
+    onConfirm: () => void;
+    onCancel: () => void;
+    title: string;
+    description?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    variant?: "default" | "danger";
+    children?: ReactNode;
+}
+/** Renders the confirm dialog component. */
+declare function ConfirmDialog({ open, onConfirm, onCancel, title, description, confirmLabel, cancelLabel, variant, children, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
+declare namespace ConfirmDialog {
+    var displayName: string;
+}
+
+/** Localized labels for the async combobox component. */
+interface AsyncComboboxLabels {
+    input?: string;
+    loading?: string;
+    noResults?: string;
+    placeholder?: string;
+}
+/** Props for the async combobox component. */
+interface AsyncComboboxProps {
+    onSearch: (query: string) => Promise<string[]>;
+    debounceMs?: number;
+    /** @deprecated Use labels.loading instead */
+    loadingText?: string;
+    minChars?: number;
+    /** @deprecated Use labels.placeholder instead */
+    placeholder?: string;
+    onSelect?: (value: string) => void;
+    labels?: AsyncComboboxLabels;
+    className?: string;
+}
+/** Renders the async combobox component. */
+declare function AsyncCombobox({ onSearch, debounceMs, loadingText, minChars, placeholder, onSelect, labels: customLabels, className, }: AsyncComboboxProps): react_jsx_runtime.JSX.Element;
+
+/** Props for the vertical tabs component. */
+interface VerticalTabsProps {
+    tabs: TabDef[];
+    defaultTabId?: string;
+    labels?: VerticalTabsLabels;
+    className?: string;
+}
+/** Localized labels for the vertical tabs component. */
+interface VerticalTabsLabels {
+    ariaLabel?: string;
+    emptyMessage?: string;
+}
+/** Renders the vertical tabs component. */
+declare function VerticalTabs({ tabs, defaultTabId, labels: customLabels, className, }: VerticalTabsProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the column toggler column shape. */
+interface ColumnTogglerColumn {
+    id: string;
+    header: string;
+}
+/** Props for the column toggler component. */
+interface ColumnTogglerProps {
+    columns: ColumnTogglerColumn[];
+    visibleColumns: string[];
+    onChange: (visibleColumns: string[]) => void;
+    className?: string;
+    labels?: ColumnTogglerLabels;
+}
+/** Localized labels for the column toggler component. */
+interface ColumnTogglerLabels {
+    triggerLabel?: (count: number) => string;
+    emptyMessage?: string;
+}
+/** Renders the column toggler component. */
+declare function ColumnToggler({ columns, visibleColumns, onChange, className, labels: customLabels, }: ColumnTogglerProps): react_jsx_runtime.JSX.Element;
+declare namespace ColumnToggler {
+    var displayName: string;
+}
+
+/** Defines the bulk action shape. */
+interface BulkActionDef {
+    id: string;
+    label: string;
+    variant?: "default" | "danger";
+}
+/** Localized labels for the bulk actions component. */
+interface BulkActionsLabels {
+    selected?: string;
+    actions?: string;
+    clear?: string;
+    noActions?: string;
+}
+/** Props for the bulk actions component. */
+interface BulkActionsProps {
+    selectedCount: number;
+    actions: BulkActionDef[];
+    onAction: (actionId: string) => void;
+    onClear: () => void;
+    labels?: BulkActionsLabels;
+    className?: string;
+}
+/** Renders the bulk actions component. */
+declare function BulkActions({ selectedCount, actions, onAction, onClear, labels: customLabels, className, }: BulkActionsProps): react_jsx_runtime.JSX.Element | null;
+
+/** Defines the filter preset shape. */
+interface FilterPreset {
+    id: string;
+    name: string;
+    filters: Record<string, unknown>;
+}
+/** Props for the saved filters component. */
+interface SavedFiltersProps {
+    currentFilters: Record<string, unknown>;
+    presets: FilterPreset[];
+    onSavePreset: (name: string, filters: Record<string, unknown>) => void;
+    onLoadPreset: (preset: FilterPreset) => void;
+    onDeletePreset: (presetId: string) => void;
+    className?: string;
+    labels?: SavedFiltersLabels;
+}
+/** Localized labels for the saved filters component. */
+interface SavedFiltersLabels {
+    triggerLabel?: (count: number) => string;
+    emptyMessage?: string;
+    deleteLabel?: (name: string) => string;
+    namePlaceholder?: string;
+    saveLabel?: string;
+}
+/** Renders the saved filters component. */
+declare function SavedFilters({ currentFilters, presets, onSavePreset, onLoadPreset, onDeletePreset, className, labels: customLabels, }: SavedFiltersProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the notification item shape. */
+interface NotificationItem {
+    id: string;
+    title: string;
+    message: string;
+    time: string;
+    read: boolean;
+    group?: string;
+    actionLabel?: string;
+}
+/** Props for the notification center component. */
+interface NotificationCenterProps {
+    notifications: NotificationItem[];
+    onMarkRead: (id: string) => void;
+    onMarkAllRead: () => void;
+    onAction?: (id: string) => void;
+    className?: string;
+    labels?: NotificationCenterLabels;
+}
+/** Localized labels for the notification center component. */
+interface NotificationCenterLabels {
+    triggerLabel?: string;
+    unreadSuffix?: (count: number) => string;
+    title?: string;
+    markAllRead?: string;
+    emptyMessage?: string;
+}
+/** Renders the notification center component. */
+declare function NotificationCenter({ notifications, onMarkRead, onMarkAllRead, onAction, className, labels: customLabels, }: NotificationCenterProps): react_jsx_runtime.JSX.Element;
+declare namespace NotificationCenter {
+    var displayName: string;
+}
+
+/** Defines the audit entry shape. */
+interface AuditEntry {
+    id: string;
+    user: {
+        name: string;
+        avatar?: string;
+    };
+    action: string;
+    target: string;
+    timestamp: string;
+    metadata?: Record<string, string>;
+}
+/** Localized labels for the audit log component. */
+interface AuditLogLabels {
+    title?: string;
+    loading?: string;
+    loadMore?: string;
+    empty?: string;
+}
+/** Props for the audit log component. */
+interface AuditLogProps {
+    entries: AuditEntry[];
+    onLoadMore?: () => void;
+    loading?: boolean;
+    labels?: AuditLogLabels;
+    className?: string;
+}
+/** Renders the audit log component. */
+declare function AuditLog({ entries, onLoadMore, loading, labels: customLabels, className, }: AuditLogProps): react_jsx_runtime.JSX.Element;
+declare namespace AuditLog {
+    var displayName: string;
+}
+
+/** Defines the tree column shape. */
+interface TreeColumnDef<T> {
+    id: string;
+    header: string;
+    accessor: keyof T | ((row: T) => react.ReactNode);
+    width?: string;
+}
+/** Defines the tree node shape. */
+interface TreeNode<T> {
+    data: T;
+    id: string;
+    children?: TreeNode<T>[];
+}
+/** Props for the tree table component. */
+interface TreeTableProps<T> {
+    data: TreeNode<T>[];
+    columns: TreeColumnDef<T>[];
+    defaultExpanded?: string[];
+    indentSize?: number;
+    className?: string;
+}
+/** Renders the tree table component. */
+declare function TreeTable<T>({ data, columns, defaultExpanded, indentSize, className, }: TreeTableProps<T>): react_jsx_runtime.JSX.Element;
+
+/** Defines the inline edit column shape. */
+interface InlineEditColumnDef<T> {
+    id: string;
+    header: string;
+    accessor: keyof T | ((row: T) => react.ReactNode);
+    editable?: boolean;
+    width?: string;
+}
+/** Props for the inline edit table component. */
+interface InlineEditTableProps<T> {
+    data: T[];
+    columns: InlineEditColumnDef<T>[];
+    keyExtractor: (row: T) => string;
+    onCellEdit?: (rowId: string, columnId: string, value: string) => void;
+    labels?: InlineEditTableLabels;
+    className?: string;
+}
+/** Localized labels for the inline edit table component. */
+interface InlineEditTableLabels {
+    emptyMessage?: string;
+}
+/** Renders the inline edit table component. */
+declare function InlineEditTable<T>({ data, columns, keyExtractor, onCellEdit, labels: customLabels, className, }: InlineEditTableProps<T>): react_jsx_runtime.JSX.Element;
+
+/** Defines the kanban column shape. */
+interface KanbanColumn<T> {
+    id: string;
+    title: string;
+    items: T[];
+}
+/** Props for the kanban board component. */
+interface KanbanBoardProps<T> {
+    columns: KanbanColumn<T>[];
+    onDragEnd: (itemId: string, fromColumnId: string, toColumnId: string, toIndex: number) => void;
+    renderCard: (item: T) => react.ReactNode;
+    keyExtractor: (item: T) => string;
+    emptyMessage?: string;
+    className?: string;
+}
+/** Renders the kanban board component. */
+declare function KanbanBoard<T>({ columns, onDragEnd, renderCard, keyExtractor, emptyMessage, className, }: KanbanBoardProps<T>): react_jsx_runtime.JSX.Element;
+
+type ToolbarAction = "bold" | "italic" | "link" | "code" | "heading" | "list" | "quote";
+/** Props for the rich text editor component. */
+interface RichTextEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    toolbar?: ToolbarAction[];
+    className?: string;
+}
+/** Renders the rich text editor component. */
+declare function RichTextEditor({ value, onChange, placeholder, toolbar, className, }: RichTextEditorProps): react_jsx_runtime.JSX.Element;
+
+/** Props for the code diff viewer component. */
+interface CodeDiffViewerProps {
+    original: string;
+    modified: string;
+    mode?: "split" | "unified";
+    showLineNumbers?: boolean;
+    scrollLabel?: string;
+    className?: string;
+}
+/** Renders the code diff viewer component. */
+declare function CodeDiffViewer({ original, modified, mode, showLineNumbers, scrollLabel, className, }: CodeDiffViewerProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the webhook shape. */
+interface WebhookDef {
+    url: string;
+    events: string[];
+    retries: number;
+    active: boolean;
+}
+/** Props for the webhook component. */
+interface WebhookConfigProps {
+    webhook: WebhookDef;
+    onChange: (webhook: WebhookDef) => void;
+    availableEvents: string[];
+    onTest?: () => void;
+    className?: string;
+    labels?: WebhookConfigLabels;
+}
+/** Localized labels for the webhook component. */
+interface WebhookConfigLabels {
+    webhookUrl?: string;
+    events?: string;
+    retries?: string;
+    testWebhook?: string;
+    emptyEventsMessage?: string;
+}
+/** Renders the webhook config component. */
+declare function WebhookConfig({ webhook, onChange, availableEvents, onTest, className, labels: customLabels, }: WebhookConfigProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the feature flag shape. */
+interface FeatureFlag {
+    id: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    environments: string[];
+    rolloutPercentage?: number;
+}
+/** Props for the feature flag panel component. */
+interface FeatureFlagPanelProps {
+    flags: FeatureFlag[];
+    onToggle: (flagId: string, enabled: boolean) => void;
+    onRolloutChange?: (flagId: string, percentage: number) => void;
+    environments: string[];
+    className?: string;
+    labels?: FeatureFlagPanelLabels;
+}
+/** Localized labels for the feature flag panel component. */
+interface FeatureFlagPanelLabels {
+    enabled?: string;
+    disabled?: string;
+    rolloutLabel?: string;
+    emptyMessage?: string;
+}
+/** Renders the feature flag panel component. */
+declare function FeatureFlagPanel({ flags, onToggle, onRolloutChange, environments, className, labels: customLabels, }: FeatureFlagPanelProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the import field shape. */
+interface ImportFieldDef {
+    id: string;
+    label: string;
+    required?: boolean;
+}
+/** Localized labels for the data import wizard component. */
+interface DataImportWizardLabels {
+    stepsLabel?: string;
+    upload?: string;
+    mapColumns?: string;
+    preview?: string;
+    confirm?: string;
+    dropPrompt?: string;
+    selectColumn?: string;
+    back?: string;
+    next?: string;
+    import?: string;
+    uploadFileAriaLabel?: string;
+    previewSummary?: (shown: number, total: number) => string;
+    confirmSummary?: (rows: number, mappedFields: number) => string;
+}
+/** Props for the data import wizard component. */
+interface DataImportWizardProps {
+    fields: ImportFieldDef[];
+    onImport: (mapping: Record<string, string>, data: string[][]) => void;
+    acceptedFormats?: string;
+    labels?: DataImportWizardLabels;
+    className?: string;
+}
+/** Renders the data import wizard component. */
+declare function DataImportWizard({ fields, onImport, acceptedFormats, labels: customLabels, className, }: DataImportWizardProps): react_jsx_runtime.JSX.Element;
+
+/** Defines the mega menu item shape. */
+interface MegaMenuItem {
+    label: string;
+    href?: string;
+    description?: string;
+    icon?: react.ReactNode;
+}
+/** Defines the mega menu section shape. */
+interface MegaMenuSection {
+    title: string;
+    items: MegaMenuItem[];
+}
+/** Props for the mega menu component. */
+interface MegaMenuProps {
+    menus: MegaMenuSection[];
+    columns?: number;
+    footer?: react.ReactNode;
+    triggerLabel?: string;
+    labels?: MegaMenuLabels;
+    className?: string;
+}
+/** Localized labels for the mega menu component. */
+interface MegaMenuLabels {
+    trigger?: string;
+}
+/** Renders the mega menu component. */
+declare function MegaMenu({ menus, columns, footer, triggerLabel, labels: customLabels, className, }: MegaMenuProps): react_jsx_runtime.JSX.Element | null;
+declare namespace MegaMenu {
+    var displayName: string;
+}
+
+/** Localized labels for the chat sidebar component. */
+interface ChatSidebarLabels {
+    newChat?: string;
+    searchPlaceholder?: string;
+    emptyTitle?: string;
+    emptyDescription?: string;
+}
+/** Props for the chat sidebar component. */
+interface ChatSidebarProps {
+    conversations: ChatConversationDef[];
+    activeConversationId?: string;
+    onConversationSelect?: (conversation: ChatConversationDef) => void;
+    onNewChat?: () => void;
+    onSearch?: (query: string) => void;
+    labels?: ChatSidebarLabels;
+    className?: string;
+}
+/** Renders the chat sidebar component. */
+declare function ChatSidebar({ conversations, activeConversationId, onConversationSelect, onNewChat, onSearch, labels: customLabels, className, }: ChatSidebarProps): react_jsx_runtime.JSX.Element;
+declare namespace ChatSidebar {
+    var displayName: string;
+}
+
+/** Localized labels for the chat input component. */
+interface ChatInputLabels {
+    placeholder?: string;
+    send?: string;
+    attach?: string;
+    hint?: string;
+    modelLabel?: string;
+    styleLabel?: string;
+    shiftKey?: string;
+    enterKey?: string;
+}
+/** Props for the chat input component. */
+interface ChatInputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onSend?: (message: string) => void;
+    onFileAttach?: () => void;
+    models?: ChatModelDef[];
+    selectedModel?: string;
+    onModelChange?: (modelId: string) => void;
+    stylePresets?: ChatStylePresetDef[];
+    selectedStyle?: string;
+    onStyleChange?: (styleId: string) => void;
+    disabled?: boolean;
+    maxRows?: number;
+    showHint?: boolean;
+    labels?: ChatInputLabels;
+    className?: string;
+}
+/** Renders the chat input component. */
+declare function ChatInput({ value: controlledValue, defaultValue, onChange, onSend, onFileAttach, models, selectedModel, onModelChange, stylePresets, selectedStyle, onStyleChange, disabled, maxRows, showHint, labels: customLabels, className, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+declare namespace ChatInput {
+    var displayName: string;
+}
+
+/** Localized labels for the chat message list component. */
+interface ChatMessageListLabels {
+    emptyTitle?: string;
+    emptyDescription?: string;
+    userLabel?: string;
+    assistantLabel?: string;
+    typingLabel?: string;
+}
+/** Props for the chat message list component. */
+interface ChatMessageListProps {
+    messages: ChatMessageDef[];
+    loading?: boolean;
+    renderContent?: (message: ChatMessageDef) => ReactNode;
+    assistantAvatar?: string;
+    userName?: string;
+    showTimestamps?: boolean;
+    autoScroll?: boolean;
+    labels?: ChatMessageListLabels;
+    className?: string;
+}
+/** Renders the chat message list component. */
+declare function ChatMessageList({ messages, loading, renderContent, assistantAvatar, userName, showTimestamps, autoScroll, labels: customLabels, className, }: ChatMessageListProps): react_jsx_runtime.JSX.Element;
+declare namespace ChatMessageList {
+    var displayName: string;
+}
+
+/**
+ * 페이지 전환 시 새 콘텐츠의 h1으로 포커스를 이동한다.
+ * 포커스가 body로 빠지는 것을 방지하고,
+ * 스크린 리더가 새 페이지 제목을 즉시 읽어줄 수 있게 한다.
+ */
+declare function RouteFocusManager(): null;
+
+/** Props for the design guide panel component. */
+interface DesignGuidePanelProps {
+    className?: string;
+}
+/** Renders the design guide panel component. */
+declare function DesignGuidePanel({ className }: DesignGuidePanelProps): react_jsx_runtime.JSX.Element;
+
+/** Handles cn. */
+declare function cn(...inputs: ClassValue[]): string;
+
+declare const OPT_TEXT_PRIMARY = "text-text-primary";
+declare const OPT_TEXT_SECONDARY = "text-text-secondary";
+
+/**
+ * Generates a stable component ID from label text.
+ * Eliminates the duplicated `id ?? label?.replace(...)` pattern across input components.
+ */
+declare function useInputId(id: string | undefined, label: string | undefined, prefix: string): string | undefined;
+
+/**
+ * Manages controlled/uncontrolled state for input components.
+ * When `controlledValue` is provided, acts as controlled; otherwise uses internal state.
+ */
+declare function useControlledState<T>(defaultValue: T, controlledValue: T | undefined, onChange: ((value: T) => void) | undefined): [T, (value: T) => void];
+
+type OptDateInput = string | number | Date;
+/** Formats a date as Korean short date text in the opt-ui default timezone. */
+declare function formatOptShortDate(input: OptDateInput): string;
+/** Formats a date as Korean clock time in the opt-ui default timezone. */
+declare function formatOptTime(input: OptDateInput): string;
+/** Formats a date as Korean date-time text in the opt-ui default timezone. */
+declare function formatOptDateTime(input: OptDateInput): string;
+/** Formats numbers without depending on the runtime default locale. */
+declare function formatOptNumber(value: number): string;
+
+/** Type definition for direction. */
+type Direction = "up" | "down" | "left" | "right";
+/** Handles should skip arrow. */
+declare function shouldSkipArrow(el: HTMLElement, dir: Direction): boolean;
+/** Returns trapped context role. */
+declare function getTrappedContextRole(el: HTMLElement): string | null;
+/** Defines the spatial target shape. */
+interface SpatialTarget {
+    direction: Direction;
+    element: HTMLElement;
+    score: number;
+}
+/** Handles compute spatial targets. */
+declare function computeSpatialTargets(current: HTMLElement): SpatialTarget[];
+/** Defines the spatial nav decision detail shape. */
+interface SpatialNavDecisionDetail {
+    direction: Direction;
+    result: "moved" | "skipped";
+    reason?: "defaultPrevented" | "input-protection" | "trapped-context" | "no-candidate";
+    context?: string;
+    target?: HTMLElement;
+}
+/** Renders the spatial nav provider component. */
+declare function SpatialNavProvider(): null;
+
+/**
+ * opt-ui Korean default labels.
+ *
+ * Components consume these as defaults so consumers don't have to pass labels
+ * for the most common case. Korean is the package default — other locales
+ * should be imported explicitly (e.g. `enLabels`) and passed via component
+ * props or wrapped with a labels provider.
+ */
+declare const koComboboxLabels: {
+    readonly empty: "결과가 없습니다.";
+};
+declare const koStarRatingLabels: {
+    /** {value}/{max}점 — readonly fallback aria-label */
+    readonly readonlyAriaLabel: "{value}/{max}점";
+    /** rating group aria-label */
+    readonly groupAriaLabel: "별점";
+    /** {star}점 — individual star aria-label */
+    readonly starAriaLabel: "{star}점";
+};
+declare const koBreadcrumbLabels: {
+    /** {label}(으)로 이동 */
+    readonly navAriaLabel: "{label}(으)로 이동";
+};
+
+/** opt-ui English label catalog (opt-in alternative to `koLabels`). */
+declare const enComboboxLabels: {
+    readonly empty: "No results.";
+};
+declare const enStarRatingLabels: {
+    readonly readonlyAriaLabel: "{value} out of {max} stars";
+    readonly groupAriaLabel: "Rating";
+    readonly starAriaLabel: "{star} stars";
+};
+declare const enBreadcrumbLabels: {
+    readonly navAriaLabel: "Go to {label}";
+};
+
+export { ALL_COMPOUND_THEMES, ActivityDef, ActivityFeed, type ActivityFeedLabels, type ActivityFeedProps, AlertBuilder, type AlertBuilderProps, type AlertCondition, type AlertConfig, AppShell, type AppShellProps, AsyncCombobox, type AsyncComboboxLabels, type AsyncComboboxProps, type AuditChange, type AuditEntry, AuditLog, type AuditLogLabels, type AuditLogProps, AuditTimeline, type AuditEntry$1 as AuditTimelineEntry, type AuditTimelineLabels, type AuditTimelineProps, AuthForm, type AuthFormLabels, type AuthFormProps, type BulkActionDef, BulkActions, type BulkActionsLabels, type BulkActionsProps, COLOR_PRESETS, type CanonicalThemeOverrides, type CanonicalThemeTokenMap, type ChartTypeDef, ChatConversationDef, ChatInput, type ChatInputLabels, type ChatInputProps, ChatMessageDef, ChatMessageList, type ChatMessageListLabels, type ChatMessageListProps, ChatModelDef, ChatSidebar, type ChatSidebarLabels, type ChatSidebarProps, ChatStylePresetDef, CodeDiffViewer, type CodeDiffViewerProps, type CodeSnippetSyntaxTheme, CodeSnippetViewer, type CodeSnippetViewerProps, ColumnToggler, type ColumnTogglerColumn, type ColumnTogglerProps, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, type CommandInputProps, CommandItem, CommandList, CommandSeparator, CommandShortcut, type ComparisonOption, ComparisonSelector, type ComparisonSelectorLabels, type ComparisonSelectorProps, type CompoundTheme, ConfirmDialog, type ConfirmDialogProps, ConnectionIndicator, type ConnectionIndicatorProps, type ConnectionStatus, DataImportWizard, type DataImportWizardLabels, type DataImportWizardProps, type DataSourceDef, DateRange, type DescriptorThemeSpec, DesignGuidePanel, type DesignGuidePanelProps, type DetectionConfig, type DetectionTypeDef, type Direction, DynamicFieldForm, type DynamicFieldFormLabels, type DynamicFieldFormProps, ErrorBoundary, type ErrorBoundaryProps, EventIcon, type EventIconProps, type EventMeta, EventMetaEditor, type EventMetaEditorProps, ExportButton, type ExportButtonLabels, type ExportButtonProps, ExportColumn, ExportFormat, FORCE_LIGHT_PRESETS, FORCE_LIGHT_PRESET_IDS, type FeatureFlag, FeatureFlagPanel, type FeatureFlagPanelProps, FileUploadForm, type FileUploadFormLabels, type FileUploadFormProps, FilterBar, type FilterBarLabels, type FilterBarProps, FilterGroupDef, type FilterPreset, type FloatingAction, FloatingActionBar, type FloatingActionBarProps, FormFieldDef, GENERATED_THEME_ID_DEFAULT, GLOBAL_THEME_STYLE_ID, type GeneratedThemeSpec, type GeneratedTokens, IconDef, type ImportFieldDef, type InlineEditColumnDef, InlineEditTable, type InlineEditTableProps, type InsightItem, type InsightSeverity, InsightsPanel, type InsightsPanelLabels, type InsightsPanelProps, type InsightsStat, KanbanBoard, type KanbanBoardProps, type KanbanColumn, LoadingOverlay, type LoadingOverlayProps, MegaMenu, type MegaMenuItem, type MegaMenuProps, type MegaMenuSection, NotificationCenter, type NotificationCenterProps, type NotificationItem, OPT_TEXT_PRIMARY, OPT_TEXT_SECONDARY, type OptThemeController, OptThemeControllerContext, OptThemeProvider, type OptThemeProviderProps, POPULAR_ICONS, PageAside, type PageAsideProps, type PresetThemeSpec, PromptTemplate, type PromptTemplateLabels, type PromptTemplateProps, type PromptVariable, type PropertyDef, PropertyExplorer, type PropertyExplorerProps, type PropertyGroup, QueryResultsTable, type QueryResultsTableProps, QuickActionDef, QuickActions, type QuickActionsLabels, type QuickActionsProps, ReportBuilder, type ReportBuilderChartType, type ReportBuilderLabels, type ReportBuilderProps, type ReportBuilderStep, type ResolvedThemeSpec, RichTextEditor, type RichTextEditorProps, RouteFocusManager, SavedFilters, type SavedFiltersProps, type SchemaLike, SegmentBuilder, type SegmentBuilderProps, type SegmentCondition, type SegmentConditionType, type SegmentGroup, Sidebar, type SidebarProps, type SpatialNavDecisionDetail, SpatialNavProvider, type SpatialTarget, SqlEditor, type SqlEditorProps, StatCard as StatCardType, type StoredTokenCache, SummaryRow, type SummaryRowProps, THEME_PRESET_IDS, THEME_REGISTRY, THEME_SPEC_STORAGE_KEY, THEME_TOKENS_STORAGE_KEY, TabDef, TaskDef, TaskList, type TaskListLabels, type TaskListProps, TeamMemberDef, TeamMemberList, type TeamMemberListLabels, type TeamMemberListProps, type TemplateDef, TemplatePicker, type TemplatePickerProps, type ThemeDescriptor, type ThemeMode, type ThemeOverrides, type ThemePreset, type ThemePresetId, type ThemeRuntimeOptions, type ThemeSpec, type ThemeStackEntry, ThemeSwitcher, type ThemeSwitcherLabels, type ThemeSwitcherProps, type TimePresetDef, TimeRangeSelector, type TimeRangeSelectorLabels, type TimeRangeSelectorProps, type TreeColumnDef, type TreeNode, TreeTable, type TreeTableProps, VerticalTabs, type VerticalTabsProps, WebhookConfig, type WebhookConfigProps, type WebhookDef, type WidgetDef, WidgetGrid, type WidgetGridProps, WizardForm, type WizardFormLabels, type WizardFormProps, type WizardStepDef, buildTokenCache, cn, coerceThemeMode, computeGeneratedTokens, computeSpatialTargets, createThemeBootScript, defineThemeOverrides, enBreadcrumbLabels, enComboboxLabels, enStarRatingLabels, formatOptDateTime, formatOptNumber, formatOptShortDate, formatOptTime, generatedTheme, getCompoundIdForSpec, getCompoundTheme, getThemeDescriptor, getTrappedContextRole, isDescriptorSpec, isForceLightSpec, isGeneratedSpec, isPresetSpec, isThemePresetId, koBreadcrumbLabels, koComboboxLabels, koStarRatingLabels, presetTheme, readStoredTheme, resolveDescriptor, resolveThemeMode, safeParseStoredSpec, safeParseStoredTokens, schemaValidator, serializeGeneratedTheme, serializeThemeRule, serializeTokenBody, shouldSkipArrow, useControlledState, useInputId, useOptTheme, useOptThemeController, useOptionalOptTheme, useSidebar };