sh-ui-cli 0.45.3 → 0.47.0

package/data/registry/react/components/popover/index.module.tsx

@@ -0,0 +1,113 @@
+import * as React from "react";
+import { Popover as BasePopover } from "@base-ui/react/popover";
+import styles from "./styles.module.css";
+
+import { cn } from "@SH_UI_UTILS@";
+type WithStringClassName<T> = Omit<T, "className"> & { className?: string };
+
+
+/**
+ * 트리거 요소에 떠다니는 가벼운 패널을 띄우는 비모달 컨테이너. 포커스를 가두지 않으므로
+ * 짧은 폼·정보 표시에 적합하고, 강제 응답이 필요하면 Dialog를 사용할 것.
+ */
+export const Popover = BasePopover.Root;
+
+/** Popover를 여는 트리거. */
+export const PopoverTrigger = BasePopover.Trigger;
+
+/** Popover를 닫는 요소. */
+export const PopoverClose = BasePopover.Close;
+
+export interface PopoverContentProps
+  extends WithStringClassName<React.ComponentPropsWithoutRef<typeof BasePopover.Popup>> {
+  /**
+   * Trigger 기준 배치 방향. 공간 부족 시 자동으로 반대편으로 뒤집힌다.
+   * @default "bottom"
+   */
+  side?: "top" | "right" | "bottom" | "left";
+  /**
+   * 트리거 축에서의 정렬.
+   * - `start` — 트리거 시작 가장자리 정렬
+   * - `center` — 가운데 (기본)
+   * - `end` — 트리거 끝 가장자리 정렬
+   *
+   * @default "center"
+   */
+  align?: "start" | "center" | "end";
+  /**
+   * Trigger와 Popup 사이 간격(px).
+   * @default 8
+   */
+  sideOffset?: number;
+  /**
+   * Portal이 마운트될 DOM 노드.
+   * @default document.body
+   */
+  container?: React.ComponentPropsWithoutRef<typeof BasePopover.Portal>["container"];
+  /**
+   * Trigger를 가리키는 화살표 표시 여부.
+   * @default false
+   */
+  showArrow?: boolean;
+}
+
+/**
+ * Popover의 콘텐츠. 트리거에 자동 위치 조정되어 portal로 마운트된다.
+ * `side`/`align`/`sideOffset`로 배치를 미세조정하고, `showArrow`로 화살표를 노출한다.
+ */
+export const PopoverContent = React.forwardRef<HTMLDivElement, PopoverContentProps>(
+  function PopoverContent(
+    { className, children, side, align, sideOffset = 8, container, showArrow, ...props },
+    ref,
+  ) {
+    return (
+      <BasePopover.Portal container={container}>
+        <BasePopover.Positioner
+          className={styles.popover__positioner}
+          side={side}
+          align={align}
+          sideOffset={sideOffset}
+        >
+          <BasePopover.Popup
+            ref={ref}
+            className={cn(styles.popover__content, className)}
+            {...props}
+          >
+            {showArrow && (
+              <BasePopover.Arrow className={styles.popover__arrow} />
+            )}
+            {children}
+          </BasePopover.Popup>
+        </BasePopover.Positioner>
+      </BasePopover.Portal>
+    );
+  },
+);
+
+/** Popover 콘텐츠의 제목. 접근성을 위해 짧은 제목이라도 함께 두는 것을 권장. */
+export const PopoverTitle = React.forwardRef<
+  HTMLHeadingElement,
+  WithStringClassName<React.ComponentPropsWithoutRef<typeof BasePopover.Title>>
+>(function PopoverTitle({ className, ...props }, ref) {
+  return (
+    <BasePopover.Title
+      ref={ref}
+      className={cn(styles.popover__title, className)}
+      {...props}
+    />
+  );
+});
+
+/** Popover 콘텐츠의 보조 설명. */
+export const PopoverDescription = React.forwardRef<
+  HTMLParagraphElement,
+  WithStringClassName<React.ComponentPropsWithoutRef<typeof BasePopover.Description>>
+>(function PopoverDescription({ className, ...props }, ref) {
+  return (
+    <BasePopover.Description
+      ref={ref}
+      className={cn(styles.popover__description, className)}
+      {...props}
+    />
+  );
+});

package/data/registry/react/components/popover/styles.module.css

