@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.
Files changed (39) hide show
  1. package/build/components/all-component-tools.js +2 -0
  2. package/build/components/data/icon-names.generated.js +341 -0
  3. package/build/components/data/icon-names.js +32 -16
  4. package/build/components/examples/opsnow-common-chart-examples-data.js +73 -471
  5. package/build/components/examples/opsnow-common-forms-examples-data.js +1 -11
  6. package/build/components/examples/opsnow-common-grid-examples-data.js +93 -129
  7. package/build/components/examples/opsnow-common-layout-examples-data.js +12 -13
  8. package/build/components/examples/opsnow-common-popup-examples-data.js +14 -28
  9. package/build/components/examples/opsnow-common-progress-examples-data.js +0 -5
  10. package/build/components/examples/opsnow-common-select-examples-data.js +16 -0
  11. package/build/components/examples/opsnow-common-stepper-examples-data.js +2 -3
  12. package/build/components/examples/opsnow-common-storage-examples-data.js +23 -4
  13. package/build/components/examples/opsnow-common-tab-examples-data.js +37 -0
  14. package/build/components/examples/opsnow-common-tooltip-examples-data.js +1 -21
  15. package/build/components/opsnow-common-calendar.js +36 -15
  16. package/build/components/opsnow-common-chart.js +245 -156
  17. package/build/components/opsnow-common-coach-mark.js +3 -2
  18. package/build/components/opsnow-common-data-status.js +17 -11
  19. package/build/components/opsnow-common-dropdown.js +80 -0
  20. package/build/components/opsnow-common-examples.js +4 -2
  21. package/build/components/opsnow-common-file-upload.js +4 -1
  22. package/build/components/opsnow-common-forms.js +73 -36
  23. package/build/components/opsnow-common-grid.js +110 -79
  24. package/build/components/opsnow-common-icons.js +23 -39
  25. package/build/components/opsnow-common-jsx-helper.js +36 -0
  26. package/build/components/opsnow-common-layout.js +66 -25
  27. package/build/components/opsnow-common-notification.js +3 -2
  28. package/build/components/opsnow-common-pagination.js +4 -4
  29. package/build/components/opsnow-common-popup.js +12 -11
  30. package/build/components/opsnow-common-progress.js +10 -16
  31. package/build/components/opsnow-common-select.js +30 -15
  32. package/build/components/opsnow-common-stepper.js +30 -7
  33. package/build/components/opsnow-common-tab.js +26 -3
  34. package/build/components/opsnow-common-toast-popup.js +1 -0
  35. package/build/components/opsnow-common-tooltip.js +44 -46
  36. package/build/components/opsnow-common-typography.js +11 -5
  37. package/build/components/opsnow-common-validate-props.js +0 -0
  38. package/build/index.js +43 -0
  39. 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
- domLayout: z.enum(['normal', 'autoHeight', 'print']).optional().describe('그리드 레이아웃 방식'),
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
- 'value'
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('행 클래스 사용 여부 (셀 클릭 이벤트 사용 시 필수: true)'),
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.string().optional().describe('행 모델 타입'),
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: Auto Row Height - 다음 경우 반드시 적용**
215
- 1. 긴 텍스트가 들어올 수 있는 컬럼이 있는 경우 (설명, 메시지, 항목, 이름, 제목, 코멘트, 비고, 등)
216
- 2. 컬럼이 resizable인 경우 - 사용자가 폭을 줄여도 텍스트가 잘리지 않고 여러 줄로 정상 표시되어야 함 (ellipsis로 자르면 안됨)
217
-
218
- [필수] defaultColDef에 반드시 포함:
219
- const defaultColDef = {
220
- // ... 다른 설정들
221
- wrapText: true, // 필수 - 텍스트 줄바꿈
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
- field: 'description',
235
- flex: 2, // 필수 - flex 사용
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
- ⚠️ defaultColDef에 wrapText, autoHeight가 없으면 텍스트가 넘칩니다!
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
- **CRITICAL: 행 수가 많을 수 있으면 - 높이 분기 필수**
246
- autoHeight(domLayout:'autoHeight')는 모든 행을 펼쳐서 그리드가 무한정 길어짐.
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 ROW_LIMIT = 10;
250
- const isScroll = rowData.length > ROW_LIMIT;
251
- const gridOptions = {
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 요약: refreshCells / redrawRows / forEachNode / node.setDataValue(field, value) / downloadExcel / downloadCsv
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. OpsnowCommonDataGrid에 textErrorTitle, textErrorDescription 속성 반드시 포함
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
- useEffect(() => {
303
- // 사용자가 여기에 실제 API 호출 등 비즈니스 로직을 추가합니다
304
- const fetchData = async () => {
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
- textErrorTitle="데이터 로드 실패"
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.string().optional().describe("테마명"),
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.string().optional().describe("MUI 색상"),
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
- // name: "createMarkers",
108
- // description: `마커 컴포넌트 - 그래프/차트용 심볼
109
- // - 그래프, 차트 등에서 포인트/마커로 활용
110
- // - theme(마커 테마), hexColor, lineAlpha, size 등 다양한 옵션 지원
111
- // - 아이콘은 useOpsnowCommonIcons 훅을 통해 생성해야 합니다.
112
- // **import 예시:**
113
- // \`\`\`javascript
114
- // import { useOpsnowCommonIcons } from '@opsnow-common/opsnow-finops-common-ui-loader';
115
- // const { OpsnowCommonMarkers } = useOpsnowCommonIcons();
116
- // \`\`\``,
117
- // parameters: MarkersSchema,
118
- // handler: async (args: MarkersProps) => {
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(z.object({
5
- xs: z.number().optional(),
6
- sm: z.number().optional(),
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().optional().describe("필터 변경 이벤트 핸들러"),
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
- - 섹션(카드 그룹) 사이 간격: theme.commonSpacing.sectionGap (24px) — Grid container의 gap
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: true }, spacing = 2, } = args;
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 bpProps = Object.entries(bp)
63
- .map(([k, v]) => `${k}={${v}}`)
64
- .join(" ");
65
- return ` <Grid item ${bpProps} key={${i}}>` +
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
- `<Grid container wrap="nowrap" spacing={0} sx={theme => ({ padding: theme.commonSpacing.pagePadding, gap: theme.commonSpacing.sectionGap })}>`,
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
  }