@ncds/ui-admin 1.6.4 → 1.8.0

package/dist/temp/assets/scripts/tooltip/Tooltip.js

@@ -0,0 +1,335 @@
+import { SVG_ICONS, CLASS_NAMES, TOOLTIP_DEFAULT_VALUE, ICON_SIZES, TOOLTIP_OFFSET, VIEWPORT_MARGIN, OFFSCREEN_POSITION, OPACITY, POSITION, EVENT_OPTIONS, CSS_TEMPLATES, HTML_TEMPLATES, FALLBACK_ICON_SVG, Z_INDEX, } from './const';
+import { ButtonCloseX } from '../shared/ButtonCloseX';
+import { MEDIA_QUERY } from '../../../src/constant/breakpoint';
+import { TooltipLayerManager } from './TooltipLayerManager';
+/**
+ * Tooltip 클래스
+ * 툴팁 패널 패턴을 사용하여 툴팁을 생성합니다.
+ * 툴팁 패널 패턴은 바깥 컨테이너(항상 pointer-events:none) + 실제 패널(클릭 허용) 패턴을 사용합니다.
+ * 레이어 1개 아래에 여러개의 패널과 툴팁이 생성되어 화면에 삽입됩니다.
+ * 자동 위치조정 ( 공간이 부족하다면 상하좌우를 조절하는 기능 - 기본값: top )을 사용합니다.
+ * Shadow DOM 지원
+ */
+export class Tooltip {
+    constructor(options = {}) {
+        this.iconElement = null;
+        // 전역 레이어 매니저 사용
+        this.layerManager = TooltipLayerManager.getInstance();
+        this.panelId = null;
+        this.panel = null;
+        this.calculatedPosition = 'top';
+        this.isVisible = false;
+        this.isMeasuring = false;
+        this.isForceHidden = false;
+        // 이벤트 핸들러
+        this.boundMouseEnter = () => this.handleMouseEnter();
+        this.boundMouseLeave = () => this.handleMouseLeave();
+        this.boundResizeScroll = () => this.handleResizeScroll();
+        this.boundPanelClick = (e) => this.handlePanelClick(e);
+        /* ========== 핸들러 ========== */
+        this.handleMouseEnter = () => {
+            this.showTooltip();
+            if (this.options.type === 'long') {
+                // long은 X로 닫을 때까지 유지 → 재호버 방지
+                this.disableMouseEvents();
+            }
+        };
+        this.handleMouseLeave = () => {
+            if (this.options.type === 'short') {
+                this.hideTooltip();
+            }
+        };
+        this.handleResizeScroll = () => {
+            if (this.isVisible)
+                this.updateTooltipPosition();
+        };
+        this.handlePanelClick = (e) => {
+            const t = e.target;
+            if (t.closest(`.${CLASS_NAMES.TOOLTIP_CLOSE_BUTTON}`)) {
+                e.stopPropagation();
+                e.preventDefault();
+                this.isForceHidden = true;
+                this.hideTooltip();
+                // long 타입에서 닫았으면 다시 hover 가능
+                if (this.options.type === 'long')
+                    this.enableMouseEvents();
+            }
+        };
+        this.options = {
+            ...TOOLTIP_DEFAULT_VALUE,
+            ...options,
+        };
+        this.element = this.createElement();
+        this.bindEvents();
+    }
+    /* ========== DOM 생성 ========== */
+    createElement() {
+        const iconSize = ICON_SIZES[this.options.size ?? 'sm'];
+        const key = this.options.iconType === 'stroke' ? 'help-circle-stroke' : 'help-circle-fill';
+        const iconSvg = SVG_ICONS[key]?.(iconSize) ?? FALLBACK_ICON_SVG(iconSize);
+        const wrapper = document.createElement('span');
+        wrapper.className = this.buildAnchorClassName();
+        wrapper.style.cssText = CSS_TEMPLATES.ANCHOR_WRAPPER;
+        wrapper.innerHTML = HTML_TEMPLATES.ICON_WRAPPER(CLASS_NAMES.TOOLTIP_ICON, iconSvg);
+        this.iconElement = wrapper.querySelector(`.${CLASS_NAMES.TOOLTIP_ICON}`);
+        // body에 레이어/패널 생성(패널 패턴)
+        this.createLayerAndPanel();
+        return wrapper;
+    }
+    // 앵커(아이콘 래퍼) 클래스
+    buildAnchorClassName() {
+        const classes = [
+            CLASS_NAMES.TOOLTIP,
+            `${CLASS_NAMES.TOOLTIP}--${this.options.size}`,
+            `${CLASS_NAMES.TOOLTIP}--${this.options.type}`,
+        ];
+        if (this.options.hideArrow)
+            classes.push(CLASS_NAMES.TOOLTIP_HIDDEN_ARROW);
+        if (this.options.iconType === 'stroke')
+            classes.push(CLASS_NAMES.TOOLTIP_STROKE);
+        if (this.options.position === 'auto')
+            classes.push(CLASS_NAMES.TOOLTIP_AUTO);
+        if (this.options.className)
+            classes.push(this.options.className);
+        return classes.join(' ');
+    }
+    // 패널 클래스 (방향/테마 가짐)
+    buildPanelClassName() {
+        const finalPosition = this.options.position === 'auto' ? this.calculatedPosition : this.options.position;
+        const classes = [
+            CLASS_NAMES.TOOLTIP_PANEL,
+            CLASS_NAMES.TOOLTIP_BG,
+            `${CLASS_NAMES.TOOLTIP_BG}--${this.options.tooltipType}`,
+            `${CLASS_NAMES.TOOLTIP_BG}--${finalPosition}`, // top/bottom/left/right
+        ];
+        if (this.isVisible)
+            classes.push(CLASS_NAMES.TOOLTIP_BG_VISIBLE);
+        if (this.isMeasuring)
+            classes.push(CLASS_NAMES.TOOLTIP_BG_MEASURING);
+        if (this.isForceHidden)
+            classes.push(CLASS_NAMES.TOOLTIP_BG_FORCE_HIDDEN);
+        return classes.join(' ');
+    }
+    renderContentHTML() {
+        if (!this.options.content)
+            return '';
+        if (this.options.useShadowDOM) {
+            return HTML_TEMPLATES.TOOLTIP_CONTENT_SHADOW(CLASS_NAMES.TOOLTIP_CONTENT);
+        }
+        return HTML_TEMPLATES.TOOLTIP_CONTENT(CLASS_NAMES.TOOLTIP_CONTENT, this.options.content);
+    }
+    renderCloseButtonHTML() {
+        if (this.options.type !== 'long')
+            return '';
+        const theme = this.options.tooltipType === 'white' ? 'dark' : 'light';
+        const isMobile = window.matchMedia(MEDIA_QUERY.mobile).matches;
+        const size = isMobile ? 'sm' : 'xs';
+        return ButtonCloseX(size, theme, CLASS_NAMES.TOOLTIP_CLOSE_BUTTON, '툴팁 닫기');
+    }
+    /** 전역 레이어에 패널 생성 */
+    createLayerAndPanel() {
+        // 기존 패널 제거
+        if (this.panelId) {
+            this.layerManager.removePanel(this.panelId);
+        }
+        // 새 패널 생성 (zIndex 전달)
+        const zIndex = this.options.zIndex ?? Z_INDEX.TOOLTIP_LAYER;
+        const { id, panel } = this.layerManager.createPanel(zIndex);
+        this.panelId = id;
+        this.panel = panel;
+        // 패널 설정
+        this.panel.className = this.buildPanelClassName();
+        // 패널 내용 구성
+        const titleHTML = this.options.title
+            ? HTML_TEMPLATES.TOOLTIP_TITLE(CLASS_NAMES.TOOLTIP_TITLE, this.options.title)
+            : '';
+        const contentHTML = this.renderContentHTML();
+        const closeButtonHTML = this.renderCloseButtonHTML();
+        this.panel.innerHTML = `${titleHTML}${contentHTML}${closeButtonHTML}`;
+        if (this.options.useShadowDOM && this.options.content) {
+            this.setupShadowContent();
+        }
+        // 패널 클릭(닫기 버튼) 위임
+        this.panel.addEventListener('click', this.boundPanelClick);
+    }
+    setupShadowContent() {
+        if (!this.panel || !this.options.content)
+            return;
+        const container = this.panel.querySelector('[data-shadow-content]');
+        if (!container)
+            return;
+        const shadowRoot = container.attachShadow({ mode: 'open' });
+        const style = document.createElement('style');
+        style.textContent = CSS_TEMPLATES.SHADOW_DOM_HOST;
+        shadowRoot.appendChild(style);
+        const temp = document.createElement('div');
+        temp.innerHTML = this.options.content;
+        while (temp.firstChild)
+            shadowRoot.appendChild(temp.firstChild);
+    }
+    /* ========== 이벤트 바인딩/해제 ========== */
+    bindEvents() {
+        this.enableMouseEvents();
+        window.addEventListener('resize', this.boundResizeScroll, EVENT_OPTIONS.PASSIVE);
+        window.addEventListener('scroll', this.boundResizeScroll, EVENT_OPTIONS.PASSIVE);
+    }
+    // tooltip icon위에 마우스 올리면 툴팁 보이기
+    enableMouseEvents() {
+        this.iconElement?.addEventListener('mouseenter', this.boundMouseEnter);
+        this.iconElement?.addEventListener('mouseleave', this.boundMouseLeave);
+    }
+    disableMouseEvents() {
+        this.iconElement?.removeEventListener('mouseenter', this.boundMouseEnter);
+        this.iconElement?.removeEventListener('mouseleave', this.boundMouseLeave);
+    }
+    /* ========== 표시/숨김/위치 ========== */
+    showTooltip() {
+        if (!this.panel)
+            return;
+        this.isVisible = true;
+        this.isForceHidden = false; // 강제 숨김 상태 리셋
+        this.updateTooltipPosition();
+        // 보이기
+        this.panel.style.opacity = OPACITY.VISIBLE;
+        this.updatePanelClass();
+    }
+    hideTooltip() {
+        if (!this.panel)
+            return;
+        this.isVisible = false;
+        this.isForceHidden = false; // 강제 숨김 상태 리셋 (다시 표시 가능하도록)
+        this.panel.style.opacity = OPACITY.HIDDEN;
+        this.updatePanelClass();
+        // long 타입에서 hideTooltip()을 호출한 경우 마우스 이벤트 다시 활성화
+        if (this.options.type === 'long') {
+            this.enableMouseEvents();
+        }
+        // 전환 종료 후 완전히 오프스크린 이동 → 히트 테스트 0
+        const el = this.panel;
+        const onEnd = () => {
+            el.style.left = OFFSCREEN_POSITION;
+            el.style.top = OFFSCREEN_POSITION;
+            el.removeEventListener('transitionend', onEnd);
+        };
+        el.addEventListener('transitionend', onEnd, { once: true });
+    }
+    updateTooltipPosition() {
+        if (!this.panel)
+            return;
+        this.isMeasuring = true;
+        this.updatePanelClass();
+        // 먼저 눈에 보이도록 화면 안쪽으로 잠깐 이동해 사이즈 측정
+        // (opacity는 showTooltip에서만 1로)
+        if (this.panel.style.left === OFFSCREEN_POSITION) {
+            this.panel.style.left = POSITION.INITIAL;
+            this.panel.style.top = POSITION.INITIAL;
+        }
+        const tipRect = this.panel.getBoundingClientRect();
+        const anchor = this.iconElement ?? this.element;
+        const rect = anchor.getBoundingClientRect();
+        let left = 0;
+        let top = 0;
+        let prefer = this.options.position;
+        if (prefer === 'auto') {
+            const enoughTop = rect.top - TOOLTIP_OFFSET - tipRect.height >= VIEWPORT_MARGIN;
+            prefer = enoughTop ? 'top' : 'bottom';
+        }
+        if (prefer === 'bottom') {
+            top = rect.bottom + TOOLTIP_OFFSET;
+            left = rect.left + rect.width / 2 - tipRect.width / 2;
+            this.calculatedPosition = 'bottom';
+        }
+        else if (prefer === 'top') {
+            top = rect.top - tipRect.height - TOOLTIP_OFFSET;
+            left = rect.left + rect.width / 2 - tipRect.width / 2;
+            this.calculatedPosition = 'top';
+        }
+        else if (prefer === 'left') {
+            top = rect.top + rect.height / 2 - tipRect.height / 2;
+            left = rect.left - tipRect.width - TOOLTIP_OFFSET;
+            this.calculatedPosition = 'left';
+        }
+        else if (prefer === 'right') {
+            top = rect.top + rect.height / 2 - tipRect.height / 2;
+            left = rect.right + TOOLTIP_OFFSET;
+            this.calculatedPosition = 'right';
+        }
+        else {
+            // fallback: top
+            top = rect.top - tipRect.height - TOOLTIP_OFFSET;
+            left = rect.left + rect.width / 2 - tipRect.width / 2;
+            this.calculatedPosition = 'top';
+        }
+        // 화면 경계 보정
+        left = Math.max(VIEWPORT_MARGIN, Math.min(left, window.innerWidth - tipRect.width - VIEWPORT_MARGIN));
+        top = Math.max(VIEWPORT_MARGIN, Math.min(top, window.innerHeight - tipRect.height - VIEWPORT_MARGIN));
+        this.panel.style.left = `${Math.round(left)}px`;
+        this.panel.style.top = `${Math.round(top)}px`;
+        this.isMeasuring = false;
+        this.updatePanelClass();
+    }
+    updatePanelClass() {
+        if (!this.panel)
+            return;
+        const newClassName = this.buildPanelClassName();
+        if (this.panel.className !== newClassName) {
+            this.panel.className = newClassName;
+        }
+    }
+    /* ========== Public API ========== */
+    getElement() {
+        return this.element;
+    }
+    /* 기존 옵션 업데이트 ( i18n 적용, 속성 변경 등 옵션 변경 시 사용 ) */
+    updateOptions(newOptions) {
+        // 기존 리스너/DOM 정리
+        this.disableMouseEvents();
+        window.removeEventListener('resize', this.boundResizeScroll);
+        window.removeEventListener('scroll', this.boundResizeScroll);
+        this.panel?.removeEventListener('click', this.boundPanelClick);
+        if (this.panelId) {
+            this.layerManager.removePanel(this.panelId);
+        }
+        // 옵션 병합
+        this.options = { ...this.options, ...newOptions };
+        // 앵커 재구성
+        const parent = this.element.parentNode;
+        const newEl = this.createElement();
+        if (parent)
+            parent.replaceChild(newEl, this.element);
+        this.element = newEl;
+        // 리스너 재바인딩
+        this.bindEvents();
+    }
+    /* 정리 메서드 용도 */
+    destroy() {
+        this.disableMouseEvents();
+        window.removeEventListener('resize', this.boundResizeScroll);
+        window.removeEventListener('scroll', this.boundResizeScroll);
+        this.panel?.removeEventListener('click', this.boundPanelClick);
+        if (this.panelId) {
+            this.layerManager.removePanel(this.panelId);
+        }
+        if (this.element.parentNode)
+            this.element.parentNode.removeChild(this.element);
+    }
+    /* ========== 팩토리 메서드 ========== */
+    static create(options = {}) {
+        return new Tooltip(options);
+    }
+    static createShort(title, content, options = {}) {
+        return new Tooltip({ type: 'short', title, content, ...options });
+    }
+    static createLong(title, content, options = {}) {
+        return new Tooltip({ type: 'long', title, content, ...options });
+    }
+    static createAuto(title, content, options = {}) {
+        return new Tooltip({ position: 'auto', title, content, ...options });
+    }
+    static createAutoLong(title, content, options = {}) {
+        return new Tooltip({ type: 'long', position: 'auto', title, content, ...options });
+    }
+    static createAutoLongWithShadowDOM(title, content, options = {}) {
+        return new Tooltip({ type: 'long', position: 'auto', title, content, useShadowDOM: true, ...options });
+    }
+}

