From acea3418e3bea3c6a1689ab9a8677196939cdd69 Mon Sep 17 00:00:00 2001
From: clkim <clkim@smilegate.com>
Date: Thu, 25 Sep 2025 18:28:02 +0900
Subject: [PATCH] =?UTF-8?q?fix.=20=EB=B2=84=ED=8A=BC=20=EC=BB=B4=ED=8F=AC?=
 =?UTF-8?q?=EB=84=8C=ED=8A=B8=20=EB=A7=81=ED=81=AC=20=EC=A0=81=EC=9A=A9,?=
 =?UTF-8?q?=20=EC=BD=94=EB=93=9C=20=EB=A6=AC=ED=8C=A9=ED=86=A0=EB=A7=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 layers/assets/css/components/_button.css   |  56 +++++-------
 layers/components/atoms/Button/index.vue   | 101 ++++++++++-----------
 layers/components/blocks/HybridLink.vue    |  32 ++++---
 layers/components/blocks/VisualContent.vue |  34 +------
 layers/components/widgets/Background.vue   |   1 -
 layers/components/widgets/ButtonList.vue   |  66 +++++++++++---
 layers/types/api/pageData.ts               |  22 ++---
 layers/types/components/button.ts          |  10 +-
 layers/utils/dataUtil.ts                   |  78 ----------------
 layers/utils/styleUtil.ts                  |  82 +++++++++++++++++
 10 files changed, 247 insertions(+), 235 deletions(-)
 create mode 100644 layers/utils/styleUtil.ts

