@ncds/ui-admin 1.8.28-alpha.0 → 1.8.28-alpha.2

package/dist/cjs/src/hooks/dropdown/__tests__/dropdownHooks.test.js

@@ -0,0 +1,168 @@
+"use strict";
+
+var _react = require("react");
+var _client = require("react-dom/client");
+var _testUtils = require("react-dom/test-utils");
+var _vitest = require("vitest");
+var _useDropdown = require("../useDropdown");
+var _useDropdownKeyboard = require("../useDropdownKeyboard");
+var _useWindowResize = require("../useWindowResize");
+// @vitest-environment jsdom
+//
+// 드롭다운 훅의 컴포넌트 경유로 닿지 않는 분기 — 위험 목록표 DDH-01~03 (PR-7c).
+// 호출부(SelectBox·ComboBox)는 dropdownRef·target 을 항상 넘기고 isKeyboardNavigation 을 부르지 않으므로
+// 훅을 부르는 하네스 컴포넌트로 직접 구동한다.
+
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+const MAX_HEIGHT = 200;
+const OPTIONS = ['a', 'b'];
+const cleanups = [];
+(0, _vitest.afterEach)(() => {
+  for (const cleanup of cleanups.splice(0)) cleanup();
+});
+const mount = element => {
+  const container = document.createElement('div');
+  document.body.appendChild(container);
+  const root = (0, _client.createRoot)(container);
+  cleanups.push(() => {
+    (0, _testUtils.act)(() => root.unmount());
+    container.remove();
+  });
+  (0, _testUtils.act)(() => {
+    root.render(element);
+  });
+  return container;
+};
+const requireElement = (scope, selector) => {
+  const element = scope.querySelector(selector);
+  if (element === null) throw new Error(`요소를 찾을 수 없습니다: ${selector}`);
+  return element;
+};
+const dispatch = (target, event) => {
+  (0, _testUtils.act)(() => {
+    target.dispatchEvent(event);
+  });
+};
+(0, _vitest.describe)('DDH-01 useDropdown — dropdownRef 생략', () => {
+  const DropdownProbe = () => {
+    const triggerRef = (0, _react.useRef)(null);
+    const {
+      isOpen,
+      toggleDropdown
+    } = (0, _useDropdown.useDropdown)({
+      triggerRef,
+      maxHeight: MAX_HEIGHT,
+      itemCount: OPTIONS.length,
+      optionItems: OPTIONS,
+      onSelect: () => undefined
+    });
+    return /*#__PURE__*/(0, _react.createElement)('button', {
+      ref: triggerRef,
+      type: 'button',
+      'data-open': String(isOpen),
+      onClick: toggleDropdown
+    });
+  };
+  (0, _vitest.it)('DDH-01 dropdownRef 없이도 트리거 안 mousedown 은 열린 채 두고, 바깥 mousedown 은 닫는다', () => {
+    const container = mount(/*#__PURE__*/(0, _react.createElement)(DropdownProbe));
+    const trigger = requireElement(container, 'button');
+    (0, _testUtils.act)(() => {
+      trigger.click();
+    });
+    dispatch(trigger, new MouseEvent('mousedown', {
+      bubbles: true
+    }));
+    const afterInside = trigger.dataset.open;
+    dispatch(document.body, new MouseEvent('mousedown', {
+      bubbles: true
+    }));
+    (0, _vitest.expect)([afterInside, trigger.dataset.open]).toEqual(['true', 'false']);
+  });
+});
+(0, _vitest.describe)('DDH-02 useDropdownKeyboard — 직접 호출', () => {
+  (0, _vitest.afterEach)(() => {
+    _vitest.vi.useRealTimers();
+  });
+  (0, _vitest.it)('DDH-02 isKeyboardNavigation 은 화살표 뒤 true, mousemove 뒤 false 이고 옵션 목록 없는 dropdownRef 는 스크롤 보정을 건너뛴다', () => {
+    _vitest.vi.useFakeTimers({
+      toFake: ['setTimeout']
+    });
+    const onFocusChange = _vitest.vi.fn();
+    const captured = {
+      isKeyboardNavigation: null
+    };
+    const KeyboardProbe = () => {
+      // 옵션 목록(.ncua-select-dropdown__options)이 없는 요소를 dropdownRef 로 넘긴다
+      const dropdownRef = (0, _react.useRef)(null);
+      const {
+        handleKeyDown,
+        handleMouseMove,
+        isKeyboardNavigation
+      } = (0, _useDropdownKeyboard.useDropdownKeyboard)({
+        isOpen: true,
+        disabled: false,
+        focusedIndex: -1,
+        optionItems: OPTIONS,
+        onToggle: () => undefined,
+        onSelect: () => undefined,
+        onClose: () => undefined,
+        onFocusChange,
+        dropdownRef
+      });
+      captured.isKeyboardNavigation = isKeyboardNavigation;
+      return /*#__PURE__*/(0, _react.createElement)('div', {
+        ref: dropdownRef,
+        tabIndex: 0,
+        onKeyDown: handleKeyDown,
+        onMouseMove: handleMouseMove
+      });
+    };
+    const container = mount(/*#__PURE__*/(0, _react.createElement)(KeyboardProbe));
+    const target = requireElement(container, 'div');
+    const isKeyboardNavigation = () => {
+      if (captured.isKeyboardNavigation === null) throw new Error('isKeyboardNavigation 을 얻지 못했습니다');
+      return captured.isKeyboardNavigation();
+    };
+    const initial = isKeyboardNavigation();
+    dispatch(target, new KeyboardEvent('keydown', {
+      key: 'ArrowDown',
+      bubbles: true,
+      cancelable: true
+    }));
+    const afterArrow = isKeyboardNavigation();
+    (0, _vitest.expect)(() => (0, _testUtils.act)(() => {
+      _vitest.vi.runOnlyPendingTimers();
+    })).not.toThrow();
+    dispatch(target, new MouseEvent('mousemove', {
+      bubbles: true
+    }));
+    (0, _vitest.expect)([initial, afterArrow, isKeyboardNavigation()]).toEqual([false, true, false]);
+    (0, _vitest.expect)(onFocusChange).toHaveBeenCalledWith(0);
+  });
+});
+(0, _vitest.describe)('DDH-03 useWindowResize — target 생략', () => {
+  (0, _vitest.afterEach)(() => {
+    _vitest.vi.unstubAllGlobals();
+  });
+  (0, _vitest.it)('DDH-03 target 을 넘기지 않으면 document.body 를 관찰한다', () => {
+    const observed = [];
+    class ResizeObserverStub {
+      observe(target) {
+        observed.push(target);
+      }
+      unobserve() {
+        return undefined;
+      }
+      disconnect() {
+        return undefined;
+      }
+    }
+    _vitest.vi.stubGlobal('ResizeObserver', ResizeObserverStub);
+    const ResizeProbe = () => {
+      (0, _useWindowResize.useWindowResize)(() => undefined, true);
+      return null;
+    };
+    mount(/*#__PURE__*/(0, _react.createElement)(ResizeProbe));
+    (0, _vitest.expect)(observed.map(target => target === document.body)).toEqual([true]);
+  });
+});