package/dist/temp/assets/scripts/tooltip/TooltipLayerManager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 툴팁 레이어 관리자
+ * 전역 레이어 하나를 사용하여 모든 툴팁 패널을 관리합니다.
+ */
+export declare class TooltipLayerManager {
+    private static instance;
+    private layer;
+    private panels;
+    private nextId;
+    private maxZIndex;
+    private constructor();
+    static getInstance(): TooltipLayerManager;
+    private createGlobalLayer;
+    createPanel(zIndex?: number): {
+        id: string;
+        panel: HTMLElement;
+    };
+    removePanel(id: string): void;
+    getPanel(id: string): HTMLElement | null;
+    destroy(): void;
+}

package/dist/temp/assets/scripts/tooltip/TooltipLayerManager.js

@@ -0,0 +1,71 @@
+import { CLASS_NAMES, Z_INDEX } from './const';
+/**
+ * 툴팁 레이어 관리자
+ * 전역 레이어 하나를 사용하여 모든 툴팁 패널을 관리합니다.
+ */
+export class TooltipLayerManager {
+    constructor() {
+        this.layer = null;
+        this.panels = new Map();
+        this.nextId = 0;
+        this.maxZIndex = Z_INDEX.TOOLTIP_LAYER; // 기본 z-index (가장 높은 값 추적)
+        this.createGlobalLayer();
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new TooltipLayerManager();
+        }
+        return this.instance;
+    }
+    createGlobalLayer() {
+        // 기존 레이어가 있으면 제거
+        const existingLayer = document.getElementById('tooltip-global-layer');
+        if (existingLayer) {
+            existingLayer.remove();
+        }
+        this.layer = document.createElement('div');
+        this.layer.id = 'tooltip-global-layer';
+        this.layer.className = CLASS_NAMES.TOOLTIP_GLOBAL_LAYER;
+        this.layer.style.zIndex = String(this.maxZIndex);
+        document.body.appendChild(this.layer);
+    }
+    createPanel(zIndex = Z_INDEX.TOOLTIP_LAYER) {
+        if (!this.layer) {
+            this.createGlobalLayer();
+        }
+        // 최대 z-index 추적 및 전역 레이어 업데이트
+        // 왜 이런 구현이 필요한지..? 툴팁 레이어 매니저는 바디에 무분별하게 붙는걸 방지하기 위해 하나의 전역 레이아웃입니다. 툴팁 20개씩 붙는 페이지를 위함
+        // 전역 레이어의 z-index는 자식과 일치되면 가장 좋지만, 수시로 변하는 z-index를 추적하는 것이 디버깅측면에서 좋지않고 버그를 유발할 가능성이 높아보여
+        // 툴팁은 보통은 고정된값을 사용하기에, 변동이 없다고 가정하고, 변동되는 경우에만 가장 높은 z-index를 추적하고 업데이트하는 구현을 하였습니다.
+        if (zIndex > this.maxZIndex) {
+            this.maxZIndex = zIndex;
+            if (this.layer) {
+                this.layer.style.zIndex = String(this.maxZIndex);
+            }
+        }
+        const id = `tooltip-panel-${++this.nextId}`;
+        const panel = document.createElement('span');
+        panel.id = id;
+        panel.className = CLASS_NAMES.TOOLTIP_PANEL;
+        this.panels.set(id, panel);
+        this.layer.appendChild(panel);
+        return { id, panel };
+    }
+    removePanel(id) {
+        const panel = this.panels.get(id);
+        if (panel && panel.parentNode) {
+            panel.parentNode.removeChild(panel);
+            this.panels.delete(id);
+        }
+    }
+    getPanel(id) {
+        return this.panels.get(id) || null;
+    }
+    destroy() {
+        this.panels.clear();
+        if (this.layer && this.layer.parentNode) {
+            this.layer.parentNode.removeChild(this.layer);
+        }
+        this.layer = null;
+    }
+}

