@opsnow-mcp/opsnow-mcp-common-ui-server 1.0.44 → 1.0.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,162 @@
1
+ import { z } from "zod";
2
+ import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
3
+ // forms 패키지의 카드 · 선택 그룹 컴포넌트 (Card / CardGroup / ChipGroup / CheckboxGroup) — forms 2.0.13 번들 기준
4
+ // 선택 그룹 공통 항목
5
+ const SelectionItemSchema = z.object({
6
+ value: z.union([z.string(), z.number()]).describe("항목 값 (string | number, 그룹 안에서 고유)"),
7
+ label: z.string().describe("항목 이름 (문자열 필수) — 화면에 다르게 그려도 스크린리더·코파일럿이 이 이름을 씀"),
8
+ copilotLabel: z.string().optional().describe("코파일럿에만 보이는 이름 — 화면 이름이 겹쳐 구분이 안 될 때만"),
9
+ disabled: z.boolean().optional().describe("항목 비활성화 (흐리게 · 선택 불가)"),
10
+ });
11
+ // Card 컴포넌트 관련 스키마 정의
12
+ export const CardSchema = z.object({
13
+ children: z.string().optional().describe("카드 안 내용 JSX"),
14
+ variant: z.enum(["outlined", "plain"]).optional().describe("'outlined'(기본): 모서리 12 · 테두리 1px gray200 · 배경 · 여백 / 'plain': 상자 없이 영역만 (모양은 화면이 sx로 그림)"),
15
+ selected: z.boolean().optional().describe("선택 테두리 표시 — onClick과 같이 주면 aria-pressed 토글 카드"),
16
+ disabled: z.boolean().optional().describe("비활성화 (opacity 0.38 · 누를 수 없음)"),
17
+ onClick: z.string().optional().describe("클릭 핸들러 — 주면 버튼 카드가 됨 (role=\"button\", 탭 이동, Enter · Space)"),
18
+ padding: z.union([z.number(), z.string()]).optional().describe("안쪽 여백. 숫자는 px. 기본: outlined는 공통 토큰 cardPadding(16px 20px), plain은 0"),
19
+ sx: z.string().optional().describe("카드 상자 스타일 (폭 · 높이 등 크기·배치는 화면이 정함). 예: { width: 280 }"),
20
+ });
21
+ // CardGroup 컴포넌트 관련 스키마 정의
22
+ export const CardGroupSchema = z.object({
23
+ items: z.array(SelectionItemSchema).describe("카드 목록 [{ value, label, copilotLabel?, disabled? }] — label은 화면에 안 그려도 필수 (스크린리더·코파일럿 이름)"),
24
+ renderCard: z.string().describe("카드 내용을 그리는 함수 (item, state) => ReactNode. state = { selected, disabled, index, interactive }"),
25
+ selectionMode: z.enum(["none", "single", "multiple"]).optional().describe("'none'(기본): 표시·클릭만 / 'single': 하나 고르기 / 'multiple': 여러 장 고르기"),
26
+ value: z.any().optional().describe("선택 모드의 값. single은 값 하나(또는 null), multiple은 배열"),
27
+ onChange: z.string().optional().describe("선택 변경 핸들러 (event, value) => void — 둘째 인자가 새 값. 예: (_, v) => setValue(v)"),
28
+ onCardClick: z.string().optional().describe("카드를 눌렀을 때 (event, item) => void. selectionMode 'none'에서 주면 카드가 버튼이 됨 (이동 · 팝업). 선택 모드에서는 onChange 다음에 호출"),
29
+ allowEmpty: z.boolean().optional().describe("아무것도 고르지 않은 상태 허용. 기본: single false(고른 카드를 다시 눌러도 유지), multiple true"),
30
+ disabled: z.boolean().optional().describe("그룹 전체 비활성화"),
31
+ columns: z.union([z.number(), z.record(z.string(), z.number())]).optional().describe("한 줄 카드 수 — 숫자 또는 브레이크포인트별 { xs: 1, sm: 2, md: 4 }. 없으면 minCardWidth 기준으로 폭에 맞춰 채움"),
32
+ minCardWidth: z.number().optional().describe("columns가 없을 때 카드 최소 폭(px). 기본 200"),
33
+ gap: z.number().optional().describe("카드 사이 간격(px). 기본 16"),
34
+ cardVariant: z.enum(["outlined", "plain"]).optional().describe("'outlined'(기본): 그룹이 테두리·배경·선택 테두리를 그림 / 'plain': 상자를 그리지 않음 — 카드 모양·선택 표시를 renderCard가 state로 직접 그림"),
35
+ cardSx: z.string().optional().describe("모든 카드 공통 상자 스타일. 예: { minHeight: 120 }"),
36
+ getCardSx: z.string().optional().describe("카드마다 다른 스타일 (item, state) => sx. cardSx 다음에 적용"),
37
+ sx: z.string().optional().describe("그룹(그리드) 스타일. 고정 폭 배치 예: { gridTemplateColumns: 'repeat(2, 260px)' }"),
38
+ });
39
+ // ChipGroup 컴포넌트 관련 스키마 정의
40
+ export const ChipGroupSchema = z.object({
41
+ items: z.array(SelectionItemSchema).describe("칩 목록 [{ value, label, copilotLabel?, disabled?, group?, data? }] — group·data는 removable 모드 전용"),
42
+ value: z.any().describe("단일 선택은 값 하나(또는 null), multiple은 값 배열. removable 모드는 값 배열 또는 묶음 객체 { 묶음 키: 값[] }"),
43
+ onChange: z.string().optional().describe("변경 핸들러 (event, value) => void — 둘째 인자가 새 값. removable 모드는 셋째 인자 detail.items(남은 항목 객체들)도 받음"),
44
+ multiple: z.boolean().optional().describe("여러 개 고르기. 기본 false"),
45
+ allowEmpty: z.boolean().optional().describe("아무것도 고르지 않은 상태 허용. 기본: 단일 false(고른 칩을 다시 눌러도 유지), 다중 true. 「전체」가 필요하면 값 없음 대신 「전체」 항목을 하나 두는 것을 권장"),
46
+ disabled: z.boolean().optional().describe("그룹 전체 비활성화"),
47
+ size: z.enum(["small", "medium"]).optional().describe("칩 크기. 기본 medium (removable 모드는 small)"),
48
+ variant: z.enum(["filled", "outlined"]).optional().describe("칩 스타일 (removable 모드 기본 filled)"),
49
+ selectedVariant: z.enum(["filled", "outlined"]).optional().describe("고른 칩 스타일. 없으면 variant와 같음 (예: 고른 칩 filled · 나머지 outlined)"),
50
+ selectedColor: z.enum(["default", "primary", "secondary", "error", "warning", "info", "success"]).optional().describe("고른 칩 색. 기본 primary"),
51
+ color: z.enum(["default", "primary", "secondary", "error", "warning", "info", "success"]).optional().describe("고르지 않은 칩 색. 기본 default (removable 모드는 모든 칩 색, 기본 info)"),
52
+ renderLabel: z.string().optional().describe("칩 안 내용 (item, state) => ReactNode. 기본은 item.label"),
53
+ getChipProps: z.string().optional().describe("항목마다 OpsnowCommonChip에 더 넘길 속성 (item, state) => ({ icon, avatar, sx ... })"),
54
+ renderItem: z.string().optional().describe("항목을 직접 그림 (item, state, itemProps) => ReactNode. itemProps를 항목 루트 요소에 펼쳐 넣어야({...itemProps}) 클릭·키보드·접근성이 동작. 항목 안의 다른 버튼은 onClick에서 e.stopPropagation() 호출"),
55
+ gap: z.number().optional().describe("칩 사이 간격(px). 기본 8 (removable 모드는 4)"),
56
+ wrap: z.boolean().optional().describe("줄바꿈. 기본 true"),
57
+ removable: z.boolean().optional().describe("true면 지우기 칩 목록 — 칩을 눌러도 선택은 안 바뀌고 ✕로 값을 뺌 (적용된 필터 요약 등). 아래 groupLabels~renderRowEnd는 이 모드 전용"),
58
+ groupLabels: z.string().optional().describe("[removable] 묶음 키 → 줄 앞 이름 객체. 예: { tag: '태그', account: '계정' }"),
59
+ collapseAfter: z.number().optional().describe("[removable] 한 줄에 N개까지 보이고 나머지는 «+M 기타»로 접음. 없으면 접지 않음"),
60
+ collapsed: z.any().optional().describe("[removable] 접힘 상태(제어). boolean 또는 { 묶음 키: boolean }. 없으면 컴포넌트가 관리(처음엔 접힘)"),
61
+ onCollapsedChange: z.string().optional().describe("[removable] 접힘 상태 변경 핸들러 (collapsed) => void"),
62
+ renderMore: z.string().optional().describe("[removable] 접기 링크를 직접 그림 ({ groupKey, hiddenCount, collapsed, toggle }) => ReactNode"),
63
+ renderRowEnd: z.string().optional().describe("[removable] 줄 끝 내용 (groupKey, index) => ReactNode (예: 첫 줄 끝 「전체 지우기」 버튼)"),
64
+ sx: z.string().optional().describe("그룹 컨테이너 스타일"),
65
+ });
66
+ // CheckboxGroup 컴포넌트 관련 스키마 정의
67
+ export const CheckboxGroupSchema = z.object({
68
+ items: z.array(SelectionItemSchema).describe("체크박스 목록 [{ value, label, copilotLabel?, disabled? }]"),
69
+ value: z.string().describe("선택된 값 배열 상태 변수명 (V[]). 예: 'accounts'"),
70
+ onChange: z.string().optional().describe("변경 핸들러 (event, value) => void — 둘째 인자가 새 값 배열. 예: (_, v) => setAccounts(v)"),
71
+ selectAll: z.boolean().optional().describe("맨 위에 「전체 선택」 체크박스 표시. 기본 false — 보이는(활성) 항목만 켜고 끔"),
72
+ selectAllLabel: z.string().optional().describe("「전체 선택」 문구 바꾸기. 없으면 common i18n(common.label.select_all)을 화면 언어로 사용"),
73
+ disabled: z.boolean().optional().describe("그룹 전체 비활성화"),
74
+ direction: z.enum(["row", "column"]).optional().describe("배치 방향. 기본 column"),
75
+ size: z.enum(["small", "medium", "large"]).optional().describe("체크박스 크기. 기본 medium"),
76
+ color: z.enum(["primary", "secondary", "error", "warning", "info", "success", "default"]).optional().describe("체크박스 색. 기본 primary"),
77
+ gap: z.number().optional().describe("항목 사이 간격(px). 기본 세로 4, 가로 16"),
78
+ listMaxHeight: z.number().optional().describe("목록 최대 높이(px) — 주면 항목 목록만 스크롤되고 「전체 선택」은 위에 고정 (긴 계정 목록 등)"),
79
+ emptyContent: z.string().optional().describe("items가 비었을 때 보여 줄 JSX (검색 결과 없음 등)"),
80
+ renderLabel: z.string().optional().describe("체크박스 옆 내용 (item, state) => ReactNode. 기본은 item.label"),
81
+ sx: z.string().optional().describe("그룹 컨테이너 스타일"),
82
+ });
83
+ export function createSelectionGroupComponent() {
84
+ return [
85
+ {
86
+ name: "createCard",
87
+ description: `Card 컴포넌트 - 공통 기본 모양(모서리 12 · 테두리 1px gray200 · 여백 16px 20px)의 내용 상자 · 지표 카드
88
+ onClick을 주면 버튼 카드가 됩니다. 여러 장 중 고르기(단일·다중 선택)는 Card를 직접 나열하지 말고 CardGroup을 쓰세요.
89
+ 크기·배치(width 등)는 sx로 화면이 정합니다. 제목 헤더가 있는 패널형 컨테이너는 Tile을 씁니다.
90
+ @opsnow-common/opsnow-common-forms 2.0.13 설치본에서 확인한 컴포넌트입니다 — 더 낮은 버전이면 useCommonComponents()에 없을 수 있으니 package.json 확인.
91
+
92
+ **import:**
93
+ \`\`\`javascript
94
+ import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
95
+ const { OpsnowCommonCard } = useCommonComponents();
96
+ \`\`\``,
97
+ parameters: CardSchema,
98
+ handler: async (args) => {
99
+ const { children, ...rest } = args;
100
+ return jsxResult(jsxTag("OpsnowCommonCard", jsxAttrs(rest, { exprKeys: ["onClick", "sx"] }), children ?? "{/* 카드 내용 */}"));
101
+ },
102
+ },
103
+ {
104
+ name: "createCardGroup",
105
+ description: `CardGroup 컴포넌트 - 카드 여러 장의 배치 · 선택 · 키보드 · 접근성을 맡는 그룹 (요약 카드 줄, 클릭 카드, 단일/다중 선택 카드)
106
+ 그룹은 배치와 선택만 맡고 카드 내용은 renderCard가 그립니다. items의 label은 화면에 안 그려도 필수입니다.
107
+ - 표시만: selectionMode 생략 ('none')
108
+ - 클릭해서 이동·팝업: onCardClick만 지정
109
+ - 고르기: selectionMode="single" | "multiple" + value + onChange={(_, v) => setValue(v)} — onChange 둘째 인자가 새 값
110
+ - 열 수: columns={{ xs: 1, sm: 2, md: 4 }} 또는 minCardWidth
111
+ @opsnow-common/opsnow-common-forms 2.0.13 설치본에서 확인한 컴포넌트입니다 — 더 낮은 버전이면 useCommonComponents()에 없을 수 있으니 package.json 확인.
112
+
113
+ **import:**
114
+ \`\`\`javascript
115
+ import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
116
+ const { OpsnowCommonCardGroup } = useCommonComponents();
117
+ \`\`\``,
118
+ parameters: CardGroupSchema,
119
+ handler: async (args) => jsxResult(jsxTag("OpsnowCommonCardGroup", jsxAttrs(args, { exprKeys: ["renderCard", "value", "onChange", "onCardClick", "cardSx", "getCardSx", "sx"] }))),
120
+ },
121
+ {
122
+ name: "createChipGroup",
123
+ description: `ChipGroup 컴포넌트 - 칩으로 고르는 필터 (카테고리 단일 선택, 클라우드 다중 선택) 또는 지우기 칩 목록(removable)
124
+ Chip을 map으로 나열해 선택 상태를 직접 관리하지 말고 ChipGroup을 쓰세요 (선택 · 키보드 · 접근성 포함).
125
+ - onChange 둘째 인자가 새 값: onChange={(_, v) => setValue(v)}
126
+ - 단일 선택은 고른 칩을 다시 눌러도 풀리지 않습니다 (allowEmpty로 변경)
127
+ - removable: 칩을 눌러도 선택이 안 바뀌고 ✕로 값을 뺍니다 (적용된 필터 요약)
128
+ @opsnow-common/opsnow-common-forms 2.0.13 설치본에서 확인한 컴포넌트입니다 — 더 낮은 버전이면 useCommonComponents()에 없을 수 있으니 package.json 확인.
129
+
130
+ **import:**
131
+ \`\`\`javascript
132
+ import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
133
+ const { OpsnowCommonChipGroup } = useCommonComponents();
134
+ \`\`\``,
135
+ parameters: ChipGroupSchema,
136
+ handler: async (args) => jsxResult(jsxTag("OpsnowCommonChipGroup", jsxAttrs(args, {
137
+ exprKeys: ["value", "onChange", "renderLabel", "getChipProps", "renderItem", "groupLabels", "collapsed", "onCollapsedChange", "renderMore", "renderRowEnd", "sx"],
138
+ }))),
139
+ },
140
+ {
141
+ name: "createCheckboxGroup",
142
+ description: `CheckboxGroup 컴포넌트 - 체크박스 여러 개를 값 배열 하나로 다루는 그룹 (계정 선택, 요일 선택)
143
+ Checkbox를 map으로 나열해 배열 상태를 직접 관리하지 말고 CheckboxGroup을 쓰세요.
144
+ **주의: 화면에 항상 펼쳐져 있는 체크박스 목록입니다 (패널·팝업·설정 폼 안).**
145
+ 「필터」 요청(계정 필터, 제품 필터 등 조회 조건)은 기본적으로 드롭다운입니다 — 드롭다운을 열어 체크박스로 고르는 필터는
146
+ 이 컴포넌트가 아니라 AutocompleteSelect(OpsnowCommonAutocomplete)에 multiple + useCheckboxOption + useSelectAll 을 쓰세요 (검색 내장).
147
+ "펼쳐진 목록", "패널에 나열" 처럼 항상 보이는 목록을 요청했을 때만 CheckboxGroup을 쓰고, 어느 쪽인지 불분명하면 같은 화면의 기존 필터 형태를 따릅니다.
148
+ - onChange 둘째 인자가 새 값 배열: onChange={(_, v) => setValue(v)}
149
+ - selectAll: 「전체 선택」 체크박스 (문구는 common i18n 자동)
150
+ - 검색은 화면이 items를 걸러 넘깁니다 — 가려진 선택값은 지워지지 않습니다
151
+ @opsnow-common/opsnow-common-forms 2.0.13 설치본에서 확인한 컴포넌트입니다 — 더 낮은 버전이면 useCommonComponents()에 없을 수 있으니 package.json 확인.
152
+
153
+ **import:**
154
+ \`\`\`javascript
155
+ import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
156
+ const { OpsnowCommonCheckboxGroup } = useCommonComponents();
157
+ \`\`\``,
158
+ parameters: CheckboxGroupSchema,
159
+ handler: async (args) => jsxResult(jsxTag("OpsnowCommonCheckboxGroup", jsxAttrs(args, { exprKeys: ["value", "onChange", "emptyContent", "renderLabel", "sx"] }))),
160
+ },
161
+ ];
162
+ }
@@ -1,4 +1,5 @@
1
1
  import { z } from "zod";
