@opsnow-mcp/opsnow-mcp-common-ui-server 1.0.40 → 1.0.42
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.
- package/build/components/all-component-tools.js +2 -0
- package/build/components/data/icon-names.generated.js +341 -0
- package/build/components/data/icon-names.js +32 -16
- package/build/components/examples/opsnow-common-chart-examples-data.js +73 -471
- package/build/components/examples/opsnow-common-forms-examples-data.js +1 -11
- package/build/components/examples/opsnow-common-grid-examples-data.js +93 -129
- package/build/components/examples/opsnow-common-layout-examples-data.js +12 -13
- package/build/components/examples/opsnow-common-popup-examples-data.js +14 -28
- package/build/components/examples/opsnow-common-progress-examples-data.js +0 -5
- package/build/components/examples/opsnow-common-select-examples-data.js +16 -0
- package/build/components/examples/opsnow-common-stepper-examples-data.js +2 -3
- package/build/components/examples/opsnow-common-storage-examples-data.js +23 -4
- package/build/components/examples/opsnow-common-tab-examples-data.js +37 -0
- package/build/components/examples/opsnow-common-tooltip-examples-data.js +1 -21
- package/build/components/opsnow-common-calendar.js +36 -15
- package/build/components/opsnow-common-chart.js +245 -156
- package/build/components/opsnow-common-coach-mark.js +3 -2
- package/build/components/opsnow-common-data-status.js +17 -11
- package/build/components/opsnow-common-dropdown.js +80 -0
- package/build/components/opsnow-common-examples.js +4 -2
- package/build/components/opsnow-common-file-upload.js +4 -1
- package/build/components/opsnow-common-forms.js +73 -36
- package/build/components/opsnow-common-grid.js +110 -79
- package/build/components/opsnow-common-icons.js +23 -39
- package/build/components/opsnow-common-jsx-helper.js +36 -0
- package/build/components/opsnow-common-layout.js +66 -25
- package/build/components/opsnow-common-notification.js +3 -2
- package/build/components/opsnow-common-pagination.js +4 -4
- package/build/components/opsnow-common-popup.js +12 -11
- package/build/components/opsnow-common-progress.js +10 -16
- package/build/components/opsnow-common-select.js +30 -15
- package/build/components/opsnow-common-stepper.js +30 -7
- package/build/components/opsnow-common-tab.js +26 -3
- package/build/components/opsnow-common-toast-popup.js +1 -0
- package/build/components/opsnow-common-tooltip.js +44 -46
- package/build/components/opsnow-common-typography.js +11 -5
- package/build/components/opsnow-common-validate-props.js +0 -0
- package/build/index.js +43 -0
- package/package.json +2 -1
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
|
|
2
3
|
const gridOptionsSchema = z.object({
|
|
3
4
|
animateRows: z.boolean().optional().describe('행 애니메이션 사용 여부'),
|
|
4
5
|
rowSelection: z.object({
|
|
@@ -8,8 +9,9 @@ const gridOptionsSchema = z.object({
|
|
|
8
9
|
headerCheckbox: z.boolean().optional().describe('헤더 체크박스 사용 여부'),
|
|
9
10
|
enableSelectionWithoutKeys: z.boolean().optional().describe('키 없이 선택 허용'),
|
|
10
11
|
}).optional().describe('행 선택 옵션'),
|
|
11
|
-
tooltipShowDelay: z.number().optional().describe('툴팁 표시 지연 시간'),
|
|
12
|
-
|
|
12
|
+
tooltipShowDelay: z.number().optional().describe('툴팁 표시 지연 시간 (ms, 기본 300)'),
|
|
13
|
+
tooltipShowMode: z.enum(['standard', 'whenTruncated']).optional().describe("툴팁 표시 방식. 지정하지 않으면 그리드가 'whenTruncated'(잘린 셀만 툴팁)를 자동 적용 — 직접 지정하면 자동 말줄임 툴팁·헤더 툴팁이 꺼지므로 보통 지정하지 말 것"),
|
|
14
|
+
domLayout: z.enum(['autoHeight', 'print']).optional().describe("그리드 레이아웃 방식 — 'autoHeight' 권장(최대 maxGridHeight까지 콘텐츠 맞춤). 고정 높이는 이 키를 빼고 gridHeight. ⚠️ 'normal'은 쓰지 말 것: 컨테이너 높이가 비워져 그리드가 0px로 사라짐(부모 높이와 무관, grid 2.0.7 브라우저 실측)"),
|
|
13
15
|
suppressCellFocus: z.boolean().optional().describe('셀 포커스 비활성화 (셀 클릭 이벤트 사용 시 필수: true)'),
|
|
14
16
|
suppressPaginationPanel: z.boolean().optional().describe('페이지네이션 패널 숨김'),
|
|
15
17
|
masterDetail: z.boolean().optional().describe('마스터/디테일 모드 사용'),
|
|
@@ -38,19 +40,25 @@ const columnDefsSchema = z.lazy(() => z.object({
|
|
|
38
40
|
colId: z.string().optional().describe('컬럼 고유 ID'),
|
|
39
41
|
groupId: z.string().optional().describe('컬럼 그룹 고유 ID'),
|
|
40
42
|
width: z.number().optional().describe('컬럼 너비'),
|
|
41
|
-
minWidth: z.number().describe('컬럼 최소 너비'),
|
|
43
|
+
minWidth: z.number().optional().describe('컬럼 최소 너비'),
|
|
42
44
|
maxWidth: z.number().optional().describe('컬럼 최대 너비'),
|
|
43
45
|
pinned: z.enum(['left', 'right']).optional().describe('컬럼 고정 위치'),
|
|
44
46
|
type: z.array(z.enum([
|
|
47
|
+
'default',
|
|
45
48
|
'number',
|
|
49
|
+
'integer',
|
|
46
50
|
'cost',
|
|
47
51
|
'ratio',
|
|
48
|
-
'mixFormat',
|
|
49
52
|
'numberTooltip',
|
|
53
|
+
'mixFormat',
|
|
50
54
|
'ratioBar',
|
|
51
55
|
'dataBar',
|
|
52
|
-
'
|
|
53
|
-
])).optional().describe(`컬럼 타입.
|
|
56
|
+
'date'
|
|
57
|
+
])).optional().describe(`컬럼 타입. 숫자·날짜 표기 표준은 type이 처리하므로 valueFormatter/cellStyle로 직접 만들지 말 것.
|
|
58
|
+
- cost·ratio·integer·number·mixFormat: 헤더·셀 오른쪽 정렬 자동
|
|
59
|
+
- ratio(mixFormat 퍼센트 포함): 소수 1자리 (85.3%, 0.0%)
|
|
60
|
+
- cost: 0.01 미만은 <$0.01, 실제 0은 $0.00. 증감 부호는 typeParams.showSign
|
|
61
|
+
- date: 셀 YYYY-MM-DD HH:mm(24시간제, 입력값을 UTC로 보고 브라우저 시간대로 표시), 헤더에 시간대 자동 표기(예: (UTC+9)) — headerName에 '(UTC'가 있으면 생략
|
|
54
62
|
- ratioBar: 여러 색상/세그먼트로 구성 비율을 보여주는 스택 차트 스타일 바. 여러 필드의 비율을 시각화할 때 사용 (예: Cost Composition by Type). 'Ratio Bar' 예제 참고.
|
|
55
63
|
- dataBar: 단일 색상으로 셀 배경을 값에 비례하여 채우는 Excel 스타일 바. 단일 값의 크기를 시각화할 때 사용 (예: 월별 비용 트렌드). 'Data Bar' 예제 참고.`),
|
|
56
64
|
cellRenderer: z.any().optional().describe('셀 렌더러'),
|
|
@@ -60,6 +68,9 @@ const columnDefsSchema = z.lazy(() => z.object({
|
|
|
60
68
|
digits: z.number().optional().describe('소수점 자리수'),
|
|
61
69
|
iconRight: z.boolean().optional().describe('오른쪽 아이콘 표시'),
|
|
62
70
|
isPercent: z.boolean().optional().describe('퍼센트 표시 여부'),
|
|
71
|
+
vendor: z.string().optional().describe('cost 타입: 벤더별 통화·포맷 (예: \'aws\')'),
|
|
72
|
+
isNegative: z.boolean().optional().describe('cost 타입: 음수 표시 처리'),
|
|
73
|
+
showSign: z.boolean().optional().describe('증감 부호 항상 표기 (+12.5%, -3.2%, 0은 부호 없음). ratio·cost·mixFormat 타입. 전월 대비 같은 증감 컬럼에 사용'),
|
|
63
74
|
fields: z.array(z.string()).optional().describe('비율바 등에서 여러 필드'),
|
|
64
75
|
label: z.object({
|
|
65
76
|
postfix: z.string().optional().describe('라벨 접미사'),
|
|
@@ -87,8 +98,10 @@ const columnDefsSchema = z.lazy(() => z.object({
|
|
|
87
98
|
}).catchall(z.any()).optional().describe('헤더 컴포넌트 파라미터'),
|
|
88
99
|
sortable: z.boolean().optional().describe('정렬 가능 여부'),
|
|
89
100
|
resizable: z.boolean().optional().describe('크기 조절 가능 여부'),
|
|
90
|
-
wrapText: z.boolean().optional().describe('텍스트 줄바꿈'),
|
|
91
|
-
autoHeight: z.boolean().optional().describe('자동 높이'),
|
|
101
|
+
wrapText: z.boolean().optional().describe('텍스트 줄바꿈 (기본 false = 한 줄 + 말줄임 + 잘리면 툴팁). 줄바꿈이 꼭 필요한 컬럼에만 true'),
|
|
102
|
+
autoHeight: z.boolean().optional().describe('자동 높이 (그리드 기본값 true — 지정 불필요)'),
|
|
103
|
+
tooltipField: z.string().optional().describe('툴팁에 표시할 필드명. ⚠️ 하나라도 지정하면 그리드 전체의 자동 말줄임 툴팁이 꺼짐 — 보통 지정하지 말 것'),
|
|
104
|
+
headerTooltip: z.string().optional().describe('헤더 툴팁 문구. ⚠️ 지정하면 자동 말줄임 툴팁이 꺼짐 — 긴 헤더는 기본으로 2줄 + 말줄임 + 전체 명칭 툴팁이 나오므로 보통 불필요'),
|
|
92
105
|
suppressMenu: z.boolean().optional().describe('메뉴 숨김'),
|
|
93
106
|
unSortIcon: z.boolean().optional().describe('정렬 해제 아이콘 표시'),
|
|
94
107
|
rowDrag: z.boolean().optional().describe('행 드래그 사용'),
|
|
@@ -109,8 +122,8 @@ const columnDefsSchema = z.lazy(() => z.object({
|
|
|
109
122
|
children: z.array(z.lazy(() => columnDefsSchema)).optional().describe('하위 컬럼 정의 배열 (컬럼 그룹화)'),
|
|
110
123
|
}));
|
|
111
124
|
const defaultColDefSchema = z.object({
|
|
112
|
-
wrapText: z.boolean().optional().describe('
|
|
113
|
-
autoHeight: z.boolean().optional().describe('자동 높이'),
|
|
125
|
+
wrapText: z.boolean().optional().describe('⚠️ defaultColDef에는 넣지 말 것 — 모든 컬럼이 줄바꿈되어 표기 표준(한 줄 + 말줄임) 위반. 필요한 컬럼의 colDef에만 지정'),
|
|
126
|
+
autoHeight: z.boolean().optional().describe('자동 높이 (그리드 기본값 true — 지정 불필요)'),
|
|
114
127
|
suppressMenu: z.boolean().optional().describe('메뉴 숨김'),
|
|
115
128
|
unSortIcon: z.boolean().optional().describe('정렬 해제 아이콘 표시'),
|
|
116
129
|
sortable: z.boolean().optional().describe('정렬 가능 여부'),
|
|
@@ -123,9 +136,6 @@ const defaultColDefSchema = z.object({
|
|
|
123
136
|
});
|
|
124
137
|
// ag-grid 기반 OpsnowCommonDataGrid 스키마 정의
|
|
125
138
|
export const DataGridSchema = z.object({
|
|
126
|
-
totalPage: z.number().optional().describe('전체 페이지 수'),
|
|
127
|
-
initPageNum: z.number().optional().describe('초기 페이지 번호'),
|
|
128
|
-
dropdownSearchDefaultValue: z.string().optional().describe('드롭다운 검색 기본값'),
|
|
129
139
|
gridOptions: gridOptionsSchema.optional().describe('ag-grid 옵션'),
|
|
130
140
|
columnDefs: z.array(columnDefsSchema).describe("ag-grid 컬럼 정의").min(1),
|
|
131
141
|
defaultColDef: defaultColDefSchema.optional().describe('ag-grid 기본 컬럼 옵션'),
|
|
@@ -153,38 +163,39 @@ export const DataGridSchema = z.object({
|
|
|
153
163
|
setStatus(CommonConst.GRID_STATUS.ERROR)
|
|
154
164
|
})
|
|
155
165
|
}, [])`),
|
|
156
|
-
gridHeight: z.number().optional().describe(
|
|
166
|
+
gridHeight: z.number().optional().describe("고정 높이(px, 기본 483). gridOptions.domLayout을 지정하지 않았을 때만 적용 — domLayout에 값이 있으면 무시됨 ('normal'이면 그리드가 0px로 사라짐)"),
|
|
167
|
+
maxGridHeight: z.number().optional().describe("domLayout:'autoHeight'일 때 최대 높이(px, 헤더 42px 포함, 기본 600). 넘치면 본문 세로 스크롤. grid ≥2.0.6"),
|
|
168
|
+
unlimitedHeight: z.boolean().optional().describe("true면 autoHeight 높이 제한 해제(모든 행 펼침). 기본 false. 짧은 고정 목록에만 사용"),
|
|
157
169
|
setClass: z.string().optional().describe('그리드 클래스명'),
|
|
158
|
-
localRowClass: z.string().optional().describe('로컬 행 클래스명'),
|
|
159
170
|
pagination: z.boolean().optional().describe('페이지네이션 사용 여부 (true로 설정 시 내부적으로 opsnow-common-pagination 컴포넌트 사용)'),
|
|
160
|
-
paginationPageSize: z.number().optional().describe('페이지당 행 수'),
|
|
161
|
-
textNoData: z.string().optional().describe('데이터 없음
|
|
171
|
+
paginationPageSize: z.number().optional().describe('페이지당 행 수 (기본값: 10)'),
|
|
172
|
+
textNoData: z.string().optional().describe('데이터 없음 문구 — 생략 시 langCd 표준 문구(ko: 표시할 데이터가 없습니다.). 화면 고유 문구가 필요할 때만'),
|
|
162
173
|
noDataDescription: z.string().optional().describe('데이터 없음 설명'),
|
|
163
|
-
textLoading: z.string().optional().describe('로딩
|
|
164
|
-
textErrorTitle: z.string().optional().describe('
|
|
165
|
-
textErrorDescription: z.string().optional().describe('
|
|
174
|
+
textLoading: z.string().optional().describe('로딩 문구 — 생략 시 표준 문구(ko: 데이터를 불러오는 중입니다.)'),
|
|
175
|
+
textErrorTitle: z.string().optional().describe('오류 타이틀 — 생략 시 표준 문구(ko: 오류). 보통 생략'),
|
|
176
|
+
textErrorDescription: z.string().optional().describe('오류 설명 — 생략 시 표준 문구(ko: 데이터를 불러오지 못했습니다. 잠시 후 다시 시도해 주세요.). 보통 생략'),
|
|
177
|
+
onRetry: z.string().optional().describe('오류 상태의 [다시 시도] 버튼 클릭 핸들러(stringified). 넘기면 버튼이 표시됨 — 보통 조회 함수를 그대로 전달: onRetry={fetchData}'),
|
|
166
178
|
filterSearchText: z.string().optional().describe('필터 검색 텍스트'),
|
|
167
|
-
searchTextNoData: z.string().optional().describe('검색 결과 없음
|
|
179
|
+
searchTextNoData: z.string().optional().describe('검색 결과 없음 문구 — 생략 시 표준 문구'),
|
|
168
180
|
searchTextNoDataDescription: z.string().optional().describe('검색 결과 없음 설명'),
|
|
169
|
-
pagingFromServer: z.boolean().optional().describe('서버 페이징 사용 여부'),
|
|
170
181
|
pageSizeList: z.array(z.object({
|
|
171
182
|
label: z.string().describe('페이지 사이즈 라벨'),
|
|
172
183
|
value: z.number().describe('페이지 사이즈 값')
|
|
173
|
-
})).optional().describe('페이지 사이즈 리스트 (예: [{ label: "5", value: 5 }, { label: "10", value: 10 }])'),
|
|
184
|
+
})).optional().describe('페이지 사이즈 리스트 (기본값: 10/20/50, 예: [{ label: "5", value: 5 }, { label: "10", value: 10 }])'),
|
|
174
185
|
placeholderText: z.string().optional().describe('플레이스홀더 텍스트'),
|
|
175
|
-
usedRowClass: z.boolean().optional().describe('행
|
|
186
|
+
usedRowClass: z.boolean().optional().describe('클릭 가능한 행 스타일(hover·커서) 적용 여부 — onCellClick이 있으면 자동 적용되므로 보통 지정 불필요'),
|
|
176
187
|
usedSearch: z.boolean().optional().describe('검색창 사용 여부'),
|
|
177
188
|
usedSearchAndDropdown: z.boolean().optional().describe('검색+드롭다운 동시 사용'),
|
|
178
189
|
useOpsnowUs: z.boolean().optional().describe('Opsnow US 스타일 사용'),
|
|
179
190
|
inTile: z.boolean().optional().describe('타일 내 그리드 여부'),
|
|
180
191
|
noDataCustomComponent: z.any().optional().describe('커스텀 No Data 컴포넌트'),
|
|
181
|
-
rowModelType: z.
|
|
192
|
+
rowModelType: z.enum(['clientSide', 'serverSide']).optional().describe("행 모델 타입 (기본값: 'clientSide')"),
|
|
182
193
|
serverSideDatasource: z.record(z.any()).optional().describe('서버사이드 데이터소스'),
|
|
183
194
|
cacheBlockSize: z.number().optional().describe('서버사이드 캐시 블록 크기'),
|
|
184
195
|
usedMenuItem: z.boolean().optional().describe('메뉴 아이템 사용 여부'),
|
|
185
196
|
showSelectedRowCount: z.boolean().optional().describe('선택 행 개수 표시'),
|
|
186
|
-
isAutoSizeAllColumns: z.boolean().optional().describe('모든 컬럼 자동 크기
|
|
187
|
-
langCd: z.string().optional().describe(
|
|
197
|
+
isAutoSizeAllColumns: z.boolean().optional().describe('모든 컬럼 자동 크기 조정. 모바일(≤767.95px)에서는 자동으로 true — 컬럼이 내용 폭에 맞춰지고, 컨테이너보다 넓으면 가로 스크롤이 생김 (flex/sizeColumnsToFit 전제 레이아웃은 모바일에서 달라질 수 있음)'),
|
|
198
|
+
langCd: z.string().optional().describe("언어 코드 (기본값: 'ko') — 보통 i18n.getLocale()"),
|
|
188
199
|
useTreeDataDragDrop: z.boolean().optional().describe('트리 데이터 드래그 사용'),
|
|
189
200
|
getDropTargetNode: z.string().optional().describe('드롭 타겟 노드 반환 함수(stringified)'),
|
|
190
201
|
emitQuickFilterChange: z.boolean().optional().describe('빠른 필터 변경 이벤트 발생'),
|
|
@@ -201,6 +212,12 @@ export const DataGridSchema = z.object({
|
|
|
201
212
|
onSetPage: z.string().optional().describe('페이지 변경 이벤트 핸들러(stringified)'),
|
|
202
213
|
serverSideTotalPageSize: z.number().optional().describe('서버사이드 전체 페이지 수')
|
|
203
214
|
});
|
|
215
|
+
export const HeaderFilterSchema = z.object({
|
|
216
|
+
gridData: z.string().describe("AG Grid가 headerComponent에 넘기는 header params 변수명 (column, displayName, enableSorting, setSort, context) (필수)"),
|
|
217
|
+
textRight: z.boolean().optional().describe("헤더 텍스트 우측 정렬 (숫자 컬럼)"),
|
|
218
|
+
isUsedMenuFilter: z.boolean().optional().describe("헤더 필터 메뉴 사용 여부"),
|
|
219
|
+
children: z.string().optional().describe("헤더 텍스트 옆에 넣을 JSX (예: 툴팁 아이콘)"),
|
|
220
|
+
});
|
|
204
221
|
// DataGrid 컴포넌트 함수 - 배열 반환
|
|
205
222
|
export function createDataGridComponent() {
|
|
206
223
|
return [
|
|
@@ -211,49 +228,44 @@ export function createDataGridComponent() {
|
|
|
211
228
|
**이 데이터 그리드 컴포넌트는 ag-grid를 기반으로 구현되었습니다.**
|
|
212
229
|
**데이터 그리드 데이터, 컬럼 정의 등의 데이터가 제공되지 않을 경우 목업 데이터를 사용하세요.**
|
|
213
230
|
|
|
214
|
-
**CRITICAL:
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
autoHeight: true, // 필수 - 행 높이 자동 조절
|
|
223
|
-
};
|
|
224
|
-
|
|
225
|
-
[필수] gridOptions에 반드시 포함:
|
|
226
|
-
const gridOptions = {
|
|
227
|
-
// ... 다른 설정들
|
|
228
|
-
domLayout: 'autoHeight', // 필수
|
|
229
|
-
};
|
|
231
|
+
**CRITICAL: 셀 표기 표준 — 기본은 한 줄 + 말줄임 (wrapText 강제 금지)**
|
|
232
|
+
그리드 기본 colDef가 이미 { autoHeight: true, wrapText: false, wrapHeaderText: true, autoHeaderHeight: true }이고,
|
|
233
|
+
잘린 셀에만 툴팁을 띄우는 tooltipShowMode: 'whenTruncated'를 자동 적용합니다. 긴 텍스트(설명·메시지·ARN 등) 컬럼도 기본은 아무 설정 없이 둡니다.
|
|
234
|
+
1. ❌ defaultColDef에 wrapText: true / autoHeight: true 넣지 말 것 — 모든 컬럼이 줄바꿈되어 표기 표준 위반
|
|
235
|
+
2. ✅ 줄바꿈이 꼭 필요한 컬럼에만 colDef에 wrapText: true (행 높이는 기본 autoHeight라 자동으로 늘어남)
|
|
236
|
+
3. ⚠️ 컬럼 하나라도 tooltipField / tooltipValueGetter / tooltipComponent / headerTooltip / headerTooltipValueGetter를 지정하거나
|
|
237
|
+
defaultColDef·gridOptions(tooltipShowMode)에 툴팁 설정을 넣으면, 자동 말줄임 툴팁·헤더 툴팁이 그리드 전체에서 꺼짐 — 정말 커스텀 툴팁이 필요할 때만
|
|
238
|
+
4. 헤더: 긴 헤더명은 2줄까지 표시, 넘치면 말줄임 + 호버 시 전체 명칭 툴팁 (HeaderFilter·HeaderInfoTooltip 커스텀 헤더도 동일) — 헤더명을 줄이거나 headerTooltip을 따로 달 필요 없음
|
|
230
239
|
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
headerName: '
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
minWidth: 200,
|
|
237
|
-
wrapText: true, // 필수 - 텍스트 줄바꿈
|
|
238
|
-
autoHeight: true, // 필수 - 행 높이 자동 조절
|
|
239
|
-
suppressSizeToFit: true, // 필수
|
|
240
|
-
cellStyle: { alignItems: 'center' } // 필수 (flex-start도 가능)
|
|
241
|
-
}
|
|
240
|
+
const columnDefs = [
|
|
241
|
+
{ headerName: 'Description', field: 'description', flex: 2, minWidth: 220 }, // 한 줄 + 말줄임 + 잘리면 툴팁
|
|
242
|
+
{ headerName: 'Memo', field: 'memo', flex: 2, minWidth: 220, wrapText: true }, // 이 컬럼만 줄바꿈
|
|
243
|
+
];
|
|
244
|
+
'긴 텍스트 컬럼 (한 줄 + 말줄임 툴팁 / 줄바꿈 선택)' 예제 참고.
|
|
242
245
|
|
|
243
|
-
|
|
246
|
+
**숫자·날짜 표기 표준 — type만 지정, valueFormatter/cellStyle로 다시 만들지 말 것**
|
|
247
|
+
- cost·ratio·integer·number·mixFormat 타입: 헤더·셀 자동 오른쪽 정렬
|
|
248
|
+
- ratio (mixFormat 퍼센트 포함): 소수 1자리 (85.3%, 0.0%). digits로 변경 가능
|
|
249
|
+
- cost: 0.01 미만 금액은 <$0.01 (음수는 >-$0.01), 실제 0은 $0.00
|
|
250
|
+
- 증감 컬럼: cellRendererParams: { typeParams: { showSign: true } } → +12.5% / -3.2% (0은 부호 없음, ratio·cost·mixFormat)
|
|
251
|
+
- date: 셀 YYYY-MM-DD HH:mm (24시간제, 언어 무관). 입력값을 UTC로 보고 브라우저 시간대로 변환하므로 rowData에는 UTC 값을 그대로 넣음.
|
|
252
|
+
시간대는 헤더에 한 번 자동으로 붙음 (예: 'Updated At' → 'Updated At (UTC+9)'). headerName에 이미 '(UTC'가 있으면 다시 붙이지 않음 — 셀/헤더에 시간대를 직접 붙이지 말 것
|
|
253
|
+
그리드 밖(카드·요약 텍스트·파일명 등)의 날짜는 useGlobalContext()의 finOpsDateUtils(formatDate/formatPeriod/formatDateTime/getTimeZoneLabel/formatFileNameDate)로 — 서버 UTC 값은 formatDateTime(v, { inputUtc: true })
|
|
254
|
+
'표기 표준 (숫자·날짜·2줄 헤더)' 예제 참고.
|
|
244
255
|
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
256
|
+
**그리드 높이 정책 (grid ≥2.0.6) — 행 수로 분기하지 말 것**
|
|
257
|
+
- 기본: gridOptions.domLayout: 'autoHeight' 하나만. 행이 적으면 콘텐츠 높이에 맞추고,
|
|
258
|
+
maxGridHeight(기본 600px, 헤더 42px 포함)를 넘으면 본문에 세로 스크롤이 자동으로 생긴다.
|
|
259
|
+
- 상한 변경: maxGridHeight={800} / 상한 해제(모든 행 펼침): unlimitedHeight (짧은 고정 목록에만)
|
|
260
|
+
- 고정 높이: gridOptions에서 domLayout 키를 아예 빼고 gridHeight={N} (기본 483)
|
|
261
|
+
- ⚠️ domLayout: 'normal'을 명시하면 컨테이너 높이가 비워져 그리드가 0px로 사라진다 (gridHeight·부모 높이와 무관 — 브라우저 실측).
|
|
262
|
+
isScroll ? 'normal' : 'autoHeight' 같은 행 수 분기 패턴 금지.
|
|
263
|
+
- 상한은 헤더 1줄(42px) 기준이라 헤더가 여러 줄이면 그만큼 커지고, 페이지네이션 영역은 상한 밖이다.
|
|
264
|
+
- 모바일(≤767.95px)에서는 컬럼을 autoSizeAllColumns로 맞추므로 가로 스크롤이 생길 수 있다.
|
|
248
265
|
|
|
249
|
-
const
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
// ... 다른 설정들
|
|
253
|
-
domLayout: isScroll ? 'normal' : 'autoHeight', // 10행 이하: 콘텐츠 맞춤 / 초과: 고정+스크롤
|
|
254
|
-
};
|
|
255
|
-
// 10행 초과 시에만 고정 높이 부여 (autoHeight 셀은 가변이라 픽셀 고정값 사용)
|
|
256
|
-
<OpsnowCommonDataGrid gridOptions={gridOptions} gridHeight={isScroll ? 600 : undefined} />
|
|
266
|
+
const gridOptions = { /* ... */ domLayout: 'autoHeight' };
|
|
267
|
+
<OpsnowCommonDataGrid gridOptions={gridOptions} /> // 최대 600px, 넘치면 스크롤
|
|
268
|
+
<OpsnowCommonDataGrid gridOptions={gridOptions} maxGridHeight={800} /> // 상한 변경
|
|
257
269
|
|
|
258
270
|
**셀·행 단위 부분 로딩 (Partial Loading) — status로 하지 말 것**
|
|
259
271
|
status={GRID_STATUS.LOADING}은 그리드 전체를 가립니다. "이 셀만 재계산 중", "선택한 행만 동기화 중" 같은 부분 로딩은
|
|
@@ -264,7 +276,8 @@ export function createDataGridComponent() {
|
|
|
264
276
|
4. 인디케이터로 셀 콘텐츠를 치환하지 말고, 원래 콘텐츠를 visibility: hidden 으로 남기고 인디케이터를 position: absolute 로 겹친다 (autoHeight라 치환하면 행 높이가 바뀜)
|
|
265
277
|
5. columnDefs/셀 렌더러는 useMemo/useCallback 으로 고정 — 매 렌더마다 새로 만들면 그리드가 통째로 다시 그려진다
|
|
266
278
|
6. 선택 노드 수집: forEachNode + node.isSelected() (getSelectedNodes는 ref API에 없음). onSelectionChanged는 top-level prop (인자 = 선택 노드 배열)
|
|
267
|
-
ref API
|
|
279
|
+
ref API (gridRef.current.*, 26종): getColumnState, applyColumnState, setColumnDefs, setAutoGroupColumnDef, sizeColumnsToFit / setRowData, applyTransaction, getGridData, getDisplayedRowAtIndex, forEachNode, forEachNodeAfterFilter, refreshCells, redrawRows / setNodesSelected, checkBoxSelectAll, saveSelectionState, loadSelectionState, setSelectionState, clearSelectionState / updateFilter / downloadExcel, downloadCsv / getRowDropZoneParams, addRowDropZone / setServerSideDatasource, setServerSideFilterList (노드 값 변경은 node.setDataValue(field, value))
|
|
280
|
+
⚠️ DataGrid는 AG Grid 옵션을 최상위 prop으로 받지 않습니다 (rowHeight, getRowId, context, onRowClicked 등) — 모두 gridOptions 안에 넣으세요.
|
|
268
281
|
rowModelType: 'serverSide' 그리드는 AG Grid 내장 loadingCellRenderer를 쓰는 것이 맞습니다.
|
|
269
282
|
|
|
270
283
|
**import:**
|
|
@@ -288,7 +301,8 @@ export function createDataGridComponent() {
|
|
|
288
301
|
3. useEffect를 반드시 사용하여 데이터 로딩 시뮬레이션
|
|
289
302
|
4. .then()으로 성공 처리 → CommonConst.GRID_STATUS.DATA_EXISTS로 변경
|
|
290
303
|
5. .catch()로 에러 처리 → CommonConst.GRID_STATUS.ERROR로 변경
|
|
291
|
-
6.
|
|
304
|
+
6. 상태 문구(로딩·오류·데이터 없음·검색 결과 없음)는 그리드가 langCd(ko/en/ja) 표준 문구로 표시 — textLoading/textErrorTitle/textErrorDescription/textNoData 등은 넘기지 않는 것이 기본 (화면 고유 문구가 꼭 필요할 때만)
|
|
305
|
+
7. 조회 함수를 onRetry로 넘겨 오류 상태에 [다시 시도] 버튼을 제공 (재조회 시 status를 LOADING으로 되돌리는 것까지 조회 함수에서 처리)
|
|
292
306
|
|
|
293
307
|
사용자는 생성된 코드의 useEffect 내부에 실제 비즈니스 로직(API 호출, 데이터 변환 등)을 추가할 수 있습니다.
|
|
294
308
|
|
|
@@ -298,10 +312,10 @@ export function createDataGridComponent() {
|
|
|
298
312
|
const [status, setStatus] = useState(CommonConst.GRID_STATUS.LOADING);
|
|
299
313
|
const [rowData, setRowData] = useState([]);
|
|
300
314
|
|
|
301
|
-
// ✅ 올바른 방법: useEffect
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
315
|
+
// ✅ 올바른 방법: 조회 함수를 만들고 useEffect + onRetry 양쪽에서 사용
|
|
316
|
+
const fetchData = useCallback(async () => {
|
|
317
|
+
setStatus(CommonConst.GRID_STATUS.LOADING);
|
|
318
|
+
// 사용자가 여기에 실제 API 호출 등 비즈니스 로직을 추가합니다
|
|
305
319
|
try {
|
|
306
320
|
// 실제로는 여기에 API 호출을 넣습니다
|
|
307
321
|
// 예: const response = await fetch('/api/data');
|
|
@@ -321,21 +335,21 @@ export function createDataGridComponent() {
|
|
|
321
335
|
console.error('Error loading data:', error);
|
|
322
336
|
setStatus(CommonConst.GRID_STATUS.ERROR);
|
|
323
337
|
}
|
|
324
|
-
|
|
338
|
+
}, []);
|
|
325
339
|
|
|
340
|
+
useEffect(() => {
|
|
326
341
|
fetchData();
|
|
327
|
-
}, []);
|
|
342
|
+
}, [fetchData]);
|
|
328
343
|
|
|
329
344
|
// gridOptions 정의 (권장)
|
|
330
345
|
const gridOptions = {
|
|
331
346
|
animateRows: true,
|
|
332
347
|
rowSelection: { mode: 'singleRow', checkboxes: false, enableClickSelection: true },
|
|
333
|
-
tooltipShowDelay: 100,
|
|
334
348
|
domLayout: 'autoHeight',
|
|
335
349
|
suppressCellFocus: true,
|
|
336
350
|
};
|
|
337
351
|
|
|
338
|
-
// ✅ 올바른 방법:
|
|
352
|
+
// ✅ 올바른 방법: onRetry로 [다시 시도] 제공, 상태 문구는 표준 문구 사용 (text* prop 생략)
|
|
339
353
|
<OpsnowCommonDataGrid
|
|
340
354
|
columnDefs={columnDefs}
|
|
341
355
|
rowData={rowData}
|
|
@@ -348,8 +362,7 @@ export function createDataGridComponent() {
|
|
|
348
362
|
{ label: '10', value: 10 },
|
|
349
363
|
{ label: '20', value: 20 }
|
|
350
364
|
]}
|
|
351
|
-
|
|
352
|
-
textErrorDescription="데이터를 불러오는 중 오류가 발생했습니다."
|
|
365
|
+
onRetry={fetchData}
|
|
353
366
|
langCd={i18n.getLocale()}
|
|
354
367
|
/>
|
|
355
368
|
\`\`\``,
|
|
@@ -375,6 +388,24 @@ export function createDataGridComponent() {
|
|
|
375
388
|
]
|
|
376
389
|
};
|
|
377
390
|
}
|
|
378
|
-
}
|
|
391
|
+
},
|
|
392
|
+
{
|
|
393
|
+
name: "createHeaderFilter",
|
|
394
|
+
description: `HeaderFilter 컴포넌트 - DataGrid 컬럼 헤더에 정렬·필터 메뉴를 붙이는 커스텀 헤더
|
|
395
|
+
JSX로 직접 배치하지 않고 columnDefs의 headerComponent로 등록합니다. gridData에는 AG Grid가 넘기는 header params를 그대로 전달합니다.
|
|
396
|
+
예: { field: 'cost', headerComponent: (params) => <OpsnowCommonHeaderFilter gridData={params} textRight /> }
|
|
397
|
+
|
|
398
|
+
**import:**
|
|
399
|
+
\`\`\`javascript
|
|
400
|
+
import { useCommonComponents } from '@opsnow-common/opsnow-finops-common-ui-loader';
|
|
401
|
+
const { OpsnowCommonHeaderFilter } = useCommonComponents();
|
|
402
|
+
\`\`\``,
|
|
403
|
+
parameters: HeaderFilterSchema,
|
|
404
|
+
handler: async (args) => {
|
|
405
|
+
const { children, ...rest } = args;
|
|
406
|
+
const tag = jsxTag("OpsnowCommonHeaderFilter", jsxAttrs(rest, { exprKeys: ["gridData"] }), children);
|
|
407
|
+
return jsxResult(`const headerFilterColumn = {\n field: 'fieldName',\n headerComponent: (${args.gridData}) => (\n${tag}\n ),\n}\n// columnDefs={[ ..., headerFilterColumn ]}`);
|
|
408
|
+
},
|
|
409
|
+
},
|
|
379
410
|
];
|
|
380
411
|
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
|
|
2
3
|
import { IconNamesMap, generateIconDescription } from "./data/icon-names.js";
|
|
3
4
|
export const IconSchema = z.object({
|
|
4
5
|
iconName: z.enum(Object.keys(IconNamesMap)).describe(generateIconDescription({ format: 'nested' })),
|
|
@@ -8,21 +9,20 @@ export const IconSchema = z.object({
|
|
|
8
9
|
onClick: z.string().optional().describe("클릭 이벤트 핸들러 함수명 (HTMLAttributes 상속으로 span에 적용됨)"),
|
|
9
10
|
});
|
|
10
11
|
export const MuiIconSchema = z.object({
|
|
11
|
-
theme: z.
|
|
12
|
+
theme: z.enum(["mixed-circle-line-legend", "mixed-stack-line-legend", "diagonal-legend"]).optional().describe("레전드 마커 모양 (범례용일 때만) — 아이콘 이름은 theme이 아니라 label"),
|
|
12
13
|
hexColor: z.string().optional().describe("HEX 색상"),
|
|
13
14
|
size: z.number().optional().default(24).describe("아이콘 크기(px)"),
|
|
14
15
|
noCircle: z.boolean().optional().describe("원형 배경 없음"),
|
|
15
16
|
alpha: z.number().optional().describe("투명도"),
|
|
16
|
-
color: z.
|
|
17
|
-
label: z.string().optional().describe("MUI 아이콘 이름")
|
|
17
|
+
color: z.enum(["primary", "secondary", "success", "error", "info", "warning", "inherit"]).optional().describe("MUI 색상"),
|
|
18
|
+
label: z.string().optional().describe("MUI(Material) 아이콘 이름 (예: 'close', 'menu') — 기본값 add_icon")
|
|
19
|
+
});
|
|
20
|
+
export const MarkersSchema = z.object({
|
|
21
|
+
theme: z.enum(["square", "line-graph", "line-trend", "line-dashed", "mixed-line-stack"]).optional().describe("마커 모양 — square(사각), line-graph/line-trend/line-dashed(선), mixed-line-stack(선+막대)"),
|
|
22
|
+
hexColor: z.string().optional().describe("마커 색상 HEX (미지정 시 primary.main)"),
|
|
23
|
+
lineAlpha: z.number().optional().describe("선 부분 투명도 (0~1)"),
|
|
24
|
+
shapesAlpha: z.number().optional().describe("도형 부분 투명도 (0~1). mixed-line-stack이면 0.3으로 고정"),
|
|
18
25
|
});
|
|
19
|
-
// export const MarkersSchema = z.object({
|
|
20
|
-
// theme: z.string().describe("마커 테마"),
|
|
21
|
-
// hexColor: z.string().optional().describe("HEX 색상"),
|
|
22
|
-
// lineAlpha: z.number().optional().describe("선 투명도"),
|
|
23
|
-
// size: z.number().optional().default(24).describe("마커 크기(px)")
|
|
24
|
-
// });
|
|
25
|
-
// export type MarkersProps = z.infer<typeof MarkersSchema>;
|
|
26
26
|
export function createIconsComponent() {
|
|
27
27
|
return [
|
|
28
28
|
{
|
|
@@ -103,34 +103,18 @@ export function createIconsComponent() {
|
|
|
103
103
|
};
|
|
104
104
|
}
|
|
105
105
|
},
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
// const props: string[] = [];
|
|
120
|
-
// props.push(`theme="${args.theme}"`);
|
|
121
|
-
// if (args.hexColor) props.push(`hexColor="${args.hexColor}"`);
|
|
122
|
-
// if (args.lineAlpha) props.push(`lineAlpha={${args.lineAlpha}}`);
|
|
123
|
-
// if (args.size) props.push(`size={${args.size}}`);
|
|
124
|
-
// const code = `<OpsnowCommonMarkers ${props.join(" ")} />`;
|
|
125
|
-
// return {
|
|
126
|
-
// content: [
|
|
127
|
-
// {
|
|
128
|
-
// type: "text" as const,
|
|
129
|
-
// text: `\`\`\`jsx\n${code}\n\`\`\``
|
|
130
|
-
// }
|
|
131
|
-
// ]
|
|
132
|
-
// };
|
|
133
|
-
// }
|
|
134
|
-
// }
|
|
106
|
+
{
|
|
107
|
+
name: "createMarkers",
|
|
108
|
+
description: `Markers 컴포넌트 - 차트 범례·커스텀 레전드에 쓰는 시리즈 마커 (선/도형 조합)
|
|
109
|
+
크기는 고정이라 size prop이 없습니다.
|
|
110
|
+
|
|
111
|
+
**import:**
|
|
112
|
+
\`\`\`javascript
|
|
113
|
+
import { useOpsnowCommonIcons } from '@opsnow-common/opsnow-finops-common-ui-loader';
|
|
114
|
+
const { OpsnowCommonMarkers } = useOpsnowCommonIcons();
|
|
115
|
+
\`\`\``,
|
|
116
|
+
parameters: MarkersSchema,
|
|
117
|
+
handler: async (args) => jsxResult(jsxTag("OpsnowCommonMarkers", jsxAttrs(args))),
|
|
118
|
+
},
|
|
135
119
|
];
|
|
136
120
|
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
// 생성기 공용: 툴 입력(args)을 JSX 속성 문자열로 변환
|
|
2
|
+
// - exprKeys에 든 키(상태 변수명·함수명·JSX)는 {값}으로, 그 외 문자열은 "값"으로 출력
|
|
3
|
+
// - true → 속성만, false → {false}, 숫자 → {n}, 객체/배열 → {JSON}
|
|
4
|
+
// - skipKeys는 출력하지 않음 (생성기 입력 전용 키 등)
|
|
5
|
+
export function jsxAttrs(args, opts = {}) {
|
|
6
|
+
const exprKeys = new Set(opts.exprKeys ?? []);
|
|
7
|
+
const skipKeys = new Set(opts.skipKeys ?? []);
|
|
8
|
+
const out = [];
|
|
9
|
+
for (const [k, v] of Object.entries(args)) {
|
|
10
|
+
if (v === undefined || v === null || skipKeys.has(k))
|
|
11
|
+
continue;
|
|
12
|
+
if (typeof v === "string")
|
|
13
|
+
out.push(exprKeys.has(k) ? `${k}={${v}}` : `${k}="${v}"`);
|
|
14
|
+
else if (typeof v === "boolean")
|
|
15
|
+
out.push(v ? k : `${k}={false}`);
|
|
16
|
+
else if (typeof v === "number")
|
|
17
|
+
out.push(`${k}={${v}}`);
|
|
18
|
+
else
|
|
19
|
+
out.push(`${k}={${JSON.stringify(v)}}`);
|
|
20
|
+
}
|
|
21
|
+
return out;
|
|
22
|
+
}
|
|
23
|
+
// 여러 줄 JSX 태그 조립 (children 없으면 self-closing)
|
|
24
|
+
export function jsxTag(tag, attrs, children) {
|
|
25
|
+
const open = attrs.length ? `<${tag}\n ${attrs.join("\n ")}\n` : `<${tag}`;
|
|
26
|
+
if (!children)
|
|
27
|
+
return attrs.length ? `${open}/>` : `${open} />`;
|
|
28
|
+
return `${attrs.length ? open : open + " "}>\n ${children}\n</${tag}>`.replace(`<${tag} >`, `<${tag}>`);
|
|
29
|
+
}
|
|
30
|
+
// JSX 표현식 값: 문자열은 변수명·함수·JSX로 보고 그대로, 그 외(객체·배열·숫자·불리언)는 JSON 리터럴로
|
|
31
|
+
export function jsxExpr(value) {
|
|
32
|
+
return typeof value === "string" ? value : JSON.stringify(value);
|
|
33
|
+
}
|
|
34
|
+
export function jsxResult(code) {
|
|
35
|
+
return { content: [{ type: "text", text: `\`\`\`jsx\n${code}\n\`\`\`` }] };
|
|
36
|
+
}
|
|
@@ -1,21 +1,19 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { jsxAttrs, jsxTag, jsxResult } from "./opsnow-common-jsx-helper.js";
|
|
3
|
+
// MUI 9 Grid size 값: 컬럼 수(1~12) | 'auto'(콘텐츠 폭) | 'grow'(남은 폭 채움)
|
|
4
|
+
const GridSizeValue = z.union([z.number(), z.enum(["auto", "grow"])]);
|
|
5
|
+
const GridBreakpointSize = z.object({
|
|
6
|
+
xs: GridSizeValue.optional(),
|
|
7
|
+
sm: GridSizeValue.optional(),
|
|
8
|
+
md: GridSizeValue.optional(),
|
|
9
|
+
lg: GridSizeValue.optional(),
|
|
10
|
+
xl: GridSizeValue.optional(),
|
|
11
|
+
});
|
|
2
12
|
const GridLayoutSchema = z.object({
|
|
3
13
|
items: z.array(z.string()).describe("렌더링할 JSX 문자열 배열 (각 항목은 컴포넌트 호출 코드)"),
|
|
4
|
-
layout: z.array(
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
md: z.number().optional(),
|
|
8
|
-
lg: z.number().optional(),
|
|
9
|
-
xl: z.number().optional(),
|
|
10
|
-
}).partial()).optional().describe("각 항목별 브레이크포인트 레이아웃 배열"),
|
|
11
|
-
defaultLayout: z.object({
|
|
12
|
-
xs: z.number().optional(),
|
|
13
|
-
sm: z.number().optional(),
|
|
14
|
-
md: z.number().optional(),
|
|
15
|
-
lg: z.number().optional(),
|
|
16
|
-
xl: z.number().optional(),
|
|
17
|
-
}).optional().describe("기본 브레이크포인트 레이아웃"),
|
|
18
|
-
spacing: z.number().optional().describe("Grid 간격 (MUI spacing 단위)"),
|
|
14
|
+
layout: z.array(GridBreakpointSize.partial()).optional().describe("각 항목별 브레이크포인트 size 배열 (MUI 9 Grid size prop으로 출력, 예: { xs: 12, md: 6 })"),
|
|
15
|
+
defaultLayout: GridBreakpointSize.optional().describe("기본 브레이크포인트 size (기본 { xs: 'grow' })"),
|
|
16
|
+
spacing: z.number().optional().describe("Grid 간격 (MUI spacing 단위). 미지정 시 섹션 간격 토큰(sectionGap 24px) 사용"),
|
|
19
17
|
tileProps: z.record(z.any()).optional().describe("OpsnowCommonTile에 전달할 추가 props"),
|
|
20
18
|
});
|
|
21
19
|
const MegaFilterSchema = z.object({
|
|
@@ -23,10 +21,12 @@ const MegaFilterSchema = z.object({
|
|
|
23
21
|
vendors: z.string().optional().describe("벤더 옵션 배열 변수명"),
|
|
24
22
|
selectedVendor: z.string().optional().describe("선택된 벤더 상태 변수명"),
|
|
25
23
|
onVendorChange: z.string().optional().describe("벤더 변경 이벤트 핸들러"),
|
|
26
|
-
onFilterChange: z.string().
|
|
24
|
+
onFilterChange: z.string().describe("필터 변경 이벤트 핸들러 (필수)"),
|
|
27
25
|
selectedDateRange: z.string().optional().describe("선택된 날짜 범위 상태 변수명"),
|
|
28
26
|
onDateRangeChange: z.string().optional().describe("날짜 범위 변경 이벤트 핸들러"),
|
|
29
|
-
locale: z.enum(["en", "ko"]).optional().describe("로케일 설정"),
|
|
27
|
+
locale: z.enum(["en", "ko", "ja", "zh"]).optional().describe("로케일 설정"),
|
|
28
|
+
chipStateOptions: z.string().optional().describe("필터 칩 상태 옵션 배열 변수명"),
|
|
29
|
+
filterCountText: z.string().optional().describe("선택 개수 텍스트 함수명 ((selected, total) => string)"),
|
|
30
30
|
title: z.string().optional().describe("필터 제목"),
|
|
31
31
|
clearAllText: z.string().optional().describe("전체 초기화 버튼 텍스트"),
|
|
32
32
|
clearText: z.string().optional().describe("개별 초기화 버튼 텍스트"),
|
|
@@ -36,6 +36,17 @@ const MegaFilterSchema = z.object({
|
|
|
36
36
|
noItemsText: z.string().optional().describe("검색 결과 없음 텍스트"),
|
|
37
37
|
addText: z.string().optional().describe("개별 필터 추가 버튼 텍스트"),
|
|
38
38
|
});
|
|
39
|
+
export const TileSchema = z.object({
|
|
40
|
+
size: z.union([z.number(), z.enum(["auto", "grow"])]).optional().describe("flex 크기 — 'grow'(남은 폭 채움, 기본값) | 'auto'(콘텐츠 폭) | 숫자(flex 비율)"),
|
|
41
|
+
theme: z.enum(["selectable", "gray", "white", "blue", "dash", "special"]).optional().describe("타일 테마 (dash = 점선 테두리)"),
|
|
42
|
+
borderColor: z.string().optional().describe("테두리 색상"),
|
|
43
|
+
borderStyle: z.string().optional().describe("테두리 스타일 (기본값: solid)"),
|
|
44
|
+
height: z.string().optional().describe("높이 (CSS 값, 예: '240px')"),
|
|
45
|
+
className: z.string().optional().describe("클래스명 — Tile은 sx를 받지 않으므로 스타일은 className으로"),
|
|
46
|
+
onClick: z.string().optional().describe("클릭 핸들러 함수명 (selectable 테마와 함께)"),
|
|
47
|
+
header: z.string().optional().describe("Tile.Header 안에 넣을 JSX (생성기 입력 — <OpsnowCommonTile.Header>로 출력)"),
|
|
48
|
+
content: z.string().optional().describe("Tile.Content 안에 넣을 JSX (생성기 입력 — <OpsnowCommonTile.Content>로 출력)"),
|
|
49
|
+
});
|
|
39
50
|
export function createGridLayoutComponent() {
|
|
40
51
|
return [
|
|
41
52
|
{
|
|
@@ -44,7 +55,8 @@ export function createGridLayoutComponent() {
|
|
|
44
55
|
|
|
45
56
|
**간격 규칙 (px 하드코딩 금지, 색상 토큰처럼 theme.commonSpacing 참조):**
|
|
46
57
|
- 페이지/그리드 컨테이너 패딩: theme.commonSpacing.pagePadding (24px)
|
|
47
|
-
- 섹션(카드 그룹) 사이 간격:
|
|
58
|
+
- 섹션(카드 그룹) 사이 간격: sectionGap (24px) — Grid container의 spacing="var(--opsnow-spacing-section-gap)" (sx gap 금지: size 폭 계산에 안 들어가 줄바꿈이 깨짐)
|
|
59
|
+
- MUI 9 Grid: <Grid size={{ xs: 12, md: 6 }}> (item/xs/md prop 금지)
|
|
48
60
|
- 카드(Box) 내부 패딩: theme.commonSpacing.cardPadding ('16px 20px')
|
|
49
61
|
- 카드 내부 요소 간 간격: theme.commonSpacing.cardGap (16px)
|
|
50
62
|
- 값이 여러 개이므로 sx는 콜백 형태로: sx={theme => ({ padding: theme.commonSpacing.pagePadding, gap: theme.commonSpacing.sectionGap })}
|
|
@@ -56,13 +68,13 @@ export function createGridLayoutComponent() {
|
|
|
56
68
|
`,
|
|
57
69
|
parameters: GridLayoutSchema,
|
|
58
70
|
handler: async (args) => {
|
|
59
|
-
const { items, layout = [], defaultLayout = { xs:
|
|
71
|
+
const { items, layout = [], defaultLayout = { xs: 'grow' }, spacing, } = args;
|
|
60
72
|
const gridItems = items.map((item, i) => {
|
|
61
73
|
const bp = layout[i] || defaultLayout;
|
|
62
|
-
const
|
|
63
|
-
.map(([k, v]) => `${k}
|
|
64
|
-
.join(" ");
|
|
65
|
-
return ` <Grid
|
|
74
|
+
const sizeObj = Object.entries(bp)
|
|
75
|
+
.map(([k, v]) => `${k}: ${typeof v === "string" ? `'${v}'` : v}`)
|
|
76
|
+
.join(", ");
|
|
77
|
+
return ` <Grid size={{ ${sizeObj} }} key={${i}}>` +
|
|
66
78
|
`\n <Box sx={theme => ({` +
|
|
67
79
|
`\n border: '1px solid #ddd',` +
|
|
68
80
|
`\n borderRadius: '12px',` +
|
|
@@ -77,7 +89,8 @@ export function createGridLayoutComponent() {
|
|
|
77
89
|
`\n </Grid>`;
|
|
78
90
|
}).join("\n");
|
|
79
91
|
const code = [
|
|
80
|
-
|
|
92
|
+
// 간격은 sx gap이 아니라 spacing으로 (gap은 size 폭 계산에 안 들어감)
|
|
93
|
+
`<Grid container spacing={${spacing !== undefined ? spacing : '"var(--opsnow-spacing-section-gap)"'}} sx={theme => ({ padding: theme.commonSpacing.pagePadding })}>`,
|
|
81
94
|
gridItems,
|
|
82
95
|
`</Grid>`,
|
|
83
96
|
].join("\n");
|
|
@@ -112,6 +125,10 @@ export function createGridLayoutComponent() {
|
|
|
112
125
|
props.push(`onVendorChange={${args.onVendorChange}}`);
|
|
113
126
|
if (args.onFilterChange)
|
|
114
127
|
props.push(`onFilterChange={${args.onFilterChange}}`);
|
|
128
|
+
if (args.chipStateOptions)
|
|
129
|
+
props.push(`chipStateOptions={${args.chipStateOptions}}`);
|
|
130
|
+
if (args.filterCountText)
|
|
131
|
+
props.push(`filterCountText={${args.filterCountText}}`);
|
|
115
132
|
if (args.selectedDateRange)
|
|
116
133
|
props.push(`selectedDateRange={${args.selectedDateRange}}`);
|
|
117
134
|
if (args.onDateRangeChange)
|
|
@@ -144,6 +161,30 @@ export function createGridLayoutComponent() {
|
|
|
144
161
|
]
|
|
145
162
|
};
|
|
146
163
|
},
|
|
147
|
-
}
|
|
164
|
+
},
|
|
165
|
+
{
|
|
166
|
+
name: "createTile",
|
|
167
|
+
description: `Tile 컴포넌트 - 카드형 컨테이너 (헤더 + 본문)
|
|
168
|
+
<OpsnowCommonTile>
|
|
169
|
+
<OpsnowCommonTile.Header>제목</OpsnowCommonTile.Header> // props: paddingX, paddingY (기본 16), borderColor
|
|
170
|
+
<OpsnowCommonTile.Content>본문</OpsnowCommonTile.Content> // props: paddingX, paddingY (기본 16)
|
|
171
|
+
</OpsnowCommonTile>
|
|
172
|
+
⚠️ Tile은 sx를 받지 않습니다 (rest props 미전달) — 스타일은 className 또는 감싸는 Box의 sx로.
|
|
173
|
+
⚠️ layout 패키지는 로더 의존성이 아니라 앱 package.json에 @opsnow-common/opsnow-common-layout@^2 를 직접 설치해야 합니다.
|
|
174
|
+
|
|
175
|
+
**import:**
|
|
176
|
+
\`\`\`javascript
|
|
177
|
+
import { OpsnowCommonTile } from '@opsnow-common/opsnow-common-layout';
|
|
178
|
+
\`\`\``,
|
|
179
|
+
parameters: TileSchema,
|
|
180
|
+
handler: async (args) => {
|
|
181
|
+
const { header, content, ...rest } = args;
|
|
182
|
+
const children = [
|
|
183
|
+
header ? `<OpsnowCommonTile.Header>${header}</OpsnowCommonTile.Header>` : "",
|
|
184
|
+
`<OpsnowCommonTile.Content>${content ?? ""}</OpsnowCommonTile.Content>`,
|
|
185
|
+
].filter(Boolean).join("\n ");
|
|
186
|
+
return jsxResult(jsxTag("OpsnowCommonTile", jsxAttrs(rest, { exprKeys: ["onClick"] }), children));
|
|
187
|
+
},
|
|
188
|
+
},
|
|
148
189
|
];
|
|
149
190
|
}
|