@jk-core/components 1.0.2 → 1.1.0

package/src/common/Accordion/Accordion.module.scss

@@ -0,0 +1,52 @@
+.accordion {
+  width: 500px;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  border: 1px solid var(--G-20);
+  transition: margin-bottom 0.25s;
+  border-radius: 5px;
+
+  &--visible {
+    margin-bottom: 10px;
+  }
+}
+
+.button {
+  width: 100%;
+  background-color: white;
+  transition: padding 0.25s;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 20px 10px;
+  font-size: 18px;
+  font-weight: 500;
+
+  &__arrow {
+    width: 15px;
+    height: 15px;
+    stroke: var(--G-50);
+    transition: transform 0.25s;
+
+    &--up {
+      transform: rotate(180deg);
+    }
+  }
+
+  &--visible {
+    padding: 30px 10px;
+  }
+}
+
+.wrapper {
+  overflow: hidden;
+  transition: height 0.25s;
+  background-color: white;
+}
+
+.content {
+  white-space: pre-wrap;
+  font-size: 16px;
+  padding: 20px;
+}

package/src/common/Accordion/arrow-down.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="9" viewBox="0 0 12 9" stroke="black" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M1 1.5L6 7L11 1.5" stroke-width="1.4" stroke-linecap="round"/>
+</svg>

package/src/common/Accordion/arrow-up.svg

@@ -0,0 +1,3 @@
+<svg width="12" height="9" viewBox="0 0 12 9" stroke="black" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11 7.5L6 2L1 7.5" stroke-width="1.4" stroke-linecap="round"/>
+</svg>

package/src/common/Accordion/index.tsx