2
+ import { UIDEMO_BASE_URL, looksLikeDemoUrl, renderDemoMatch } from "./data/uidemo-routes.js";
2
3
  // optional/default/describe 래퍼를 벗겨가며 타입·기본값·설명 수집
3
4
  // 중첩 z.object는 'options.color' 형태의 dotted name으로 펼침
4
5
  function inspectField(name, field, depth = 0) {
@@ -115,23 +116,29 @@ export function createSpecTools(componentTools, exampleKeys) {
115
116
  }
116
117
  md += `\n다음 단계:\n`;
117
118
  md += `1. 컴포넌트를 골랐으면 props/import 확인: getComponentSpec({ component: "이름" })\n`;
118
- md += `2. 실제 사용 예제 확인: getUIExamples({ uiType: "이름" })`;
119
+ md += `2. 실제 사용 예제 확인: getUIExamples({ uiType: "이름" })\n`;
120
+ md += `\nuidemo 데모 링크(${UIDEMO_BASE_URL}/...)를 받았으면 이름 대신 링크를 그대로 넣으세요: getComponentSpec({ component: "<데모 링크>" }) → 그 화면의 컴포넌트·예제 호출문을 돌려줍니다.`;
119
121
  return { content: [{ type: "text", text: md }] };
120
122
  },
