@bestow-ui/react 1.4.0 → 1.6.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import * as _bestow_ui_tokens from '@bestow-ui/tokens';
 import { space } from '@bestow-ui/tokens';
 import * as react from 'react';
-import { ReactNode, HTMLAttributes, ElementType, CSSProperties, ComponentPropsWithoutRef, InputHTMLAttributes, ButtonHTMLAttributes, AnchorHTMLAttributes, ReactElement, OlHTMLAttributes, TdHTMLAttributes, ThHTMLAttributes, ChangeEvent, TextareaHTMLAttributes } from 'react';
+import { ReactNode, HTMLAttributes, ElementType, CSSProperties, ComponentPropsWithoutRef, InputHTMLAttributes, ButtonHTMLAttributes, AnchorHTMLAttributes, ReactElement, SelectHTMLAttributes, OlHTMLAttributes, TdHTMLAttributes, ThHTMLAttributes, ChangeEvent, TextareaHTMLAttributes } from 'react';
+export { composeExtraAddress, formatBusinessNumber, formatKoreanAmount, formatKoreanDate, formatPhoneNumber, isValidBusinessNumber } from '@bestow-ui/korean-utils';
 import * as RadixAccordion from '@radix-ui/react-accordion';
 import * as Dialog from '@radix-ui/react-dialog';
 import * as RadixMenu from '@radix-ui/react-dropdown-menu';
