@ncds/ui-admin 1.8.21-alpha.5 → 1.8.21-alpha.7

package/dist/esm/assets/scripts/notification/FullWidthNotification.js

@@ -1,3 +1,4 @@
+import { HIDE_PERMANENTLY_LABEL } from '../../../constant/notification';
 import { sanitizeHtml } from '../utils/sanitize';
 import { CLASS_NAMES, FULL_WIDTH_ICON_MAP, FULL_WIDTH_SIZES, SVG_ICONS } from './const';
 import { bindNotificationEvents, createWrapperElement, renderActions, renderSupportingText, setupAutoClose } from './utils';
@@ -24,7 +25,8 @@ export class FullWidthNotification {
       actions,
       onClose,
       supportTextLink,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     } = this.options;
     const wrapper = createWrapperElement(CLASS_NAMES.FULL_WIDTH.BASE, color, className);
     const iconHtml = FULL_WIDTH_ICON_MAP[color](FULL_WIDTH_SIZES.ICON);
@@ -35,7 +37,8 @@ export class FullWidthNotification {
       actions,
       onClose,
       supportTextLink,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     }));
     return wrapper;
   }
@@ -47,7 +50,8 @@ export class FullWidthNotification {
       actions,
       onClose,
       supportTextLink,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     } = params;
     return `
       <div class="${CLASS_NAMES.FULL_WIDTH.CONTAINER}">
@@ -61,18 +65,25 @@ export class FullWidthNotification {
           </div>
           <div class="${CLASS_NAMES.FULL_WIDTH.ACTIONS_CONTAINER}">
             ${actions && actions.length > 0 ? renderActions(actions, CLASS_NAMES.FULL_WIDTH.ACTIONS) : ''}
-            ${this.renderHidePermanentlyButton(onHidePermanently)}
+            ${this.renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel)}
             ${this.renderCloseButton(onClose)}
           </div>
         </div>
       </div>
     `;
   }
-  renderHidePermanentlyButton(onHidePermanently) {
+  /**
+   * 다시보지 않기 버튼.
+   *
+   * `label`은 이 함수의 반환값이 `wrapper.innerHTML`에 들어가기 전에 `sanitizeHtml`로
+   * 처리되므로 별도 이스케이프하지 않는다 — `renderSupportingText`와 같은 정책이다.
+   */
+  renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel) {
     if (!onHidePermanently) return '';
+    const label = hidePermanentlyLabel ?? HIDE_PERMANENTLY_LABEL.fullWidth;
     return `
       <button type="button" class="ncua-notification__action-button ncua-notification__action-button--text ncua-full-width-notification__link" data-hide-permanently="true">
-        다시보지 않기
+        ${label}
       </button>
     `;
   }

package/dist/esm/assets/scripts/notification/MessageNotification.js

@@ -25,7 +25,8 @@ export class MessageNotification {
       className,
       actions,
       onClose,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     } = this.options;
     // message 타입은 neutral, error, warning, success 4가지 색상만 지원
     let actualColor = color;
