sh-ui-cli 0.44.0 → 0.45.1

package/data/changelog/versions.json

@@ -2,6 +2,30 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.45.1",
+      "date": "2026-04-30",
+      "title": "릴리즈 자동화 — `pnpm release` 명령 + mcp.mjs 동적 버전",
+      "type": "patch",
+      "highlights": [
+        "**`pnpm release <patch|minor|major|X.Y.Z>` 명령 신설** — packages/cli/package.json 의 version 갱신 + packages/changelog/versions.json 에 placeholder 엔트리 prepend 를 한 번에 처리. 매 릴리즈 6단계 수작업 → highlights 채우기 + git/PR/merge/tag 6 명령으로 단순화. 거꾸로 가는 버전·중복 엔트리·잘못된 형식 인자는 모두 거부.",
+        "**MCP 서버 버전 동적 읽기** — `packages/cli/src/mcp.mjs` 가 시작 시점에 package.json 의 version 을 읽도록 변경. 하드코딩된 `version: \"X.Y.Z\"` 문자열 제거 — 매 릴리즈마다 손으로 갱신할 필요 영구 사라짐 (실제로 v0.45.0 출고 시 거의 빠뜨릴 뻔한 drift 위험을 잡은 변경).",
+        "기능 변경 0 — 릴리즈 워크플로 신뢰성만 향상."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.45.1"
+    },
+    {
+      "version": "0.45.0",
+      "date": "2026-04-30",
+      "title": "Tailwind 변종 100% 커버리지 — 11 컴포넌트 추가로 전체 완성",
+      "type": "minor",
+      "highlights": [
+        "**나머지 11 컴포넌트 Tailwind 변종 추가** — calendar, carousel, color-picker, file-upload, toast, header, sidebar, form, code-editor, markdown-editor, rich-text-editor. 이제 `cssFramework: \"tailwind\"` 로 만든 프로젝트는 모든 styled 컴포넌트가 utility-class 변종으로 설치 — fallback 알림이 더 이상 발생하지 않음.",
+        "**form 멀티파일 변종** — `index.tailwind.tsx` + `form.tailwind.tsx` + `field.tailwind.tsx` 세 파일이 함께 카피되어 sub-component(Field, Section, Error 등) 모두 utility-class. registry.json 의 file-단위 frameworks 분기가 멀티파일 컴포넌트도 깔끔하게 처리.",
+        "**editor 컴포넌트의 descendant 스타일 처리** — code-editor (CodeMirror `.cm-*`), markdown-editor (react-markdown 렌더 트리), rich-text-editor (Tiptap `.ProseMirror`) 는 3rd-party 라이브러리 자식 element 에 직접 CSS 가 필요 — outer wrapper 만 utility class 로 변환하고 descendant 규칙은 컴포넌트 모듈이 한 번 inject 하는 패턴 (`<style>` 태그). 토큰은 동일하게 사용해 테마 자동 추종."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.45.0"
+    },
     {
       "version": "0.44.0",
       "date": "2026-04-30",

package/data/registry/react/components/calendar/index.tailwind.tsx

@@ -0,0 +1,498 @@
+"use client";
+
+import * as React from "react";
+import { Select, SelectContent, SelectItem, SelectTrigger } from "../select";
+
+function cx(...args: (string | undefined | false)[]) {
+  return args.filter(Boolean).join(" ");
+}
+
+const DEFAULT_WEEKDAYS_KO = ["일", "월", "화", "수", "목", "금", "토"] as const;
+
+const isSameDay = (a: Date, b: Date) =>
+  a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+const toDateOnly = (d: Date) => new Date(d.getFullYear(), d.getMonth(), d.getDate());
+const startOfMonth = (d: Date) => new Date(d.getFullYear(), d.getMonth(), 1);
+const addMonths = (d: Date, n: number) => new Date(d.getFullYear(), d.getMonth() + n, 1);
+const formatIsoDate = (d: Date) =>
+  `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+const defaultMonthLabel = (year: number, month: number) => `${year}년 ${month + 1}월`;
+
+function getDaysGrid(year: number, month: number, weekStartsOn: 0 | 1) {
+  const first = new Date(year, month, 1);
+  const startDay = (first.getDay() - weekStartsOn + 7) % 7;
+  const daysInMonth = new Date(year, month + 1, 0).getDate();
+  const prevDays = new Date(year, month, 0).getDate();
+  const cells: { date: Date; current: boolean }[] = [];
+  for (let i = startDay - 1; i >= 0; i--) cells.push({ date: new Date(year, month - 1, prevDays - i), current: false });
+  for (let d = 1; d <= daysInMonth; d++) cells.push({ date: new Date(year, month, d), current: true });
+  const remaining = 7 - (cells.length % 7);
+  if (remaining < 7) {
+    for (let d = 1; d <= remaining; d++) cells.push({ date: new Date(year, month + 1, d), current: false });
+  }
+  return cells;
+}
+
+function rotateWeekdays(labels: readonly string[], weekStartsOn: 0 | 1): string[] {
+  if (weekStartsOn === 0) return [...labels];
+  return [...labels.slice(weekStartsOn), ...labels.slice(0, weekStartsOn)];
+}
+
+export interface DateRange { from: Date; to: Date; }
+export type CalendarMode = "single" | "multiple" | "range";
+
+interface CalendarCommonProps {
+  month?: Date; defaultMonth?: Date;
+  onMonthChange?: (month: Date) => void;
+  numberOfMonths?: number;
+  min?: Date; max?: Date;
+  disabled?: (date: Date) => boolean;
+  showOutsideDays?: boolean;
+  weekStartsOn?: 0 | 1;
+  weekdayLabels?: readonly string[];
+  formatMonthLabel?: (year: number, month: number) => string;
+  fromYear?: number; toYear?: number;
+  className?: string;
+  "aria-label"?: string;
+  children?: React.ReactNode;
+}
+
+export type CalendarSingleProps = CalendarCommonProps & {
+  mode?: "single"; value?: Date; defaultValue?: Date; onValueChange?: (date: Date | undefined) => void;
+};
+export type CalendarMultipleProps = CalendarCommonProps & {
+  mode: "multiple"; value?: Date[]; defaultValue?: Date[]; onValueChange?: (dates: Date[]) => void;
+};
+export type CalendarRangeProps = CalendarCommonProps & {
+  mode: "range"; value?: DateRange; defaultValue?: DateRange; onValueChange?: (range: DateRange | undefined) => void;
+};
+export type CalendarProps = CalendarSingleProps | CalendarMultipleProps | CalendarRangeProps;
+
+function ChevronLeftIcon() {
+  return <svg viewBox="0 0 16 16" width="16" height="16" fill="none" aria-hidden><path d="M10 3 5.5 8 10 13" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+function ChevronRightIcon() {
+  return <svg viewBox="0 0 16 16" width="16" height="16" fill="none" aria-hidden><path d="M6 3 10.5 8 6 13" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+function ChevronDoubleLeftIcon() {
+  return <svg viewBox="0 0 16 16" width="16" height="16" fill="none" aria-hidden><path d="M8 3 3.5 8 8 13M13 3 8.5 8 13 13" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+function ChevronDoubleRightIcon() {
+  return <svg viewBox="0 0 16 16" width="16" height="16" fill="none" aria-hidden><path d="M3 3 7.5 8 3 13M8 3 12.5 8 8 13" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" /></svg>;
+}
+
+interface CalendarContextValue {
+  visibleMonth: Date;
+  monthIndex: number;
+  monthsLength: number;
+  yearOptions: number[];
+  setYearForVisible: (y: number) => void;
+  setMonthForVisible: (m: number) => void;
+  prevMonth: () => void; nextMonth: () => void;
+  prevYear: () => void; nextYear: () => void;
+  weekStartsOn: 0 | 1;
+  weekdayLabels: string[];
+  showOutsideDays: boolean;
+  formatMonthLabel: (year: number, month: number) => string;
+  ariaLabel?: string;
+  isSelected: (date: Date) => boolean;
+  isInRange: (date: Date) => { inRange: boolean; isStart: boolean; isEnd: boolean };
+  isDisabled: (date: Date) => boolean;
+  handleSelect: (date: Date) => void;
+  setHoverDate: (date: Date | undefined) => void;
+  onKeyDown: (e: React.KeyboardEvent) => void;
+  isFirstMonth: boolean;
+  isLastMonth: boolean;
+}
+
+const CalendarContext = React.createContext<CalendarContextValue | null>(null);
+
+function useCalendarContext(component: string) {
+  const ctx = React.useContext(CalendarContext);
+  if (!ctx) throw new Error(`${component}는 <Calendar> 내부에서 사용해야 합니다.`);
+  return ctx;
+}
+
+export function Calendar(props: CalendarProps) {
+  const {
+    mode = "single", month: monthProp, defaultMonth, onMonthChange,
+    numberOfMonths: numberOfMonthsProp = 1,
+    min, max, disabled, showOutsideDays = true, weekStartsOn = 0,
+    weekdayLabels: weekdayLabelsProp,
+    formatMonthLabel = defaultMonthLabel,
+    fromYear, toYear, className, "aria-label": ariaLabel, children,
+  } = props as CalendarCommonProps & { mode?: CalendarMode };
+
+  const numberOfMonths = children ? 1 : Math.max(1, numberOfMonthsProp);
+
+  const isControlled = "value" in props && props.value !== undefined;
+  const [internalSingle, setInternalSingle] = React.useState<Date | undefined>(
+    mode === "single" ? (props as CalendarSingleProps).defaultValue : undefined,
+  );
+  const [internalMultiple, setInternalMultiple] = React.useState<Date[]>(
+    mode === "multiple" ? (props as CalendarMultipleProps).defaultValue ?? [] : [],
+  );
+  const [internalRange, setInternalRange] = React.useState<DateRange | undefined>(
+    mode === "range" ? (props as CalendarRangeProps).defaultValue : undefined,
+  );
+
+  const singleValue = isControlled ? (props as CalendarSingleProps).value : internalSingle;
+  const multipleValue = isControlled ? (props as CalendarMultipleProps).value ?? [] : internalMultiple;
+  const rangeValue = isControlled ? (props as CalendarRangeProps).value : internalRange;
+
+  const [picking, setPicking] = React.useState<Date | undefined>(undefined);
+  const [hoverDate, setHoverDate] = React.useState<Date | undefined>(undefined);
+
+  const monthControlled = monthProp !== undefined;
+  const [internalMonth, setInternalMonth] = React.useState<Date>(() => {
+    if (defaultMonth) return startOfMonth(defaultMonth);
+    if (mode === "single" && singleValue) return startOfMonth(singleValue);
+    if (mode === "multiple" && multipleValue.length > 0) return startOfMonth(multipleValue[0]);
+    if (mode === "range" && rangeValue?.from) return startOfMonth(rangeValue.from);
+    return startOfMonth(new Date());
+  });
+  const currentMonth = monthControlled ? startOfMonth(monthProp!) : internalMonth;
+
+  const setMonth = React.useCallback((next: Date) => {
+    const normalized = startOfMonth(next);
+    if (!monthControlled) setInternalMonth(normalized);
+    onMonthChange?.(normalized);
+  }, [monthControlled, onMonthChange]);
+
+  const [focusedDate, setFocusedDate] = React.useState<Date>(() => {
+    if (mode === "single" && singleValue) return singleValue;
+    if (mode === "range" && rangeValue?.from) return rangeValue.from;
+    return new Date();
+  });
+
+  const weekdayLabels = React.useMemo(() => {
+    const base = weekdayLabelsProp ?? DEFAULT_WEEKDAYS_KO;
+    return rotateWeekdays(base, weekStartsOn);
+  }, [weekdayLabelsProp, weekStartsOn]);
+
+  const nowYear = new Date().getFullYear();
+  const resolvedFromYear = fromYear ?? min?.getFullYear() ?? nowYear - 10;
+  const resolvedToYear = toYear ?? max?.getFullYear() ?? nowYear + 10;
+  const yearOptions = React.useMemo(() => {
+    const out: number[] = [];
+    const start = Math.min(resolvedFromYear, resolvedToYear);
+    const end = Math.max(resolvedFromYear, resolvedToYear);
+    for (let y = start; y <= end; y++) out.push(y);
+    return out;
+  }, [resolvedFromYear, resolvedToYear]);
+
+  const isDateDisabled = React.useCallback((date: Date) => {
+    const d = toDateOnly(date);
+    if (min && d < toDateOnly(min)) return true;
+    if (max && d > toDateOnly(max)) return true;
+    if (disabled?.(date)) return true;
+    return false;
+  }, [min, max, disabled]);
+
+  const isDateSelected = React.useCallback((date: Date) => {
+    if (mode === "single") return !!singleValue && isSameDay(date, singleValue);
+    if (mode === "multiple") return multipleValue.some((d) => isSameDay(d, date));
+    if (mode === "range") {
+      if (picking) return isSameDay(date, picking);
+      if (rangeValue?.from && isSameDay(date, rangeValue.from)) return true;
+      if (rangeValue?.to && isSameDay(date, rangeValue.to)) return true;
+      return false;
+    }
+    return false;
+  }, [mode, singleValue, multipleValue, rangeValue, picking]);
+
+  const getRangeState = React.useCallback((date: Date) => {
+    if (mode !== "range") return { inRange: false, isStart: false, isEnd: false };
+    const from = picking ?? rangeValue?.from;
+    if (!from) return { inRange: false, isStart: false, isEnd: false };
+    const to = picking ? hoverDate : rangeValue?.to;
+    if (!to) return { inRange: false, isStart: isSameDay(date, from), isEnd: false };
+    const [rStart, rEnd] = from <= to ? [from, to] : [to, from];
+    const s = toDateOnly(rStart);
+    const e = toDateOnly(rEnd);
+    const d = toDateOnly(date);
+    return { inRange: d >= s && d <= e, isStart: isSameDay(d, s), isEnd: isSameDay(d, e) };
+  }, [mode, picking, hoverDate, rangeValue]);
+
+  const handleSelect = React.useCallback((date: Date) => {
+    if (mode === "single") {
+      if (!isControlled) setInternalSingle(date);
+      (props as CalendarSingleProps).onValueChange?.(date);
+      return;
+    }
+    if (mode === "multiple") {
+      const exists = multipleValue.some((d) => isSameDay(d, date));
+      const next = exists ? multipleValue.filter((d) => !isSameDay(d, date)) : [...multipleValue, date];
+      if (!isControlled) setInternalMultiple(next);
+      (props as CalendarMultipleProps).onValueChange?.(next);
+      return;
+    }
+    if (mode === "range") {
+      if (!picking) { setPicking(date); return; }
+      const [from, to] = picking <= date ? [picking, date] : [date, picking];
+      const range: DateRange = { from, to };
+      setPicking(undefined); setHoverDate(undefined);
+      if (!isControlled) setInternalRange(range);
+      (props as CalendarRangeProps).onValueChange?.(range);
+    }
+  }, [mode, isControlled, multipleValue, picking, props]);
+
+  const handleKeyDown = React.useCallback((e: React.KeyboardEvent) => {
+    let next: Date | null = null;
+    const cursor = focusedDate;
+    switch (e.key) {
+      case "ArrowLeft": next = new Date(cursor.getFullYear(), cursor.getMonth(), cursor.getDate() - 1); break;
+      case "ArrowRight": next = new Date(cursor.getFullYear(), cursor.getMonth(), cursor.getDate() + 1); break;
+      case "ArrowUp": next = new Date(cursor.getFullYear(), cursor.getMonth(), cursor.getDate() - 7); break;
+      case "ArrowDown": next = new Date(cursor.getFullYear(), cursor.getMonth(), cursor.getDate() + 7); break;
+      case "PageUp": next = new Date(cursor.getFullYear(), cursor.getMonth() - 1, cursor.getDate()); break;
+      case "PageDown": next = new Date(cursor.getFullYear(), cursor.getMonth() + 1, cursor.getDate()); break;
+      case "Home": next = new Date(cursor.getFullYear(), cursor.getMonth(), 1); break;
+      case "End": next = new Date(cursor.getFullYear(), cursor.getMonth() + 1, 0); break;
+      case "Enter":
+      case " ":
+        e.preventDefault();
+        if (!isDateDisabled(cursor)) handleSelect(cursor);
+        return;
+      default: return;
+    }
+    e.preventDefault();
+    if (!next || isDateDisabled(next)) return;
+    setFocusedDate(next);
+    const visibleEnd = addMonths(currentMonth, numberOfMonths - 1);
+    if (next < currentMonth) setMonth(addMonths(currentMonth, -1));
+    else if (next > new Date(visibleEnd.getFullYear(), visibleEnd.getMonth() + 1, 0)) setMonth(addMonths(currentMonth, 1));
+  }, [focusedDate, isDateDisabled, handleSelect, currentMonth, numberOfMonths, setMonth]);
+
+  const months = Array.from({ length: numberOfMonths }, (_, i) => addMonths(currentMonth, i));
+
+  const buildMonthContext = (visibleMonth: Date, idx: number): CalendarContextValue => ({
+    visibleMonth, monthIndex: idx, monthsLength: numberOfMonths, yearOptions,
+    setYearForVisible: (y) => {
+      const yearDiff = y - visibleMonth.getFullYear();
+      setMonth(new Date(currentMonth.getFullYear() + yearDiff, currentMonth.getMonth(), 1));
+    },
+    setMonthForVisible: (m) => setMonth(addMonths(currentMonth, m - visibleMonth.getMonth())),
+    prevMonth: () => setMonth(addMonths(currentMonth, -1)),
+    nextMonth: () => setMonth(addMonths(currentMonth, 1)),
+    prevYear: () => setMonth(addMonths(currentMonth, -12)),
+    nextYear: () => setMonth(addMonths(currentMonth, 12)),
+    weekStartsOn, weekdayLabels, showOutsideDays, formatMonthLabel, ariaLabel,
+    isSelected: isDateSelected, isInRange: getRangeState, isDisabled: isDateDisabled,
+    handleSelect,
+    setHoverDate: mode === "range" ? setHoverDate : () => {},
+    onKeyDown: handleKeyDown,
+    isFirstMonth: idx === 0, isLastMonth: idx === numberOfMonths - 1,
+  });
+
+  return (
+    <div
+      className={cx("inline-flex gap-[var(--space-4)] select-none", numberOfMonths > 1 && "flex-wrap", className)}
+      aria-label={ariaLabel}
+    >
+      {children
+        ? <CalendarContext.Provider value={buildMonthContext(months[0], 0)}>{children}</CalendarContext.Provider>
+        : months.map((m, idx) => (
+          <CalendarContext.Provider key={`${m.getFullYear()}-${m.getMonth()}`} value={buildMonthContext(m, idx)}>
+            <div className="w-[17.5rem]">
+              <CalendarHeader>
+                {idx === 0 ? <CalendarPrevYearButton /> : <CalendarNavPlaceholder />}
+                {idx === 0 ? <CalendarPrevMonthButton /> : <CalendarNavPlaceholder />}
+                <div className="inline-flex items-center gap-[var(--space-1)] flex-1 justify-center">
+                  <CalendarYearSelect />
+                  <CalendarMonthSelect />
+                </div>
+                {idx === months.length - 1 ? <CalendarNextMonthButton /> : <CalendarNavPlaceholder />}
+                {idx === months.length - 1 ? <CalendarNextYearButton /> : <CalendarNavPlaceholder />}
+              </CalendarHeader>
+              <CalendarGrid />
+            </div>
+          </CalendarContext.Provider>
+        ))}
+    </div>
+  );
+}
+
+export interface CalendarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {}
+export const CalendarHeader = React.forwardRef<HTMLDivElement, CalendarHeaderProps>(
+  function CalendarHeader({ className, ...props }, ref) {
+    return <div ref={ref} className={cx("flex items-center justify-between gap-[var(--space-1)] mb-[var(--space-2)]", className)} {...props} />;
+  },
+);
+
+const navButtonClasses =
+  "inline-flex items-center justify-center w-7 h-7 p-0 border-none rounded-[calc(var(--radius)-2px)] bg-transparent text-foreground-muted cursor-pointer shrink-0 transition-[background-color,color] duration-[var(--duration-fast)] hover:not-disabled:bg-background-muted hover:not-disabled:text-foreground focus-visible:outline-[length:var(--border-width-strong)] focus-visible:outline-foreground focus-visible:outline-offset-2 motion-reduce:transition-none";
+
+function CalendarNavPlaceholder() {
+  return <span className={cx(navButtonClasses, "invisible pointer-events-none")} aria-hidden />;
+}
+
+export interface CalendarNavButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
+  children?: React.ReactNode;
+}
+
+function makeNavButton(
+  displayName: string,
+  defaultIcon: React.ReactNode,
+  defaultLabel: string,
+  resolveHandler: (ctx: CalendarContextValue) => () => void,
+) {
+  const Component = React.forwardRef<HTMLButtonElement, CalendarNavButtonProps>(
+    function NavButton({ className, children, "aria-label": ariaLabel, onClick, ...props }, ref) {
+      const ctx = useCalendarContext(displayName);
+      return (
+        <button
+          ref={ref}
+          type="button"
+          className={cx(navButtonClasses, className)}
+          aria-label={ariaLabel ?? defaultLabel}
+          onClick={(e) => { resolveHandler(ctx)(); onClick?.(e); }}
+          {...props}
+        >
+          {children ?? defaultIcon}
+        </button>
+      );
+    },
+  );
+  Component.displayName = displayName;
+  return Component;
+}
+
+export const CalendarPrevYearButton = makeNavButton("CalendarPrevYearButton", <ChevronDoubleLeftIcon />, "이전 해", (ctx) => ctx.prevYear);
+export const CalendarNextYearButton = makeNavButton("CalendarNextYearButton", <ChevronDoubleRightIcon />, "다음 해", (ctx) => ctx.nextYear);
+export const CalendarPrevMonthButton = makeNavButton("CalendarPrevMonthButton", <ChevronLeftIcon />, "이전 달", (ctx) => ctx.prevMonth);
+export const CalendarNextMonthButton = makeNavButton("CalendarNextMonthButton", <ChevronRightIcon />, "다음 달", (ctx) => ctx.nextMonth);
+
+const calendarSelectTriggerClasses =
+  "min-w-0 h-7 gap-[var(--space-1)] px-[var(--space-2)] bg-transparent border-transparent font-semibold text-[length:var(--text-sm)] text-foreground hover:not-disabled:bg-background-muted hover:not-disabled:border-transparent data-[popup-open]:bg-background-muted data-[popup-open]:border-transparent";
+
+export interface CalendarYearSelectProps {
+  className?: string;
+  formatYear?: (year: number) => string;
+}
+
+export function CalendarYearSelect({ className, formatYear = (y) => `${y}년` }: CalendarYearSelectProps) {
+  const ctx = useCalendarContext("CalendarYearSelect");
+  const year = ctx.visibleMonth.getFullYear();
+  const items = ctx.yearOptions.includes(year) ? ctx.yearOptions : [...ctx.yearOptions, year].sort((a, b) => a - b);
+  return (
+    <Select value={String(year)} onValueChange={(v) => ctx.setYearForVisible(Number(v))}>
+      <SelectTrigger className={cx(calendarSelectTriggerClasses, className)} aria-label="연도">
+        <span>{formatYear(year)}</span>
+      </SelectTrigger>
+      <SelectContent>
+        {items.map((y) => <SelectItem key={y} value={String(y)}>{formatYear(y)}</SelectItem>)}
+      </SelectContent>
+    </Select>
+  );
+}
+
+export interface CalendarMonthSelectProps {
+  className?: string;
+  formatMonth?: (month: number) => string;
+}
+
+export function CalendarMonthSelect({ className, formatMonth = (m) => `${m + 1}월` }: CalendarMonthSelectProps) {
+  const ctx = useCalendarContext("CalendarMonthSelect");
+  const month = ctx.visibleMonth.getMonth();
+  return (
+    <Select value={String(month)} onValueChange={(v) => ctx.setMonthForVisible(Number(v))}>
+      <SelectTrigger className={cx(calendarSelectTriggerClasses, className)} aria-label="월">
+        <span>{formatMonth(month)}</span>
+      </SelectTrigger>
+      <SelectContent>
+        {Array.from({ length: 12 }, (_, m) => <SelectItem key={m} value={String(m)}>{formatMonth(m)}</SelectItem>)}
+      </SelectContent>
+    </Select>
+  );
+}
+
+export interface CalendarGridProps extends React.HTMLAttributes<HTMLDivElement> {}
+
+export const CalendarGrid = React.forwardRef<HTMLDivElement, CalendarGridProps>(
+  function CalendarGrid({ className, ...rest }, ref) {
+    const ctx = useCalendarContext("CalendarGrid");
+    const year = ctx.visibleMonth.getFullYear();
+    const month = ctx.visibleMonth.getMonth();
+    const cells = getDaysGrid(year, month, ctx.weekStartsOn);
+    const today = new Date();
+    const monthLabel = ctx.formatMonthLabel(year, month);
+    const ariaLabel = ctx.ariaLabel ?? monthLabel;
+
+    return (
+      <div ref={ref} className={cx("", className)} {...rest}>
+        <div className="grid grid-cols-7 mb-[var(--space-1)]" role="row">
+          {ctx.weekdayLabels.map((label) => (
+            <span key={label} className="flex items-center justify-center h-8 text-[length:var(--text-xs)] font-medium text-foreground-muted" role="columnheader" aria-label={label}>
+              {label}
+            </span>
+          ))}
+        </div>
+        <div
+          className="grid grid-cols-7 outline-none focus-visible:outline-[length:var(--border-width-strong)] focus-visible:outline-foreground focus-visible:outline-offset-2 focus-visible:rounded-[calc(var(--radius)-2px)]"
+          role="grid"
+          tabIndex={0}
+          onKeyDown={ctx.onKeyDown}
+          aria-label={ariaLabel}
+        >
+          {cells.map(({ date, current }, i) => {
+            const dDisabled = ctx.isDisabled(date);
+            const selected = ctx.isSelected(date);
+            const isToday = isSameDay(date, today);
+            const { inRange, isStart, isEnd } = ctx.isInRange(date);
+            const hidden = !current && !ctx.showOutsideDays;
+            if (hidden) return <span key={i} className="flex items-center justify-center w-full h-[2.375rem] min-w-0" aria-hidden />;
+
+            const cellRangeBg = (inRange || isStart || isEnd) ? "bg-[color-mix(in_srgb,var(--primary)_12%,transparent)]" : "";
+            const cellRangeRadius =
+              isStart && !isEnd ? "rounded-l-[calc(var(--radius)-2px)]" :
+              isEnd && !isStart ? "rounded-r-[calc(var(--radius)-2px)]" :
+              isStart && isEnd ? "rounded-[calc(var(--radius)-2px)]" : "";
+
+            return (
+              <div key={i} className={cx("flex items-center justify-center w-full h-[2.375rem] min-w-0", cellRangeBg, cellRangeRadius)}>
+                <button
+                  type="button"
+                  className={cx(
+                    "flex items-center justify-center w-9 h-9 p-0 border-none rounded-[calc(var(--radius)-2px)] bg-transparent text-foreground text-[0.8125rem] font-[inherit] cursor-pointer transition-[background-color,color] duration-[var(--duration-fast)] hover:not-disabled:bg-background-muted focus-visible:outline-[length:var(--border-width-strong)] focus-visible:outline-foreground focus-visible:outline-offset-2 disabled:opacity-30 disabled:cursor-not-allowed motion-reduce:transition-none",
+                    !current && "text-[var(--foreground-subtle,var(--foreground-muted))] opacity-40",
+                    isToday && "font-bold underline underline-offset-[0.125rem]",
+                    selected && "bg-primary text-primary-foreground font-semibold hover:not-disabled:bg-primary-hover hover:not-disabled:text-primary-foreground",
+                  )}
+                  disabled={dDisabled}
+                  tabIndex={-1}
+                  onClick={() => { if (!dDisabled) ctx.handleSelect(date); }}
+                  onMouseEnter={() => ctx.setHoverDate(date)}
+                  onMouseLeave={() => ctx.setHoverDate(undefined)}
+                  aria-label={formatIsoDate(date)}
+                  aria-selected={selected || inRange || undefined}
+                  data-today={isToday || undefined}
+                >
+                  {date.getDate()}
+                </button>
+              </div>
+            );
+          })}
+        </div>
+      </div>
+    );
+  },
+);
+
+export function useCalendar() {
+  const ctx = useCalendarContext("useCalendar");
+  return {
+    visibleMonth: ctx.visibleMonth,
+    monthIndex: ctx.monthIndex,
+    monthsLength: ctx.monthsLength,
+    setYear: ctx.setYearForVisible,
+    setMonth: ctx.setMonthForVisible,
+    prevMonth: ctx.prevMonth,
+    nextMonth: ctx.nextMonth,
+    prevYear: ctx.prevYear,
+    nextYear: ctx.nextYear,
+    yearOptions: ctx.yearOptions,
+    isFirstMonth: ctx.isFirstMonth,
+    isLastMonth: ctx.isLastMonth,
+  };
+}