@@ -0,0 +1,65 @@
+.popover__positioner {
+  z-index: var(--z-popover);
+  outline: none;
+}
+
+.popover__content {
+  min-width: 12rem;
+  padding: var(--space-2);
+  background: var(--background);
+  color: var(--foreground);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+  outline: none;
+  font-size: var(--text-sm);
+  line-height: 1.4;
+  transform-origin: var(--transform-origin);
+}
+
+.popover__content[data-starting-style],
+.popover__content[data-ending-style] {
+  opacity: 0;
+  transform: scale(0.96);
+}
+
+.popover__content {
+  transition:
+    opacity 140ms ease,
+    transform 140ms ease;
+}
+
+.popover__content:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+
+.popover__arrow {
+  color: var(--background);
+}
+
+.popover__arrow svg {
+  display: block;
+}
+
+.popover__title {
+  margin: 0 0 var(--space-1);
+  font-weight: var(--weight-semibold);
+  font-size: 0.9375rem;
+}
+
+.popover__description {
+  margin: 0;
+  color: var(--foreground-muted);
+  font-size: 0.8125rem;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .popover__content {
+    transition: none;
+  }
+  .popover__content[data-starting-style],
+  .popover__content[data-ending-style] {
+    transform: none;
+  }
+}

package/data/registry/react/components/progress/index.module.tsx

@@ -0,0 +1,54 @@
+import * as React from "react";
+import styles from "./styles.module.css";
+
+
+import { cn } from "@SH_UI_UTILS@";
+function clamp(n: number, min: number, max: number) {
+  return Math.min(max, Math.max(min, n));
+}
+
+export interface ProgressProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "role"> {
+  /** 0~100 사이의 현재 값. 생략 시 indeterminate 모드. */
+  value?: number;
+  /** 최댓값. 기본 100. */
+  max?: number;
+  /** 접근성: aria-label (시각적 라벨이 없으면 권장). */
+  "aria-label"?: string;
+}
+
+/**
+ * 작업 진행도를 가로 바로 표시. value가 없으면 무한 루프 indeterminate.
+ *
+ * - determinate: `<Progress value={40} />`
+ * - indeterminate: `<Progress aria-label="로딩 중" />`
+ */
+export const Progress = React.forwardRef<HTMLDivElement, ProgressProps>(
+  function Progress(
+    { value, max = 100, className, "aria-label": ariaLabel, ...props },
+    ref,
+  ) {
+    const isDeterminate = value !== undefined;
+    const normalized = isDeterminate ? clamp((value / max) * 100, 0, 100) : 0;
+
+    return (
+      <div
+        ref={ref}
+        role="progressbar"
+        aria-label={ariaLabel}
+        aria-valuemin={isDeterminate ? 0 : undefined}
+        aria-valuemax={isDeterminate ? max : undefined}
+        aria-valuenow={isDeterminate ? value : undefined}
+        data-state={isDeterminate ? "determinate" : "indeterminate"}
+        className={cn(styles.progress, className)}
+        {...props}
+      >
+        <div
+          className={styles.progress__indicator}
+          style={isDeterminate ? { width: `${normalized}%` } : undefined}
+        />
+      </div>
+    );
+  },
+);
+Progress.displayName = "Progress";

package/data/registry/react/components/progress/styles.module.css

