"use client";

import { FoxInput, FoxInputState, FoxSelect, FoxSelectItem, FoxSelectOption, FoxSelectOptionItem } from "@/@fox/core/components";
import { useState, type CSSProperties, type ReactNode } from "react";
import { FoxButton } from "../core/components/fox-button";
import { FoxButtonGroup } from "../core/components/fox-button-group";
import { FoxButtonPanel } from "../core/components/fox-button-panel";
import { FoxIconButton } from "../core/components/fox-icon-button";
import { FoxLinkButton } from "../core/components/fox-link-button";
import { FoxAddress, type FoxAddressSearchResult, type FoxAddressValue } from "../core/components/fox-address";
import { FoxCertified } from "../core/components/fox-certified";
import { FoxCheckIcon } from "../core/components/fox-check-icon";
import { FoxCheckbox } from "../core/components/fox-checkbox";
import { FoxCheckboxGroup } from "../core/components/fox-checkbox-group";
import { FoxChip, type FoxChipItem } from "../core/components/fox-chip";
import { FoxChipArea } from "../core/components/fox-chip-area";
import { FoxSelectText } from "../core/components/fox-select-text";
import { FoxSegmentedControl } from "../core/components/fox-segmented-control";
import { FoxSegmentedControlItem } from "../core/components/fox-segmented-control-item";
import { FoxConditionalOption } from "../core/components/fox-conditional-option";
import { FoxEmail } from "../core/components/fox-email";
import { FoxFormLabel } from "../core/components/fox-form-label";
import { FoxFileUpload, type FoxFileItem } from "../core/components/fox-file-upload";
import { FoxPhoneNumber, type FoxPhoneNumberState } from "../core/components/fox-phone-number";
import { FoxTextArea, type FoxTextAreaState } from "../core/components/fox-text-area";
import { FoxTextButton } from "../core/components/fox-text-button";
import { FoxRadio } from "../core/components/fox-radio";
import { FoxRadioGroup } from "../core/components/fox-radio-group";
import { FoxRadioIcon } from "../core/components/fox-radio-icon";
import { FoxTag } from "../core/components/fox-tag";
import { FoxTagList } from "../core/components/fox-tag-list";
import { FoxToggleQuantity } from "../core/components/fox-toggle-quantity";
import { FoxToggleSwitch } from "../core/components/fox-toggle-switch";
import styles from "./dev-test.module.scss";

export interface ComponentExample {
  /** 해시 링크에 쓰이는 kebab-case 식별자. */
  id: string;
  name: string;
  description?: string;
  /** 눈으로 비교해야 하는 조합을 빠짐없이 넣는다 — 예제가 곧 회귀 확인 수단이다. */
  variants: { label: string; node: ReactNode }[];
}

// 자리 확인용 도형. `currentColor`로 그려야 계열별 색이 입혀진다. style은 FoxSelect
// 힌트 아이콘처럼 크기를 줄여 써야 하는 자리에 쓴다.
function DemoIcon({ style }: { style?: CSSProperties } = {}) {
  return (
    <svg
      viewBox="0 0 16 16"
      fill="none"
      stroke="currentColor"
      strokeWidth="2"
      aria-hidden="true"
      style={style}
    >
      <path d="M6 3l5 5-5 5" />
    </svg>
  );
}

function DemoStar() {
  return (
    <svg viewBox="0 0 16 16" fill="currentColor" aria-hidden="true">
      <path d="M8 1.6l1.9 4 4.4.6-3.2 3 .8 4.3L8 11.5l-3.9 2 .8-4.3-3.2-3 4.4-.6z" />
    </svg>
  );
}

// FoxChip select 계열의 앞 아이콘 자리를 확인하기 위한 달력 도형(시안이 그 자리에 달력을
// 쓴다). `currentColor`로 그려야 상태별 글자 색을 따라간다.
function DemoCalendar() {
  return (
    <svg viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" aria-hidden="true">
      <rect x="2" y="3" width="12" height="11" rx="1.5" />
      <path d="M2 6.5h12M5.5 1.5v3M10.5 1.5v3" />
    </svg>
  );
}

const CHIP_PERIOD_OPTIONS: FoxChipItem[] = [
  { value: "7d", label: "최근 7일" },
  { value: "1m", label: "최근 1개월" },
  { value: "3m", label: "최근 3개월" },
  { value: "custom", label: "직접 입력" },
];

const SELECT_TEXT_MONTHS: FoxSelectItem[] = [
  { value: "2026-06", label: "2026년 6월" },
  { value: "2026-07", label: "2026년 7월" },
  { value: "2026-08", label: "2026년 8월" },
];

const SELECT_TEXT_SORTS: FoxSelectItem[] = [
  { value: "latest", label: "최신순" },
  { value: "oldest", label: "오래된순" },
  { value: "amount", label: "금액 높은순" },
];

// overlay 계열은 어두운 반투명 배경이라 밝은 바탕 위에서는 대비를 볼 수 없다.
function OnPhoto({ children }: { children: ReactNode }) {
  return (
    <span
      style={{
        display: "inline-flex",
        gap: "0.8rem",
        padding: "0.8rem",
        borderRadius: "0.8rem",
        backgroundImage: "url(https://picsum.photos/seed/picsum/200/300)",
        backgroundSize: "cover",
      }}
    >
      {children}
    </span>
  );
}

// 입력 예제는 폭이 있어야 시안(360px)처럼 보인다.
function InputStage({ children, wide = false }: { children: ReactNode; wide?: boolean }) {
  return <div className={wide ? styles.demoFieldWide : styles.demoField}>{children}</div>;
}

// 지우기 버튼과 자동 상태 판정을 실제로 눌러 보려면 예제가 값을 들고 있어야 한다.
function InputLiveDemo() {
  const [text, setText] = useState("지우기를 눌러보세요");
  return (
    <>
      <InputStage>
        <FoxInput
          size="md"
          label="자동 상태"
          placeholder="입력하면 글자가 진해집니다"
          message="포커스하면 도움말이 파랗게 바뀝니다"
          value={text}
          onChange={setText}
          clearable
        />
      </InputStage>
      <InputStage>
        <FoxInput
          size="md"
          label="오류 (invalid)"
          placeholder="내용을 입력하세요."
          message="필수 항목입니다"
          invalid
        />
      </InputStage>
    </>
  );
}

// 카운터가 실제로 올라가는 걸 보려면 예제가 값을 들고 있어야 한다.
function TextAreaLiveDemo() {
  const [text, setText] = useState("입력하면 아래 숫자가 따라 올라갑니다.");
  return (
    <>
      <InputStage>
        <FoxTextArea
          label="자동 상태 · 카운터"
          placeholder="내용을 입력하세요."
          message="포커스하면 도움말이 파랗게 바뀝니다"
          value={text}
          onChange={setText}
          maxLength={100}
          counter
        />
      </InputStage>
      <InputStage>
        <FoxTextArea
          label="오류 (invalid)"
          placeholder="내용을 입력하세요."
          message="100자를 넘길 수 없습니다"
          defaultValue={"x".repeat(100)}
          maxLength={100}
          counter
          invalid
        />
      </InputStage>
    </>
  );
}

const PHONE_PREFIXES = ["010", "011", "016", "017", "018", "019", "02", "031", "051"];

// 값이 숫자만 담긴 문자열 하나라는 걸 보려면 예제가 그 값을 그대로 보여줘야 한다.
function PhoneNumberLiveDemo() {
  const [unit, setUnit] = useState("01012345678");
  const [combine, setCombine] = useState("0212345678");
  return (
    <>
      <InputStage>
        <FoxPhoneNumber
          label={`unit — value="${unit}"`}
          prefixOptions={PHONE_PREFIXES}
          value={unit}
          onChange={setUnit}
          message="칸을 다 채우면 다음 칸으로 넘어갑니다"
        />
      </InputStage>
      <InputStage>
        <FoxPhoneNumber
          type="combine"
          label={`combine — value="${combine}"`}
          prefixOptions={PHONE_PREFIXES}
          value={combine}
          onChange={setCombine}
          message="앞자리 목록에 02가 있어 지역번호도 제자리에 갈립니다"
        />
      </InputStage>
    </>
  );
}

const EMAIL_DOMAINS = ["naver.com", "gmail.com", "daum.net", "kakao.com"];

// 값이 합쳐진 문자열 하나라는 걸 보려면 예제가 그 값을 그대로 보여줘야 한다.
function EmailLiveDemo() {
  const [email, setEmail] = useState("hong@naver.com");
  return (
    <InputStage wide>
      <FoxEmail
        label={`value="${email}"`}
        domainOptions={EMAIL_DOMAINS}
        value={email}
        onChange={setEmail}
        message="도메인을 고르면 옆 칸이 채워지고 잠깁니다. 직접입력을 고르면 풀립니다."
      />
    </InputStage>
  );
}

// 어떤 우편번호 서비스를 쓰든 이 모양으로 돌려주면 된다 — 여기서는 지연만 흉내낸다.
const FAKE_SEARCH_RESULT: FoxAddressSearchResult = {
  zipCode: "06236",
  address: "서울 강남구 테헤란로 152",
  detail: "강남파이낸스센터",
};

function AddressLiveDemo({ cancel = false }) {
  const [value, setValue] = useState<FoxAddressValue>({ zipCode: "", address: "", detail: "" });
  return (
    <>
      <InputStage>
        <FoxAddress
          label={cancel ? "검색을 취소하면 값이 그대로 남습니다" : "주소 검색을 눌러보세요"}
          value={value}
          onChange={setValue}
          onSearch={async () => {
            await new Promise((resolve) => setTimeout(resolve, 400));
            return cancel ? null : FAKE_SEARCH_RESULT;
          }}
        />
      </InputStage>
      <pre className={styles.code}>{JSON.stringify(value, null, 2)}</pre>
    </>
  );
}

// 목록은 업로드 결과에 따라 바뀌므로, 오류 줄까지 보려면 예제가 값을 들고 있어야 한다.
const SAMPLE_FILES: FoxFileItem[] = [
  { id: "a", name: "사업자등록증", meta: ".PDF (20KB)" },
  { id: "b", name: "아주 긴 파일 이름이라 가운데에서 말줄임되어야 하는 첨부물", meta: ".XLSX (1.2MB)" },
  {
    id: "c",
    name: "용량초과파일",
    meta: ".ZIP (32MB)",
    error: true,
    message: "등록 가능한 파일 용량을 초과하였습니다. 20MB 미만의 파일만 등록할 수 있습니다.",
  },
];

function FileUploadLiveDemo({ mode }: { mode: "default" | "area" }) {
  const [files, setFiles] = useState<FoxFileItem[]>(SAMPLE_FILES);
  return (
    <InputStage wide>
      <FoxFileUpload
        mode={mode}
        label={mode === "area" ? "끌어다 놓거나 버튼으로 고릅니다" : "고른 파일이 칸에 적힙니다"}
        files={files}
        onSelect={(picked) =>
          setFiles((prev) => [
            ...prev,
            ...picked.map((file) => ({ id: file.name, name: file.name, meta: `(${file.size}B)` })),
          ])
        }
        onRemove={(id) => setFiles((prev) => prev.filter((item) => item.id !== id))}
        description={mode === "default" ? "JPG, PNG 파일만 가능 (최대 5MB)" : undefined}
        multiple
      />
    </InputStage>
  );
}

// 이벤트가 실제로 도는 걸 보려면 예제가 결과를 적어 둬야 한다. 서버 대신 지연만 흉내낸다.
function CertifiedLiveDemo({ failSend = false, failVerify = false }) {
  const [log, setLog] = useState<string[]>([]);
  const write = (line: string) => setLog((prev) => [line, ...prev].slice(0, 5));
  const wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));

  return (
    <>
      <InputStage>
        <FoxCertified
          prefixOptions={PHONE_PREFIXES}
          defaultPhone="01012345678"
          expiresIn={180}
          onSend={async (phone) => {
            await wait(400);
            if (failSend) throw new Error("발송 한도를 넘었습니다");
            write(`보내기 요청 → ${phone}`);
          }}
          onVerify={async (_phone, code) => {
            await wait(400);
            if (failVerify || code !== "123456") throw new Error("번호가 맞지 않습니다");
          }}
          onSendSuccess={() => write("onSendSuccess")}
          onSendFail={(error) => write(`onSendFail — ${(error as Error).message}`)}
          onVerifySuccess={() => write("onVerifySuccess — 이제 전부 잠깁니다")}
          onVerifyFail={(error) => write(`onVerifyFail — ${(error as Error).message}`)}
          onExpire={() => write("onExpire")}
        />
      </InputStage>
      <pre className={styles.code}>{log.length ? log.join("\n") : "이벤트가 여기에 쌓입니다 (인증번호는 123456)"}</pre>
    </>
  );
}