package/dist/cjs/src/types/component-meta.js

@@ -5,8 +5,4 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.COMPONENT_CATEGORIES = void 0;
 /** AI 에이전트용 컴포넌트 메타데이터 타입 */
-/**
- * 컴포넌트 카테고리 — `src/components/` 하위 디렉토리명과 동일.
- * 타입과 런타임 값을 한 곳에서 정의해 추가/변경 시 동기화 누락을 막는다.
- */
 const COMPONENT_CATEGORIES = exports.COMPONENT_CATEGORIES = ['action', 'data-display', 'feedback-and-status', 'forms-and-input', 'image-and-icons', 'layout', 'navigation', 'overlays'];

package/dist/cjs/src/utils/__tests__/date-picker.test.js

@@ -2,6 +2,7 @@
 
 var _moment = _interopRequireDefault(require("moment"));
 var _vitest = require("vitest");
+var _fixedToday = require("../../__tests__/helpers/fixedToday");
 var _datePicker = require("../date-picker");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 (0, _vitest.describe)('convertToMomentFormat', () => {
@@ -26,4 +27,108 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
     (0, _vitest.expect)((0, _moment.default)(date).format((0, _datePicker.convertToMomentFormat)('Y-m-d H:i'))).toBe('2024-03-20 14:30');
     (0, _vitest.expect)((0, _moment.default)(date).format((0, _datePicker.convertToMomentFormat)('Y-m-d H:i:S'))).toBe('2024-03-20 14:30:05');
   });