@@ -0,0 +1,41 @@
+.progress {
+  position: relative;
+  width: 100%;
+  height: 0.5rem;
+  overflow: hidden;
+  background: var(--background-muted);
+  border-radius: 999px;
+}
+
+.progress__indicator {
+  height: 100%;
+  background: var(--primary);
+  border-radius: 999px;
+  transition: width var(--duration-base) ease;
+}
+
+/* indeterminate 모드: 바가 좌우로 왕복 */
+.progress[data-state="indeterminate"] .progress__indicator {
+  width: 40%;
+  animation: sh-ui-progress-slide 1.2s ease-in-out infinite;
+}
+
+@keyframes sh-ui-progress-slide {
+  0% {
+    transform: translateX(-100%);
+  }
+  100% {
+    transform: translateX(250%);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .progress__indicator {
+    transition: none;
+  }
+  .progress[data-state="indeterminate"] .progress__indicator {
+    /* 움직임 최소화 — 중앙에 정지된 바 */
+    animation: none;
+    transform: translateX(75%);
+  }
+}

package/data/registry/react/components/radio/index.module.tsx

@@ -0,0 +1,65 @@
+import * as React from "react";
+import { Radio as BaseRadio } from "@base-ui/react/radio";
+import { RadioGroup as BaseRadioGroup } from "@base-ui/react/radio-group";
+import styles from "./styles.module.css";
+
+
+import { cn } from "@SH_UI_UTILS@";
+/* ───────────── Radio ───────────── */
+
+export type RadioProps = Omit<
+  React.ComponentPropsWithoutRef<typeof BaseRadio.Root>,
+  "className"
+> & {
+  className?: string;
+};
+
+/**
+ * 단일 선택지. 단독으로 쓰지 않고 반드시 `RadioGroup` 안에 두 개 이상을 묶어 사용한다.
+ * 단일 선택이지만 즉시 적용되는 설정에는 Switch를, 다중 선택에는 Checkbox를 권장.
+ */
+export const Radio = React.forwardRef<HTMLElement, RadioProps>(
+  ({ className, ...props }, ref) => (
+    <BaseRadio.Root
+      ref={ref}
+      className={cn(styles.radio, className)}
+      {...props}
+    >
+      <BaseRadio.Indicator className={styles.radio__indicator} />
+    </BaseRadio.Root>
+  ),
+);
+Radio.displayName = "Radio";
+
+/* ───────────── RadioGroup ───────────── */
+
+export type RadioGroupProps = Omit<
+  React.ComponentPropsWithoutRef<typeof BaseRadioGroup>,
+  "className"
+> & {
+  className?: string;
+  /**
+   * 그룹 내 항목 배치 방향.
+   * - `vertical` — 세로 나열 (기본)
+   * - `horizontal` — 가로 나열. 짧은 라벨 2~3개에만 권장
+   *
+   * @default "vertical"
+   */
+  orientation?: "horizontal" | "vertical";
+};
+
+/**
+ * 여러 Radio를 묶는 컨테이너. 같은 `name` 아래 단일 선택을 보장하고,
+ * 키보드 화살표로 항목 간 이동이 가능하다. 그룹 라벨은 외부 `<Label>`로 제공할 것.
+ */
+export const RadioGroup = React.forwardRef<HTMLDivElement, RadioGroupProps>(
+  ({ className, orientation = "vertical", ...props }, ref) => (
+    <BaseRadioGroup
+      ref={ref}
+      className={cn(styles["radio-group"], className)}
+      data-orientation={orientation}
+      {...props}
+    />
+  ),
+);
+RadioGroup.displayName = "RadioGroup";

package/data/registry/react/components/radio/styles.module.css

@@ -0,0 +1,80 @@
+/* ───────────── Radio ───────────── */
+
+.radio {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 1.125rem;
+  height: 1.125rem;
+  border: 1px solid var(--border-strong);
+  border-radius: 999px;
+  background: var(--background);
+  cursor: pointer;
+  flex-shrink: 0;
+  transition: border-color var(--duration-fast);
+  -webkit-tap-highlight-color: transparent;
+}
+
+.radio:hover:not([data-disabled]) {
+  border-color: var(--foreground);
+}
+
+.radio:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+
+.radio[data-checked] {
+  border-color: var(--primary);
+}
+
+.radio[data-disabled] {
+  opacity: var(--opacity-disabled);
+  cursor: not-allowed;
+}
+
+/* 모바일/터치: 최소 탭 영역 */
+@media (hover: none) and (pointer: coarse) {
+  .radio {
+    width: 1.25rem;
+    height: 1.25rem;
+  }
+}
+
+/* ───────────── Indicator (내부 원) ───────────── */
+
+.radio__indicator {
+  width: 0.5rem;
+  height: 0.5rem;
+  border-radius: 999px;
+  background: var(--primary);
+  transform: scale(0);
+  transition: transform var(--duration-fast) ease-out;
+}
+
+.radio[data-checked] .radio__indicator {
+  transform: scale(1);
+}
+
+/* ───────────── RadioGroup ───────────── */
+
+.radio-group {
+  display: flex;
+  gap: 0.625rem;
+}
+
+.radio-group[data-orientation="vertical"] {
+  flex-direction: column;
+}
+
+.radio-group[data-orientation="horizontal"] {
+  flex-direction: row;
+  flex-wrap: wrap;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .radio,
+  .radio__indicator {
+    transition: none;
+  }
+}