@ncds/ui-admin-mcp 1.0.0-alpha.20 → 1.0.0-alpha.21

package/bin/overrides/composition.json

@@ -895,13 +895,7 @@
       "수직 테이블",
       "form-vertical-table"
     ],
-    "bemClassesExtra": [
-      "ncua-table--in-data-grid",
-      "ncua-table__required",
-      "ncua-table__cell--with-tooltip",
-      "ncua-table__cell-inner",
-      "ncua-table__cell-label"
-    ],
+    "bemClassesExtra": ["ncua-table--in-data-grid", "ncua-table__required"],
     "allowedChildren": {
       "Table": ["Table.Header", "Table.Body", "Table.Footer", "Table.ColGroup", "Table.Empty"],
       "Table.Header": ["Table.Row"],
@@ -1049,7 +1043,7 @@
         }
       },
       "vertical-form-label-with-required": {
-        "description": "P7/P12: Vertical Table 필수 라벨 표기 표준. ⚠️ ncua-table__required 는 NCDS Table SCSS 에서 font-size: var(--font-size-sm) (14px) 로 정의되는데 라벨 텍스트는 var(--font-size-xs) (13px) — baseline 이 어긋남. 정렬 보정을 위해 페이지 prefix wrapper 로 inline-flex + align-items: center 적용 권장. wrapper 클래스명은 페이지 prefix 통일 (예: 'page-vlabel') — 페이지 SCSS 에 .page-vlabel { display: inline-flex; align-items: center; gap: 4px; } .page-vlabel .ncua-table__required { line-height: 1; } 정의. component descriptor 트리로는 wrapper + raw span 을 한 번에 표현 불가 → render_to_html 출력 후 페이지 코드에서 wrapper 추가하거나, 라벨 텍스트 자체에 markup 포함 string 으로 전달. P16: 안내 Tooltip 이 필요하면 본 시나리오 대신 'vertical-form-label-with-tooltip' 을 사용하거나, 본 시나리오의 라벨 Cell 에 `tooltip: TooltipProps` prop 을 추가하면 된다 (Cell 내부 ncua-table__cell-inner / ncua-table__cell-label 로 자동 wrapping — 별도 페이지 wrapper 불필요).",
+        "description": "P7/P12: Vertical Table 필수 라벨 표기 표준. ncua-table__required 는 라벨 텍스트 앞에 `<span class='ncua-table__required'>*</span>` 형태로 prepend. 라벨 셀(Table.Cell with isHeader=true) 의 children 첫 자식이 raw markup string, 두 번째가 라벨 텍스트. ⚠️ component descriptor 트리로 페이지 prefix wrapper(예: page-vlabel) + raw span 을 한 번에 표현 불가 → render_to_html 출력 후 페이지 코드에서 추가하거나, 본 시나리오처럼 markup 을 children string 으로 전달. P16: 안내 Tooltip 이 필요하면 'vertical-form-label-with-tooltip' 시나리오 사용 — Table.Cell 은 tooltip prop 을 받지 않으며 라벨 셀의 children 에 합성한다.",
         "props": {
           "type": "vertical",
           "children": [
@@ -1112,7 +1106,7 @@
         }
       },
       "vertical-form-label-with-tooltip": {
-        "description": "P16/P23: Vertical Table 라벨 + 안내 Tooltip 표준. 라벨 옆 안내 아이콘은 Table.Cell.tooltip prop 으로 전달 — Cell 내부에 ncua-table__cell-inner / ncua-table__cell-label / .ncua-tooltip 구조로 자동 wrapping (ncua-table__cell--with-tooltip modifier 적용). 페이지 prefix wrapper(예: page-vlabel, sgr-tooltip-wrapper) 또는 라벨 셀 외부에 별도 Tooltip 컴포넌트 배치 금지 — 정렬 어긋남 + 발명 클래스 hallucination 의 주원인. tooltip 값은 NCDS Tooltip 의 React props 그대로 (type='short'/'long', tooltipType='black'/'white', content/title 등). ⚠️ P23: 출력 BEM 은 반드시 `<th scope='row' class='ncua-table__cell ncua-table__cell--with-tooltip'>` — `<th class='ncua-required'>` 같은 발명 클래스 사용 금지 (NCDS 미제공). 필수 마크는 `<span class='ncua-table__required'>*</span>` 을 라벨 텍스트 앞에 prepend. ⚠️ CDN HTML 모드에서는 tooltip 영역이 placeholder + script — CDN JS 마운트 후 anchor span 에 `<div data-tooltip-seq data-tooltip-initialized>` wrapper + `<span class='ncua-tooltip__icon'>` SVG wrapper + inline style 자동 부착. 이 결과 DOM 을 보고 '정적 출력 = NCDS 표준' 으로 오인해 페이지에서 직접 작성하지 말 것.",
+        "description": "P16/P23: Vertical Table 라벨 + 안내 Tooltip 표준 합성 패턴. Table.Cell 의 children 에 div wrapper 한 단계를 두고 그 안에 [필수 마크 span(필요 시), 라벨 텍스트, Tooltip 컴포넌트] 순으로 합성한다. NCDS Table SCSS 의 vertical 모드 룰이 Tooltip 앵커 span 을 자식으로 가진 div(셀렉터: `th:first-child > div:has(> .ncua-tooltip)`)에 한해 inline-flex 정렬을 자동 적용하므로 라벨과 합성 자식이 같은 선상에 배치된다. Tooltip 앵커 박스와 CDN JS 마운트 후 자동 생성되는 icon wrapper span(`.ncua-tooltip__icon`) 모두 SVG 크기(14px)로 수축되어 React 출력과 CDN HTML 출력 양쪽에서 동일한 박스 메트릭으로 정렬된다. spacing 은 자식별 margin 으로 관리(Required: margin-right 4px, Tooltip: margin-left 4px) — wrapper 에 flex gap 미사용. ⚠️ 사용 금지: (a) Table.Cell 에 tooltip prop 전달(시그니처에 없음). (b) ncua-table__cell--with-tooltip 모디파이어(NCDS 미정의). (c) ncua-table__cell-inner / ncua-table__cell-label 자동 wrapper(생성 안 됨). (d) 페이지 prefix wrapper(page-vlabel, sgr-tooltip-wrapper 등) 외부 배치 — 정렬 어긋남 + hallucination 주원인. ⚠️ 출력 BEM 표준은 라벨 셀이 모디파이어 없는 `<th scope='row' class='ncua-table__cell'><div>...<span class='ncua-tooltip ...'>...</span></div></th>` — th 에 추가 클래스 없음, div wrapper 가 정렬 책임. ⚠️ CDN HTML 모드의 tooltip 영역은 정적 placeholder + script — CDN JS 마운트 후 anchor span 에 `<div data-tooltip-seq data-tooltip-initialized>` wrapper + `<span class='ncua-tooltip__icon'>` SVG wrapper + inline style 자동 부착. 정적 출력을 그대로 페이지 코드로 작성하지 말고 render_to_html 출력 + CDN 스크립트 마운트 흐름을 따를 것. Tooltip 의 props 는 render_to_html 의 tooltip 컴포넌트 spec 그대로 사용(type 'short'|'long', tooltipType 'black'|'white', title, content, position 등).",
         "props": {
           "type": "vertical",
           "children": [
@@ -1121,19 +1115,16 @@
               "children": [
                 {
                   "component": "table.row",
-                  "_note": "필수 + 안내 tooltip 라벨. children 첫 자식은 ncua-table__required span raw markup, 두 번째는 라벨 텍스트. tooltip 은 props.tooltip 으로 전달 — Cell 내부에서 라벨과 함께 inline-flex wrapping.",
+                  "_note": "필수 + 안내 tooltip 라벨. Table.Cell 의 children 트리는 div wrapper 한 단계 안에 [필수 마크 span raw markup, 라벨 텍스트, Tooltip 컴포넌트] 순으로 합성. tree 표현 한계로 div 와 Tooltip 자식을 한 markup string 으로 묶고 anchor 만 placeholder 로 표시 — render_to_html 출력이 사용 환경에 맞춰 실제 Tooltip 마크업으로 채운다.",
                   "children": [
                     {
                       "component": "table.cell",
                       "props": {
-                        "isHeader": true,
-                        "tooltip": {
-                          "type": "short",
-                          "tooltipType": "black",
-                          "content": "외부에 노출되는 상품명입니다. 50자 이내로 입력하세요."
-                        }
+                        "isHeader": true
                       },
-                      "children": ["<span class=\"ncua-table__required\">*</span>", "상품명"]
+                      "children": [
+                        "<div><span class=\"ncua-table__required\">*</span>상품명<span class=\"ncua-tooltip ncua-tooltip--sm ncua-tooltip--short ncua-tooltip--stroke\"></span></div>"
+                      ]
                     },
                     {
                       "component": "table.cell",
@@ -1143,20 +1134,16 @@
                 },
                 {
                   "component": "table.row",
-                  "_note": "비필수 + 안내 tooltip. required span 없이 텍스트 + tooltip prop.",
+                  "_note": "비필수 + 안내 tooltip. 필수 마크 span 없이 div wrapper 안에 [라벨 텍스트, Tooltip 컴포넌트] 합성. children 트리는 위 row 와 동일 구조에서 Required span 만 빠진 형태.",
                   "children": [
                     {
                       "component": "table.cell",
                       "props": {
-                        "isHeader": true,
-                        "tooltip": {
-                          "type": "long",
-                          "tooltipType": "white",
-                          "title": "카테고리 안내",
-                          "content": "상품을 분류하는 최상위 카테고리입니다. 변경 시 검색·노출 영역에 영향."
-                        }
+                        "isHeader": true
                       },
-                      "children": ["카테고리"]
+                      "children": [
+                        "<div>카테고리<span class=\"ncua-tooltip ncua-tooltip--sm ncua-tooltip--long ncua-tooltip--stroke\"></span></div>"
+                      ]
                     },
                     {
                       "component": "table.cell",
@@ -2414,21 +2401,7 @@
   "notification": {
     "_note": "P20/P22: Notification 은 비차단 알림 컴포넌트. type ∈ {floating, full-width, message} × color ∈ {neutral, error, warning, success, info} 매트릭스 (단, floating 은 info 색상 미지원). props 기반 — subComponents 없음. ⚠️⚠️ BEM prefix 는 type 별로 분리: type='floating' → `ncua-floating-notification__*`, type='full-width' → `ncua-full-width-notification__*`, type='message' → `ncua-message-notification__*`. **generic 한 `ncua-notification__*` prefix 는 존재하지 않음** — godomall5 페이지에서 발견된 가짜 BEM. floating 은 페이지 우측 영역 자동 노출(autoClose 지원), full-width 는 화면 상단 가로 배너, message 는 인라인 메시지 박스. onHidePermanently 는 message / full-width 에서만 동작. React 컴포넌트 + CDN CSS 완비 — 반드시 render_to_html('notification', {...}) 호출해 정확한 type-prefix BEM 출력을 받아 그대로 사용.",
     "descriptionExtra": "[중요] 비차단 알림 컴포넌트. type 으로 표현 형태(floating/full-width/message) 결정, color 로 상태(neutral/error/warning/success/info) 결정. ⚠️ BEM prefix 가 type 별로 다름: floating→ncua-floating-notification__*, full-width→ncua-full-width-notification__*, message→ncua-message-notification__*. generic ncua-notification__* prefix 는 존재하지 않으니 절대 직접 작성 금지 — render_to_html 출력 그대로 사용. type='floating' 은 color='info' 미지원. autoClose 는 floating 전용 (밀리초). onHidePermanently 는 message / full-width 전용. 페이지 prefix wrapper(toast-wrapper, alert-banner 등) 우회 금지.",
-    "bemClassesExtra": [
-      "ncua-floating-notification",
-      "ncua-floating-notification__container",
-      "ncua-floating-notification__content",
-      "ncua-floating-notification__title",
-      "ncua-floating-notification__icon",
-      "ncua-full-width-notification",
-      "ncua-full-width-notification__container",
-      "ncua-full-width-notification__content",
-      "ncua-full-width-notification__title",
-      "ncua-message-notification",
-      "ncua-message-notification__container",
-      "ncua-message-notification__content",
-      "ncua-message-notification__title"
-    ],
+    "bemClassesExtra": ["ncua-floating-notification__icon"],
     "aliasesExtra": [
       "알림",
       "알림창",

package/bin/tools/listSidecarOverrides.d.ts

@@ -0,0 +1,54 @@
+/**
+ * list_sidecar_overrides tool — composition.json sidecar 적용 현황 요약
+ *
+ * 신규 프로젝트에서 NCDS MCP 와 연결한 뒤, 어느 컴포넌트에 어떤 sidecar 보강이
+ * 들어가 있는지 표 형태(컴포넌트별 row)로 한 번에 확인하는 용도. 응답이 크지 않도록
+ * 시나리오 키 목록 + 카운트 위주로 구성하고, 상세는 get_component_props 로 유도.
+ *
+ * 순수 함수 — server.ts 부팅 시 1회 buildListSidecarOverridesResponse() 로 사전 직렬화.
+ */
+import type { ComponentData } from '../types.js';
+import type { CompositionEntry } from '../utils/dataLoader.js';
+import { type McpToolResponse } from '../utils/response.js';
+export interface SidecarOverrideSummary {
+    /** 컴포넌트 이름 (kebab-case) */
+    component: string;
+    /** canonicalExamples 시나리오 key 목록 — 비어있으면 [] */
+    canonicalExamples: string[];
+    /** legacy 단일 시나리오 canonicalExample 존재 여부 */
+    hasCanonicalExample: boolean;
+    /** bemClassesExtra 항목 수 */
+    bemClassesExtra: number;
+    /** allowedChildren 정의된 부모 키 목록 (예: ["Table", "Table.Header", ...]) */
+    allowedChildrenKeys: string[];
+    /** allowedParents 정의된 자식 키 목록 */
+    allowedParentsKeys: string[];
+    /** descriptionExtra 존재 여부 */
+    descriptionExtra: boolean;
+    /** aliasesExtra 항목 수 */
+    aliasesExtra: number;
+    /** AI 의 UI 작성 정확도 추정 점수 (0.0 ~ 1.0). 시나리오 + compound 제약 + validate 정확도 + 자연어 보강의 가중 합. */
+    coverageScore: number;
+    /** 컴포넌트 구조상 의미 있게 달성 가능한 최대 점수. compound 컴포넌트(subComponents 보유): 1.0, 그 외: 0.8. */
+    maxAchievable: number;
+    /** coverageScore / maxAchievable — 컴포넌트별 천장 대비 충족율 (0.0 ~ 1.0). 절대 점수가 낮아도 비율이 1.0 이면 더 보강할 게 없다. */
+    coverageRatio: number;
+    /** coverageScore 한 줄 해석 — high/medium/low 와 강점 영역 요약 */
+    coverageNote: string;
+}
+export interface ListSidecarOverridesResult {
+    /** sidecar 적용 컴포넌트 수 */
+    total: number;
+    /** 각 척도가 무엇을 의미하고 AI 의 UI 작성 정확도에 어떻게 영향을 주는지 (AI 가 본 응답을 바로 해석하도록 동봉) */
+    metrics: Record<string, string>;
+    /** coverageScore 산식 (가중치 명시) */
+    coverageScoreFormula: string;
+    /** 컴포넌트별 요약 row 배열 — coverageScore 내림차순, 동률은 컴포넌트 이름 알파벳 */
+    overrides: SidecarOverrideSummary[];
+}
+/** sidecar map → 요약 결과 (순수 함수). coverageRatio 내림차순 + 동률은 coverageScore + 이름 알파벳 */
+export declare const buildSidecarOverridesSummary: (sidecar: Record<string, CompositionEntry>, componentMap: Map<string, ComponentData>) => ListSidecarOverridesResult;
+/** server.ts 부팅 시 1회 호출 — 응답 사전 직렬화 */
+export declare const buildListSidecarOverridesResponse: (sidecar: Record<string, CompositionEntry>, componentMap: Map<string, ComponentData>) => McpToolResponse;
+/** list_sidecar_overrides tool — 사전 직렬화된 응답을 그대로 반환 */
+export declare const listSidecarOverrides: (prebuilt: McpToolResponse) => McpToolResponse;

package/bin/tools/listSidecarOverrides.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSidecarOverrides = exports.buildListSidecarOverridesResponse = exports.buildSidecarOverridesSummary = void 0;
+const response_js_1 = require("../utils/response.js");
+/** AI 가 UI 를 얼마나 정확히 그릴 수 있는지 추정 — 각 sidecar 보강이 다른 정확도 영역을 커버한다 */
+const METRIC_DESCRIPTIONS = {
+    canonicalExamples: 'AI 가 시나리오별로 분기 가능한 정답 트리 수 (form / data-grid / with-tooltip 등). 가장 강한 정확도 신호 — 0 이면 AI 가 prop 조합을 추측해야 한다.',
+    hasCanonicalExample: 'legacy 단일 시나리오 존재 여부 — 진입용 표준 트리 1건. canonicalExamples 가 비어있는 컴포넌트의 fallback.',
+    bemClassesExtra: 'extract 가 못 잡은 BEM 클래스 화이트리스트 수. validate_html 이 합법/위법을 정확히 판정 — 발명 클래스 사용 차단력.',
+    allowedChildrenKeys: 'compound 부모-자식 제약 노드 수. 잘못된 자식 끼우기 / 컨텍스트 위반 (Table.Pagination in DataGrid 등) 차단력.',
+    allowedParentsKeys: '역방향 제약 노드 수 — 자식이 어느 부모 안에만 허용되는지 명시.',
+    descriptionExtra: 'list_components 응답에 자연어 용도/모드 명시 여부. 같은 컴포넌트가 다른 모드(horizontal/vertical) 로 쓰일 때 AI 가 모드를 인지하는 정확도.',
+    aliasesExtra: 'search_component 한국어/유사 키워드 매칭 별칭 수. AI 가 "폼 레이아웃", "세로 테이블" 같은 비공식 용어로 검색해도 정답 컴포넌트에 도달.',
+    maxAchievable: '구조상 의미 있게 도달 가능한 최대 점수. compound 컴포넌트(subComponents 보유): 1.0, 그 외(prop 배열로 항목 받는 컴포넌트 — menus/groups/optionItems 등): 0.8. allowedChildren 가중치(+0.20) 가 compound 가 아닌 컴포넌트에는 적용 불가하기 때문.',
+    coverageRatio: 'coverageScore / maxAchievable. 절대 점수보다 더 정확한 "보강 충족율" — 1.0 이면 해당 컴포넌트는 더 채울 영역이 없다. 0.8 미만이면 의미 있는 보강 여지 있음.',
+};
+const COVERAGE_FORMULA = 'canonicalExamples>=2: +0.50 (>=1 또는 hasCanonicalExample: +0.25) · allowedChildrenKeys>=2: +0.20 (>=1: +0.10) · bemClassesExtra>=1: +0.10 · descriptionExtra: +0.10 · aliasesExtra>=1: +0.10 · max 1.0. 임계값: high>=0.70, medium>=0.40, 그 외 low. 시나리오 가중치가 가장 큼 — AI hallucination 의 가장 강한 차단 신호이기 때문.';
+const computeCoverageScore = (s) => {
+    let score = 0;
+    if (s.canonicalExamples.length >= 2)
+        score += 0.5;
+    else if (s.canonicalExamples.length >= 1 || s.hasCanonicalExample)
+        score += 0.25;
+    if (s.allowedChildrenKeys.length >= 2)
+        score += 0.2;
+    else if (s.allowedChildrenKeys.length >= 1)
+        score += 0.1;
+    if (s.bemClassesExtra >= 1)
+        score += 0.1;
+    if (s.descriptionExtra)
+        score += 0.1;
+    if (s.aliasesExtra >= 1)
+        score += 0.1;
+    return Math.min(1, Math.round(score * 100) / 100);
+};
+/** 컴포넌트 구조상 의미 있게 도달 가능한 최대 점수.
+ *  compound (subComponents 보유): canonicalExamples 0.5 + allowedChildren 0.2 + bem 0.1 + desc 0.1 + alias 0.1 = 1.0.
+ *  non-compound: allowedChildren 항목이 의미 없음 → 0.8 cap. */
+const computeMaxAchievable = (isCompound) => (isCompound ? 1.0 : 0.8);
+const noteFor = (s, score) => {
+    const strengths = [];
+    if (s.canonicalExamples.length >= 2)
+        strengths.push(`시나리오 ${s.canonicalExamples.length}`);
+    else if (s.canonicalExamples.length >= 1 || s.hasCanonicalExample)
+        strengths.push('시나리오 1');
+    if (s.allowedChildrenKeys.length >= 1)
+        strengths.push(`compound 제약 ${s.allowedChildrenKeys.length}`);
+    if (s.bemClassesExtra >= 1)
+        strengths.push(`BEM 화이트리스트 ${s.bemClassesExtra}`);
+    if (s.descriptionExtra)
+        strengths.push('모드 인지 보강');
+    if (s.aliasesExtra >= 1)
+        strengths.push(`검색 별칭 ${s.aliasesExtra}`);
+    const tier = score >= 0.7 ? 'high' : score >= 0.4 ? 'medium' : 'low';
+    return strengths.length > 0 ? `${tier} · ${strengths.join(' + ')}` : `${tier} · 보강 거의 없음 — 직접 작성 hallucination 위험`;
+};
+/** 단일 entry 를 row 로 변환 — componentMap 으로 compound 여부 결정해 maxAchievable 계산 */
+const toSummary = (component, entry, componentMap) => {
+    const base = {
+        component,
+        canonicalExamples: Object.keys(entry.canonicalExamples ?? {}).filter((k) => !k.startsWith('_')),
+        hasCanonicalExample: !!entry.canonicalExample,
+        bemClassesExtra: (entry.bemClassesExtra ?? []).length,
+        allowedChildrenKeys: Object.keys(entry.allowedChildren ?? {}),
+        allowedParentsKeys: Object.keys(entry.allowedParents ?? {}),
+        descriptionExtra: !!entry.descriptionExtra,
+        aliasesExtra: (entry.aliasesExtra ?? []).length,
+    };
+    const coverageScore = computeCoverageScore(base);
+    const subComponentCount = Object.keys(componentMap.get(component)?.subComponents ?? {}).length;
+    const isCompound = subComponentCount > 0;
+    const maxAchievable = computeMaxAchievable(isCompound);
+    const coverageRatio = Math.round((coverageScore / maxAchievable) * 100) / 100;
+    return { ...base, coverageScore, maxAchievable, coverageRatio, coverageNote: noteFor(base, coverageScore) };
+};
+/** sidecar map → 요약 결과 (순수 함수). coverageRatio 내림차순 + 동률은 coverageScore + 이름 알파벳 */
+const buildSidecarOverridesSummary = (sidecar, componentMap) => {
+    const overrides = Object.entries(sidecar)
+        .map(([component, entry]) => toSummary(component, entry, componentMap))
+        .sort((a, b) => b.coverageRatio - a.coverageRatio ||
+        b.coverageScore - a.coverageScore ||
+        a.component.localeCompare(b.component));
+    return {
+        total: overrides.length,
+        metrics: METRIC_DESCRIPTIONS,
+        coverageScoreFormula: COVERAGE_FORMULA,
+        overrides,
+    };
+};
+exports.buildSidecarOverridesSummary = buildSidecarOverridesSummary;
+/** server.ts 부팅 시 1회 호출 — 응답 사전 직렬화 */
+const buildListSidecarOverridesResponse = (sidecar, componentMap) => (0, response_js_1.successResponse)((0, exports.buildSidecarOverridesSummary)(sidecar, componentMap));
+exports.buildListSidecarOverridesResponse = buildListSidecarOverridesResponse;
+/** list_sidecar_overrides tool — 사전 직렬화된 응답을 그대로 반환 */
+const listSidecarOverrides = (prebuilt) => prebuilt;
+exports.listSidecarOverrides = listSidecarOverrides;

package/bin/version.d.ts

@@ -3,4 +3,4 @@
  * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
  * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-export declare const VERSION = "1.8.7";
+export declare const VERSION = "1.8.8";

package/bin/version.js

@@ -6,4 +6,4 @@ exports.VERSION = void 0;
  * scripts/generate-version-ts.ts 가 ui-admin/package.json 의 version 으로부터 자동 생성한다.
  * 수동 편집 금지 — 빌드(`pnpm generate:version-ts` 또는 `pnpm build`) 시 덮어쓰여진다.
  */
-exports.VERSION = '1.8.7';
+exports.VERSION = '1.8.8';

package/data/badge-group.json

@@ -59,7 +59,7 @@
     "groupIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -134,7 +134,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -211,7 +211,7 @@
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",

package/data/badge.json

@@ -81,7 +81,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -154,7 +154,7 @@
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",

package/data/bread-crumb.json

@@ -57,7 +57,7 @@
     "items": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/navigation/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/navigation/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
       "properties": {
         "href": {
           "type": "string",

package/data/button.json

@@ -77,7 +77,7 @@
     "leadingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -158,7 +158,7 @@
     "trailingIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",

package/data/combo-box.json

@@ -88,6 +88,10 @@
       "type": "function",
       "required": false
     },
+    "onComplete": {
+      "type": "function",
+      "required": false
+    },
     "onEdit": {
       "type": "function",
       "required": false
@@ -99,7 +103,7 @@
     "optionItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -126,7 +130,7 @@
     "register": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
+      "rawType": "import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/react-hook-form@7.72.0_react@18.2.0/node_modules/react-hook-form/dist/types/form\").UseFormRegisterReturn | undefined"
     },
     "required": {
       "type": "boolean",
@@ -155,7 +159,7 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
     }
   },
   "html": {},

package/data/date-picker.json

@@ -62,7 +62,7 @@
     "datePickerOptions": {
       "type": "object",
       "required": false,
-      "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+      "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
     },
     "destructive": {
       "type": "string",

package/data/dropdown.json

@@ -115,12 +115,12 @@
     "groups": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownGroup[]",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownGroup[]",
       "properties": {
         "items": {
           "type": "object",
           "required": true,
-          "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownItemType[]",
+          "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownItemType[]",
           "properties": {
             "id": {
               "type": "string",
@@ -178,7 +178,7 @@
     "header": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownHeaderType | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownHeaderType | undefined",
       "properties": {
         "type": {
           "type": "string",
@@ -206,7 +206,7 @@
     "trigger": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").AvatarTrigger | import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").ButtonTrigger | import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").IconTrigger | import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").CustomTrigger",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").AvatarTrigger | import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").ButtonTrigger | import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").IconTrigger | import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").CustomTrigger",
       "properties": {
         "type": {
           "type": "string",

package/data/empty-state.json

@@ -37,7 +37,7 @@
     "buttons": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions | import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions | import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions[] | undefined",
       "properties": {
         "label": {
           "type": "string",
@@ -79,7 +79,7 @@
         "leadingIcon": {
           "type": "object",
           "required": false,
-          "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+          "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
           "properties": {
             "type": {
               "type": "string",
@@ -142,7 +142,7 @@
         "trailingIcon": {
           "type": "object",
           "required": false,
-          "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+          "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
           "properties": {
             "type": {
               "type": "string",

package/data/horizontal-tab.json

@@ -60,7 +60,7 @@
     "menus": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -97,7 +97,7 @@
         "badgeInfo": {
           "type": "object",
           "required": false,
-          "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/feedback-and-status/badge/Badge\").BadgeProps | undefined",
+          "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/badge/Badge\").BadgeProps | undefined",
           "properties": {
             "label": {
               "type": "string",
@@ -131,7 +131,7 @@
             "leadingIcon": {
               "type": "object",
               "required": false,
-              "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+              "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
               "properties": {
                 "type": {
                   "type": "string",
@@ -194,7 +194,7 @@
             "trailingIcon": {
               "type": "object",
               "required": false,
-              "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+              "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
               "properties": {
                 "type": {
                   "type": "string",

package/data/image-file-input.json

@@ -338,6 +338,7 @@
     "ncua-image-file-input__empty-slot-wrapper",
     "ncua-image-file-input__preview-container",
     "ncua-image-file-input__previews",
+    "ncua-image-file-input__slot-tooltip",
     "ncua-input__help-icon"
   ],
   "usage": {

package/data/modal.json

@@ -211,7 +211,7 @@
         "featuredIcon": {
           "type": "object",
           "required": false,
-          "rawType": "{ icon: import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SlotIconComponent; color: import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconColor; theme: import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconTheme; } | undefined",
+          "rawType": "{ icon: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/types/side-slot\").SlotIconComponent; color: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconColor; theme: import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconTheme; } | undefined",
           "properties": {
             "icon": {
               "type": "function",

package/data/notification.json

@@ -45,7 +45,7 @@
     "actions": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
       "properties": {
         "label": {
           "type": "string",

package/data/page-title.json

@@ -56,7 +56,7 @@
     "breadcrumbItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/layout/page-title/PageTitle\").PageTitleBreadcrumbItem[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/layout/page-title/PageTitle\").PageTitleBreadcrumbItem[] | undefined",
       "properties": {
         "label": {
           "type": "string",

package/data/progress-bar.json

@@ -52,7 +52,7 @@
     "segments": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
       "properties": {
         "value": {
           "type": "number",

package/data/range-date-picker-with-buttons.json

@@ -61,7 +61,7 @@
     "endDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -82,7 +82,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",
@@ -144,7 +144,7 @@
     "startDateOptions": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/Users/nhn/Project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
       "properties": {
         "size": {
           "type": "enum",
@@ -165,7 +165,7 @@
         "datePickerOptions": {
           "type": "object",
           "required": false,
-          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/Users/nhn/Project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",