@@ -54,7 +55,8 @@ export class MessageNotification {
       supportingText,
       actions,
       onClose,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     }));
     // FeaturedIcon을 content-wrapper에 추가
     if (featuredIconElement) {

package/dist/esm/assets/scripts/notification/messageTemplate.js

@@ -1,3 +1,4 @@
+import { HIDE_PERMANENTLY_LABEL } from '../../../constant/notification';
 import { CLASS_NAMES, MESSAGE_SIZES, SVG_ICONS } from './const';
 import { renderActions, renderSupportingText } from './utils';
 /**
@@ -16,7 +17,8 @@ export function buildMessageTemplate(params) {
     supportingText,
     actions,
     onClose,
-    onHidePermanently
+    onHidePermanently,
+    hidePermanentlyLabel
   } = params;
   return `
     <div class="${CLASS_NAMES.MESSAGE.CONTAINER}">
@@ -27,7 +29,12 @@ export function buildMessageTemplate(params) {
             ${renderSupportingText(supportingText, CLASS_NAMES.MESSAGE.SUPPORTING_TEXT)}
           </div>
         </div>
-        ${renderActionsContainer(actions, onClose, onHidePermanently)}
+        ${renderActionsContainer({
+    actions,
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  })}
       </div>
     </div>
   `;
@@ -37,27 +44,49 @@ export function buildMessageTemplate(params) {
  * 이 컨테이너의 gap(12px)이 두 그룹 사이 간격을 만든다.
  * 표시할 요소가 하나도 없으면 빈 컨테이너를 남기지 않는다.
  */
-function renderActionsContainer(actions, onClose, onHidePermanently) {
+function renderActionsContainer(params) {
+  const {
+    actions,
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  } = params;
   const actionsHtml = renderActions(actions ?? [], CLASS_NAMES.MESSAGE.ACTIONS, ACTION_BUTTON_SIZE);
-  const footerHtml = renderFooterContainer(onClose, onHidePermanently);
+  const footerHtml = renderFooterContainer({
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  });
   if (!actionsHtml && !footerHtml) return '';
   return `<div class="${CLASS_NAMES.MESSAGE.ACTIONS_CONTAINER}">${actionsHtml}${footerHtml}</div>`;
 }
 /** 다시 보지 않기 + 닫기 그룹. 전용 래퍼를 쓰는 이유는 `CLASS_NAMES.MESSAGE.FOOTER_CONTAINER` 참조. */
-function renderFooterContainer(onClose, onHidePermanently) {
+function renderFooterContainer(params) {
+  const {
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  } = params;
   if (!onHidePermanently && !onClose) return '';
   return `
     <div class="${CLASS_NAMES.MESSAGE.FOOTER_CONTAINER}">
-      ${renderHidePermanentlyButton(onHidePermanently)}
+      ${renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel)}
       ${renderCloseButton(onClose)}
     </div>
   `;
 }
-function renderHidePermanentlyButton(onHidePermanently) {
+/**
+ * 다시 보지 않기 버튼.
+ *
+ * `label`은 이 함수의 반환값이 `wrapper.innerHTML`에 들어가기 전에 `sanitizeHtml`로
+ * 처리되므로 별도 이스케이프하지 않는다 — `renderSupportingText`와 같은 정책이다.
+ */
+function renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel) {
   if (!onHidePermanently) return '';
+  const label = hidePermanentlyLabel ?? HIDE_PERMANENTLY_LABEL.message;
   return `
     <button type="button" class="${CLASS_NAMES.COMMON.ACTION_BUTTON} ${CLASS_NAMES.MESSAGE.HIDE_LINK}" data-hide-permanently="true">
-      다시 보지 않기
+      ${label}
     </button>
   `;
 }

package/dist/esm/constant/notification.js

@@ -0,0 +1,15 @@
+/**
+ * 다시보지 않기 버튼의 타입별 기본 문구.
+ *
+ * `hidePermanentlyLabel`을 지정하지 않았을 때 쓰인다.
+ * React(`src/components/overlays/notification/`)와 Vanilla(`assets/scripts/notification/`)
+ * 두 구현이 이 상수를 함께 참조한다 — 문구가 하드코딩으로 흩어져 서로 어긋나던 문제(#460)를
+ * 막기 위한 단일 출처다.
+ *
+ * `message`와 `fullWidth`의 띄어쓰기가 다른 것은 오타가 아니라 현행 유지다.
+ * 표기 통일은 별도 결정 사항이며, 결정되면 이 파일 한 곳만 고치면 된다.
+ */
+export const HIDE_PERMANENTLY_LABEL = {
+  message: '다시 보지 않기',
+  fullWidth: '다시보지 않기'
+};

package/dist/esm/src/components/forms-and-input/input-base/InputBase.js

@@ -32,26 +32,27 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
     ...props
   } = _ref;
   const inputRef = useRef(null);
-  const [textCount, setTextCount] = useState(0);
-  const [hasValue, setHasValue] = useState(false);
-  // 값 유무는 DOM에서 읽는다 — props.value로 판정하면 uncontrolled Input에서 항상 빈 값으로 보인다.
-  // biome-ignore lint/correctness/useExhaustiveDependencies: controlled 값이 프로그래밍적으로 바뀔 때는 input 이벤트가 나지 않아 props.value로 재동기화해야 한다
+  // controlled 인풋은 props.value 로 길이를 알 수 있으므로 상태를 두지 않는다.
+  // 입력마다 setState 를 하면 조합 중(한글 IME)에 리렌더가 끼어들어 조합이 끊긴다.
+  const isControlled = props.value !== undefined;
+  const [uncontrolledLength, setUncontrolledLength] = useState(0);
+  const valueLength = isControlled ? String(props.value ?? '').length : uncontrolledLength;
+  const hasValue = valueLength > 0;
+  const textCount = valueLength;
+  // uncontrolled 인풋만 DOM 값을 읽어 따라간다 — props.value 가 없어 길이를 알 방법이 이것뿐이다.
   useEffect(() => {
+    if (isControlled) return;
     const input = inputRef.current;
     if (!input) return;
     const syncFromInput = () => {
-      const {
-        length
-      } = input.value;
-      setHasValue(length > 0);
-      setTextCount(length);
+      setUncontrolledLength(input.value.length);
     };
     syncFromInput();
     input.addEventListener('input', syncFromInput);
     return () => {
       input.removeEventListener('input', syncFromInput);
     };
-  }, [props.value]);
+  }, [isControlled]);
   const renderOutsideSlot = (slot, position) => {
     if (slot.type === 'custom' && slot.placement !== 'outside') {
       return null;
@@ -65,10 +66,15 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
           children: slot.label
         });
       case 'text':