diff --git a/layers/assets/css/components/_button.css b/layers/assets/css/components/_button.css
index 669f90b..a28dfbc 100644
--- a/layers/assets/css/components/_button.css
+++ b/layers/assets/css/components/_button.css
@@ -1,44 +1,34 @@
 /* Button Size Classes */
 @layer components {
   .btn-base {
-    @apply relative inline-flex items-center justify-center font-medium border border-gray-600/30 overflow-hidden;
+    @apply overflow-hidden relative inline-flex items-center justify-center font-medium cursor-pointer
+    before:content-[''] before:absolute before:top-0 before:left-0 before:w-full before:h-full before:border before:border-white/10 before:rounded-lg
+    after:content-[''] after:absolute after:top-0 after:left-0 after:w-full after:h-full after:bg-white after:rounded-lg after:transition-opacity after:duration-300 after:ease-in-out after:opacity-0
     /* 기본 크기: size-medium */
-    --btn-padding: theme('spacing.10');
-    --btn-height: theme('spacing.14');
-    --btn-text: theme('fontSize.base');
-    --btn-radius: theme('borderRadius.lg');
-    @apply px-10 h-14 text-base rounded-lg;
+    px-10 h-14 text-base rounded-lg;
   }
-
-  .size-extra-small {
-    --btn-padding: theme('spacing.6');
-    --btn-height: theme('spacing.10');
-    --btn-text: theme('fontSize.sm');
-    --btn-radius: theme('borderRadius.DEFAULT');
-    @apply px-6 h-10 text-sm rounded;
+  .btn-base:hover {
+    @apply after:opacity-20;
   }
-
-  .size-small {
-    --btn-padding: theme('spacing.10');
-    --btn-height: theme('spacing.12');
-    --btn-text: theme('fontSize.sm');
-    --btn-radius: theme('borderRadius.lg');
-    @apply px-10 h-12 text-sm rounded-lg;
-  }
-
-  .size-medium {
-    --btn-padding: theme('spacing.10');
-    --btn-height: theme('spacing.14');
-    --btn-text: theme('fontSize.base');
-    --btn-radius: theme('borderRadius.lg');
-    @apply px-10 h-14 text-base rounded-lg;
+  .btn-base:disabled {
+    @apply cursor-default
+    after:bg-[var(--text-color)] after:opacity-20 after:z-[2];
   }
 
   .size-large {
-    --btn-padding: theme('spacing.10');
-    --btn-height: theme('spacing.16');
-    --btn-text: theme('fontSize.lg');
-    --btn-radius: theme('borderRadius.lg');
-    @apply px-10 h-16 text-lg rounded-lg;
+    @apply px-10 h-16 text-lg;
+  }
+
+  .size-medium {
+    @apply px-10 h-14 text-base;
+  }
+
+  .size-small {
+    @apply px-10 h-12 text-sm;
+  }
+
+  .size-extra-small {
+    @apply before:rounded after:rounded
+    px-6 h-10 text-sm rounded;
   }
 }
diff --git a/layers/components/atoms/Button/index.vue b/layers/components/atoms/Button/index.vue
index 1b5beb6..5c28912 100644
--- a/layers/components/atoms/Button/index.vue
+++ b/layers/components/atoms/Button/index.vue
@@ -1,45 +1,34 @@
 <script setup lang="ts">
-import type { GameDataKeyCodeCodes } from '#layers/types/api/gameData'
+import type { ButtonType } from '#layers/types/components/button'
 
 interface ButtonProps {
-  backgroundColor?: string
-  textColor?: string
+  type?: ButtonType
   icon?: string
-  disabled?: boolean
+  target?: '_self' | '_blank'
+  href?: string
+  rel?: string
+  backgroundColor?: string
   backgroundImage?: string
+  textColor?: string
+  disabled?: boolean
+  class?: string
 }
 
 const props = withDefaults(defineProps<ButtonProps>(), {
+  type: 'action',
   backgroundColor: 'var(--primary)',
   textColor: 'var(--alternative-02)',
-  icon: '',
   disabled: false,
 })
 
-// 색상 코드 키 목록 key_code_codes
-const PARSED_KEY_CODE_CODES_KEYS: (keyof GameDataKeyCodeCodes)[] = [
-  'primary',
-  'text-primary',
-  'text-secondary',
-  'alternative-01',
-  'alternative-02',
-]
-
-// 색상 값을 CSS 변수로 변환하는 헬퍼 함수
-const getColorValue = (color: string) =>
-  PARSED_KEY_CODE_CODES_KEYS.includes(color as keyof GameDataKeyCodeCodes)
-    ? `var(--${color})`
-    : color
-
-const buttonClasses = computed(() => [
-  'btn-base group relative inline-flex items-center justify-center font-medium border border-gray-600/30 overflow-hidden',
-  props.disabled ? 'cursor-default' : 'cursor-pointer',
-])
-
+const buttonClasses = computed(() =>
+  ['btn-base group', props.class].filter(Boolean)
+)
 const buttonStyles = computed(() => {
   const styles: Record<string, string> = {
-    backgroundColor: getColorValue(props.backgroundColor),
-    color: getColorValue(props.textColor),
+    backgroundColor: props.backgroundColor,
+    color: props.textColor,
+    '--text-color': props.textColor,
   }
 
   if (props.backgroundImage) {
@@ -51,40 +40,50 @@ const buttonStyles = computed(() => {
 
   return styles
 })
+const componentTag = computed((): string => {
+  switch (props.type) {
+    case 'download':
+    case 'external':
+      return 'a'
+    case 'internal':
+      return 'AtomsLocaleLink'
+    default:
+      return 'button'
+  }
+})
+const componentProps = computed(() => {
+  const baseProps = { disabled: props.disabled }
 
-const overlayClasses = computed(() => [
-  'absolute inset-0 -m-px transition-opacity duration-200',
-  props.disabled
-    ? 'opacity-20 z-10'
-    : 'bg-white opacity-0 group-hover:opacity-20',
-])
-
-const overlayDisabledStyles = computed(
-  () =>
-    props.disabled && {
-      backgroundColor: props.textColor,
+  if (props.type === 'external') {
+    return {
+      ...baseProps,
+      href: props.href,
+      target: props.target,
+      rel: props.rel,
     }
-)
+  }
 
-const contentDisabledStyles = computed(() => props.disabled && { opacity: 0.2 })
+  if (props.type === 'internal') {
+    return {
+      ...baseProps,
+      to: props.href,
+    }
+  }
+
+  return baseProps
+})
 </script>
 
 <template>
-  <button
+  <component
+    :is="componentTag"
+    v-bind="componentProps"
     :class="buttonClasses"
     :style="buttonStyles"
-    :disabled="props.disabled"
   >
-    <!-- 호버 효과 / Disabled 오버레이 -->
-    <span :class="overlayClasses" :style="overlayDisabledStyles" />
-
-    <!-- 버튼 내용 -->
-    <span
-      class="relative flex items-center gap-2"
-      :style="contentDisabledStyles"
-    >
+    <span class="relative flex items-center gap-2 z-[1]">
       <slot />
       <span v-if="props.icon" class="flex-shrink-0" v-html="props.icon" />
     </span>
-  </button>
+  </component>
 </template>
diff --git a/layers/components/blocks/HybridLink.vue b/layers/components/blocks/HybridLink.vue
index ea8f1fc..a20ac02 100644
--- a/layers/components/blocks/HybridLink.vue
+++ b/layers/components/blocks/HybridLink.vue
@@ -9,19 +9,29 @@ const props = withDefaults(defineProps<Props>(), {
   target: '',
   class: '',
 })
+
+const componentTag = computed(() => {
+  return props.target === '_blank' ? 'a' : 'AtomsLocaleLink'
+})
+
+const componentProps = computed(() => {
+  if (props.target === '_blank') {
+    return {
+      href: props.to,
+      target: props.target,
+      class: props.class,
+    }
+  }
+
+  return {
+    to: props.to,
+    class: props.class,
+  }
+})
 </script>
 
 <template>
-  <a
-    v-if="props.target === '_blank'"
-    v-bind="$attrs"
-    :href="props.to"
-    :target="props.target"
-    :class="props.class"
-  >
+  <component :is="componentTag" v-bind="{ ...$attrs, ...componentProps }">
     <slot />
-  </a>
-  <AtomsLocaleLink v-else v-bind="$attrs" :to="props.to" :class="props.class">
-    <slot />
-  </AtomsLocaleLink>
+  </component>
 </template>
diff --git a/layers/components/blocks/VisualContent.vue b/layers/components/blocks/VisualContent.vue
index a4c461d..c464952 100644
--- a/layers/components/blocks/VisualContent.vue
+++ b/layers/components/blocks/VisualContent.vue
@@ -1,5 +1,4 @@
 <script setup lang="ts">
-import { getResponsiveSrc } from '#layers/utils/dataUtil'
 import type { PageDataResourceGroup } from '#layers/types/api/pageData'
 
 interface Props {
@@ -13,39 +12,14 @@ const props = defineProps<Props>()
 const displayText = computed(() => {
   return props.resourcesData?.display?.txt || ''
 })
-
-// 이미지 소스 추출
 const imageSrc = computed(() => {
   return getResponsiveSrc(props.resourcesData?.res_path)
 })
-
-// 색상 코드 추출 (우선순위: color_code_txt > color_code)
-const colorCode = computed(() => {
-  return (
-    props.resourcesData?.display?.color_code_txt ||
-    props.resourcesData?.display?.color_code
-  )
-})
-
-// 색상 이름 추출 (우선순위: color_name_txt > color_name)
 const colorName = computed(() => {
-  return (
-    props.resourcesData?.display?.color_name_txt ||
-    props.resourcesData?.display?.color_name
-  )
+  return props.resourcesData?.display?.color_name
 })
-
-// 색상 스타일 계산
-const textStyles = computed(() => {
-  const styles: Record<string, string> = {}
-
-  if (colorName.value) {
-    styles.color = `var(--${colorName.value})`
-  } else if (colorCode.value) {
-    styles.color = colorCode.value
-  }
-
-  return styles
+const colorCode = computed(() => {
+  return props.resourcesData?.display?.color_code
 })
 
 // HTML 콘텐츠 정리 (줄바꿈 처리)
@@ -82,7 +56,7 @@ const hasImage = computed(() => {
   <span
     v-else-if="displayText"
     v-dompurify-html="sanitizedContent"
-    :style="textStyles"
+    :style="{ color: getColorCode({ colorName, colorCode }) }"
     class="block"
   />
 </template>
diff --git a/layers/components/widgets/Background.vue b/layers/components/widgets/Background.vue
index 30d65dd..356520e 100644
--- a/layers/components/widgets/Background.vue
+++ b/layers/components/widgets/Background.vue
@@ -1,5 +1,4 @@
 <script setup lang="ts">
-import { getResponsiveClass, getResponsiveSrc } from '#layers/utils/dataUtil'
 import type { PageDataResourceGroup } from '#layers/types/api/pageData'
 
 interface Props {
diff --git a/layers/components/widgets/ButtonList.vue b/layers/components/widgets/ButtonList.vue
index 4b7aeab..f7ac19d 100644
--- a/layers/components/widgets/ButtonList.vue
+++ b/layers/components/widgets/ButtonList.vue
@@ -1,25 +1,69 @@
 <script setup lang="ts">
-import type { PageDataResourceGroup } from '#layers/types/api/pageData'
+import type {
+  PageDataResourceGroup,
+  PageDataResourceGroupBtnInfo,
+} from '#layers/types/api/pageData'
+import type { ButtonType } from '#layers/types/components/button'
 
-const props = defineProps<{
+interface ButtonListProps {
   resourcesData: PageDataResourceGroup[]
-  buttonType?: string
-}>()
+}
+
+const props = defineProps<ButtonListProps>()
+
+// 상수 정의
+const BUTTON_TYPE_MAP = {
+  URL: {
+    _self: 'internal' as const,
+    _blank: 'external' as const,
+  },
+  DOWNLOAD: 'download' as const,
+} as const
+const DEFAULT_BUTTON_TYPE: ButtonType = 'action'
+
+const getButtonType = (btnInfo: PageDataResourceGroupBtnInfo): ButtonType => {
+  const btnType = btnInfo?.detail?.btn_type
+  const btnTarget = btnInfo?.detail?.action?.link_target
+
+  if (btnType === 'URL' && btnTarget) {
+    return BUTTON_TYPE_MAP.URL[btnTarget] || DEFAULT_BUTTON_TYPE
+  }
+
+  if (btnType === 'DOWNLOAD') {
+    return BUTTON_TYPE_MAP.DOWNLOAD
+  }
+
+  return DEFAULT_BUTTON_TYPE
+}
+
+const getButtonProps = (button: PageDataResourceGroup) => ({
+  type: getButtonType(button.btn_info),
+  target: button.btn_info?.detail?.action?.link_target,
+  href: button.btn_info?.detail?.action?.url,
+  rel: button.btn_info?.detail?.action?.rel,
+  backgroundColor: getColorCode({
+    colorName: button.btn_info?.color_name_btn,
+    colorCode: button.btn_info?.color_code_btn,
+  }),
+  textColor: getColorCode({
+    colorName: button.btn_info?.color_name_txt,
+    colorCode: button.btn_info?.color_code_txt,
+  }),
+  disabled: button.btn_info?.disabled,
+  text: button.btn_info?.txt_btn_name,
+})
 </script>
 
 <template>
   <div
-    v-if="props.resourcesData"
+    v-if="props.resourcesData?.length"
     class="flex flex-wrap justify-center gap-3 md:gap-4"
   >
     <AtomsButton
-      v-for="button in props.resourcesData"
-      :key="button.group_code"
-      :button-type="props.buttonType"
+      v-for="(button, index) in props.resourcesData"
+      :key="`${button.group_code}-${index}`"
+      v-bind="getButtonProps(button)"
       class="size-extra-small md:size-medium"
-      :background-color="button.btn_info?.color_code_btn"
-      :text-color="button.btn_info?.color_code_txt"
-      :disabled="button.btn_info?.disabled"
     >
       {{ button.btn_info?.txt_btn_name }}
     </AtomsButton>
diff --git a/layers/types/api/pageData.ts b/layers/types/api/pageData.ts
index e5d129b..53a3d94 100644
--- a/layers/types/api/pageData.ts
+++ b/layers/types/api/pageData.ts
@@ -60,25 +60,25 @@ export interface PageDataResourceGroupResPath {
   path_pc?: string
 }
 
+export interface PageDataResourceGroupBtnInfo {
+  color_code_btn: string
+  color_name_btn: string
+  color_code_txt: string
+  color_name_txt: string
+  disabled: boolean
+  txt_btn_name: string
+  detail: Record<string, any>
+}
+
 // 리소스 그룹 타입
 export interface PageDataResourceGroup {
   group_type?: string
   group_code?: string
   res_path?: PageDataResourceGroupResPath
-  btn_info?: {
-    color_code_btn: string
-    color_code_txt: string
-    disabled: boolean
-    txt_btn_name: string
-    detail: Record<string, any>
-  }
+  btn_info?: PageDataResourceGroupBtnInfo
   display?: {
     text: string
     txt: string
-    color_code_btn?: string
-    color_name_btn?: string
-    color_code_txt?: string
-    color_name_txt?: string
     color_code?: string
     color_name?: string
   }
diff --git a/layers/types/components/button.ts b/layers/types/components/button.ts
index be3a92c..6de1956 100644
--- a/layers/types/components/button.ts
+++ b/layers/types/components/button.ts
@@ -1,10 +1,2 @@
-// 버튼 크기 타입
+export type ButtonType = 'internal' | 'external' | 'download' | 'action'
 export type ButtonSize = 'large' | 'medium' | 'small' | 'extra-small'
-
-// 버튼 설정 인터페이스
-export interface ButtonConfig {
-  padding: string
-  height: string
-  text: string
-  rounded: string
-}
diff --git a/layers/utils/dataUtil.ts b/layers/utils/dataUtil.ts
index 0bc3f65..0179fc1 100644
--- a/layers/utils/dataUtil.ts
+++ b/layers/utils/dataUtil.ts
@@ -1,13 +1,8 @@
 import type {
   PageDataValue,
-  PageDataResourceGroupResPath,
   PageDataComponent,
 } from '#layers/types/api/pageData'
 
-// ============================================================================
-// 페이지 데이터 관련 유틸리티
-// ============================================================================
-
 /**
  * 페이지 데이터를 기반으로 레이아웃 타입을 결정합니다.
  * @param pageData 페이지 데이터
@@ -19,10 +14,6 @@ export const getLayoutType = (
   return pageData?.page_type === 1 ? 'default' : 'promotion'
 }
 
-// ============================================================================
-// 컴포넌트 데이터 접근 관련 유틸리티
-// ============================================================================
-
 /**
  * 그룹의 첫 번째 데이터를 반환합니다.
  * @param source props.components 또는 group 객체
@@ -72,72 +63,3 @@ export const getComponentGroupAry = (source: any, componentName: string) => {
 
   return source[componentName]?.groups || []
 }
-
-// ============================================================================
-// 리소스/이미지 처리 관련 유틸리티
-// ============================================================================
-
-/**
- * 이미지 경로를 완전한 호스트 URL로 변환합니다.
- * @param path 이미지 경로
- * @returns 완전한 이미지 URL
- */
-export const getResolvedHost = (path: string): string => {
-  const config = useRuntimeConfig()
-  //   const isDev = process.env.NODE_ENV === "development";
-  //   const rootPath = isDev ? "/images" : `${config.public.staticUrl}`;
-
-  const rootPath = config.public.staticUrl
-
-  return `${rootPath}${path}`
-}
-
-/**
- * 반응형 리소스(이미지/비디오)를 처리하여 PC/모바일 버전을 반환합니다.
- * @param pathArray 리소스 경로 배열
- * @param options 리소스 타입 옵션
- * @returns 반응형 리소스 객체 또는 null
- */
-export const getResponsiveSrc = (
-  pathArray: PageDataResourceGroupResPath,
-  options: {
-    resourcesType?: 'image' | 'bg' | 'video'
-  } = {}
-) => {
-  const { resourcesType = 'image' } = options
-  const pcField = resourcesType === 'video' ? 'path_vid_pc' : 'path_pc'
-  const mobileField = resourcesType === 'video' ? 'path_vid_mo' : 'path_mo'
-
-  if (!pathArray?.[mobileField]) {
-    return null
-  }
-
-  const resolvedImages = {
-    pc: getResolvedHost(pathArray[pcField] || pathArray[mobileField]),
-    mobile: getResolvedHost(pathArray[mobileField]),
-  }
-
-  if (resourcesType === 'bg') {
-    return {
-      '--pc-bg': `url(${resolvedImages.pc})`,
-      '--mobile-bg': `url(${resolvedImages.mobile})`,
-    }
-  }
-
-  return {
-    mobileSrc: resolvedImages.mobile,
-    pcSrc: resolvedImages.pc,
-  }
-}
-
-// ============================================================================
-// 스타일링 관련 유틸리티
-// ============================================================================
-
-/**
- * 반응형 배경 이미지를 위한 CSS 클래스를 반환합니다.
- * @returns 반응형 배경 클래스 배열
- */
-export const getResponsiveClass = () => {
-  return ['bg-[image:var(--mobile-bg)]', 'md:bg-[image:var(--pc-bg)]']
-}
diff --git a/layers/utils/styleUtil.ts b/layers/utils/styleUtil.ts
new file mode 100644
index 0000000..ee90ee9
--- /dev/null
+++ b/layers/utils/styleUtil.ts
@@ -0,0 +1,82 @@
+import type { PageDataResourceGroupResPath } from '#layers/types/api/pageData'
+
+/**
+ * 이미지 경로를 완전한 호스트 URL로 변환합니다.
+ * @param path 이미지 경로
+ * @returns 완전한 이미지 URL
+ */
+export const getResolvedHost = (path: string): string => {
+  const config = useRuntimeConfig()
+  //   const isDev = process.env.NODE_ENV === "development";
+  //   const rootPath = isDev ? "/images" : `${config.public.staticUrl}`;
+
+  const rootPath = config.public.staticUrl
+
+  return `${rootPath}${path}`
+}
+
+/**
+ * 반응형 리소스(이미지/비디오)를 처리하여 PC/모바일 버전을 반환합니다.
+ * @param pathArray 리소스 경로 배열
+ * @param options 리소스 타입 옵션
+ * @returns 반응형 리소스 객체 또는 null
+ */
+export const getResponsiveSrc = (
+  pathArray: PageDataResourceGroupResPath,
+  options: {
+    resourcesType?: 'image' | 'bg' | 'video'
+  } = {}
+) => {
+  const { resourcesType = 'image' } = options
+  const pcField = resourcesType === 'video' ? 'path_vid_pc' : 'path_pc'
+  const mobileField = resourcesType === 'video' ? 'path_vid_mo' : 'path_mo'
+
+  if (!pathArray?.[mobileField]) {
+    return null
+  }
+
+  const resolvedImages = {
+    pc: getResolvedHost(pathArray[pcField] || pathArray[mobileField]),
+    mobile: getResolvedHost(pathArray[mobileField]),
+  }
+
+  if (resourcesType === 'bg') {
+    return {
+      '--pc-bg': `url(${resolvedImages.pc})`,
+      '--mobile-bg': `url(${resolvedImages.mobile})`,
+    }
+  }
+
+  return {
+    mobileSrc: resolvedImages.mobile,
+    pcSrc: resolvedImages.pc,
+  }
+}
+
+/**
+ * 반응형 배경 이미지를 위한 CSS 클래스를 반환합니다.
+ * @returns 반응형 배경 클래스 배열
+ */
+export const getResponsiveClass = () => {
+  return ['bg-[image:var(--mobile-bg)]', 'md:bg-[image:var(--pc-bg)]']
+}
+
+/**
+ * 색상값을 반환합니다.
+ * @param colorName 색상 이름
+ * @param colorCode 색상 코드
+ * @returns 색상 값
+ */
+export const getColorCode = ({
+  colorName,
+  colorCode,
+}: {
+  colorName: string
+  colorCode: string
+}) => {
+  if (colorName) {
+    return `var(--${colorName})`
+  } else if (colorCode) {
+    return colorCode
+  }
+}