package/dist/temp/assets/scripts/tooltip/const/classNames.d.ts

@@ -0,0 +1,17 @@
+export declare const CLASS_NAMES: {
+    TOOLTIP: string;
+    TOOLTIP_ICON: string;
+    TOOLTIP_BG: string;
+    TOOLTIP_TITLE: string;
+    TOOLTIP_CONTENT: string;
+    TOOLTIP_CLOSE_BUTTON: string;
+    TOOLTIP_HIDDEN_ARROW: string;
+    TOOLTIP_STROKE: string;
+    TOOLTIP_AUTO: string;
+    TOOLTIP_BG_VISIBLE: string;
+    TOOLTIP_BG_MEASURING: string;
+    TOOLTIP_BG_FORCE_HIDDEN: string;
+    TOOLTIP_GLOBAL_LAYER: string;
+    TOOLTIP_PANEL: string;
+    BUTTON_CLOSE_X: string;
+};

package/dist/temp/assets/scripts/tooltip/const/classNames.js

@@ -0,0 +1,23 @@
+// Tooltip CSS 클래스명 상수들
+export const CLASS_NAMES = {
+    // 기본 클래스
+    TOOLTIP: 'ncua-tooltip',
+    TOOLTIP_ICON: 'ncua-tooltip__icon',
+    TOOLTIP_BG: 'ncua-tooltip__bg',
+    TOOLTIP_TITLE: 'ncua-tooltip__title',
+    TOOLTIP_CONTENT: 'ncua-tooltip__content',
+    TOOLTIP_CLOSE_BUTTON: 'ncua-tooltip__close-button',
+    // 수정자 클래스 (modifier classes)
+    TOOLTIP_HIDDEN_ARROW: 'ncua-tooltip--hidden-arrow',
+    TOOLTIP_STROKE: 'ncua-tooltip--stroke',
+    TOOLTIP_AUTO: 'ncua-tooltip--auto',
+    // 배경 상태 클래스
+    TOOLTIP_BG_VISIBLE: 'ncua-tooltip__bg--visible',
+    TOOLTIP_BG_MEASURING: 'ncua-tooltip__bg--measuring',
+    TOOLTIP_BG_FORCE_HIDDEN: 'ncua-tooltip__bg--force-hidden',
+    // 레이어 관련 클래스
+    TOOLTIP_GLOBAL_LAYER: 'ncua-tooltip-global-layer',
+    TOOLTIP_PANEL: 'ncua-tooltip-panel',
+    // 버튼 클래스
+    BUTTON_CLOSE_X: 'ncua-button-close-x',
+};