+});
+// ── 위험 경로 DU-xx (PR-7a) ───────────────────────────────────────────────
+(0, _vitest.describe)('DU-01 오늘 기준 기본값', () => {
+  (0, _vitest.afterEach)(() => {
+    _vitest.vi.useRealTimers();
+  });
+  (0, _vitest.it)('DU-01 getDateFormat() 은 인자가 없으면 오늘을 YYYY-MM-DD 로 돌려준다', () => {
+    (0, _fixedToday.useFixedToday)();
+    (0, _vitest.expect)((0, _datePicker.getDateFormat)()).toBe('2026-10-21');
+    (0, _vitest.expect)((0, _datePicker.getToday)()).toEqual(_fixedToday.FIXED_TODAY);
+  });
+  (0, _vitest.it)('DU-01 getDateFormat 은 주어진 날짜를 YYYY-MM-DD 로 돌려준다', () => {
+    (0, _vitest.expect)((0, _datePicker.getDateFormat)('2026-01-05T09:30:00')).toBe('2026-01-05');
+  });
+  (0, _vitest.it)('DU-01 getSubtractDate 는 date 가 없으면 오늘에서 period(unit) 를 뺀다', () => {
+    (0, _fixedToday.useFixedToday)();
+    (0, _vitest.expect)((0, _datePicker.getDateFormat)((0, _datePicker.getSubtractDate)({
+      period: 3,
+      unit: 'days'
+    }))).toBe('2026-10-18');
+  });
+  (0, _vitest.it)('DU-01 getSubtractDate 는 date 가 있으면 그 날짜에서 빼고, 월 단위는 말일로 보정한다', () => {
+    (0, _vitest.expect)((0, _datePicker.getDateFormat)((0, _datePicker.getSubtractDate)({
+      date: '2026-03-31',
+      period: 1,
+      unit: 'months'
+    }))).toBe('2026-02-28');
+  });
+  _vitest.it.each([{
+    input: '20231112',
+    expected: '2023-11-12'
+  }, {
+    input: '2023-11-12',
+    expected: '2023-11-12'
+  },
+  // 실재하지 않는 월·일 8자리는 정리하지 않고 원문 유지 — 무효 판정·복원은 입력 핸들러 몫 (DPV-02 · #8)
+  {
+    input: '20231345',
+    expected: '20231345'
+  }])('DU-01 formatDateInput($input) → $expected', _ref => {
+    let {
+      input,
+      expected
+    } = _ref;
+    (0, _vitest.expect)((0, _datePicker.formatDateInput)(input)).toBe(expected);
+  });
+});
+(0, _vitest.describe)('DU-02 시·분 입력 정리', () => {
+  _vitest.it.each([{
+    input: '7a',
+    expected: '7'
+  }, {
+    input: '123',
+    expected: '12'
+  }, {
+    input: '23',
+    expected: '23'
+  }, {
+    input: '',
+    expected: ''
+  }])('DU-02 formatHourInput($input) → $expected', _ref2 => {
+    let {
+      input,
+      expected
+    } = _ref2;
+    (0, _vitest.expect)((0, _datePicker.formatHourInput)(input)).toBe(expected);
+  });
+  _vitest.it.each([{
+    input: '5b',
+    expected: '5'
+  }, {
+    input: '599',
+    expected: '59'
+  }, {
+    input: '',
+    expected: ''
+  }])('DU-02 formatMinuteInput($input) → $expected', _ref3 => {
+    let {
+      input,
+      expected
+    } = _ref3;
+    (0, _vitest.expect)((0, _datePicker.formatMinuteInput)(input)).toBe(expected);
+  });
+  _vitest.it.each([{
+    label: '시 24',
+    format: _datePicker.formatHourInput,
+    input: '24'
+  }, {
+    label: '시 99',
+    format: _datePicker.formatHourInput,
+    input: '99'
+  }, {
+    label: '분 60',
+    format: _datePicker.formatMinuteInput,
+    input: '60'
+  }])('DU-02 범위 밖 값($label)은 정리하지 않고 원문을 돌려준다', _ref4 => {
+    let {
+      format,
+      input
+    } = _ref4;
+    // 현재 동작 고정 — 결함 후보: 후속 이슈 (범위 밖을 원문 반환 → flatpickr blur 보정이 나머지 연산으로 감음 — RDP-11 과 같은 뿌리)
+    (0, _vitest.expect)(format(input)).toBe(input);
+  });
+  _vitest.it.todo('DU-02 시 24 이상 · 분 60 이상은 23 · 59 로 제한한다 (기대 동작)');
 });

