@nurimedia/react-ui 0.1.0

package/dist/Modal/index.d.ts

@@ -0,0 +1,62 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import * as Dialog from '@radix-ui/react-dialog';
+
+type Placement = 'center' | 'bottom';
+type Size = 'sm' | 'md' | 'lg';
+interface ModalContentProps extends ComponentPropsWithoutRef<typeof Dialog.Content> {
+    /**
+     * 표시 위치.
+     * - `center`: 화면 중앙 다이얼로그 (기본)
+     * - `bottom`: 하단 바텀시트 (모바일에서 아래에서 올라옴)
+     * @default 'center'
+     */
+    placement?: Placement;
+    /**
+     * 최대 너비. **`placement="center"`에서만 적용** (bottom 바텀시트는 항상 풀 width).
+     * @default 'md'
+     */
+    size?: Size;
+    /** 백드롭(오버레이) 표시 여부. @default true */
+    overlay?: boolean;
+    /** 포털 렌더 대상. 기본은 document.body. 다른 요소에 렌더하려면 지정. */
+    container?: HTMLElement | null;
+}
+interface ModalTitleProps extends ComponentPropsWithoutRef<typeof Dialog.Title> {
+    /**
+     * 시각적으로는 숨기되 스크린리더에는 노출. 시각적 제목이 없는 모달도
+     * 접근 가능한 이름을 가져야 하므로(Radix Dialog는 Title 필수), 이 옵션으로 처리.
+     * @example <Modal.Title visuallyHidden>이미지 미리보기</Modal.Title>
+     */
+    visuallyHidden?: boolean;
+}
+interface ModalFooterProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * 액션 버튼 정렬.
+     * - `end`: 우측 (기본, 데스크탑 관례)
+     * - `start`: 좌측
+     * - `center`: 가운데
+     * - `between`: 양끝 분산 (예: 좌측 위험 액션 + 우측 확인)
+     * - `full`: 버튼들이 가로를 균등하게 채움 (모바일 전체너비)
+     * @default 'end'
+     */
+    align?: 'start' | 'center' | 'end' | 'between' | 'full';
+}
+declare const Modal: {
+    (props: ComponentPropsWithoutRef<typeof Dialog.Root>): react.JSX.Element;
+    displayName: string;
+} & {
+    Trigger: react.ForwardRefExoticComponent<Dialog.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+    Content: react.ForwardRefExoticComponent<ModalContentProps & react.RefAttributes<HTMLDivElement>>;
+    Header: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+    Title: react.ForwardRefExoticComponent<ModalTitleProps & react.RefAttributes<HTMLHeadingElement>>;
+    Description: react.ForwardRefExoticComponent<Omit<Dialog.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
+    Body: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+    Footer: react.ForwardRefExoticComponent<ModalFooterProps & react.RefAttributes<HTMLDivElement>>;
+    Close: react.ForwardRefExoticComponent<Dialog.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
+    CloseButton: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & {
+        children?: ReactNode;
+    } & react.RefAttributes<HTMLButtonElement>>;
+};
+
+export { Modal, type ModalContentProps, type ModalFooterProps, type ModalTitleProps };

package/dist/Modal/index.js