package/dist/temp/assets/scripts/tooltip/const/constants.d.ts

@@ -0,0 +1,33 @@
+import type { TooltipOptions } from './types';
+export declare const MARGIN = 10;
+export declare const DEFAULT_TOOLTIP_WIDTH = 200;
+export declare const DEFAULT_TOOLTIP_HEIGHT = 60;
+export declare const POSITION_PRIORITY: readonly ["bottom", "top", "right", "left"];
+export declare const TOOLTIP_OFFSET = 8;
+export declare const VIEWPORT_MARGIN = 8;
+export declare const ICON_SIZES: {
+    readonly sm: 14;
+    readonly md: 16;
+};
+export declare const TRANSITION_DURATION = "0.18s";
+export declare const OFFSCREEN_POSITION = "-99999px";
+export declare const OPACITY: {
+    readonly HIDDEN: "0";
+    readonly VISIBLE: "1";
+};
+export declare const POSITION: {
+    readonly INITIAL: "0px";
+    readonly OFFSCREEN: "-99999px";
+};
+export declare const Z_INDEX: {
+    readonly TOOLTIP_LAYER: 2000;
+};
+export declare const EVENT_OPTIONS: {
+    readonly PASSIVE: {
+        readonly passive: true;
+    };
+    readonly ONCE: {
+        readonly once: true;
+    };
+};
+export declare const TOOLTIP_DEFAULT_VALUE: TooltipOptions;