// active는 호출부가 소유하므로 켜고 끄는 걸 보려면 예제가 상태를 들고 있어야 한다.
function IconToggleDemo() {
  const [on, setOn] = useState(false);
  return (
    <>
      <FoxIconButton
        size="md"
        type="default"
        label={on ? "즐겨찾기 해제" : "즐겨찾기"}
        icon={<DemoStar />}
        active={on}
        onAction={() => setOn((prev) => !prev)}
      />
      <FoxIconButton
        size="md"
        type="ghost"
        label={on ? "즐겨찾기 해제" : "즐겨찾기"}
        icon={<DemoStar />}
        active={on}
        onAction={() => setOn((prev) => !prev)}
      />
      <OnPhoto>
        <FoxIconButton
          size="md"
          type="overlay"
          label={on ? "즐겨찾기 해제" : "즐겨찾기"}
          icon={<DemoStar />}
          active={on}
          onAction={() => setOn((prev) => !prev)}
        />
      </OnPhoto>
    </>
  );
}

const SELECT_ITEMS: FoxSelectItem[] = [
  { value: "a", label: "옵션 A" },
  { value: "b", label: "옵션 B" },
  { value: "c", label: "옵션 C" },
];

// 옵션 아이콘은 별도 목록으로 둔다 — 위 목록에 섞으면 크기·상태 예제가 전부 같이 바뀌어
// 무엇을 보는 예제인지 흐려진다. 아이콘은 시안 미정이라 자리 확인용 도형이다.
const SELECT_ITEMS_RICH: FoxSelectItem[] = [
  { value: "a", label: "아이콘 있는 옵션", icon: <DemoIcon /> },
  { value: "b", label: "아이콘 없는 옵션" },
  { value: "c", label: "아주 긴 옵션 라벨 — 트리거에서는 말줄임으로 잘린다" },
];

// 태그 목록은 상태를 갖지 않으므로, 닫기 아이콘이 실제로 뭔가를 떼는지 보려면 예제가 목록을
// 들고 있어야 한다. 전부 떼면 다시 채울 방법이 없어 초기화 버튼을 같이 둔다.
const TAG_FILTERS = ["서울", "경기", "인천", "부산"];

function TagListLiveDemo() {
  const [filters, setFilters] = useState(TAG_FILTERS);

  return (
    <>
      <FoxTagList size="md" label="걸어 둔 조건">
        {filters.map((name) => (
          <FoxTag
            key={name}
            label={name}
            ariaLabel={`${name} 조건 제거`}
            onAction={() => setFilters((prev) => prev.filter((it) => it !== name))}
          />
        ))}
      </FoxTagList>
      <FoxButton
        size="xsm"
        label="초기화"
        onAction={() => setFilters(TAG_FILTERS)}
        disabled={filters.length === TAG_FILTERS.length}
      />
    </>
  );
}