@@ -0,0 +1,83 @@
+// src/Modal/Modal.tsx
+import "./styles.css";
+import * as Dialog from "@radix-ui/react-dialog";
+import { forwardRef } from "react";
+
+// src/utils/cx.ts
+function cx(...classes) {
+  return classes.filter(Boolean).join(" ");
+}
+
+// src/Modal/Modal.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var Root2 = (props) => /* @__PURE__ */ jsx(Dialog.Root, { ...props });
+Root2.displayName = "Modal";
+var Trigger2 = Dialog.Trigger;
+var Content2 = forwardRef(
+  function ModalContent({ placement = "center", size = "md", overlay = true, container, className, children, ...rest }, ref) {
+    const classes = cx("nuri-modal", `nuri-modal--${placement}`, `nuri-modal--${size}`, className);
+    return /* @__PURE__ */ jsxs(Dialog.Portal, { container, children: [
+      overlay && /* @__PURE__ */ jsx(Dialog.Overlay, { className: "nuri-modal__overlay" }),
+      /* @__PURE__ */ jsx(Dialog.Content, { ref, className: classes, ...rest, children })
+    ] });
+  }
+);
+var Header = forwardRef(function ModalHeader({ className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx("div", { ref, className: cx("nuri-modal__header", className), ...rest });
+});
+var Title2 = forwardRef(function ModalTitle({ visuallyHidden = false, className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(
+    Dialog.Title,
+    {
+      ref,
+      className: cx("nuri-modal__title", visuallyHidden && "nuri-sr-only", className),
+      ...rest
+    }
+  );
+});
+var Description2 = forwardRef(function ModalDescription({ className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(Dialog.Description, { ref, className: cx("nuri-modal__description", className), ...rest });
+});
+var Body = forwardRef(function ModalBody({ className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx("div", { ref, className: cx("nuri-modal__body", className), ...rest });
+});
+var Footer = forwardRef(function ModalFooter({ align = "end", className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref,
+      className: cx("nuri-modal__footer", `nuri-modal__footer--${align}`, className),
+      ...rest
+    }
+  );
+});
+var Close2 = Dialog.Close;
+var CloseIcon = () => /* @__PURE__ */ jsx("svg", { width: "20", height: "20", viewBox: "0 0 20 20", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M5 5l10 10M15 5L5 15", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round" }) });
+var CloseButton = forwardRef(function ModalCloseButton({ className, "aria-label": ariaLabel = "\uB2EB\uAE30", children, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(Dialog.Close, { asChild: true, children: /* @__PURE__ */ jsx(
+    "button",
+    {
+      ref,
+      type: "button",
+      "aria-label": ariaLabel,
+      className: cx("nuri-modal__close", className),
+      ...rest,
+      children: children ?? /* @__PURE__ */ jsx(CloseIcon, {})
+    }
+  ) });
+});
+var Modal = Object.assign(Root2, {
+  Trigger: Trigger2,
+  Content: Content2,
+  Header,
+  Title: Title2,
+  Description: Description2,
+  Body,
+  Footer,
+  Close: Close2,
+  CloseButton
+});
+export {
+  Modal
+};
+//# sourceMappingURL=index.js.map

package/dist/Modal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Modal/Modal.tsx","../../src/utils/cx.ts"],"sourcesContent":["'use client';\n\nimport './styles.css';\nimport * as Dialog from '@radix-ui/react-dialog';\nimport { forwardRef } from 'react';\nimport type { ComponentPropsWithoutRef, ElementRef, ReactNode } from 'react';\nimport { cx } from '../utils/cx.js';\n\ntype Placement = 'center' | 'bottom';\ntype Size = 'sm' | 'md' | 'lg';\n\n/**\n * 모달 루트. open/onOpenChange로 제어하거나, Modal.Trigger와 함께 비제어로도 사용.\n * Radix Dialog 기반 — 포커스 트랩·Esc·스크롤 락·포커스 복귀·aria 연결을 자동 제공.\n *\n * @example 제어형\n * <Modal open={open} onOpenChange={setOpen}>\n *   <Modal.Content>...</Modal.Content>\n * </Modal>\n *\n * @example 비제어 (트리거)\n * <Modal>\n *   <Modal.Trigger asChild><Button>열기</Button></Modal.Trigger>\n *   <Modal.Content>...</Modal.Content>\n * </Modal>\n */\nconst Root = (props: ComponentPropsWithoutRef<typeof Dialog.Root>) => <Dialog.Root {...props} />;\nRoot.displayName = 'Modal';\n\n/** 모달을 여는 트리거. `asChild`로 임의 엘리먼트(Button 등)에 위임. */\nconst Trigger = Dialog.Trigger;\n\nexport interface ModalContentProps extends ComponentPropsWithoutRef<typeof Dialog.Content> {\n  /**\n   * 표시 위치.\n   * - `center`: 화면 중앙 다이얼로그 (기본)\n   * - `bottom`: 하단 바텀시트 (모바일에서 아래에서 올라옴)\n   * @default 'center'\n   */\n  placement?: Placement;\n  /**\n   * 최대 너비. **`placement=\"center\"`에서만 적용** (bottom 바텀시트는 항상 풀 width).\n   * @default 'md'\n   */\n  size?: Size;\n  /** 백드롭(오버레이) 표시 여부. @default true */\n  overlay?: boolean;\n  /** 포털 렌더 대상. 기본은 document.body. 다른 요소에 렌더하려면 지정. */\n  container?: HTMLElement | null;\n}\n\n/**\n * 오버레이 + 포털 + 다이얼로그 패널을 한 번에 렌더.\n * 내부에 Modal.Header / Modal.Body / Modal.Footer를 자유롭게 합성.\n */\nconst Content = forwardRef<ElementRef<typeof Dialog.Content>, ModalContentProps>(\n  function ModalContent(\n    { placement = 'center', size = 'md', overlay = true, container, className, children, ...rest },\n    ref,\n  ) {\n    const classes = cx('nuri-modal', `nuri-modal--${placement}`, `nuri-modal--${size}`, className);\n\n    return (\n      <Dialog.Portal container={container}>\n        {overlay && <Dialog.Overlay className=\"nuri-modal__overlay\" />}\n        <Dialog.Content ref={ref} className={classes} {...rest}>\n          {children}\n        </Dialog.Content>\n      </Dialog.Portal>\n    );\n  },\n);\n\n/** 헤더 영역 (Title/Description/CloseButton을 담는 레이아웃 슬롯). */\nconst Header = forwardRef<HTMLDivElement, ComponentPropsWithoutRef<'div'>>(function ModalHeader(\n  { className, ...rest },\n  ref,\n) {\n  return <div ref={ref} className={cx('nuri-modal__header', className)} {...rest} />;\n});\n\nexport interface ModalTitleProps extends ComponentPropsWithoutRef<typeof Dialog.Title> {\n  /**\n   * 시각적으로는 숨기되 스크린리더에는 노출. 시각적 제목이 없는 모달도\n   * 접근 가능한 이름을 가져야 하므로(Radix Dialog는 Title 필수), 이 옵션으로 처리.\n   * @example <Modal.Title visuallyHidden>이미지 미리보기</Modal.Title>\n   */\n  visuallyHidden?: boolean;\n}\n\n/** 모달 제목. 렌더 시 자동으로 `aria-labelledby`로 연결됨 (Radix Dialog.Title). */\nconst Title = forwardRef<ElementRef<typeof Dialog.Title>, ModalTitleProps>(function ModalTitle(\n  { visuallyHidden = false, className, ...rest },\n  ref,\n) {\n  return (\n    <Dialog.Title\n      ref={ref}\n      className={cx('nuri-modal__title', visuallyHidden && 'nuri-sr-only', className)}\n      {...rest}\n    />\n  );\n});\n\n/** 모달 설명. 렌더 시 자동으로 `aria-describedby`로 연결됨 (Radix Dialog.Description). */\nconst Description = forwardRef<\n  ElementRef<typeof Dialog.Description>,\n  ComponentPropsWithoutRef<typeof Dialog.Description>\n>(function ModalDescription({ className, ...rest }, ref) {\n  return (\n    <Dialog.Description ref={ref} className={cx('nuri-modal__description', className)} {...rest} />\n  );\n});\n\n/** 본문 영역 (스크롤 가능). */\nconst Body = forwardRef<HTMLDivElement, ComponentPropsWithoutRef<'div'>>(function ModalBody(\n  { className, ...rest },\n  ref,\n) {\n  return <div ref={ref} className={cx('nuri-modal__body', className)} {...rest} />;\n});\n\nexport interface ModalFooterProps extends ComponentPropsWithoutRef<'div'> {\n  /**\n   * 액션 버튼 정렬.\n   * - `end`: 우측 (기본, 데스크탑 관례)\n   * - `start`: 좌측\n   * - `center`: 가운데\n   * - `between`: 양끝 분산 (예: 좌측 위험 액션 + 우측 확인)\n   * - `full`: 버튼들이 가로를 균등하게 채움 (모바일 전체너비)\n   * @default 'end'\n   */\n  align?: 'start' | 'center' | 'end' | 'between' | 'full';\n}\n\n/** 푸터 영역 (액션 버튼 배치). 정렬은 `align` prop으로 제어. */\nconst Footer = forwardRef<HTMLDivElement, ModalFooterProps>(function ModalFooter(\n  { align = 'end', className, ...rest },\n  ref,\n) {\n  return (\n    <div\n      ref={ref}\n      className={cx('nuri-modal__footer', `nuri-modal__footer--${align}`, className)}\n      {...rest}\n    />\n  );\n});\n\n/**\n * 모달을 닫는 액션. `asChild`로 임의 엘리먼트에 위임.\n * @example <Modal.Close asChild><Button variant=\"outline\">취소</Button></Modal.Close>\n */\nconst Close = Dialog.Close;\n\nconst CloseIcon = () => (\n  <svg width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"none\" aria-hidden=\"true\">\n    <path d=\"M5 5l10 10M15 5L5 15\" stroke=\"currentColor\" strokeWidth=\"1.5\" strokeLinecap=\"round\" />\n  </svg>\n);\n\n/** 우상단 X 닫기 버튼 (미리 스타일링됨). 기본 `aria-label=\"닫기\"`. */\nconst CloseButton = forwardRef<\n  HTMLButtonElement,\n  Omit<ComponentPropsWithoutRef<'button'>, 'children'> & { children?: ReactNode }\n>(function ModalCloseButton(\n  { className, 'aria-label': ariaLabel = '닫기', children, ...rest },\n  ref,\n) {\n  return (\n    <Dialog.Close asChild>\n      <button\n        ref={ref}\n        type=\"button\"\n        aria-label={ariaLabel}\n        className={cx('nuri-modal__close', className)}\n        {...rest}\n      >\n        {children ?? <CloseIcon />}\n      </button>\n    </Dialog.Close>\n  );\n});\n\nexport const Modal = Object.assign(Root, {\n  Trigger,\n  Content,\n  Header,\n  Title,\n  Description,\n  Body,\n  Footer,\n  Close,\n  CloseButton,\n});\n","/**\n * 조건부 className 합성 유틸. falsy 값(undefined/false/null/'')은 제거.\n * @example cx('btn', isActive && 'btn--active', className)\n */\nexport function cx(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(' ');\n}\n"],"mappings":";AAEA,OAAO;AACP,YAAY,YAAY;AACxB,SAAS,kBAAkB;;;ACApB,SAAS,MAAM,SAA2D;AAC/E,SAAO,QAAQ,OAAO,OAAO,EAAE,KAAK,GAAG;AACzC;;;ADoBsE,cAqChE,YArCgE;AAAtE,IAAMA,QAAO,CAAC,UAAwD,oBAAQ,aAAP,EAAa,GAAG,OAAO;AAC9FA,MAAK,cAAc;AAGnB,IAAMC,WAAiB;AAyBvB,IAAMC,WAAU;AAAA,EACd,SAAS,aACP,EAAE,YAAY,UAAU,OAAO,MAAM,UAAU,MAAM,WAAW,WAAW,UAAU,GAAG,KAAK,GAC7F,KACA;AACA,UAAM,UAAU,GAAG,cAAc,eAAe,SAAS,IAAI,eAAe,IAAI,IAAI,SAAS;AAE7F,WACE,qBAAQ,eAAP,EAAc,WACZ;AAAA,iBAAW,oBAAQ,gBAAP,EAAe,WAAU,uBAAsB;AAAA,MAC5D,oBAAQ,gBAAP,EAAe,KAAU,WAAW,SAAU,GAAG,MAC/C,UACH;AAAA,OACF;AAAA,EAEJ;AACF;AAGA,IAAM,SAAS,WAA4D,SAAS,YAClF,EAAE,WAAW,GAAG,KAAK,GACrB,KACA;AACA,SAAO,oBAAC,SAAI,KAAU,WAAW,GAAG,sBAAsB,SAAS,GAAI,GAAG,MAAM;AAClF,CAAC;AAYD,IAAMC,SAAQ,WAA6D,SAAS,WAClF,EAAE,iBAAiB,OAAO,WAAW,GAAG,KAAK,GAC7C,KACA;AACA,SACE;AAAA,IAAQ;AAAA,IAAP;AAAA,MACC;AAAA,MACA,WAAW,GAAG,qBAAqB,kBAAkB,gBAAgB,SAAS;AAAA,MAC7E,GAAG;AAAA;AAAA,EACN;AAEJ,CAAC;AAGD,IAAMC,eAAc,WAGlB,SAAS,iBAAiB,EAAE,WAAW,GAAG,KAAK,GAAG,KAAK;AACvD,SACE,oBAAQ,oBAAP,EAAmB,KAAU,WAAW,GAAG,2BAA2B,SAAS,GAAI,GAAG,MAAM;AAEjG,CAAC;AAGD,IAAM,OAAO,WAA4D,SAAS,UAChF,EAAE,WAAW,GAAG,KAAK,GACrB,KACA;AACA,SAAO,oBAAC,SAAI,KAAU,WAAW,GAAG,oBAAoB,SAAS,GAAI,GAAG,MAAM;AAChF,CAAC;AAgBD,IAAM,SAAS,WAA6C,SAAS,YACnE,EAAE,QAAQ,OAAO,WAAW,GAAG,KAAK,GACpC,KACA;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,WAAW,GAAG,sBAAsB,uBAAuB,KAAK,IAAI,SAAS;AAAA,MAC5E,GAAG;AAAA;AAAA,EACN;AAEJ,CAAC;AAMD,IAAMC,SAAe;AAErB,IAAM,YAAY,MAChB,oBAAC,SAAI,OAAM,MAAK,QAAO,MAAK,SAAQ,aAAY,MAAK,QAAO,eAAY,QACtE,8BAAC,UAAK,GAAE,wBAAuB,QAAO,gBAAe,aAAY,OAAM,eAAc,SAAQ,GAC/F;AAIF,IAAM,cAAc,WAGlB,SAAS,iBACT,EAAE,WAAW,cAAc,YAAY,gBAAM,UAAU,GAAG,KAAK,GAC/D,KACA;AACA,SACE,oBAAQ,cAAP,EAAa,SAAO,MACnB;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,MAAK;AAAA,MACL,cAAY;AAAA,MACZ,WAAW,GAAG,qBAAqB,SAAS;AAAA,MAC3C,GAAG;AAAA,MAEH,sBAAY,oBAAC,aAAU;AAAA;AAAA,EAC1B,GACF;AAEJ,CAAC;AAEM,IAAM,QAAQ,OAAO,OAAOL,OAAM;AAAA,EACvC,SAAAC;AAAA,EACA,SAAAC;AAAA,EACA;AAAA,EACA,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAAC;AAAA,EACA;AACF,CAAC;","names":["Root","Trigger","Content","Title","Description","Close"]}

package/dist/Modal/styles.css

@@ -0,0 +1,229 @@
+.nuri-modal__overlay {
+  position: fixed;
+  inset: 0;
+  background-color: var(--nuri-modal-overlay);
+  z-index: var(--nuri-modal-z-index);
+  animation: nuri-modal-overlay-in 200ms ease;
+}
+.nuri-modal__overlay[data-state='closed'] {
+  animation: nuri-modal-overlay-out 150ms ease;
+}
+
+.nuri-modal,
+.nuri-modal__header,
+.nuri-modal__body,
+.nuri-modal__footer {
+  box-sizing: border-box;
+}
+
+.nuri-modal {
+  position: fixed;
+  z-index: calc(var(--nuri-modal-z-index) + 1);
+  display: flex;
+  flex-direction: column;
+  gap: var(--nuri-modal-gap);
+  background-color: var(--nuri-modal-surface);
+  color: var(--nuri-modal-fg);
+  box-shadow: var(--nuri-modal-shadow);
+  font-family: inherit;
+  max-height: calc(100dvh - 48px);
+  outline: none;
+}
+
+/* ─── placement: center ─── */
+.nuri-modal--center {
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  width: calc(100vw - 32px);
+  border-radius: var(--nuri-modal-radius);
+  padding: var(--nuri-modal-padding);
+  animation: nuri-modal-center-in 200ms ease;
+}
+.nuri-modal--center[data-state='closed'] {
+  animation: nuri-modal-center-out 150ms ease;
+}
+.nuri-modal--center.nuri-modal--sm {
+  max-width: var(--nuri-modal-width-sm);
+}
+.nuri-modal--center.nuri-modal--md {
+  max-width: var(--nuri-modal-width-md);
+}
+.nuri-modal--center.nuri-modal--lg {
+  max-width: var(--nuri-modal-width-lg);
+}
+
+/* ─── placement: bottom (바텀시트) ─── */
+/* 바텀시트는 모바일 패턴(언제 쓸지는 소비 앱이 useMediaQuery로 결정) → 항상 풀 width.
+   size prop은 바텀시트에선 width에 영향 없음 (center 전용) */
+.nuri-modal--bottom {
+  left: 0;
+  right: 0;
+  bottom: 0;
+  width: 100%;
+  border-radius: var(--nuri-modal-radius-bottom) var(--nuri-modal-radius-bottom) 0 0;
+  padding: var(--nuri-modal-padding);
+  padding-bottom: calc(var(--nuri-modal-padding) + env(safe-area-inset-bottom, 0px));
+  animation: nuri-modal-bottom-in 240ms cubic-bezier(0.32, 0.72, 0, 1);
+}
+.nuri-modal--bottom[data-state='closed'] {
+  animation: nuri-modal-bottom-out 200ms ease;
+}
+
+/* ─── 내부 슬롯 ─── */
+.nuri-modal__header {
+  display: flex;
+  flex-direction: column;
+  gap: var(--nuri-modal-header-gap);
+  position: relative;
+}
+
+.nuri-modal__title {
+  margin: 0;
+  font-size: var(--nuri-modal-title-size);
+  font-weight: var(--nuri-modal-title-weight);
+  color: var(--nuri-modal-fg);
+  line-height: 1.6;
+}
+
+/* 시각적으로만 숨김 (스크린리더에는 노출) — visuallyHidden Title 등에 사용 */
+.nuri-sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+.nuri-modal__description {
+  margin: 0;
+  font-size: var(--nuri-modal-desc-size);
+  color: var(--nuri-modal-fg-muted);
+  line-height: 1.6;
+}
+
+.nuri-modal__body {
+  flex: 1 1 auto;
+  overflow-y: auto;
+  font-size: var(--nuri-modal-body-size);
+  line-height: 1.6;
+}
+
+/* ─── footer: 정렬은 align prop으로 (기본 end) ─── */
+.nuri-modal__footer {
+  display: flex;
+  gap: var(--nuri-modal-footer-gap);
+  flex-shrink: 0;
+}
+.nuri-modal__footer--start {
+  justify-content: flex-start;
+}
+.nuri-modal__footer--center {
+  justify-content: center;
+}
+.nuri-modal__footer--end {
+  justify-content: flex-end;
+}
+.nuri-modal__footer--between {
+  justify-content: space-between;
+}
+/* full: 자식 버튼들이 가로를 균등하게 채움 (모바일 전체너비 액션) */
+.nuri-modal__footer--full > * {
+  flex: 1 1 0;
+}
+
+/* ─── 우상단 닫기 버튼 ─── */
+.nuri-modal__close {
+  position: absolute;
+  top: 0;
+  right: 0;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: none;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--nuri-modal-close-color);
+  cursor: pointer;
+  transition:
+    background-color 120ms ease,
+    color 120ms ease;
+}
+.nuri-modal__close:hover {
+  background-color: var(--nuri-modal-close-bg-hover);
+  color: var(--nuri-modal-close-color-hover);
+}
+.nuri-modal__close:focus-visible {
+  outline: var(--nuri-button-focus-ring-width) solid
+    var(--nuri-button-focus-ring-color, var(--nuri-color-brand-default));
+  outline-offset: 2px;
+}
+
+/* ─── 애니메이션 ─── */
+@keyframes nuri-modal-overlay-in {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+@keyframes nuri-modal-overlay-out {
+  from {
+    opacity: 1;
+  }
+  to {
+    opacity: 0;
+  }
+}
+@keyframes nuri-modal-center-in {
+  from {
+    opacity: 0;
+    transform: translate(-50%, -50%) scale(0.96);
+  }
+  to {
+    opacity: 1;
+    transform: translate(-50%, -50%) scale(1);
+  }
+}
+@keyframes nuri-modal-center-out {
+  from {
+    opacity: 1;
+    transform: translate(-50%, -50%) scale(1);
+  }
+  to {
+    opacity: 0;
+    transform: translate(-50%, -50%) scale(0.96);
+  }
+}
+@keyframes nuri-modal-bottom-in {
+  from {
+    transform: translateY(100%);
+  }
+  to {
+    transform: translateY(0);
+  }
+}
+@keyframes nuri-modal-bottom-out {
+  from {
+    transform: translateY(0);
+  }
+  to {
+    transform: translateY(100%);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .nuri-modal__overlay,
+  .nuri-modal--center,
+  .nuri-modal--bottom {
+    animation-duration: 1ms;
+  }
+}

package/dist/Radio/index.cjs

@@ -0,0 +1,86 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Radio/index.ts
+var Radio_exports = {};
+__export(Radio_exports, {
+  Radio: () => Radio,
+  RadioGroup: () => RadioGroup
+});
+module.exports = __toCommonJS(Radio_exports);
+
+// src/Radio/Radio.tsx
+var import_styles = require("./styles.css");
+var RadixRadioGroup = __toESM(require("@radix-ui/react-radio-group"), 1);
+var import_react = require("react");
+
+// src/utils/cx.ts
+function cx(...classes) {
+  return classes.filter(Boolean).join(" ");
+}
+
+// src/Radio/Radio.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var RadioGroup = (0, import_react.forwardRef)(function RadioGroup2({ children, orientation = "vertical", className, ...rest }, ref) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    RadixRadioGroup.Root,
+    {
+      ref,
+      orientation,
+      className: cx("nuri-radio-group", `nuri-radio-group--${orientation}`, className),
+      ...rest,
+      children
+    }
+  );
+});
+var Radio = (0, import_react.forwardRef)(function Radio2({ value, label, disabled = false, id: idProp, className, ...rest }, ref) {
+  const reactId = (0, import_react.useId)();
+  const id = idProp ?? `nuri-radio-${reactId}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: cx("nuri-radio", className), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      RadixRadioGroup.Item,
+      {
+        ref,
+        id,
+        value,
+        disabled,
+        className: "nuri-radio__control",
+        ...rest,
+        children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(RadixRadioGroup.Indicator, { className: "nuri-radio__indicator" })
+      }
+    ),
+    label != null && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { htmlFor: id, className: "nuri-radio__label", children: label })
+  ] });
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Radio,
+  RadioGroup
+});
+//# sourceMappingURL=index.cjs.map

package/dist/Radio/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Radio/index.ts","../../src/Radio/Radio.tsx","../../src/utils/cx.ts"],"sourcesContent":["export { RadioGroup, Radio } from './Radio.js';\nexport type { RadioGroupProps, RadioProps } from './Radio.js';\n","'use client';\n\nimport './styles.css';\nimport * as RadixRadioGroup from '@radix-ui/react-radio-group';\nimport { forwardRef, useId } from 'react';\nimport type { ReactNode } from 'react';\nimport { cx } from '../utils/cx.js';\n\nexport interface RadioGroupProps {\n  children: ReactNode;\n  /** 선택된 값 (제어형). */\n  value?: string;\n  /** 초기 값 (비제어형). */\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** 배치 방향 — 키보드 화살표 탐색 방향에도 반영됨. @default 'vertical' */\n  orientation?: 'vertical' | 'horizontal';\n  disabled?: boolean;\n  /** 폼 전송용 name. */\n  name?: string;\n  required?: boolean;\n  className?: string;\n  /** 그룹의 접근 가능한 이름 (시각 제목이 없을 때 필수). */\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n}\n\n/**\n * 라디오 그룹. Radix RadioGroup 기반 — 화살표 키 그룹 탐색·단일 선택·폼 참여 자동.\n * 그룹에 `aria-label`(또는 aria-labelledby)을 지정한다.\n *\n * @example\n * <RadioGroup aria-label=\"정렬\" value={sort} onValueChange={setSort}>\n *   <Radio value=\"latest\" label=\"최신순\" />\n *   <Radio value=\"edited\" label=\"수정순\" />\n * </RadioGroup>\n */\nexport const RadioGroup = forwardRef<HTMLDivElement, RadioGroupProps>(function RadioGroup(\n  { children, orientation = 'vertical', className, ...rest },\n  ref,\n) {\n  return (\n    <RadixRadioGroup.Root\n      ref={ref}\n      orientation={orientation}\n      className={cx('nuri-radio-group', `nuri-radio-group--${orientation}`, className)}\n      {...rest}\n    >\n      {children}\n    </RadixRadioGroup.Root>\n  );\n});\n\nexport interface RadioProps {\n  /** 이 항목이 나타내는 값. */\n  value: string;\n  /** 라벨 (컨트롤 우측). 없으면 `aria-label` 필수. */\n  label?: ReactNode;\n  disabled?: boolean;\n  id?: string;\n  className?: string;\n  'aria-label'?: string;\n}\n\n/** 라디오 항목 — 반드시 RadioGroup 안에서 사용. */\nexport const Radio = forwardRef<HTMLButtonElement, RadioProps>(function Radio(\n  { value, label, disabled = false, id: idProp, className, ...rest },\n  ref,\n) {\n  const reactId = useId();\n  const id = idProp ?? `nuri-radio-${reactId}`;\n\n  return (\n    <div className={cx('nuri-radio', className)}>\n      <RadixRadioGroup.Item\n        ref={ref}\n        id={id}\n        value={value}\n        disabled={disabled}\n        className=\"nuri-radio__control\"\n        {...rest}\n      >\n        <RadixRadioGroup.Indicator className=\"nuri-radio__indicator\" />\n      </RadixRadioGroup.Item>\n      {label != null && (\n        <label htmlFor={id} className=\"nuri-radio__label\">\n          {label}\n        </label>\n      )}\n    </div>\n  );\n});\n","/**\n * 조건부 className 합성 유틸. falsy 값(undefined/false/null/'')은 제거.\n * @example cx('btn', isActive && 'btn--active', className)\n */\nexport function cx(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(' ');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,oBAAO;AACP,sBAAiC;AACjC,mBAAkC;;;ACA3B,SAAS,MAAM,SAA2D;AAC/E,SAAO,QAAQ,OAAO,OAAO,EAAE,KAAK,GAAG;AACzC;;;ADoCI;AALG,IAAM,iBAAa,yBAA4C,SAASA,YAC7E,EAAE,UAAU,cAAc,YAAY,WAAW,GAAG,KAAK,GACzD,KACA;AACA,SACE;AAAA,IAAiB;AAAA,IAAhB;AAAA,MACC;AAAA,MACA;AAAA,MACA,WAAW,GAAG,oBAAoB,qBAAqB,WAAW,IAAI,SAAS;AAAA,MAC9E,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ,CAAC;AAcM,IAAM,YAAQ,yBAA0C,SAASC,OACtE,EAAE,OAAO,OAAO,WAAW,OAAO,IAAI,QAAQ,WAAW,GAAG,KAAK,GACjE,KACA;AACA,QAAM,cAAU,oBAAM;AACtB,QAAM,KAAK,UAAU,cAAc,OAAO;AAE1C,SACE,6CAAC,SAAI,WAAW,GAAG,cAAc,SAAS,GACxC;AAAA;AAAA,MAAiB;AAAA,MAAhB;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAU;AAAA,QACT,GAAG;AAAA,QAEJ,sDAAiB,2BAAhB,EAA0B,WAAU,yBAAwB;AAAA;AAAA,IAC/D;AAAA,IACC,SAAS,QACR,4CAAC,WAAM,SAAS,IAAI,WAAU,qBAC3B,iBACH;AAAA,KAEJ;AAEJ,CAAC;","names":["RadioGroup","Radio"]}

package/dist/Radio/index.d.cts

@@ -0,0 +1,46 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface RadioGroupProps {
+    children: ReactNode;
+    /** 선택된 값 (제어형). */
+    value?: string;
+    /** 초기 값 (비제어형). */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** 배치 방향 — 키보드 화살표 탐색 방향에도 반영됨. @default 'vertical' */
+    orientation?: 'vertical' | 'horizontal';
+    disabled?: boolean;
+    /** 폼 전송용 name. */
+    name?: string;
+    required?: boolean;
+    className?: string;
+    /** 그룹의 접근 가능한 이름 (시각 제목이 없을 때 필수). */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+/**
+ * 라디오 그룹. Radix RadioGroup 기반 — 화살표 키 그룹 탐색·단일 선택·폼 참여 자동.
+ * 그룹에 `aria-label`(또는 aria-labelledby)을 지정한다.
+ *
+ * @example
+ * <RadioGroup aria-label="정렬" value={sort} onValueChange={setSort}>
+ *   <Radio value="latest" label="최신순" />
+ *   <Radio value="edited" label="수정순" />
+ * </RadioGroup>
+ */
+declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
+interface RadioProps {
+    /** 이 항목이 나타내는 값. */
+    value: string;
+    /** 라벨 (컨트롤 우측). 없으면 `aria-label` 필수. */
+    label?: ReactNode;
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+/** 라디오 항목 — 반드시 RadioGroup 안에서 사용. */
+declare const Radio: react.ForwardRefExoticComponent<RadioProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { Radio, RadioGroup, type RadioGroupProps, type RadioProps };

package/dist/Radio/index.d.ts

@@ -0,0 +1,46 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface RadioGroupProps {
+    children: ReactNode;
+    /** 선택된 값 (제어형). */
+    value?: string;
+    /** 초기 값 (비제어형). */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** 배치 방향 — 키보드 화살표 탐색 방향에도 반영됨. @default 'vertical' */
+    orientation?: 'vertical' | 'horizontal';
+    disabled?: boolean;
+    /** 폼 전송용 name. */
+    name?: string;
+    required?: boolean;
+    className?: string;
+    /** 그룹의 접근 가능한 이름 (시각 제목이 없을 때 필수). */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+/**
+ * 라디오 그룹. Radix RadioGroup 기반 — 화살표 키 그룹 탐색·단일 선택·폼 참여 자동.
+ * 그룹에 `aria-label`(또는 aria-labelledby)을 지정한다.
+ *
+ * @example
+ * <RadioGroup aria-label="정렬" value={sort} onValueChange={setSort}>
+ *   <Radio value="latest" label="최신순" />
+ *   <Radio value="edited" label="수정순" />
+ * </RadioGroup>
+ */
+declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
+interface RadioProps {
+    /** 이 항목이 나타내는 값. */
+    value: string;
+    /** 라벨 (컨트롤 우측). 없으면 `aria-label` 필수. */
+    label?: ReactNode;
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+/** 라디오 항목 — 반드시 RadioGroup 안에서 사용. */
+declare const Radio: react.ForwardRefExoticComponent<RadioProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { Radio, RadioGroup, type RadioGroupProps, type RadioProps };

package/dist/Radio/index.js

@@ -0,0 +1,48 @@
+// src/Radio/Radio.tsx
+import "./styles.css";
+import * as RadixRadioGroup from "@radix-ui/react-radio-group";
+import { forwardRef, useId } from "react";
+
+// src/utils/cx.ts
+function cx(...classes) {
+  return classes.filter(Boolean).join(" ");
+}
+
+// src/Radio/Radio.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var RadioGroup = forwardRef(function RadioGroup2({ children, orientation = "vertical", className, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(
+    RadixRadioGroup.Root,
+    {
+      ref,
+      orientation,
+      className: cx("nuri-radio-group", `nuri-radio-group--${orientation}`, className),
+      ...rest,
+      children
+    }
+  );
+});
+var Radio = forwardRef(function Radio2({ value, label, disabled = false, id: idProp, className, ...rest }, ref) {
+  const reactId = useId();
+  const id = idProp ?? `nuri-radio-${reactId}`;
+  return /* @__PURE__ */ jsxs("div", { className: cx("nuri-radio", className), children: [
+    /* @__PURE__ */ jsx(
+      RadixRadioGroup.Item,
+      {
+        ref,
+        id,
+        value,
+        disabled,
+        className: "nuri-radio__control",
+        ...rest,
+        children: /* @__PURE__ */ jsx(RadixRadioGroup.Indicator, { className: "nuri-radio__indicator" })
+      }
+    ),
+    label != null && /* @__PURE__ */ jsx("label", { htmlFor: id, className: "nuri-radio__label", children: label })
+  ] });
+});
+export {
+  Radio,
+  RadioGroup
+};
+//# sourceMappingURL=index.js.map

package/dist/Radio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Radio/Radio.tsx","../../src/utils/cx.ts"],"sourcesContent":["'use client';\n\nimport './styles.css';\nimport * as RadixRadioGroup from '@radix-ui/react-radio-group';\nimport { forwardRef, useId } from 'react';\nimport type { ReactNode } from 'react';\nimport { cx } from '../utils/cx.js';\n\nexport interface RadioGroupProps {\n  children: ReactNode;\n  /** 선택된 값 (제어형). */\n  value?: string;\n  /** 초기 값 (비제어형). */\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** 배치 방향 — 키보드 화살표 탐색 방향에도 반영됨. @default 'vertical' */\n  orientation?: 'vertical' | 'horizontal';\n  disabled?: boolean;\n  /** 폼 전송용 name. */\n  name?: string;\n  required?: boolean;\n  className?: string;\n  /** 그룹의 접근 가능한 이름 (시각 제목이 없을 때 필수). */\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n}\n\n/**\n * 라디오 그룹. Radix RadioGroup 기반 — 화살표 키 그룹 탐색·단일 선택·폼 참여 자동.\n * 그룹에 `aria-label`(또는 aria-labelledby)을 지정한다.\n *\n * @example\n * <RadioGroup aria-label=\"정렬\" value={sort} onValueChange={setSort}>\n *   <Radio value=\"latest\" label=\"최신순\" />\n *   <Radio value=\"edited\" label=\"수정순\" />\n * </RadioGroup>\n */\nexport const RadioGroup = forwardRef<HTMLDivElement, RadioGroupProps>(function RadioGroup(\n  { children, orientation = 'vertical', className, ...rest },\n  ref,\n) {\n  return (\n    <RadixRadioGroup.Root\n      ref={ref}\n      orientation={orientation}\n      className={cx('nuri-radio-group', `nuri-radio-group--${orientation}`, className)}\n      {...rest}\n    >\n      {children}\n    </RadixRadioGroup.Root>\n  );\n});\n\nexport interface RadioProps {\n  /** 이 항목이 나타내는 값. */\n  value: string;\n  /** 라벨 (컨트롤 우측). 없으면 `aria-label` 필수. */\n  label?: ReactNode;\n  disabled?: boolean;\n  id?: string;\n  className?: string;\n  'aria-label'?: string;\n}\n\n/** 라디오 항목 — 반드시 RadioGroup 안에서 사용. */\nexport const Radio = forwardRef<HTMLButtonElement, RadioProps>(function Radio(\n  { value, label, disabled = false, id: idProp, className, ...rest },\n  ref,\n) {\n  const reactId = useId();\n  const id = idProp ?? `nuri-radio-${reactId}`;\n\n  return (\n    <div className={cx('nuri-radio', className)}>\n      <RadixRadioGroup.Item\n        ref={ref}\n        id={id}\n        value={value}\n        disabled={disabled}\n        className=\"nuri-radio__control\"\n        {...rest}\n      >\n        <RadixRadioGroup.Indicator className=\"nuri-radio__indicator\" />\n      </RadixRadioGroup.Item>\n      {label != null && (\n        <label htmlFor={id} className=\"nuri-radio__label\">\n          {label}\n        </label>\n      )}\n    </div>\n  );\n});\n","/**\n * 조건부 className 합성 유틸. falsy 값(undefined/false/null/'')은 제거.\n * @example cx('btn', isActive && 'btn--active', className)\n */\nexport function cx(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(' ');\n}\n"],"mappings":";AAEA,OAAO;AACP,YAAY,qBAAqB;AACjC,SAAS,YAAY,aAAa;;;ACA3B,SAAS,MAAM,SAA2D;AAC/E,SAAO,QAAQ,OAAO,OAAO,EAAE,KAAK,GAAG;AACzC;;;ADoCI,cA+BA,YA/BA;AALG,IAAM,aAAa,WAA4C,SAASA,YAC7E,EAAE,UAAU,cAAc,YAAY,WAAW,GAAG,KAAK,GACzD,KACA;AACA,SACE;AAAA,IAAiB;AAAA,IAAhB;AAAA,MACC;AAAA,MACA;AAAA,MACA,WAAW,GAAG,oBAAoB,qBAAqB,WAAW,IAAI,SAAS;AAAA,MAC9E,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ,CAAC;AAcM,IAAM,QAAQ,WAA0C,SAASC,OACtE,EAAE,OAAO,OAAO,WAAW,OAAO,IAAI,QAAQ,WAAW,GAAG,KAAK,GACjE,KACA;AACA,QAAM,UAAU,MAAM;AACtB,QAAM,KAAK,UAAU,cAAc,OAAO;AAE1C,SACE,qBAAC,SAAI,WAAW,GAAG,cAAc,SAAS,GACxC;AAAA;AAAA,MAAiB;AAAA,MAAhB;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,WAAU;AAAA,QACT,GAAG;AAAA,QAEJ,8BAAiB,2BAAhB,EAA0B,WAAU,yBAAwB;AAAA;AAAA,IAC/D;AAAA,IACC,SAAS,QACR,oBAAC,WAAM,SAAS,IAAI,WAAU,qBAC3B,iBACH;AAAA,KAEJ;AAEJ,CAAC;","names":["RadioGroup","Radio"]}