package/dist/temp/assets/scripts/tooltip/const/constants.js

@@ -0,0 +1,46 @@
+export const MARGIN = 10;
+export const DEFAULT_TOOLTIP_WIDTH = 200;
+export const DEFAULT_TOOLTIP_HEIGHT = 60;
+export const POSITION_PRIORITY = ['bottom', 'top', 'right', 'left'];
+// 툴팁 위치 계산 관련 상수
+export const TOOLTIP_OFFSET = 8; // 툴팁과 앵커 사이의 거리
+export const VIEWPORT_MARGIN = 8; // 뷰포트 경계와의 최소 거리
+// 아이콘 크기 상수
+export const ICON_SIZES = {
+    sm: 14,
+    md: 16,
+};
+// 애니메이션 관련 상수
+export const TRANSITION_DURATION = '0.18s';
+export const OFFSCREEN_POSITION = '-99999px';
+// 툴팁 상태 관련 상수
+export const OPACITY = {
+    HIDDEN: '0',
+    VISIBLE: '1',
+};
+export const POSITION = {
+    INITIAL: '0px',
+    OFFSCREEN: OFFSCREEN_POSITION,
+};
+// z-index 관련 상수
+export const Z_INDEX = {
+    TOOLTIP_LAYER: 2000, // 툴팁 전역 레이어 기본 z-index
+};
+// 이벤트 관련 상수
+export const EVENT_OPTIONS = {
+    PASSIVE: { passive: true },
+    ONCE: { once: true },
+};
+export const TOOLTIP_DEFAULT_VALUE = {
+    tooltipType: 'white',
+    iconType: 'stroke',
+    position: 'auto',
+    size: 'sm',
+    hideArrow: false,
+    title: '',
+    content: '',
+    type: 'short',
+    zIndex: Z_INDEX.TOOLTIP_LAYER,
+    useShadowDOM: false,
+    className: '', // 커스텀 클래스명
+};