package/dist/cjs/src/utils/dropdown/__tests__/dropdownUtils.test.js

@@ -313,4 +313,28 @@ const mountChain = function () {
     }));
     (0, _vitest.expect)((0, _dropdownUtils.findScrollableParent)(boundary, boundary)).toBe(boundary);
   });
+  (0, _vitest.it)('UDD-01 boundary 밖 요소는 body 까지 올라가 boundary 를 만나지 못하고 null 을 반환한다', () => {
+    const [boundary] = mountChain(createScrollable({
+      overflowY: 'auto',
+      scrollable: true
+    }));
+    const [outside] = mountChain(createScrollable({
+      overflowY: 'visible',
+      scrollable: false
+    }), createScrollable({
+      overflowY: 'visible',
+      scrollable: false
+    }));
+    (0, _vitest.expect)((0, _dropdownUtils.findScrollableParent)(outside, boundary)).toBeNull();
+  });
+  (0, _vitest.it)('UDD-01 boundary 가 overflow auto 여도 내용이 넘치지 않으면 null 을 반환한다', () => {
+    const [boundary, target] = mountChain(createScrollable({
+      overflowY: 'auto',
+      scrollable: false
+    }), createScrollable({
+      overflowY: 'visible',
+      scrollable: false
+    }));
+    (0, _vitest.expect)((0, _dropdownUtils.findScrollableParent)(target, boundary)).toBeNull();
+  });
 });

package/dist/cjs/src/utils/dropdown/__tests__/multiSelect.test.js

@@ -0,0 +1,49 @@
+"use strict";
+
+var _react = require("react");
+var _client = require("react-dom/client");
+var _testUtils = require("react-dom/test-utils");
+var _vitest = require("vitest");
+var _multiSelect = require("../multiSelect");
+// @vitest-environment jsdom
+//
+// useMultiSelect 의 호출부 경유로 닿지 않는 방어 분기 — 위험 목록표 UDD-02 (PR-7c).
+// SelectBox·ComboBox 는 tryToggle 에 항상 배열을 넘기므로 훅을 하네스로 직접 부른다.
+
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+const OPTIONS = [{
+  id: 'a',
+  label: 'A'
+}, {
+  id: 'b',
+  label: 'B'
+}];
+const cleanups = [];
+(0, _vitest.afterEach)(() => {
+  for (const cleanup of cleanups.splice(0)) cleanup();
+});
+const renderMultiSelect = () => {
+  const captured = {
+    current: null
+  };
+  const Probe = () => {
+    captured.current = (0, _multiSelect.useMultiSelect)([], OPTIONS);
+    return null;
+  };
+  const container = document.createElement('div');
+  const root = (0, _client.createRoot)(container);
+  cleanups.push(() => (0, _testUtils.act)(() => root.unmount()));
+  (0, _testUtils.act)(() => {
+    root.render(/*#__PURE__*/(0, _react.createElement)(Probe));
+  });
+  if (captured.current === null) throw new Error('useMultiSelect 반환값을 얻지 못했습니다');
+  return captured.current;
+};
+(0, _vitest.describe)('UDD-02 tryToggle 현재값 방어', () => {
+  (0, _vitest.it)('UDD-02 현재값이 배열이 아니면 빈 배열 기준으로 추가한다', () => {
+    const {
+      tryToggle
+    } = renderMultiSelect();
+    (0, _vitest.expect)(tryToggle('a', undefined)).toEqual(['a']);
+  });
+});

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useMultiSelect = exports.useMaxSelection = exports.removeTagFromSelected = exports.isAllItemsSelected = exports.handleSelectAllItems = exports.getSelectedTags = exports.getSelectAllButtonText = void 0;
+exports.useMultiSelect = exports.useMaxSelection = void 0;
 var _react = require("react");
 var _maxSelection = require("./maxSelection");
 /**
@@ -17,7 +17,6 @@ const isAllItemsSelected = (selectedValues, options) => {
 /**
  * 전체 선택 버튼 텍스트를 반환하는 유틸 함수
  */
