@opsnow-mcp/opsnow-mcp-common-ui-server 1.0.39 → 1.0.41

package/build/components/opsnow-common-coach-mark.js

@@ -5,7 +5,8 @@ export const CoachMarkSchema = z.object({
     title: z.string().optional().describe("가이드 말풍선 제목 - 생략 시 본문만 표시"),
     content: z.string().describe("가이드 말풍선 본문 - 문자열 또는 JSX 사용 가능 (여러 줄/굵은 글씨/링크 등 표현 시 JSX)"),
     isJsxContent: z.boolean().optional().describe("content를 JSX로 렌더링할지 여부 - true면 content를 JSX 표현식으로 출력"),
-    placement: z.enum(["top", "bottom", "left", "right"]).optional().describe("말풍선 표시 위치 (top/bottom/left/right) - 공간이 부족하면 MUI가 자동으로 반대쪽으로 flip"),
+    placement: z.enum(["top", "top-start", "top-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end", "right", "right-start", "right-end"]).optional().describe("말풍선 표시 위치 (기본값: bottom) - 공간이 부족하면 MUI가 자동으로 반대쪽으로 flip"),
+    children: z.string().optional().describe("말풍선이 가리킬 대상 요소 JSX (실제 컴포넌트에선 필수 — 단일 엘리먼트, 예: <OpsnowCommonButton label=\"새 기능\" />)"),
     defaultOpen: z.boolean().optional().describe("닫힌 기록이 없을 때 첫 노출 여부 (기본 true) - false면 처음부터 표시되지 않음"),
     onClose: z.string().optional().describe("말풍선이 닫힐 때(X 또는 close 액션) 실행할 콜백 함수명"),
     actionLabel: z.string().optional().describe("하단 우측 액션 버튼 라벨 - 지정 시 actions={(close) => <Button onClick={close}>라벨</Button>} 형태로 렌더링 (close는 '닫기+영구저장' 핸들러)"),
@@ -52,7 +53,7 @@ export function createCoachMarkComponent() {
         <OpsnowCommonCoachMark
           ${props.join("\n          ")}
         >
-          // 가이드 대상 요소 필요(Mui Button or OpsnowCommonButton 등)
+          ${args.children ?? "{/* 가이드 대상 요소 (단일 엘리먼트, 필수) */}"}
         </OpsnowCommonCoachMark>
         `;
                 return {

package/build/components/opsnow-common-data-status.js

@@ -4,7 +4,8 @@ import { IconNamesMap, generateIconDescription } from "./data/icon-names.js";
 export const DataStatusSchema = z.object({
     type: z
         .enum(["loading", "noData", "noSearchResults", "withAction", "error"])
-        .describe("데이터 상태 및 화면에 노출 되어야하는 데이터 상태 타입"),
+        .optional()
+        .describe("데이터 상태 및 화면에 노출 되어야하는 데이터 상태 타입 (기본값: loading)"),
     title: z
         .string()
         .optional()
@@ -14,10 +15,12 @@ export const DataStatusSchema = z.object({
         .optional()
         .describe("제목 아래 작게 보이는 자세한 설명(데이터 상태 메시지)"),
     iconName: z.string().optional().describe("아이콘 이름"),
+    useMuiIcon: z.boolean().optional().describe("상태 아이콘을 MUI 아이콘으로 표시 (label에 Material 아이콘 이름)"),
+    label: z.string().optional().describe("useMuiIcon일 때 표시할 Material 아이콘 이름"),
     buttonProps: z
         .object({
         label: z.string().describe("버튼 라벨"),
-        disabled: z.boolean().default(true).describe("버튼 활성화 여부"),
+        disabled: z.boolean().optional().describe("버튼 비활성화 여부 (기본값: false)"),
         action: z
             .string()
             .optional()
@@ -32,7 +35,7 @@ export const DataStatusSchema = z.object({
             .describe(generateIconDescription({ format: "nested" }))
             .optional()
             .describe("아이콘 이름"),
-        iconPosition: z.enum(["right", "left"]).describe("버튼 위치"),
+        iconPosition: z.enum(["right", "left"]).optional().describe("버튼 아이콘 위치"),
     })
         .optional()
         .describe("버튼 속성"),
@@ -44,7 +47,7 @@ export function createDataStatusComponent() {
             name: "createDataStatus",
             description: `데이터 상태 컴포넌트 - 로딩, 성공, 에러, no Data, 검색 결과 없음 상태 표시
       **style 적용 시:**
-       div에 style 적용 보다는 mui/material의 Box, Stack, Typography 컴포넌트를 사용하여 스타일을 적용하는 것을 권장합니다.
+       OpsnowCommonDataStatus 자체에 준 sx·className·style은 적용되지 않습니다 — 바깥을 <Box sx={{ ... }}>로 감싸서 적용하세요.
       **버튼 액션 적용 시:**
        버튼 클릭 시 실행할 onConfirm 함수를 미리 정의한 후, buttonProps에서 참조하여 사용합니다.
        onConfirm은 콜백 함수이므로 사용자가 직접 구현해서 전달해야 합니다.
@@ -58,7 +61,8 @@ export function createDataStatusComponent() {
             handler: async (args) => {
                 // 데이터 상태 컴포넌트 로직 구현
                 let functionDefinitions = "";
-                if (args.type === "withAction") {
+                // buttonProps.onConfirm은 필수
+                if (args.buttonProps) {
                     functionDefinitions += `
           const onConfirm = () => {
             ${args.buttonProps?.action ? args.buttonProps.action : ""}
@@ -71,20 +75,22 @@ export function createDataStatusComponent() {
                 if (args.title)
                     dataStatusProps.push(`title="${args.title}"`);
                 if (args.description)
-                    dataStatusProps.push(`description={${args.description}}`);
+                    dataStatusProps.push(`description="${args.description}"`);
                 if (args.iconName)
                     dataStatusProps.push(`iconName="${args.iconName}"`);
+                if (args.useMuiIcon)
+                    dataStatusProps.push(`useMuiIcon`);
+                if (args.label)
+                    dataStatusProps.push(`label="${args.label}"`);
                 if (args.buttonProps) {
                     const buttonProps = [];
-                    if (args.buttonProps.action) {
-                        buttonProps.push(`onConfirm`);
-                    }
+                    buttonProps.push(`onConfirm`);
                     if (args.buttonProps.label)
                         buttonProps.push(`label: "${args.buttonProps.label}"`);
                     if (args.buttonProps.size)
                         buttonProps.push(`size: "${args.buttonProps.size}"`);
-                    if (!args.buttonProps.disabled)
-                        buttonProps.push(`disabled: ${!args.buttonProps.disabled}`);
+                    if (args.buttonProps.disabled)
+                        buttonProps.push(`disabled: true`);
                     if (args.buttonProps.muiIconName)
                         buttonProps.push(`muiIconName: "${args.buttonProps.muiIconName}"`);
                     if (args.buttonProps.iconName)

package/build/components/opsnow-common-dropdown.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { IconNamesMap } from "./data/icon-names.js";
+import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
+// dropdown 패키지(@opsnow-common/opsnow-common-dropdown 2.x) 컴포넌트 중 Select/Autocomplete/CurrencySwitcher 외 항목
+const SelectMenuItemSchema = z.object({
+    label: z.string().describe("메뉴 항목 텍스트 (필수)"),
+    iconName: z.enum(Object.keys(IconNamesMap)).optional().describe("OpsNow 아이콘 이름 — muiIconName과 둘 중 하나만"),
+    muiIconName: z.string().optional().describe("Material 아이콘 이름 (예: 'settings') — iconName과 둘 중 하나만"),
+    onClick: z.string().optional().describe("클릭 핸들러 함수명"),
+    link: z.string().optional().describe("이동할 링크 URL"),
+    hasDivider: z.boolean().optional().describe("항목 아래 구분선 표시"),
+    selected: z.boolean().optional().describe("선택 상태 표시"),
+    disabled: z.boolean().optional().describe("비활성화"),
+    keepOpenOnClick: z.boolean().optional().describe("클릭 후에도 메뉴를 닫지 않음 (기본 false — 토글 항목 등에만 true)"),
+});
+export const SelectMenuSchema = z.object({
+    menuItems: z.array(SelectMenuItemSchema).describe("메뉴 항목 배열 (필수)"),
+    button: z.string().optional().describe("메뉴를 여는 트리거 JSX (미지정 시 아이콘 버튼)"),
+    buttonIconName: z.enum(Object.keys(IconNamesMap)).optional().describe("기본 트리거 버튼의 아이콘 이름"),
+    listHeader: z.string().optional().describe("메뉴 목록 위에 표시할 JSX"),
+    listFooter: z.string().optional().describe("메뉴 목록 아래에 표시할 JSX"),
+    anchorOrigin: z.object({
+        vertical: z.enum(["top", "center", "bottom"]),
+        horizontal: z.enum(["left", "center", "right"]),
+    }).optional().describe("메뉴가 붙을 트리거 기준점 (MUI Menu anchorOrigin)"),
+    transformOrigin: z.object({
+        vertical: z.enum(["top", "center", "bottom"]),
+        horizontal: z.enum(["left", "center", "right"]),
+    }).optional().describe("메뉴 자신의 기준점 (MUI Menu transformOrigin)"),
+});
+export const CompanySelectSchema = z.object({
+    currentCompanyName: z.string().describe("현재 선택된 회사 이름 (필수)"),
+    isExtended: z.boolean().describe("확장(사이드바 펼침) 상태 여부 (필수)"),
+    autocompleteOptions: z.string().describe("회사 목록 변수명 — [{ value, label, group?, iconName?, disabled? }] (필수)"),
+    onSelect: z.string().describe("회사 선택 핸들러 함수명 ((selectedItem) => void) (필수)"),
+});
+export function createDropdownComponent() {
+    return [
+        {
+            name: "createSelectMenu",
+            description: `SelectMenu 컴포넌트 - 버튼을 누르면 펼쳐지는 액션 메뉴 (더보기 ⋯ 메뉴, 컨텍스트 메뉴)
+      값을 고르는 드롭다운은 Select, 동작을 고르는 메뉴는 SelectMenu를 씁니다.
+      menuItems의 각 항목은 label이 필수이고, 아이콘은 iconName(OpsNow) 또는 muiIconName(Material) 중 하나만 지정합니다.
+
+      **import:**
+      \`\`\`javascript
+      import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
+      const { OpsnowCommonSelectMenu } = useCommonComponents();
+      \`\`\``,
+            parameters: SelectMenuSchema,
+            handler: async (args) => {
+                const items = args.menuItems.map(item => {
+                    const fields = Object.entries(item)
+                        .filter(([, v]) => v !== undefined)
+                        .map(([k, v]) => (k === "onClick" ? `${k}: ${v}` : `${k}: ${JSON.stringify(v)}`));
+                    return `{ ${fields.join(", ")} }`;
+                });
+                const { menuItems: _menuItems, ...rest } = args;
+                const attrs = [
+                    `menuItems={[\n    ${items.join(",\n    ")}\n  ]}`,
+                    ...jsxAttrs(rest, { exprKeys: ["button", "listHeader", "listFooter"] }),
+                ];
+                return jsxResult(jsxTag("OpsnowCommonSelectMenu", attrs));
+            },
+        },
+        {
+            name: "createCompanySelect",
+            description: `CompanySelect 컴포넌트 - GNB/사이드바의 회사(테넌트) 선택 자동완성
+      4개 prop 모두 필수입니다. 일반 페이지의 값 선택에는 Autocomplete를 쓰세요.
+
+      **import:**
+      \`\`\`javascript
+      import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
+      const { OpsnowCommonCompanySelect } = useCommonComponents();
+      \`\`\``,
+            parameters: CompanySelectSchema,
+            handler: async (args) => jsxResult(jsxTag("OpsnowCommonCompanySelect", jsxAttrs(args, { exprKeys: ["autocompleteOptions", "onSelect"] }))),
+        },
+    ];
+}

package/build/components/opsnow-common-examples.js

@@ -1,5 +1,5 @@
 import { ButtonExamples, BadgeExamples, TextareaExamples, SwitchExamples, ChipExamples, TextFieldExamples, AvatarExamples, CheckboxExamples, RadioGroupExamples, CollapseExamples, SliderExamples, LinkExamples, TreeViewExamples, InsightCardExamples, InsightContentExamples, CurrencySwitcherExamples, ToggleButtonExamples } from "./examples/opsnow-common-forms-examples-data.js";
-import { IconExamples, MuiIconExamples } from "./examples/opsnow-common-icons-examples-data.js";
+import { IconExamples, MuiIconExamples, MarkersExamples } from "./examples/opsnow-common-icons-examples-data.js";
 import { CalendarExamples } from "./examples/opsnow-common-calendar-examples-data.js";
 import { GaugeChartExamples, PieChartExamples, BarChartExamples, LineChartExamples, StackChartExamples, XyMultiChartExamples, HeatmapChartExamples, BubbleChartExamples } from "./examples/opsnow-common-chart-examples-data.js";
 import { TooltipExamples } from "./examples/opsnow-common-tooltip-examples-data.js";
@@ -14,7 +14,7 @@ import { FileUploaderExamples } from "./examples/opsnow-common-file-upload-examp
 import { NotificationExamples } from "./examples/opsnow-common-notification-examples-data.js";
 import { PaginationExamples } from "./examples/opsnow-common-pagination-examples-data.js";
 import { DataStatusExamples } from "./examples/opsnow-common-data-status-examples-data.js";
-import { ProgressExamples } from "./examples/opsnow-common-progress-examples-data.js";
+import { ProgressExamples, LoadingExamples } from "./examples/opsnow-common-progress-examples-data.js";
 import { TabExamples } from "./examples/opsnow-common-tab-examples-data.js";
 import { GridLayoutExamples, MegaFilterExamples } from "./examples/opsnow-common-layout-examples-data.js";
 import { TypographyExamples } from "./examples/opsnow-common-typography-examples-data.js";
@@ -40,6 +40,7 @@ export const EXAMPLES_MAP = {
     ToggleButtonGroup: ToggleButtonExamples,
     Icon: IconExamples,
     MuiIcon: MuiIconExamples,
+    Markers: MarkersExamples,
     Calendar: CalendarExamples,
     GaugeChart: GaugeChartExamples,
     PieChart: PieChartExamples,
@@ -62,6 +63,7 @@ export const EXAMPLES_MAP = {
     Pagination: PaginationExamples,
     DataStatus: DataStatusExamples,
     Progress: ProgressExamples,
+    Loading: LoadingExamples,
     Tab: TabExamples,
     GridLayout: GridLayoutExamples,
     MegaFilter: MegaFilterExamples,

package/build/components/opsnow-common-file-upload.js

@@ -3,7 +3,7 @@ import { z } from "zod";
 export const FileUploaderSchema = z.object({
     accept: z.record(z.string(), z.array(z.string())).optional().describe("허용할 파일 타입 (예: { 'application/pdf': ['.pdf'] })"),
     multiple: z.boolean().optional().default(false).describe("다중 파일 업로드 가능 여부"),
-    targetUrl: z.string().optional().describe("업로드 대상 URL"),
+    targetUrl: z.string().describe("업로드 대상 URL (필수)"),
     disabled: z.boolean().optional().default(false).describe("비활성화 여부"),
     helperText: z.string().optional().describe("도움말 텍스트"),
     fileNotSelectedText: z.string().optional().describe("파일 미선택 시 텍스트"),
@@ -15,6 +15,7 @@ export const FileUploaderSchema = z.object({
     placeholder: z.string().optional().describe("플레이스홀더 텍스트"),
     dropPlaceholder: z.string().optional().describe("파일을 드래그하여 업로드 영역 위로 올렸을 때 표시되는 안내 텍스트 (string). 미지정 시 라이브러리 기본 문구 사용"),
     onChange: z.string().optional().describe("onChange 핸들러 함수명"),
+    ref: z.string().optional().describe("useRef 변수명 — ref.current.upload(formDataKey, headers?, params?), clearFiles(), setInvalid(), clearInvalid() 호출용"),
 });
 // FileUploader MCP 툴 함수 - Stepper MCP 툴 구조 참고
 export function createFileUploaderComponent() {
@@ -34,6 +35,8 @@ export function createFileUploaderComponent() {
                 const propList = Object.entries(args)
                     .filter(([_, v]) => v !== undefined)
                     .map(([k, v]) => {
+                    if (k === 'onChange' || k === 'ref')
+                        return `${k}={${v}}`;
                     if (typeof v === 'string')
                         return `${k}="${v}"`;
                     if (typeof v === 'boolean')

package/build/components/opsnow-common-forms.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { IconNamesMap, generateIconDescription } from "./data/icon-names.js";
+import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
 // Button 컴포넌트 관련 스키마 정의
 export const ButtonSchema = z.object({
     label: z.string().optional().describe("버튼 라벨"),
@@ -13,12 +14,13 @@ export const ButtonSchema = z.object({
     iconOnly: z.boolean().optional().describe("아이콘만 표시"),
     disabled: z.boolean().optional().describe("비활성화 여부"),
     loading: z.boolean().optional().describe("로딩 상태"),
-    onClick: z.string().optional().describe("클릭 이벤트 핸들러")
+    onClick: z.string().optional().describe("클릭 이벤트 핸들러"),
+    copilotId: z.string().optional().describe("Copilot 연동 ID — Copilot 매니페스트의 bind.copilotId와 매칭되어 AI가 이 컨트롤을 조작할 수 있게 함. useCommonComponents()로 받은 컴포넌트에서만 동작(로더 HOC가 소비 후 제거)"),
 });
 // Badge 컴포넌트 관련 스키마 정의
 export const BadgeSchema = z.object({
     badgeContent: z.number().optional().describe("뱃지 내용 (숫자)"),
-    color: z.enum(["primary", "error", "info", "warning", "success"]).default("primary").describe("뱃지 색상"),
+    color: z.enum(["primary", "secondary", "error", "info", "warning", "success"]).default("primary").describe("뱃지 색상 (실제 컴포넌트에선 필수). badgeContent·variant·color·children·showZero 외 MUI Badge prop은 전달되지 않음"),
     variant: z.enum(["standard", "dot"]).optional().describe("뱃지 스타일"),
     showZero: z.boolean().optional().describe("0일 때도 표시 여부"),
     children: z.string().optional().describe("뱃지 내부 콘텐츠")
@@ -60,12 +62,14 @@ export const TextFieldSchema = z.object({
     placeholder: z.string().optional().describe("입력 필드에 표시될 플레이스홀더 텍스트"),
     value: z.string().optional().describe("입력 필드의 값. React 상태 변수 이름을 전달하세요 (예: 'name')."),
     onChange: z.string().optional().describe("값이 변경될 때 실행할 함수의 본문을 문자열로 전달하세요 (예: '(e) => setName(e.target.value)')."),
-    variant: z.enum(["standard", "outlined", "filled"]).default("standard").describe("입력 필드 스타일"),
-    type: z.enum(["text", "password", "number"]).optional().describe("입력 타입"),
+    variant: z.enum(["standard", "outlined", "filled"]).optional().describe("입력 필드 스타일 — 미지정 시 MUI 기본값 outlined로 렌더 (standard 원하면 명시)"),
+    type: z.string().optional().describe("input type (예: 'text', 'password', 'number', 'email', 'search')"),
     size: z.enum(["medium", "small"]).optional().describe("입력 필드 크기"),
     error: z.boolean().optional().describe("에러 상태 여부"),
     helperText: z.string().optional().describe("입력 필드 아래에 표시될 도움말 텍스트"),
     disabled: z.boolean().optional().describe("비활성화 여부"),
+    InputProps: z.string().optional().describe("InputProps 객체(JSX/문자열) — Input 컴포넌트에 전달 (예: { endAdornment: <InputAdornment position=\"end\">원</InputAdornment> }). 래퍼가 내부에서 slotProps.input으로 매핑"),
+    InputLabelProps: z.string().optional().describe("InputLabelProps 객체(JSX/문자열) — 라벨에 전달 (예: { shrink: true })"),
     inputProps: z.string().optional().describe(`inputProps 객체(JSX/문자열).
 - input 엘리먼트에 직접 전달할 속성 객체입니다.
 - 예: { readOnly: true }, { inputMode: 'numeric', pattern: '[0-9]*' }
@@ -122,22 +126,22 @@ export const TextFieldSchema = z.object({
     adornmentPosition: z.enum(["start", "end"]).optional().describe("장식(adornment)의 위치"),
     readOnly: z.boolean().optional().describe("읽기 전용 상태 여부 - 생성 코드에서 inputProps={{ readOnly: true }}로 변환되어 출력됨 (톱레벨 readOnly prop은 lib에 없음). inputProps를 직접 지정하는 경우 이 파라미터 대신 inputProps에 readOnly를 포함할 것"),
     adornmentLabelColor: z.string().optional().describe("장식(adornment) 라벨 텍스트의 색상 (CSS 색상 문자열, 예: '#666666', 'red')"),
-    adornmentUnit: z.boolean().optional().describe("장식(adornment) 라벨을 단위(unit) 스타일로 표시할지 여부 (boolean, 기본값: false)"),
+    adornmentUnit: z.boolean().optional().describe("장식(adornment) 라벨을 단위(unit) 스타일로 표시할지 여부 (boolean, 기본값: true — 단위 스타일을 끄려면 false)"),
     adornmentIconColor: z.string().optional().describe("장식(adornment) 아이콘의 색상 (CSS 색상 문자열, 예: '#1976d2')"),
     withBtnVoice: z.boolean().optional().describe("입력 필드 우측에 음성 입력(마이크) 버튼 표시 여부 (boolean, 기본값: false)"),
     voiceOn: z.boolean().optional().describe("음성 입력 활성(녹음 중) 상태 여부 (boolean). withBtnVoice와 함께 사용하며 보통 상태 변수로 제어"),
     disabledVoice: z.boolean().optional().describe("음성 입력 버튼 비활성화 여부 (boolean, 기본값: false)"),
     voiceSupported: z.boolean().optional().describe("브라우저의 음성 인식 지원 여부 (boolean). false면 음성 버튼이 미지원 상태로 표시됨"),
     onVoice: z.string().optional().describe("음성 입력 버튼 클릭 시 호출될 함수명 (예: 'handleVoice'). () => void 형태"),
-    withBtnIconName: z.enum(Object.keys(IconNamesMap)).optional().describe("입력 필드 우측 확인(withBtn) 버튼에 표시할 아이콘 이름"),
-    withBtnDisabled: z.boolean().optional().describe("우측 확인(withBtn) 버튼 비활성화 여부 (boolean, 기본값: false)"),
-    onConfirm: z.string().optional().describe("우측 확인(withBtn) 버튼 클릭 시 호출될 함수명 (예: 'handleConfirm'). () => void 형태"),
+    withBtnIconName: z.string().optional().describe("우측 확인 버튼의 Material 아이콘 이름 (기본값: 'send') — OpsNow IconName이 아님. withBtnVoice=true일 때만 표시"),
+    withBtnDisabled: z.boolean().optional().describe("우측 확인(withBtn) 버튼 비활성화 여부 (boolean, 기본값: false). withBtnVoice=true일 때만 동작"),
+    onConfirm: z.string().optional().describe("우측 확인(withBtn) 버튼 클릭 시 호출될 함수명 (예: 'handleConfirm'). () => void 형태. 확인 버튼은 withBtnVoice=true일 때만 나타남"),
 });
 // Avatar 컴포넌트 관련 스키마 정의
 export const AvatarSchema = z.object({
     src: z.string().optional().describe('이미지 URL'),
     alt: z.string().optional().describe('이미지 대체 텍스트'),
-    size: z.enum(['xsmall', 'small', 'medium', 'large']).optional().describe('아바타 크기'),
+    size: z.union([z.enum(['xsmall', 'small', 'medium', 'large']), z.number()]).optional().describe('아바타 크기 — 프리셋 또는 px 숫자 (기본값: medium). 뱃지 기본값 badgeVariant=\'dot\', badgeOverlap=\'circular\''),
     variant: z.enum(['circular', 'rounded', 'square']).optional().describe('아바타 형태'),
     showBadge: z.boolean().optional().describe('뱃지 표시 여부'),
     sx: z.string().optional().describe('MUI sx 스타일 객체(JSX/문자열)'),
@@ -160,17 +164,18 @@ export const CheckboxSchema = z.object({
 });
 // RadioGroup 컴포넌트 관련 스키마 정의
 export const RadioGroupSchema = z.object({
-    options: z.string().describe("라디오 옵션 배열 변수명 (예: options)"),
+    options: z.string().describe("라디오 옵션 배열 변수명 (예: options) — [{ label, value, disabled? }]. 개별 비활성화는 options[].disabled (RadioGroup 전체 disabled prop은 없음)"),
     color: z.enum(["primary", "secondary", "error", "success", "warning", "info", "default"]).optional().describe("라디오 색상"),
-    name: z.string().describe("라디오 그룹 이름"),
+    name: z.string().optional().describe("라디오 그룹 이름"),
     defaultValue: z.string().optional().describe("기본 선택값"),
     row: z.boolean().optional().describe("가로 배치 여부"),
     size: z.enum(["small", "medium", "large"]).optional().describe("라디오 크기"),
+    value: z.string().optional().describe("선택된 값 (제어형) — 상태 변수명. onChange와 함께 사용"),
+    onChange: z.string().optional().describe("선택 변경 핸들러 함수명 ((e, value) => void)"),
 });
 // Collapse 컴포넌트 관련 스키마 정의
 export const CollapseSchema = z.object({
     label: z.string().describe("토글 라벨 텍스트"),
-    defaultExpanded: z.boolean().optional().describe("기본 확장 여부"),
     children: z.string().describe("Collapse 내부에 들어갈 JSX/텍스트"),
     btnClass: z.string().optional().describe("토글 버튼에 적용할 커스텀 CSS 클래스명"),
     btnToggleClass: z.string().optional().describe("확장(펼침) 상태일 때 토글 버튼에 적용할 커스텀 CSS 클래스명"),
@@ -179,7 +184,7 @@ export const CollapseSchema = z.object({
 // Slider 컴포넌트 관련 스키마 정의
 export const SliderSchema = z.object({
     defaultValue: z.string().optional().describe("기본 값 (string, 단일 값: '30', 범위: '[10, 50]')"),
-    color: z.enum(["primary", "secondary"]).optional().describe("슬라이더 색상"),
+    color: z.enum(["primary", "secondary", "error", "warning", "info", "success"]).optional().describe("슬라이더 색상"),
     size: z.enum(["small", "medium"]).optional().describe("슬라이더 크기"),
     step: z.number().optional().describe("슬라이더 step 값"),
     marks: z.string().optional().describe(`마크 표시 여부/마크 배열(string, 예: 'true', 'false', 또는 아래와 같은 배열 문자열)
@@ -198,31 +203,31 @@ export const SliderSchema = z.object({
     getAriaValueText: z.string().optional().describe("aria value 텍스트 함수 변수명"),
     ariaLabel: z.string().optional().describe("aria-label 속성"),
     sx: z.string().optional().describe("MUI sx 스타일 객체(JSX/문자열)"),
+    value: z.union([z.number(), z.array(z.number())]).optional().describe("현재 값 (제어형) — 상태 변수명. onChange와 함께 사용"),
 });
 // Link 컴포넌트 관련 스키마 정의
 export const LinkSchema = z.object({
     href: z.string().describe("링크 주소(href)"),
-    color: z.enum(["primary", "inherit"]).optional().describe("링크 색상"),
+    color: z.enum(["primary", "inherit"]).default("primary").describe("링크 색상 (실제 컴포넌트에선 필수)"),
     underline: z.enum(["always", "hover", "none"]).optional().describe("밑줄 표시 방식"),
     onClick: z.string().optional().describe("클릭 이벤트 핸들러"),
     children: z.string().describe("링크 내부 텍스트/JSX"),
 });
 // ToggleButtonGroup 컴포넌트 관련 스키마 정의
 export const ToggleButtonSchema = z.object({
-    value: z.string().describe('선택된 값'),
+    value: z.string().describe('선택된 값 상태 변수명 — string | string[] | null (exclusive가 아니면 배열)'),
     onChange: z.string().describe('값 변경 핸들러 함수명'),
     size: z.enum(['large', 'medium', 'small']).optional().describe('토글 버튼 크기'),
     exclusive: z.boolean().optional().describe('단일 선택 여부'),
     disabled: z.boolean().optional().describe('비활성화 여부'),
-    theme: z.enum(['new']).optional().describe('테마'),
+    theme: z.enum(['us', 'new']).optional().describe("테마 (기본값: 'us')"),
     buttons: z.array(z.object({
         value: z.string().describe('버튼 값'),
         label: z.string().optional().describe('버튼 라벨'),
         iconName: z.enum(Object.keys(IconNamesMap)).optional().describe(generateIconDescription({ format: 'nested' })),
-        iconOnly: z.boolean().optional().describe('아이콘만 표시'),
-        iconPosition: z.enum(['left', 'right']).optional().describe('아이콘 위치'),
         disabled: z.boolean().optional().describe('비활성화 여부'),
     })).describe('토글 버튼 목록'),
+    copilotId: z.string().optional().describe("Copilot 연동 ID — Copilot 매니페스트의 bind.copilotId와 매칭되어 AI가 이 컨트롤을 조작할 수 있게 함. useCommonComponents()로 받은 컴포넌트에서만 동작(로더 HOC가 소비 후 제거)"),
 });
 // TreeView 컴포넌트 관련 스키마 정의
 export const TreeViewSchema = z.object({
@@ -232,6 +237,7 @@ export const TreeViewSchema = z.object({
 - id: 노드 고유 ID
 - label: 노드 라벨 텍스트
 - muiIconName: Material-UI 아이콘 이름 (예: 'settings', 'person', 'lock' 등)
+- iconName: OpsNow 아이콘 이름 (IconName) — muiIconName이 있으면 muiIconName이 우선
 - children: 자식 노드 배열 (선택사항)
 - data: 노드에 추가 데이터 (선택사항, 예: { memberCount: 5 })
 
@@ -315,6 +321,23 @@ export const CurrencySwitcherSchema = z.object({
     showDetail: z.boolean().optional().describe("환율 설정(직접 입력 시뮬레이션) 섹션 노출 여부 (기본값: false). 실제 노출은 showDetail && simulationAnchorCurrency 지정 && simulationAnchorCurrency !== 선택 통화 3조건으로 판정 — 선택 통화가 기준 통화(USD)여도 앵커와 다르면 노출됨"),
 });
 // Forms 컴포넌트 함수 - 배열 반환
+export const InputSchema = z.object({
+    value: z.string().optional().describe("입력값 상태 변수명 (예: 'keyword')"),
+    onChange: z.string().optional().describe("변경 핸들러 함수명 ((e) => void)"),
+    placeholder: z.string().optional().describe("플레이스홀더 텍스트"),
+    variant: z.enum(["standard", "outlined", "filled", "noLine", "emUnderline"]).optional().describe("입력 스타일 (기본값: standard)"),
+    helperText: z.string().optional().describe("입력 아래 도움말 텍스트"),
+    adornmentPosition: z.enum(["start", "end"]).optional().describe("장식(adornment) 위치 (기본값: start)"),
+    adornmentLabel: z.string().optional().describe("장식 라벨 텍스트 (예: '$', 'GB')"),
+    adornmentLabelColor: z.string().optional().describe("장식 라벨 색상 (CSS 색상)"),
+    adornmentUnit: z.boolean().optional().describe("장식 라벨을 단위(unit) 스타일로 표시 (기본값: true — 끄려면 false)"),
+    adornmentIconName: z.enum(Object.keys(IconNamesMap)).optional().describe("장식 아이콘 이름 (IconName)"),
+    adornmentIconColor: z.string().optional().describe("장식 아이콘 색상 (CSS 색상)"),
+    type: z.string().optional().describe("input type (예: 'text', 'number', 'password')"),
+    disabled: z.boolean().optional().describe("비활성화 여부"),
+    error: z.boolean().optional().describe("에러 상태"),
+    fullWidth: z.boolean().optional().describe("부모 너비 채움"),
+});
 export function createFormsComponent() {
     return [
         {
@@ -538,14 +561,14 @@ export function createFormsComponent() {
             handler: async (args) => {
                 const props = [];
                 let inputPropsBlock = '';
-                let InputPropsBlock = '';
                 if (args.placeholder)
                     props.push(`placeholder=\"${args.placeholder}\"`);
                 if (args.value)
                     props.push(`value={${args.value}}`);
                 if (args.onChange)
                     props.push(`onChange={${args.onChange}}`);
-                if (args.variant && args.variant !== "standard")
+                // variant 미지정 시 MUI 기본 outlined로 렌더됨
+                if (args.variant)
                     props.push(`variant=\"${args.variant}\"`);
                 if (args.type)
                     props.push(`type=\"${args.type}\"`);
@@ -568,8 +591,9 @@ export function createFormsComponent() {
                     props.push(`inputProps={{ readOnly: true }}`);
                 if (args.adornmentLabelColor)
                     props.push(`adornmentLabelColor=\"${args.adornmentLabelColor}\"`);
-                if (args.adornmentUnit)
-                    props.push(`adornmentUnit`);
+                // adornmentUnit은 런타임 기본값이 true → false일 때만 명시
+                if (args.adornmentUnit === false)
+                    props.push(`adornmentUnit={false}`);
                 if (args.adornmentIconColor)
                     props.push(`adornmentIconColor=\"${args.adornmentIconColor}\"`);
                 if (args.withBtnVoice)
@@ -588,6 +612,10 @@ export function createFormsComponent() {
                     props.push(`withBtnDisabled`);
                 if (args.onConfirm)
                     props.push(`onConfirm={${args.onConfirm}}`);
+                if (args.InputProps)
+                    props.push(`InputProps={${args.InputProps}}`);
+                if (args.InputLabelProps)
+                    props.push(`InputLabelProps={${args.InputLabelProps}}`);
                 // inputProps, InputProps 멀티라인/JSX 대응
                 if (args.inputProps) {
                     if (args.inputProps.trim().startsWith('{') && args.inputProps.includes('\n')) {
@@ -599,8 +627,8 @@ export function createFormsComponent() {
                 }
                 // 멀티라인 여부에 따라 코드 조립
                 let code = '';
-                if (inputPropsBlock || InputPropsBlock) {
-                    code = `<OpsnowCommonTextField\n  ${props.join('\n  ')}\n  ${inputPropsBlock ? inputPropsBlock + '\n  ' : ''}${InputPropsBlock ? InputPropsBlock + '\n' : ''}/>`;
+                if (inputPropsBlock) {
+                    code = `<OpsnowCommonTextField\n  ${props.join('\n  ')}\n  ${inputPropsBlock}\n/>`;
                 }
                 else {
                     code = `<OpsnowCommonTextField ${props.join(' ')} />`;
@@ -727,6 +755,10 @@ export function createFormsComponent() {
                     props.push(`defaultValue=\"${args.defaultValue}\"`);
                 if (args.row)
                     props.push(`row`);
+                if (args.value)
+                    props.push(`value={${args.value}}`);
+                if (args.onChange)
+                    props.push(`onChange={${args.onChange}}`);
                 if (args.size)
                     props.push(`size=\"${args.size}\"`);
                 const code = `<OpsnowCommonRadioGroup ${props.join(' ')} />`;
@@ -754,8 +786,6 @@ export function createFormsComponent() {
                 const props = [];
                 if (args.label)
                     props.push(`label=\"${args.label}\"`);
-                if (args.defaultExpanded)
-                    props.push(`defaultExpanded`);
                 if (args.btnClass)
                     props.push(`btnClass=\"${args.btnClass}\"`);
                 if (args.btnToggleClass)
@@ -931,14 +961,7 @@ export function createFormsComponent() {
                 const buttonCodes = args.buttons.map(btn => {
                     const btnProps = [];
                     btnProps.push(`value=\"${btn.value}\"`);
-                    if (btn.label)
-                        btnProps.push(btn.iconName ? '' : btn.label); // label은 children으로 처리
-                    if (btn.iconName)
-                        btnProps.push(`<OpsnowCommonIcon iconName=\"${btn.iconName}\" />`);
-                    if (btn.iconOnly)
-                        btnProps.push(`iconOnly`);
-                    if (btn.iconPosition)
-                        btnProps.push(`iconPosition=\"${btn.iconPosition}\"`);
+                    // label/icon은 children으로 처리
                     if (btn.disabled)
                         btnProps.push(`disabled`);
                     // children 조립
@@ -946,7 +969,7 @@ export function createFormsComponent() {
                     if (btn.iconName) {
                         children = `<OpsnowCommonIcon iconName=\"${btn.iconName}\" />${btn.label ? ' ' + btn.label : ''}`;
                     }
-                    return `  <OpsnowCommonToggleButton ${btnProps.filter(p => !p.startsWith('<')).join(' ')}>${children}</OpsnowCommonToggleButton>`;
+                    return `  <OpsnowCommonToggleButton ${btnProps.join(' ')}>${children}</OpsnowCommonToggleButton>`;
                 }).join('\n');
                 const code = `<OpsnowCommonToggleButtonGroup\n  ${props.join('\n  ')}\n>\n${buttonCodes}\n</OpsnowCommonToggleButtonGroup>`;
                 return {
@@ -1241,6 +1264,20 @@ export function createFormsComponent() {
                     ]
                 };
             }
-        }
+        },
+        {
+            name: "createInput",
+            description: `Input 컴포넌트 - 라벨 없이 쓰는 단일 입력 필드 (adornment 라벨/아이콘/단위 지원)
+      라벨·helperText를 갖춘 폼 필드는 TextField, 검색창·인라인 입력처럼 가벼운 입력은 Input을 씁니다.
+      MUI Input props(type, disabled, error, fullWidth, inputProps 등)를 그대로 받습니다.
+
+      **import:**
+      \`\`\`javascript
+      import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
+      const { OpsnowCommonInput } = useCommonComponents();
+      \`\`\``,
+            parameters: InputSchema,
+            handler: async (args) => jsxResult(jsxTag("OpsnowCommonInput", jsxAttrs(args, { exprKeys: ["value", "onChange"] }))),
+        },
     ];
 }