@@ -85,12 +86,14 @@ type Widen<T> = {
  * 그래서 넣지 않으면 화면이 그대로이고, 기존 토큰(border.default 등)을 덮어쓴 사용자 설정도 계속 따른다(하위 영역의 CSS 덮어쓰기 포함).
  * - `color.border.input`·`inputHover` (1.x 추가): 입력 칸(Input·Select·Combobox·Textarea·인증번호 칸 등) 테두리. 기본은 border.default·border.strong.
  *   흰 배경과 1.3:1 인 기본 테두리를 3:1 이상으로 올리려면 `strongInputBorders` 를 쓴다(2.0 에서 기본값이 될 예정).
+ * - `color.border.control` (1.x 추가): Checkbox·Radio 테두리, 꺼진 Switch 트랙, Stepper 의 예정 단계. 기본은 border.strong(라이트 2.07:1).
  */
 declare const optionalTokens: {
     color: {
         border: {
             input: string;
             inputHover: string;
+            control: string;
         };
     };
 };
@@ -100,6 +103,7 @@ declare const vars: {
         border: {
             input: `var(--${string})`;
             inputHover: `var(--${string})`;
+            control: `var(--${string})`;
             default: `var(--${string})`;
             strong: `var(--${string})`;
             focus: `var(--${string})`;
@@ -272,9 +276,9 @@ type IntentName = 'primary' | 'neutral' | 'danger' | 'success' | 'warning';
 declare function createIntentColors(intent: IntentName, color: string): ThemeInput;
 
 /**
- * 입력 칸 테두리를 배경과 3:1 이상으로 올리는 테마 입력 (WCAG 1.4.11 비텍스트 대비).
- * 기본 테두리(border.default)는 흰 배경과 1.3:1 이라 칸의 경계가 잘 보이지 않는다 — 2.0 에서 기본값이 될 예정.
- * hover 는 테두리보다 더 진하게(다크는 더 밝게) 바뀐다.
+ * 입력 칸·체크 컨트롤 테두리를 배경과 3:1 이상으로 올리는 테마 입력 (WCAG 1.4.11 비텍스트 대비) — 2.0 에서 기본값이 될 예정.
+ * - 입력 칸(border.input): 기본 border.default 는 흰 배경과 1.3:1. hover 는 테두리보다 더 진하게(다크는 더 밝게).
+ * - Checkbox·Radio 테두리, 꺼진 Switch, Stepper 예정 단계(border.control): 기본 border.strong 은 라이트 흰 배경과 2.07:1.
  *
  * @example
  * <ThemeProvider overrides={createTheme(strongInputBorders)}>…</ThemeProvider>
@@ -416,40 +420,10 @@ declare function useMessages(): Messages;
  */
 declare const en: BestowMessages;
 
-/**
- * 숫자만 있는 전화번호에 하이픈을 넣는다. 입력 중인 값도 자연스럽게 나눈다.
- * @example formatPhoneNumber('01012345678') // '010-1234-5678'
- * @example formatPhoneNumber('021234567')   // '02-123-4567'
- * @example formatPhoneNumber('15881234')    // '1588-1234'
- */
-declare function formatPhoneNumber(input: string): string;
-/**
- * 사업자등록번호(10자리)에 하이픈을 넣는다.
- * @example formatBusinessNumber('1234567890') // '123-45-67890'
- */
-declare function formatBusinessNumber(input: string): string;
-/**
- * 사업자등록번호 검증 공식(가중치 1,3,7,1,3,7,1,3,5)으로 확인한다. 실제로 등록된 번호인지는 국세청 조회가 필요하다.
- * @example isValidBusinessNumber('124-81-00998') // true
- */
-declare function isValidBusinessNumber(input: string): boolean;
-/**
- * 금액을 만·억·조 단위로 읽기 쉽게 쓴다.
- * @example formatKoreanAmount(125000)     // '12만 5,000원'
- * @example formatKoreanAmount(150000000)  // '1억 5,000만원'
- * @example formatKoreanAmount(0)          // '0원'
- */
-declare function formatKoreanAmount(amount: number, unit?: string): string;
-
 /** Date → 'YYYY-MM-DD' (로컬 기준) */
 declare function toISODate(date: Date): string;
 /** 'YYYY-MM-DD' → Date (로컬 자정). 형식이 틀리거나 없는 날짜(2월 30일 등)면 null */
 declare function parseISODate(value: string | null | undefined): Date | null;
-/**
- * 한국어 날짜. 스크린리더용 날짜 이름 등에 쓴다.
- * @example formatKoreanDate(new Date(2026, 9, 15)) // '2026년 10월 15일 목요일'
- */
-declare function formatKoreanDate(date: Date, withWeekday?: boolean): string;
 
 /** 주소 검색 결과 */
 interface AddressSearchResult {
@@ -465,18 +439,7 @@ interface AddressSearchResult {
  * 정리 함수를 돌려주면 검색 창이 닫힐 때 부른다. 다른 주소 서비스(행정안전부 도로명주소 API 등)로 바꿔 끼울 수 있다.
  */
 type AddressProvider = (container: HTMLElement, onSelect: (result: AddressSearchResult) => void) => void | (() => void) | Promise<void | (() => void)>;
-interface KakaoPostcodeData {
-    zonecode: string;
-    userSelectedType: 'R' | 'J';
-    roadAddress: string;
-    jibunAddress: string;
-    autoJibunAddress?: string;
-    bname: string;
-    buildingName: string;
-    apartment: 'Y' | 'N';
-}
-/** 카카오 가이드의 방식으로 도로명 주소의 참고 항목(법정동, 공동주택 건물명)을 만든다 */
-declare function composeExtraAddress(data: Pick<KakaoPostcodeData, 'userSelectedType' | 'bname' | 'buildingName' | 'apartment'>): string;
+
 /**
  * 기본 공급자: 카카오(다음) 우편번호 서비스. 처음 쓸 때 스크립트를 불러오므로 코어 번들 크기에 영향이 없다.
  * 사용 조건은 서비스 가이드를 따른다.
@@ -1639,6 +1602,37 @@ interface SegmentedControlProps {
  */
 declare const SegmentedControl: react.ForwardRefExoticComponent<SegmentedControlProps & react.RefAttributes<HTMLDivElement>>;
 
+interface NativeSelectOption {
+    value: string;
+    /** `<option>` 은 글자만 담을 수 있어 문자열 */
+    label: string;
+    disabled?: boolean;
+}
+interface NativeSelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size' | 'multiple'> {
+    /** 선택지 목록. 없으면 children 의 `<option>`·`<optgroup>` 을 그대로 쓴다 */
+    options?: NativeSelectOption[];
+    /** 값이 바뀔 때 새 값으로 호출된다 (Select 와 같은 이름). 네이티브 onChange 도 함께 쓸 수 있다 */
+    onValueChange?: (value: string) => void;
+    /** 선택 전 표시할 문구 — 값이 '' 인 고를 수 없는 첫 항목으로 들어간다 */
+    placeholder?: string;
+    /** 위에 표시할 레이블 */
+    label?: ReactNode;
+    /** 아래에 표시할 도움말. error 일 때는 에러 메시지로 표시된다 */
+    helperText?: ReactNode;
+    /** 에러 상태 */
+    error?: boolean;
+    /** 크기 */
+    size?: 'sm' | 'md' | 'lg';
+    /** 부모 너비를 꽉 채운다 */
+    fullWidth?: boolean;
+}
+/**
+ * 브라우저 기본 `<select>` 에 Select 와 같은 모양을 입힌 것. Radix 가 없어 가볍고(폼 세트 번들이 크게 준다),
+ * 모바일에서는 운영체제의 선택 화면이 열린다. `register(...)` 를 그대로 펼칠 수 있다.
+ * 목록 모양을 꾸미거나 항목에 아이콘을 넣어야 하면 Select 를 쓴다.
+ */
+declare const NativeSelect: react.ForwardRefExoticComponent<NativeSelectProps & react.RefAttributes<HTMLSelectElement>>;
+
 interface SelectOption {
     value: string;
     label: ReactNode;
@@ -1795,6 +1789,10 @@ interface SwitchProps {
     /** 바깥 래퍼 className */
     className?: string;
 }
+/**
+ * 켜고 끄는 스위치. `<button role="switch">` 로 그리고, form 안에서는 숨긴 checkbox 로 값 제출·required 검증·reset 을 처리한다
+ * (1.5 까지 쓰던 Radix Switch 와 같은 동작 — 번들을 줄이려고 직접 구현).
+ */
 declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLButtonElement>>;
 
 type TableSize = 'sm' | 'md';
@@ -2050,5 +2048,5 @@ interface VerificationCodeInputProps {
  */
 declare const VerificationCodeInput: react.ForwardRefExoticComponent<VerificationCodeInputProps & react.RefAttributes<HTMLInputElement>>;
 
-export { Accordion, AccordionItem, AddressInput, AgreementGroup, Alert, AmountInput, Avatar, Badge, Breadcrumb, BusinessNumberInput, Button, Calendar, Card, CardBody, CardFooter, CardHeader, Checkbox, Combobox, DatePicker, DateRangePicker, DescriptionList, Divider, Drawer, DrawerClose, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorSummary, FileUpload, IconButton, Input, Link, LocaleProvider, Modal, ModalClose, NumberInput, Pagination, PhoneNumberInput, Popover, PopoverClose, Progress, RadioGroup, SegmentedControl, Select, Skeleton, SkipLink, Slider, Spinner, Stack, Stepper, Switch, Table, TableBody, TableCell, TableEmpty, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, ThemeProvider, ToastProvider, Tooltip, Typography, VerificationCodeInput, VisuallyHidden, composeExtraAddress, contrastRatio, createIntentColors, createTheme, dateRangePresets, en, focusField, formatBusinessNumber, formatKoreanAmount, formatKoreanDate, formatPhoneNumber, hasAllRequiredAgreements, isValidBusinessNumber, kakaoPostcodeProvider, parseISODate, presetRange, strongInputBorders, themeClass, toISODate, useMessages, usePortalProps, useTableSelection, useTheme, useToast, vars };
-export type { AccordionItemProps, AccordionProps, AddressInputProps, AddressProvider, AddressSearchResult, AddressValue, AgreementGroupProps, AgreementItem, AlertColor, AlertProps, AmountInputProps, AvatarProps, BadgeProps, BestowMessages, BestowTheme, BreadcrumbItemData, BreadcrumbProps, BusinessNumberInputProps, ButtonProps, CalendarProps, CardProps, CardSectionProps, CheckboxProps, ComboboxOption, ComboboxProps, DatePickerProps, DateRange, DateRangePickerProps, DateRangePreset, DeepPartial, DescriptionListItem, DescriptionListProps, DividerProps, DrawerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, ErrorSummaryItem, ErrorSummaryProps, FileRejection, FileRejectionReason, FileUploadProps, IconButtonProps, InputProps, IntentName, LinkProps, LocaleProviderProps, Messages, ModalProps, NumberInputProps, PaginationItemType, PaginationProps, PhoneNumberInputProps, PopoverProps, ProgressProps, RadioGroupProps, RadioOption, SegmentedControlOption, SegmentedControlProps, SelectOption, SelectProps, SkeletonProps, SkipLinkProps, SliderProps, SpinnerProps, StackProps, StepperProps, StepperStep, SwitchProps, TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableRowProps, TableSize, TableSkeletonProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextFieldProps, TextareaProps, ThemeInput, ThemeName, ThemeOverrides, ThemeProviderProps, ThemeTokens, ToastColor, ToastContextValue, ToastOptions, ToastProviderProps, TooltipProps, TypographyProps, TypographyVariant, VerificationCodeInputProps, VisuallyHiddenProps };
+export { Accordion, AccordionItem, AddressInput, AgreementGroup, Alert, AmountInput, Avatar, Badge, Breadcrumb, BusinessNumberInput, Button, Calendar, Card, CardBody, CardFooter, CardHeader, Checkbox, Combobox, DatePicker, DateRangePicker, DescriptionList, Divider, Drawer, DrawerClose, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorSummary, FileUpload, IconButton, Input, Link, LocaleProvider, Modal, ModalClose, NativeSelect, NumberInput, Pagination, PhoneNumberInput, Popover, PopoverClose, Progress, RadioGroup, SegmentedControl, Select, Skeleton, SkipLink, Slider, Spinner, Stack, Stepper, Switch, Table, TableBody, TableCell, TableEmpty, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, ThemeProvider, ToastProvider, Tooltip, Typography, VerificationCodeInput, VisuallyHidden, contrastRatio, createIntentColors, createTheme, dateRangePresets, en, focusField, hasAllRequiredAgreements, kakaoPostcodeProvider, parseISODate, presetRange, strongInputBorders, themeClass, toISODate, useMessages, usePortalProps, useTableSelection, useTheme, useToast, vars };
+export type { AccordionItemProps, AccordionProps, AddressInputProps, AddressProvider, AddressSearchResult, AddressValue, AgreementGroupProps, AgreementItem, AlertColor, AlertProps, AmountInputProps, AvatarProps, BadgeProps, BestowMessages, BestowTheme, BreadcrumbItemData, BreadcrumbProps, BusinessNumberInputProps, ButtonProps, CalendarProps, CardProps, CardSectionProps, CheckboxProps, ComboboxOption, ComboboxProps, DatePickerProps, DateRange, DateRangePickerProps, DateRangePreset, DeepPartial, DescriptionListItem, DescriptionListProps, DividerProps, DrawerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, ErrorSummaryItem, ErrorSummaryProps, FileRejection, FileRejectionReason, FileUploadProps, IconButtonProps, InputProps, IntentName, LinkProps, LocaleProviderProps, Messages, ModalProps, NativeSelectOption, NativeSelectProps, NumberInputProps, PaginationItemType, PaginationProps, PhoneNumberInputProps, PopoverProps, ProgressProps, RadioGroupProps, RadioOption, SegmentedControlOption, SegmentedControlProps, SelectOption, SelectProps, SkeletonProps, SkipLinkProps, SliderProps, SpinnerProps, StackProps, StepperProps, StepperStep, SwitchProps, TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableRowProps, TableSize, TableSkeletonProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextFieldProps, TextareaProps, ThemeInput, ThemeName, ThemeOverrides, ThemeProviderProps, ThemeTokens, ToastColor, ToastContextValue, ToastOptions, ToastProviderProps, TooltipProps, TypographyProps, TypographyVariant, VerificationCodeInputProps, VisuallyHiddenProps };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as _bestow_ui_tokens from '@bestow-ui/tokens';
 import { space } from '@bestow-ui/tokens';
 import * as react from 'react';
-import { ReactNode, HTMLAttributes, ElementType, CSSProperties, ComponentPropsWithoutRef, InputHTMLAttributes, ButtonHTMLAttributes, AnchorHTMLAttributes, ReactElement, OlHTMLAttributes, TdHTMLAttributes, ThHTMLAttributes, ChangeEvent, TextareaHTMLAttributes } from 'react';
+import { ReactNode, HTMLAttributes, ElementType, CSSProperties, ComponentPropsWithoutRef, InputHTMLAttributes, ButtonHTMLAttributes, AnchorHTMLAttributes, ReactElement, SelectHTMLAttributes, OlHTMLAttributes, TdHTMLAttributes, ThHTMLAttributes, ChangeEvent, TextareaHTMLAttributes } from 'react';
+export { composeExtraAddress, formatBusinessNumber, formatKoreanAmount, formatKoreanDate, formatPhoneNumber, isValidBusinessNumber } from '@bestow-ui/korean-utils';
 import * as RadixAccordion from '@radix-ui/react-accordion';
 import * as Dialog from '@radix-ui/react-dialog';
 import * as RadixMenu from '@radix-ui/react-dropdown-menu';
@@ -85,12 +86,14 @@ type Widen<T> = {
  * 그래서 넣지 않으면 화면이 그대로이고, 기존 토큰(border.default 등)을 덮어쓴 사용자 설정도 계속 따른다(하위 영역의 CSS 덮어쓰기 포함).
  * - `color.border.input`·`inputHover` (1.x 추가): 입력 칸(Input·Select·Combobox·Textarea·인증번호 칸 등) 테두리. 기본은 border.default·border.strong.
  *   흰 배경과 1.3:1 인 기본 테두리를 3:1 이상으로 올리려면 `strongInputBorders` 를 쓴다(2.0 에서 기본값이 될 예정).
+ * - `color.border.control` (1.x 추가): Checkbox·Radio 테두리, 꺼진 Switch 트랙, Stepper 의 예정 단계. 기본은 border.strong(라이트 2.07:1).
  */
 declare const optionalTokens: {
     color: {
         border: {
             input: string;
             inputHover: string;
+            control: string;
         };
     };
 };
@@ -100,6 +103,7 @@ declare const vars: {
         border: {
             input: `var(--${string})`;
             inputHover: `var(--${string})`;
+            control: `var(--${string})`;
             default: `var(--${string})`;
             strong: `var(--${string})`;
             focus: `var(--${string})`;
@@ -272,9 +276,9 @@ type IntentName = 'primary' | 'neutral' | 'danger' | 'success' | 'warning';
 declare function createIntentColors(intent: IntentName, color: string): ThemeInput;
 
 /**
- * 입력 칸 테두리를 배경과 3:1 이상으로 올리는 테마 입력 (WCAG 1.4.11 비텍스트 대비).
- * 기본 테두리(border.default)는 흰 배경과 1.3:1 이라 칸의 경계가 잘 보이지 않는다 — 2.0 에서 기본값이 될 예정.
- * hover 는 테두리보다 더 진하게(다크는 더 밝게) 바뀐다.
+ * 입력 칸·체크 컨트롤 테두리를 배경과 3:1 이상으로 올리는 테마 입력 (WCAG 1.4.11 비텍스트 대비) — 2.0 에서 기본값이 될 예정.
+ * - 입력 칸(border.input): 기본 border.default 는 흰 배경과 1.3:1. hover 는 테두리보다 더 진하게(다크는 더 밝게).
+ * - Checkbox·Radio 테두리, 꺼진 Switch, Stepper 예정 단계(border.control): 기본 border.strong 은 라이트 흰 배경과 2.07:1.
  *
  * @example
  * <ThemeProvider overrides={createTheme(strongInputBorders)}>…</ThemeProvider>
@@ -416,40 +420,10 @@ declare function useMessages(): Messages;
  */
 declare const en: BestowMessages;
 
-/**
- * 숫자만 있는 전화번호에 하이픈을 넣는다. 입력 중인 값도 자연스럽게 나눈다.
- * @example formatPhoneNumber('01012345678') // '010-1234-5678'
- * @example formatPhoneNumber('021234567')   // '02-123-4567'
- * @example formatPhoneNumber('15881234')    // '1588-1234'
- */
-declare function formatPhoneNumber(input: string): string;
-/**
- * 사업자등록번호(10자리)에 하이픈을 넣는다.
- * @example formatBusinessNumber('1234567890') // '123-45-67890'
- */
-declare function formatBusinessNumber(input: string): string;
-/**
- * 사업자등록번호 검증 공식(가중치 1,3,7,1,3,7,1,3,5)으로 확인한다. 실제로 등록된 번호인지는 국세청 조회가 필요하다.
- * @example isValidBusinessNumber('124-81-00998') // true
- */
-declare function isValidBusinessNumber(input: string): boolean;
-/**
- * 금액을 만·억·조 단위로 읽기 쉽게 쓴다.
- * @example formatKoreanAmount(125000)     // '12만 5,000원'
- * @example formatKoreanAmount(150000000)  // '1억 5,000만원'
- * @example formatKoreanAmount(0)          // '0원'
- */
-declare function formatKoreanAmount(amount: number, unit?: string): string;
-
 /** Date → 'YYYY-MM-DD' (로컬 기준) */
 declare function toISODate(date: Date): string;
 /** 'YYYY-MM-DD' → Date (로컬 자정). 형식이 틀리거나 없는 날짜(2월 30일 등)면 null */
 declare function parseISODate(value: string | null | undefined): Date | null;
-/**
- * 한국어 날짜. 스크린리더용 날짜 이름 등에 쓴다.
- * @example formatKoreanDate(new Date(2026, 9, 15)) // '2026년 10월 15일 목요일'
- */
-declare function formatKoreanDate(date: Date, withWeekday?: boolean): string;
 
 /** 주소 검색 결과 */
 interface AddressSearchResult {
@@ -465,18 +439,7 @@ interface AddressSearchResult {
  * 정리 함수를 돌려주면 검색 창이 닫힐 때 부른다. 다른 주소 서비스(행정안전부 도로명주소 API 등)로 바꿔 끼울 수 있다.
  */
 type AddressProvider = (container: HTMLElement, onSelect: (result: AddressSearchResult) => void) => void | (() => void) | Promise<void | (() => void)>;
-interface KakaoPostcodeData {
-    zonecode: string;
-    userSelectedType: 'R' | 'J';
-    roadAddress: string;
-    jibunAddress: string;
-    autoJibunAddress?: string;
-    bname: string;
-    buildingName: string;
-    apartment: 'Y' | 'N';
-}
-/** 카카오 가이드의 방식으로 도로명 주소의 참고 항목(법정동, 공동주택 건물명)을 만든다 */
-declare function composeExtraAddress(data: Pick<KakaoPostcodeData, 'userSelectedType' | 'bname' | 'buildingName' | 'apartment'>): string;
+
 /**
  * 기본 공급자: 카카오(다음) 우편번호 서비스. 처음 쓸 때 스크립트를 불러오므로 코어 번들 크기에 영향이 없다.
  * 사용 조건은 서비스 가이드를 따른다.
@@ -1639,6 +1602,37 @@ interface SegmentedControlProps {
  */
 declare const SegmentedControl: react.ForwardRefExoticComponent<SegmentedControlProps & react.RefAttributes<HTMLDivElement>>;
 
+interface NativeSelectOption {
+    value: string;
+    /** `<option>` 은 글자만 담을 수 있어 문자열 */
+    label: string;
+    disabled?: boolean;
+}
+interface NativeSelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size' | 'multiple'> {
+    /** 선택지 목록. 없으면 children 의 `<option>`·`<optgroup>` 을 그대로 쓴다 */
+    options?: NativeSelectOption[];
+    /** 값이 바뀔 때 새 값으로 호출된다 (Select 와 같은 이름). 네이티브 onChange 도 함께 쓸 수 있다 */
+    onValueChange?: (value: string) => void;
+    /** 선택 전 표시할 문구 — 값이 '' 인 고를 수 없는 첫 항목으로 들어간다 */
+    placeholder?: string;
+    /** 위에 표시할 레이블 */
+    label?: ReactNode;
+    /** 아래에 표시할 도움말. error 일 때는 에러 메시지로 표시된다 */
+    helperText?: ReactNode;
+    /** 에러 상태 */
+    error?: boolean;
+    /** 크기 */
+    size?: 'sm' | 'md' | 'lg';
+    /** 부모 너비를 꽉 채운다 */
+    fullWidth?: boolean;
+}
+/**
+ * 브라우저 기본 `<select>` 에 Select 와 같은 모양을 입힌 것. Radix 가 없어 가볍고(폼 세트 번들이 크게 준다),
+ * 모바일에서는 운영체제의 선택 화면이 열린다. `register(...)` 를 그대로 펼칠 수 있다.
+ * 목록 모양을 꾸미거나 항목에 아이콘을 넣어야 하면 Select 를 쓴다.
+ */
+declare const NativeSelect: react.ForwardRefExoticComponent<NativeSelectProps & react.RefAttributes<HTMLSelectElement>>;
+
 interface SelectOption {
     value: string;
     label: ReactNode;
@@ -1795,6 +1789,10 @@ interface SwitchProps {
     /** 바깥 래퍼 className */
     className?: string;
 }
+/**
+ * 켜고 끄는 스위치. `<button role="switch">` 로 그리고, form 안에서는 숨긴 checkbox 로 값 제출·required 검증·reset 을 처리한다
+ * (1.5 까지 쓰던 Radix Switch 와 같은 동작 — 번들을 줄이려고 직접 구현).
+ */
 declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLButtonElement>>;
 
 type TableSize = 'sm' | 'md';
@@ -2050,5 +2048,5 @@ interface VerificationCodeInputProps {
  */
 declare const VerificationCodeInput: react.ForwardRefExoticComponent<VerificationCodeInputProps & react.RefAttributes<HTMLInputElement>>;
 
-export { Accordion, AccordionItem, AddressInput, AgreementGroup, Alert, AmountInput, Avatar, Badge, Breadcrumb, BusinessNumberInput, Button, Calendar, Card, CardBody, CardFooter, CardHeader, Checkbox, Combobox, DatePicker, DateRangePicker, DescriptionList, Divider, Drawer, DrawerClose, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorSummary, FileUpload, IconButton, Input, Link, LocaleProvider, Modal, ModalClose, NumberInput, Pagination, PhoneNumberInput, Popover, PopoverClose, Progress, RadioGroup, SegmentedControl, Select, Skeleton, SkipLink, Slider, Spinner, Stack, Stepper, Switch, Table, TableBody, TableCell, TableEmpty, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, ThemeProvider, ToastProvider, Tooltip, Typography, VerificationCodeInput, VisuallyHidden, composeExtraAddress, contrastRatio, createIntentColors, createTheme, dateRangePresets, en, focusField, formatBusinessNumber, formatKoreanAmount, formatKoreanDate, formatPhoneNumber, hasAllRequiredAgreements, isValidBusinessNumber, kakaoPostcodeProvider, parseISODate, presetRange, strongInputBorders, themeClass, toISODate, useMessages, usePortalProps, useTableSelection, useTheme, useToast, vars };
-export type { AccordionItemProps, AccordionProps, AddressInputProps, AddressProvider, AddressSearchResult, AddressValue, AgreementGroupProps, AgreementItem, AlertColor, AlertProps, AmountInputProps, AvatarProps, BadgeProps, BestowMessages, BestowTheme, BreadcrumbItemData, BreadcrumbProps, BusinessNumberInputProps, ButtonProps, CalendarProps, CardProps, CardSectionProps, CheckboxProps, ComboboxOption, ComboboxProps, DatePickerProps, DateRange, DateRangePickerProps, DateRangePreset, DeepPartial, DescriptionListItem, DescriptionListProps, DividerProps, DrawerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, ErrorSummaryItem, ErrorSummaryProps, FileRejection, FileRejectionReason, FileUploadProps, IconButtonProps, InputProps, IntentName, LinkProps, LocaleProviderProps, Messages, ModalProps, NumberInputProps, PaginationItemType, PaginationProps, PhoneNumberInputProps, PopoverProps, ProgressProps, RadioGroupProps, RadioOption, SegmentedControlOption, SegmentedControlProps, SelectOption, SelectProps, SkeletonProps, SkipLinkProps, SliderProps, SpinnerProps, StackProps, StepperProps, StepperStep, SwitchProps, TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableRowProps, TableSize, TableSkeletonProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextFieldProps, TextareaProps, ThemeInput, ThemeName, ThemeOverrides, ThemeProviderProps, ThemeTokens, ToastColor, ToastContextValue, ToastOptions, ToastProviderProps, TooltipProps, TypographyProps, TypographyVariant, VerificationCodeInputProps, VisuallyHiddenProps };
+export { Accordion, AccordionItem, AddressInput, AgreementGroup, Alert, AmountInput, Avatar, Badge, Breadcrumb, BusinessNumberInput, Button, Calendar, Card, CardBody, CardFooter, CardHeader, Checkbox, Combobox, DatePicker, DateRangePicker, DescriptionList, Divider, Drawer, DrawerClose, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ErrorSummary, FileUpload, IconButton, Input, Link, LocaleProvider, Modal, ModalClose, NativeSelect, NumberInput, Pagination, PhoneNumberInput, Popover, PopoverClose, Progress, RadioGroup, SegmentedControl, Select, Skeleton, SkipLink, Slider, Spinner, Stack, Stepper, Switch, Table, TableBody, TableCell, TableEmpty, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, ThemeProvider, ToastProvider, Tooltip, Typography, VerificationCodeInput, VisuallyHidden, contrastRatio, createIntentColors, createTheme, dateRangePresets, en, focusField, hasAllRequiredAgreements, kakaoPostcodeProvider, parseISODate, presetRange, strongInputBorders, themeClass, toISODate, useMessages, usePortalProps, useTableSelection, useTheme, useToast, vars };
+export type { AccordionItemProps, AccordionProps, AddressInputProps, AddressProvider, AddressSearchResult, AddressValue, AgreementGroupProps, AgreementItem, AlertColor, AlertProps, AmountInputProps, AvatarProps, BadgeProps, BestowMessages, BestowTheme, BreadcrumbItemData, BreadcrumbProps, BusinessNumberInputProps, ButtonProps, CalendarProps, CardProps, CardSectionProps, CheckboxProps, ComboboxOption, ComboboxProps, DatePickerProps, DateRange, DateRangePickerProps, DateRangePreset, DeepPartial, DescriptionListItem, DescriptionListProps, DividerProps, DrawerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuRadioGroupProps, DropdownMenuRadioItemProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, ErrorSummaryItem, ErrorSummaryProps, FileRejection, FileRejectionReason, FileUploadProps, IconButtonProps, InputProps, IntentName, LinkProps, LocaleProviderProps, Messages, ModalProps, NativeSelectOption, NativeSelectProps, NumberInputProps, PaginationItemType, PaginationProps, PhoneNumberInputProps, PopoverProps, ProgressProps, RadioGroupProps, RadioOption, SegmentedControlOption, SegmentedControlProps, SelectOption, SelectProps, SkeletonProps, SkipLinkProps, SliderProps, SpinnerProps, StackProps, StepperProps, StepperStep, SwitchProps, TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableRowProps, TableSize, TableSkeletonProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextFieldProps, TextareaProps, ThemeInput, ThemeName, ThemeOverrides, ThemeProviderProps, ThemeTokens, ToastColor, ToastContextValue, ToastOptions, ToastProviderProps, TooltipProps, TypographyProps, TypographyVariant, VerificationCodeInputProps, VisuallyHiddenProps };

package/dist/shared.js

@@ -5,11 +5,6 @@ import {
   cx,
   dateRangePresets,
   focusField,
-  formatBusinessNumber,
-  formatKoreanAmount,
-  formatKoreanDate,
-  formatPhoneNumber,
-  isValidBusinessNumber,
   kakaoPostcodeProvider,
   parseISODate,
   presetRange,
@@ -17,7 +12,7 @@ import {
   toISODate,
   vars,
   visuallyHidden
-} from "./chunk-TIFI6ZQU.js";
+} from "./chunk-NKLDAXUR.js";
 
 // src/theme/color.ts
 import { darkColors, lightColors, palette } from "@bestow-ui/tokens";
@@ -159,9 +154,11 @@ function createIntentColors(intent, color) {
 // src/theme/presets.ts
 var strongInputBorders = /* @__PURE__ */ Object.freeze({
   // 라이트: gray600 / gray700 — 흰 배경 5.18:1, bg.subtle(gray50) 4.91:1
-  light: { color: { border: { input: "#666e76", inputHover: "#495057" } } },
+  // 체크 컨트롤: gray600 — 흰 배경 5.18:1
+  light: { color: { border: { input: "#666e76", inputHover: "#495057", control: "#666e76" } } },
   // 다크: gray500 / gray300 — gray600 은 bg.subtle(gray900) 위에서 2.98:1 이라 한 단계 밝게. bg.default 8.57:1, bg.subtle 7.43:1
-  dark: { color: { border: { input: "#adb5bd", inputHover: "#dee2e6" } } }
+  // 체크 컨트롤: gray500 — 다크 기본값(border.strong)과 같다(이미 8.57:1)
+  dark: { color: { border: { input: "#adb5bd", inputHover: "#dee2e6", control: "#adb5bd" } } }
 });
 
 // src/i18n/en.ts
@@ -254,6 +251,15 @@ var en = {
   dateIncomplete: "Enter the date as YYYY-MM-DD."
 };
 
+// src/shared.ts
+import {
+  formatBusinessNumber,
+  formatKoreanAmount,
+  formatKoreanDate,
+  formatPhoneNumber,
+  isValidBusinessNumber
+} from "@bestow-ui/korean-utils";
+
 // src/components/AgreementGroup/agreements.ts
 function hasAllRequiredAgreements(items, value2) {
   return items.every((item2) => !item2.required || value2.includes(item2.value));