@reopt-ai/opt-ui 1.11.0 → 1.12.1

package/README.md

@@ -47,17 +47,17 @@ bun add @reopt-ai/opt-ui
 ## 컴포넌트 계층
 
 ```
-Core (68)  →  Shells (80)  →  Blocks via opt-cli
+Core (70)  →  Shells (83)  →  Blocks via opt-cli
  primitives     비즈니스 조합     페이지 템플릿 설치
 
 opt-charts (37) → 데이터 시각화와 chart-specific shells
 ```
 
-### Core (68개)
+### Core (70개)
 
 접근성 프리미티브 + Tailwind 스타일. 단일 책임 primitive 컴포넌트.
 
-Button, Badge, Input, Textarea, Switch, Checkbox, CheckboxGroup, RadioGroup, Radio, Select, Combobox, Dialog, Disclosure, Accordion, Tabs, Menu, Menubar, Toolbar, Tooltip, Form (FormInput, FormTextarea, FormSelect, FormSwitch), Popover, DropdownMenu, Drawer, NumberInput, OtpField, Kbd, StatCard, Avatar, AvatarGroup, Progress, CircularProgress, Spinner, Alert, Skeleton, Separator, Breadcrumb, EmptyState, Card, DateRangePicker, TagInput, Toggle, ColorPicker, IconPicker, StepBuilder, ConditionBuilder, CompositeZone, SurfaceLayout, createSurface, PageHeader, ScrollArea, Container, Section, Resizable (PanelGroup/Panel/Handle), Logo, FieldToken, Facet, Expression, TextTruncate, Highlight, LiveRegion, ColorPalette, InlineEdit, KeyPadMenu
+Button, Badge, Input, Textarea, Switch, Checkbox, CheckboxGroup, RadioGroup, Radio, Select, Combobox, Dialog, Disclosure, Accordion, Tabs, Menu, Menubar, Toolbar, Tooltip, Form (FormInput, FormTextarea, FormSelect, FormSwitch), Popover, DropdownMenu, Drawer, NumberInput, OtpField, Kbd, StatCard, Avatar, AvatarGroup, Progress, CircularProgress, Spinner, Alert, Skeleton, Separator, Breadcrumb, EmptyState, Card, DateRangePicker, TagInput, Toggle, ColorPicker, IconPicker, StepBuilder, ConditionBuilder, CompositeZone, SurfaceLayout, createSurface, PageHeader, ScrollArea, Container, Section, Resizable (PanelGroup/Panel/Handle), Logo, FieldToken, Facet, Expression, TextTruncate, Highlight, LiveRegion, ColorPalette, InlineEdit, KeyPadMenu, DescriptionList, Identity
 
 ### Charts / Visuals
 
@@ -67,13 +67,13 @@ Button, Badge, Input, Textarea, Switch, Checkbox, CheckboxGroup, RadioGroup, Rad
 
 ChartContainer, ChartTooltip, ChartLegend, LineChart, BarChart, AreaChart, Sparkline, PieChart, ScatterChart, ComparisonChart, GaugeChart, FunnelChart, RetentionHeatmap, SankeyChart, TimeSeriesChart, TimeSeriesTooltipContent, LoadingChart, SmallMultiples
 
-### Shells (80개)
+### Shells (83개)
 
 Core 조합 + 비즈니스 로직.
 
 대표 컴포넌트:
 
-CommandPalette, CommandPaletteTrigger, DashboardGrid, SearchCombobox, StatusSelect, AppMenubar, SidebarNav, EditorToolbar, ContentTabs, FaqAccordion, SettingsForm, AuthForm, DynamicFieldForm, FileUploadForm, WizardForm, DeploymentTimeline, ProjectSwitcher, EnvPanel, BranchSelect, DomainTable, DataTable, NotificationToast, TaskList, ActivityFeed, FilterBar, QuickActions, TeamMemberList, EventIcon, ConnectionIndicator, FloatingActionBar, TemplatePicker, CodeSnippetViewer, PropertyExplorer, QueryResultsTable, AlertBuilder, SqlEditor, EventMetaEditor, WidgetGrid, ReportBuilder, SegmentBuilder, InsightsPanel, TimeRangeSelector, TimeRangeControl, TimeSeriesPanel, LogTable, QueryBar, FieldSidebar, ExportButton, LoadingOverlay, SummaryRow, ComparisonSelector, ThemeSwitcher, PromptTemplate, Sidebar, AppShell, DesignGuidePanel
+CommandPalette, CommandPaletteTrigger, DashboardGrid, SearchCombobox, StatusSelect, AppMenubar, SidebarNav, EditorToolbar, ContentTabs, FaqAccordion, SettingsForm, AuthForm, DynamicFieldForm, FileUploadForm, WizardForm, DeploymentTimeline, ProjectSwitcher, EnvPanel, BranchSelect, DomainTable, DataTable, NotificationToast, TaskList, ActivityFeed, EventTimeline, FilterBar, QuickActions, TeamMemberList, EventIcon, ConnectionIndicator, FloatingActionBar, Flyout, TemplatePicker, CodeSnippetViewer, PropertyExplorer, QueryResultsTable, AlertBuilder, SqlEditor, EventMetaEditor, WidgetGrid, ReportBuilder, SegmentBuilder, InsightsPanel, ScoreBreakdown, TimeRangeSelector, TimeRangeControl, TimeSeriesPanel, LogTable, QueryBar, FieldSidebar, ExportButton, LoadingOverlay, SummaryRow, ComparisonSelector, ThemeSwitcher, PromptTemplate, Sidebar, AppShell, DesignGuidePanel
 
 전체 목록은 `COMPONENT_CATALOG.md` 또는 generated docs의 `02-components/03-shells.md`를 기준으로 확인합니다.
 