@@ -0,0 +1,55 @@
+import { useRef, useState } from 'react';
+import { cn } from '@jk-core/utils';
+import styles from './Accordion.module.scss';
+import DownIcon from './arrow-down.svg';
+
+interface AccordionProps {
+  /**
+   * 아코디언의 내용
+   */
+  children: React.ReactNode;
+}
+
+/**
+ * 아코디언 컴포넌트
+ * 클릭 시 내용이 확장되거나 축소되는 UI 컴포넌트입니다.
+ */
+export default function Accordion({ children }: AccordionProps) {
+  const contentRef = useRef<HTMLDivElement>(null);
+  const [visible, setVisible] = useState(false);
+
+  return (
+    <div className={cn({
+      [styles.accordion]: true,
+      [styles['accordion--visible']]: visible,
+    })}
+    >
+      <button
+        className={cn({
+          [styles.button]: true,
+          [styles['button--visible']]: visible,
+        })}
+        type="button"
+        onClick={() => setVisible(!visible)}
+      >
+        Accordion
+        <DownIcon className={cn({
+          [styles.button__arrow]: true,
+          [styles['button__arrow--up']]: visible,
+        })}
+        />
+      </button>
+      <div
+        className={cn({
+          [styles.wrapper]: true,
+          [styles['wrapper--visible']]: visible,
+        })}
+        style={{ height: visible ? ((contentRef.current?.scrollHeight ?? 0)) : '0px' }}
+      >
+        <div className={styles.content} ref={contentRef}>
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}

package/src/common/Breadcrumbs/Breadcrumbs.module.scss

@@ -0,0 +1,45 @@
+.breadcrumbs {
+  width: fit-content;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  color: var(--G-60);
+}
+
+.separator {
+  font-size: 12px;
+}
+
+.item {
+  display: flex;
+  align-items: center;
+  color: var(--G-60);
+  font-size: 15px;
+  font-weight: 500;
+
+  & > svg {
+    width: 16px;
+    height: 16px;
+    stroke: var(--G-60);
+  }
+
+  &:hover {
+    text-decoration: underline;
+
+    &:hover > svg {
+      stroke: var(--G-80);
+    }
+  }
+
+  &:last-child {
+    color: var(--G-80);
+
+    & > svg {
+      stroke: var(--G-80);
+    }
+
+    &:hover {
+      text-decoration: none;
+    }
+  }
+}

package/src/common/Breadcrumbs/home.svg

@@ -0,0 +1,5 @@
+<svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg" stroke="black">
+<path d="M4 5.5V14.5H14V5.5" stroke-width="1.2"/>
+<path d="M6.5 12H11.5" stroke-width="1.2"/>
+<path d="M1 8L9 1L17 8" stroke-width="1.2"/>
+</svg>

package/src/common/Breadcrumbs/index.tsx

@@ -0,0 +1,82 @@
+import { Fragment } from 'react/jsx-runtime';
+import styles from './Breadcrumbs.module.scss';
+import HomeIcon from './home.svg';
+
+interface BreadcumbsProps {
+  /**
+   * 자식 요소로 BreadcrumbsItem 컴포넌트를 받습니다.
+   * 각 BreadcrumbsItem은 경로를 나타내며, 클릭 시 해당 경로로 이동합니다.
+   */
+  children: React.ReactNode;
+}
+
+/**
+ * Breadcrumbs 컴포넌트
+ * 여러 개의 ```<BreadcrumbsItem />```을 자식으로 받아 경로를 표시합니다.
+ * 각 ```BreadcrumbsItem```은 경로를 나타내며, 클릭 시 해당 경로로 이동합니다.
+ */
+export default function Breadcrumbs({ children }: BreadcumbsProps) {
+  return (
+    <div className={styles.breadcrumbs}>
+      {Array.isArray(children)
+        ? children.map((child, idx) => (
+          <Fragment key={idx}>
+            {idx > 0 && (
+              <div className={styles.separator}>
+                {'>'}
+              </div>
+            )}
+            {child}
+          </Fragment>
+        ))
+        : children}
+    </div>
+  );
+}
+
+interface BreadcrumbsItemProps {
+  /**
+   * BreadcrumbsItem의 자식 요소로 표시될 텍스트입니다.
+   * 경로를 나타내며, 클릭 시 해당 경로로 이동합니다.
+   */
+  children?: React.ReactNode;
+  /**
+   * BreadcrumbsItem이 클릭되었을 때 이동할 경로입니다.
+   * 기본값은 '/'로 설정되어 있습니다.
+   *
+   */
+  path: string;
+  /**
+   * BreadcrumbsItem이 홈 아이콘을 표시할지 여부입니다.
+   * 기본값은 false로 설정되어 있습니다.
+   * true로 설정하면 홈 아이콘이 표시됩니다.
+   */
+  root?: boolean;
+}
+
+/**
+ * BreadcrumbsItem 컴포넌트
+ * Breadcrumbs 컴포넌트의 자식으로 사용되며, 경로를 나타냅니다.
+ * 클릭 시 해당 경로로 이동합니다.
+ * 기본적으로 홈 아이콘과 함께 표시됩니다.
+ */
+export function BreadcrumbsItem({ children, path, root }: BreadcrumbsItemProps) {
+  return (
+    <button
+      className={styles.item}
+      type="button"
+      onClick={() => {
+        window.location.assign(path);
+      }}
+    >
+      {root
+        ? (
+          <>
+            <HomeIcon className={styles.icon} />
+            {children}
+          </>
+        )
+        : children}
+    </button>
+  );
+}

package/src/common/Button/Button.module.scss

@@ -0,0 +1,130 @@
+@keyframes loading {
+  0%,
+  100% {
+    transform: scale(1);
+  }
+
+  50% {
+    transform: scale(1.3);
+  }
+}
+
+.loading-dot {
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 5px;
+
+  div {
+    width: 6px;
+    height: 6px;
+    background-color: var(--white);
+    border-radius: 100%;
+
+    &:nth-child(1) {
+      animation: loading 1s infinite;
+    }
+
+    &:nth-child(2) {
+      animation: loading 1s 0.25s infinite;
+    }
+
+    &:nth-child(3) {
+      animation: loading 1s 0.5s infinite;
+    }
+  }
+}
+
+.button {
+  position: relative;
+  width: fit-content;
+  border-radius: 8px;
+  padding: 10px 24px;
+  transition: background-color 0.1s;
+  font-size: 17px;
+  font-weight: 500;
+
+  &__loading {
+    color: transparent !important;
+    user-select: none;
+    pointer-events: none;
+    cursor: default !important;
+
+    &:hover,
+    &:active {
+      background-color: inherit;
+      border-color: inherit;
+    }
+  }
+
+  &__tertiary {
+    border: 1px solid var(--G-40);
+
+    &:hover {
+      background-color: var(--G-5);
+      border-color: var(--G-80);
+    }
+
+    &:active {
+      background-color: var(--G-10);
+    }
+  }
+
+  &__secondary {
+    color: var(--P-50);
+    background-color: var(--P-5);
+    border: 1px solid var(--P-50);
+
+    &:hover {
+      background-color: var(--P-10);
+    }
+
+    &:active {
+      background-color: var(--P-20);
+    }
+  }
+
+  &__primary {
+    color: var(--white);
+    background-color: var(--P-50);
+
+    &:hover {
+      background-color: var(--P-60);
+    }
+
+    &:active {
+      background-color: var(--P-70);
+    }
+  }
+
+  &__cancel {
+    color: var(--white);
+    background-color: var(--Point-50);
+
+    &:hover {
+      background-color: var(--Point-60);
+    }
+
+    &:active {
+      background-color: var(--Point-70);
+    }
+  }
+
+  &__disabled {
+    color: var(--white);
+    background-color: var(--G-40) !important;
+    cursor: default;
+
+    &:hover {
+      background-color: var(--P-60);
+    }
+
+    &:active {
+      background-color: var(--P-70);
+    }
+  }
+}

package/src/common/Button/index.tsx

@@ -0,0 +1,60 @@
+import { cn } from '@jk-core/utils';
+import styles from './Button.module.scss';
+
+interface Props extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+  /** 버튼 내용 */
+  text: string;
+  /** 버튼 등급 (Primary, Secondary, Tertiary, Cancel) */
+  grade?: 'tertiary' | 'secondary' | 'primary' | 'cancel';
+  /** 버튼 비활성화 여부 */
+  disabled?: boolean;
+  /** 버튼 클래스 */
+  className?: string;
+  /** 로딩 중 여부, 버튼 내부 스피너 표시 */
+  isLoading?: boolean;
+  /** 버튼 클릭 이벤트 핸들러 */
+  onClick?: () => void;
+}
+
+/**
+ * 공용 버튼 컴포넌트입니다.
+ *
+ * 다양한 등급(grade)과 상태(로딩, 비활성화 등)를 지원하며, 텍스트와 클릭 이벤트를 전달할 수 있습니다.
+ *
+ * - `grade` prop을 통해 버튼의 스타일(Primary, Secondary, Tertiary, Cancel)을 지정할 수 있습니다.
+ * - `isLoading`이 true일 때 로딩 애니메이션이 표시됩니다.
+ * - `disabled`가 true이면 버튼이 비활성화됩니다.
+ * - `text` prop으로 버튼에 표시할 텍스트를 지정합니다.
+ * - 추가적으로 button의 모든 기본 속성(React.)을 지원합니다.
+ */
+export function Button({
+  text, grade = 'primary', disabled = false, onClick, className = '', isLoading = false, ...props
+}: Props) {
+  return (
+    <button
+      className={cn({
+        [styles.button]: true,
+        [styles.button__loading]: isLoading,
+        [styles.button__disabled]: !!disabled,
+        [styles.button__tertiary]: grade === 'tertiary',
+        [styles.button__secondary]: grade === 'secondary',
+        [styles.button__primary]: grade === 'primary',
+        [styles.button__cancel]: grade === 'cancel',
+        [className]: !!className,
+      })}
+      type="button"
+      disabled={disabled}
+      onClick={onClick}
+      {...props}
+    >
+      {text}
+      {isLoading && (
+        <div className={styles['loading-dot']}>
+          <div />
+          <div />
+          <div />
+        </div>
+      )}
+    </button>
+  );
+}