package/dist/temp/assets/scripts/tooltip/const/icons.d.ts

@@ -0,0 +1,4 @@
+export declare const SVG_ICONS: {
+    readonly 'help-circle-stroke': (size: number) => string;
+    readonly 'help-circle-fill': (size: number) => string;
+};

package/dist/temp/assets/scripts/tooltip/const/icons.js

@@ -0,0 +1,9 @@
+// SVG 아이콘들
+export const SVG_ICONS = {
+    'help-circle-stroke': (size) => `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" fill="none" viewBox="0 0 24 24" stroke="none">
+      <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3m.08 4h.01M22 12c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2s10 4.477 10 10"></path>
+    </svg>`,
+    'help-circle-fill': (size) => `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" fill="none" viewBox="0 0 24 24" stroke="none">
+      <path fill="currentColor" fill-rule="evenodd" d="M12 1C5.925 1 1 5.925 1 12s4.925 11 11 11 11-4.925 11-11S18.075 1 12 1m-1.093 7.271a2 2 0 0 1 3.013 1.727V10c0 .47-.365.958-1.055 1.418a6 6 0 0 1-1.262.634 1 1 0 0 0 .633 1.897l.169-.061a8.05 8.05 0 0 0 1.57-.806c.81-.54 1.944-1.55 1.945-3.081a4 4 0 0 0-7.773-1.333 1 1 0 0 0 1.886.664 2 2 0 0 1 .874-1.06M12 16a1 1 0 1 0 0 2h.01a1 1 0 0 0 0-2z" clip-rule="evenodd"></path>
+    </svg>`,
+};

