@ncds/ui-admin 1.8.4 → 1.8.5

package/dist/esm/src/components/select-dropdown/SelectDropdown.js

@@ -20,6 +20,7 @@ const SelectDropdown = /*#__PURE__*/forwardRef((_ref, ref) => {
     multiple = false,
     showFooterButtons = false,
     selectAllButtonText = '전체 선택',
+    showSelectAllAction = true,
     onSelectAll,
     onEdit,
     onComplete,
@@ -85,7 +86,7 @@ const SelectDropdown = /*#__PURE__*/forwardRef((_ref, ref) => {
         className: "ncua-select-dropdown__footer-buttons",
         children: [_jsx("div", {
           className: "ncua-select-dropdown__footer-left",
-          children: multiple && _jsx(Button, {
+          children: multiple && showSelectAllAction && _jsx(Button, {
             label: selectAllButtonText,
             hierarchy: "text",
             size: "xs",

package/dist/esm/src/contexts/FloatingContext.js

@@ -0,0 +1,4 @@
+import { createContext, useContext } from 'react';
+const FloatingContext = /*#__PURE__*/createContext(null);
+export const FloatingProvider = FloatingContext.Provider;
+export const useFloatingContext = () => useContext(FloatingContext);

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

@@ -0,0 +1 @@
+export * from './FloatingContext';

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

@@ -2,5 +2,6 @@
 // 드롭다운 관련 hooks
 export * from './dropdown';
 export * from './useCallbackRef';
+export * from './useFloatingPosition';
 export * from './useMediaQuery';
 export * from './useMergeRefs';

package/dist/esm/src/hooks/useFloatingPosition.js

@@ -0,0 +1,71 @@
+import { useLayoutEffect, useState } from 'react';
+const FLOATING_Z_INDEX = 1500;
+export const useFloatingPosition = _ref => {
+  let {
+    enabled,
+    isOpen,
+    triggerRef,
+    floatingRef,
+    direction,
+    offset = 4,
+    align = 'left',
+    matchTriggerWidth = false
+  } = _ref;
+  const [style, setStyle] = useState(null);
+  useLayoutEffect(() => {
+    if (!enabled || !isOpen) {
+      setStyle(null);
+      return;
+    }
+    const trigger = triggerRef.current;
+    if (!trigger) return;
+    const calculatePosition = (trigger, floatingHeight, floatingWidth) => {
+      const top = direction === 'up' ? trigger.top - floatingHeight - offset : trigger.bottom + offset;
+      const left = align === 'right' ? trigger.right - floatingWidth : trigger.left;
+      return {
+        top,
+        left
+      };
+    };
+    const update = () => {
+      const t = triggerRef.current;
+      const f = floatingRef.current;
+      if (!t) return;
+      const r = t.getBoundingClientRect();
+      const floatingHeight = f?.offsetHeight ?? 0;
+      const floatingWidth = matchTriggerWidth ? r.width : f?.offsetWidth ?? r.width;
+      const {
+        top,
+        left
+      } = calculatePosition(r, floatingHeight, floatingWidth);
+      // matchTriggerWidth=true: width는 max-content(콘텐츠 자연 너비), min-width만 trigger 너비로 보장.
+      // 옵션이 짧으면 trigger 너비, 길면 자연 확장 — 기존 absolute 모드와 동일한 UX.
+      setStyle({
+        position: 'fixed',
+        top,
+        left,
+        zIndex: FLOATING_Z_INDEX,
+        ...(matchTriggerWidth ? {
+          minWidth: r.width
+        } : {})
+      });
+    };
+    update();
+    window.addEventListener('scroll', update, true);
+    window.addEventListener('resize', update);
+    const triggerObserver = new ResizeObserver(update);
+    triggerObserver.observe(trigger);
+    let floatingObserver;
+    if (floatingRef.current) {
+      floatingObserver = new ResizeObserver(update);
+      floatingObserver.observe(floatingRef.current);
+    }
+    return () => {
+      window.removeEventListener('scroll', update, true);
+      window.removeEventListener('resize', update);
+      triggerObserver.disconnect();
+      floatingObserver?.disconnect();
+    };
+  }, [enabled, isOpen, direction, offset, align, matchTriggerWidth, triggerRef, floatingRef]);
+  return style;
+};

package/dist/esm/src/hooks/usePortalState.js

@@ -0,0 +1,10 @@
+import { useFloatingContext } from '../contexts/FloatingContext';
+export const usePortalState = usePortalProp => {
+  const floatingContext = useFloatingContext();
+  const shouldPortal = usePortalProp ?? floatingContext?.preferPortal ?? false;
+  const portalContainer = floatingContext?.portalContainer ?? (typeof document !== 'undefined' ? document.body : null);
+  return {
+    shouldPortal,
+    portalContainer
+  };
+};

package/dist/esm/src/utils/dropdown/maxSelection.js

@@ -0,0 +1,27 @@
+/**
+ * SelectBox / ComboBox 공통 — 최대 선택 개수 제한 활성 여부 판정.
+ *
+ * React 훅(`useMultiSelect`)과 vanilla 드롭다운(`DropdownModel`)가 동일 로직을 공유하므로
+ * 두 곳에 정의가 갈라지지 않도록 단일 source-of-truth로 둔다.
+ *
+ * **계약**
+ * - `0` 이상의 정수 → 활성 (단, `0`은 모든 새 선택을 차단하는 의미)
+ * - 음수 / 비정수 / `undefined` / `null` → 비활성 (제한 없는 것과 동일)
+ *
+ * `0`을 활성으로 보는 이유: 호출자가 `maxSelection={0}`을 명시적으로 전달했을 때
+ * "선택 자체를 막겠다"는 의도로 해석하기 위함. 음수는 일반적으로 "값 없음"의 sentinel이므로 비활성.
+ */
+export const isMaxSelectionLimitActive = maxSelection => typeof maxSelection === 'number' && Number.isInteger(maxSelection) && maxSelection >= 0;
+/**
+ * 현재 선택 길이가 최대치에 도달했는지 단일 함수로 판정.
+ *
+ * 호출 측에서 `>=`을 직접 작성하지 않도록 의미를 노출하고, type predicate가 내부에서 적용되어
+ * `maxSelection`의 narrowing이 보장된다 (외부 predicate 호출로 인한 narrowing 누락 방지).
+ *
+ * - 제한 비활성(음수 / null / undefined / 비정수): 항상 `false`.
+ * - 활성: `currentLength >= maxSelection`.
+ */
+export const isMaxSelectionReached = (currentLength, maxSelection) => {
+  if (!isMaxSelectionLimitActive(maxSelection)) return false;
+  return currentLength >= maxSelection;
+};

package/dist/esm/src/utils/dropdown/multiSelect.js

@@ -1,3 +1,5 @@
+import { useCallback, useMemo } from 'react';
+import { isMaxSelectionLimitActive, isMaxSelectionReached } from './maxSelection';
 /**
  * 전체 선택 상태를 확인하는 유틸 함수
  */
@@ -44,25 +46,79 @@ export const removeTagFromSelected = (selectedValues, tagIdToRemove) => {
   return selectedValues.filter(id => id !== tagIdToRemove);
 };
 /**
- * 전체 선택 관련 로직을 한 번에 처리하는 커스텀 훅
+ * 최대 선택 개수 관련 응집을 별도 훅으로 분리.
+ *
+ * - `isMaxSelectionActive`: 제한 활성 여부.
+ * - `isMaxReached`: 현재 선택 길이가 최대치에 도달했는지.
+ * - `canAdd(currentLength)`: 새 항목 추가가 허용되는지 (도달 시 `false`).
+ *
+ * 도메인 규칙(`>=` 비교 등)을 외부로 노출하지 않고 헬퍼를 통해 의미만 반환한다.
+ * `useMultiSelect`가 내부에서 사용하지만, 단독으로도 필요한 호출자가 쓸 수 있게 export한다.
  */
-export const useMultiSelect = (selectedValues, options, selectText, deselectText) => {
+export const useMaxSelection = (selectedValues, maxSelection) => {
+  const isMaxSelectionActive = isMaxSelectionLimitActive(maxSelection);
+  const isMaxReached = isMaxSelectionReached(selectedValues.length, maxSelection);
+  const canAdd = useCallback(currentLength => !isMaxSelectionReached(currentLength, maxSelection), [maxSelection]);
+  return {
+    isMaxSelectionActive,
+    isMaxReached,
+    canAdd
+  };
+};
+/**
+ * 전체 선택 관련 로직을 한 번에 처리하는 커스텀 훅.
+ *
+ * 시그니처는 호출자가 maxSelection만 지정하더라도 텍스트 라벨을 건너뛰지 않도록 옵션 객체로 받는다.
+ *
+ * **반환의 `tryToggle`**: multiple 토글 결과를 직접 돌려준다.
+ *  - 새 배열 반환: 정상 토글 (추가 또는 해제).
+ *  - `null` 반환: 최대 개수 도달로 추가가 차단됨 (호출자는 변경 없이 종료해야 함).
+ *
+ * 호출자가 `>= maxSelection` 같은 도메인 규칙을 직접 검사하지 않도록 결과만 노출한다.
+ */
+export const useMultiSelect = function (selectedValues, options) {
+  let config = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  const {
+    selectText,
+    deselectText,
+    maxSelection
+  } = config;
   const isAllSelected = isAllItemsSelected(selectedValues, options);
   const buttonText = getSelectAllButtonText(selectedValues, options, selectText, deselectText);
-  const toggleSelectAll = () => {
-    return handleSelectAllItems(selectedValues, options);
-  };
-  const getSelectedTagsData = () => {
-    return getSelectedTags(selectedValues, options);
-  };
-  const removeTag = tagId => {
-    return removeTagFromSelected(selectedValues, tagId);
-  };
-  return {
+  const {
+    isMaxSelectionActive,
+    isMaxReached,
+    canAdd
+  } = useMaxSelection(selectedValues, maxSelection);
+  const toggleSelectAll = useCallback(() => handleSelectAllItems(selectedValues, options), [selectedValues, options]);
+  const getSelectedTagsData = useCallback(() => getSelectedTags(selectedValues, options), [selectedValues, options]);
+  const removeTag = useCallback(tagId => removeTagFromSelected(selectedValues, tagId), [selectedValues]);
+  /**
+   * multiple 선택 토글을 한 번에 처리한다.
+   * - 이미 포함된 항목: 해제 (배열에서 제거하여 반환).
+   * - 미포함 항목: 추가 시도. 최대치 도달이면 `null` 반환(차단).
+   *
+   * 호출 측은 `null` 여부만 확인하면 되며 maxSelection 도메인 규칙을 알 필요가 없다.
+   */
+  const tryToggle = useCallback((optionId, currentArray) => {
+    const base = Array.isArray(currentArray) ? currentArray : [];
+    const idx = base.indexOf(optionId);
+    if (idx > -1) {
+      const next = [...base];
+      next.splice(idx, 1);
+      return next;
+    }
+    if (!canAdd(base.length)) return null;
+    return [...base, optionId];
+  }, [canAdd]);
+  return useMemo(() => ({
     isAllSelected,
     buttonText,
     toggleSelectAll,
     getSelectedTagsData,
-    removeTag
-  };
+    removeTag,
+    isMaxSelectionActive,
+    isMaxReached,
+    tryToggle
+  }), [isAllSelected, buttonText, toggleSelectAll, getSelectedTagsData, removeTag, isMaxSelectionActive, isMaxReached, tryToggle]);
 };

package/dist/temp/assets/scripts/featuredIcon.d.ts

@@ -0,0 +1,22 @@
+export type FeaturedIconTheme = 'light-circle' | 'dark-circle' | 'outline-circle' | 'square-outline';
+export type FeaturedIconColor = 'neutral' | 'error' | 'warning' | 'success';
+export type FeaturedIconSize = 'sm' | 'md' | 'lg' | 'xl';
+export interface FeaturedIconOptions {
+    svgString: string;
+    theme?: FeaturedIconTheme;
+    color?: FeaturedIconColor;
+    size?: FeaturedIconSize;
+    className?: string;
+}
+export declare class FeaturedIcon {
+    private element;
+    private options;
+    constructor(options: FeaturedIconOptions);
+    private createElement;
+    private addSizeToSvg;
+    getElement(): HTMLElement;
+    updateColor(color: FeaturedIconColor): void;
+    updateSize(size: FeaturedIconSize): void;
+    destroy(): void;
+    static create(options: FeaturedIconOptions): FeaturedIcon;
+}

package/dist/temp/assets/scripts/featuredIcon.js

@@ -0,0 +1,79 @@
+// React 컴포넌트와 동일하게 구성
+const iconSizeMap = {
+    sm: 16,
+    md: 20,
+    lg: 24,
+    xl: 28,
+};
+export class FeaturedIcon {
+    constructor(options) {
+        this.options = {
+            theme: 'light-circle',
+            color: 'neutral',
+            size: 'sm',
+            className: '',
+            ...options,
+        };
+        this.element = this.createElement();
+    }
+    // svgString ( ICON SVG ) 을 받아서 요소를 생성
+    createElement() {
+        const { theme, color, size, className, svgString } = this.options;
+        // React FeaturedIcon과 동일한 클래스 구조
+        const classes = [
+            'ncua-featured-icon',
+            `ncua-featured-icon--${theme}`,
+            `ncua-featured-icon--${color}`,
+            `ncua-featured-icon--${size}`,
+        ];
+        if (className) {
+            classes.push(className);
+        }
+        const div = document.createElement('div');
+        div.className = classes.join(' ');
+        // outline-circle 테마일 때 추가 요소들 (React 컴포넌트와 동일)
+        if (theme === 'outline-circle') {
+            const innerOutline = document.createElement('div');
+            innerOutline.className = 'ncua-featured-icon__outline ncua-featured-icon__outline--inner';
+            div.appendChild(innerOutline);
+            const outerOutline = document.createElement('div');
+            outerOutline.className = 'ncua-featured-icon__outline ncua-featured-icon__outline--outer';
+            div.appendChild(outerOutline);
+        }
+        // SVG 아이콘 추가
+        const iconSize = iconSizeMap[size];
+        const svgWithSize = this.addSizeToSvg(svgString, iconSize);
+        div.innerHTML += svgWithSize;
+        return div;
+    }
+    addSizeToSvg(svgString, size) {
+        return svgString.replace(/<svg([^>]*)>/, `<svg$1 width="${size}" height="${size}">`);
+    }
+    // Public methods
+    getElement() {
+        return this.element;
+    }
+    updateColor(color) {
+        this.element.className = this.element.className.replace(/ncua-featured-icon--(neutral|error|warning|success)/, `ncua-featured-icon--${color}`);
+        this.options.color = color;
+    }
+    updateSize(size) {
+        const iconSize = iconSizeMap[size];
+        this.element.className = this.element.className.replace(/ncua-featured-icon--(sm|md|lg|xl)/, `ncua-featured-icon--${size}`);
+        const svgIcon = this.element.querySelector('svg');
+        if (svgIcon) {
+            svgIcon.setAttribute('width', String(iconSize));
+            svgIcon.setAttribute('height', String(iconSize));
+        }
+        this.options.size = size;
+    }
+    destroy() {
+        if (this.element.parentNode) {
+            this.element.parentNode.removeChild(this.element);
+        }
+    }
+    // Static factory method
+    static create(options) {
+        return new FeaturedIcon(options);
+    }
+}

package/dist/temp/assets/scripts/notification/FloatingNotification.d.ts

@@ -0,0 +1,24 @@
+import type { BaseNotificationOptions } from './const';
+export interface FloatingNotificationOptions extends BaseNotificationOptions {
+    type?: 'floating';
+}
+export declare class FloatingNotification {
+    private element;
+    private options;
+    private autoCloseTimer?;
+    private featuredIcon?;
+    private mobileCleanup?;
+    constructor(options: FloatingNotificationOptions);
+    private createElement;
+    private buildTemplate;
+    private renderCloseButton;
+    private setupMobileListener;
+    private updateMobileStyles;
+    private bindEvents;
+    private setupAutoClose;
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    static create(options: FloatingNotificationOptions): FloatingNotification;
+}

package/dist/temp/assets/scripts/notification/FloatingNotification.js

@@ -0,0 +1,156 @@
+import { MEDIA_QUERY } from '../../../src/constant/breakpoint';
+import { FeaturedIcon } from '../featuredIcon';
+import { ButtonCloseX } from '../shared/ButtonCloseX';
+import { sanitizeHtml } from '../utils/sanitize';
+import { CLASS_NAMES, FLOATING_ICON_MAP, getSizes } from './const';
+import { bindNotificationEvents, createWrapperElement, isMobile, renderActions, renderSupportingText, setupAutoClose, } from './utils';
+export class FloatingNotification {
+    constructor(options) {
+        this.options = {
+            color: 'neutral',
+            className: '',
+            actions: [],
+            autoClose: 0,
+            supportingText: undefined,
+            ...options,
+        };
+        this.element = this.createElement();
+        this.bindEvents();
+        this.setupAutoClose();
+        this.setupMobileListener();
+    }
+    createElement() {
+        const { title, supportingText, color, className, actions, onClose } = this.options;
+        // 플로팅 알림에서 info 색상 사용 시 neutral로 대체
+        let actualColor = color;
+        if (color === 'info') {
+            actualColor = 'neutral';
+        }
+        const wrapper = createWrapperElement(CLASS_NAMES.FLOATING.BASE, actualColor, className);
+        const iconFunction = FLOATING_ICON_MAP[actualColor];
+        const mobile = isMobile();
+        // FeaturedIcon 생성
+        let featuredIconElement = null;
+        if (iconFunction) {
+            const size = getSizes.featuredIcon(mobile);
+            const iconSize = getSizes.iconPixel(mobile);
+            const iconSvg = iconFunction(iconSize);
+            this.featuredIcon = FeaturedIcon.create({
+                svgString: iconSvg,
+                theme: 'dark-circle',
+                color: actualColor,
+                size: size,
+            });
+            featuredIconElement = this.featuredIcon.getElement();
+        }
+        wrapper.innerHTML = sanitizeHtml(this.buildTemplate({
+            title,
+            supportingText,
+            actions,
+            onClose,
+            isMobile: mobile,
+        }));
+        // FeaturedIcon을 container에 추가
+        if (featuredIconElement) {
+            const container = wrapper.querySelector(`.${CLASS_NAMES.FLOATING.CONTAINER}`);
+            if (container) {
+                container.insertBefore(featuredIconElement, container.firstChild);
+            }
+        }
+        return wrapper;
+    }
+    buildTemplate(params) {
+        const { title, supportingText, actions, onClose, isMobile } = params;
+        return `
+      <div class="${CLASS_NAMES.FLOATING.CONTENT}">
+        <div class="${CLASS_NAMES.FLOATING.CONTAINER}">
+          <div class="${CLASS_NAMES.FLOATING.TEXT_CONTAINER}">
+            <div class="${CLASS_NAMES.FLOATING.TITLE_WRAPPER}">
+              <span class="${CLASS_NAMES.FLOATING.TITLE}">${title}</span>
+            </div>
+            ${renderSupportingText(supportingText, CLASS_NAMES.FLOATING.SUPPORTING_TEXT)}
+            ${actions && actions.length > 0 ? renderActions(actions, CLASS_NAMES.FLOATING.ACTIONS) : ''}
+          </div>
+        </div>
+      </div>
+      ${this.renderCloseButton(onClose, isMobile)}
+    `;
+    }
+    renderCloseButton(onClose, isMobile = false) {
+        if (!onClose)
+            return '';
+        const size = getSizes.closeButton(isMobile);
+        return ButtonCloseX(size, 'light', CLASS_NAMES.FLOATING.CLOSE_BUTTON, '알림 닫기', onClose);
+    }
+    setupMobileListener() {
+        const mediaQuery = window.matchMedia(MEDIA_QUERY.mobile);
+        const handleChange = (e) => {
+            this.updateMobileStyles(e.matches);
+            if (e.matches && this.options.onClose) {
+                this.options.onClose();
+                this.remove();
+            }
+        };
+        handleChange({ matches: mediaQuery.matches });
+        mediaQuery.addEventListener('change', handleChange);
+        this.mobileCleanup = () => {
+            mediaQuery.removeEventListener('change', handleChange);
+        };
+    }
+    updateMobileStyles(mobile) {
+        if (this.featuredIcon) {
+            const newSize = getSizes.featuredIcon(mobile);
+            this.featuredIcon.updateSize(newSize);
+        }
+        const closeButton = this.element.querySelector('.ncua-button-close-x');
+        if (closeButton) {
+            const newSize = getSizes.closeButton(mobile);
+            const newSvgSize = getSizes.closeButtonSvg(newSize);
+            closeButton.className = closeButton.className.replace(/ncua-button-close-x--(xs|sm)/, `ncua-button-close-x--${newSize}`);
+            const svg = closeButton.querySelector('svg');
+            if (svg) {
+                svg.setAttribute('width', newSvgSize.toString());
+                svg.setAttribute('height', newSvgSize.toString());
+            }
+        }
+    }
+    bindEvents() {
+        bindNotificationEvents(this.element, this.options.actions, this.options.onClose, () => this.remove());
+    }
+    setupAutoClose() {
+        this.autoCloseTimer = setupAutoClose(this.options.autoClose, this.options.onClose, () => this.remove());
+    }
+    // Public methods
+    getElement() {
+        return this.element;
+    }
+    appendTo(parent) {
+        parent.appendChild(this.element);
+    }
+    remove() {
+        if (this.autoCloseTimer) {
+            clearTimeout(this.autoCloseTimer);
+            this.autoCloseTimer = undefined;
+        }
+        if (this.element?.parentNode) {
+            this.element.parentNode.removeChild(this.element);
+        }
+    }
+    destroy() {
+        // FeaturedIcon 정리
+        if (this.featuredIcon) {
+            this.featuredIcon.destroy();
+            this.featuredIcon = undefined;
+        }
+        // 모바일 리스너 정리
+        if (this.mobileCleanup) {
+            this.mobileCleanup();
+            this.mobileCleanup = undefined;
+        }
+        this.remove();
+    }
+    // Static factory methods
+    static create(options) {
+        return new FloatingNotification(options);
+    }
+}

package/dist/temp/assets/scripts/notification/FullWidthNotification.d.ts

@@ -0,0 +1,21 @@
+import type { BaseNotificationOptions } from './const';
+export interface FullWidthNotificationOptions extends BaseNotificationOptions {
+    type?: 'full-width';
+}
+export declare class FullWidthNotification {
+    private element;
+    private options;
+    private autoCloseTimer?;
+    constructor(options: FullWidthNotificationOptions);
+    private createElement;
+    private buildTemplate;
+    private renderHidePermanentlyButton;
+    private renderCloseButton;
+    private bindEvents;
+    private setupAutoClose;
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    static create(options: FullWidthNotificationOptions): FullWidthNotification;
+}

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

@@ -0,0 +1,111 @@
+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';
+export class FullWidthNotification {
+    constructor(options) {
+        this.options = {
+            color: 'neutral',
+            className: '',
+            actions: [],
+            autoClose: 0,
+            supportingText: undefined,
+            ...options,
+        };
+        this.element = this.createElement();
+        this.bindEvents();
+        this.setupAutoClose();
+    }
+    createElement() {
+        const { title, supportingText, color, className, actions, onClose, supportTextLink, onHidePermanently } = this.options;
+        const wrapper = createWrapperElement(CLASS_NAMES.FULL_WIDTH.BASE, color, className);
+        const iconHtml = FULL_WIDTH_ICON_MAP[color](FULL_WIDTH_SIZES.ICON);
+        wrapper.innerHTML = sanitizeHtml(this.buildTemplate({
+            iconHtml,
+            title,
+            supportingText,
+            actions,
+            onClose,
+            supportTextLink,
+            onHidePermanently,
+        }));
+        return wrapper;
+    }
+    buildTemplate(params) {
+        const { iconHtml, title, supportingText, actions, onClose, supportTextLink, onHidePermanently } = params;
+        return `
+      <div class="${CLASS_NAMES.FULL_WIDTH.CONTAINER}">
+        <div class="${CLASS_NAMES.FULL_WIDTH.CONTENT}">
+          <div class="${CLASS_NAMES.FULL_WIDTH.CONTENT_WRAPPER}">
+            <div class="${CLASS_NAMES.FULL_WIDTH.ICON}">${iconHtml}</div>
+            <div class="${CLASS_NAMES.FULL_WIDTH.TEXT_CONTAINER}">
+              <span class="${CLASS_NAMES.FULL_WIDTH.TITLE}">${title}</span>
+              ${renderSupportingText(supportingText, CLASS_NAMES.FULL_WIDTH.SUPPORTING_TEXT, supportTextLink)}
+            </div>
+          </div>
+          <div class="${CLASS_NAMES.FULL_WIDTH.ACTIONS_CONTAINER}">
+            ${actions && actions.length > 0 ? renderActions(actions, CLASS_NAMES.FULL_WIDTH.ACTIONS) : ''}
+            ${this.renderHidePermanentlyButton(onHidePermanently)}
+            ${this.renderCloseButton(onClose)}
+          </div>
+        </div>
+      </div>
+    `;
+    }
+    renderHidePermanentlyButton(onHidePermanently) {
+        if (!onHidePermanently)
+            return '';
+        return `
+      <button type="button" class="ncua-notification__action-button ncua-notification__action-button--text ncua-full-width-notification__link" data-hide-permanently="true">
+        다시보지 않기
+      </button>
+    `;
+    }
+    renderCloseButton(onClose) {
+        if (!onClose)
+            return '';
+        return `
+      <button type="button" class="${CLASS_NAMES.FULL_WIDTH.CLOSE_BUTTON}" aria-label="알림 닫기">
+        ${SVG_ICONS['x-close'](FULL_WIDTH_SIZES.CLOSE_BUTTON)}
+      </button>
+    `;
+    }
+    bindEvents() {
+        bindNotificationEvents(this.element, this.options.actions, this.options.onClose, () => this.remove());
+        // 다시보지 않기 버튼 이벤트 바인딩
+        if (this.options.onHidePermanently) {
+            const hidePermanentlyButton = this.element.querySelector('[data-hide-permanently="true"]');
+            if (hidePermanentlyButton) {
+                hidePermanentlyButton.addEventListener('click', () => {
+                    this.options.onHidePermanently?.();
+                    this.remove();
+                });
+            }
+        }
+    }
+    setupAutoClose() {
+        this.autoCloseTimer = setupAutoClose(this.options.autoClose, this.options.onClose, () => this.remove());
+    }
+    // Public methods
+    getElement() {
+        return this.element;
+    }
+    appendTo(parent) {
+        parent.appendChild(this.element);
+    }
+    remove() {
+        if (this.autoCloseTimer) {
+            clearTimeout(this.autoCloseTimer);
+            this.autoCloseTimer = undefined;
+        }
+        if (this.element?.parentNode) {
+            this.element.parentNode.removeChild(this.element);
+        }
+    }
+    destroy() {
+        this.remove();
+    }
+    // Static factory methods
+    static create(options) {
+        return new FullWidthNotification(options);
+    }
+}