/** 컴포넌트를 만들 때마다 항목 하나를 추가한다 — 다른 파일은 고치지 않는다. */
export const COMPONENT_EXAMPLES: ComponentExample[] = [
  {
    id: "fox-button",
    name: "FoxButton",
    description:
      "Figma 시안(btn, 컴포넌트 세트 106:1606)을 토큰만으로 옮겼습니다. 너비는 내용에 따라 가변이고 높이만 고정입니다. hover·pressed는 마우스를 올리거나 눌러 확인하세요. error 계열은 시안 미정이라 비어 있습니다.",
    variants: [
      {
        label: "계열 (type) — hover·pressed 확인 가능",
        node: (
          <>
            <FoxButton size="md" label="default" />
            <FoxButton size="md" type="primary" label="primary" />
            <FoxButton size="md" type="secondary" label="secondary" />
            <FoxButton size="md" type="error" label="error (시안 미정)" />
          </>
        ),
      },
      {
        label: "크기 (size)",
        node: (
          <>
            <FoxButton size="lg" label="lg" />
            <FoxButton size="md" label="md" />
            <FoxButton size="sm" label="sm" />
            <FoxButton size="xsm" label="xsm" />
          </>
        ),
      },
      {
        label: "아이콘",
        node: (
          <>
            <FoxButton size="md" label="leading" leadingIcon={<DemoIcon />} />
            <FoxButton size="md" label="trailing" trailingIcon={<DemoIcon />} />
            <FoxButton size="md" label="both" leadingIcon={<DemoIcon />} trailingIcon={<DemoIcon />} />
          </>
        ),
      },
      {
        label: "상태 — disabled / loading (둘 다 클릭이 막힌다)",
        node: (
          <>
            <FoxButton size="md" label="normal" onAction={() => undefined} />
            <FoxButton size="md" label="disabled" disabled />
            <FoxButton size="md" label="loading" loading />
            <FoxButton size="md" label="loading + icon" loading leadingIcon={<DemoIcon />} />
          </>
        ),
      },
      {
        label: "fullWidth",
        node: <FoxButton size="md" label="fullWidth" fullWidth />,
      },
      {
        label: "htmlType — 폼 안에서의 역할",
        node: (
          <>
            <FoxButton size="md" label="button (기본)" />
            <FoxButton size="md" label="submit" htmlType="submit" />
            <FoxButton size="md" label="reset" htmlType="reset" />
          </>
        ),
      },
      {
        label: "hidden — 렌더되지 않는다(아래는 비어 있는 것이 정상)",
        node: <FoxButton size="md" label="hidden" hidden />,
      },
    ],
  },
  {
    id: "fox-text-button",
    name: "FoxTextButton",
    description:
      "Figma 시안(btn-txt, 컴포넌트 세트 106:2468)을 토큰만으로 옮겼습니다. 높이를 고정하지 않고 패딩과 line-height로만 크기를 잡습니다. lg만 상하 패딩과 간격이 한 단계 넓습니다.",
    variants: [
      {
        label: "계열 (type) — primary는 굵기가 한 단계 더 굵다",
        node: (
          <>
            <FoxTextButton size="md" type="primary" label="primary" />
            <FoxTextButton size="md" type="secondary" label="secondary" />
          </>
        ),
      },
      {
        label: "크기 (size)",
        node: (
          <>
            <FoxTextButton size="lg" label="lg" />
            <FoxTextButton size="md" label="md" />
            <FoxTextButton size="sm" label="sm" />
            <FoxTextButton size="xsm" label="xsm" />
          </>
        ),
      },
      {
        label: "아이콘",
        node: (
          <>
            <FoxTextButton size="md" label="leading" leadingIcon={<DemoIcon />} />
            <FoxTextButton size="md" label="trailing" trailingIcon={<DemoIcon />} />
            <FoxTextButton
              size="md"
              label="both"
              leadingIcon={<DemoIcon />}
              trailingIcon={<DemoIcon />}
            />
          </>
        ),
      },
      {
        label: "상태 — disabled",
        node: (
          <>
            <FoxTextButton size="md" label="normal" onAction={() => undefined} />
            <FoxTextButton size="md" label="disabled" disabled />
            <FoxTextButton size="md" type="secondary" label="disabled (secondary)" disabled />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-link-button",
    name: "FoxLinkButton",
    description:
      "Figma 시안(btn-lnk, 컴포넌트 세트 107:207)을 토큰만으로 옮겼습니다. href를 주면 <a>, 없으면 <button>으로 렌더합니다. 방문 색은 브라우저가 실제 방문 기록으로만 켜므로 아래에서 링크를 한 번 눌러 돌아오면 색이 바뀝니다. tertiary만 평소에 밑줄이 없고 hover에서만 생깁니다.",
    variants: [
      {
        label: "계열 (type) — hover하면 tertiary에 밑줄이 생긴다",
        node: (
          <>
            <FoxLinkButton size="md" type="primary" label="primary" href="https://example.com" />
            <FoxLinkButton
              size="md"
              type="secondary"
              label="secondary"
              href="https://example.com"
            />
            <FoxLinkButton size="md" type="tertiary" label="tertiary" href="https://example.com" />
          </>
        ),
      },
      {
        label: "크기 (size)",
        node: (
          <>
            <FoxLinkButton size="lg" label="lg" href="https://example.com" />
            <FoxLinkButton size="md" label="md" href="https://example.com" />
            <FoxLinkButton size="sm" label="sm" href="https://example.com" />
          </>
        ),
      },
      {
        label: "아이콘 — 라벨 뒤에만 놓인다",
        node: (
          <>
            <FoxLinkButton size="lg" label="lg" href="https://example.com" icon={<DemoIcon />} />
            <FoxLinkButton size="md" label="md" href="https://example.com" icon={<DemoIcon />} />
            <FoxLinkButton size="sm" label="sm" href="https://example.com" icon={<DemoIcon />} />
          </>
        ),
      },
      {
        label: "href 없음 — <button>으로 렌더된다(방문 색이 켜지지 않는다)",
        node: (
          <>
            <FoxLinkButton size="md" label="onAction만" onAction={() => undefined} />
            <FoxLinkButton size="md" type="tertiary" label="tertiary" onAction={() => undefined} />
          </>
        ),
      },
      {
        label: "상태 — disabled (앵커는 href가 빠져 포커스·클릭이 함께 사라진다)",
        node: (
          <>
            <FoxLinkButton size="md" label="disabled (a)" href="https://example.com" disabled />
            <FoxLinkButton size="md" label="disabled (button)" disabled />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-icon-button",
    name: "FoxIconButton",
    description:
      "Figma 시안(btn-ico 400:6312 + btn-ico-toggle 404:5247)을 토큰만으로 옮겼습니다. 두 시안이 계열·크기·모양이 같고 켜짐 상태만 달라 한 컴포넌트로 합쳤습니다 — active를 주면 토글(aria-pressed)이 됩니다. ghost는 테두리가 없는 대신 아이콘이 한 단계 큽니다.",
    variants: [
      {
        label: "계열 (type) — overlay는 사진 위에서 봐야 한다",
        node: (
          <>
            <FoxIconButton size="md" type="default" label="default" icon={<DemoIcon />} />
            <FoxIconButton size="md" type="ghost" label="ghost" icon={<DemoIcon />} />
            <OnPhoto>
              <FoxIconButton size="md" type="overlay" label="overlay" icon={<DemoIcon />} />
            </OnPhoto>
          </>
        ),
      },
      {
        label: "크기 (size) — default 계열",
        node: (
          <>
            <FoxIconButton size="lg" label="lg" icon={<DemoIcon />} />
            <FoxIconButton size="md" label="md" icon={<DemoIcon />} />
            <FoxIconButton size="sm" label="sm" icon={<DemoIcon />} />
            <FoxIconButton size="xsm" label="xsm" icon={<DemoIcon />} />
          </>
        ),
      },
      {
        label: "크기 (size) — ghost는 같은 상자에 아이콘만 한 단계 크다",
        node: (
          <>
            <FoxIconButton size="lg" type="ghost" label="lg" icon={<DemoIcon />} />
            <FoxIconButton size="md" type="ghost" label="md" icon={<DemoIcon />} />
            <FoxIconButton size="sm" type="ghost" label="sm" icon={<DemoIcon />} />
            <FoxIconButton size="xsm" type="ghost" label="xsm" icon={<DemoIcon />} />
          </>
        ),
      },
      {
        label: "토글 — 눌러서 켜고 끈다 (active)",
        node: <IconToggleDemo />,
      },
      {
        label: "토글 켜짐 고정 — 계열별 색 비교",
        node: (
          <>
            <FoxIconButton size="md" type="default" label="on" icon={<DemoStar />} active />
            <FoxIconButton size="md" type="ghost" label="on" icon={<DemoStar />} active />
            <OnPhoto>
              <FoxIconButton size="md" type="overlay" label="on" icon={<DemoStar />} active />
            </OnPhoto>
          </>
        ),
      },
      {
        label: "상태 — disabled (켜짐보다 우선한다)",
        node: (
          <>
            <FoxIconButton size="md" label="disabled" icon={<DemoIcon />} disabled />
            <FoxIconButton size="md" type="ghost" label="disabled" icon={<DemoIcon />} disabled />
            <FoxIconButton
              size="md"
              type="overlay"
              label="disabled"
              icon={<DemoIcon />}
              disabled
            />
            <FoxIconButton
              size="md"
              label="active + disabled"
              icon={<DemoStar />}
              active
              disabled
            />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-button-group",
    name: "FoxButtonGroup",
    description:
      "간격만 Figma 시안(btn-group, 컴포넌트 세트 398:4854)에서 가져왔습니다 — 크기·방향과 무관하게 gap-2(4px) 하나뿐이라 그룹에는 크기별 스타일이 없습니다. 크기는 그룹이 단일 진실 공급원이라 자식이 저마다 다른 size를 줘도 그룹 값으로 통일됩니다. 세로일 때는 자식이 항상 폭을 채웁니다. 블록 레벨 flex라 부모 폭을 채웁니다.",
    variants: [
      {
        label: "가로 · 정렬 (align) — 회색 테두리가 그룹 영역",
        node: (
          <div className={styles.demoStack}>
            {(["start", "center", "end"] as const).map((align) => (
              <div key={align} className={styles.demoOutline}>
                <FoxButtonGroup size="md" align={align}>
                  <FoxButton size="md" label={align} />
                  <FoxButton size="md" type="primary" label="확인" />
                </FoxButtonGroup>
              </div>
            ))}
          </div>
        ),
      },
      {
        label: "크기 (size) — 자식이 준 size는 무시된다",
        node: (
          <div className={styles.demoStack}>
            {(["lg", "md", "sm", "xsm"] as const).map((size) => (
              <FoxButtonGroup key={size} size={size}>
                {/* 일부러 어긋난 size를 준다 — 전부 그룹 값으로 통일되어야 정상 */}
                <FoxButton size="lg" label={size} />
                <FoxButton size="xsm" type="primary" label="확인" />
                <FoxIconButton size="lg" label="공유" icon={<DemoIcon />} />
              </FoxButtonGroup>
            ))}
          </div>
        ),
      },
      {
        label: "세로 — 자식이 항상 폭을 채운다",
        node: (
          <div className={styles.demoOutline}>
            <FoxButtonGroup size="md" orientation="vertical">
              <FoxButton size="md" label="취소" />
              <FoxButton size="md" type="primary" label="확인" />
            </FoxButtonGroup>
          </div>
        ),
      },
      {
        label: "wrap — 폭이 모자라면 다음 줄로 넘어간다",
        node: (
          <div className={styles.demoStack}>
            <div className={styles.demoNarrow}>
              <FoxButtonGroup size="md" wrap>
                {["첫째", "둘째", "셋째", "넷째", "다섯째"].map((label) => (
                  <FoxButton key={label} size="md" label={label} />
                ))}
              </FoxButtonGroup>
            </div>
            <div className={styles.demoNarrow}>
              <FoxButtonGroup size="md">
                {["첫째", "둘째", "셋째", "넷째", "다섯째"].map((label) => (
                  <FoxButton key={label} size="md" label={label} />
                ))}
              </FoxButtonGroup>
            </div>
          </div>
        ),
      },
      {
        label: "버튼이 아닌 자식 — 호스트 요소는 건드리지 않는다",
        node: (
          <FoxButtonGroup size="sm" align="center">
            <FoxButton size="sm" label="이전" />
            <span className={styles.demoText}>1 / 10</span>
            <FoxButton size="sm" label="다음" />
          </FoxButtonGroup>
        ),
      },
      {
        label: "프래그먼트로 감싼 자식도 덮어쓴다",
        node: (
          <FoxButtonGroup size="xsm">
            <>
              <FoxButton size="lg" label="프래그먼트 안" />
              <FoxButton size="lg" type="primary" label="확인" />
            </>
            <FoxButton size="lg" label="프래그먼트 밖" />
          </FoxButtonGroup>
        ),
      },
    ],
  },
  {
    id: "fox-button-panel",
    name: "FoxButtonPanel",
    description:
      "Figma 시안(btn-page, 컴포넌트 세트 404:5121)을 옮겼습니다. 자식은 버튼 그룹이고, 여럿이면 양끝으로 벌어지고 하나면 가운데로 갑니다 — 자식 수는 CSS :only-child가 판단합니다. 패널 안에서는 그룹 간격이 gap-3(8px)으로 덮어써지고(단독으로 쓰면 gap-2), 버튼에 최소 폭 160px이 붙습니다. 창을 768px 아래로 줄이면 패널도 그룹도 세로로 쌓이고 버튼이 폭을 채웁니다.",
    variants: [
      {
        label: "그룹 둘 — 양끝 (시안 type=flow)",
        node: (
          <div className={styles.demoOutline}>
            <FoxButtonPanel offset={false}>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" label="취소" />
              </FoxButtonGroup>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" type="secondary" label="임시 저장" />
                <FoxButton size="lg" type="primary" label="다음" />
              </FoxButtonGroup>
            </FoxButtonPanel>
          </div>
        ),
      },
      {
        label: "그룹 하나 — 가운데 (시안 type=default)",
        node: (
          <div className={styles.demoOutline}>
            <FoxButtonPanel offset={false}>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" label="취소" />
                <FoxButton size="lg" type="primary" label="확인" />
              </FoxButtonGroup>
            </FoxButtonPanel>
          </div>
        ),
      },
      {
        label: "상단 여백 (offset) — 기본 켜짐, 80px",
        node: (
          <div className={styles.demoOutline}>
            <FoxButtonPanel>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" type="primary" label="확인" />
              </FoxButtonGroup>
            </FoxButtonPanel>
          </div>
        ),
      },
      {
        label: "그룹 셋 이상도 양끝 기준으로 벌어진다",
        node: (
          <div className={styles.demoOutline}>
            <FoxButtonPanel offset={false}>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" label="삭제" />
              </FoxButtonGroup>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" label="미리보기" />
              </FoxButtonGroup>
              <FoxButtonGroup size="lg">
                <FoxButton size="lg" type="primary" label="저장" />
              </FoxButtonGroup>
            </FoxButtonPanel>
          </div>
        ),
      },
    ],
  },
    {
    id: "fox-form-label",
    name: "FoxFormLabel",
    description:
      "Figma 시안(form-label 180:609) 입력 칸 위에 붙는 라벨입니다. 글자 자체는 form-field의 label 믹스인이 갖습니다 — 시안에서 이 컴포넌트와 입력 계열의 라벨이 같은 공용 조각이라 값이 갈라질 이유가 없습니다. 필수는 글자 뒤에 *, 선택은 (선택)을 붙이고 둘은 배타적이라 boolean 두 개가 아니라 값 하나로 받습니다. *는 aria-hidden이라 스크린리더가 읽지 않습니다 — 필수 여부는 입력 요소의 required가 알리는 것이고 별표는 그 눈에 보이는 짝이라, 둘 다 읽히면 같은 말이 두 번 나옵니다. 반대로 (선택)은 대신 알려 줄 속성이 없어 읽히게 둡니다.",
    variants: [
      {
        label: "기본 / 필수 / 선택",
        node: (
          <div className={styles.demoStack}>
            <FoxFormLabel>레이블</FoxFormLabel>
            <FoxFormLabel requirement="required">레이블</FoxFormLabel>
            <FoxFormLabel requirement="optional">레이블</FoxFormLabel>
          </div>
        ),
      },
      {
        label: "optionalText — 문구를 바꿀 수 있다",
        node: (
          <div className={styles.demoStack}>
            <FoxFormLabel requirement="optional">기본 문구</FoxFormLabel>
            <FoxFormLabel requirement="optional" optionalText="(입력하지 않아도 됩니다)">
              직접 지정
            </FoxFormLabel>
          </div>
        ),
      },
      {
        label: "htmlFor — 눌러 보면 아래 입력칸에 커서가 간다",
        node: (
          <InputStage>
            <div className={styles.demoStack}>
              <FoxFormLabel htmlFor="demo-form-label" requirement="required">
                라벨을 눌러 보세요
              </FoxFormLabel>
              <FoxInput size="md" id="demo-form-label" placeholder="여기로 커서가 옵니다" />
            </div>
          </InputStage>
        ),
      },
    ],
  },
  {
    id: "fox-input",
    name: "FoxInput",
    description:
      "Figma 시안(input, 컴포넌트 세트 135:621)을 옮겼습니다. 네이티브 <input>을 감싸므로 시안에 없는 password·email·number 등 모든 타입을 그대로 받습니다. 상태는 기본적으로 브라우저가 판단하고(포커스·값·비활성·aria-invalid), state를 주면 그 모양으로 고정됩니다. 라벨은 입력 크기와 무관하게 항상 같은 크기입니다.",
    variants: [
      {
        label: "직접 조작 — 입력·포커스·지우기",
        node: <InputLiveDemo />,
      },
      {
        label: "크기 (size) — 상자·글자·아이콘이 함께 줄고 라벨만 고정",
        node: (
          <>
            {(["lg", "md", "sm"] as const).map((size) => (
              <InputStage key={size}>
                <FoxInput size={size} label={`레이블 (${size})`} placeholder="내용을 입력하세요." />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "상태 고정 (state) — 시안 6종을 그대로 비교",
        node: (
          <>
            {(
              ["default", "focused", "completed", "error", "disabled", "view"] as FoxInputState[]
            ).map((state) => (
              <InputStage key={state}>
                <FoxInput
                  size="md"
                  state={state}
                  label={state}
                  placeholder="내용을 입력하세요."
                  message="힌트 메시지"
                />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "타입 — 시안에 없는 것도 네이티브 그대로 동작한다",
        node: (
          <>
            {(["text", "date", "password", "email", "number", "time"] as const).map((type) => (
              <InputStage key={type}>
                <FoxInput size="md" type={type} label={type} placeholder="내용을 입력하세요." />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "아이콘 · 헬퍼 아이콘 슬롯",
        node: (
          <>
            <InputStage>
              <FoxInput
                size="md"
                label="오른쪽 아이콘"
                placeholder="내용을 입력하세요."
                icon={<DemoIcon />}
              />
            </InputStage>
            <InputStage>
              <FoxInput
                size="md"
                label="헬퍼 아이콘"
                placeholder="내용을 입력하세요."
                message="아이콘은 호출부가 넣습니다"
                messageIcon={<DemoIcon />}
              />
            </InputStage>
          </>
        ),
      },
      {
        label: "비활성 · 읽기 전용 — 네이티브 속성으로 자동 판정",
        node: (
          <>
            <InputStage>
              <FoxInput size="md" label="disabled" defaultValue="수정할 수 없음" disabled />
            </InputStage>
            <InputStage>
              <FoxInput size="md" label="readOnly" defaultValue="읽기 전용" readOnly />
            </InputStage>
          </>
        ),
      },
      {
        label: "라벨·헬퍼 없이도 쓸 수 있다",
        node: (
          <InputStage>
            <FoxInput size="md" placeholder="내용을 입력하세요." />
          </InputStage>
        ),
      },
      
    ],
    
  },
  {
    id: "fox-select",
    name: "FoxSelect",
    description:
      "Figma 시안(select, 컴포넌트 세트 111:272). 네이티브 <select>가 아니라 트리거 버튼 + 리스트박스라 옵션 목록까지 시안대로 그립니다. 상태는 전부 ARIA 속성이 스타일 훅을 겸합니다 — 열림·오류·조회 전용·옵션 선택에 별도 클래스가 없습니다.",
    variants: [
      {
        label: "크기 (size)",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="lg" label="레이블" options={SELECT_ITEMS} hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS} hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="sm" label="레이블" options={SELECT_ITEMS} hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
          </div>
        ),
      },
      {
        label: "완료(값 선택됨)",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="lg" label="레이블" options={SELECT_ITEMS} defaultValue="a" hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS} defaultValue="a" hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="sm" label="레이블" options={SELECT_ITEMS} defaultValue="a" hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
          </div>
        ),
      },
      {
        label: "error",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="lg" label="레이블" options={SELECT_ITEMS} error hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS} error hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="sm" label="레이블" options={SELECT_ITEMS} error hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
          </div>
        ),
      },
      {
        label: "disabled",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="lg" label="레이블" options={SELECT_ITEMS} disabled hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS} disabled hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="sm" label="레이블" options={SELECT_ITEMS} disabled hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
          </div>
        ),
      },
      {
        label: "view (조회 전용)",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="lg" label="레이블" options={SELECT_ITEMS} defaultValue="a" readOnly hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS} defaultValue="a" readOnly hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
            <FoxSelect size="sm" label="레이블" options={SELECT_ITEMS} defaultValue="a" readOnly hint="힌트 메시지" hintIcon={<DemoIcon style={{ width: 12, height: 12 }} />} />
          </div>
        ),
      },
      {
        label: "옵션 아이콘(맨 뒤) · 긴 라벨 — 열어서 확인한다",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="md" label="레이블" options={SELECT_ITEMS_RICH} />
          </div>
        ),
      },
      {
        label: "라벨 없음 · 힌트 없음 — 해당 영역이 렌더되지 않는다",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="md" options={SELECT_ITEMS} />
            <FoxSelect size="md" label="라벨만" options={SELECT_ITEMS} />
          </div>
        ),
      },
      {
        label: "placeholder — 기본값은 “선택해주세요”",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="md" label="기본" options={SELECT_ITEMS} />
            <FoxSelect size="md" label="직접 지정" options={SELECT_ITEMS} placeholder="등급을 고르세요" />
          </div>
        ),
      },
      {
        label: "requirement — 라벨을 FoxFormLabel이 그린다",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="md" label="표시 없음" options={SELECT_ITEMS} />
            <FoxSelect size="md" label="필수" options={SELECT_ITEMS} requirement="required" />
            <FoxSelect size="md" label="선택" options={SELECT_ITEMS} requirement="optional" />
          </div>
        ),
      },
      {
        label:
          "selectionMode=\"multiple\" — 고른 라벨이 쉼표로 이어지고, 목록은 바깥을 눌러야 닫힙니다",
        node: (
          <div className={styles.demoFields}>
            <FoxSelect size="md" label="아무것도 안 고름" selectionMode="multiple" options={SELECT_ITEMS} />
            <FoxSelect
              size="md"
              label="여러 개 고름"
              selectionMode="multiple"
              options={SELECT_ITEMS}
              defaultValues={SELECT_ITEMS.slice(0, 2).map((option) => option.value)}
            />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-select-option",
    name: "FoxSelectOption",
    description:
      "Figma 시안(select, 컴포넌트 세트 732:5879) FoxSelect가 열렸을 때 뜨는 옵션 목록입니다. 셀렉트에서 떼어내 단독으로 올려두었습니다. 목록은 position: absolute라 위치 기준이 되는 조상이 필요합니다",
    variants: [
      {
        label: "목록",
        node: (
          <div className={styles.demoListboxStage}>
            <FoxSelectOption>
              <FoxSelectOptionItem label="셀렉트 옵션" />
              <FoxSelectOptionItem label="셀렉트 옵션" />
              <FoxSelectOptionItem label="셀렉트 옵션" />
              <FoxSelectOptionItem label="셀렉트 옵션" />
            </FoxSelectOption>
          </div>
        ),
      },
      {
        label: "스크롤 — 항목이 많으면 240px에서 스크롤된다 (⚠️ 높이 미확정)",
        node: (
          <div className={styles.demoListboxStage}>
            <FoxSelectOption>
              {Array.from({ length: 12 }, (_, i) => (
                <FoxSelectOptionItem key={i} label={`항목 ${i + 1}`} selected={i === 2} />
              ))}
            </FoxSelectOption>
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-select-option-item",
    name: "FoxSelectOptionItem",
    description:
      "Figma 시안(select, 컴포넌트 세트 251:396) 옵션 목록의 항목 하나입니다. 선택 여부는 aria-selected가 스타일 훅을 겸하고, 키보드로 이동 중인 항목만 네이티브 대응이 없어 --active 클래스를 씁니다. 항목은 포커스를 받지 않습니다 — 콤보박스는 포커스가 트리거에 남아야 aria-activedescendant가 성립하기 때문입니다. 눌림(pressed)은 마우스로 누르고 있는 동안 보입니다.",
    variants: [
      {
        label: "상태 — 기본 / 선택됨 / hover / pressed 클릭",
        node: (
          <div className={styles.demoListboxStage}>
            <FoxSelectOption>
              <FoxSelectOptionItem label="셀렉트 옵션" />
              <FoxSelectOptionItem label="셀렉트 옵션-selected" selected />
              <FoxSelectOptionItem label="셀렉트 옵션-hover" active />
              <FoxSelectOptionItem label="셀렉트 옵션-pressed (클릭으로 확인)" />
              <FoxSelectOptionItem label="셀렉트 옵션-danger" danger />
            </FoxSelectOption>
          </div>
        ),
      },
      {
        label: "아이콘 — 체크는 맨 앞(선택됐을 때만), 아이콘은 맨 뒤",
        node: (
          <div className={styles.demoListboxStage}>
            <FoxSelectOption>
              <FoxSelectOptionItem label="셀렉트 옵션" icon={<DemoIcon />} />
              <FoxSelectOptionItem label="셀렉트 옵션-selected" selected icon={<DemoIcon />} />
            </FoxSelectOption>
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-radio-icon",
    name: "FoxRadioIcon",
    description:
      "Figma 시안(radio-icon 107:551) 라디오의 동그란 표시만 담당합니다. SVG가 아니라 CSS로 그립니다 — 시안이 바깥 원과 안쪽 점을 별개 레이어로 두었고, 네 상태가 모양이 아니라 색만 다르기 때문입니다(테두리 두께는 전부 border-1). FoxRadio 안에서는 네이티브 input의 :checked·:disabled가 스타일 훅을 겸해서 클래스가 필요 없고, 아래처럼 단독으로 상태를 비교할 때만 모디파이어로 못박습니다.",
    variants: [
      {
        label: "lg — 기본 / 선택 / 비활성 / 선택+비활성",
        node: (
          <>
            <FoxRadioIcon size="lg" />
            <FoxRadioIcon size="lg" checked />
            <FoxRadioIcon size="lg" disabled />
            <FoxRadioIcon size="lg" checked disabled />
          </>
        ),
      },
      {
        label: "md — 기본 / 선택 / 비활성 / 선택+비활성",
        node: (
          <>
            <FoxRadioIcon size="md" />
            <FoxRadioIcon size="md" checked />
            <FoxRadioIcon size="md" disabled />
            <FoxRadioIcon size="md" checked disabled />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-radio",
    name: "FoxRadio",
    description:
      "Figma 시안(radio 180:278)  동그란 표시 + 라벨 + 부가설명을 묶은 라디오 한 칸입니다.",
    variants: [
      {
        label: "size-lg",
        node: (
          <div className={styles.demoStack}>
            <FoxRadio name="demo-plan" value="basic" label="라디오버튼" size="lg" description="부가적인 설명이 들어갑니다." />
            <FoxRadio name="demo-plan" value="pro" label="라디오버튼" size="lg" description="부가적인 설명이 들어갑니다." defaultChecked/>
            <FoxRadio name="demo-plan" value="team" label="라디오버튼" size="lg" description="부가적인 설명이 들어갑니다." disabled />
            <FoxRadio name="demo-plan" value="team" label="라디오버튼" size="lg" description="부가적인 설명이 들어갑니다." disabled defaultChecked />
          </div>
        ),
      },
      {
        label: "size-md",
        node: (
          <div className={styles.demoStack}>
            <FoxRadio name="demo-plan" value="basic" label="라디오버튼" size="md" description="부가적인 설명이 들어갑니다." />
            <FoxRadio name="demo-plan" value="pro" label="라디오버튼" size="md" description="부가적인 설명이 들어갑니다." defaultChecked/>
            <FoxRadio name="demo-plan" value="team" label="라디오버튼" size="md" description="부가적인 설명이 들어갑니다." disabled />
            <FoxRadio name="demo-plan" value="team" label="라디오버튼" size="md" description="부가적인 설명이 들어갑니다." disabled defaultChecked />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-radio-group",
    name: "FoxRadioGroup",
    description:
      "Figma 시안(radio-group 194:4327)라디오 여러 칸의 배치와 name·size 통일을 책임집니다. 어느 칸이 선택됐는지는 각 FoxRadio의 네이티브 input이 소유하므로 그룹은 상태를 갖지 않습니다. name은 그룹이 단일 진실 공급원이라 자식마다 적지 않아도 되고, 한 칸만 빼먹어 두 개가 선택되는 실수가 막힙니다. ⚠️ 시안의 변형 이름이 실제 동작과 반대라서(direction=row가 세로로 쌓습니다) 동작 기준으로 다시 이름 붙였습니다 — 시안 row가 vertical, 시안 col이 horizontal입니다.",
    variants: [
      {
        label: "vertical (기본) — 간격 gap-7, 왼쪽 끝 정렬",
        node: (
          <FoxRadioGroup name="vertical" label="vertical">
            <FoxRadio label="라디오버튼" defaultChecked />
            <FoxRadio  label="라디오버튼" />
          </FoxRadioGroup>
        ),
      },
      {
        label: "horizontal — 행 gap-7 / 열 gap-9, 폭이 모자라면 줄바꿈",
        node: (
          <FoxRadioGroup orientation="horizontal" name="horizontal" label="horizontal">
            <FoxRadio label="라디오버튼" defaultChecked />
            <FoxRadio label="라디오버튼" />
            <FoxRadio label="라디오버튼" />
          </FoxRadioGroup>
        ),
      },
      {
        label: "horizontal + 줄바꿈 — 다음 줄로 넘어간다",
        node: (
          <div className={styles.demoNarrow}>
            <FoxRadioGroup orientation="horizontal" name="rg-wrap" label="줄바꿈 확인">
              {["첫째", "둘째", "셋째", "넷째", "다섯째"].map((label, i) => (
                <FoxRadio key={label} value={label} label={label} defaultChecked={i === 0} />
              ))}
            </FoxRadioGroup>
          </div>
        ),
      },
      {
        label: "size — 자식이 준 값은 무시되고 그룹 값으로 통일된다",
        node: (
          <FoxRadioGroup orientation="horizontal" name="rg-md" size="md" label="md 크기">
            {/* 일부러 어긋난 size를 준다 — 둘 다 md로 나와야 정상 */}
            <FoxRadio value="a" label="첫째" size="lg" defaultChecked />
            <FoxRadio value="b" label="둘째" />
          </FoxRadioGroup>
        ),
      },
    ],
  },
    {
    id: "fox-conditional-option",
    name: "FoxConditionalOption",
    description:
      "Figma 시안(conditional-option 190:2163) 컨트롤 한 칸과 select가 합쳐 하나의 답을 이룹니다. control로 라디오·체크박스를 고릅니다(시안의 trigger — 이 패키지에서 trigger는 fox-select__trigger라는 다른 뜻으로 이미 쓰여 이름을 바꿨습니다). select는 이 칸이 골라지지 않아도 조작할 수 있고, 값을 고르면 라디오가 자동으로 켜집니다. 잠가 두면 그 자동 선택 자체가 불가능해지기 때문입니다(disabled는 클릭을 먹지 않습니다). 켜는 방법은 숨은 input을 실제로 클릭하는 것이라 형제 칸이 꺼지는 것과 change 이벤트가 브라우저 규칙 그대로 일어납니다. ⚠️ 시안의 변형 이름이 실제 동작과 반대라서(FoxRadioGroup과 같은 문제) 동작 기준으로 다시 이름 붙였습니다 — 시안 row가 vertical, 시안 col이 horizontal입니다.",
    variants: [
      {
        label: "vertical (기본) — select가 아래로 내려가고 왼쪽 끝에 붙는다",
        node: (
          <FoxConditionalOption
            name="co-v"
            value="other"
            label="다른 주소로 배송"
            description="주소를 고르면 이 항목이 자동으로 선택됩니다."
            options={SELECT_ITEMS}
            placeholder="주소를 고르세요"
          />
        ),
      },
      {
        label: "horizontal — select가 라디오 옆에 선다",
        node: (
          <FoxConditionalOption
            orientation="horizontal"
            name="co-h"
            value="other"
            label="다른 주소로 배송"
            options={SELECT_ITEMS}
            placeholder="주소를 고르세요"
          />
        ),
      },
      {
        label: "",
        node: (
          <FoxRadioGroup name="co-auto" label="배송지">
            <FoxRadio value="default" label="기본 배송지" defaultChecked />
            <FoxConditionalOption
              value="other"
              label="다른 주소로 배송"
              options={SELECT_ITEMS}
              placeholder="주소를 고르세요"
            />
          </FoxRadioGroup>
        ),
      },
      {
        label: "FoxRadioGroup 안 — name·size를 그룹이 넣어 준다(md로 통일된다)",
        node: (
          <FoxRadioGroup name="co-group" size="md" label="결제 수단">
            <FoxRadio value="card" label="카드" defaultChecked />
            <FoxConditionalOption
              value="bank"
              label="계좌 이체"
              description="은행을 고르면 이 항목이 선택됩니다."
              options={SELECT_ITEMS}
              placeholder="은행을 고르세요"
            />
          </FoxRadioGroup>
        ),
      },
      {
        label: "disabled — 컨트롤과 select가 함께 잠긴다",
        node: (
          <FoxConditionalOption
            name="co-off"
            value="other"
            label="다른 주소로 배송"
            description="선택할 수 없습니다."
            options={SELECT_ITEMS}
            placeholder="주소를 고르세요"
            disabled
          />
        ),
      },
      {
        label: "control=\"checkbox\" — 여러 개를 동시에 켤 수 있다",
        node: (
          <FoxCheckboxGroup name="co-cb" label="추가 옵션">
            <FoxCheckbox value="gift" label="선물 포장" />
            <FoxConditionalOption
              control="checkbox"
              value="card"
              label="카드 동봉"
              description="문구를 고르면 이 항목이 자동으로 켜집니다."
              options={SELECT_ITEMS}
              placeholder="문구를 고르세요"
            />
          </FoxCheckboxGroup>
        ),
      },
      {
        label: "control 비교 — 라디오는 하나만, 체크박스는 여럿",
        node: (
          <div className={styles.demoStack}>
            <FoxConditionalOption
              orientation="horizontal"
              name="co-cmp-r"
              value="a"
              label="radio (기본)"
              options={SELECT_ITEMS}
              placeholder="고르세요"
            />
            <FoxConditionalOption
              orientation="horizontal"
              control="checkbox"
              name="co-cmp-c"
              value="a"
              label="checkbox"
              options={SELECT_ITEMS}
              placeholder="고르세요"
            />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-text-area",
    name: "FoxTextArea",
    description:
      "Figma 시안(textarea 135:1655)을 옮겼습니다. 시안에 크기 축이 없어 상자는 하나뿐이고 높이는 rows가 정합니다(기본 5줄, 시안과 같음). 상태 판정은 FoxInput과 같은 방식입니다 — 기본은 브라우저가 판단하고 state를 주면 고정됩니다. 하단은 왼쪽 헬퍼와 오른쪽 글자수 카운터로 나뉘고, 오류일 때 현재 글자수가 빨개집니다.",
    variants: [
      {
        label: "직접 조작 — 입력·포커스·카운터",
        node: <TextAreaLiveDemo />,
      },
      {
        label: "상태 고정 (state) — 시안 6종을 그대로 비교",
        node: (
          <>
            {(
              ["default", "focused", "completed", "error", "disabled", "view"] as FoxTextAreaState[]
            ).map((state) => (
              <InputStage key={state}>
                <FoxTextArea
                  state={state}
                  label={state}
                  placeholder="내용을 입력하세요."
                  message="힌트 메시지"
                  defaultValue={""}
                  maxLength={100}
                  counter
                />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "줄 수 (rows)",
        node: (
          <>
            {[3, 5, 8].map((rows) => (
              <InputStage key={rows}>
                <FoxTextArea rows={rows} label={`rows=${rows}`} placeholder="내용을 입력하세요." />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "헬퍼·카운터는 따로 켠다",
        node: (
          <>
            <InputStage>
              <FoxTextArea label="헬퍼만" placeholder="내용을 입력하세요." message="힌트 메시지" />
            </InputStage>
            <InputStage>
              <FoxTextArea label="카운터만" placeholder="내용을 입력하세요." maxLength={100} counter />
            </InputStage>
            <InputStage>
              <FoxTextArea label="최대 없이 개수만" placeholder="내용을 입력하세요." counter />
            </InputStage>
            <InputStage>
              <FoxTextArea label="둘 다 없음" placeholder="내용을 입력하세요." />
            </InputStage>
          </>
        ),
      },
      {
        label: "비활성 · 읽기 전용 — 네이티브 속성으로 자동 판정",
        node: (
          <>
            <InputStage>
              <FoxTextArea label="disabled" defaultValue="수정할 수 없음" disabled />
            </InputStage>
            <InputStage>
              <FoxTextArea label="readOnly" defaultValue="읽기 전용" readOnly />
            </InputStage>
          </>
        ),
      },
    ],
  },
  {
    id: "fox-phone-number",
    name: "FoxPhoneNumber",
    description:
      "Figma 시안(form-phonenumber 391:3156)을 옮겼습니다. unit은 상자 셋을 하이픈으로 잇고 앞자리가 선택이며, combine은 상자 하나에 세 칸을 둡니다. 화면은 세 칸이지만 값은 숫자만 담긴 문자열 하나입니다 — 하이픈은 값에 들어가지 않습니다. 칸을 다 채우면 다음 칸으로 넘어가고, 빈 칸에서 지우면 앞칸으로 돌아갑니다.",
    variants: [
      {
        label: "직접 조작 — 값이 그대로 라벨에 보입니다",
        node: <PhoneNumberLiveDemo />,
      },
      {
        label: "모양 (type)",
        node: (
          <>
            <InputStage>
              <FoxPhoneNumber label="unit" prefixOptions={PHONE_PREFIXES} />
            </InputStage>
            <InputStage>
              <FoxPhoneNumber type="combine" label="combine" prefixOptions={PHONE_PREFIXES} />
            </InputStage>
          </>
        ),
      },
      {
        label: "상태 고정 (state) — combine 기준",
        node: (
          <>
            {(
              ["default", "focused", "completed", "error", "disabled", "view"] as FoxPhoneNumberState[]
            ).map((state) => (
              <InputStage key={state}>
                <FoxPhoneNumber
                  type="combine"
                  state={state}
                  label={state}
                  message="힌트 메시지"
                />
              </InputStage>
            ))}
          </>
        ),
      },
      {
        label: "자동 이동 끄기 (autoAdvance)",
        node: (
          <InputStage>
            <FoxPhoneNumber
              label="autoAdvance={false}"
              prefixOptions={PHONE_PREFIXES}
              autoAdvance={false}
              message="칸을 다 채워도 커서가 그대로 있습니다"
            />
          </InputStage>
        ),
      },
      {
        label: "비활성 · 읽기 전용",
        node: (
          <>
            <InputStage>
              <FoxPhoneNumber
                label="disabled"
                prefixOptions={PHONE_PREFIXES}
                defaultValue="01012345678"
                disabled
              />
            </InputStage>
            <InputStage>
              <FoxPhoneNumber
                type="combine"
                label="readOnly"
                prefixOptions={PHONE_PREFIXES}
                defaultValue="01012345678"
                readOnly
              />
            </InputStage>
          </>
        ),
      },
    ],
  },
  {
    id: "fox-certified",
    name: "FoxCertified",
    description:
      "Figma 시안(form-certified 190:2017)을 옮겼습니다. 전화번호는 FoxPhoneNumber(combine), 두 버튼은 FoxButton(secondary·primary)을 그대로 씁니다. 보내기·확인은 호출부가 Promise로 넘기고, resolve면 성공 reject면 실패입니다. 보내기가 성공해야 인증번호 칸과 확인 버튼이 열리고, 인증에 성공하면 전부 잠깁니다.",
    variants: [
      {
        label: "직접 조작 — 인증번호 123456이면 성공, 아니면 실패",
        node: <CertifiedLiveDemo />,
      },
      {
        label: "보내기가 실패하는 경우 — 칸이 열리지 않고 이벤트만 옵니다",
        node: <CertifiedLiveDemo failSend />,
      },
      {
        label: "타이머를 호출부가 넘길 때 (remainingSeconds)",
        node: (
          <InputStage>
            <FoxCertified
              prefixOptions={PHONE_PREFIXES}
              defaultPhone="01012345678"
              remainingSeconds={1456}
              onSend={async () => undefined}
              onVerify={async () => undefined}
            />
          </InputStage>
        ),
      },
      {
        label: "전체 잠금 (disabled)",
        node: (
          <InputStage>
            <FoxCertified
              prefixOptions={PHONE_PREFIXES}
              defaultPhone="01012345678"
              disabled
              onSend={async () => undefined}
              onVerify={async () => undefined}
            />
          </InputStage>
        ),
      },
    ],
  },
  {
    id: "fox-email",
    name: "FoxEmail",
    description:
      "Figma 시안(form-email 136:3092)을 옮겼습니다. 세 칸이 모두 input·select 인스턴스라 FoxInput·FoxSelect를 그대로 조합했습니다. 값은 아이디@도메인이 합쳐진 문자열 하나입니다. 도메인을 고르면 옆 칸에 그 값이 채워지고 읽기 전용이 되며, 직접입력을 고르면 풀립니다. 칸은 최소 240px을 지키며 남는 폭을 나눠 갖고, 좁아지면 줄이 넘어갑니다.",
    variants: [
      {
        label: "직접 조작 — 도메인을 바꿔보세요",
        node: <EmailLiveDemo />,
      },
      {
        label: "확인 버튼 — onVerify를 넘겼을 때만 생깁니다",
        node: (
          <>
            <InputStage wide>
              <FoxEmail
                label="onVerify 있음"
                domainOptions={EMAIL_DOMAINS}
                defaultValue="hong@naver.com"
                onVerify={async () => new Promise((resolve) => setTimeout(resolve, 400))}
              />
            </InputStage>
            <InputStage wide>
              <FoxEmail label="onVerify 없음" domainOptions={EMAIL_DOMAINS} />
            </InputStage>
          </>
        ),
      },
      {
        label: "좁은 곳에서는 줄이 넘어갑니다",
        node: (
          <InputStage>
            <FoxEmail domainOptions={EMAIL_DOMAINS} defaultValue="hong@naver.com" />
          </InputStage>
        ),
      },
      {
        label: "오류 · 비활성",
        node: (
          <>
            <InputStage wide>
              <FoxEmail
                label="invalid"
                domainOptions={EMAIL_DOMAINS}
                defaultValue="hong@naver.com"
                message="이미 쓰고 있는 주소입니다"
                invalid
              />
            </InputStage>
            <InputStage wide>
              <FoxEmail label="disabled" domainOptions={EMAIL_DOMAINS} defaultValue="hong@naver.com" disabled />
            </InputStage>
          </>
        ),
      },
    ],
  },
  {
    id: "fox-address",
    name: "FoxAddress",
    description:
      "Figma 시안(form-address 5346:5823)을 옮겼습니다. 세 상자가 모두 input 인스턴스라 FoxInput을 그대로 조합했습니다. 우편번호와 주소는 검색 결과로만 채워지는 읽기 전용이고 상세주소만 손으로 적습니다. 어떤 우편번호 서비스를 쓸지는 호출부가 정합니다 — onSearch에서 결과를 FoxAddressSearchResult 모양으로 돌려주면 되고, 취소는 null입니다.",
    variants: [
      {
        label: "직접 조작 — 검색하면 두 칸이 채워집니다",
        node: <AddressLiveDemo />,
      },
      {
        label: "검색을 취소하면(null) 값이 그대로 남습니다",
        node: <AddressLiveDemo cancel />,
      },
      {
        label: "오류 · 비활성",
        node: (
          <>
            <InputStage>
              <FoxAddress
                label="invalid"
                message="주소를 입력해 주세요"
                invalid
                onSearch={async () => null}
              />
            </InputStage>
            <InputStage>
              <FoxAddress
                label="disabled"
                defaultValue={{ zipCode: "06236", address: "서울 강남구 테헤란로 152", detail: "10층" }}
                disabled
                onSearch={async () => null}
              />
            </InputStage>
          </>
        ),
      },
    ],
  },
  {
    id: "fox-file-upload",
    name: "FoxFileUpload",
    description:
      "Figma 시안 다섯(file-upload 391:3677 · file-upload-area 392:5968 · file-upload-img 391:3732 · file-list 392:5938 · file-list-item 391:3509)을 한 컴포넌트로 옮겼습니다. 버튼·입력이 모두 기존 컴포넌트의 인스턴스라 FoxButton·FoxTextButton·FoxIconButton·FoxInput을 그대로 조합했습니다. 업로드는 하지 않고 고른 원본 File만 넘깁니다 — 목록은 files로 주면 제어, 안 주면 안에서 들고 있습니다. default·area는 목록을 붙일 수 있고 image는 목록이 없습니다.",
    variants: [
      {
        label: "default 모드 — 읽기 전용 칸 + 파일선택, 목록 지원",
        node: <FileUploadLiveDemo mode="default" />,
      },
      {
        label: "area 모드 — 끌어다 놓기가 항상 켜져 있고 목록을 지원합니다",
        node: <FileUploadLiveDemo mode="area" />,
      },
      {
        label: "image 모드 — 목록이 없고 썸네일 하나입니다",
        node: (
          <>
            <InputStage wide>
              <FoxFileUpload
                mode="image"
                label="비었을 때"
                accept="image/*"
                description="JPG, PNG 파일만 가능 (권장 사이즈: 1280x720px, 최대 5MB)"
              />
            </InputStage>
            <InputStage wide>
              <FoxFileUpload
                mode="image"
                label="채워졌을 때 — 가운데 버튼으로 지웁니다"
                accept="image/*"
                defaultFiles={[
                  { id: "p", name: "미리보기", previewUrl: "https://picsum.photos/seed/picsum/426/240" },
                ]}
                description="JPG, PNG 파일만 가능 (권장 사이즈: 1280x720px, 최대 5MB)"
              />
            </InputStage>
          </>
        ),
      },
      {
        label: "default 모드 · 파일 하나 (시안 upload=true) — 칸이 잠기고 버튼이 삭제로 바뀝니다",
        node: (
          <>
            <InputStage wide>
              <FoxFileUpload label="비었을 때" description="JPG, PNG 파일만 가능 (최대 5MB)" />
            </InputStage>
            <InputStage wide>
              <FoxFileUpload
                label="파일이 있을 때"
                defaultFiles={[{ id: "one", name: "파일명", meta: ".PDF (20KB)" }]}
                description="JPG, PNG 파일만 가능 (최대 5MB)"
              />
            </InputStage>
          </>
        ),
      },
      {
        label: "목록 없이 · 크기 바꾸기",
        node: (
          <>
            <InputStage wide>
              <FoxFileUpload label="showList={false}" defaultFiles={SAMPLE_FILES} showList={false} multiple />
            </InputStage>
            <InputStage wide>
              <FoxFileUpload label="inputWidth=440" inputWidth={440} />
            </InputStage>
            <InputStage wide>
              <FoxFileUpload
                mode="image"
                label="thumbnail 160×90"
                thumbnailWidth={160}
                thumbnailHeight={90}
              />
            </InputStage>
          </>
        ),
      },
      {
        label: "비활성",
        node: (
          <InputStage wide>
            <FoxFileUpload label="disabled" defaultFiles={SAMPLE_FILES} multiple disabled />
          </InputStage>
        ),
      },
    ],
  },  { 
    id: "fox-check-icon",
    name: "FoxCheckIcon",
    description:
      "Figma 시안(check-icon 108:234) 체크박스의 네모 표시만 담당합니다. 상자는 CSS로 그리고 안쪽 표시만 SVG입니다 — 상자는 테두리·배경·모서리로 끝나지만 체크는 임의의 path라 CSS로 그릴 수 없습니다(FoxRadioIcon은 안쪽이 원이라 전부 CSS였습니다). 선택과 부분선택은 상자 모양이 같고 안쪽 표시만 다릅니다. FoxCheckbox 안에서는 네이티브 input의 :checked·:indeterminate·:disabled가 스타일 훅을 겸해서 클래스가 필요 없고, 아래처럼 단독으로 상태를 비교할 때만 모디파이어로 못박습니다.",
    variants: [
      {
        label: "lg — 기본 / 선택 / 부분선택 / 비활성 / 선택+비활성 / 부분선택+비활성",
        node: (
          <>
            <FoxCheckIcon size="lg" />
            <FoxCheckIcon size="lg" checked />
            <FoxCheckIcon size="lg" indeterminate />
            <FoxCheckIcon size="lg" disabled />
            <FoxCheckIcon size="lg" checked disabled />
            <FoxCheckIcon size="lg" indeterminate disabled />
          </>
        ),
      },
      {
        label: "md — 기본 / 선택 / 부분선택 / 비활성 / 선택+비활성 / 부분선택+비활성",
        node: (
          <>
            <FoxCheckIcon size="md" />
            <FoxCheckIcon size="md" checked />
            <FoxCheckIcon size="md" indeterminate />
            <FoxCheckIcon size="md" disabled />
            <FoxCheckIcon size="md" checked disabled />
            <FoxCheckIcon size="md" indeterminate disabled />
          </>
        ),
      },
    ],
  },
  { 
    id: "fox-checkbox",
    name: "FoxCheckbox",
    description:
      "Figma 시안(checkbox 108:469) 네모 표시 + 라벨 + 부가설명을 묶은 체크박스 한 칸입니다. 루트가 <label>이라 라벨이나 설명을 눌러도 켜집니다. 라디오와 달리 name이 같아도 서로를 끄지 않아 여러 개를 동시에 고를 수 있고, 폼 전송 시 고른 것들이 함께 나갑니다. ⚠️ 부분선택은 HTML 속성이 아니라 DOM 프로퍼티라 마크업만으로는 켤 수 없습니다 — 컴포넌트가 대신 넣어 줍니다.",
    variants: [
      {
        label: "여러 개를 동시에 고를 수 있다 (같은 name이어도 서로 끄지 않는다)",
        node: (
          <div className={styles.demoStack}>
            <FoxCheckbox name="cb-terms" value="service" label="서비스 이용약관" defaultChecked />
            <FoxCheckbox name="cb-terms" value="privacy" label="개인정보 처리방침" defaultChecked />
            <FoxCheckbox name="cb-terms" value="marketing" label="마케팅 정보 수신" />
          </div>
        ),
      },
      {
        label: "부분선택 — 전체 동의처럼 자식 일부만 켜진 상태",
        node: (
          <div className={styles.demoStack}>
            <FoxCheckbox name="cb-ind" value="all" label="전체 동의" indeterminate />
            <FoxCheckbox name="cb-ind" value="a" label="필수 약관" defaultChecked />
            <FoxCheckbox name="cb-ind" value="b" label="선택 약관" />
          </div>
        ),
      },
      {
        label: "부가설명 — 여러 줄이어도 네모 표시는 첫 줄에 붙는다",
        node: (
          <div className={styles.demoStack}>
            <FoxCheckbox
              name="cb-desc"
              value="a"
              label="마케팅 정보 수신"
              description="이벤트·혜택 소식을 받아봅니다."
              defaultChecked
            />
            <FoxCheckbox
              name="cb-desc"
              value="b"
              label="야간 알림"
              description="밤 9시 이후에도 알림을 받습니다. 설명이 길어지면 이렇게 줄이 넘어가고, 네모 표시는 첫 줄에 붙어 있어야 정상입니다."
            />
          </div>
        ),
      },
      {
        label: "크기 (size)",
        node: (
          <div className={styles.demoStack}>
            <FoxCheckbox name="cb-lg" value="a" label="lg" description="부가설명" defaultChecked />
            <FoxCheckbox name="cb-md" value="a" label="md" description="부가설명" size="md" defaultChecked />
          </div>
        ),
      },
      {
        label: "비활성 — 글자색도 흐려지고 클릭이 막힌다",
        node: (
          <div className={styles.demoStack}>
            <FoxCheckbox name="cb-off" value="a" label="비활성" description="선택할 수 없습니다." disabled />
            <FoxCheckbox name="cb-off2" value="a" label="비활성 + 선택됨" description="체크가 남고 색만 흐려집니다." disabled defaultChecked />
            <FoxCheckbox name="cb-off3" value="a" label="비활성 + 부분선택" description="대시가 남고 색만 흐려집니다." disabled indeterminate />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-checkbox-group",
    name: "FoxCheckboxGroup",
    description:
      "Figma 시안(checkbox-group 194:4000) 체크박스 여러 칸의 배치와 name·size 통일을 책임집니다. 켜짐 여부는 각 FoxCheckbox의 네이티브 input이 소유하므로 그룹은 상태를 갖지 않습니다. role이 radiogroup이 아니라 group입니다 — 체크박스는 서로를 끄지 않아 하나만 고르는 묶음이 아니고, 화살표 이동으로 옮겨 다니지도 않아 각 칸이 독립적으로 Tab을 받습니다. 배치 값은 FoxRadioGroup과 같습니다.",
    variants: [
      {
        label: "vertical (기본) — 간격 gap-7, 왼쪽 끝 정렬",
        node: (
          <FoxCheckboxGroup name="cbg-v" label="약관 동의">
            <FoxCheckbox value="service" label="서비스 이용약관" defaultChecked />
            <FoxCheckbox value="privacy" label="개인정보 처리방침" />
            <FoxCheckbox value="marketing" label="마케팅 정보 수신" />
          </FoxCheckboxGroup>
        ),
      },
      {
        label: "horizontal — 행 gap-7 / 열 gap-9, 폭이 모자라면 줄바꿈",
        node: (
          <FoxCheckboxGroup orientation="horizontal" name="cbg-h" label="관심 분야">
            <FoxCheckbox value="dev" label="개발" defaultChecked />
            <FoxCheckbox value="design" label="디자인" />
            <FoxCheckbox value="pm" label="기획" />
          </FoxCheckboxGroup>
        ),
      },
      {
        label: "horizontal + 줄바꿈 — 좁은 무대에서 다음 줄로 넘어간다",
        node: (
          <div className={styles.demoNarrow}>
            <FoxCheckboxGroup orientation="horizontal" name="cbg-wrap" label="줄바꿈 확인">
              {["첫째", "둘째", "셋째", "넷째", "다섯째"].map((label, i) => (
                <FoxCheckbox key={label} value={label} label={label} defaultChecked={i === 0} />
              ))}
            </FoxCheckboxGroup>
          </div>
        ),
      },
      {
        label: "size — 자식이 준 값은 무시되고 그룹 값으로 통일된다",
        node: (
          <FoxCheckboxGroup orientation="horizontal" name="cbg-md" size="md" label="md 크기">
            {/* 일부러 어긋난 size를 준다 — 둘 다 md로 나와야 정상 */}
            <FoxCheckbox value="a" label="첫째" size="lg" defaultChecked />
            <FoxCheckbox value="b" label="둘째" />
          </FoxCheckboxGroup>
        ),
      },
    ],
  },
  {
    id: "fox-tag",
    name: "FoxTag",
    description:
      "Figma 시안(tag 132:195) 아이콘만 누르는 게 아니라 조각 전체가 버튼입니다 — 시안이 hover 배경을 태그 전체에 줍니다. type이 아이콘의 종류와 자리를 정합니다: sorting은 글자 뒤에 닫기 아이콘(걸어 둔 조건을 뗄 때), button은 글자 앞에 택 아이콘입니다. 기본 배경은 action-secondary, 즉 투명이라 아래 무대 색이 그대로 보이는 것이 정상입니다 — hover(연한 파랑)·pressed(진한 파랑)는 마우스를 올리고 눌러서 확인해야 합니다. button만 hover·pressed에서 글자에 밑줄이 붙습니다.",
    variants: [
      {
        label: "sorting (기본) — 크기 lg / md / sm",
        node: (
          <>
            <FoxTag size="lg" label="태그" ariaLabel="태그 조건 제거" />
            <FoxTag size="md" label="태그" ariaLabel="태그 조건 제거" />
            <FoxTag size="sm" label="태그" ariaLabel="태그 조건 제거" />
          </>
        ),
      },
      {
        label: "button — 크기 lg / md / sm (마우스를 올리면 글자에 밑줄)",
        node: (
          <>
            <FoxTag type="button" size="lg" label="태그" />
            <FoxTag type="button" size="md" label="태그" />
            <FoxTag type="button" size="sm" label="태그" />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-tag-list",
    name: "FoxTagList",
    description:
      "Figma 시안(tag-list 190:2565) 태그 여러 개의 배치와 size·type 통일을 책임집니다. 무엇이 걸려 있는지는 호출부가 소유하므로 목록은 상태를 갖지 않습니다. 방향 수식어가 없습니다 — 태그는 가로로 흐르다 폭이 모자라면 다음 줄로 넘어가는 것이 유일한 배치입니다. role이 radiogroup이 아니라 group입니다 — 하나만 고르는 묶음이 아니고 각 태그가 독립적으로 Tab을 받는 버튼입니다. 태그 사이 간격은 없습니다 — 각 태그의 좌우 padding이 여백 역할을 하고, 배경이 투명해서 서로 닿아도 경계가 겹쳐 보이지 않습니다.",
    variants: [
      {
        label: "닫기를 누르면 실제로 떨어진다 — 목록은 호출부가 소유한다",
        node: <TagListLiveDemo />,
      },
      {
        label: "size — 자식이 준 값은 무시되고 묶음 값으로 통일된다",
        node: (
          <FoxTagList size="sm" label="sm 크기">
            {/* 일부러 어긋난 size를 준다 — 셋 다 sm으로 나와야 정상 */}
            <FoxTag label="서울" size="lg" />
            <FoxTag label="경기" size="md" />
            <FoxTag label="인천" />
          </FoxTagList>
        ),
      },
      {
        label: "type — 묶음이 계열도 통일한다",
        node: (
          <FoxTagList type="button" size="md" label="button 계열">
            <FoxTag label="공지사항" />
            <FoxTag label="1:1 문의" />
            <FoxTag label="FAQ" />
          </FoxTagList>
        ),
      },
      {
        label: "줄바꿈 — 좁은 무대에서 다음 줄로 넘어간다",
        node: (
          <div className={styles.demoNarrow}>
            <FoxTagList size="md" label="줄바꿈 확인">
              {["서울", "경기", "인천", "부산", "대구", "광주"].map((name) => (
                <FoxTag key={name} label={name} ariaLabel={`${name} 조건 제거`} />
              ))}
            </FoxTagList>
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-toggle-switch",
    name: "FoxToggleSwitch",
    description:
      "Figma 시안(toggle-switch 134:442) 토글 스위치 입니다. 마크업은 체크박스와 같고 role=\"switch\"만 얹어 선택됨이 아니라 켜짐/꺼짐으로 읽히게 합니다 — 폼에도 체크박스처럼 참여합니다. 루트가 <label>이라 글자를 눌러도 바뀌고, 켜짐 여부는 네이티브 input이 소유하므로 아래 예제는 전부 실제로 눌러서 확인할 수 있습니다. 동그라미는 꺼짐이면 왼쪽·켜짐이면 오른쪽이고, 표시 색은 언제나 트랙 배경과 같은 값이라 흰 동그라미에 트랙 색으로 글리프를 파낸 모양이 됩니다. 크기는 트랙·동그라미·표시·글자를 함께 바꿉니다 — lg는 트랙 40×24, md는 트랙 32×20입니다.",
    variants: [
      {
        label: "꺼짐 / 켜짐 — 눌러서 바꿔 보세요",
        node: (
          <div className={styles.demoStack}>
            <FoxToggleSwitch name="ts-off" label="알림 받기" />
            <FoxToggleSwitch name="ts-on" label="알림 받기" defaultChecked />
          </div>
        ),
      },
      {
        label: "크기 — lg 트랙 40×24 / md 트랙 32×20, 꺼짐·켜짐 모두",
        node: (
          <div className={styles.demoStack}>
            <FoxToggleSwitch name="ts-lg-off" label="lg 꺼짐" />
            <FoxToggleSwitch name="ts-lg" label="lg 켜짐" defaultChecked />
            <FoxToggleSwitch name="ts-md-off" size="md" label="md 꺼짐" />
            <FoxToggleSwitch name="ts-md" size="md" label="md 켜짐" defaultChecked />
          </div>
        ),
      },
      {
        label: "label 없음 — 글자 영역을 렌더하지 않는다 (읽어 줄 이름은 aria-label로 준다)",
        node: (
          <>
            <FoxToggleSwitch name="ts-bare-off" aria-label="알림 받기" />
            <FoxToggleSwitch name="ts-bare-on" aria-label="알림 받기" defaultChecked />
          </>
        ),
      },
      {
        label: "비활성 — 꺼짐 / 켜짐",
        node: (
          <div className={styles.demoStack}>
            <FoxToggleSwitch name="ts-off-dis" label="비활성 + 꺼짐" disabled />
            <FoxToggleSwitch name="ts-on-dis" label="비활성 + 켜짐" disabled defaultChecked />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-chip",
    name: "FoxChip",
    description:
      "Figma 시안(chip 264:424) 켜짐 여부를 갖는 작은 조각입니다 — type은 아이콘의 유무와 누를 때 벌어지는 일만 정하고, 상태별 모양(기본·hover·켜짐·비활성)은 세 계열이 똑같습니다. check는 켜졌을 때만 앞에 체크가 붙고, select는 뒤 화살표가 늘 있으며 앞 아이콘은 icon을 넘긴 때만 나옵니다. action은 아이콘이 없습니다. select는 selectionMode로 단일·다중을 고릅니다 — 단일은 하나 고르면 그 자리에서 반영되고 닫히지만, 다중은 열린 채로 남고 바깥을 눌러야 닫힙니다(닫기가 곧 확정이 아니라 체크할 때마다 이미 반영됩니다). 열리는 목록은 FoxSelectOption이 아니라 전용 FoxChipSelectOption이고, 항목이 단일이면 라디오·다중이면 체크박스입니다. 그래서 칩은 콤보박스가 아니라 목록을 여닫는 버튼(aria-expanded)일 뿐이고, 항목 사이 이동은 네이티브 입력이 알아서 합니다. 아래 예제는 전부 실제로 눌러서 확인할 수 있습니다 — hover(파란 테두리 + 연한 파랑 배경)는 마우스를 올려야 보이고, 켜짐 위에서는 hover가 걸리지 않습니다(시안에 없어 임의로 만들지 않았습니다).",
    variants: [
      {
        label: "check — 눌러서 켜고 끕니다. 켜지면 앞에 체크가 붙고 남색으로 채워집니다",
        node: (
          <>
            <FoxChip label="레이블" />
            <FoxChip label="레이블" defaultChecked />
          </>
        ),
      },
      {
        label: "select — 눌러 목록을 엽니다. 고르면 켜짐이 되고 글자가 고른 값으로 바뀝니다",
        node: (
          <>
            <FoxChip type="select" label="기간" icon={<DemoCalendar />} options={CHIP_PERIOD_OPTIONS} />
            <FoxChip type="select" label="기간" options={CHIP_PERIOD_OPTIONS} />
            <FoxChip
              type="select"
              label="기간"
              icon={<DemoCalendar />}
              options={CHIP_PERIOD_OPTIONS}
              defaultValue="1m"
            />
          </>
        ),
      },
      {
        label:
          "select · 다중 선택 — 켜고 꺼도 목록이 열린 채로 남고, 바깥을 눌러야 닫힙니다 (칩 글자는 그대로)",
        node: (
          <>
            <FoxChip
              type="select"
              selectionMode="multiple"
              label="기간"
              icon={<DemoCalendar />}
              options={CHIP_PERIOD_OPTIONS}
            />
            <FoxChip
              type="select"
              selectionMode="multiple"
              label="기간"
              icon={<DemoCalendar />}
              options={CHIP_PERIOD_OPTIONS}
              defaultValues={["7d", "3m"]}
            />
          </>
        ),
      },
      {
        label: "action — 아이콘 없이 켜고 끕니다 (켜져도 체크가 붙지 않습니다)",
        node: (
          <>
            <FoxChip type="action" label="레이블" />
            <FoxChip type="action" label="레이블" defaultChecked />
          </>
        ),
      },
      {
        label: "크기 — lg 높이 40 / md 높이 28. 아이콘도 20 / 16으로 함께 바뀝니다",
        node: (
          <>
            <FoxChip size="lg" label="레이블" defaultChecked />
            <FoxChip size="md" label="레이블" defaultChecked />
            <FoxChip size="lg" type="select" label="기간" icon={<DemoCalendar />} options={CHIP_PERIOD_OPTIONS} />
            <FoxChip size="md" type="select" label="기간" icon={<DemoCalendar />} options={CHIP_PERIOD_OPTIONS} />
          </>
        ),
      },
      {
        label: "비활성 — 꺼짐 / 켜짐. 켜짐 여부와 무관하게 한 벌입니다(시안 확인 완료)",
        node: (
          <>
            <FoxChip label="레이블" disabled />
            <FoxChip label="레이블" disabled defaultChecked />
            <FoxChip type="select" label="기간" icon={<DemoCalendar />} options={CHIP_PERIOD_OPTIONS} disabled />
            <FoxChip type="action" label="레이블" disabled defaultChecked />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-chip-area",
    name: "FoxChipArea",
    description:
      "Figma 시안(chip-area 264:1671) 칩 여러 개의 배치와 size 통일만 책임집니다. 시안이 주는 규칙이 inline-flex · align-items: center · gap 4px 세 줄뿐이라 스타일 파일도 그만큼입니다. FoxTagList와 달리 type은 덮어쓰지 않습니다 — 한 줄에 계열이 섞이는 것이 칩에서는 정상이기 때문입니다(기간 select 옆에 action 칩들). role이 radiogroup이 아니라 group입니다 — 하나만 고르는 묶음이 아니고 각 칩이 독립적으로 Tab을 받는 버튼입니다. 줄바꿈이 없습니다(flex-wrap 없음) — 시안이 한 줄만 그리므로 폭이 모자라면 넘칩니다.",
    variants: [
      {
        label: "기본 — 칩 사이 간격 4px, 계열이 섞여도 됩니다",
        node: (
          <FoxChipArea size="md" label="거래 구분">
            <FoxChip type="select" label="기간" icon={<DemoCalendar />} options={CHIP_PERIOD_OPTIONS} />
            <FoxChip type="action" label="전체" defaultChecked />
            <FoxChip type="action" label="입금" />
            <FoxChip type="action" label="출금" />
            <FoxChip type="action" label="환불" />
          </FoxChipArea>
        ),
      },
      {
        label: "size — 자식이 준 값은 무시되고 묶음 값으로 통일된다",
        node: (
          <FoxChipArea size="md" label="md 크기">
            {/* 일부러 어긋난 size를 준다 — 셋 다 md로 나와야 정상 */}
            <FoxChip label="레이블" size="lg" />
            <FoxChip label="레이블" size="lg" defaultChecked />
            <FoxChip label="레이블" />
          </FoxChipArea>
        ),
      },
      {
        label: "size를 넘기지 않으면 — 자식이 각자 정한 값이 그대로 남는다",
        node: (
          <FoxChipArea label="크기 섞임">
            <FoxChip label="lg" size="lg" />
            <FoxChip label="md" size="md" />
          </FoxChipArea>
        ),
      },
      {
        label: "프래그먼트로 감싼 자식에도 통일이 걸린다",
        node: (
          <FoxChipArea size="lg" label="프래그먼트">
            <>
              <FoxChip label="레이블" size="md" />
              <FoxChip label="레이블" size="md" defaultChecked />
            </>
          </FoxChipArea>
        ),
      },
    ],
  },
  {
    id: "fox-select-text",
    name: "FoxSelectText",
    description:
      "Figma 시안(select-txt 112:508) 글자만 있는 셀렉트입니다. FoxSelect와 같은 콤보박스이고 열리는 목록도 같은 FoxSelectOption을 쓰지만, 폼 한 칸이 아닙니다 — 라벨·힌트·에러·필수 표시가 없고 테두리도 고정 높이도 없습니다. 배경 계열도 다릅니다: FoxSelect는 중립(흰 바탕 + 테두리)인데 이쪽은 강조 계열이라 기본이 투명이고 hover·pressed에서만 연한 파랑이 깔립니다 — 그래서 아래 예제의 기본 상태는 배경이 없는 것이 정상이고, 마우스를 올리고 눌러야 색이 보입니다. 크기가 글자 계열까지 바꾸는 것도 여기뿐입니다: lg는 heading/md(제목용 20px bold), md·sm은 label/*-strong(본문용 medium)입니다. '지금 무엇을 보고 있는지'를 글자로 보여 주면서 그 자리에서 바꾸게 하는 자리에 씁니다.",
    variants: [
      {
        label: "크기 — lg(제목 20px bold) / md(15px medium) / sm(13px medium)",
        node: (
          <>
            <FoxSelectText size="lg" ariaLabel="조회 기간" options={SELECT_TEXT_MONTHS} defaultValue="2026-08" />
            <FoxSelectText size="md" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} defaultValue="latest" />
            <FoxSelectText size="sm" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} defaultValue="latest" />
          </>
        ),
      },
      {
        label: "아무것도 고르지 않으면 placeholder — 골라 보세요",
        node: (
          <>
            <FoxSelectText size="lg" ariaLabel="조회 기간" options={SELECT_TEXT_MONTHS} placeholder="기간 선택" />
            <FoxSelectText size="md" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} />
          </>
        ),
      },
      {
        label: "제목 옆에 놓기 — inline이라 줄 전체를 차지하지 않습니다",
        node: (
          <span style={{ display: "inline-flex", alignItems: "center", gap: "0.8rem" }}>
            <FoxSelectText size="lg" ariaLabel="조회 기간" options={SELECT_TEXT_MONTHS} defaultValue="2026-08" />
            <FoxSelectText size="sm" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} defaultValue="amount" />
          </span>
        ),
      },
      {
        label: "비활성 — 시안에 없어 색은 기본과 같고 hover·pressed만 죽습니다",
        node: (
          <>
            <FoxSelectText size="lg" ariaLabel="조회 기간" options={SELECT_TEXT_MONTHS} defaultValue="2026-08" disabled />
            <FoxSelectText size="md" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} defaultValue="latest" disabled />
          </>
        ),
      },
      {
        label: "세로 flex 안에 놓아도 목록 폭이 늘어나지 않는다 (트리거는 부모가 늘립니다)",
        node: (
          <div className={styles.demoStack}>
            <FoxSelectText size="md" ariaLabel="조회 기간" options={SELECT_TEXT_MONTHS} defaultValue="2026-08" />
            <FoxSelectText size="sm" ariaLabel="정렬 기준" options={SELECT_TEXT_SORTS} defaultValue="latest" />
          </div>
        ),
      },
    ],
  },
  {
    id: "fox-segmented-control-item",
    name: "FoxSegmentedControlItem",
    description:
      "Figma 시안(segmented-control-item) 세그먼티드 컨트롤의 칸 하나입니다. 상태를 갖지 않습니다 — 켜짐 여부는 네이티브 input[type=radio]가 소유하므로, name만 같으면 단일 선택·화살표 이동·폼 전송을 브라우저가 처리합니다(FoxRadio와 같은 구조). 루트가 label이라 글자든 아이콘이든 어디를 눌러도 선택됩니다. 아래 예제는 묶는 테두리 없이 칸만 보여 주는 것이라 실제 사용 모습은 FoxSegmentedControl 쪽을 보세요 — 칸 오른쪽의 구분선이 이 컴포넌트 것이고, 감싸는 테두리와 모서리는 묶음 것입니다. 켜짐과 비활성은 구분선을 지웁니다 hover·pressed는 꺼져 있을 때만 걸립니다.",
    variants: [
      {
        label: "크기 — lg 56 / md 40 / sm 28 / xsm 24 (아이콘도 24/20/16/12로 함께)",
        node: (
          <>
            <FoxSegmentedControlItem name="sci-lg" size="lg" label="목록" icon={<DemoStar />} defaultChecked />
            <FoxSegmentedControlItem name="sci-md" size="md" label="목록" icon={<DemoStar />} defaultChecked />
            <FoxSegmentedControlItem name="sci-sm" size="sm" label="목록" icon={<DemoStar />} defaultChecked />
            <FoxSegmentedControlItem name="sci-xsm" size="xsm" label="목록" icon={<DemoStar />} defaultChecked />
          </>
        ),
      },
      {
        label: "상태 — 꺼짐 / 켜짐 / 비활성+꺼짐 / 비활성+켜짐 (마우스를 올리고 눌러 보세요)",
        node: (
          <>
            <FoxSegmentedControlItem name="sci-a" size="md" label="꺼짐" />
            <FoxSegmentedControlItem name="sci-b" size="md" label="켜짐" defaultChecked />
            <FoxSegmentedControlItem name="sci-c" size="md" label="비활성" disabled />
            <FoxSegmentedControlItem name="sci-d" size="md" label="비활성 켜짐" disabled defaultChecked />
          </>
        ),
      },
      {
        label: "아이콘 없이 — 넘기지 않으면 자리를 만들지 않습니다",
        node: (
          <>
            <FoxSegmentedControlItem name="sci-e" size="md" label="글자만" />
            <FoxSegmentedControlItem name="sci-f" size="md" label="아이콘" icon={<DemoStar />} />
          </>
        ),
      },
    ],
  },
  {
    id: "fox-segmented-control",
    name: "FoxSegmentedControl",
    description:
      "Figma 시안(segmented-control) 칸들을 테두리 하나로 감싸고 name·size를 통일합니다. 상태를 갖지 않습니다 — 어느 칸이 켜졌는지는 각 칸의 네이티브 라디오가 소유하므로 아래 예제는 전부 실제로 눌러서 바꿀 수 있고, 화살표 키로도 이동합니다. size는 묶음의 모서리와 칸의 높이를 함께 정합니다: 둘이 어긋나면 칸 배경이 둥근 모서리와 맞지 않아서, 자식이 준 size는 무시되고 묶음 값으로 통일됩니다. overflow: hidden으로 채워진 칸 배경을 모서리에 맞춰 잘라 냅니다. name도 묶음이 단일 진실 공급원입니다 — 한 칸만 빼먹어 두 개가 켜지는 실수가 생기지 않습니다.",
    variants: [
      {
        label: "크기 — lg(모서리 12) / md(8) / sm(4) / xsm(4)",
        node: (
          <div className={styles.demoStackStart}>
            <FoxSegmentedControl size="lg" name="sc-lg" label="보기 방식 lg">
              <FoxSegmentedControlItem label="전체" value="all" defaultChecked />
              <FoxSegmentedControlItem label="입금" value="in" />
              <FoxSegmentedControlItem label="출금" value="out" />
            </FoxSegmentedControl>
            <FoxSegmentedControl size="md" name="sc-md" label="보기 방식 md">
              <FoxSegmentedControlItem label="전체" value="all" defaultChecked />
              <FoxSegmentedControlItem label="입금" value="in" />
              <FoxSegmentedControlItem label="출금" value="out" />
            </FoxSegmentedControl>
            <FoxSegmentedControl size="sm" name="sc-sm" label="보기 방식 sm">
              <FoxSegmentedControlItem label="전체" value="all" defaultChecked />
              <FoxSegmentedControlItem label="입금" value="in" />
              <FoxSegmentedControlItem label="출금" value="out" />
            </FoxSegmentedControl>
            <FoxSegmentedControl size="xsm" name="sc-xsm" label="보기 방식 xsm">
              <FoxSegmentedControlItem label="전체" value="all" defaultChecked />
              <FoxSegmentedControlItem label="입금" value="in" />
              <FoxSegmentedControlItem label="출금" value="out" />
            </FoxSegmentedControl>
          </div>
        ),
      },
      {
        label: "아이콘 + 글자 — 첫 칸·마지막 칸이 켜져도 배경이 모서리를 넘지 않습니다",
        node: (
          <FoxSegmentedControl size="md" name="sc-icon" label="정렬 방식">
            <FoxSegmentedControlItem label="목록" value="list" icon={<DemoStar />} defaultChecked />
            <FoxSegmentedControlItem label="카드" value="card" icon={<DemoStar />} />
            <FoxSegmentedControlItem label="표" value="table" icon={<DemoStar />} />
          </FoxSegmentedControl>
        ),
      },
      {
        label: "size — 자식이 준 값은 무시되고 묶음 값으로 통일된다",
        node: (
          <FoxSegmentedControl size="sm" name="sc-override" label="크기 통일">
            {/* 일부러 어긋난 size를 준다 — 셋 다 sm으로 나와야 정상 */}
            <FoxSegmentedControlItem label="전체" value="all" size="lg" defaultChecked />
            <FoxSegmentedControlItem label="입금" value="in" size="xsm" />
            <FoxSegmentedControlItem label="출금" value="out" />
          </FoxSegmentedControl>
        ),
      },
      {
        label: "칸 하나만 비활성 — 나머지는 그대로 고를 수 있습니다",
        node: (
          <FoxSegmentedControl size="md" name="sc-disabled" label="일부 비활성">
            <FoxSegmentedControlItem label="전체" value="all" defaultChecked />
            <FoxSegmentedControlItem label="입금" value="in" />
            <FoxSegmentedControlItem label="준비중" value="soon" disabled />
          </FoxSegmentedControl>
        ),
      },
      {
        label: "칸 두 개 / 다섯 개 — 개수와 무관하게 규칙이 같습니다",
        node: (
          <div className={styles.demoStackStart}>
            <FoxSegmentedControl size="md" name="sc-two" label="두 칸">
              <FoxSegmentedControlItem label="켜짐" value="on" defaultChecked />
              <FoxSegmentedControlItem label="꺼짐" value="off" />
            </FoxSegmentedControl>
            <FoxSegmentedControl size="md" name="sc-five" label="다섯 칸">
              <FoxSegmentedControlItem label="1월" value="1" />
              <FoxSegmentedControlItem label="2월" value="2" />
              <FoxSegmentedControlItem label="3월" value="3" defaultChecked />
              <FoxSegmentedControlItem label="4월" value="4" />
              <FoxSegmentedControlItem label="5월" value="5" />
            </FoxSegmentedControl>
          </div>
        ),
      },
    ],
  },

  {
    id: "fox-toggle-quantity",
    name: "FoxToggleQuantity",
    description:
      "Figma 시안(toggle-quantity) 수량 조절기입니다. 회색 판 위에 빼기 버튼·숫자·더하기 버튼이 놓이고, 크기 수식어가 없습니다 — 시안이 한 벌만 줍니다. 값은 제어·비제어 둘 다 되고(FoxSelect와 같은 방식) min·max에 닿으면 해당 버튼이 네이티브 disabled가 되므로 누를 수 없다는 것이 커서와 보조기술에 함께 전달됩니다. 숫자는 입력칸이 아니라 읽기 전용 글자입니다 — 시안에 입력칸의 테두리도 배경도 없어서 role=spinbutton을 붙이지 않고, 대신 값에 aria-live를 걸어 바뀐 숫자를 읽어 줍니다. 숫자가 flex: 1 0 0이라 남는 자리를 혼자 가져가므로 값이 한 자리든 세 자리든 버튼 위치가 흔들리지 않습니다. 버튼은 FoxIconButton이 아닙니다 — 크기·모서리·아이콘 슬롯은 sm과 같지만 배경이 투명이 아니라 흰색이어야 회색 판 위에서 보입니다.",
    variants: [
      {
        label: "기본 — 눌러서 바꿔 보세요 (min 0, 상한 없음)",
        node: <FoxToggleQuantity label="수량" defaultValue={1} />,
      },
      {
        label: "min에 닿으면 빼기가, max에 닿으면 더하기가 비활성됩니다 (min 1 / max 3)",
        node: (
          <>
            <FoxToggleQuantity label="최소값" min={1} max={3} defaultValue={1} />
            <FoxToggleQuantity label="중간값" min={1} max={3} defaultValue={2} />
            <FoxToggleQuantity label="최대값" min={1} max={3} defaultValue={3} />
          </>
        ),
      },
      {
        label: "step — 한 번에 10씩",
        node: <FoxToggleQuantity label="10단위" step={10} max={100} defaultValue={10} />,
      },
      {
        label: "자릿수가 늘어도 버튼 위치가 흔들리지 않습니다",
        node: (
          <>
            <FoxToggleQuantity label="한 자리" defaultValue={9} />
            <FoxToggleQuantity label="세 자리" defaultValue={999} />
          </>
        ),
      },
      {
        label: "disabled — 둘 다 막습니다 (min·max에 의한 개별 비활성과는 별개)",
        node: <FoxToggleQuantity label="비활성" defaultValue={5} disabled />,
      },
    ],
  },
];