package/dist/temp/assets/scripts/tooltip/const/index.d.ts

@@ -0,0 +1,5 @@
+export type { TooltipOptions, CalculatedPosition } from './types';
+export { SVG_ICONS } from './icons';
+export { CLASS_NAMES } from './classNames';
+export { MARGIN, DEFAULT_TOOLTIP_WIDTH, DEFAULT_TOOLTIP_HEIGHT, POSITION_PRIORITY, TOOLTIP_DEFAULT_VALUE, TOOLTIP_OFFSET, VIEWPORT_MARGIN, ICON_SIZES, TRANSITION_DURATION, OFFSCREEN_POSITION, OPACITY, POSITION, Z_INDEX, EVENT_OPTIONS, } from './constants';
+export { CSS_TEMPLATES, HTML_TEMPLATES, FALLBACK_ICON_SVG } from './templates';

package/dist/temp/assets/scripts/tooltip/const/index.js

@@ -0,0 +1,4 @@
+export { SVG_ICONS } from './icons';
+export { CLASS_NAMES } from './classNames';
+export { MARGIN, DEFAULT_TOOLTIP_WIDTH, DEFAULT_TOOLTIP_HEIGHT, POSITION_PRIORITY, TOOLTIP_DEFAULT_VALUE, TOOLTIP_OFFSET, VIEWPORT_MARGIN, ICON_SIZES, TRANSITION_DURATION, OFFSCREEN_POSITION, OPACITY, POSITION, Z_INDEX, EVENT_OPTIONS, } from './constants';
+export { CSS_TEMPLATES, HTML_TEMPLATES, FALLBACK_ICON_SVG } from './templates';

