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

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

@@ -171,4 +171,13 @@ describe('findScrollableParent — 스크롤 부모 탐색 (characterisation)',
         const [boundary] = mountChain(createScrollable({ overflowY: 'scroll', scrollable: true }));
         expect(findScrollableParent(boundary, boundary)).toBe(boundary);
     });
+    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 }));
+        expect(findScrollableParent(outside, boundary)).toBeNull();
+    });
+    it('UDD-01 boundary 가 overflow auto 여도 내용이 넘치지 않으면 null 을 반환한다', () => {
+        const [boundary, target] = mountChain(createScrollable({ overflowY: 'auto', scrollable: false }), createScrollable({ overflowY: 'visible', scrollable: false }));
+        expect(findScrollableParent(target, boundary)).toBeNull();
+    });
 });

package/dist/temp/src/utils/dropdown/__tests__/multiSelect.test.d.ts

@@ -0,0 +1 @@
+export {};

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

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

package/dist/temp/src/utils/dropdown/multiSelect.d.ts

@@ -1,24 +1,4 @@
 import type { MultiSelectOption, SelectedTag } from '../../types';
-/**
- * 전체 선택 상태를 확인하는 유틸 함수
- */
-export declare const isAllItemsSelected: (selectedValues: (string | number)[], options: MultiSelectOption[]) => boolean;
-/**
- * 전체 선택 버튼 텍스트를 반환하는 유틸 함수
- */
-export declare const getSelectAllButtonText: (selectedValues: (string | number)[], options: MultiSelectOption[], selectText?: string, deselectText?: string) => string;
-/**
- * 전체 선택/해제를 처리하는 유틸 함수
- */
-export declare const handleSelectAllItems: (selectedValues: (string | number)[], options: MultiSelectOption[]) => (string | number)[];
-/**
- * 선택된 항목들을 태그 데이터로 변환하는 유틸 함수
- */
-export declare const getSelectedTags: (selectedValues: (string | number)[], options: MultiSelectOption[]) => SelectedTag[];
-/**
- * 태그 제거 시 선택값에서 해당 ID를 제거하는 유틸 함수
- */
-export declare const removeTagFromSelected: (selectedValues: (string | number)[], tagIdToRemove: string | number) => (string | number)[];
 export interface UseMultiSelectOptions {
     /** 전체 선택 버튼의 라벨 (default: '전체 선택') */
     selectText?: string;

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

@@ -3,7 +3,7 @@ import { isMaxSelectionLimitActive, isMaxSelectionReached } from './maxSelection
 /**
  * 전체 선택 상태를 확인하는 유틸 함수
  */
-export const isAllItemsSelected = (selectedValues, options) => {
+const isAllItemsSelected = (selectedValues, options) => {
     if (options.length === 0)
         return false;
     const validOptionIds = options.filter((option) => !option.disabled).map((option) => option.id);
@@ -12,13 +12,13 @@ export const isAllItemsSelected = (selectedValues, options) => {
 /**
  * 전체 선택 버튼 텍스트를 반환하는 유틸 함수
  */
-export const getSelectAllButtonText = (selectedValues, options, selectText = '전체 선택', deselectText = '전체 해제') => {
+const getSelectAllButtonText = (selectedValues, options, selectText = '전체 선택', deselectText = '전체 해제') => {
     return isAllItemsSelected(selectedValues, options) ? deselectText : selectText;
 };
 /**
  * 전체 선택/해제를 처리하는 유틸 함수
  */
-export const handleSelectAllItems = (selectedValues, options) => {
+const handleSelectAllItems = (selectedValues, options) => {
     if (isAllItemsSelected(selectedValues, options)) {
         // 전체 해제: 빈 배열 반환
         return [];
@@ -29,7 +29,7 @@ export const handleSelectAllItems = (selectedValues, options) => {
 /**
  * 선택된 항목들을 태그 데이터로 변환하는 유틸 함수
  */
-export const getSelectedTags = (selectedValues, options) => {
+const getSelectedTags = (selectedValues, options) => {
     return selectedValues
         .map((value) => {
         const option = options.find((opt) => opt.id === value);
@@ -40,7 +40,7 @@ export const getSelectedTags = (selectedValues, options) => {
 /**
  * 태그 제거 시 선택값에서 해당 ID를 제거하는 유틸 함수
  */
-export const removeTagFromSelected = (selectedValues, tagIdToRemove) => {
+const removeTagFromSelected = (selectedValues, tagIdToRemove) => {
     return selectedValues.filter((id) => id !== tagIdToRemove);
 };
 /**

package/dist/temp/src/utils/portal-position/__tests__/portalPosition.nullAnchor.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,57 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { trackPortalPosition } from '..';
+/** afterEach 에서 호출할 구독 해제 함수 */
+const cleanups = [];
+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(trackPortalPosition({ getAnchor, getPanel: () => panel, direction: 'down', onUpdate }));
+};
+describe('trackPortalPosition — 변화 시점 anchor 가 null (RSD-02)', () => {
+    it('RSD-02 구독 뒤 anchor 가 null 이 되면 resize 에도 onUpdate 를 부르지 않는다', () => {
+        // Given: 구독 시점에는 anchor 가 있었고 이후 사라진다
+        const anchor = createDetachableAnchor();
+        const onUpdate = vi.fn();
+        track(anchor.getAnchor, onUpdate);
+        onUpdate.mockClear();
+        anchor.detach();
+        // When: 창 크기 변화가 온다
+        window.dispatchEvent(new Event('resize'));
+        // Then: onUpdate 가 불리지 않는다
+        expect(onUpdate).not.toHaveBeenCalled();
+    });
+    it('RSD-02 (대조) anchor 가 남아 있으면 resize 에 onUpdate 를 부른다', () => {
+        // Given: anchor 가 계속 있다
+        const anchor = createDetachableAnchor();
+        const onUpdate = vi.fn();
+        track(anchor.getAnchor, onUpdate);
+        onUpdate.mockClear();
+        // When: 창 크기 변화가 온다
+        window.dispatchEvent(new Event('resize'));
+        // Then: 측정한 스타일로 onUpdate 가 불린다
+        expect(onUpdate).toHaveBeenCalledWith(expect.objectContaining({ position: 'fixed' }));
+    });
+});

package/dist/temp/vitest.config.js

@@ -4,6 +4,8 @@ import { defineConfig } from 'vitest/config';
 // projectBaseDir 로 잡으므로, 패키지 루트 기준 상대경로(SF:src/foo.ts)로 두면 경로가
 // 해석되지 않아 커버리지가 통째로 무시된다.
 const REPO_ROOT = path.resolve(__dirname, '../..');
+// CI 출력은 그대로 두고 로컬에서만 리포터를 더한다 (CI 는 GitHub Actions 가 CI=true 로 설정).
+const LOCAL_REPORTERS = process.env.CI ? [] : ['text', 'html'];
 export default defineConfig({
     test: {
         include: [
@@ -26,20 +28,24 @@ export default defineConfig({
                 '**/*.meta.ts',
                 'src/types/**',
                 'src/constant/**',
+                // generate:scoped-css 가 만드는 빌드 산출물(gitignore) — 존재 여부가 실행 환경마다 달라
+                // 분모가 흔들린다. git 에 없어 Sonar 스캔 대상이 아니므로 sonar 쪽 동기화는 필요 없다.
+                'src/generated/**',
             ],
-            // 'text' 미포함 — 미커버 파일이 수백 개라 파일별 상세 출력이 CI 로그를 덮는다.
-            // 'lcov' 대신 'lcovonly' — 'lcov' 는 HTML 리포트까지 생성한다.
-            reporter: ['text-summary', ['lcovonly', { projectRoot: REPO_ROOT }]],
+            // 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/types/assets/scripts/notification/const/icons.d.ts

@@ -17,13 +17,6 @@ export declare const FULL_WIDTH_ICON_MAP: {
     readonly success: (size: string) => string;
     readonly info: (size: string) => string;
 };
-export declare const ICON_MAP: {
-    readonly neutral: (size: string) => string;
-    readonly error: (size: string) => string;
-    readonly warning: (size: string) => string;
-    readonly success: (size: string) => string;
-    readonly info: (size: string) => string;
-};
 /** message 기본 타입 아이콘. floating 과 같은 4색에 info(neutral 과 같은 핀)를 더한다. */
 export declare const MESSAGE_ICON_MAP: Record<NotificationColor, IconFunction>;
 export {};

package/dist/types/assets/scripts/notification/const/index.d.ts

@@ -1,4 +1,4 @@
 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 type { BaseNotificationOptions, LegacyNotificationHierarchy, NotificationAction, NotificationActionButtonSize, NotificationColor, NotificationHierarchy, NotificationLinkTarget, } from './types';
+export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, MESSAGE_ICON_MAP, SVG_ICONS } from './icons';
+export { FULL_WIDTH_SIZES, getSizes, MESSAGE_SIZES } from './sizes';
+export type { BaseNotificationOptions, LegacyNotificationHierarchy, NotificationAction, NotificationActionButtonSize, NotificationColor, NotificationHierarchy, } from './types';

package/dist/types/assets/scripts/notification/const/sizes.d.ts

@@ -1,17 +1,4 @@
-export declare const FEATURED_ICON_SIZES: {
-    readonly MOBILE: "md";
-    readonly DESKTOP: "sm";
-};
-export declare const ICON_PIXEL_SIZES: {
-    readonly MOBILE: "20";
-    readonly DESKTOP: "16";
-    readonly FULL_WIDTH: "16";
-};
-export declare const CLOSE_BUTTON_SIZES: {
-    readonly MOBILE: "sm";
-    readonly DESKTOP: "xs";
-};
-export declare const CLOSE_BUTTON_SVG_SIZES: {
+declare const CLOSE_BUTTON_SVG_SIZES: {
     readonly xs: 16;
     readonly sm: 20;
 };
@@ -30,3 +17,4 @@ export declare const getSizes: {
     readonly closeButton: (isMobile: boolean) => "xs" | "sm";
     readonly closeButtonSvg: (size: keyof typeof CLOSE_BUTTON_SVG_SIZES) => 20 | 16;
 };
+export {};

package/dist/types/assets/scripts/notification/const/types.d.ts

@@ -1,10 +1,10 @@
-export type NotificationColor = 'neutral' | 'error' | 'warning' | 'success' | 'info';
 /**
  * 텍스트 링크(`supportTextLink`)를 여는 대상. React `NotificationLinkTarget`과 같은 어휘다.
  * - `'_self'`: 같은 탭
  * - `'_blank'`: 새 탭 + `rel="noopener noreferrer"`
  */
-export type NotificationLinkTarget = '_self' | '_blank';
+type NotificationLinkTarget = '_self' | '_blank';
+export type NotificationColor = 'neutral' | 'error' | 'warning' | 'success' | 'info';
 /**
  * 알림 액션 버튼(`ncua-btn`)의 색상 수식자.
  * React `NotificationAction.hierarchy`와 동일한 어휘를 쓴다 — `ButtonTheme`의 부분집합이다.
@@ -64,3 +64,4 @@ export interface BaseNotificationOptions {
      */
     hidePermanentlyLabel?: string;
 }
+export {};

package/dist/types/assets/scripts/notification/index.d.ts

@@ -1,5 +1,5 @@
 export type { BaseNotificationOptions, NotificationAction, NotificationColor, NotificationHierarchy } from './const';
-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, type FloatingNotificationOptions } from './FloatingNotification';
 export { FullWidthNotification, type FullWidthNotificationOptions } from './FullWidthNotification';
 export { MessageNotification, type MessageNotificationOptions } from './MessageNotification';

package/dist/types/assets/scripts/shared/ButtonCloseX.d.ts

@@ -1,5 +1,3 @@
 export type ButtonCloseXSize = 'xs' | 'sm' | 'md' | 'lg';
 export type ButtonCloseXTheme = 'dark' | 'light';
-export declare const SVG_SIZE: Record<ButtonCloseXSize, number>;
-export declare const X_CLOSE_SVG: (size: string) => string;
 export declare function ButtonCloseX(size: ButtonCloseXSize, theme?: ButtonCloseXTheme, additionalClasses?: string, ariaLabel?: string, onClick?: () => void): string;

package/dist/types/assets/scripts/table/scrollbar/const.d.ts

@@ -37,7 +37,6 @@ export declare const SCROLLBAR_OWNERS: {
     readonly cdn: "cdn";
     readonly react: "react";
 };
-export type ScrollbarOwner = (typeof SCROLLBAR_OWNERS)[keyof typeof SCROLLBAR_OWNERS];
 export declare const SCROLLBAR_OWNER_VALUES: readonly string[];
 export declare const OPT_OUT_VALUE = "off";
 export declare const AXIS_VALUES: readonly ["both", "x", "y"];

package/dist/types/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/types/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/types/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/types/assets/scripts/tooltip/const/index.d.ts

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

package/dist/types/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: var(--font-families-commerce-sans, 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/types/assets/scripts/tooltip/const/types.d.ts

@@ -0,0 +1,17 @@
+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;
+    panelClassName?: string;
+    forceVisible?: boolean;
+    iconColor?: string;
+}
+export type CalculatedPosition = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';

package/dist/types/assets/scripts/utils/sanitize.d.ts

@@ -14,9 +14,3 @@
  * 이벤트 바인딩은 addEventListener로 별도 처리할 것.
  */
 export declare function sanitizeHtml(dirty: string): string;
-/**
- * 엘리먼트에 콘텐츠를 안전하게 설정한다.
- * - string: sanitize 후 innerHTML 교체
- * - HTMLElement: 기존 자식 제거 후 appendChild
- */
-export declare function setSafeInnerHTML(element: HTMLElement, content: string | HTMLElement): void;

package/dist/types/src/__tests__/helpers/dom.d.ts

@@ -0,0 +1,2 @@
+/** 셀렉터에 맞는 첫 요소. 없으면 셀렉터를 담아 던져 실패 위치를 바로 보여 준다. */
+export declare function mustQuery<T extends Element>(root: ParentNode, selector: string): T;

package/dist/types/src/__tests__/helpers/fileInput.d.ts

@@ -0,0 +1,27 @@
+import { type Mock, vi } from 'vitest';
+/** 내용은 검증 대상이 아니므로 최소 크기만 채운다 */
+export declare const DUMMY_FILE_BYTES = 4;
+/** 파일마다 type 등 속성이 달라 팩토리로 받는다 — 반환 함수는 (이름, 크기) 만 받는다 */
+export declare const createFileFactory: (properties: FilePropertyBag) => (name: string, size?: number) => File;
+/**
+ * URL.createObjectURL · revokeObjectURL 을 테스트마다 새 목으로 바꾸고 끝나면 원복한다.
+ * 모듈 최상위에서 호출해 beforeEach · afterEach 를 등록한다. 발급 URL 은 테스트마다 blob:mock/1 부터 센다.
+ */
+export declare const mockObjectUrls: () => {
+    createObjectURL: Mock<(object: Blob | MediaSource) => string>;
+    revokeObjectURL: Mock<(url: string) => void>;
+};
+export declare const fileInputOf: (scope: HTMLElement) => HTMLInputElement;
+export declare const browseButton: (scope: HTMLElement) => HTMLButtonElement;
+/**
+ * jsdom 에는 파일 선택 UI 가 없어 files 를 직접 정의한 뒤 change 를 발생시킨다.
+ * React 는 상태 갱신을 반영하도록 dispatch 에 act 를 넘긴다.
+ */
+export declare const selectFiles: (scope: HTMLElement, filesToSelect: File[] | null, dispatch?: (fire: () => void) => void) => void;
+/**
+ * actual 의 각 File 이 expected 의 몇 번째 인스턴스인지 (없으면 -1).
+ * 이 환경에서 File 은 열거 가능한 own 속성이 없어 서로 다른 File 도 toEqual 이 통과하므로 동일성으로 비교한다.
+ */
+export declare const indexesIn: (expected: File[], actual: File[]) => number[];
+/** 목(mock) 의 마지막 호출에서 첫 인자(File[])를 꺼낸다 — 호출이 없으면 빈 배열 */
+export declare const lastFilesOf: (mock: ReturnType<typeof vi.fn>) => File[];

package/dist/types/src/__tests__/helpers/fixedToday.d.ts

@@ -0,0 +1,4 @@
+/** 2026-10-21 (수) 정오 — 자정 경계 영향을 받지 않도록 정오로 둔다 */
+export declare const FIXED_TODAY: Date;
+/** Date 만 가짜로 고정한다 — flatpickr 내부 타이머는 실제로 흐른다. 해제는 호출 측 afterEach 의 vi.useRealTimers() */
+export declare const useFixedToday: () => void;

package/dist/types/src/__tests__/helpers/matchMedia.d.ts

@@ -0,0 +1,13 @@
+/** React 쪽은 리스너 발화를 act 로 감싸야 해서 발화 방식을 주입받는다. */
+type Dispatch = (dispatchToListeners: () => void) => void;
+export interface FakeMediaQuery {
+    /** 저장된 change 리스너에 matches 값을 담아 발화한다. */
+    fire: (matches: boolean) => void;
+    listenerCount: () => number;
+}
+/**
+ * jsdom 에 없는 matchMedia 를 change 리스너를 보관하는 가짜로 바꾼다.
+ * 원본 복원 함수는 `cleanups` 에 넣으므로 호출 측 afterEach 가 되돌린다.
+ */
+export declare function installMatchMedia(cleanups: (() => void)[], initial: boolean, dispatch?: Dispatch): FakeMediaQuery;
+export {};

package/dist/types/src/__tests__/helpers/rect.d.ts

@@ -0,0 +1,2 @@
+/** jsdom 은 레이아웃이 없어 getBoundingClientRect 가 전부 0 이다 — 테스트가 쓸 좌표만 채운 DOMRect 를 만든다. */
+export declare const toRect: (rect: Partial<DOMRect>) => DOMRect;

package/dist/types/src/components/action/button/__tests__/Button.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/action/button-group/__tests__/ButtonGroup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/data-grid/__tests__/DataGrid.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/Table.dnd.dragCell.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/Table.dnd.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/Table.scroll.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/Table.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/dnd-context.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/dnd-preview.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/__tests__/tableDndTestUtils.d.ts

@@ -0,0 +1,76 @@
+import { dropTargetForElements, draggable as makeDraggable, monitorForElements } from '@atlaskit/pragmatic-drag-and-drop/element/adapter';
+import type { TableBodyProps, TableProps } from '../types';
+type DraggableArgs = Parameters<typeof makeDraggable>[0];
+type DropTargetArgs = Parameters<typeof dropTargetForElements>[0];
+type MonitorArgs = Parameters<typeof monitorForElements>[0];
+type MonitorCanPayload = Parameters<NonNullable<MonitorArgs['canMonitor']>>[0];
+type GetInitialDataPayload = Parameters<NonNullable<DraggableArgs['getInitialData']>>[0];
+type DragData = Record<string | symbol, unknown>;
+/** cleanup 이 아직 불리지 않은 registration 만 등록 순서대로 돌려준다 */
+declare const draggables: () => DraggableArgs[];
+declare const dropTargets: () => DropTargetArgs[];
+declare const monitors: () => MonitorArgs[];
+declare const stubRect: (element: Element, rect: Partial<DOMRect>) => void;
+declare const ROW_HEIGHT = 40;
+declare const UPPER_HALF_Y = 10;
+declare const LOWER_HALF_Y = 30;
+declare const rowOf: (dragId: string, scope?: ParentNode) => HTMLTableRowElement;
+/** 드래그 핸들(button)이 scope 안의 dragId 행에 속한 draggable registration */
+declare const draggableArgsOf: (dragId: string, scope?: ParentNode) => DraggableArgs;
+declare const dropTargetArgsOf: (dragId: string) => DropTargetArgs;
+declare const sourceDataOf: (dragId: string, scope?: ParentNode) => DragData;
+/** 행 dropTarget 의 getData 를 실제 closest-edge 로 실행해 target data 를 만든다. */
+declare const targetDataOf: (dragId: string, clientY: number, source: DragData) => DragData;
+/** 등록된 모든 monitor 에 drop 을 흘린다 (canMonitor 통과한 것만). */
+declare const dropOnMonitors: (source: DragData, targets: DragData[]) => void;
+type RowDragEvent = 'onDragEnter' | 'onDrag' | 'onDragLeave' | 'onDrop';
+/** 행 dropTarget 콜백에 self(=closest-edge 가 붙은 target data)·source 를 넘긴다. */
+declare const fireRowEvent: (event: RowDragEvent, targetId: string, sourceId: string, clientY: number) => void;
+declare const ROW_LEFT = 20;
+declare const ROW_TOP = 100;
+declare const ROW_WIDTH = 600;
+declare const START_X = 50;
+declare const START_Y = 110;
+declare const MOVE_X = 200;
+declare const MOVE_Y = 300;
+declare const OFFSET_X: number;
+declare const OFFSET_Y: number;
+declare const generatePreview: (args: DraggableArgs, nativeSetDragImage?: DataTransfer['setDragImage']) => void;
+declare const startDrag: (args: DraggableArgs) => void;
+declare const endDrag: (args: DraggableArgs) => void;
+declare const previewOverlays: () => HTMLElement[];
+declare const fireDragOver: (clientX: number, clientY: number) => void;
+/** beforeEach 에서 부른다 */
+declare const trackDragOverListeners: () => void;
+/** afterEach 에서 부른다 — 남은 오버레이·dragover 리스너를 정리하고 spy 를 되돌린다 */
+declare const cleanupDragPreview: () => void;
+declare const ROW_IDS: string[];
+declare const draggableTable: (onRowDrop: TableBodyProps['onRowDrop']) => import("react").FunctionComponentElement<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "draggable" | "ref"> & {
+    type?: import("../types").TableType | undefined;
+    fixedHeader?: boolean | undefined;
+    maxHeight?: string | number | undefined;
+    hoverable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    horizontalScroll?: boolean | undefined;
+    minWidth?: string | number | undefined;
+    draggable?: boolean | undefined;
+    children: import("react").ReactNode;
+} & import("react").RefAttributes<HTMLDivElement>>;
+type RowSpec = {
+    id: string;
+    selected?: boolean;
+    disabled?: boolean;
+    withDragCell?: boolean;
+};
+declare const customTable: (rows: RowSpec[], tableProps?: Partial<TableProps>, bodyProps?: Partial<TableBodyProps>) => import("react").FunctionComponentElement<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "draggable" | "ref"> & {
+    type?: import("../types").TableType | undefined;
+    fixedHeader?: boolean | undefined;
+    maxHeight?: string | number | undefined;
+    hoverable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    horizontalScroll?: boolean | undefined;
+    minWidth?: string | number | undefined;
+    draggable?: boolean | undefined;
+    children: import("react").ReactNode;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export { type DraggableArgs, type DropTargetArgs, type MonitorCanPayload, type GetInitialDataPayload, type DragData, draggables, dropTargets, monitors, stubRect, ROW_HEIGHT, UPPER_HALF_Y, LOWER_HALF_Y, rowOf, draggableArgsOf, dropTargetArgsOf, sourceDataOf, targetDataOf, dropOnMonitors, fireRowEvent, ROW_LEFT, ROW_TOP, ROW_WIDTH, START_X, START_Y, MOVE_X, MOVE_Y, OFFSET_X, OFFSET_Y, generatePreview, startDrag, endDrag, previewOverlays, fireDragOver, trackDragOverListeners, cleanupDragPreview, ROW_IDS, draggableTable, customTable, };

package/dist/types/src/components/data-display/table/__tests__/tableTestUtils.d.ts

@@ -0,0 +1,11 @@
+import type { ReactElement } from 'react';
+/** 한 테스트 안에서 다시 부르면 같은 root 에 리렌더한다 */
+declare const render: (element: ReactElement) => HTMLElement;
+/** 각 테스트 파일의 afterEach 에서 부른다 */
+declare const cleanupRender: () => void;
+declare class ResizeObserverStub {
+    observe(): void;
+    unobserve(): void;
+    disconnect(): void;
+}
+export { render, cleanupRender, ResizeObserverStub };

package/dist/types/src/components/data-display/table/__tests__/useTableScrollbars.ownership.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/data-display/table/dnd-context.d.ts

@@ -8,5 +8,5 @@ type RowDndContextValue = {
     setIsDragging: (v: boolean) => void;
 };
 declare const RowDndContext: import("react").Context<RowDndContextValue>;
-export type { TableDndContextValue, RowDndContextValue };
+export type { TableDndContextValue };
 export { TableDndContext, RowDndContext };