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

package/bin/types.d.ts

@@ -15,6 +15,24 @@ export interface ComponentUsage {
     import: string;
     react: Record<string, string>;
 }
+/** P8: allowedChildren 의 구조화 객체 형태 (P5-2).
+ *  - required: 부모 안에 반드시 있어야 하는 자식
+ *  - recommended: 강력히 권장 (없어도 통과)
+ *  - optional: 선택적 (사용자 명시 요청 시만)
+ *  - forbiddenInContext: { childKey: reason } — 이름은 valid 컴포넌트지만 이 부모 안에서는 사용 금지 + 대체 슬롯 안내 */
+export interface AllowedChildrenSpec {
+    required?: string[];
+    recommended?: string[];
+    optional?: string[];
+    forbiddenInContext?: Record<string, string>;
+}
+/** P8: canonicalExamples 다중 시나리오 맵의 단일 항목 (P5-1). */
+export interface CanonicalExampleEntry {
+    /** 시나리오 한 줄 설명. AI 가 어떤 시나리오를 선택할지 판단에 사용. */
+    description?: string;
+    /** render_to_html 입력으로 그대로 사용 가능한 props 트리. */
+    props: Record<string, unknown>;
+}
 export interface ComponentData {
     name: string;
     exportName: string;
@@ -37,6 +55,18 @@ export interface ComponentData {
     subComponents?: Record<string, {
         props: Record<string, PropSpec>;
     }>;
+    /** P8: Composition Overrides (`src/overrides/composition.json`) 에서 병합되는 부모-자식 제약.
+     *  키는 컴포넌트 자체("DataGrid") 또는 서브("DataGrid.Table") PascalCase.
+     *  값은 단순 배열 (legacy) 또는 구조화 객체 (required/recommended/optional/forbiddenInContext) 모두 허용. */
+    allowedChildren?: Record<string, string[] | AllowedChildrenSpec>;
+    /** P8: composition overrides 에서 병합되는 허용 부모. */
+    allowedParents?: Record<string, string[]>;
+    /** P8: composition overrides 에서 병합되는 canonical 단일 시나리오 (legacy P1-6 호환). */
+    canonicalExample?: {
+        props: Record<string, unknown>;
+    };
+    /** P8: composition overrides 에서 병합되는 canonical 다중 시나리오 맵 (P5-1). 키는 시나리오 식별자. */
+    canonicalExamples?: Record<string, CanonicalExampleEntry>;
     html?: Record<string, string>;
     bemClasses: string[];
     usage: ComponentUsage;

package/bin/utils/bemValidator.d.ts

@@ -7,7 +7,13 @@ import type { parse } from 'node-html-parser';
 import type { ComponentData } from '../types.js';
 import type { CdnMeta } from './dataLoader.js';
 interface ValidationError {
-    type: 'invalid_modifier' | 'invalid_element' | 'unknown_component' | 'missing_root_class' | 'mixed_namespace' | 'missing_cdn';
+    type: 'invalid_modifier' | 'invalid_element' | 'unknown_component' | 'missing_root_class' | 'mixed_namespace' | 'missing_cdn'
+    /** P13: Vertical Table 안에서 horizontal 전용 `ncua-table__header-cell` 사용 */
+     | 'vertical_uses_horizontal_header_cell'
+    /** P13: Vertical/Horizontal Table 안 `<tr>` 에 `ncua-table__row` 클래스 누락 */
+     | 'missing_table_row_class'
+    /** P13: 페이지 prefix `*-required` 클래스로 필수 마크 자체 작성 (ncua-table__required 사용 권장) */
+     | 'custom_required_mark';
     class: string;
     component: string;
     message: string;

package/bin/utils/dataLoader.d.ts

@@ -1,6 +1,29 @@
 import type { ComplianceRulesData, ComponentData, IconData, JsApiInfo, TokenData } from '../types.js';
 declare const DEFAULT_DATA_DIR: string;
-interface CdnMeta {
+interface CompositionEntry {
+    bemClassesExtra?: string[];
+    /** P5-2: 단순 배열 (legacy) 또는 구조화 객체 모두 허용 */
+    allowedChildren?: Record<string, string[] | import('../types.js').AllowedChildrenSpec>;
+    allowedParents?: Record<string, string[]>;
+    /** P1-6 legacy 단일 시나리오 */
+    canonicalExample?: {
+        props: Record<string, unknown>;
+    };
+    /** P5-1 다중 시나리오 맵 */
+    canonicalExamples?: Record<string, import('../types.js').CanonicalExampleEntry>;
+    /** P13: 컴포넌트 description 끝에 append (메타 보강). list_components / search_component 응답 개선용. */
+    descriptionExtra?: string;
+    /** P13: 컴포넌트 aliases 와 union (중복 제거). search_component 별칭 보강. */
+    aliasesExtra?: string[];
+    /**
+     * coverageScore 분모에서 제외할 보강 영역 목록 — 구조상 채울 수 없는 영역을 선언.
+     * 예: extract 가 BEM 클래스를 완전히 잡는 컴포넌트는 ["bemClassesExtra"] 선언 → 분모 0.10 차감 → 달성 가능한 나머지 영역만 채우면 1.0 달성.
+     * compound/non-compound 구조적 제외(allowedChildren)와 union 되어 최종 notApplicable 결정.
+     */
+    notApplicableAreas?: string[];
+}
+declare const loadCompositionOverrides: () => Record<string, CompositionEntry>;
+export interface CdnMeta {
     version: string;
     css: string;
     js: string;
@@ -9,8 +32,11 @@ interface IconMeta {
     packageName: string;
     version: string;
 }
-/** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
-declare const loadComponentsFromDir: (dataDir: string) => Map<string, ComponentData>;
+/** data/ 디렉토리의 JSON 파일을 읽어 componentMap + compositionOverrides로 반환 */
+declare const loadComponentsFromDir: (dataDir: string) => {
+    map: Map<string, ComponentData>;
+    compositionOverrides: Record<string, CompositionEntry>;
+};
 /** data/_icons.json을 읽어 IconData로 반환 (파일 없으면 빈 데이터) */
 declare const loadIconData: (dataDir: string) => IconData;
 /** _meta.json 파싱 결과 */
@@ -32,5 +58,5 @@ declare const loadJsApi: (definitionsDir: string) => Map<string, JsApiInfo>;
 declare const getComponent: (map: Map<string, ComponentData>, name: string) => ComponentData | undefined;
 /** componentMap의 모든 컴포넌트를 배열로 반환 */
 declare const getAllComponents: (map: Map<string, ComponentData>) => ComponentData[];
-export { DEFAULT_DATA_DIR, getAllComponents, getComponent, loadComplianceRules, loadComponentsFromDir, loadIconData, loadInstructions, loadJsApi, loadMeta, loadTokenData, };
-export type { CdnMeta, IconMeta, MetaData };
+export { DEFAULT_DATA_DIR, getAllComponents, getComponent, loadComplianceRules, loadCompositionOverrides, loadComponentsFromDir, loadIconData, loadInstructions, loadJsApi, loadMeta, loadTokenData, };
+export type { CompositionEntry, IconMeta, MetaData };

package/bin/utils/dataLoader.js

@@ -3,15 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadTokenData = exports.loadMeta = exports.loadJsApi = exports.loadInstructions = exports.loadIconData = exports.loadComponentsFromDir = exports.loadComplianceRules = exports.getComponent = exports.getAllComponents = exports.DEFAULT_DATA_DIR = void 0;
+exports.loadTokenData = exports.loadMeta = exports.loadJsApi = exports.loadInstructions = exports.loadIconData = exports.loadComponentsFromDir = exports.loadCompositionOverrides = exports.loadComplianceRules = exports.getComponent = exports.getAllComponents = exports.DEFAULT_DATA_DIR = void 0;
 /**
  * dataLoader — mcp/data/*.json + definitions/ 파일을 읽어 반환
  *
  * 함수 분류:
- *   loadComponentsFromDir, loadIconData, loadCdnMeta, loadInstructions → 부수효과 (fs I/O)
+ *   loadComponentsFromDir, loadCompositionOverrides, loadIconData, loadCdnMeta, loadInstructions → 부수효과 (fs I/O)
  *   getComponent, getAllComponents → 순수 함수 (Map 조회)
  *
- * Map 소유권은 server.ts가 가진다. 이 파일은 상태를 보유하지 않는다.
+ * Map + 메타데이터 소유권은 server.ts가 가진다. 이 파일은 상태를 보유하지 않는다.
  */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -19,13 +19,100 @@ const logger_js_1 = require("./logger.js");
 const response_js_1 = require("./response.js");
 const DEFAULT_DATA_DIR = path_1.default.resolve(__dirname, '../../data');
 exports.DEFAULT_DATA_DIR = DEFAULT_DATA_DIR;
+/**
+ * P8: Composition Overrides 위치.
+ * extract-mcp-data.ts 가 만드는 data/*.json 위에 컴포넌트 디렉토리를 건드리지 않고
+ * allowedChildren / allowedParents / canonicalExample / canonicalExamples / bemClassesExtra 를
+ * 추가하는 단일 채널.
+ *
+ * 빌드 산출물(bin/) 에서는 src/overrides 가 build:server 단계에서 복사되지 않을 수 있으므로
+ * src 와 bin 양쪽을 fallback 으로 본다.
+ */
+const COMPOSITION_OVERRIDES_CANDIDATES = [
+    path_1.default.resolve(__dirname, '../../src/overrides/composition.json'),
+    path_1.default.resolve(__dirname, '../overrides/composition.json'),
+];
+/** composition.json 파일에서 메타 키를 제거하여 CompositionEntry 객체만 수집 */
+const filterCompositionEntries = (parsed) => {
+    if (typeof parsed !== 'object' || !parsed)
+        return {};
+    const entries = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (key.startsWith('_'))
+            continue;
+        if (value && typeof value === 'object' && !Array.isArray(value))
+            entries[key] = value;
+    }
+    return entries;
+};
+const loadCompositionOverrides = () => {
+    for (const candidate of COMPOSITION_OVERRIDES_CANDIDATES) {
+        try {
+            const raw = fs_1.default.readFileSync(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            const entries = filterCompositionEntries(parsed);
+            logger_js_1.logger.info(`composition overrides 로딩: ${Object.keys(entries).length}개 (${path_1.default.basename(candidate)})`);
+            return entries;
+        }
+        catch (err) {
+            // ENOENT: 파일 없으면 다음 후보 시도 (TOCTOU 회피)
+            if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+                continue;
+            }
+            logger_js_1.logger.warn(`composition overrides 파싱 실패 (${candidate}): ${(0, response_js_1.toErrorMessage)(err)}`);
+            return {};
+        }
+    }
+    return {};
+};
+exports.loadCompositionOverrides = loadCompositionOverrides;
+/** P8: `_` 접두 메타 키를 객체에서 제거 (얕은 필터). canonicalExamples 같은 중첩 맵에서 _note 누출 방지. */
+const stripMetaKeys = (obj) => {
+    if (!obj)
+        return obj;
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key.startsWith('_'))
+            continue;
+        cleaned[key] = value;
+    }
+    return cleaned;
+};
+/** ComponentData 에 composition overrides 항목을 in-place 병합 — bemClasses 는 union, 나머지는 추가 필드. */
+const mergeCompositionEntry = (component, entry) => {
+    if (entry.bemClassesExtra && entry.bemClassesExtra.length > 0) {
+        const merged = new Set([...component.bemClasses, ...entry.bemClassesExtra]);
+        component.bemClasses = [...merged].sort();
+    }
+    if (entry.allowedChildren)
+        component.allowedChildren = entry.allowedChildren;
+    if (entry.allowedParents)
+        component.allowedParents = entry.allowedParents;
+    if (entry.canonicalExample) {
+        // canonicalExample 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
+        component.canonicalExample = stripMetaKeys(entry.canonicalExample);
+    }
+    if (entry.canonicalExamples) {
+        // canonicalExamples 내부 _note / _comment 같은 메타 키 제거 — 응답에 누출되지 않도록
+        component.canonicalExamples = stripMetaKeys(entry.canonicalExamples);
+    }
+    // P13: description 끝에 append — list_components 응답에서 컴포넌트 용도 명시
+    if (entry.descriptionExtra) {
+        component.description = `${component.description}\n\n${entry.descriptionExtra}`;
+    }
+    // P13: aliases union — search_component 별칭 보강 (중복 제거)
+    if (entry.aliasesExtra && entry.aliasesExtra.length > 0) {
+        const set = new Set([...(component.aliases ?? []), ...entry.aliasesExtra]);
+        component.aliases = [...set];
+    }
+};
 // ── 검증 헬퍼 (§ 3.8 복잡한 조건을 의도가 드러나는 이름으로 분리) ──────────
 /** JSON.parse 결과가 name: string 필드를 가진 컴포넌트 객체인지 검증 */
 const isValidComponentJson = (data) => !!data && typeof data === 'object' && 'name' in data && typeof data.name === 'string';
 /** JSON.parse 결과가 icons 배열을 가진 아이콘 데이터인지 검증 */
 const isValidIconJson = (data) => !!data && typeof data === 'object' && 'icons' in data && Array.isArray(data.icons);
 // ── 부수효과 함수 (fs I/O) ────────────────────────────────────────────────
-/** data/ 디렉토리의 JSON 파일을 읽어 componentMap으로 반환 */
+/** data/ 디렉토리의 JSON 파일을 읽어 componentMap + compositionOverrides로 반환 */
 const loadComponentsFromDir = (dataDir) => {
     if (!fs_1.default.existsSync(dataDir)) {
         throw new Error(`mcp/data/ 디렉토리가 없습니다: ${dataDir}`);
@@ -35,6 +122,8 @@ const loadComponentsFromDir = (dataDir) => {
         throw new Error(`mcp/data/ 디렉토리에 JSON 파일이 없습니다: ${dataDir}`);
     }
     const map = new Map();
+    // P8: composition overrides (composition.json) 를 한 번만 로딩해 각 컴포넌트에 병합 — 호출자에게도 반환
+    const compositionOverrides = loadCompositionOverrides();
     for (const file of jsonFiles) {
         const filePath = path_1.default.join(dataDir, file);
         const raw = fs_1.default.readFileSync(filePath, 'utf-8');
@@ -43,10 +132,13 @@ const loadComponentsFromDir = (dataDir) => {
             throw new Error(`JSON 파싱 실패 (${file}): name 필드가 없거나 올바르지 않습니다`);
         }
         const component = parsed;
+        const compositionOverridesEntry = compositionOverrides[component.name];
+        if (compositionOverridesEntry)
+            mergeCompositionEntry(component, compositionOverridesEntry);
         map.set(component.name, component);
     }
     logger_js_1.logger.info(`컴포넌트 ${map.size}개 로딩 완료`);
-    return map;
+    return { map, compositionOverrides };
 };
 exports.loadComponentsFromDir = loadComponentsFromDir;
 /** data/_icons.json을 읽어 IconData로 반환 (파일 없으면 빈 데이터) */

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.4";
+export declare const VERSION = "1.8.7";

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.4';
+exports.VERSION = '1.8.7';

package/data/badge-group.json

@@ -59,7 +59,7 @@
     "groupIcon": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/navigation/bread-crumb/BreadCrumb\").BreadcrumbItemProps[]",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
       "properties": {
         "type": {
           "type": "string",

package/data/combo-box.json

@@ -26,6 +26,10 @@
     "전체선택",
     "선택완료",
     "Clear",
+    "maxSelection",
+    "최대 선택 개수",
+    "최대선택",
+    "선택 제한",
     "NCDS"
   ],
   "hasChildren": true,
@@ -71,6 +75,10 @@
       "required": false,
       "default": "defaultMaxHeight"
     },
+    "maxSelection": {
+      "type": "number",
+      "required": false
+    },
     "multiple": {
       "type": "boolean",
       "required": false,
@@ -91,7 +99,7 @@
     "optionItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/dropdown/option\").OptionType[] | undefined",
       "properties": {
         "id": {
           "type": "string",
@@ -118,7 +126,7 @@
     "register": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/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"
+      "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"
     },
     "required": {
       "type": "boolean",
@@ -147,7 +155,7 @@
     "value": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/dropdown/option\").OptionValue | undefined"
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+      "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
     },
     "destructive": {
       "type": "string",

package/data/dropdown.json

@@ -2,7 +2,7 @@
   "name": "dropdown",
   "exportName": "Dropdown",
   "importPath": "@ncds/ui-admin",
-  "jsRequired": false,
+  "jsRequired": true,
   "category": "overlays",
   "description": "Dropdown(메뉴형)은 버튼, 아이콘, 아바타 등 트리거 요소를 통해 숨겨진 메뉴 또는 작업(Action) 목록을 레이어 형태로 노출하는 컴포넌트입니다.",
   "aliases": [
@@ -115,12 +115,12 @@
     "groups": {
       "type": "object",
       "required": true,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownGroup[]",
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownGroup[]",
       "properties": {
         "items": {
           "type": "object",
           "required": true,
-          "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownItemType[]",
+          "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").DropdownHeaderType | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").AvatarTrigger | import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").ButtonTrigger | import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").IconTrigger | import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/dropdown/Dropdown\").CustomTrigger",
+      "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",
       "properties": {
         "type": {
           "type": "string",

package/data/empty-state.json

@@ -37,7 +37,7 @@
     "buttons": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions | import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/feedback-and-status/empty-state/EmptyState\").ButtonOptions[] | undefined",
+      "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",
       "properties": {
         "label": {
           "type": "string",
@@ -79,7 +79,7 @@
         "leadingIcon": {
           "type": "object",
           "required": false,
-          "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+          "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+          "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/tab/TabButton\").TabButtonProps[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/feedback-and-status/badge/Badge\").BadgeProps | undefined",
+          "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+              "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
+              "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/types/side-slot\").SideSlotType | undefined",
               "properties": {
                 "type": {
                   "type": "string",

package/data/modal.json

@@ -211,7 +211,7 @@
         "featuredIcon": {
           "type": "object",
           "required": false,
-          "rawType": "{ icon: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/types/side-slot\").SlotIconComponent; color: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconColor; theme: import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/image-and-icons/featured-icon/FeaturedIcon\").FeaturedIconTheme; } | undefined",
+          "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",
           "properties": {
             "icon": {
               "type": "function",

package/data/notification.json

@@ -45,7 +45,7 @@
     "actions": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/ncds/packages/ui-admin/src/components/overlays/notification/Notification\").NotificationAction[] | undefined",
       "properties": {
         "label": {
           "type": "string",
@@ -99,6 +99,11 @@
       "type": "function",
       "required": false
     },
+    "portal": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
     "supportingText": {
       "type": "ReactNode",
       "required": false

package/data/page-title.json

@@ -56,7 +56,7 @@
     "breadcrumbItems": {
       "type": "object",
       "required": false,
-      "rawType": "import(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/layout/page-title/PageTitle\").PageTitleBreadcrumbItem[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/feedback-and-status/progress-bar/types\").ProgressSegment[] | undefined",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/packages/ui-admin/src/components/forms-and-input/date-picker/DatePicker\").DatePickerProps",
+      "rawType": "import(\"/home/runner/_work/ncds/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(\"/Users/nhncommerce/Desktop/project/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+          "rawType": "Partial<import(\"/home/runner/_work/ncds/ncds/node_modules/.pnpm/flatpickr@4.6.13/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
         },
         "destructive": {
           "type": "string",