sh-ui-cli 0.46.0 → 0.48.0

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

@@ -0,0 +1,502 @@
+/* ───────────── Tokens ───────────── */
+.sidebar-wrapper {
+  --sidebar-width: 16rem;
+  --sidebar-width-icon: 3rem;
+  --sidebar-width-mobile: 18rem;
+  --sidebar-bg: var(--background-subtle);
+  --sidebar-fg: var(--foreground);
+  --sidebar-border: var(--border);
+  --sidebar-accent: var(--background-muted);
+  --sidebar-accent-fg: var(--foreground);
+
+  display: flex;
+  min-height: 100svh;
+  width: 100%;
+}
+
+/* embedded: 문서 데모용 */
+.sidebar-wrapper[data-embedded] {
+  min-height: 0;
+  height: 100%;
+}
+.sidebar-wrapper[data-embedded] .sidebar__inner,
+.sidebar-wrapper[data-embedded] .sidebar--static {
+  height: 100%;
+  position: relative;
+  top: 0;
+}
+.sidebar-wrapper[data-embedded] .sidebar--mobile {
+  position: absolute;
+}
+.sidebar-wrapper[data-embedded] .sidebar__backdrop {
+  position: absolute;
+}
+
+/* ───────────── Sidebar (desktop) ───────────── */
+.sidebar {
+  display: flex;
+  flex-direction: column;
+  width: var(--sidebar-width);
+  flex-shrink: 0;
+  background: var(--sidebar-bg);
+  color: var(--sidebar-fg);
+  border-right: 1px solid var(--sidebar-border);
+  transition: width var(--duration-slow) ease;
+  position: relative;
+  z-index: 5;
+}
+
+.sidebar[data-side="right"] {
+  border-right: none;
+  border-left: 1px solid var(--sidebar-border);
+  order: 1;
+}
+
+.sidebar__inner {
+  display: flex;
+  flex-direction: column;
+  height: 100svh;
+  position: sticky;
+  top: 0;
+  overflow: hidden;
+}
+
+/* collapsed: offcanvas → 0 폭 */
+.sidebar[data-state="collapsed"][data-collapsible="offcanvas"] {
+  width: 0;
+  border-right-width: 0;
+  border-left-width: 0;
+  overflow: hidden;
+}
+
+/* collapsed: icon → 아이콘만 */
+.sidebar[data-state="collapsed"][data-collapsible="icon"] {
+  width: var(--sidebar-width-icon);
+}
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__group-label,
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__menu-button > span,
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__menu-sub {
+  display: none;
+}
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__menu-button {
+  justify-content: center;
+  padding: var(--space-2);
+}
+
+/* variant: floating */
+.sidebar[data-variant="floating"] {
+  border: none;
+  padding: var(--space-2);
+  background: transparent;
+}
+.sidebar[data-variant="floating"] .sidebar__inner {
+  border: 1px solid var(--sidebar-border);
+  border-radius: var(--radius);
+  background: var(--sidebar-bg);
+  height: calc(100svh - 1rem);
+  top: var(--space-2);
+}
+
+/* variant: inset (메인 영역이 카드 형태) */
+.sidebar[data-variant="inset"] {
+  background: transparent;
+  border: none;
+}
+
+/* static (collapsible=none) */
+.sidebar--static {
+  height: 100svh;
+  position: sticky;
+  top: 0;
+}
+
+/* ───────────── Mobile drawer ───────────── */
+.sidebar--mobile {
+  position: fixed;
+  top: 0;
+  bottom: 0;
+  width: var(--sidebar-width-mobile);
+  z-index: var(--z-overlay);
+  transition: transform var(--duration-slow) ease;
+  border-right: 1px solid var(--sidebar-border);
+}
+.sidebar--mobile[data-side="left"] {
+  left: 0;
+  transform: translateX(-100%);
+}
+.sidebar--mobile[data-side="right"] {
+  right: 0;
+  transform: translateX(100%);
+  border-right: none;
+  border-left: 1px solid var(--sidebar-border);
+}
+.sidebar--mobile[data-state="open"] {
+  transform: translateX(0);
+}
+
+.sidebar__backdrop {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.25);
+  /* unprefixed 속성만 사용 — 최신 브라우저(Chrome/Firefox/Safari 18+)는 prefix 불필요.
+     일부 CSS 트랜스포머가 prefix 중복 선언을 드롭하는 이슈를 피하기 위해 단일 선언 유지. */
+  backdrop-filter: blur(8px);
+  z-index: 40;
+}
+
+/* ───────────── Trigger ───────────── */
+.sidebar__trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  border: 1px solid transparent;
+  background: transparent;
+  color: var(--foreground-muted);
+  border-radius: calc(var(--radius) - 2px);
+  cursor: pointer;
+  transition: background-color var(--duration-fast), color var(--duration-fast), border-color var(--duration-fast);
+}
+.sidebar__trigger:hover {
+  background: var(--sidebar-accent);
+  color: var(--foreground);
+}
+.sidebar__trigger:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: 2px;
+}
+
+/* ───────────── Panel (보조 확장 패널) ─────────────
+ * 레일(사이드바)과 Inset 사이에 위치. 활성 시 너비를 차지해 Inset을 밀어냄.
+ * 모바일에서는 드로어 형태로 오버레이. */
+.sidebar__panel {
+  --sidebar-panel-width: 20rem;
+
+  display: flex;
+  flex-direction: column;
+  width: var(--sidebar-panel-width);
+  flex-shrink: 0;
+  background: var(--background);
+  border-right: 1px solid var(--sidebar-border);
+  position: relative;
+  z-index: 4;
+  overflow: hidden;
+  animation: sh-ui-sidebar-panel-in 180ms ease;
+}
+
+.sidebar__panel[data-state="closed"] {
+  display: none;
+}
+
+@keyframes sh-ui-sidebar-panel-in {
+  from { transform: translateX(-8px); opacity: 0; }
+  to   { transform: translateX(0);    opacity: 1; }
+}
+
+.sidebar__panel-header {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  padding: 0.875rem var(--space-4);
+  border-bottom: 1px solid var(--sidebar-border);
+  font-weight: var(--weight-semibold);
+  font-size: 0.9375rem;
+}
+
+.sidebar__panel-content {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow-y: auto;
+  padding: var(--space-3) var(--space-4) var(--space-4);
+}
+
+.sidebar__panel-close {
+  position: absolute;
+  top: var(--space-2);
+  right: var(--space-2);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  border: 0;
+  border-radius: calc(var(--radius) - 2px);
+  background: transparent;
+  color: var(--foreground-muted);
+  font-size: var(--text-lg);
+  line-height: 1;
+  cursor: pointer;
+  transition: background-color var(--duration-fast), color var(--duration-fast);
+}
+.sidebar__panel-close:hover {
+  background: var(--sidebar-accent);
+  color: var(--foreground);
+}
+
+/* 모바일: 패널은 드로어 위에 오버레이 */
+@media (max-width: 47.9375rem) {
+  .sidebar__panel {
+    position: fixed;
+    top: 0;
+    bottom: 0;
+    left: 0;
+    width: min(var(--sidebar-panel-width), 90vw);
+    z-index: var(--z-modal);
+    border-right: 1px solid var(--sidebar-border);
+    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.15);
+  }
+}
+.sidebar-wrapper[data-embedded] .sidebar__panel {
+  position: relative;
+}
+
+/* ───────────── Inset (main) ───────────── */
+.sidebar-inset {
+  flex: 1 1 0%;
+  min-width: 0;
+  background: var(--background);
+  display: flex;
+  flex-direction: column;
+}
+
+/* variant=inset일 때 main이 카드처럼 보이도록 wrapper 클래스로 처리하고 싶으면
+   :has() 없이도 동작하게 사용자가 직접 클래스 조정 가능. 기본은 평면. */
+
+/* ───────────── Header / Footer / Content / Separator ───────────── */
+.sidebar__header,
+.sidebar__footer {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+  padding: var(--space-2);
+  overflow: hidden;
+}
+
+.sidebar__content {
+  display: flex;
+  flex-direction: column;
+  flex: 1 1 0%;
+  min-height: 0;
+  overflow-y: auto;
+  gap: 0;
+}
+
+.sidebar__separator {
+  margin: var(--space-1) var(--space-2);
+  border: none;
+  border-top: 1px solid var(--sidebar-border);
+  width: auto;
+}
+
+/* ───────────── Group ───────────── */
+.sidebar__group {
+  display: flex;
+  flex-direction: column;
+  padding: var(--space-2);
+  min-width: 0;
+}
+
+.sidebar__group-label {
+  display: flex;
+  align-items: center;
+  height: 2rem;
+  padding: 0 var(--space-2);
+  font-size: var(--text-xs);
+  font-weight: var(--weight-medium);
+  color: var(--foreground-muted);
+  border-radius: calc(var(--radius) - 2px);
+}
+
+.sidebar__group-content {
+  width: 100%;
+  font-size: var(--text-sm);
+}
+
+/* ───────────── Menu ───────────── */
+.sidebar__menu {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  gap: 0;
+}
+
+.sidebar__menu-item {
+  position: relative;
+  margin: 0;
+}
+
+.sidebar__menu-button {
+  display: flex;
+  width: 100%;
+  align-items: center;
+  gap: var(--space-2);
+  padding: var(--space-2);
+  text-align: left;
+  font-size: var(--text-sm);
+  color: var(--sidebar-fg);
+  background: transparent;
+  border: none;
+  border-radius: calc(var(--radius) - 2px);
+  cursor: pointer;
+  transition: background-color var(--duration-fast), color var(--duration-fast);
+  text-decoration: none;
+  font-family: inherit;
+  line-height: 1.4;
+}
+.sidebar__menu-button > svg {
+  width: 1rem;
+  height: 1rem;
+  flex-shrink: 0;
+}
+.sidebar__menu-button > span {
+  flex: 1 1 0%;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.sidebar__menu-button:hover {
+  background: var(--sidebar-accent);
+  color: var(--sidebar-accent-fg);
+}
+.sidebar__menu-button:focus-visible {
+  outline: var(--border-width-strong) solid var(--foreground);
+  outline-offset: -2px;
+}
+.sidebar__menu-button[data-active] {
+  background: var(--primary);
+  color: var(--primary-foreground);
+  font-weight: var(--weight-semibold);
+}
+.sidebar__menu-button[data-active]:hover {
+  background: var(--primary-hover);
+  color: var(--primary-foreground);
+}
+.sidebar__menu-button:disabled,
+.sidebar__menu-button[aria-disabled="true"] {
+  opacity: var(--opacity-disabled);
+  pointer-events: none;
+}
+
+.sidebar__menu-button--sm {
+  height: 1.75rem;
+  padding: var(--space-1) var(--space-2);
+  font-size: 0.8125rem;
+}
+.sidebar__menu-button--md {
+  /* default */
+}
+.sidebar__menu-button--lg {
+  padding: var(--space-3);
+  font-size: 0.9375rem;
+}
+
+/* ───────────── Sub menu ───────────── */
+.sidebar__menu-sub {
+  list-style: none;
+  margin: 0.125rem 0 0;
+  padding: 0.125rem 0 0.125rem 0.625rem;
+  margin-left: 0.875rem;
+  border-left: 1px solid var(--sidebar-border);
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  min-width: 0;
+}
+
+.sidebar__menu-sub-item {
+  position: relative;
+}
+
+.sidebar__menu-sub-button {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+  height: 1.75rem;
+  padding: 0 var(--space-2);
+  border-radius: calc(var(--radius) - 2px);
+  font-size: 0.8125rem;
+  color: var(--sidebar-fg);
+  text-decoration: none;
+  transition: background-color var(--duration-fast), color var(--duration-fast);
+  min-width: 0;
+}
+.sidebar__menu-sub-button > span {
+  flex: 1 1 0%;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.sidebar__menu-sub-button:hover {
+  background: var(--sidebar-accent);
+  color: var(--sidebar-accent-fg);
+}
+.sidebar__menu-sub-button[data-active] {
+  background: var(--primary);
+  color: var(--primary-foreground);
+  font-weight: var(--weight-semibold);
+}
+.sidebar__menu-sub-button[data-active]:hover {
+  background: var(--primary-hover);
+  color: var(--primary-foreground);
+}
+.sidebar__menu-sub-button--sm {
+  font-size: var(--text-xs);
+}
+
+/* ───────────── Collapsible ───────────── */
+.sidebar__chevron {
+  width: 0.875rem !important;
+  height: 0.875rem !important;
+  margin-left: auto;
+  flex-shrink: 0;
+  transition: transform 150ms ease;
+  color: var(--foreground-muted);
+}
+.sidebar__collapsible-trigger[data-state="open"] .sidebar__chevron {
+  transform: rotate(90deg);
+}
+
+.sidebar__collapsible-content[data-state="closed"] {
+  display: none;
+}
+
+/* ───── Flyout (collapsed=icon 상태의 서브메뉴) ─────
+ * 실제 포지셔닝·보더·쉐도우는 Popover가 담당. 여기서는 내부 서브메뉴만 정돈. */
+.sidebar__collapsible-flyout .sidebar__menu-sub {
+  display: flex !important;  /* collapsed 상태 전역 숨김 규칙 override */
+  flex-direction: column;
+  gap: 0.125rem;
+  margin: 0;
+  padding: 0;
+  border-left: 0;
+}
+.sidebar__collapsible-flyout .sidebar__menu-sub-button {
+  padding-left: 0.625rem;
+}
+
+/* collapsed=icon 상태에서는 chevron 숨기고 content도 숨김 */
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__chevron,
+.sidebar[data-state="collapsed"][data-collapsible="icon"] .sidebar__collapsible-content {
+  display: none;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .sidebar,
+  .sidebar--mobile,
+  .sidebar__trigger,
+  .sidebar__menu-button,
+  .sidebar__menu-sub-button,
+  .sidebar__panel-close,
+  .sidebar__chevron {
+    transition: none;
+  }
+  .sidebar__panel {
+    animation: none;
+  }
+}

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

@@ -0,0 +1,22 @@
+import * as React from "react";
+import styles from "./styles.module.css";
+
+
+import { cn } from "@SH_UI_UTILS@";
+/**
+ * 로딩 중 콘텐츠 자리를 채우는 placeholder 박스. 폭/높이는 인라인 스타일이나
+ * 클래스로 직접 지정한다. `aria-hidden`이 기본 적용되므로 스크린리더에 노출되지
+ * 않는다 — 로딩 상태 안내가 필요하면 부모에 `aria-busy`를 함께 둘 것.
+ */
+export const Skeleton = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    aria-hidden="true"
+    className={cn(styles.skeleton, className)}
+    {...props}
+  />
+));
+Skeleton.displayName = "Skeleton";

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

@@ -0,0 +1,24 @@
+.skeleton {
+  display: block;
+  width: 100%;
+  height: 1rem;
+  background: var(--background-muted);
+  border-radius: calc(var(--radius) - 2px);
+  animation: sh-ui-skeleton-pulse 1.6s ease-in-out infinite;
+}
+
+@keyframes sh-ui-skeleton-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.55;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .skeleton {
+    animation: none;
+  }
+}