package/dist/temp/assets/scripts/tooltip/const/templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 툴팁 관련 CSS 및 HTML 템플릿
+ */
+export declare const CSS_TEMPLATES: {
+    readonly LAYER_CONTAINER: (zIndex: number) => string;
+    readonly TOOLTIP_PANEL: (zIndex: number) => string;
+    readonly ANCHOR_WRAPPER: "\n    display: inline-flex;\n    vertical-align: middle;\n    margin: 0 4px;\n  ";
+    readonly SHADOW_DOM_HOST: "\n    :host { \n      all: unset; \n      display: block; \n      font-family: system-ui; \n      color: black; \n    }\n  ";
+};
+export declare const HTML_TEMPLATES: {
+    readonly ICON_WRAPPER: (className: string, iconSvg: string) => string;
+    readonly TOOLTIP_TITLE: (className: string, title: string) => string;
+    readonly TOOLTIP_CONTENT: (className: string, content: string) => string;
+    readonly TOOLTIP_CONTENT_SHADOW: (className: string) => string;
+};
+export declare const FALLBACK_ICON_SVG: (size: number) => string;

package/dist/temp/assets/scripts/tooltip/const/templates.js

@@ -0,0 +1,59 @@
+import { OFFSCREEN_POSITION, TRANSITION_DURATION } from './constants';
+/**
+ * 툴팁 관련 CSS 및 HTML 템플릿
+ */
+// CSS 템플릿
+export const CSS_TEMPLATES = {
+    // 레이어 컨테이너 스타일 (클릭 통과)
+    LAYER_CONTAINER: (zIndex) => `
+    position: fixed;
+    inset: 0;
+    pointer-events: none;
+    z-index: ${zIndex};
+    display: block;
+  `,
+    // 툴팁 패널 스타일 (클릭 허용)
+    TOOLTIP_PANEL: (zIndex) => `
+    position: fixed;
+    left: ${OFFSCREEN_POSITION}; 
+    top: ${OFFSCREEN_POSITION};
+    opacity: 0;
+    transition: opacity ${TRANSITION_DURATION} ease;
+    pointer-events: auto;
+    z-index: ${zIndex};
+    right: auto;
+    bottom: auto;
+    transform: none;
+  `,
+    // 앵커 래퍼 스타일
+    ANCHOR_WRAPPER: `
+    display: inline-flex;
+    vertical-align: middle;
+    margin: 0 4px;
+  `,
+    // Shadow DOM 기본 스타일
+    SHADOW_DOM_HOST: `
+    :host { 
+      all: unset; 
+      display: block; 
+      font-family: system-ui; 
+      color: black; 
+    }
+  `,
+};
+// HTML 템플릿
+export const HTML_TEMPLATES = {
+    // 아이콘 래퍼
+    ICON_WRAPPER: (className, iconSvg) => `<span class="${className}">${iconSvg}</span>`,
+    // 툴팁 제목
+    TOOLTIP_TITLE: (className, title) => `<span class="${className}">${title}</span>`,
+    // 툴팁 콘텐츠 (일반)
+    TOOLTIP_CONTENT: (className, content) => `<span class="${className}">${content}</span>`,
+    // 툴팁 콘텐츠 (Shadow DOM)
+    TOOLTIP_CONTENT_SHADOW: (className) => `<span class="${className}" data-shadow-content></span>`,
+};
+// 폴백 아이콘 SVG
+export const FALLBACK_ICON_SVG = (size) => `<svg width="${size}" height="${size}" viewBox="0 0 16 16" aria-hidden="true">
+    <circle cx="8" cy="8" r="7" stroke="currentColor" fill="none"/>
+    <text x="8" y="11" font-size="8" text-anchor="middle" fill="currentColor">?</text>
+  </svg>`;

package/dist/temp/assets/scripts/tooltip/const/types.d.ts

@@ -0,0 +1,14 @@
+export interface TooltipOptions {
+    tooltipType?: 'white' | 'black';
+    iconType?: 'stroke' | 'fill';
+    position?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'auto';
+    size?: 'sm' | 'md';
+    hideArrow?: boolean;
+    title?: string;
+    content?: string;
+    type?: 'long' | 'short';
+    zIndex?: number;
+    useShadowDOM?: boolean;
+    className?: string;
+}
+export type CalculatedPosition = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';