@@ -165,6 +165,44 @@ const series = [
   [InlineEdit](https://design.reopt.ai/explore/opt-ui/core/inline-edit),
   [KeyPadMenu](https://design.reopt.ai/explore/opt-ui/core/key-pad-menu)
 
+### 분석 상세 조사 흐름
+
+목록에서 대상을 선택하고, 페이지 문맥을 유지한 채 상세 근거를 조사하는 흐름을
+Core와 Shell 조합으로 제공합니다.
+
+```tsx
+import {
+  DescriptionList,
+  EventTimeline,
+  Flyout,
+  Identity,
+  ScoreBreakdown,
+} from "@reopt-ai/opt-ui";
+
+<Identity
+  name={customer.name}
+  secondary={customer.email}
+  id={customer.id}
+  state={customer.anonymous ? "anonymous" : "identified"}
+/>
+
+<Flyout open={Boolean(customer)} onClose={clearCustomer} title={customer?.name}>
+  <DescriptionList items={profileFacts} columns={2} />
+  <ScoreBreakdown score={health.score} axes={health.axes} />
+  <EventTimeline groups={sessions} showGaps />
+</Flyout>;
+```
+
+- [DescriptionList](https://design.reopt.ai/explore/opt-ui/core/description-list),
+  [Identity](https://design.reopt.ai/explore/opt-ui/core/identity)
+- [EventTimeline](https://design.reopt.ai/explore/shells/event-timeline),
+  [ScoreBreakdown](https://design.reopt.ai/explore/shells/score-breakdown),
+  [Flyout](https://design.reopt.ai/explore/shells/flyout)
+- 기존 [EmptyState](https://design.reopt.ai/explore/opt-ui/core/empty-state),
+  [StatCard](https://design.reopt.ai/explore/opt-ui/core/stat-card),
+  [SummaryRow](https://design.reopt.ai/explore/shells/summary-row) 예제도
+  `tone`, `polarity`, 선택 상태와 5·6열 밀도를 포함하도록 갱신했습니다.
+
 ### 로그 탐색: 쿼리를 값으로 유지
 
 <code>QueryBar</code>는 문자열을 내부 상태에 숨기지 않고 직렬화 가능한

package/dist/core/index.cjs

@@ -1,7 +1,7 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_text_truncate = require("../text-truncate-BZdL1k5Z.cjs");
-const require_key_pad_menu = require("../key-pad-menu-Cg6rZBie.cjs");
+const require_text_truncate = require("../text-truncate-I1XLWmRa.cjs");
+const require_key_pad_menu = require("../key-pad-menu-SItoHPLu.cjs");
 let _reopt_ai_opt_ui_primitives = require("@reopt-ai/opt-ui-primitives");
 exports.AccordionContent = require_key_pad_menu.AccordionContent;
 exports.AccordionItem = require_key_pad_menu.AccordionItem;

package/dist/core/index.d.cts

@@ -1,4 +1,4 @@
 
-import { $ as DrawerSize, $i as CardTitle, A as ShaderSurfaceHandle, Aa as SeparatorProps, Ai as SkeletonText, An as FormSwitch, Ar as AlertDialogPanelProps, At as CheckboxGroupProps, B as ShaderPresetCategory, Ba as Kbd, Bi as BadgeProps, Bn as DEFAULT_PRESETS, Br as DialogHeading, Bt as PopoverRoot, C as Facet, Ca as Toggle, Ci as Textarea, Cn as FormSelectPopover, Cr as ComboboxGroup, Ct as BlockLayoutProps, D as FacetItem, Da as OtpField, Di as SkeletonCard, Dr as ComboboxPopover, Dt as RadioProps, E as FacetGroupProps, Ea as ToggleProps, Ei as SkeletonAvatar, Er as ComboboxItem, Et as RadioGroupProps, F as SHADER_PRESETS, Fa as Text, Fi as Alert, Fn as FormTextareaProps, Fr as DialogDismiss, Ft as DropdownSeparator, G as VirtualListProps, Gi as CardContentProps, Gn as DateRangePreset, Gr as SelectLabel, Gt as ConditionGroup, H as getShaderFragment, Hi as ButtonProps, Hn as DateRange, Hr as DialogRoot, Ht as ConditionBuilder, I as SHADER_PRESET_IDS, Ia as TextElement, Ii as AlertProps, Ir as DialogFooter, It as DropdownTrigger, J as DrawerClose, Ji as CardFooter, Jn as IconDef, Jr as SelectTrigger, Jt as StepBuilder, K as Pagination, Ki as CardDescription, Kn as TagInput, Kr as SelectPopover, Kt as ConditionOperator, L as ShaderParamKey, La as TextProps, Li as Spinner, Ln as useFormContext, Lr as DialogFooterProps, Lt as PopoverClose, M as SHADER_OVERLAY_PARAM_KEYS, Ma as HeadingLevel, Mi as SwitchProps, Mr as DialogBodyProps, Mt as DropdownContent, N as SHADER_PARAM_FALLBACK, Na as HeadingProps, Ni as Input, Nr as DialogDescription, Nt as DropdownItem, O as FacetProps, Oa as OtpFieldProps, Oi as SkeletonProps, Or as ComboboxRoot, Ot as Checkbox, P as SHADER_PARAM_KEYS, Pa as HeadingRole, Pi as InputProps, Pn as FormTextarea, Pr as DialogDisclosure, Pt as DropdownMenu, Q as DrawerSide, Qi as CardProps, Qn as ColorPickerProps, Qr as TabPanel, R as ShaderParamSpec, Ra as TextRole, Ri as SpinnerProps, Rn as useFormStore, Rr as DialogHeader, Rt as PopoverContent, S as ExpressionTone, Sa as PrimAccordionTriggerProps, Si as AvatarProps, Sn as FormSelectItem, Sr as ComboboxEmpty, St as BlockLayout, T as FacetGroupLabels, Ta as ToggleGroupProps, Ti as Skeleton, Tr as ComboboxInput, Tt as RadioGroup, U as getShaderPreset, Ui as Card, Un as DateRangePicker, Ur as DialogSize, Ut as ConditionBuilderProps, V as ShaderPresetId, Va as KbdProps, Vi as Button, Vn as DateGranularity, Vr as DialogPanel, Vt as PopoverTrigger, W as VirtualList, Wi as CardContent, Wn as DateRangePickerProps, Wr as SelectItem, Wt as ConditionDef, X as DrawerPanelProps, Xi as CardHeader, Xn as IconPickerProps, Xr as TabList, Xt as StepDef, Y as DrawerPanel, Yi as CardFooterProps, Yn as IconPicker, Yr as Tab, Yt as StepBuilderProps, Z as DrawerRoot, Zi as CardHeaderProps, Zn as ColorPicker, Zt as FormCheckbox, _ as HighlightProps, _a as AccordionRoot, _i as Progress, _n as FormRadioGroup, _r as MenuRoot, _t as ScrollAreaProps, a as InlineEditLabels, aa as DescriptionListLabels, ai as DisclosureContent, an as FormField, ar as ToolbarButton, at as PanelSize, b as ExpressionGroupProps, ba as PrimAccordionContentProps, bi as AvatarGroup, bn as FormRoot, br as MenubarContainer, bt as BlockBaseProps, c as ColorPaletteDisplay, ca as EmptyStateAction, ci as Composite, cr as ToolbarSeparator, ct as ResizablePanel, d as ColorPalettePickerProps, da as BreadcrumbItem, di as CompositeRow, dn as FormLabel, dr as TooltipProvider, dt as ResizablePanelProps, ea as CardTitleProps, en as FormControl, et as Logo, f as PaletteKind, fa as BreadcrumbProps, fi as CompositeZone, fr as MenuButtonArrow, ft as Section, g as Highlight, ga as AccordionItem, gi as CircularProgressProps, gn as FormRadio, gr as MenuPopover, gt as ScrollArea, h as LiveRegionProps, ha as AccordionContent, hi as CircularProgress, hn as FormPush, hr as MenuItemRadio, ht as ContainerProps, i as InlineEdit, ia as DescriptionListItem, in as FormError, ir as NumberInputProps, it as PanelImperativeHandle, j as ShaderSurfaceProps, ja as Heading, ji as Switch, jn as FormSwitchProps, jr as DialogBody, jt as CheckboxProps, k as ShaderSurface, ka as Separator, ki as SkeletonTable, kn as FormSubmit, kr as AlertDialogPanel, kt as CheckboxGroup, l as ColorPaletteDisplayProps, la as EmptyStateProps, li as CompositeItem, lr as Tooltip, lt as ResizablePanelGroup, m as LiveRegion, ma as StatCardProps, mi as MeterProps, mn as FormProvider, mr as MenuItemCheckbox, mt as Container, n as KeyPadMenu, na as IdentityProps, ni as TabsRoot, nr as SliderProps, nt as GroupImperativeHandle, o as InlineEditProps, oa as DescriptionListProps, oi as DisclosureRoot, on as FormGroup, or as ToolbarContainer, ot as ResizableHandle, p as THEME_PALETTES, pa as StatCard, pi as Meter, pr as MenuItem, pt as SectionProps, q as PaginationProps, qi as CardDescriptionProps, qn as TagInputProps, qr as SelectRoot, qt as ConditionTypeRenderer, r as KeyPadMenuProps, ra as DescriptionList, rn as FormDescription, rr as NumberInput, rt as Layout, s as ColorPalette, sa as EmptyState, si as DisclosureTrigger, sn as FormGroupLabel, sr as ToolbarRoot, st as ResizableHandleProps, t as KeyPadItem, ta as Identity, tr as Slider, tt as LogoProps, u as ColorPalettePicker, ua as Breadcrumb, ui as CompositeProvider, un as FormInput, ur as TooltipAnchor, ut as ResizablePanelGroupProps, v as Expression, va as AccordionRootProps, vi as ProgressProps, vn as FormRemove, vr as MenuSeparator, vt as PageHeader, w as FacetGroup, wa as ToggleGroup, wi as TextareaProps, wn as FormSelectProps, wr as ComboboxGroupLabel, wt as Radio, x as ExpressionProps, xa as PrimAccordionItemProps, xi as AvatarGroupProps, xn as FormSelect, xr as MenubarRoot, xt as createBlock, y as ExpressionGroup, ya as AccordionTrigger, yi as Avatar, yn as FormReset, yr as MenuTrigger, yt as PageHeaderProps, z as ShaderPreset, za as TextTone, zi as Badge, zn as ComparisonMode, zr as DialogHeaderProps, zt as PopoverContentProps } from "../key-pad-menu-BxTy_u0Q.cjs";
-import { a as FieldDataType, c as resolveFieldType, i as FIELD_TYPE_TOKENS, n as TextTruncateProps, o as FieldToken, r as TruncationSide, s as FieldTokenProps, t as TextTruncate } from "../text-truncate-DW78lg4S.cjs";
+import { $ as DrawerSize, $i as CardTitle, A as ShaderSurfaceHandle, Aa as SeparatorProps, Ai as SkeletonText, An as FormSwitch, Ar as AlertDialogPanelProps, At as CheckboxGroupProps, B as ShaderPresetCategory, Ba as Kbd, Bi as BadgeProps, Bn as DEFAULT_PRESETS, Br as DialogHeading, Bt as PopoverRoot, C as Facet, Ca as Toggle, Ci as Textarea, Cn as FormSelectPopover, Cr as ComboboxGroup, Ct as BlockLayoutProps, D as FacetItem, Da as OtpField, Di as SkeletonCard, Dr as ComboboxPopover, Dt as RadioProps, E as FacetGroupProps, Ea as ToggleProps, Ei as SkeletonAvatar, Er as ComboboxItem, Et as RadioGroupProps, F as SHADER_PRESETS, Fa as Text, Fi as Alert, Fn as FormTextareaProps, Fr as DialogDismiss, Ft as DropdownSeparator, G as VirtualListProps, Gi as CardContentProps, Gn as DateRangePreset, Gr as SelectLabel, Gt as ConditionGroup, H as getShaderFragment, Hi as ButtonProps, Hn as DateRange, Hr as DialogRoot, Ht as ConditionBuilder, I as SHADER_PRESET_IDS, Ia as TextElement, Ii as AlertProps, Ir as DialogFooter, It as DropdownTrigger, J as DrawerClose, Ji as CardFooter, Jn as IconDef, Jr as SelectTrigger, Jt as StepBuilder, K as Pagination, Ki as CardDescription, Kn as TagInput, Kr as SelectPopover, Kt as ConditionOperator, L as ShaderParamKey, La as TextProps, Li as Spinner, Ln as useFormContext, Lr as DialogFooterProps, Lt as PopoverClose, M as SHADER_OVERLAY_PARAM_KEYS, Ma as HeadingLevel, Mi as SwitchProps, Mr as DialogBodyProps, Mt as DropdownContent, N as SHADER_PARAM_FALLBACK, Na as HeadingProps, Ni as Input, Nr as DialogDescription, Nt as DropdownItem, O as FacetProps, Oa as OtpFieldProps, Oi as SkeletonProps, Or as ComboboxRoot, Ot as Checkbox, P as SHADER_PARAM_KEYS, Pa as HeadingRole, Pi as InputProps, Pn as FormTextarea, Pr as DialogDisclosure, Pt as DropdownMenu, Q as DrawerSide, Qi as CardProps, Qn as ColorPickerProps, Qr as TabPanel, R as ShaderParamSpec, Ra as TextRole, Ri as SpinnerProps, Rn as useFormStore, Rr as DialogHeader, Rt as PopoverContent, S as ExpressionTone, Sa as PrimAccordionTriggerProps, Si as AvatarProps, Sn as FormSelectItem, Sr as ComboboxEmpty, St as BlockLayout, T as FacetGroupLabels, Ta as ToggleGroupProps, Ti as Skeleton, Tr as ComboboxInput, Tt as RadioGroup, U as getShaderPreset, Ui as Card, Un as DateRangePicker, Ur as DialogSize, Ut as ConditionBuilderProps, V as ShaderPresetId, Va as KbdProps, Vi as Button, Vn as DateGranularity, Vr as DialogPanel, Vt as PopoverTrigger, W as VirtualList, Wi as CardContent, Wn as DateRangePickerProps, Wr as SelectItem, Wt as ConditionDef, X as DrawerPanelProps, Xi as CardHeader, Xn as IconPickerProps, Xr as TabList, Xt as StepDef, Y as DrawerPanel, Yi as CardFooterProps, Yn as IconPicker, Yr as Tab, Yt as StepBuilderProps, Z as DrawerRoot, Zi as CardHeaderProps, Zn as ColorPicker, Zt as FormCheckbox, _ as HighlightProps, _a as AccordionRoot, _i as Progress, _n as FormRadioGroup, _r as MenuRoot, _t as ScrollAreaProps, a as InlineEditLabels, aa as DescriptionListLabels, ai as DisclosureContent, an as FormField, ar as ToolbarButton, at as PanelSize, b as ExpressionGroupProps, ba as PrimAccordionContentProps, bi as AvatarGroup, bn as FormRoot, br as MenubarContainer, bt as BlockBaseProps, c as ColorPaletteDisplay, ca as EmptyStateAction, ci as Composite, cr as ToolbarSeparator, ct as ResizablePanel, d as ColorPalettePickerProps, da as BreadcrumbItem, di as CompositeRow, dn as FormLabel, dr as TooltipProvider, dt as ResizablePanelProps, ea as CardTitleProps, en as FormControl, et as Logo, f as PaletteKind, fa as BreadcrumbProps, fi as CompositeZone, fr as MenuButtonArrow, ft as Section, g as Highlight, ga as AccordionItem, gi as CircularProgressProps, gn as FormRadio, gr as MenuPopover, gt as ScrollArea, h as LiveRegionProps, ha as AccordionContent, hi as CircularProgress, hn as FormPush, hr as MenuItemRadio, ht as ContainerProps, i as InlineEdit, ia as DescriptionListItem, in as FormError, ir as NumberInputProps, it as PanelImperativeHandle, j as ShaderSurfaceProps, ja as Heading, ji as Switch, jn as FormSwitchProps, jr as DialogBody, jt as CheckboxProps, k as ShaderSurface, ka as Separator, ki as SkeletonTable, kn as FormSubmit, kr as AlertDialogPanel, kt as CheckboxGroup, l as ColorPaletteDisplayProps, la as EmptyStateProps, li as CompositeItem, lr as Tooltip, lt as ResizablePanelGroup, m as LiveRegion, ma as StatCardProps, mi as MeterProps, mn as FormProvider, mr as MenuItemCheckbox, mt as Container, n as KeyPadMenu, na as IdentityProps, ni as TabsRoot, nr as SliderProps, nt as GroupImperativeHandle, o as InlineEditProps, oa as DescriptionListProps, oi as DisclosureRoot, on as FormGroup, or as ToolbarContainer, ot as ResizableHandle, p as THEME_PALETTES, pa as StatCard, pi as Meter, pr as MenuItem, pt as SectionProps, q as PaginationProps, qi as CardDescriptionProps, qn as TagInputProps, qr as SelectRoot, qt as ConditionTypeRenderer, r as KeyPadMenuProps, ra as DescriptionList, rn as FormDescription, rr as NumberInput, rt as Layout, s as ColorPalette, sa as EmptyState, si as DisclosureTrigger, sn as FormGroupLabel, sr as ToolbarRoot, st as ResizableHandleProps, t as KeyPadItem, ta as Identity, tr as Slider, tt as LogoProps, u as ColorPalettePicker, ua as Breadcrumb, ui as CompositeProvider, un as FormInput, ur as TooltipAnchor, ut as ResizablePanelGroupProps, v as Expression, va as AccordionRootProps, vi as ProgressProps, vn as FormRemove, vr as MenuSeparator, vt as PageHeader, w as FacetGroup, wa as ToggleGroup, wi as TextareaProps, wn as FormSelectProps, wr as ComboboxGroupLabel, wt as Radio, x as ExpressionProps, xa as PrimAccordionItemProps, xi as AvatarGroupProps, xn as FormSelect, xr as MenubarRoot, xt as createBlock, y as ExpressionGroup, ya as AccordionTrigger, yi as Avatar, yn as FormReset, yr as MenuTrigger, yt as PageHeaderProps, z as ShaderPreset, za as TextTone, zi as Badge, zn as ComparisonMode, zr as DialogHeaderProps, zt as PopoverContentProps } from "../key-pad-menu-CwcY_Vps.cjs";
+import { a as FieldDataType, i as FIELD_TYPE_TOKENS, l as FieldTokenProps, n as TextTruncateProps, o as FieldToken, r as TruncationSide, t as TextTruncate, u as resolveFieldType } from "../text-truncate-CQyfUZvq.cjs";
 export { AccordionContent, type PrimAccordionContentProps as AccordionContentProps, AccordionItem, type PrimAccordionItemProps as AccordionItemProps, AccordionRoot, type AccordionRootProps, AccordionTrigger, type PrimAccordionTriggerProps as AccordionTriggerProps, Alert, AlertDialogPanel, type AlertDialogPanelProps, type AlertProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Badge, type BadgeProps, type BlockBaseProps, type BlockBaseProps as SurfaceBaseProps, BlockLayout, BlockLayout as SurfaceLayout, type BlockLayoutProps, type BlockLayoutProps as SurfaceLayoutProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, CircularProgress, type CircularProgressProps, type ColorPalette, ColorPaletteDisplay, type ColorPaletteDisplayProps, ColorPalettePicker, type ColorPalettePickerProps, ColorPicker, type ColorPickerProps, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxItem, ComboboxPopover, ComboboxRoot, type ComparisonMode, Composite, CompositeItem, CompositeProvider, CompositeRow, CompositeZone, ConditionBuilder, type ConditionBuilderProps, type ConditionDef, type ConditionGroup, type ConditionOperator, type ConditionTypeRenderer, Container, type ContainerProps, DEFAULT_PRESETS, type DateGranularity, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, DescriptionList, type DescriptionListItem, type DescriptionListLabels, type DescriptionListProps, DialogBody, type DialogBodyProps, DialogDescription, DialogDisclosure, DialogDismiss, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogHeading, DialogPanel, DialogRoot, type DialogSize, DisclosureContent, DisclosureRoot, DisclosureTrigger, DrawerClose, DrawerPanel, type DrawerPanelProps, DrawerRoot, type DrawerSide, type DrawerSize, DropdownContent, DropdownItem, DropdownMenu, DropdownSeparator, DropdownTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, Expression, ExpressionGroup, type ExpressionGroupProps, type ExpressionProps, type ExpressionTone, FIELD_TYPE_TOKENS, Facet, FacetGroup, type FacetGroupLabels, type FacetGroupProps, type FacetItem, type FacetProps, type FieldDataType, FieldToken, type FieldTokenProps, FormCheckbox, FormControl, FormDescription, FormError, FormField, FormGroup, FormGroupLabel, FormInput, FormLabel, FormProvider, FormPush, FormRadio, FormRadioGroup, FormRemove, FormReset, FormRoot, FormSelect, FormSelectItem, FormSelectPopover, type FormSelectProps, FormSubmit, FormSwitch, type FormSwitchProps, FormTextarea, type FormTextareaProps, Heading, type HeadingLevel, type HeadingProps, type HeadingRole, Highlight, type HighlightProps, type IconDef, IconPicker, type IconPickerProps, Identity, type IdentityProps, InlineEdit, type InlineEditLabels, type InlineEditProps, Input, type InputProps, Kbd, type KbdProps, type KeyPadItem, KeyPadMenu, type KeyPadMenuProps, LiveRegion, type LiveRegionProps, Logo, type LogoProps, MenuButtonArrow, MenuItem, MenuItemCheckbox, MenuItemRadio, MenuPopover, MenuRoot, MenuSeparator, MenuTrigger, MenubarContainer, MenubarRoot, Meter, type MeterProps, NumberInput, type NumberInputProps, OtpField, type OtpFieldProps, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, type PaletteKind, PopoverClose, PopoverContent, type PopoverContentProps, PopoverRoot, PopoverTrigger, Progress, type ProgressProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, ResizableHandle, type ResizableHandleProps, ResizablePanel, ResizablePanelGroup, type GroupImperativeHandle as ResizablePanelGroupHandle, type ResizablePanelGroupProps, type PanelImperativeHandle as ResizablePanelHandle, type Layout as ResizablePanelLayout, type ResizablePanelProps, type PanelSize as ResizablePanelSize, SHADER_OVERLAY_PARAM_KEYS, SHADER_PARAM_FALLBACK, SHADER_PARAM_KEYS, SHADER_PRESETS, SHADER_PRESET_IDS, ScrollArea, type ScrollAreaProps, Section, type SectionProps, SelectItem, SelectLabel, SelectPopover, SelectRoot, SelectTrigger, Separator, type SeparatorProps, type ShaderParamKey, type ShaderParamSpec, type ShaderPreset, type ShaderPresetCategory, type ShaderPresetId, ShaderSurface, type ShaderSurfaceHandle, type ShaderSurfaceProps, Skeleton, SkeletonAvatar, SkeletonCard, type SkeletonProps, SkeletonTable, SkeletonText, Slider, type SliderProps, Spinner, type SpinnerProps, StatCard, type StatCardProps, StepBuilder, type StepBuilderProps, type StepDef, Switch, type SwitchProps, THEME_PALETTES, Tab, TabList, TabPanel, TabsRoot, TagInput, type TagInputProps, Text, type TextElement, type TextProps, type TextRole, type TextTone, TextTruncate, type TextTruncateProps, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupProps, type ToggleProps, ToolbarButton, ToolbarContainer, ToolbarRoot, ToolbarSeparator, Tooltip, TooltipAnchor, TooltipProvider, type TruncationSide, VirtualList, type VirtualListProps, createBlock, createBlock as createSurface, getShaderFragment, getShaderPreset, resolveFieldType, useFormContext, useFormStore };

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
 
-import { $ as DrawerSize, $i as CardTitle, A as ShaderSurfaceHandle, Aa as SeparatorProps, Ai as SkeletonText, An as FormSwitch, Ar as AlertDialogPanelProps, At as CheckboxGroupProps, B as ShaderPresetCategory, Ba as Kbd, Bi as BadgeProps, Bn as DEFAULT_PRESETS, Br as DialogHeading, Bt as PopoverRoot, C as Facet, Ca as Toggle, Ci as Textarea, Cn as FormSelectPopover, Cr as ComboboxGroup, Ct as BlockLayoutProps, D as FacetItem, Da as OtpField, Di as SkeletonCard, Dr as ComboboxPopover, Dt as RadioProps, E as FacetGroupProps, Ea as ToggleProps, Ei as SkeletonAvatar, Er as ComboboxItem, Et as RadioGroupProps, F as SHADER_PRESETS, Fa as Text, Fi as Alert, Fn as FormTextareaProps, Fr as DialogDismiss, Ft as DropdownSeparator, G as VirtualListProps, Gi as CardContentProps, Gn as DateRangePreset, Gr as SelectLabel, Gt as ConditionGroup, H as getShaderFragment, Hi as ButtonProps, Hn as DateRange, Hr as DialogRoot, Ht as ConditionBuilder, I as SHADER_PRESET_IDS, Ia as TextElement, Ii as AlertProps, Ir as DialogFooter, It as DropdownTrigger, J as DrawerClose, Ji as CardFooter, Jn as IconDef, Jr as SelectTrigger, Jt as StepBuilder, K as Pagination, Ki as CardDescription, Kn as TagInput, Kr as SelectPopover, Kt as ConditionOperator, L as ShaderParamKey, La as TextProps, Li as Spinner, Ln as useFormContext, Lr as DialogFooterProps, Lt as PopoverClose, M as SHADER_OVERLAY_PARAM_KEYS, Ma as HeadingLevel, Mi as SwitchProps, Mr as DialogBodyProps, Mt as DropdownContent, N as SHADER_PARAM_FALLBACK, Na as HeadingProps, Ni as Input, Nr as DialogDescription, Nt as DropdownItem, O as FacetProps, Oa as OtpFieldProps, Oi as SkeletonProps, Or as ComboboxRoot, Ot as Checkbox, P as SHADER_PARAM_KEYS, Pa as HeadingRole, Pi as InputProps, Pn as FormTextarea, Pr as DialogDisclosure, Pt as DropdownMenu, Q as DrawerSide, Qi as CardProps, Qn as ColorPickerProps, Qr as TabPanel, R as ShaderParamSpec, Ra as TextRole, Ri as SpinnerProps, Rn as useFormStore, Rr as DialogHeader, Rt as PopoverContent, S as ExpressionTone, Sa as PrimAccordionTriggerProps, Si as AvatarProps, Sn as FormSelectItem, Sr as ComboboxEmpty, St as BlockLayout, T as FacetGroupLabels, Ta as ToggleGroupProps, Ti as Skeleton, Tr as ComboboxInput, Tt as RadioGroup, U as getShaderPreset, Ui as Card, Un as DateRangePicker, Ur as DialogSize, Ut as ConditionBuilderProps, V as ShaderPresetId, Va as KbdProps, Vi as Button, Vn as DateGranularity, Vr as DialogPanel, Vt as PopoverTrigger, W as VirtualList, Wi as CardContent, Wn as DateRangePickerProps, Wr as SelectItem, Wt as ConditionDef, X as DrawerPanelProps, Xi as CardHeader, Xn as IconPickerProps, Xr as TabList, Xt as StepDef, Y as DrawerPanel, Yi as CardFooterProps, Yn as IconPicker, Yr as Tab, Yt as StepBuilderProps, Z as DrawerRoot, Zi as CardHeaderProps, Zn as ColorPicker, Zt as FormCheckbox, _ as HighlightProps, _a as AccordionRoot, _i as Progress, _n as FormRadioGroup, _r as MenuRoot, _t as ScrollAreaProps, a as InlineEditLabels, aa as DescriptionListLabels, ai as DisclosureContent, an as FormField, ar as ToolbarButton, at as PanelSize, b as ExpressionGroupProps, ba as PrimAccordionContentProps, bi as AvatarGroup, bn as FormRoot, br as MenubarContainer, bt as BlockBaseProps, c as ColorPaletteDisplay, ca as EmptyStateAction, ci as Composite, cr as ToolbarSeparator, ct as ResizablePanel, d as ColorPalettePickerProps, da as BreadcrumbItem, di as CompositeRow, dn as FormLabel, dr as TooltipProvider, dt as ResizablePanelProps, ea as CardTitleProps, en as FormControl, et as Logo, f as PaletteKind, fa as BreadcrumbProps, fi as CompositeZone, fr as MenuButtonArrow, ft as Section, g as Highlight, ga as AccordionItem, gi as CircularProgressProps, gn as FormRadio, gr as MenuPopover, gt as ScrollArea, h as LiveRegionProps, ha as AccordionContent, hi as CircularProgress, hn as FormPush, hr as MenuItemRadio, ht as ContainerProps, i as InlineEdit, ia as DescriptionListItem, in as FormError, ir as NumberInputProps, it as PanelImperativeHandle, j as ShaderSurfaceProps, ja as Heading, ji as Switch, jn as FormSwitchProps, jr as DialogBody, jt as CheckboxProps, k as ShaderSurface, ka as Separator, ki as SkeletonTable, kn as FormSubmit, kr as AlertDialogPanel, kt as CheckboxGroup, l as ColorPaletteDisplayProps, la as EmptyStateProps, li as CompositeItem, lr as Tooltip, lt as ResizablePanelGroup, m as LiveRegion, ma as StatCardProps, mi as MeterProps, mn as FormProvider, mr as MenuItemCheckbox, mt as Container, n as KeyPadMenu, na as IdentityProps, ni as TabsRoot, nr as SliderProps, nt as GroupImperativeHandle, o as InlineEditProps, oa as DescriptionListProps, oi as DisclosureRoot, on as FormGroup, or as ToolbarContainer, ot as ResizableHandle, p as THEME_PALETTES, pa as StatCard, pi as Meter, pr as MenuItem, pt as SectionProps, q as PaginationProps, qi as CardDescriptionProps, qn as TagInputProps, qr as SelectRoot, qt as ConditionTypeRenderer, r as KeyPadMenuProps, ra as DescriptionList, rn as FormDescription, rr as NumberInput, rt as Layout, s as ColorPalette, sa as EmptyState, si as DisclosureTrigger, sn as FormGroupLabel, sr as ToolbarRoot, st as ResizableHandleProps, t as KeyPadItem, ta as Identity, tr as Slider, tt as LogoProps, u as ColorPalettePicker, ua as Breadcrumb, ui as CompositeProvider, un as FormInput, ur as TooltipAnchor, ut as ResizablePanelGroupProps, v as Expression, va as AccordionRootProps, vi as ProgressProps, vn as FormRemove, vr as MenuSeparator, vt as PageHeader, w as FacetGroup, wa as ToggleGroup, wi as TextareaProps, wn as FormSelectProps, wr as ComboboxGroupLabel, wt as Radio, x as ExpressionProps, xa as PrimAccordionItemProps, xi as AvatarGroupProps, xn as FormSelect, xr as MenubarRoot, xt as createBlock, y as ExpressionGroup, ya as AccordionTrigger, yi as Avatar, yn as FormReset, yr as MenuTrigger, yt as PageHeaderProps, z as ShaderPreset, za as TextTone, zi as Badge, zn as ComparisonMode, zr as DialogHeaderProps, zt as PopoverContentProps } from "../key-pad-menu-u5GTJl9B.js";
-import { a as FieldDataType, c as resolveFieldType, i as FIELD_TYPE_TOKENS, n as TextTruncateProps, o as FieldToken, r as TruncationSide, s as FieldTokenProps, t as TextTruncate } from "../text-truncate-DW78lg4S.js";
+import { $ as DrawerSize, $i as CardTitle, A as ShaderSurfaceHandle, Aa as SeparatorProps, Ai as SkeletonText, An as FormSwitch, Ar as AlertDialogPanelProps, At as CheckboxGroupProps, B as ShaderPresetCategory, Ba as Kbd, Bi as BadgeProps, Bn as DEFAULT_PRESETS, Br as DialogHeading, Bt as PopoverRoot, C as Facet, Ca as Toggle, Ci as Textarea, Cn as FormSelectPopover, Cr as ComboboxGroup, Ct as BlockLayoutProps, D as FacetItem, Da as OtpField, Di as SkeletonCard, Dr as ComboboxPopover, Dt as RadioProps, E as FacetGroupProps, Ea as ToggleProps, Ei as SkeletonAvatar, Er as ComboboxItem, Et as RadioGroupProps, F as SHADER_PRESETS, Fa as Text, Fi as Alert, Fn as FormTextareaProps, Fr as DialogDismiss, Ft as DropdownSeparator, G as VirtualListProps, Gi as CardContentProps, Gn as DateRangePreset, Gr as SelectLabel, Gt as ConditionGroup, H as getShaderFragment, Hi as ButtonProps, Hn as DateRange, Hr as DialogRoot, Ht as ConditionBuilder, I as SHADER_PRESET_IDS, Ia as TextElement, Ii as AlertProps, Ir as DialogFooter, It as DropdownTrigger, J as DrawerClose, Ji as CardFooter, Jn as IconDef, Jr as SelectTrigger, Jt as StepBuilder, K as Pagination, Ki as CardDescription, Kn as TagInput, Kr as SelectPopover, Kt as ConditionOperator, L as ShaderParamKey, La as TextProps, Li as Spinner, Ln as useFormContext, Lr as DialogFooterProps, Lt as PopoverClose, M as SHADER_OVERLAY_PARAM_KEYS, Ma as HeadingLevel, Mi as SwitchProps, Mr as DialogBodyProps, Mt as DropdownContent, N as SHADER_PARAM_FALLBACK, Na as HeadingProps, Ni as Input, Nr as DialogDescription, Nt as DropdownItem, O as FacetProps, Oa as OtpFieldProps, Oi as SkeletonProps, Or as ComboboxRoot, Ot as Checkbox, P as SHADER_PARAM_KEYS, Pa as HeadingRole, Pi as InputProps, Pn as FormTextarea, Pr as DialogDisclosure, Pt as DropdownMenu, Q as DrawerSide, Qi as CardProps, Qn as ColorPickerProps, Qr as TabPanel, R as ShaderParamSpec, Ra as TextRole, Ri as SpinnerProps, Rn as useFormStore, Rr as DialogHeader, Rt as PopoverContent, S as ExpressionTone, Sa as PrimAccordionTriggerProps, Si as AvatarProps, Sn as FormSelectItem, Sr as ComboboxEmpty, St as BlockLayout, T as FacetGroupLabels, Ta as ToggleGroupProps, Ti as Skeleton, Tr as ComboboxInput, Tt as RadioGroup, U as getShaderPreset, Ui as Card, Un as DateRangePicker, Ur as DialogSize, Ut as ConditionBuilderProps, V as ShaderPresetId, Va as KbdProps, Vi as Button, Vn as DateGranularity, Vr as DialogPanel, Vt as PopoverTrigger, W as VirtualList, Wi as CardContent, Wn as DateRangePickerProps, Wr as SelectItem, Wt as ConditionDef, X as DrawerPanelProps, Xi as CardHeader, Xn as IconPickerProps, Xr as TabList, Xt as StepDef, Y as DrawerPanel, Yi as CardFooterProps, Yn as IconPicker, Yr as Tab, Yt as StepBuilderProps, Z as DrawerRoot, Zi as CardHeaderProps, Zn as ColorPicker, Zt as FormCheckbox, _ as HighlightProps, _a as AccordionRoot, _i as Progress, _n as FormRadioGroup, _r as MenuRoot, _t as ScrollAreaProps, a as InlineEditLabels, aa as DescriptionListLabels, ai as DisclosureContent, an as FormField, ar as ToolbarButton, at as PanelSize, b as ExpressionGroupProps, ba as PrimAccordionContentProps, bi as AvatarGroup, bn as FormRoot, br as MenubarContainer, bt as BlockBaseProps, c as ColorPaletteDisplay, ca as EmptyStateAction, ci as Composite, cr as ToolbarSeparator, ct as ResizablePanel, d as ColorPalettePickerProps, da as BreadcrumbItem, di as CompositeRow, dn as FormLabel, dr as TooltipProvider, dt as ResizablePanelProps, ea as CardTitleProps, en as FormControl, et as Logo, f as PaletteKind, fa as BreadcrumbProps, fi as CompositeZone, fr as MenuButtonArrow, ft as Section, g as Highlight, ga as AccordionItem, gi as CircularProgressProps, gn as FormRadio, gr as MenuPopover, gt as ScrollArea, h as LiveRegionProps, ha as AccordionContent, hi as CircularProgress, hn as FormPush, hr as MenuItemRadio, ht as ContainerProps, i as InlineEdit, ia as DescriptionListItem, in as FormError, ir as NumberInputProps, it as PanelImperativeHandle, j as ShaderSurfaceProps, ja as Heading, ji as Switch, jn as FormSwitchProps, jr as DialogBody, jt as CheckboxProps, k as ShaderSurface, ka as Separator, ki as SkeletonTable, kn as FormSubmit, kr as AlertDialogPanel, kt as CheckboxGroup, l as ColorPaletteDisplayProps, la as EmptyStateProps, li as CompositeItem, lr as Tooltip, lt as ResizablePanelGroup, m as LiveRegion, ma as StatCardProps, mi as MeterProps, mn as FormProvider, mr as MenuItemCheckbox, mt as Container, n as KeyPadMenu, na as IdentityProps, ni as TabsRoot, nr as SliderProps, nt as GroupImperativeHandle, o as InlineEditProps, oa as DescriptionListProps, oi as DisclosureRoot, on as FormGroup, or as ToolbarContainer, ot as ResizableHandle, p as THEME_PALETTES, pa as StatCard, pi as Meter, pr as MenuItem, pt as SectionProps, q as PaginationProps, qi as CardDescriptionProps, qn as TagInputProps, qr as SelectRoot, qt as ConditionTypeRenderer, r as KeyPadMenuProps, ra as DescriptionList, rn as FormDescription, rr as NumberInput, rt as Layout, s as ColorPalette, sa as EmptyState, si as DisclosureTrigger, sn as FormGroupLabel, sr as ToolbarRoot, st as ResizableHandleProps, t as KeyPadItem, ta as Identity, tr as Slider, tt as LogoProps, u as ColorPalettePicker, ua as Breadcrumb, ui as CompositeProvider, un as FormInput, ur as TooltipAnchor, ut as ResizablePanelGroupProps, v as Expression, va as AccordionRootProps, vi as ProgressProps, vn as FormRemove, vr as MenuSeparator, vt as PageHeader, w as FacetGroup, wa as ToggleGroup, wi as TextareaProps, wn as FormSelectProps, wr as ComboboxGroupLabel, wt as Radio, x as ExpressionProps, xa as PrimAccordionItemProps, xi as AvatarGroupProps, xn as FormSelect, xr as MenubarRoot, xt as createBlock, y as ExpressionGroup, ya as AccordionTrigger, yi as Avatar, yn as FormReset, yr as MenuTrigger, yt as PageHeaderProps, z as ShaderPreset, za as TextTone, zi as Badge, zn as ComparisonMode, zr as DialogHeaderProps, zt as PopoverContentProps } from "../key-pad-menu-WBJShCJn.js";
+import { a as FieldDataType, i as FIELD_TYPE_TOKENS, l as FieldTokenProps, n as TextTruncateProps, o as FieldToken, r as TruncationSide, t as TextTruncate, u as resolveFieldType } from "../text-truncate-CQyfUZvq.js";
 export { AccordionContent, type PrimAccordionContentProps as AccordionContentProps, AccordionItem, type PrimAccordionItemProps as AccordionItemProps, AccordionRoot, type AccordionRootProps, AccordionTrigger, type PrimAccordionTriggerProps as AccordionTriggerProps, Alert, AlertDialogPanel, type AlertDialogPanelProps, type AlertProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Badge, type BadgeProps, type BlockBaseProps, type BlockBaseProps as SurfaceBaseProps, BlockLayout, BlockLayout as SurfaceLayout, type BlockLayoutProps, type BlockLayoutProps as SurfaceLayoutProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, CircularProgress, type CircularProgressProps, type ColorPalette, ColorPaletteDisplay, type ColorPaletteDisplayProps, ColorPalettePicker, type ColorPalettePickerProps, ColorPicker, type ColorPickerProps, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxItem, ComboboxPopover, ComboboxRoot, type ComparisonMode, Composite, CompositeItem, CompositeProvider, CompositeRow, CompositeZone, ConditionBuilder, type ConditionBuilderProps, type ConditionDef, type ConditionGroup, type ConditionOperator, type ConditionTypeRenderer, Container, type ContainerProps, DEFAULT_PRESETS, type DateGranularity, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, DescriptionList, type DescriptionListItem, type DescriptionListLabels, type DescriptionListProps, DialogBody, type DialogBodyProps, DialogDescription, DialogDisclosure, DialogDismiss, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogHeading, DialogPanel, DialogRoot, type DialogSize, DisclosureContent, DisclosureRoot, DisclosureTrigger, DrawerClose, DrawerPanel, type DrawerPanelProps, DrawerRoot, type DrawerSide, type DrawerSize, DropdownContent, DropdownItem, DropdownMenu, DropdownSeparator, DropdownTrigger, EmptyState, type EmptyStateAction, type EmptyStateProps, Expression, ExpressionGroup, type ExpressionGroupProps, type ExpressionProps, type ExpressionTone, FIELD_TYPE_TOKENS, Facet, FacetGroup, type FacetGroupLabels, type FacetGroupProps, type FacetItem, type FacetProps, type FieldDataType, FieldToken, type FieldTokenProps, FormCheckbox, FormControl, FormDescription, FormError, FormField, FormGroup, FormGroupLabel, FormInput, FormLabel, FormProvider, FormPush, FormRadio, FormRadioGroup, FormRemove, FormReset, FormRoot, FormSelect, FormSelectItem, FormSelectPopover, type FormSelectProps, FormSubmit, FormSwitch, type FormSwitchProps, FormTextarea, type FormTextareaProps, Heading, type HeadingLevel, type HeadingProps, type HeadingRole, Highlight, type HighlightProps, type IconDef, IconPicker, type IconPickerProps, Identity, type IdentityProps, InlineEdit, type InlineEditLabels, type InlineEditProps, Input, type InputProps, Kbd, type KbdProps, type KeyPadItem, KeyPadMenu, type KeyPadMenuProps, LiveRegion, type LiveRegionProps, Logo, type LogoProps, MenuButtonArrow, MenuItem, MenuItemCheckbox, MenuItemRadio, MenuPopover, MenuRoot, MenuSeparator, MenuTrigger, MenubarContainer, MenubarRoot, Meter, type MeterProps, NumberInput, type NumberInputProps, OtpField, type OtpFieldProps, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, type PaletteKind, PopoverClose, PopoverContent, type PopoverContentProps, PopoverRoot, PopoverTrigger, Progress, type ProgressProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, ResizableHandle, type ResizableHandleProps, ResizablePanel, ResizablePanelGroup, type GroupImperativeHandle as ResizablePanelGroupHandle, type ResizablePanelGroupProps, type PanelImperativeHandle as ResizablePanelHandle, type Layout as ResizablePanelLayout, type ResizablePanelProps, type PanelSize as ResizablePanelSize, SHADER_OVERLAY_PARAM_KEYS, SHADER_PARAM_FALLBACK, SHADER_PARAM_KEYS, SHADER_PRESETS, SHADER_PRESET_IDS, ScrollArea, type ScrollAreaProps, Section, type SectionProps, SelectItem, SelectLabel, SelectPopover, SelectRoot, SelectTrigger, Separator, type SeparatorProps, type ShaderParamKey, type ShaderParamSpec, type ShaderPreset, type ShaderPresetCategory, type ShaderPresetId, ShaderSurface, type ShaderSurfaceHandle, type ShaderSurfaceProps, Skeleton, SkeletonAvatar, SkeletonCard, type SkeletonProps, SkeletonTable, SkeletonText, Slider, type SliderProps, Spinner, type SpinnerProps, StatCard, type StatCardProps, StepBuilder, type StepBuilderProps, type StepDef, Switch, type SwitchProps, THEME_PALETTES, Tab, TabList, TabPanel, TabsRoot, TagInput, type TagInputProps, Text, type TextElement, type TextProps, type TextRole, type TextTone, TextTruncate, type TextTruncateProps, Textarea, type TextareaProps, Toggle, ToggleGroup, type ToggleGroupProps, type ToggleProps, ToolbarButton, ToolbarContainer, ToolbarRoot, ToolbarSeparator, Tooltip, TooltipAnchor, TooltipProvider, type TruncationSide, VirtualList, type VirtualListProps, createBlock, createBlock as createSurface, getShaderFragment, getShaderPreset, resolveFieldType, useFormContext, useFormStore };

package/dist/core/index.js

@@ -1,4 +1,4 @@
 "use client";
-import { $ as PopoverContent, $t as CompositeRow, A as FormRadioGroup, At as DialogDescription, B as FormSwitch, Bt as SelectPopover, Ct as ComboboxGroupLabel, D as FormProvider, Dt as ComboboxRoot, Et as ComboboxPopover, F as FormSelectItem, Ft as DialogHeading, G as useFormStore, Gt as TabPanel, H as FormTextarea, Ht as SelectTrigger, I as FormSelectPopover, It as DialogPanel, J as TagInput, Jt as DisclosureRoot, K as DEFAULT_PRESETS, Kt as TabsRoot, Lt as DialogRoot, M as FormReset, Mt as DialogDismiss, N as FormRoot, Nt as DialogFooter, O as FormPush, Ot as AlertDialogPanel, P as FormSelect, Pt as DialogHeader, Q as PopoverClose, Qt as CompositeProvider, Rt as SelectItem, S as FormGroupLabel, St as ComboboxGroup, T as FormLabel, Tt as ComboboxItem, Ut as Tab, Vt as SelectRoot, W as useFormContext, Wt as TabList, Xt as Composite, Y as IconPicker, Yt as DisclosureTrigger, Z as ColorPicker, Zt as CompositeItem, _n as SkeletonTable, _t as MenuSeparator, a as resolveFieldType, an as Alert, ar as Kbd, at as ToolbarContainer, b as FormField, bt as MenubarRoot, c as CheckboxGroup, cn as EmptyState, ct as Tooltip, dt as MenuButtonArrow, en as CompositeZone, et as PopoverRoot, ft as MenuItem, g as FormControl, gn as SkeletonCard, gt as MenuRoot, hn as SkeletonAvatar, ht as MenuPopover, i as FieldToken, it as ToolbarButton, j as FormRemove, jt as DialogDisclosure, k as FormRadio, kt as DialogBody, ln as Button, lt as TooltipAnchor, m as FormCheckbox, mn as Skeleton, mt as MenuItemRadio, n as Highlight, nt as Slider, o as Pagination, on as Spinner, ot as ToolbarRoot, pn as StatCard, pt as MenuItemCheckbox, q as DateRangePicker, qt as DisclosureContent, r as FIELD_TYPE_TOKENS, rn as Input, rt as NumberInput, s as Checkbox, sn as Badge, st as ToolbarSeparator, t as TextTruncate, tn as Meter, tt as PopoverTrigger, ut as TooltipProvider, v as FormDescription, vn as SkeletonText, vt as MenuTrigger, w as FormInput, wt as ComboboxInput, x as FormGroup, xt as ComboboxEmpty, y as FormError, yt as MenubarContainer, z as FormSubmit, zt as SelectLabel } from "../text-truncate-C17HHCR-.js";
-import { $ as Identity, A as PageHeader, B as DropdownTrigger, C as Logo, D as Section, E as ResizablePanelGroup, F as RadioGroup, G as Textarea, H as StepBuilder, I as DropdownContent, J as CardContent, K as Switch, L as DropdownItem, M as BlockLayout, O as Container, P as Radio, Q as CardTitle, R as DropdownMenu, S as DrawerRoot, T as ResizablePanel, U as CircularProgress, V as ConditionBuilder, W as Progress, X as CardFooter, Y as CardDescription, Z as CardHeader, _ as getShaderFragment, a as THEME_PALETTES, at as AccordionItem, b as DrawerClose, c as ExpressionGroup, ct as Toggle, d as ShaderSurface, dt as Separator, et as Avatar, f as SHADER_OVERLAY_PARAM_KEYS, ft as Heading, g as SHADER_PRESET_IDS, h as SHADER_PRESETS, i as ColorPalettePicker, it as AccordionContent, j as createBlock, k as ScrollArea, l as Facet, lt as ToggleGroup, m as SHADER_PARAM_KEYS, n as InlineEdit, nt as DescriptionList, o as LiveRegion, ot as AccordionRoot, p as SHADER_PARAM_FALLBACK, pt as Text, q as Card, r as ColorPaletteDisplay, rt as Breadcrumb, s as Expression, st as AccordionTrigger, t as KeyPadMenu, tt as AvatarGroup, u as FacetGroup, ut as OtpField, v as getShaderPreset, w as ResizableHandle, x as DrawerPanel, y as VirtualList, z as DropdownSeparator } from "../key-pad-menu-wXkWn1I1.js";
+import { $ as PopoverClose, $t as CompositeProvider, A as FormRadio, At as DialogBody, B as FormSubmit, Bt as SelectLabel, C as FormGroupLabel, Ct as ComboboxGroup, Dt as ComboboxPopover, E as FormLabel, Et as ComboboxItem, F as FormSelect, Ft as DialogHeader, G as useFormContext, Gt as TabList, Ht as SelectRoot, I as FormSelectItem, It as DialogHeading, J as DateRangePicker, Jt as DisclosureContent, K as useFormStore, Kt as TabPanel, L as FormSelectPopover, Lt as DialogPanel, M as FormRemove, Mt as DialogDisclosure, N as FormReset, Nt as DialogDismiss, O as FormProvider, Ot as ComboboxRoot, P as FormRoot, Pt as DialogFooter, Q as ColorPicker, Qt as CompositeItem, Rt as DialogRoot, S as FormGroup, St as ComboboxEmpty, T as FormInput, Tt as ComboboxInput, U as FormTextarea, Ut as SelectTrigger, V as FormSwitch, Vt as SelectPopover, Wt as Tab, X as IconPicker, Xt as DisclosureTrigger, Y as TagInput, Yt as DisclosureRoot, Zt as Composite, _ as FormControl, _n as SkeletonCard, _t as MenuRoot, at as ToolbarButton, b as FormError, bt as MenubarContainer, c as Checkbox, cn as Badge, ct as ToolbarSeparator, dt as TooltipProvider, en as CompositeRow, et as PopoverContent, ft as MenuButtonArrow, gn as SkeletonAvatar, gt as MenuPopover, h as FormCheckbox, hn as Skeleton, ht as MenuItemRadio, i as FieldToken, in as Input, it as NumberInput, j as FormRadioGroup, jt as DialogDescription, k as FormPush, kt as AlertDialogPanel, l as CheckboxGroup, ln as EmptyState, lt as Tooltip, mn as StatCard, mt as MenuItemCheckbox, n as Highlight, nn as Meter, nt as PopoverTrigger, o as resolveFieldType, on as Alert, or as Kbd, ot as ToolbarContainer, pt as MenuItem, q as DEFAULT_PRESETS, qt as TabsRoot, r as FIELD_TYPE_TOKENS, rt as Slider, s as Pagination, sn as Spinner, st as ToolbarRoot, t as TextTruncate, tn as CompositeZone, tt as PopoverRoot, un as Button, ut as TooltipAnchor, vn as SkeletonTable, vt as MenuSeparator, wt as ComboboxGroupLabel, x as FormField, xt as MenubarRoot, y as FormDescription, yn as SkeletonText, yt as MenuTrigger, zt as SelectItem } from "../text-truncate-DSuZECy0.js";
+import { $ as Identity, A as PageHeader, B as DropdownTrigger, C as Logo, D as Section, E as ResizablePanelGroup, F as RadioGroup, G as Textarea, H as StepBuilder, I as DropdownContent, J as CardContent, K as Switch, L as DropdownItem, M as BlockLayout, O as Container, P as Radio, Q as CardTitle, R as DropdownMenu, S as DrawerRoot, T as ResizablePanel, U as CircularProgress, V as ConditionBuilder, W as Progress, X as CardFooter, Y as CardDescription, Z as CardHeader, _ as getShaderFragment, a as THEME_PALETTES, at as AccordionItem, b as DrawerClose, c as ExpressionGroup, ct as Toggle, d as ShaderSurface, dt as Separator, et as Avatar, f as SHADER_OVERLAY_PARAM_KEYS, ft as Heading, g as SHADER_PRESET_IDS, h as SHADER_PRESETS, i as ColorPalettePicker, it as AccordionContent, j as createBlock, k as ScrollArea, l as Facet, lt as ToggleGroup, m as SHADER_PARAM_KEYS, n as InlineEdit, nt as DescriptionList, o as LiveRegion, ot as AccordionRoot, p as SHADER_PARAM_FALLBACK, pt as Text, q as Card, r as ColorPaletteDisplay, rt as Breadcrumb, s as Expression, st as AccordionTrigger, t as KeyPadMenu, tt as AvatarGroup, u as FacetGroup, ut as OtpField, v as getShaderPreset, w as ResizableHandle, x as DrawerPanel, y as VirtualList, z as DropdownSeparator } from "../key-pad-menu-Di2aRGbM.js";
 export { AccordionContent, AccordionItem, AccordionRoot, AccordionTrigger, Alert, AlertDialogPanel, Avatar, AvatarGroup, Badge, BlockLayout, BlockLayout as SurfaceLayout, Breadcrumb, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, CheckboxGroup, CircularProgress, ColorPaletteDisplay, ColorPalettePicker, ColorPicker, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxItem, ComboboxPopover, ComboboxRoot, Composite, CompositeItem, CompositeProvider, CompositeRow, CompositeZone, ConditionBuilder, Container, DEFAULT_PRESETS, DateRangePicker, DescriptionList, DialogBody, DialogDescription, DialogDisclosure, DialogDismiss, DialogFooter, DialogHeader, DialogHeading, DialogPanel, DialogRoot, DisclosureContent, DisclosureRoot, DisclosureTrigger, DrawerClose, DrawerPanel, DrawerRoot, DropdownContent, DropdownItem, DropdownMenu, DropdownSeparator, DropdownTrigger, EmptyState, Expression, ExpressionGroup, FIELD_TYPE_TOKENS, Facet, FacetGroup, FieldToken, FormCheckbox, FormControl, FormDescription, FormError, FormField, FormGroup, FormGroupLabel, FormInput, FormLabel, FormProvider, FormPush, FormRadio, FormRadioGroup, FormRemove, FormReset, FormRoot, FormSelect, FormSelectItem, FormSelectPopover, FormSubmit, FormSwitch, FormTextarea, Heading, Highlight, IconPicker, Identity, InlineEdit, Input, Kbd, KeyPadMenu, LiveRegion, Logo, MenuButtonArrow, MenuItem, MenuItemCheckbox, MenuItemRadio, MenuPopover, MenuRoot, MenuSeparator, MenuTrigger, MenubarContainer, MenubarRoot, Meter, NumberInput, OtpField, PageHeader, Pagination, PopoverClose, PopoverContent, PopoverRoot, PopoverTrigger, Progress, Radio, RadioGroup, ResizableHandle, ResizablePanel, ResizablePanelGroup, SHADER_OVERLAY_PARAM_KEYS, SHADER_PARAM_FALLBACK, SHADER_PARAM_KEYS, SHADER_PRESETS, SHADER_PRESET_IDS, ScrollArea, Section, SelectItem, SelectLabel, SelectPopover, SelectRoot, SelectTrigger, Separator, ShaderSurface, Skeleton, SkeletonAvatar, SkeletonCard, SkeletonTable, SkeletonText, Slider, Spinner, StatCard, StepBuilder, Switch, THEME_PALETTES, Tab, TabList, TabPanel, TabsRoot, TagInput, Text, TextTruncate, Textarea, Toggle, ToggleGroup, ToolbarButton, ToolbarContainer, ToolbarRoot, ToolbarSeparator, Tooltip, TooltipAnchor, TooltipProvider, VirtualList, createBlock, createBlock as createSurface, getShaderFragment, getShaderPreset, resolveFieldType, useFormContext, useFormStore };

package/dist/docs/02-components/01-core.md

@@ -1,11 +1,11 @@
 ---
 title: "Core Components"
-description: "70 Core layer components — props, examples, keyboard shortcuts."
-version: "1.10.0"
+description: "74 Core layer components — props, examples, keyboard shortcuts."
+version: "1.12.0"
 generated: true
 ---
 
-# Core Components (70)
+# Core Components (74)
 
 ## Input
 
@@ -132,16 +132,17 @@ const store = useFormStore({ defaultValues: { name: "" } });
 
 **Checkbox:**
 
-| Prop             | Type                         | Required | Default | Description                        |
-| ---------------- | ---------------------------- | -------- | ------- | ---------------------------------- |
-| `label`          | `string`                     |          |         | 체크박스 레이블                    |
-| `description`    | `string`                     |          |         | 레이블 아래 설명 텍스트            |
-| `checked`        | `boolean`                    |          |         | 제어 모드: 체크 상태               |
-| `defaultChecked` | `boolean`                    |          |         | 비제어 모드: 초기 체크 상태        |
-| `onChange`       | `(checked: boolean) => void` |          |         | 상태 변경 핸들러                   |
-| `size`           | `"sm" \| "md" \| "lg"`       |          | "md"    | 체크박스 크기                      |
-| `value`          | `string`                     |          |         | CheckboxGroup 내에서 사용할 값     |
-| `indeterminate`  | `boolean`                    |          | false   | 불확정 상태 표시 (마이너스 아이콘) |
+| Prop             | Type                         | Required | Default | Description                                                                |
+| ---------------- | ---------------------------- | -------- | ------- | -------------------------------------------------------------------------- |
+| `label`          | `string`                     |          |         | 체크박스 레이블                                                            |
+| `hint`           | `string`                     |          |         | 레이블 아래 보조 설명 텍스트                                               |
+| `description`    | `string`                     |          |         | 레이블 아래 설명 텍스트 **⚠️ deprecated since 1.9.0 — use `hint` instead** |
+| `checked`        | `boolean`                    |          |         | 제어 모드: 체크 상태                                                       |
+| `defaultChecked` | `boolean`                    |          |         | 비제어 모드: 초기 체크 상태                                                |
+| `onChange`       | `(checked: boolean) => void` |          |         | 상태 변경 핸들러                                                           |
+| `size`           | `"sm" \| "md" \| "lg"`       |          | "md"    | 체크박스 크기                                                              |
+| `value`          | `string`                     |          |         | CheckboxGroup 내에서 사용할 값                                             |
+| `indeterminate`  | `boolean`                    |          | false   | 불확정 상태 표시 (마이너스 아이콘)                                         |
 
 **CheckboxGroup:**
 
@@ -172,12 +173,13 @@ const store = useFormStore({ defaultValues: { name: "" } });
 
 **Radio:**
 
-| Prop          | Type                   | Required | Default | Description                                                |
-| ------------- | ---------------------- | -------- | ------- | ---------------------------------------------------------- |
-| `value`       | `string`               |          |         | 라디오 값 (RadioGroup 안에서는 부모가 관리하므로 optional) |
-| `label`       | `string`               |          |         | 라디오 레이블                                              |
-| `description` | `string`               |          |         | 레이블 아래 설명 텍스트                                    |
-| `size`        | `"sm" \| "md" \| "lg"` |          | "md"    | 라디오 크기                                                |
+| Prop          | Type                   | Required | Default | Description                                                                |
+| ------------- | ---------------------- | -------- | ------- | -------------------------------------------------------------------------- |
+| `value`       | `string`               |          |         | 라디오 값 (RadioGroup 안에서는 부모가 관리하므로 optional)                 |
+| `label`       | `string`               |          |         | 라디오 레이블                                                              |
+| `hint`        | `string`               |          |         | 레이블 아래 보조 설명 텍스트                                               |
+| `description` | `string`               |          |         | 레이블 아래 설명 텍스트 **⚠️ deprecated since 1.9.0 — use `hint` instead** |
+| `size`        | `"sm" \| "md" \| "lg"` |          | "md"    | 라디오 크기                                                                |
 
 **Keyboard Shortcuts:**
 
@@ -193,15 +195,16 @@ const store = useFormStore({ defaultValues: { name: "" } });
 
 **Import:** `import { Switch } from "@reopt-ai/opt-ui"`
 
-| Prop             | Type                         | Required | Default | Description                 |
-| ---------------- | ---------------------------- | -------- | ------- | --------------------------- |
-| `label`          | `string`                     |          |         | 스위치 레이블               |
-| `description`    | `string`                     |          |         | 레이블 아래 설명 텍스트     |
-| `checked`        | `boolean`                    |          |         | 제어 모드: 체크 상태        |
-| `defaultChecked` | `boolean`                    |          |         | 비제어 모드: 초기 체크 상태 |
-| `onChange`       | `(checked: boolean) => void` |          |         | 상태 변경 핸들러            |
-| `size`           | `"sm" \| "md" \| "lg"`       |          | "md"    | 스위치 크기                 |
-| `disabled`       | `boolean`                    |          |         | 비활성화 상태               |
+| Prop             | Type                         | Required | Default | Description                                                                |
+| ---------------- | ---------------------------- | -------- | ------- | -------------------------------------------------------------------------- |
+| `label`          | `string`                     |          |         | 스위치 레이블                                                              |
+| `hint`           | `string`                     |          |         | 레이블 아래 보조 설명 텍스트                                               |
+| `description`    | `string`                     |          |         | 레이블 아래 설명 텍스트 **⚠️ deprecated since 1.9.0 — use `hint` instead** |
+| `checked`        | `boolean`                    |          |         | 제어 모드: 체크 상태                                                       |
+| `defaultChecked` | `boolean`                    |          |         | 비제어 모드: 초기 체크 상태                                                |
+| `onChange`       | `(checked: boolean) => void` |          |         | 상태 변경 핸들러                                                           |
+| `size`           | `"sm" \| "md" \| "lg"`       |          | "md"    | 스위치 크기                                                                |
+| `disabled`       | `boolean`                    |          |         | 비활성화 상태                                                              |
 
 ### Select
 
@@ -354,21 +357,21 @@ import {
 
 **Import:** `import { DateRangePicker } from "@reopt-ai/opt-ui"`
 
-| Prop                  | Type                                                  | Required | Default             | Description                                            |
-| --------------------- | ----------------------------------------------------- | -------- | ------------------- | ------------------------------------------------------ |
-| `value`               | `DateRange`                                           |          |                     | 제어 모드: { start: Date \| null, end: Date \| null }  |
-| `onChange`            | `(range: DateRange) => void`                          |          |                     | 범위 변경 핸들러                                       |
-| `presets`             | `DateRangePreset[]`                                   |          |                     | 빠른 선택 프리셋 배열 (기본: Today, Last 7/30/90 days) |
-| `placeholder`         | `string`                                              |          | "Select date range" | 미선택 시 표시 텍스트                                  |
-| `label`               | `string`                                              |          |                     | 입력 필드 레이블                                       |
-| `disabled`            | `boolean`                                             |          | false               | 비활성화 상태                                          |
-| `format`              | `(date: Date) => string`                              |          |                     | 날짜 포맷 함수                                         |
-| `comparison`          | `boolean`                                             |          | false               | 비교 모드 활성화                                       |
-| `comparisonMode`      | `"previous" \| "year-over-year"`                      |          | "previous"          | 비교 기준 (이전 기간 / 전년 동기)                      |
-| `onComparisonChange`  | `(comparison: boolean, mode: ComparisonMode) => void` |          |                     | 비교 모드 변경 콜백                                    |
-| `showGranularity`     | `boolean`                                             |          | false               | 시간 단위 선택기 표시                                  |
-| `granularity`         | `"hour" \| "day" \| "week" \| "month"`                |          | "day"               | 시간 단위                                              |
-| `onGranularityChange` | `(granularity: DateGranularity) => void`              |          |                     | 시간 단위 변경 콜백                                    |
+| Prop                  | Type                                     | Required | Default             | Description                                            |
+| --------------------- | ---------------------------------------- | -------- | ------------------- | ------------------------------------------------------ |
+| `value`               | `DateRange`                              |          |                     | 제어 모드: { start: Date \| null, end: Date \| null }  |
+| `onChange`            | `(range: DateRange) => void`             |          |                     | 범위 변경 핸들러                                       |
+| `presets`             | `DateRangePreset[]`                      |          |                     | 빠른 선택 프리셋 배열 (기본: Today, Last 7/30/90 days) |
+| `placeholder`         | `string`                                 |          | "Select date range" | 미선택 시 표시 텍스트                                  |
+| `label`               | `string`                                 |          |                     | 입력 필드 레이블                                       |
+| `disabled`            | `boolean`                                |          | false               | 비활성화 상태                                          |
+| `format`              | `(date: Date) => string`                 |          |                     | 날짜 포맷 함수                                         |
+| `comparison`          | `boolean`                                |          | false               | 비교 모드 활성화                                       |
+| `comparisonMode`      | `"previous" \| "year-over-year"`         |          | "previous"          | 비교 기준 (이전 기간 / 전년 동기)                      |
+| `onComparisonChange`  | `(mode: ComparisonMode \| null) => void` |          |                     | 비교 모드 변경 콜백                                    |
+| `showGranularity`     | `boolean`                                |          | false               | 시간 단위 선택기 표시                                  |
+| `granularity`         | `"hour" \| "day" \| "week" \| "month"`   |          | "day"               | 시간 단위                                              |
+| `onGranularityChange` | `(granularity: DateGranularity) => void` |          |                     | 시간 단위 변경 콜백                                    |
 
 ### TagInput
 
@@ -1593,16 +1596,16 @@ import {
 
 **ResizablePanelGroup:**
 
-| Prop              | Type                                       | Required | Default | Description                                         |
-| ----------------- | ------------------------------------------ | -------- | ------- | --------------------------------------------------- |
-| `direction`       | `"horizontal" \| "vertical"`               | Yes      |         | 패널 분할 방향                                      |
-| `children`        | `ReactNode`                                | Yes      |         | ResizablePanel + ResizableHandle 조합               |
-| `id`              | `string`                                   |          |         | 그룹과 defaultLayout의 패널 크기를 식별하는 고유 ID |
-| `defaultLayout`   | `Record<string, number>`                   |          |         | 패널 ID별 초기 비율(0-100)                          |
-| `onLayoutChanged` | `(layout: Record<string, number>) => void` |          |         | 드래그가 끝난 뒤 확정된 레이아웃 콜백               |
-| `groupRef`        | `Ref<ResizablePanelGroupHandle>`           |          |         | 레이아웃 조회·설정을 위한 명령형 그룹 ref           |
-| `autoSaveId`      | `string`                                   |          |         | id의 deprecated 별칭                                |
-| `className`       | `string`                                   |          |         | 커스텀 CSS 클래스                                   |
+| Prop              | Type                                       | Required | Default | Description                                                                                                                           |
+| ----------------- | ------------------------------------------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `direction`       | `"horizontal" \| "vertical"`               | Yes      |         | 패널 분할 방향                                                                                                                        |
+| `children`        | `ReactNode`                                | Yes      |         | ResizablePanel + ResizableHandle 조합                                                                                                 |
+| `id`              | `string`                                   |          |         | 그룹과 defaultLayout의 패널 크기를 식별하는 고유 ID                                                                                   |
+| `defaultLayout`   | `Record<string, number>`                   |          |         | 패널 ID별 초기 비율(0-100)                                                                                                            |
+| `onLayoutChanged` | `(layout: Record<string, number>) => void` |          |         | 드래그가 끝난 뒤 확정된 레이아웃 콜백                                                                                                 |
+| `groupRef`        | `Ref<ResizablePanelGroupHandle>`           |          |         | 레이아웃 조회·설정을 위한 명령형 그룹 ref                                                                                             |
+| `autoSaveId`      | `string`                                   |          |         | id의 deprecated 별칭 **⚠️ deprecated since 1.6.0 — use `id` instead — id + defaultLayout + onLayoutChanged 조합으로 대체되었습니다.** |
+| `className`       | `string`                                   |          |         | 커스텀 CSS 클래스                                                                                                                     |
 
 **ResizablePanel:**
 
@@ -1679,36 +1682,40 @@ import {
 
 ## Other
 
-| Component       | Description                                                                                                                                                                               | Key Exports                                                                                                                                     |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| FieldToken      | 필드 타입을 글리프 하나로 표현하는 토큰. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 고정된 아이콘과 팔레트 슬롯을 부여해 필드 목록·컬럼 헤더·속성 테이블 전역에서 같은 어휘를 쓴다. | `FieldToken`, `FIELD_TYPE_TOKENS`, `resolveFieldType`                                                                                           |
-| Facet           | 필드 값 분포를 카운트와 점유율 막대로 보여주고 그 행 자체가 필터가 되는 패싯. 긴 꼬리는 접어 두고 상위 값부터 읽힌다.                                                                     | `Facet`, `FacetGroup`                                                                                                                           |
-| Expression      | 조건을 폼이 아니라 문장으로 쓰고 그 자리에서 편집하는 표현식 절. 알림 규칙·세그먼트 필터처럼 읽어서 검증해야 하는 조건에 쓴다.                                                            | `Expression`, `ExpressionGroup`                                                                                                                 |
-| TextTruncate    | 실제 폰트로 실제 가용 폭을 측정해 문자열의 식별력이 가장 낮은 부분을 잘라내는 생략. CSS가 못 하는 앞·중간·양끝 생략을 지원하고 전체 문자열은 접근성 트리에 남는다.                        | `TextTruncate`                                                                                                                                  |
-| Highlight       | 검색어에 해당하는 구간을 <mark>로 표시. 긴 항목 우선 매칭이라 겹치는 검색어도 조각나지 않는다.                                                                                            | `Highlight`                                                                                                                                     |
-| LiveRegion      | 라이브 뷰의 변화를 스크린 리더에 읽어 주는 영역. 스로틀로 폭주를 요약하고 두 노드를 번갈아 써서 같은 문구도 다시 읽힌다.                                                                  | `LiveRegion`                                                                                                                                    |
-| ColorPalette    | 시각화 색 팔레트를 그 팔레트의 모습 그대로 보여 주고 고르게 하는 컴포넌트. 범주형은 블록, 순차·발산형은 그라디언트로 그려 데이터 종류를 그림이 말한다.                                    | `ColorPaletteDisplay`, `ColorPalettePicker`, `THEME_PALETTES`                                                                                   |
-| InlineEdit      | 대시보드 제목·지표 이름처럼 읽히는 횟수가 훨씬 많은 값을 그 자리에서 고치는 편집. Enter 확정, Escape 되돌리기, 거절된 저장은 입력을 유지한다.                                             | `InlineEdit`                                                                                                                                    |
-| KeyPadMenu      | 이름보다 그림으로 알아보기 쉬운 선택지를 타일로 고르는 메뉴. 내부는 실제 radio·checkbox라 키보드와 스크린 리더가 그대로 동작한다.                                                         | `KeyPadMenu`                                                                                                                                    |
-| Text            | 본문, 레이블, 보조 설명, 코드에 일관된 의미 기반 타이포그래피를 적용합니다.                                                                                                               | `Text`                                                                                                                                          |
-| Heading         | 문서의 의미 계층과 시각적 타이포그래피 계층을 독립적으로 제어합니다.                                                                                                                      | `Heading`                                                                                                                                       |
-| Separator       | 콘텐츠를 구분하는 가로/세로 디바이더. 라벨을 넣으면 가운데 정렬 구분선이 된다.                                                                                                            | `Separator`                                                                                                                                     |
-| OtpField        | 일회용 코드(OTP)/PIN 입력. 셀 단위 입력, 붙여넣기 분배, 자동 포커스 이동, 백스페이스 네비게이션과 폼 이름/오류 연결을 지원합니다.                                                         | `OtpField`                                                                                                                                      |
-| Toggle          | 눌림(pressed) 두 상태 버튼. 단독 사용하거나 ToggleGroup으로 묶어 단일/다중 선택을 만든다.                                                                                                 | `Toggle`, `ToggleGroup`                                                                                                                         |
-| Accordion       | 수직으로 쌓인 펼침/접힘 패널. single(한 개)/multiple(여러 개) 모드와 collapsible 지원.                                                                                                    | `AccordionRoot`, `AccordionItem`, `AccordionTrigger`, `AccordionContent`                                                                        |
-| Meter           | 범위 내 스칼라 측정값 게이지 (디스크 사용량·점수·용량 등). role=meter로 작업 진행률(Progress)과 구분된다.                                                                                 | `Meter`                                                                                                                                         |
-| DescriptionList | 한 대상의 라벨 있는 사실들을 시맨틱 <dl>로 표시한다. 상세 패널의 필드 나열을 표준화하고 식별자 복사를 제공한다.                                                                           | `DescriptionList`                                                                                                                               |
-| Identity        | 사람(또는 익명 디바이스)을 목록 셀 한 칸으로 표현한다. 이름→이메일→ID 폴백과 익명 표식을 한 곳에서 처리한다.                                                                              | `Identity`                                                                                                                                      |
-| BlockLayout     | Block 루트 레이아웃. 자식 간 section spacing과 선택적 시맨틱 inset을 제공하고 loading prop으로 LoadingOverlay를 자동 래핑합니다.                                                          | `BlockLayout`                                                                                                                                   |
-| createBlock     | Block 팩토리 함수. BlockLayout 래핑을 구조적으로 강제하여 loading/className 처리를 자동화합니다.                                                                                          | `createBlock`                                                                                                                                   |
-| StarRating      | 1~N점 별점을 선택하는 인터랙티브 레이팅 입력. 읽기 전용 표시도 지원.                                                                                                                      | `StarRating`                                                                                                                                    |
-| ErrorBoundary   | React 에러 바운더리. 자식 컴포넌트 렌더 에러를 잡아 fallback UI를 표시합니다.                                                                                                             | `ErrorBoundary`                                                                                                                                 |
-| Command         | cmdk 스타일 명령 anatomy. 자동 필터링 + 키보드 내비게이션. 인라인 또는 CommandDialog로 사용.                                                                                              | `Command`, `CommandDialog`, `CommandInput`, `CommandList`, `CommandEmpty`, `CommandGroup`, `CommandItem`, `CommandSeparator`, `CommandShortcut` |
-| ShaderSurface   | ogl 기반 애니메이션 WebGL 셰이더 배경. 럭셔리 프리셋(메탈릭/실크/유리 등) + 색·파라미터로 배경·카드 배경을 만든다. 정지 프레임·PNG 캡처·WebGL 폴백 지원.                                  | `ShaderSurface`                                                                                                                                 |
+| Component        | Description                                                                                                                                                        | Key Exports                                                                                                                                     |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| FieldToken       | 필드 타입을 일관된 글리프와 선택적 텍스트 레이블로 표현합니다. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 같은 아이콘과 팔레트 슬롯을 씁니다.                | `FieldToken`, `FIELD_TYPE_TOKENS`, `resolveFieldType`                                                                                           |
+| Facet            | 필드 값 분포를 카운트와 점유율 막대로 보여주고 그 행 자체가 필터가 되는 패싯. 긴 꼬리는 접어 두고 상위 값부터 읽힌다.                                              | `Facet`, `FacetGroup`                                                                                                                           |
+| Expression       | 조건을 폼이 아니라 문장으로 쓰고 그 자리에서 편집하는 표현식 절. 알림 규칙·세그먼트 필터처럼 읽어서 검증해야 하는 조건에 쓴다.                                     | `Expression`, `ExpressionGroup`                                                                                                                 |
+| TextTruncate     | 실제 폰트로 실제 가용 폭을 측정해 문자열의 식별력이 가장 낮은 부분을 잘라내는 생략. CSS가 못 하는 앞·중간·양끝 생략을 지원하고 전체 문자열은 접근성 트리에 남는다. | `TextTruncate`                                                                                                                                  |
+| Highlight        | 검색어에 해당하는 구간을 <mark>로 표시. 긴 항목 우선 매칭이라 겹치는 검색어도 조각나지 않는다.                                                                     | `Highlight`                                                                                                                                     |
+| LiveRegion       | 라이브 뷰의 변화를 스크린 리더에 읽어 주는 영역. 스로틀로 폭주를 요약하고 두 노드를 번갈아 써서 같은 문구도 다시 읽힌다.                                           | `LiveRegion`                                                                                                                                    |
+| ColorPalette     | 시각화 색 팔레트를 그 팔레트의 모습 그대로 보여 주고 고르게 하는 컴포넌트. 범주형은 블록, 순차·발산형은 그라디언트로 그려 데이터 종류를 그림이 말한다.             | `ColorPaletteDisplay`, `ColorPalettePicker`, `THEME_PALETTES`                                                                                   |
+| InlineEdit       | 대시보드 제목·지표 이름처럼 읽히는 횟수가 훨씬 많은 값을 그 자리에서 고치는 편집. Enter 확정, Escape 되돌리기, 거절된 저장은 입력을 유지한다.                      | `InlineEdit`                                                                                                                                    |
+| KeyPadMenu       | 이름보다 그림으로 알아보기 쉬운 선택지를 타일로 고르는 메뉴. 내부는 실제 radio·checkbox라 키보드와 스크린 리더가 그대로 동작한다.                                  | `KeyPadMenu`                                                                                                                                    |
+| Text             | 본문, 레이블, 보조 설명, 코드에 일관된 의미 기반 타이포그래피를 적용합니다.                                                                                        | `Text`                                                                                                                                          |
+| Heading          | 문서의 의미 계층과 시각적 타이포그래피 계층을 독립적으로 제어합니다.                                                                                               | `Heading`                                                                                                                                       |
+| Separator        | 콘텐츠를 구분하는 가로/세로 디바이더. 라벨을 넣으면 가운데 정렬 구분선이 된다.                                                                                     | `Separator`                                                                                                                                     |
+| OtpField         | 일회용 코드(OTP)/PIN 입력. 셀 단위 입력, 붙여넣기 분배, 자동 포커스 이동, 백스페이스 네비게이션과 폼 이름/오류 연결을 지원합니다.                                  | `OtpField`                                                                                                                                      |
+| Toggle           | 눌림(pressed) 두 상태 버튼. 단독 사용하거나 ToggleGroup으로 묶어 단일/다중 선택을 만든다.                                                                          | `Toggle`, `ToggleGroup`                                                                                                                         |
+| Accordion        | 수직으로 쌓인 펼침/접힘 패널. single(한 개)/multiple(여러 개) 모드와 collapsible 지원.                                                                             | `AccordionRoot`, `AccordionItem`, `AccordionTrigger`, `AccordionContent`                                                                        |
+| Meter            | 범위 내 스칼라 측정값 게이지 (디스크 사용량·점수·용량 등). role=meter로 작업 진행률(Progress)과 구분된다.                                                          | `Meter`                                                                                                                                         |
+| DescriptionList  | 한 대상의 라벨 있는 사실들을 시맨틱 <dl>로 표시한다. 상세 패널의 필드 나열을 표준화하고 식별자 복사를 제공한다.                                                    | `DescriptionList`                                                                                                                               |
+| Identity         | 사람(또는 익명 디바이스)을 목록 셀 한 칸으로 표현한다. 이름→이메일→ID 폴백과 익명 표식을 한 곳에서 처리한다.                                                       | `Identity`                                                                                                                                      |
+| BlockLayout      | Block 루트 레이아웃. 자식 간 section spacing과 선택적 시맨틱 inset을 제공하고 loading prop으로 LoadingOverlay를 자동 래핑합니다.                                   | `BlockLayout`                                                                                                                                   |
+| createBlock      | Block 팩토리 함수. BlockLayout 래핑을 구조적으로 강제하여 loading/className 처리를 자동화합니다.                                                                   | `createBlock`                                                                                                                                   |
+| StarRating       | 1~N점 별점을 선택하는 인터랙티브 레이팅 입력. 읽기 전용 표시도 지원.                                                                                               | `StarRating`                                                                                                                                    |
+| ErrorBoundary    | React 에러 바운더리. 자식 컴포넌트 렌더 에러를 잡아 fallback UI를 표시합니다.                                                                                      | `ErrorBoundary`                                                                                                                                 |
+| Command          | cmdk 스타일 명령 anatomy. 자동 필터링 + 키보드 내비게이션. 인라인 또는 CommandDialog로 사용.                                                                       | `Command`, `CommandDialog`, `CommandInput`, `CommandList`, `CommandEmpty`, `CommandGroup`, `CommandItem`, `CommandSeparator`, `CommandShortcut` |
+| ShaderSurface    | ogl 기반 애니메이션 WebGL 셰이더 배경. 럭셔리 프리셋(메탈릭/실크/유리 등) + 색·파라미터로 배경·카드 배경을 만든다. 정지 프레임·PNG 캡처·WebGL 폴백 지원.           | `ShaderSurface`                                                                                                                                 |
+| Callout          | 페이지에 머무는 인페이지 고지. Alert와 달리 dismiss가 없고, 조건이 참인 동안 레이아웃의 일부로 남습니다.                                                           | `Callout`                                                                                                                                       |
+| StatusDot        | 점 + 텍스트로 상태를 표현합니다. 라벨이 필수라 색만으로 상태를 말할 수 없습니다.                                                                                   | `StatusDot`                                                                                                                                     |
+| CopyButton       | 값을 클립보드에 올리고 성공 여부를 알립니다. 클립보드 거부를 삼키지 않습니다.                                                                                      | `CopyButton`                                                                                                                                    |
+| SegmentedControl | 선택지를 모두 보여주는 단일 선택 컨트롤. radio-group 프리미티브 위에 올려 화살표 키가 동작합니다.                                                                  | `SegmentedControl`                                                                                                                              |
 
 ### FieldToken
 
-> 필드 타입을 글리프 하나로 표현하는 토큰. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 고정된 아이콘과 팔레트 슬롯을 부여해 필드 목록·컬럼 헤더·속성 테이블 전역에서 같은 어휘를 쓴다.
+> 필드 타입을 일관된 글리프와 선택적 텍스트 레이블로 표현합니다. 문자열·숫자·날짜·IP·지오 등 분석 스키마 타입마다 같은 아이콘과 팔레트 슬롯을 씁니다.
 
 **Import:** `import { FieldToken } from "@reopt-ai/opt-ui"`
 
@@ -1720,6 +1727,8 @@ import {
 | `shape`      | `"square" \| "circle"`          |          | "square" | 토큰 모양                                               |
 | `title`      | `string`                        |          |          | 접근성 이름. 기본값은 타입 이름                         |
 | `decorative` | `boolean`                       |          | false    | 인접 텍스트가 타입을 이미 말할 때 접근성 트리에서 제외  |
+| `withLabel`  | `boolean`                       |          | false    | 글리프 옆에 타입 이름을 함께 표시                       |
+| `label`      | `string`                        |          |          | withLabel이 표시할 문구. 기본값은 타입 이름             |
 | `className`  | `string`                        |          |          | 추가 CSS 클래스                                         |
 
 ### Facet
@@ -1922,11 +1931,11 @@ import {
 
 **Import:** `import { Heading } from "@reopt-ai/opt-ui"`
 
-| Prop       | Type                                                                     | Required | Default | Description              |
-| ---------- | ------------------------------------------------------------------------ | -------- | ------- | ------------------------ |
-| `level`    | `1 \| 2 \| 3 \| 4 \| 5 \| 6`                                             |          |         | 의미 기반 HTML 제목 레벨 |
-| `variant`  | `"heading-1" … "heading-6" \| "display-1" \| "display-2" \| "display-3"` |          |         | 시각적 제목 역할         |
-| `children` | `ReactNode`                                                              |          |         | 제목 콘텐츠              |
+| Prop       | Type                                                                                                                                  | Required | Default | Description              |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ------------------------ |
+| `level`    | `1 \| 2 \| 3 \| 4 \| 5 \| 6`                                                                                                          |          |         | 의미 기반 HTML 제목 레벨 |
+| `variant`  | `"heading-1" \| "heading-2" \| "heading-3" \| "heading-4" \| "heading-5" \| "heading-6" \| "display-1" \| "display-2" \| "display-3"` |          |         | 시각적 제목 역할         |
+| `children` | `ReactNode`                                                                                                                           |          |         | 제목 콘텐츠              |
 
 ### Separator
 
@@ -2241,3 +2250,63 @@ const MyDashboard = createBlock<MyDashboardProps>(
 | `angle`      | `number`         |          |         | 회전 각도(도)                              |
 | `paused`     | `boolean`        |          |         | true면 단일 프레임만 렌더 (카드 배경 등)   |
 | `dpr`        | `number`         |          |         | device pixel ratio 상한 (기본 min(dpr, 2)) |
+
+### Callout
+
+> 페이지에 머무는 인페이지 고지. Alert와 달리 dismiss가 없고, 조건이 참인 동안 레이아웃의 일부로 남습니다.
+
+**Import:** `import { Callout } from "@reopt-ai/opt-ui"`
+
+| Prop       | Type                                                        | Required | Default | Description                                 |
+| ---------- | ----------------------------------------------------------- | -------- | ------- | ------------------------------------------- |
+| `tone`     | `"info" \| "success" \| "warning" \| "danger" \| "neutral"` |          | "info"  | 고지의 성격                                 |
+| `title`    | `ReactNode`                                                 |          |         | 한 줄 제목                                  |
+| `icon`     | `ReactNode`                                                 |          |         | tone 기본 글리프 대체. null이면 글리프 없음 |
+| `action`   | `ReactNode`                                                 |          |         | 다음 한 걸음. 둘 이상이면 고지가 아니라 폼  |
+| `size`     | `"sm" \| "md"`                                              |          | "md"    | 밀도                                        |
+| `children` | `ReactNode`                                                 |          |         | 본문                                        |
+
+### StatusDot
+
+> 점 + 텍스트로 상태를 표현합니다. 라벨이 필수라 색만으로 상태를 말할 수 없습니다.
+
+**Import:** `import { StatusDot } from "@reopt-ai/opt-ui"`
+
+| Prop       | Type                                                                   | Required | Default   | Description                            |
+| ---------- | ---------------------------------------------------------------------- | -------- | --------- | -------------------------------------- |
+| `tone`     | `"neutral" \| "muted" \| "info" \| "success" \| "warning" \| "danger"` |          | "neutral" | 점 색상                                |
+| `size`     | `"sm" \| "md"`                                                         |          | "md"      | 점과 글자 크기                         |
+| `children` | `ReactNode`                                                            | Yes      |           | 상태 라벨. 필수 — 색은 상태가 아닙니다 |
+| `hint`     | `string`                                                               |          |           | 판정 기준 툴팁                         |
+
+### CopyButton
+
+> 값을 클립보드에 올리고 성공 여부를 알립니다. 클립보드 거부를 삼키지 않습니다.
+
+**Import:** `import { CopyButton } from "@reopt-ai/opt-ui"`
+
+| Prop               | Type                    | Required | Default | Description                                             |
+| ------------------ | ----------------------- | -------- | ------- | ------------------------------------------------------- |
+| `value`            | `string`                | Yes      |         | 복사할 텍스트                                           |
+| `variant`          | `"icon" \| "text"`      |          | "icon"  | 글리프만 / 글리프 + 라벨                                |
+| `size`             | `"sm" \| "md"`          |          | "md"    | 버튼 크기                                               |
+| `feedbackDuration` | `number`                |          | 1500    | 확인 상태 유지 시간 (ms)                                |
+| `onCopy`           | `(ok: boolean) => void` |          |         | 실제로 복사됐는지 — 비보안 컨텍스트·권한 거부에서 false |
+| `labels`           | `CopyButtonLabels`      |          |         | copy / copied / failed 문구                             |
+
+### SegmentedControl
+
+> 선택지를 모두 보여주는 단일 선택 컨트롤. radio-group 프리미티브 위에 올려 화살표 키가 동작합니다.
+
+**Import:** `import { SegmentedControl } from "@reopt-ai/opt-ui"`
+
+| Prop         | Type                          | Required | Default | Description                                             |
+| ------------ | ----------------------------- | -------- | ------- | ------------------------------------------------------- |
+| `options`    | `SegmentedControlOption<T>[]` | Yes      |         | 세그먼트 목록 (value / label / icon / badge / disabled) |
+| `value`      | `T`                           | Yes      |         | 선택된 값                                               |
+| `onChange`   | `(value: T) => void`          | Yes      |         | 선택 변경                                               |
+| `size`       | `"sm" \| "md"`                |          | "md"    | 컨트롤 크기                                             |
+| `fullWidth`  | `boolean`                     |          | false   | 컨테이너를 균등 분할                                    |
+| `disabled`   | `boolean`                     |          | false   | 전체 비활성                                             |
+| `aria-label` | `string`                      | Yes      |         | radiogroup 이름. 필수                                   |
+| `className`  | `string`                      |          |         | 추가 CSS 클래스                                         |

package/dist/docs/02-components/02-visuals.md

@@ -1,7 +1,7 @@
 ---
 title: "Visual Components"
 description: "0 Visual layer components — props, examples, keyboard shortcuts."
-version: "1.10.0"
+version: "1.12.0"
 generated: true
 ---