"use client"; import { type ChangeEvent, type ComponentPropsWithRef, type ReactNode } from "react"; import { cx } from "../../utils"; import { FoxRadioIcon } from "../fox-radio-icon"; export type FoxRadioSize = "lg" | "md"; /** * 네이티브 ``가 받는 것을 그대로 넘겨받는다 — name·value·checked· * defaultChecked·disabled·required·form 등. 의미가 겹치는 것만 걷어내고 아래에서 다시 정의한다. */ type NativeRadioProps = Omit< ComponentPropsWithRef<"input">, "type" | "size" | "className" | "children" | "hidden" | "onChange" >; export interface FoxRadioProps extends NativeRadioProps { size?: FoxRadioSize; label: ReactNode; /** 라벨 아래 보조 설명. 넘기지 않으면 영역을 렌더링하지 않는다. */ description?: ReactNode; /** * 이 칸이 선택될 때 부른다. 값이 첫 인자다 — 네이티브 `onChange`를 `Omit`으로 걷어내고 * 그 자리를 대신한다(`FoxInput`과 같은 방식). */ onChange?: (value: string, event: ChangeEvent) => void; /** * 글자를 눈에서만 감춘다 — 표의 선택 열처럼 네모(동그라미)만 필요한 자리에 쓴다. * DOM에는 남으므로 스크린리더는 그대로 읽는다. `description`도 함께 감춰진다. */ hideLabel?: boolean; /** 참이면 렌더하지 않는다(DOM에 남지 않는다). */ hidden?: boolean; /** 배치 조정용. */ className?: string; } const SIZE_CLASS: Record = { lg: "fox-radio--lg", md: "fox-radio--md", }; /** * @fox 라디오 버튼 한 칸. 상태를 갖지 않는다 — 선택 여부는 네이티브 * ``가 소유한다. * * `name`이 같은 라디오끼리는 브라우저가 그룹으로 묶어 화살표 이동·단일 선택·폼 전송을 * 처리한다. 그래서 별도 group 컴포넌트를 두지 않는다. * * 루트가 `