package/src/common/Card/Card.module.scss

@@ -0,0 +1,27 @@
+.card {
+  width: 100%;
+  background-color: var(--white);
+  border-radius: 5px;
+  padding: 10px;
+  display: flex;
+  flex-direction: column;
+  box-shadow:
+    0px 2px 1px -1px rgba(0, 0, 0, 0.2),
+    0px 1px 1px 0px rgba(0, 0, 0, 0.14),
+    0px 1px 3px 0px rgba(0, 0, 0, 0.12),
+    0px 1px 3px 0px rgba(0, 0, 0, 0.14);
+}
+
+.title {
+  color: var(--G-80);
+  margin-bottom: 10px;
+  font-size: 20px;
+  font-weight: 600;
+}
+
+.content {
+  color: var(--G-60);
+  white-space: pre-wrap;
+  font-size: 16px;
+  font-weight: 500;
+}

package/src/common/Card/index.tsx

@@ -0,0 +1,19 @@
+import styles from './Card.module.scss';
+
+interface CardProps {
+  title: string | React.ReactNode;
+  children?: React.ReactNode;
+}
+
+export default function Card({ title, children }:CardProps) {
+  return (
+    <div className={styles.card}>
+      <div className={styles.title}>
+        {title}
+      </div>
+      <div className={styles.content}>
+        {children}
+      </div>
+    </div>
+  );
+}

