@xfilecom/front-core 0.2.28 → 0.2.29

package/README.md

@@ -8,6 +8,7 @@ Design tokens (`tokens.css`), atomic layout (`base.css`), browser-only React com
 |------|------|
 | [docs/DESIGN_SYSTEM.md](./docs/DESIGN_SYSTEM.md) | MUI Paper / react-native-paper 등과 **개념 매핑**, elevation·역할 색 |
 | [docs/COMPONENTS.md](./docs/COMPONENTS.md) | 컴포넌트별 **소스 경로**, props 요약, **복붙 예제 코드** |
+| [docs/SHADCN.md](./docs/SHADCN.md) | [shadcn/ui](https://ui.shadcn.com/) **대응표** — Radix 없이 쓰는 범위·앱 의존 권장 |
 
 npm 패키지에 `docs/`가 포함되므로, 설치 후 `node_modules/@xfilecom/front-core/docs/`에서도 동일 파일을 볼 수 있다.
 

package/dist/base.css

@@ -512,6 +512,723 @@ a:hover {
   color: var(--xfc-danger);
 }
 
+/* —— shadcn/ui-style primitives (토큰만, Radix 미사용) —— */
+
+.xfc-label {
+  display: inline-block;
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  line-height: var(--xfc-leading-normal);
+  color: var(--xfc-fg-label);
+  cursor: default;
+  user-select: none;
+}
+
+label.xfc-label {
+  cursor: pointer;
+}
+
+.xfc-label--disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+.xfc-separator {
+  flex-shrink: 0;
+  background: var(--xfc-border);
+  border: none;
+}
+
+.xfc-separator--horizontal {
+  width: 100%;
+  height: 1px;
+  margin: var(--xfc-space-sm) 0;
+}
+
+.xfc-separator--vertical {
+  width: 1px;
+  min-height: 1em;
+  align-self: stretch;
+  margin: 0 var(--xfc-space-sm);
+}
+
+.xfc-skeleton {
+  display: block;
+  border-radius: var(--xfc-radius-sm);
+  background: linear-gradient(
+    90deg,
+    var(--xfc-bg-muted) 0%,
+    color-mix(in srgb, var(--xfc-bg-elevated) 55%, var(--xfc-bg-muted)) 50%,
+    var(--xfc-bg-muted) 100%
+  );
+  background-size: 200% 100%;
+  animation: xfc-skeleton-shimmer 1.2s ease-in-out infinite;
+}
+
+.xfc-skeleton--circle {
+  border-radius: 50%;
+}
+
+@keyframes xfc-skeleton-shimmer {
+  0% {
+    background-position: 200% 0;
+  }
+  100% {
+    background-position: -200% 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .xfc-skeleton {
+    animation: none;
+    background: var(--xfc-bg-muted);
+  }
+}
+
+.xfc-switch {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--xfc-space-sm);
+  cursor: pointer;
+  vertical-align: middle;
+}
+
+.xfc-switch--disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+  pointer-events: none;
+}
+
+.xfc-switch__input {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+.xfc-switch__track {
+  position: relative;
+  width: 2.75rem;
+  height: 1.5rem;
+  flex-shrink: 0;
+  border-radius: var(--xfc-radius-full);
+  background: var(--xfc-bg-muted);
+  border: 1px solid var(--xfc-border-strong);
+  transition:
+    background 0.18s ease,
+    border-color 0.18s ease;
+}
+
+.xfc-switch__thumb {
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  width: calc(1.5rem - 6px);
+  height: calc(1.5rem - 6px);
+  border-radius: 50%;
+  background: var(--xfc-bg-elevated);
+  box-shadow: var(--xfc-shadow-xs);
+  transition: transform 0.18s ease;
+}
+
+.xfc-switch__input:focus-visible + .xfc-switch__track {
+  box-shadow: var(--xfc-focus-ring);
+}
+
+.xfc-switch__input:checked + .xfc-switch__track {
+  background: color-mix(in srgb, var(--xfc-accent) 35%, var(--xfc-bg-muted));
+  border-color: color-mix(in srgb, var(--xfc-accent) 45%, var(--xfc-border-strong));
+}
+
+.xfc-switch__input:checked + .xfc-switch__track .xfc-switch__thumb {
+  transform: translateX(1.25rem);
+}
+
+.xfc-progress {
+  position: relative;
+  width: 100%;
+  height: 0.5rem;
+  overflow: hidden;
+  border-radius: var(--xfc-radius-full);
+  background: var(--xfc-bg-muted);
+  border: 1px solid var(--xfc-border);
+}
+
+.xfc-progress__indicator {
+  height: 100%;
+  border-radius: inherit;
+  background: var(--xfc-accent);
+  transition: width 0.28s ease;
+}
+
+.xfc-tabs {
+  width: 100%;
+}
+
+.xfc-tabs-list {
+  display: inline-flex;
+  flex-wrap: wrap;
+  gap: var(--xfc-space-xs);
+  padding: var(--xfc-space-xs);
+  border-radius: var(--xfc-radius-md);
+  background: color-mix(in srgb, var(--xfc-bg-muted) 55%, var(--xfc-bg-elevated));
+  border: 1px solid var(--xfc-border);
+}
+
+.xfc-tabs-trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 2.25rem;
+  padding: 0 var(--xfc-space-md);
+  font: inherit;
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  color: var(--xfc-fg-muted);
+  background: transparent;
+  border: none;
+  border-radius: var(--xfc-radius-sm);
+  cursor: pointer;
+  transition:
+    color 0.15s ease,
+    background 0.15s ease;
+}
+
+.xfc-tabs-trigger:hover:not(:disabled) {
+  color: var(--xfc-fg-label);
+}
+
+.xfc-tabs-trigger:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.xfc-tabs-trigger--active {
+  color: var(--xfc-fg-strong);
+  background: var(--xfc-bg-elevated);
+  box-shadow: var(--xfc-shadow-xs);
+}
+
+.xfc-tabs-trigger:focus-visible {
+  outline: none;
+  box-shadow: var(--xfc-focus-ring);
+}
+
+.xfc-tabs-content {
+  margin-top: var(--xfc-space-md);
+  outline: none;
+}
+
+.xfc-tabs-content[hidden] {
+  display: none;
+}
+
+.xfc-accordion {
+  width: 100%;
+  border-radius: var(--xfc-radius-md);
+  border: 1px solid var(--xfc-border);
+  background: var(--xfc-bg-elevated);
+  overflow: hidden;
+}
+
+.xfc-accordion-item + .xfc-accordion-item {
+  border-top: 1px solid var(--xfc-border);
+}
+
+.xfc-accordion-trigger {
+  display: flex;
+  width: 100%;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--xfc-space-md);
+  padding: var(--xfc-space-md) var(--xfc-space-lg);
+  font: inherit;
+  font-size: var(--xfc-text-body);
+  font-weight: 600;
+  text-align: left;
+  color: var(--xfc-fg-strong);
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  transition: background 0.15s ease;
+}
+
+.xfc-accordion-trigger:hover:not(:disabled) {
+  background: color-mix(in srgb, var(--xfc-bg-muted) 40%, transparent);
+}
+
+.xfc-accordion-trigger:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.xfc-accordion-trigger__chevron {
+  flex-shrink: 0;
+  width: 1rem;
+  height: 1rem;
+  transition: transform 0.2s ease;
+  color: var(--xfc-fg-muted);
+}
+
+.xfc-accordion-trigger[aria-expanded='true'] .xfc-accordion-trigger__chevron {
+  transform: rotate(180deg);
+}
+
+.xfc-accordion-content {
+  padding: 0 var(--xfc-space-lg) var(--xfc-space-md);
+  font-size: var(--xfc-text-body);
+  line-height: var(--xfc-leading-normal);
+  color: var(--xfc-fg);
+}
+
+.xfc-accordion-content[hidden] {
+  display: none;
+}
+
+.xfc-collapsible-content[hidden] {
+  display: none;
+}
+
+.xfc-collapsible-trigger {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--xfc-space-sm);
+  padding: var(--xfc-space-xs) var(--xfc-space-sm);
+  font: inherit;
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  color: var(--xfc-accent);
+  background: transparent;
+  border: none;
+  border-radius: var(--xfc-radius-sm);
+  cursor: pointer;
+  transition: background 0.15s ease;
+}
+
+.xfc-collapsible-trigger:hover:not(:disabled) {
+  background: var(--xfc-accent-soft);
+}
+
+.xfc-collapsible-trigger:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.xfc-collapsible-trigger:focus-visible {
+  outline: none;
+  box-shadow: var(--xfc-focus-ring);
+}
+
+.xfc-collapsible-panel {
+  margin-top: var(--xfc-space-sm);
+  font-size: var(--xfc-text-body);
+  line-height: var(--xfc-leading-normal);
+  color: var(--xfc-fg);
+}
+
+.xfc-alert {
+  position: relative;
+  width: 100%;
+  padding: var(--xfc-space-md) var(--xfc-space-lg);
+  border-radius: var(--xfc-radius-md);
+  border: 1px solid var(--xfc-border);
+  background: color-mix(in srgb, var(--xfc-bg-muted) 35%, var(--xfc-bg-elevated));
+  color: var(--xfc-fg);
+}
+
+.xfc-alert--destructive {
+  border-color: color-mix(in srgb, var(--xfc-danger) 35%, var(--xfc-border));
+  background: color-mix(in srgb, var(--xfc-danger) 10%, var(--xfc-bg-elevated));
+  color: var(--xfc-fg-strong);
+}
+
+.xfc-alert__title {
+  margin: 0 0 var(--xfc-space-xs);
+  font-size: var(--xfc-text-body);
+  font-weight: 700;
+  line-height: var(--xfc-leading-tight);
+}
+
+.xfc-alert__description {
+  margin: 0;
+  font-size: var(--xfc-text-small);
+  line-height: var(--xfc-leading-normal);
+  color: var(--xfc-fg-muted);
+}
+
+.xfc-alert--destructive .xfc-alert__description {
+  color: color-mix(in srgb, var(--xfc-danger) 55%, var(--xfc-fg-muted));
+}
+
+.xfc-avatar {
+  position: relative;
+  display: inline-flex;
+  width: 2.5rem;
+  height: 2.5rem;
+  flex-shrink: 0;
+  overflow: hidden;
+  border-radius: 50%;
+  border: 1px solid var(--xfc-border);
+  background: var(--xfc-bg-muted);
+  align-items: center;
+  justify-content: center;
+  font-size: var(--xfc-text-small);
+  font-weight: 700;
+  color: var(--xfc-fg-label);
+}
+
+.xfc-avatar__image {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.xfc-avatar__fallback {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+}
+
+.xfc-breadcrumb {
+  width: 100%;
+}
+
+.xfc-breadcrumb-list {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--xfc-space-xs);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font-size: var(--xfc-text-small);
+}
+
+.xfc-breadcrumb-item {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--xfc-space-xs);
+}
+
+.xfc-breadcrumb-link {
+  color: var(--xfc-fg-muted);
+  text-decoration: none;
+  font-weight: 500;
+  transition: color 0.15s ease;
+}
+
+.xfc-breadcrumb-link:hover {
+  color: var(--xfc-accent);
+}
+
+.xfc-breadcrumb-page {
+  font-weight: 600;
+  color: var(--xfc-fg-strong);
+}
+
+.xfc-breadcrumb-sep {
+  color: var(--xfc-fg-muted);
+  user-select: none;
+}
+
+.xfc-table-wrap {
+  width: 100%;
+  overflow-x: auto;
+  border-radius: var(--xfc-radius-md);
+  border: 1px solid var(--xfc-border);
+}
+
+.xfc-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: var(--xfc-text-small);
+}
+
+.xfc-table-caption {
+  caption-side: bottom;
+  padding: var(--xfc-space-sm) var(--xfc-space-md);
+  font-size: var(--xfc-text-small);
+  color: var(--xfc-fg-muted);
+  text-align: left;
+}
+
+.xfc-table-header {
+  background: color-mix(in srgb, var(--xfc-bg-muted) 50%, var(--xfc-bg-elevated));
+}
+
+.xfc-table-row {
+  border-bottom: 1px solid var(--xfc-border);
+  transition: background 0.12s ease;
+}
+
+.xfc-table-row:last-child {
+  border-bottom: none;
+}
+
+@media (hover: hover) {
+  .xfc-table-row:hover {
+    background: color-mix(in srgb, var(--xfc-bg-muted) 25%, transparent);
+  }
+}
+
+.xfc-table-head {
+  padding: var(--xfc-space-sm) var(--xfc-space-md);
+  text-align: left;
+  font-weight: 700;
+  color: var(--xfc-fg-label);
+  white-space: nowrap;
+}
+
+.xfc-table-cell {
+  padding: var(--xfc-space-md);
+  color: var(--xfc-fg);
+  vertical-align: middle;
+}
+
+.xfc-table-footer .xfc-table-cell {
+  font-weight: 600;
+  background: color-mix(in srgb, var(--xfc-bg-muted) 35%, var(--xfc-bg-elevated));
+}
+
+.xfc-scroll-area {
+  overflow: auto;
+  border-radius: var(--xfc-radius-sm);
+  border: 1px solid var(--xfc-border);
+  background: var(--xfc-bg-elevated);
+}
+
+.xfc-scroll-area:focus-visible {
+  outline: none;
+  box-shadow: var(--xfc-focus-ring);
+}
+
+.xfc-toggle {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 2.25rem;
+  min-width: 2.25rem;
+  padding: 0 var(--xfc-space-sm);
+  font: inherit;
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  color: var(--xfc-fg-muted);
+  background: transparent;
+  border: 1px solid transparent;
+  border-radius: var(--xfc-radius-sm);
+  cursor: pointer;
+  transition:
+    background 0.15s ease,
+    color 0.15s ease,
+    border-color 0.15s ease;
+}
+
+.xfc-toggle:hover:not(:disabled) {
+  background: var(--xfc-bg-muted);
+  color: var(--xfc-fg-label);
+}
+
+.xfc-toggle:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.xfc-toggle--pressed {
+  background: color-mix(in srgb, var(--xfc-accent) 14%, var(--xfc-bg-elevated));
+  color: var(--xfc-accent);
+  border-color: color-mix(in srgb, var(--xfc-accent) 28%, var(--xfc-border));
+}
+
+.xfc-toggle:focus-visible {
+  outline: none;
+  box-shadow: var(--xfc-focus-ring);
+}
+
+.xfc-radio-group {
+  display: flex;
+  flex-direction: column;
+  gap: var(--xfc-space-sm);
+  border: none;
+  margin: 0;
+  padding: 0;
+}
+
+.xfc-radio-group__legend {
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  color: var(--xfc-fg-label);
+  margin-bottom: var(--xfc-space-xs);
+  padding: 0;
+}
+
+.xfc-radio-row {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--xfc-space-sm);
+}
+
+.xfc-radio {
+  width: 1.125rem;
+  height: 1.125rem;
+  flex-shrink: 0;
+  accent-color: var(--xfc-accent);
+  cursor: pointer;
+}
+
+.xfc-radio:disabled {
+  cursor: not-allowed;
+  opacity: 0.55;
+}
+
+.xfc-radio-label {
+  font-size: var(--xfc-text-body);
+  color: var(--xfc-fg-label);
+  cursor: pointer;
+}
+
+.xfc-aspect {
+  position: relative;
+  width: 100%;
+  overflow: hidden;
+  border-radius: var(--xfc-radius-md);
+}
+
+.xfc-aspect__inner {
+  position: absolute;
+  inset: 0;
+}
+
+.xfc-tooltip {
+  position: relative;
+  display: inline-flex;
+}
+
+.xfc-tooltip__trigger {
+  display: inline-flex;
+}
+
+.xfc-tooltip__content {
+  position: absolute;
+  z-index: 50;
+  left: 50%;
+  bottom: calc(100% + 6px);
+  transform: translateX(-50%);
+  max-width: 240px;
+  padding: var(--xfc-space-xs) var(--xfc-space-sm);
+  font-size: var(--xfc-text-small);
+  font-weight: 500;
+  line-height: var(--xfc-leading-normal);
+  color: var(--xfc-accent-fg);
+  background: var(--xfc-fg-strong);
+  border-radius: var(--xfc-radius-sm);
+  box-shadow: var(--xfc-shadow-md);
+  pointer-events: none;
+  white-space: normal;
+  text-align: center;
+}
+
+.xfc-tooltip__content::after {
+  content: '';
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  margin-left: -5px;
+  border: 5px solid transparent;
+  border-top-color: var(--xfc-fg-strong);
+}
+
+.xfc-slider {
+  width: 100%;
+  height: 1.25rem;
+  margin: 0;
+  accent-color: var(--xfc-accent);
+  cursor: pointer;
+}
+
+.xfc-slider:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.xfc-pagination {
+  width: 100%;
+}
+
+.xfc-pagination__list {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--xfc-space-xs);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.xfc-pagination__ellipsis {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 2.25rem;
+  height: 2.25rem;
+  font-size: var(--xfc-text-small);
+  color: var(--xfc-fg-muted);
+  user-select: none;
+}
+
+.xfc-pagination__link {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 2.25rem;
+  height: 2.25rem;
+  padding: 0 var(--xfc-space-sm);
+  font: inherit;
+  font-size: var(--xfc-text-small);
+  font-weight: 600;
+  color: var(--xfc-fg);
+  text-decoration: none;
+  background: var(--xfc-bg-elevated);
+  border: 1px solid var(--xfc-border);
+  border-radius: var(--xfc-radius-sm);
+  cursor: pointer;
+  transition:
+    background 0.15s ease,
+    border-color 0.15s ease;
+}
+
+button.xfc-pagination__link {
+  font: inherit;
+}
+
+.xfc-pagination__link:hover:not(:disabled) {
+  background: var(--xfc-bg-muted);
+  border-color: var(--xfc-border-strong);
+}
+
+.xfc-pagination__link:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.xfc-pagination__link--active {
+  background: color-mix(in srgb, var(--xfc-accent) 18%, var(--xfc-bg-elevated));
+  border-color: color-mix(in srgb, var(--xfc-accent) 40%, var(--xfc-border-strong));
+  color: var(--xfc-accent);
+}
+
+.xfc-pagination__link:focus-visible {
+  outline: none;
+  box-shadow: var(--xfc-focus-ring);
+}
+
 /* —— Badges —— */
 
 .xfc-badge {