-        return _jsx("span", {
-          className: classNames(`ncua-input__${position}-text`, `ncua-input__${position}-text--${size}`),
-          children: slot.text
-        });
+        {
+          // 클래스명은 리터럴로 쓴다 — MCP 의 BEM 추출기가 `ncua-input__${position}-text` 형태의
+          // 템플릿 리터럴에서는 `ncua-input__` 조각만 읽어 완성된 클래스를 잡지 못한다.
+          const textClass = position === 'leading' ? 'ncua-input__leading-text' : 'ncua-input__trailing-text';
+          return _jsx("span", {
+            className: classNames(textClass, `${textClass}--${size}`),
+            children: slot.text
+          });
+        }
       case 'custom':
         return slot.children;
       default:

package/dist/esm/src/components/index.js

@@ -51,6 +51,7 @@ export * from './navigation/vertical-tab';
 export * from './overlays/dropdown';
 export * from './overlays/modal';
 export * from './overlays/notification';
+export * from './overlays/postcode-search-modal';
 export * from './overlays/tooltip';
 // Shared
 export * from './select-dropdown';

package/dist/esm/src/components/overlays/notification/FullWidthNotification.js

@@ -3,6 +3,7 @@ import { AlertTriangle, CheckCircle, InfoCircle, MessageChatSquare, XClose } fro
 import classNames from 'classnames';
 import { forwardRef, useEffect, useRef, useState } from 'react';
 import { COLOR } from '../../../../constant/color';