121
123
  };
122
124
  const componentSpecParams = z.object({
123
125
  component: z
124
126
  .string()
125
- .describe(`스펙을 조회할 컴포넌트 이름. 사용 가능: ${componentNames.join(", ")}`),
127
+ .describe(`스펙을 조회할 컴포넌트 이름, 또는 uidemo 데모 링크(${UIDEMO_BASE_URL}/chart/xy-multi-chart 처럼 URL 전체 — #tab=<id> 포함 가능). 사용 가능: ${componentNames.join(", ")}`),
126
128
  });
127
129
  const getComponentSpec = {
128
130
  name: "getComponentSpec",
129
131
  description: `OpsNow 공통 UI 컴포넌트의 스펙(props 테이블, import 방법, 사용 규칙)을 반환합니다.
130
132
  **컴포넌트 코드를 작성하기 전에 반드시 해당 컴포넌트로 호출하세요.**
133
+ uidemo 데모 링크(${UIDEMO_BASE_URL}/...)를 component 에 그대로 넣으면 그 화면의 컴포넌트 목록과 스펙·예제 호출문을 반환합니다.
131
134
  사용 가능한 컴포넌트: ${componentNames.join(", ")}`,
132
135
  parameters: componentSpecParams,
133
136
  handler: async (args) => {
134
137
  const input = args.component ?? "";
138
+ // uidemo 데모 링크
139
+ if (looksLikeDemoUrl(input)) {
140
+ return { content: [{ type: "text", text: renderDemoMatch(input) }] };
141
+ }
135
142
  const target = normalize(input);
136
143
  const matched = componentNames.find(n => normalize(n) === target);
137
144
  // 매칭 실패 → 빈 응답 금지, 복붙 가능한 대안 호출문 반환
@@ -83,6 +83,21 @@ export const TooltipSchema = z.object({
83
83
  .optional()
84
84
  .describe("ref를 사용할 경우, ref 변수 명만 문자열로 입력"),
85
85
  }).describe("iconName을 사용하는 경우 - createIconsComponent에서 iconName을 반드시 참조하여 string으로 입력, useIcon/useMuiIcon 둘 중 true");
86
+ // IconTooltip 컴포넌트 관련 스키마 정의 (d.ts의 alignItems · justifyContent는 런타임이 읽지 않아 제외)
87
+ export const IconTooltipSchema = z.object({
88
+ title: z.string().describe("툴팁 내용 — 문자열 또는 JSX (이미지 등)"),
89
+ placement: z.enum(["bottom-end", "bottom-start", "bottom", "left-end", "left-start", "left", "right-end", "right-start", "right", "top-end", "top-start", "top"]).optional().describe("툴팁 표시 위치. 기본 top"),
90
+ useIcon: z.boolean().optional().describe("OpsNow 아이콘(iconName) 사용. 기본 false — true면 useMuiIcon은 자동으로 false"),
91
+ iconName: z.string().optional().describe("useIcon일 때 OpsNow 아이콘 이름. 기본 'InfoCircleOutline'"),
92
+ useMuiIcon: z.boolean().optional().describe("Material 아이콘(label) 사용. 기본값은 useIcon의 반대 — 둘 다 안 주면 Material 아이콘이 표시됨"),
93
+ label: z.string().optional().describe("useMuiIcon일 때 Material 아이콘 이름 (예: 'info', 'close'). 툴팁 문구가 아님 — 문구는 title"),
94
+ muiColor: z.enum(["inherit", "primary", "secondary", "success", "error", "info", "warning"]).optional().describe("Material 아이콘 색 (useMuiIcon 전용)"),
95
+ commonColor: z.string().optional().describe("아이콘 색 (CSS color 값). 기본 commonPalette.gray[600]. 예: theme.palette.commonPalette.darkblue[500]"),
96
+ size: z.number().optional().describe("OpsNow 아이콘 크기(px). 기본 16 (useIcon 전용)"),
97
+ tooltipFullWidth: z.boolean().optional().describe("툴팁 최대 너비(256px) 제한 해제"),
98
+ tooltipPreview: z.boolean().optional().describe("흰 배경 미리보기 스타일 (이미지 툴팁 등)"),
99
+ disableInteractive: z.boolean().optional().describe("툴팁 위로 마우스를 옮기면 바로 닫히게 함"),
100
+ });
86
101
  // Tooltip 컴포넌트 함수 - 배열 반환
87
102
  export function createTooltipComponent() {
88
103
  return [
@@ -192,5 +207,40 @@ export function createTooltipComponent() {
192
207
  };
193
208
  },
194
209
  },
210
+ {
211
+ name: "createIconTooltip",
212
+ description: `IconTooltip 컴포넌트 - 아이콘에 마우스를 올리면 툴팁이 뜨는 도움말 아이콘 (라벨 옆 ⓘ 설명 등)
213
+ children 없이 단독으로 씁니다 (아이콘을 직접 그림). 버튼·텍스트 등 다른 요소에 툴팁을 붙이려면 Tooltip을 쓰세요.
214
+ - OpsNow 아이콘: useIcon + iconName (기본 InfoCircleOutline)
215
+ - Material 아이콘: useMuiIcon + label (아이콘 이름)
216
+ - open · onOpen · onClose · enterDelay 등 제어 prop과 alignItems · justifyContent는 받지 않습니다 (무시됨)
217
+
218
+ **import:**
219
+ \`\`\`javascript
220
+ import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
221
+ const { OpsnowCommonIconTooltip } = useCommonComponents();
222
+ \`\`\``,
223
+ parameters: IconTooltipSchema,
224
+ handler: async (args) => {
225
+ const { title, commonColor, ...rest } = args;
226
+ const isExpr = (v) => /^[<{(]|^[\w.]+\[|\.palette\./.test(v.trim());
227
+ const props = [isExpr(title) ? `title={${title}}` : `title="${title}"`];
228
+ for (const [k, v] of Object.entries(rest)) {
229
+ if (v === undefined)
230
+ continue;
231
+ if (typeof v === "string")
232
+ props.push(`${k}="${v}"`);
233
+ else if (typeof v === "boolean")
234
+ props.push(v ? k : `${k}={false}`);
235
+ else
236
+ props.push(`${k}={${v}}`);
237
+ }
238
+ if (commonColor)
239
+ props.push(isExpr(commonColor) ? `commonColor={${commonColor}}` : `commonColor="${commonColor}"`);
240
+ return {
241
+ content: [{ type: "text", text: `\`\`\`jsx\n<OpsnowCommonIconTooltip\n ${props.join("\n ")}\n/>\n\`\`\`` }],
242
+ };
243
+ },
244
+ },
195
245
  ];
196
246
  }
package/build/index.js CHANGED
@@ -18,6 +18,12 @@ const toolFlowInstructions = LEGACY_MODE ? "" : `
18
18
  2. 코드 작성 전: getComponentSpec({ component: "이름" }) 으로 props/import 확인
19
19
  3. 실제 패턴 확인: getUIExamples({ uiType: "이름" })
20
20
  4. 코드 작성/수정 후: validateProps({ code: "작성한 코드 전체" }) 로 props 검증
21
+
22
+ **uidemo 데모 링크를 받았을 때** (https://uidemo.finplex.bespinglobal.com/v2/uidemo/... — "이 데모처럼 만들어줘", "이 샘플 참고" 등)
23
+ 링크를 직접 열지 말고 getComponentSpec({ component: "<링크 전체>" }) 를 호출하세요 (#tab=<id> 포함 가능).
24
+ 그 화면의 컴포넌트 목록과 스펙·예제 호출문(getComponentSpec / getUIExamples)을 돌려주므로 그대로 실행하면 됩니다.
25
+ "그 데모의 N번째 예제"라고 하면 링크 뒤에 번호를 붙이세요: getUIExamples({ uiType: "<링크 전체> 3" }) → 데모 화면 위에서 3번째 예제에 해당하는 예제 호출문을 돌려줍니다 (차트·그리드 페이지, 폼·셀렉트·툴팁 탭).
26
+ 데모 화면에 보이는 예제 제목(예: "Base Interval Month", "Single Select - do not close on select")만 받았을 때는 getUIExamples의 keyword에 그 제목을 넣으세요. 컴포넌트를 모르면 uiType에 제목만 넣어도 해당 예제 호출문을 돌려줍니다.
21
27
  `;
22
28
  // MCP 서버 생성
23
29
  const server = new McpServer({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opsnow-mcp/opsnow-mcp-common-ui-server",
3
- "version": "1.0.44",
3
+ "version": "1.0.45",
4
4
  "type": "module",
5
5
  "main": "index.js",
6
6
  "bin": {