-exports.isAllItemsSelected = isAllItemsSelected;
 const getSelectAllButtonText = function (selectedValues, options) {
   let selectText = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '전체 선택';
   let deselectText = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '전체 해제';
@@ -26,7 +25,6 @@ const getSelectAllButtonText = function (selectedValues, options) {
 /**
  * 전체 선택/해제를 처리하는 유틸 함수
  */
-exports.getSelectAllButtonText = getSelectAllButtonText;
 const handleSelectAllItems = (selectedValues, options) => {
   if (isAllItemsSelected(selectedValues, options)) {
     // 전체 해제: 빈 배열 반환
@@ -38,7 +36,6 @@ const handleSelectAllItems = (selectedValues, options) => {
 /**
  * 선택된 항목들을 태그 데이터로 변환하는 유틸 함수
  */
-exports.handleSelectAllItems = handleSelectAllItems;
 const getSelectedTags = (selectedValues, options) => {
   return selectedValues.map(value => {
     const option = options.find(opt => opt.id === value);
@@ -51,7 +48,6 @@ const getSelectedTags = (selectedValues, options) => {
 /**
  * 태그 제거 시 선택값에서 해당 ID를 제거하는 유틸 함수
  */
-exports.getSelectedTags = getSelectedTags;
 const removeTagFromSelected = (selectedValues, tagIdToRemove) => {
   return selectedValues.filter(id => id !== tagIdToRemove);
 };
@@ -65,7 +61,6 @@ const removeTagFromSelected = (selectedValues, tagIdToRemove) => {
  * 도메인 규칙(`>=` 비교 등)을 외부로 노출하지 않고 헬퍼를 통해 의미만 반환한다.
  * `useMultiSelect`가 내부에서 사용하지만, 단독으로도 필요한 호출자가 쓸 수 있게 export한다.
  */
-exports.removeTagFromSelected = removeTagFromSelected;
 const useMaxSelection = (selectedValues, maxSelection) => {
   const isMaxSelectionActive = (0, _maxSelection.isMaxSelectionLimitActive)(maxSelection);
   const isMaxReached = (0, _maxSelection.isMaxSelectionReached)(selectedValues.length, maxSelection);

package/dist/cjs/src/utils/portal-position/__tests__/portalPosition.nullAnchor.test.js

@@ -0,0 +1,67 @@
+"use strict";
+
+var _vitest = require("vitest");
+var _ = require("..");
+// @vitest-environment jsdom
+
+/** afterEach 에서 호출할 구독 해제 함수 */
+const cleanups = [];
+(0, _vitest.afterEach)(() => {
+  for (const cleanup of cleanups.splice(0)) {
+    cleanup();
+  }
+  document.body.replaceChildren();
+});
+const createPanel = () => {
+  const panel = document.createElement('div');
+  document.body.appendChild(panel);
+  return panel;
+};
+/** 구독 시점에는 anchor 를 돌려주고, detach() 이후에는 null 을 돌려주는 getAnchor */
+const createDetachableAnchor = () => {
+  const element = document.createElement('button');
+  document.body.appendChild(element);
+  let current = element;
+  return {
+    getAnchor: () => current,
+    detach: () => {
+      current = null;
+    }
+  };
+};
+const track = (getAnchor, onUpdate) => {
+  const panel = createPanel();
+  cleanups.push((0, _.trackPortalPosition)({
+    getAnchor,
+    getPanel: () => panel,
+    direction: 'down',
+    onUpdate
+  }));
+};
+(0, _vitest.describe)('trackPortalPosition — 변화 시점 anchor 가 null (RSD-02)', () => {
+  (0, _vitest.it)('RSD-02 구독 뒤 anchor 가 null 이 되면 resize 에도 onUpdate 를 부르지 않는다', () => {
+    // Given: 구독 시점에는 anchor 가 있었고 이후 사라진다
+    const anchor = createDetachableAnchor();
+    const onUpdate = _vitest.vi.fn();
+    track(anchor.getAnchor, onUpdate);
+    onUpdate.mockClear();
+    anchor.detach();
+    // When: 창 크기 변화가 온다
+    window.dispatchEvent(new Event('resize'));
+    // Then: onUpdate 가 불리지 않는다
+    (0, _vitest.expect)(onUpdate).not.toHaveBeenCalled();
+  });
+  (0, _vitest.it)('RSD-02 (대조) anchor 가 남아 있으면 resize 에 onUpdate 를 부른다', () => {
+    // Given: anchor 가 계속 있다
+    const anchor = createDetachableAnchor();
+    const onUpdate = _vitest.vi.fn();
+    track(anchor.getAnchor, onUpdate);
+    onUpdate.mockClear();
+    // When: 창 크기 변화가 온다
+    window.dispatchEvent(new Event('resize'));
+    // Then: 측정한 스타일로 onUpdate 가 불린다
+    (0, _vitest.expect)(onUpdate).toHaveBeenCalledWith(_vitest.expect.objectContaining({
+      position: 'fixed'
+    }));
+  });
+});

package/dist/cjs/vitest.config.js

@@ -11,6 +11,8 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 // projectBaseDir 로 잡으므로, 패키지 루트 기준 상대경로(SF:src/foo.ts)로 두면 경로가
 // 해석되지 않아 커버리지가 통째로 무시된다.
 const REPO_ROOT = _nodePath.default.resolve(__dirname, '../..');
+// CI 출력은 그대로 두고 로컬에서만 리포터를 더한다 (CI 는 GitHub Actions 가 CI=true 로 설정).
+const LOCAL_REPORTERS = process.env.CI ? [] : ['text', 'html'];
 var _default = exports.default = (0, _config.defineConfig)({
   test: {
     include: ['scripts/**/__tests__/**/*.test.ts', 'src/**/__tests__/**/*.test.ts', 'assets/scripts/**/__tests__/**/*.test.ts'],
@@ -24,22 +26,26 @@ var _default = exports.default = (0, _config.defineConfig)({
       // (step-guide 의 src/index.ts 는 824줄 본체 구현이므로 그쪽에서는 제외하지 않는다.)
       '**/index.ts',
       // MCP 가 읽는 컴포넌트 메타데이터 선언 45개 — 실행 분기 없는 순수 데이터.
-      '**/*.meta.ts', 'src/types/**', 'src/constant/**'],
-      // 'text' 미포함 — 미커버 파일이 수백 개라 파일별 상세 출력이 CI 로그를 덮는다.
-      // 'lcov' 대신 'lcovonly' — 'lcov' 는 HTML 리포트까지 생성한다.
-      reporter: ['text-summary', ['lcovonly', {
+      '**/*.meta.ts', 'src/types/**', 'src/constant/**',
+      // generate:scoped-css 가 만드는 빌드 산출물(gitignore) — 존재 여부가 실행 환경마다 달라
+      // 분모가 흔들린다. git 에 없어 Sonar 스캔 대상이 아니므로 sonar 쪽 동기화는 필요 없다.
+      'src/generated/**'],
+      // CI 에는 'text' 미포함 — 미커버 파일이 수백 개라 파일별 상세 출력이 CI 로그를 덮는다.
+      // 로컬(CI 환경변수 없음)에서만 파일별 표(text)와 HTML 리포트(coverage/index.html)를 더한다.
+      // 'lcov' 대신 'lcovonly' — 'lcov' 는 HTML 리포트까지 생성한다 (CI 에서는 불필요).
+      reporter: [...LOCAL_REPORTERS, 'text-summary', ['lcovonly', {
         projectRoot: REPO_ROOT
       }]],
       // 회귀 방지 하한선 — 실측에서 약 2%p 낮춘 값 (ui-admin-mcp 와 같은 여유폭).
-      // 실측 기준: 2026-10-12, 25cb4d96 — stmts 54.91 / branch 44.63 / funcs 55.20 / lines 55.80
-      // 최종 목표: 93 / 88 (lines 95 · branches 90). 테스트 보강 단계마다 실측 −2 로 인상한다.
+      // 실측 기준: 2026-10-28, 545a9c81 — stmts 98.92 / branch 96.79 / funcs 99.19 / lines 99.65
+      // (직전 2026-10-12, 25cb4d96 — 54.91 / 44.63 / 55.20 / 55.80 에서 PR-4~9 테스트로 인상. 최종 목표 93 / 88 초과 달성)
       // autoUpdate: false — 값은 실측을 확인하고 사람이 직접 올린다.
       thresholds: {
         autoUpdate: false,
-        statements: 53,
-        branches: 43,
-        functions: 53,
-        lines: 54
+        statements: 96,
+        branches: 94,
+        functions: 97,
+        lines: 97
       }
     }
   }

package/dist/esm/assets/scripts/notification/const/icons.js

@@ -22,7 +22,6 @@ export const FULL_WIDTH_ICON_MAP = {
   success: SVG_ICONS['check-circle'],
   info: SVG_ICONS['info-circle']
 };
-export const ICON_MAP = FULL_WIDTH_ICON_MAP;
 /** message 기본 타입 아이콘. floating 과 같은 4색에 info(neutral 과 같은 핀)를 더한다. */
 export const MESSAGE_ICON_MAP = {
   neutral: SVG_ICONS['pin-02'],

package/dist/esm/assets/scripts/notification/const/index.js

@@ -1,4 +1,4 @@
 // Re-export all constants and types from separate files
 export { CLASS_NAMES } from './classNames';
-export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP, MESSAGE_ICON_MAP, SVG_ICONS } from './icons';
-export { CLOSE_BUTTON_SIZES, CLOSE_BUTTON_SVG_SIZES, FEATURED_ICON_SIZES, FULL_WIDTH_SIZES, getSizes, ICON_PIXEL_SIZES, MESSAGE_SIZES } from './sizes';
+export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, MESSAGE_ICON_MAP, SVG_ICONS } from './icons';
+export { FULL_WIDTH_SIZES, getSizes, MESSAGE_SIZES } from './sizes';

package/dist/esm/assets/scripts/notification/const/sizes.js

@@ -1,22 +1,22 @@
 // 알림 컴포넌트 사이즈 관련 상수들
 // FeaturedIcon 사이즈
-export const FEATURED_ICON_SIZES = {
+const FEATURED_ICON_SIZES = {
   MOBILE: 'md',
   DESKTOP: 'sm'
 };
 // SVG 아이콘 픽셀 사이즈
-export const ICON_PIXEL_SIZES = {
+const ICON_PIXEL_SIZES = {
   MOBILE: '20',
   DESKTOP: '16',
   FULL_WIDTH: '16' // Full-width는 항상 고정
 };
 // 닫기 버튼 사이즈
-export const CLOSE_BUTTON_SIZES = {
+const CLOSE_BUTTON_SIZES = {
   MOBILE: 'sm',
   DESKTOP: 'xs'
 };
 // 닫기 버튼 SVG 픽셀 사이즈
-export const CLOSE_BUTTON_SVG_SIZES = {
+const CLOSE_BUTTON_SVG_SIZES = {
   xs: 16,
   sm: 20
 };

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

@@ -1,4 +1,4 @@
-export { CLASS_NAMES, FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP, SVG_ICONS } from './const';
+export { CLASS_NAMES, FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, SVG_ICONS } from './const';
 export { FloatingNotification } from './FloatingNotification';
 export { FullWidthNotification } from './FullWidthNotification';
 export { MessageNotification } from './MessageNotification';

package/dist/esm/assets/scripts/shared/ButtonCloseX.js

@@ -1,13 +1,16 @@
 // 공통 X버튼 로직 (React ButtonCloseX 컴포넌트와 동일한 구조)
 // React ButtonCloseX와 동일한 SVG 사이즈 매핑
-export const SVG_SIZE = {
+const SVG_SIZE = {
   xs: 16,
   sm: 20,
   md: 20,
   lg: 24
 };
+// 버튼 id 난수 — 36진수 문자열에서 '0.' 뒤 9자리를 쓴다
+const BUTTON_ID_RADIX = 36;
+const BUTTON_ID_LENGTH = 9;
 // X버튼 SVG 아이콘
-export const X_CLOSE_SVG = size => `<svg width="${size}" height="${size}" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+const X_CLOSE_SVG = size => `<svg width="${size}" height="${size}" fill="none" viewBox="0 0 24 24" stroke="currentColor">
     <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
   </svg>`;
 // X버튼 렌더링 유틸리티 (React ButtonCloseX와 동일한 인터페이스)
@@ -17,7 +20,7 @@ export function ButtonCloseX(size) {
   let ariaLabel = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '닫기';
   let onClick = arguments.length > 4 ? arguments[4] : undefined;
   const svgSize = SVG_SIZE[size];
-  const buttonId = `close-btn-${Math.random().toString(36).substr(2, 9)}`;
+  const buttonId = `close-btn-${Math.random().toString(BUTTON_ID_RADIX).substr(2, BUTTON_ID_LENGTH)}`;
   const buttonHTML = `
     <button type="button" id="${buttonId}" class="ncua-button-close-x ncua-button-close-x--${size} ncua-button-close-x--${theme} ${additionalClasses}" aria-label="${ariaLabel}">
       ${X_CLOSE_SVG(svgSize.toString())}

package/dist/esm/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'
+};