+import { HIDE_PERMANENTLY_LABEL } from '../../../../constant/notification';
 const iconMap = {
   neutral: MessageChatSquare,
   error: AlertTriangle,
@@ -28,6 +29,7 @@ const FullWidthNotification = /*#__PURE__*/forwardRef((_ref, ref) => {
     autoClose = 0,
     supportTextLink,
     onHidePermanently,
+    hidePermanentlyLabel = HIDE_PERMANENTLY_LABEL.fullWidth,
     ...rest
   } = _ref;
   const [shouldRemove, setShouldRemove] = useState(false);
@@ -109,7 +111,7 @@ const FullWidthNotification = /*#__PURE__*/forwardRef((_ref, ref) => {
             type: "button",
             className: classNames('ncua-notification__action-button', 'ncua-notification__action-button--text', 'ncua-full-width-notification__link'),
             onClick: onHidePermanently,
-            children: "\uB2E4\uC2DC\uBCF4\uC9C0 \uC54A\uAE30"
+            children: hidePermanentlyLabel
           }), onClose && _jsx("button", {
             type: "button",
             className: "ncua-full-width-notification__close-button",

package/dist/esm/src/components/overlays/notification/MessageNotification.js

@@ -26,6 +26,7 @@ const MessageNotification = /*#__PURE__*/forwardRef((_ref, ref) => {
     className,
     actions,
     onHidePermanently,
+    hidePermanentlyLabel,
     ...rest
   } = _ref;
   // message 타입은 neutral, error, warning, success 4가지 색상만 지원
@@ -49,6 +50,7 @@ const MessageNotification = /*#__PURE__*/forwardRef((_ref, ref) => {
           actions: actions,
           onClose: onClose,
           onHidePermanently: onHidePermanently,
+          hidePermanentlyLabel: hidePermanentlyLabel,
           closeIconColor: COLOR[iconColorMap[validColor] || 'gray700']
         })]
       })

package/dist/esm/src/components/overlays/notification/MessageNotificationParts.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Pin02, XClose } from '@ncds/ui-admin-icon';
+import { HIDE_PERMANENTLY_LABEL } from '../../../../constant/notification';
 import { Button } from '../../action/button';
 import { FeaturedIcon } from '../../image-and-icons/featured-icon/FeaturedIcon';
 /** 아이콘 + 제목/서포팅 텍스트 영역. */
@@ -44,6 +45,7 @@ const MessageNotificationActions = _ref2 => {
     actions,
     onClose,
     onHidePermanently,
+    hidePermanentlyLabel = HIDE_PERMANENTLY_LABEL.message,
     closeIconColor
   } = _ref2;
   const hasActions = Boolean(actions?.length);
@@ -65,7 +67,7 @@ const MessageNotificationActions = _ref2 => {
         type: "button",
         className: "ncua-notification__action-button ncua-message-notification__hide-link",
         onClick: onHidePermanently,
-        children: "\uB2E4\uC2DC \uBCF4\uC9C0 \uC54A\uAE30"
+        children: hidePermanentlyLabel
       }), onClose && _jsx("button", {
         type: "button",
         className: "ncua-message-notification__close-button",

package/dist/esm/src/components/overlays/notification/__tests__/hidePermanentlyLabel.test.js

@@ -0,0 +1,206 @@
+// @vitest-environment jsdom
+import { createElement } from 'react';
+import { createRoot } from 'react-dom/client';
+import { act } from 'react-dom/test-utils';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { FullWidthNotification } from '../FullWidthNotification';
+import { MessageNotification } from '../MessageNotification';
+import { Notification } from '../Notification';
+// React 18에서 act() 사용 시 필요한 플래그 (미설정 시 console.error 경고 발생)
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+const SELECTOR = {
+  /** message 타입 — 고도몰이 textContent 덮어쓰기에 쓰는 하위호환 계약 선택자. */
+  MESSAGE_HIDE_LINK: '.ncua-message-notification__hide-link',
+  /** full-width 타입 — 다시보지 않기 버튼. */
+  FULL_WIDTH_LINK: '.ncua-full-width-notification__link',
+  ACTION_BUTTON: '.ncua-notification__action-button'
+};
+/** 각 타입의 현행 기본 문구. 표기 통일은 별도 결정 사항이므로 서로 다른 값을 그대로 유지한다. */
+const DEFAULT_LABEL = {
+  MESSAGE: '다시 보지 않기',
+  FULL_WIDTH: '다시보지 않기'
+};
+const mounted = [];
+function render(element) {
+  const container = document.createElement('div');
+  document.body.appendChild(container);
+  const root = createRoot(container);
+  act(() => {
+    root.render(element);
+  });
+  mounted.push({
+    root,
+    container
+  });
+  return container;
+}
+function renderMessage() {
+  let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(/*#__PURE__*/createElement(MessageNotification, {
+    title: '알림 제목',
+    ...props
+  }));
+}
+function renderFullWidth() {
+  let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(/*#__PURE__*/createElement(FullWidthNotification, {
+    title: '알림 제목',
+    ...props
+  }));
+}
+function renderNotification() {
+  let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(/*#__PURE__*/createElement(Notification, {
+    title: '알림 제목',
+    ...props
+  }));
+}
+afterEach(() => {
+  for (const {
+    root,
+    container
+  } of mounted.splice(0)) {
+    act(() => {
+      root.unmount();
+    });
+    container.remove();
+  }
+});
+describe('hidePermanentlyLabel (React) — message 타입', () => {
+  it('R-1: prop 미지정 시 기본 문구 "다시 보지 않기"가 렌더된다', () => {
+    // Given: hidePermanentlyLabel 없이 onHidePermanently만 주어지고
+    // When: MessageNotification을 렌더하면
+    const container = renderMessage({
+      onHidePermanently: vi.fn()
+    });
+    // Then: 현행 기본 문구가 그대로 노출된다 (시각적 변화 0)
+    const hideLink = container.querySelector(SELECTOR.MESSAGE_HIDE_LINK);
+    expect(hideLink?.textContent).toBe(DEFAULT_LABEL.MESSAGE);
+  });
+  it('R-2: prop 지정 시 그 값이 렌더된다', () => {
+    // Given: 커스텀 라벨이 주어지고
+    // When: 렌더하면
+    const container = renderMessage({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '30일간 보지 않기'
+    });
+    // Then: 하드코딩 문구 대신 전달한 값이 노출된다
+    const hideLink = container.querySelector(SELECTOR.MESSAGE_HIDE_LINK);
+    expect(hideLink?.textContent).toBe('30일간 보지 않기');
+  });
+  it('R-3: ReactNode 라벨을 받아 엘리먼트로 렌더한다', () => {
+    // Given: 문자열이 아닌 ReactNode 라벨이 주어지고
+    const label = /*#__PURE__*/createElement('span', {
+      className: 'custom-hide-label'
+    }, '커스텀 노드');
+    // When: 렌더하면
+    const container = renderMessage({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: label
+    });
+    // Then: 노드가 hide-link 내부에 그대로 마운트된다
+    const hideLink = container.querySelector(SELECTOR.MESSAGE_HIDE_LINK);
+    expect(hideLink?.querySelector('.custom-hide-label')?.textContent).toBe('커스텀 노드');
+  });
+  it('R-4: 라벨을 바꿔도 __hide-link 클래스 계약이 유지된다', () => {
+    // Given: 커스텀 라벨이 주어지고
+    // When: 렌더하면
+    const container = renderMessage({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '커스텀'
+    });
+    // Then: 고도몰의 textContent 덮어쓰기가 계속 동작하도록 기존 클래스가 모두 남는다
+    const hideLink = container.querySelector(SELECTOR.MESSAGE_HIDE_LINK);
+    expect(hideLink).not.toBeNull();
+    expect(hideLink?.classList.contains('ncua-notification__action-button')).toBe(true);
+    expect(hideLink?.classList.contains('ncua-message-notification__hide-link')).toBe(true);
+  });
+  it('R-5: onHidePermanently 없이 라벨만 주면 버튼이 렌더되지 않는다', () => {
+    // Given: 핸들러 없이 라벨만 주어지고
+    // When: 렌더하면
+    const container = renderMessage({
+      hidePermanentlyLabel: '커스텀'
+    });
+    // Then: 라벨만으로는 버튼이 생기지 않는다 (핸들러가 렌더 조건)
+    expect(container.querySelector(SELECTOR.MESSAGE_HIDE_LINK)).toBeNull();
+  });
+  it('R-6: 라벨이 DOM 속성으로 새어나가지 않는다', () => {
+    // Given: 커스텀 라벨이 주어지고
+    // When: 렌더하면
+    const container = renderMessage({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '커스텀'
+    });
+    // Then: rest 스프레드를 타고 루트 div의 속성으로 흘러들지 않는다
+    const root = container.querySelector('.ncua-message-notification');
+    expect(root?.hasAttribute('hidepermanentlylabel')).toBe(false);
+  });
+});
+describe('hidePermanentlyLabel (React) — full-width 타입', () => {
+  it('R-7: prop 미지정 시 기본 문구 "다시보지 않기"가 렌더된다', () => {
+    // Given: hidePermanentlyLabel 없이 onHidePermanently만 주어지고
+    // When: FullWidthNotification을 렌더하면
+    const container = renderFullWidth({
+      onHidePermanently: vi.fn()
+    });
+    // Then: message 타입과 다른 현행 문구가 그대로 유지된다 (표기 통일은 별도 결정)
+    const hideButton = container.querySelector(SELECTOR.FULL_WIDTH_LINK);
+    expect(hideButton?.textContent).toBe(DEFAULT_LABEL.FULL_WIDTH);
+  });
+  it('R-8: prop 지정 시 그 값이 렌더된다', () => {
+    // Given: 커스텀 라벨이 주어지고
+    // When: 렌더하면
+    const container = renderFullWidth({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '오늘 하루 보지 않기'
+    });
+    // Then: 전달한 값이 노출된다
+    const hideButton = container.querySelector(SELECTOR.FULL_WIDTH_LINK);
+    expect(hideButton?.textContent).toBe('오늘 하루 보지 않기');
+  });
+  it('R-9: 라벨을 바꿔도 기존 클래스 계약이 유지된다', () => {
+    // Given: 커스텀 라벨이 주어지고
+    // When: 렌더하면
+    const container = renderFullWidth({
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '커스텀'
+    });
+    // Then: 액션 버튼 클래스가 그대로 남는다
+    const hideButton = container.querySelector(SELECTOR.FULL_WIDTH_LINK);
+    expect(hideButton?.classList.contains('ncua-notification__action-button')).toBe(true);
+    expect(hideButton?.classList.contains('ncua-notification__action-button--text')).toBe(true);
+  });
+  it('R-10: onHidePermanently 없이 라벨만 주면 버튼이 렌더되지 않는다', () => {
+    // Given: 핸들러 없이 라벨만 주어지고
+    // When: 렌더하면
+    const container = renderFullWidth({
+      hidePermanentlyLabel: '커스텀'
+    });
+    // Then: 액션 버튼이 생기지 않는다
+    expect(container.querySelector(SELECTOR.ACTION_BUTTON)).toBeNull();
+  });
+});
+describe('hidePermanentlyLabel (React) — Notification 공유 Props 경유', () => {
+  it('R-11: type="message"에서 공유 Props의 라벨이 전달된다', () => {
+    // Given: 공유 Notification props로 라벨이 주어지고
+    // When: type="message"로 렌더하면
+    const container = renderNotification({
+      type: 'message',
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '공유 프롭 라벨'
+    });
+    // Then: message 구현까지 라벨이 도달한다
+    expect(container.querySelector(SELECTOR.MESSAGE_HIDE_LINK)?.textContent).toBe('공유 프롭 라벨');
+  });
+  it('R-12: type="full-width"에서 공유 Props의 라벨이 전달된다', () => {
+    // Given: 공유 Notification props로 라벨이 주어지고
+    // When: type="full-width"로 렌더하면
+    const container = renderNotification({
+      type: 'full-width',
+      onHidePermanently: vi.fn(),
+      hidePermanentlyLabel: '공유 프롭 라벨'
+    });
+    // Then: full-width 구현까지 라벨이 도달한다
+    expect(container.querySelector(SELECTOR.FULL_WIDTH_LINK)?.textContent).toBe('공유 프롭 라벨');
+  });
+});