package/src/common/DropDown/DropDown.module.scss

@@ -0,0 +1,135 @@
+@use "@/styles/scrollbar.scss" as scrollbar;
+
+.wrapper {
+  position: relative;
+  width: fit-content;
+}
+
+.title {
+  width: 180px;
+  height: 50px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background-color: var(--white);
+  border: 1px solid #ccc;
+  border-radius: 5px;
+  padding: 10px;
+  font-size: 16px;
+  cursor: pointer;
+}
+
+.icon {
+  width: 15px;
+  height: 15px;
+  stroke: var(--G-60);
+  transition: transform 0.25s;
+
+  &--up {
+    transform: rotate(180deg);
+  }
+}
+
+.list-portal {
+  display: contents;
+}
+
+.list-wrapper {
+  height: 0;
+  position: absolute;
+  isolation: isolate;
+  background-color: var(--white);
+  transition: height 0.25s;
+  overflow: hidden;
+  border: 1px solid var(--G-30);
+  z-index: 10000;
+
+  &--up {
+    border-radius: 0 0 5px 5px;
+    box-shadow: 0 2px 10px 4px rgba(0, 0, 0, 0.2);
+  }
+
+  &--down {
+    border-radius: 5px 5px 0 0;
+    box-shadow: 0 -2px 10px 2px rgba(0, 0, 0, 0.2);
+  }
+}
+
+.list {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  overflow-y: scroll;
+  max-height: 300px;
+
+  @include scrollbar.custom-scrollbar($background: var(--G-10), $color: var(--G-50));
+
+  &__search {
+    position: sticky;
+    top: 0;
+    width: 100%;
+    height: 40px;
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    gap: 5px;
+    border: none;
+    border-bottom: 1px solid var(--G-20);
+    font-size: 16px;
+    outline: none;
+    box-sizing: border-box;
+    padding: 8px;
+    border-radius: 5px 5px 0 0;
+    background-color: var(--white);
+
+    &:focus-within {
+      outline: 2px solid var(--P-20);
+      outline-offset: -2px;
+    }
+
+    & > svg {
+      width: 11px;
+      height: 11px;
+      flex-shrink: 0;
+    }
+
+    & > input {
+      border: none;
+      outline: none;
+      background-color: transparent;
+    }
+  }
+
+  &__item {
+    min-height: 50px;
+    padding: 8px;
+
+    & + & {
+      border-top: 1px solid var(--G-20);
+    }
+
+    &:hover {
+      background-color: var(--G-5);
+    }
+
+    &--selected {
+      background-color: var(--G-20);
+      font-weight: 600;
+
+      &:hover {
+        background-color: var(--G-20);
+      }
+    }
+  }
+
+  &__empty {
+    height: 50px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    padding: 10px;
+    text-align: center;
+    color: var(--G-50);
+    font-size: 16px;
+  }
+}