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

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.
@@ -11,19 +11,28 @@ export const XyMultiChartSchema = z.object({
11
11
  "paddingTop": 20, // 차트 상단 패딩 (px)
12
12
  "paddingBottom": 30, // 차트 하단 패딩 (px)
13
13
  "paddingLeft": 10, // 차트 좌측 패딩 (px)
14
- "paddingRight": 50 // 차트 우측 패딩 (px, 이중 축 사용 시 우측 여유 공간 확보)
14
+ "paddingRight": 50, // 차트 우측 패딩 (px, 이중 축 사용 시 우측 여유 공간 확보)
15
+ // ── 줌/스크롤 (선택) — 스크롤바를 드래그해 보이는 구간을 좁히거나 이동 ──
16
+ "scrollbarX": { // X축 스크롤바 (차트 위쪽). 옵션 없이 {} 만 줘도 켜짐
17
+ "height": 60, // 스크롤바 높이 (px, 기본값: 12). showSeries 사용 시 60 정도로 키움
18
+ "gripScale": 0.8, // 양끝 손잡이 크기 배율 (기본값: 0.8)
19
+ "showSeries": true // 스크롤바 안에 시리즈 미리보기 표시 (기본값: false)
20
+ },
21
+ "scrollbarY": {}, // Y축 스크롤바 (차트 오른쪽). 옵션: "gripScale"
22
+ "zoomOutButtonHidden": false, // 줌 아웃(원래대로) 버튼 숨김 여부 (기본값: true = 숨김). 줌/스크롤을 쓰면 false 로 두어 버튼 노출
23
+ "wheelX": "panX", // Ctrl + 마우스 휠(가로) 동작: 'zoomX' | 'zoomY' | 'zoomXY' | 'panX' | 'panY' | 'panXY' | 'none' — Ctrl 키를 누른 상태에서만 동작
24
+ "wheelY": "zoomX", // Ctrl + 마우스 휠(세로) 동작 (값은 wheelX 와 동일)
25
+ "wheelStep": 0.2, // 휠 한 칸당 줌/이동 비율
26
+ "panX": true, // 마우스 드래그로 가로 이동 허용
27
+ "panY": false // 마우스 드래그로 세로 이동 허용
15
28
  },
16
29
 
17
30
  // X축 설정
18
31
  "xAxis": {
19
32
  "type": "date", // 축 타입: 'date' | 'category'
20
33
  "valueField": "date", // X축 값 필드
21
- "dateFormats": [ // xAxis type이 'date'일 때 사용
22
- {
23
- "type": "day", // 날짜 단위: 'day' | 'week' | 'month' | 'year'
24
- "dateFormat": "MM/dd" // amCharts5에서 지원하는 날짜 형식
25
- }
26
- ],
34
+ // ⚠️ "dateFormats"는 넣지 말 것 — X축 날짜는 표기 표준이 기본 적용됨 (축: 분·시 HH:mm / 일 MM-dd / 월 yyyy-MM / 년 yyyy, 툴팁: yyyy-MM-dd(HH:mm) / yyyy-MM).
35
+ // dateFormats를 지정하면 축·기간변경·툴팁 포맷이 모두 그 값으로 덮어써져 표준이 깨짐 ('MM/dd' 같은 값 금지)
27
36
  "baseInterval": { // xAxis type이 'date'일 때 사용
28
37
  "timeUnit": "day", // 시간 단위: 'day' | 'week' | 'month' | 'year'
29
38
  "count": 1 // 간격 수(1로 고정이며 변경 불가)
@@ -41,6 +50,7 @@ export const XyMultiChartSchema = z.object({
41
50
 
42
51
  // Y축 설정
43
52
  "yAxis": {
53
+ "autoStrokeColor": true, // Y축 선을 해당 축에 연결된 시리즈 색으로 굵게 표시 (다중 Y축에서 축-시리즈 구분용). yAxis2, yAxis3 … 에도 동일하게 사용
44
54
  "type": "value", // Y축 타입: 'value'
45
55
  "useMin": false, // Y축 최소값 사용 여부 (기본값: false)
46
56
  "min": 0, // Y축 최소값 직접 지정
@@ -161,9 +171,19 @@ export const XyMultiChartSchema = z.object({
161
171
  }
162
172
  ],
163
173
  "tooltip": { // 툴팁 설정(툴팁 설정시 body 설정 필수)
164
- "type": "CG", // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
174
+ "type": "CG", // 툴팁 타입: 'CI' | 'CG' | 'CG-Compare'
175
+ // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
176
+ // CG-Compare: 기간 비교 툴팁 — 조회 기간 vs 비교 기간 값을 한 줄에 "증감률 % (조회값 vs 비교값)" 으로 보여주고,
177
+ // 증감 화살표(증가 ↑ 빨강 / 감소 ↓ 초록 / 동일 -)와 증감률을 공통 컴포넌트가 자동 계산해서 그림. 헤더는 "조회일 vs 비교일" 로 자동 표시.
178
+ // 사용 조건 (3가지 모두 필요):
179
+ // 1) chartCategory 의 비교 그룹에 compare: { origin, matchingType: 'index', valueXField } 지정 (chartCategory 설명 참고)
180
+ // 2) body.value / footer.value 는 **단순 문자열** 로 금액만 넘김 (예: "{valueY.formatNumber('0,0.00r')}").
181
+ // 증감률·화살표를 직접 넣지 말 것 — 컴포넌트가 포맷된 글자에서 숫자만 뽑아 증감률을 계산하므로 다른 숫자가 섞이면 계산이 틀어짐
182
+ // 3) chartData 각 행에 조회 기간 X값(valueXField)과 비교 기간 X값(compare.valueXField) 을 함께 넣음
183
+ // 툴팁 문자열은 색상 마크업([#f00]...[/])·HTML 을 해석하지 않으므로, 증감 색상은 이 타입으로만 표현 가능
165
184
  "withinArea": true, // 차트 영역 내에서만 툴팁 표시 여부
166
- "stopActionEnabled": false, // 툴팁 액션 중지 여부
185
+ "stopActionEnabled": false, // true 면 키를 누르고 있는 동안 툴팁이 고정되어 툴팁 안을 스크롤·클릭할 수 있음 (기본 키: Ctrl)
186
+ "stopActionKey": "alt", // 툴팁 고정 키를 Alt 로 변경 (생략 시 Ctrl)
167
187
  "orientation": "horizontal", // 툴팁 방향: 'horizontal' | 'vertical'
168
188
  "showAt": "ondemand_cost", // 특정 카테고리 그룹에서만 툴팁 표시
169
189
  "position": { // 툴팁 위치 설정
@@ -185,7 +205,9 @@ export const XyMultiChartSchema = z.object({
185
205
  // ]
186
206
  },
187
207
  "body": { // 툴팁 바디 설정
188
- "maxRowCount": 6, // 최대 행 개수
208
+ "maxRowCount": 6, // 최대 행 개수 (카테고리 그룹별)
209
+ "maxTotalRowCount": 12, // 툴팁 전체(모든 그룹 합산) 최대 행 개수 — 넘으면 툴팁 안에서 스크롤
210
+ "nameTruncated": { "enabled": true, "maxLength": 20 }, // 이름이 maxLength(기본 20)자를 넘으면 "..." 로 말줄임. header/footer 에도 같은 형태로 지정 가능
189
211
  "name": "{name}", // 툴팁 바디 이름
190
212
  "value": [ // 툴팁 바디 값 (배열 형태로 카테고리별 설정 가능)
191
213
  {
@@ -230,13 +252,50 @@ export const XyMultiChartSchema = z.object({
230
252
 
231
253
  // 커서 설정
232
254
  "cursor": {
233
- "visibleY": false // Y축 커서 표시 여부
255
+ "visibleX": true, // X축 커서(세로 가이드선) 표시 여부 (기본값: true)
256
+ "visibleY": false, // Y축 커서 표시 여부
257
+ "behavior": "zoomXY" // 마우스 드래그 동작 (선택): 'none'(기본) | 'zoomX' | 'zoomY' | 'zoomXY' | 'selectX' | 'selectY' — 드래그한 영역으로 확대할 때 사용
234
258
  },
235
259
 
260
+ // 기준선(축 범위선) 설정 (선택) — 목표값·예산선 등을 축에 가로/세로 선으로 표시
261
+ "axisRanges": [
262
+ {
263
+ "value": 1.5, // 선을 그을 축 값
264
+ "target": "Y", // 대상 축: 'X' | 'Y' (생략 시 Y축)
265
+ "color": "#c1222e", // 선·라벨 색상
266
+ "text": "{value.formatNumber('0,0.00')}", // 선 끝에 표시할 라벨 텍스트
267
+ "lineStyle": "dot", // 선 스타일: 'dot'(점선). 생략 시 실선
268
+ "location": 1, // 라벨 위치 (0~1, 1 = 축 끝쪽)
269
+ "above": true, // 시리즈 위에 그릴지 여부
270
+ "background": { "fill": "#c1222e" } // 라벨 배경색
271
+ }
272
+ ],
273
+
236
274
  // 범례 설정
237
275
  "legend": {
238
276
  "clickTarget": "none", // 범례 클릭 대상: "none" | "" (기본값: "none")
239
- "useExtension": true // 범례 확장 사용 여부 (기본값: true — 끄려면 false). 켜져 있으면 범례 전체 선택 체크박스 사용 가능
277
+ "useExtension": false, // 범례 확장 사용 여부 (기본값: false — true를 명시해야 켜짐). 켜면 범례 펼치기/접기 + 전체 선택 체크박스 사용 가능. 범례가 많아 접어야 할 때만 true
278
+ "maxRow": 3, // 범례 최대 줄 수 (기본값: 3). 넘치면 범례 영역 안에서 세로 스크롤 / useExtension 사용 시 접힌 상태의 줄 수
279
+ "useExpanding": true, // useExtension 사용 시 펼치기/접기 버튼 사용 여부 (기본값: true)
280
+ "focusItem": true, // 범례 항목에 마우스를 올리면 해당 시리즈만 강조하고 나머지는 흐리게 (기본값: false)
281
+ "useDefaultMarker": true, // 범례 마커를 기본 사각형으로 표시 (기본값: true). false 면 시리즈 모양(라인·불릿 등)을 따름
282
+ "minWidth": 100, // 범례 영역 최소 너비 (px)
283
+ "maxWidth": 300, // 범례 영역 최대 너비 (px)
284
+ "cursorOverStyle": "pointer", // 범례 위 마우스 커서 모양
285
+ "label": { // 범례 라벨 설정
286
+ "maxWidth": 150, // 라벨 최대 너비 (px)
287
+ "oversizedBehavior": "truncate" // 최대 너비 초과 시: 'truncate'(말줄임) | 'wrap' | 'none'
288
+ },
289
+ "verticalLegend": { // 세로 범례 (차트 옆에 항목을 세로로 나열 + 항목별 값 표시). 지정하면 세로 범례로 전환
290
+ "itemHeight": 40, // 항목 높이 (px, 기본값: 50)
291
+ "tooltipDirection": "right", // 범례 항목 툴팁이 뜨는 방향: 'left' | 'right'
292
+ "legendTitle": ["AWS", "GCP"], // 범례 이름 앞머리가 이 값들 중 하나로 시작하면 그 부분을 회색 제목 줄로 분리해 표시
293
+ "valueLabel": { // 항목 오른쪽 값 라벨
294
+ "textAlign": "right", // 정렬
295
+ "fontSize": 11, // 폰트 크기
296
+ "text": "{customValueTooltip['arrow']} {customValueTooltip['diffRatio']}%" // 값 텍스트 (chartUserDefinedFunc 결과 참조 가능). 텍스트 안의 'up'/'down'/'even' 단어는 증감 화살표(↑ 빨강 / ↓ 초록 / ─)로 바뀜. 생략 시 값의 퍼센트 표시
297
+ }
298
+ }
240
299
  }
241
300
  }
242
301
  `),
@@ -263,7 +322,12 @@ export const XyMultiChartSchema = z.object({
263
322
  ]`),
264
323
  chartCategory: z.array(z.object({
265
324
  name: z.string(),
266
- categories: z.array(z.string())
325
+ categories: z.array(z.string()),
326
+ compare: z.object({
327
+ origin: z.string().describe("비교 기준이 되는 조회 기간 그룹의 name"),
328
+ matchingType: z.enum(['index']).describe("조회 그룹과 비교 그룹의 categories 를 짝짓는 방식. 'index' = 같은 순서(인덱스)끼리 비교"),
329
+ valueXField: z.string().describe("chartData 에서 비교 기간의 X값(날짜 등)이 들어있는 필드명")
330
+ }).optional().describe("기간 비교 그룹 설정. 비교 기간 그룹에만 지정하며 tooltip.type 'CG-Compare' 와 함께 사용")
267
331
  })).describe(`차트 카테고리 설정입니다.
268
332
  예시)
269
333
  [
@@ -281,6 +345,25 @@ export const XyMultiChartSchema = z.object({
281
345
  ]
282
346
  }
283
347
  ]
348
+
349
+ 기간 비교(tooltip.type: 'CG-Compare') 예시) — 비교 기간 그룹에 compare 를 지정합니다.
350
+ 조회 그룹과 비교 그룹의 categories 는 **개수와 순서가 같아야** 합니다 (같은 인덱스끼리 비교).
351
+ [
352
+ {
353
+ name: 'current', // 조회 기간 그룹
354
+ categories: ['AWS 100000000001', 'AWS 100000000002']
355
+ },
356
+ {
357
+ name: 'last', // 비교 기간 그룹
358
+ categories: ['AWS 100000000001 compare', 'AWS 100000000002 compare'],
359
+ compare: {
360
+ origin: 'current', // 조회 기간 그룹의 name
361
+ matchingType: 'index', // 같은 순서의 카테고리끼리 비교
362
+ valueXField: 'date compare' // chartData 에서 비교 기간 날짜가 들어있는 필드
363
+ }
364
+ }
365
+ ]
366
+ chartData 예시) { 'date': '2023-06-01', 'date compare': '2023-05-01', 'AWS 100000000001': 10000, 'AWS 100000000001 compare': 8000, ... }
284
367
  `),
285
368
  chartLocaleProps: z.array(z.object({
286
369
  name: z.string(),
@@ -402,6 +485,7 @@ export const XyMultiChartSchema = z.object({
402
485
  useOpsnowUs: z.boolean().optional().describe("OpsNow US 기본(basic) 색상 팔레트 사용 여부 (boolean, 기본값 true). false면 mix 팔레트를 사용합니다. chartCategoryColorByVendor가 지정되면 그 설정이 우선합니다."),
403
486
  chartNoRowsText: z.string().optional().describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
404
487
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
488
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
405
489
  });
406
490
  // opsnow-common-stack-chart
407
491
  export const StackChartSchema = z.object({
@@ -421,14 +505,11 @@ export const StackChartSchema = z.object({
421
505
 
422
506
  // X축 설정
423
507
  "xAxis": {
508
+ "customLabelField": "customLabel", // chartData 각 행에서 축 라벨로 대신 표시할 텍스트 필드명 (행에 값이 있을 때만 적용)
424
509
  "type": "date", // 축 타입: 'date' | 'value' | 'category' (바형 차트일 경우는 value 사용)
425
510
  "valueField": "date", // X축 값 필드 (컬럼형 차트일 경우 필수, 바형 차트일 경우 절대 생성하면 안됨)
426
- "dateFormats": [ // xAxis type이 'date'일 때 사용
427
- {
428
- "type": "day", // 날짜 단위: 'day' | 'week' | 'month' | 'year'
429
- "dateFormat": "MM/dd" // amCharts5에서 지원하는 날짜 형식
430
- }
431
- ],
511
+ // ⚠️ "dateFormats"는 넣지 말 것 — X축 날짜는 표기 표준이 기본 적용됨 (축: 분·시 HH:mm / 일 MM-dd / 월 yyyy-MM / 년 yyyy, 툴팁: yyyy-MM-dd(HH:mm) / yyyy-MM).
512
+ // dateFormats를 지정하면 축·기간변경·툴팁 포맷이 모두 그 값으로 덮어써져 표준이 깨짐 ('MM/dd' 같은 값 금지)
432
513
  "baseInterval": { // xAxis type이 'date'일 때 사용
433
514
  "timeUnit": "day", // 시간 단위: 'day' | 'week' | 'month' | 'year'
434
515
  "count": 1 // 간격 수(1로 고정이며 변경 불가)
@@ -486,15 +567,34 @@ export const StackChartSchema = z.object({
486
567
  "grouped": true // 그룹 표시 여부
487
568
  }
488
569
  },
570
+ "cursorOverStyle": "pointer", // 시리즈 위 마우스 커서 모양 (클릭 이벤트 사용 시 'pointer')
571
+ "templateField": "columnSettings", // chartData 각 행에서 행별 스타일(fill, fillOpacity, fillPattern, stroke, strokeWidth, strokeDasharray 등)을 읽어올 필드명
572
+ "colorByIndex": true, // 카테고리가 아니라 데이터 행 순서(인덱스)별로 색상을 다르게 적용 (기본값: false). 카테고리 1개짜리 차트에서 막대마다 색을 달리할 때
489
573
  "tooltip": { // 툴팁 설정(툴팁 설정시 body 설정 필수)
490
- "type": "CG", // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
574
+ "type": "CG", // 툴팁 타입: 'CI' | 'CG' | 'CI-Compare'
575
+ // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
576
+ // CI-Compare: 기간 비교 툴팁 — chartData 가 정확히 2행([0]=비교 기간, [1]=조회 기간)일 때 사용.
577
+ // 마우스를 올린 카테고리 하나에 대해 header(이름 + 증감 화살표·증감 값) 아래 body 2줄(조회 기간 / 비교 기간(빗금 마커))을 보여줌.
578
+ // header.value 문자열 안에 'up' | 'down' | 'even' 단어가 있으면 그 단어를 증감 화살표(up: ↑ 빨강 / down: ↓ 초록 / even: -)로 바꿔 그림.
579
+ // 예) "value": "{customValueTooltip['arrow']} {customValueTooltip['diffRatio']}%" — arrow 값은 chartUserDefinedFunc 에서 'up'/'down'/'even' 으로 반환
580
+ // '↑' 같은 글리프나 색상 마크업([#f00]...[/])·HTML 은 툴팁에서 색이 적용되지 않으므로 반드시 up/down/even 단어를 넘길 것
581
+ "withinArea": true, // 차트 영역 안에서만 툴팁 표시 (기본값: true). false 면 영역 밖(축 라벨 위 등)에서도 표시
582
+ "stopActionEnabled": false, // true 면 키를 누르고 있는 동안 툴팁이 고정되어 툴팁 안을 스크롤·클릭할 수 있음 (기본 키: Ctrl)
583
+ "stopActionKey": "alt", // 툴팁 고정 키를 Alt 로 변경 (생략 시 Ctrl)
584
+ "position": { // 툴팁 위치 설정
585
+ "topFixed": true, // 툴팁을 차트 상단에 고정
586
+ "criteria": "right", // 툴팁을 띄울 방향 고정: 'left' | 'right' (생략 시 공간에 따라 자동)
587
+ "tailDirection": "bottom" // 툴팁 꼬리 방향: 'bottom' (생략 시 기본)
588
+ },
491
589
  "header": { // 툴팁 헤더 설정
492
590
  "name": "{valueX.formatDate('MM/dd')}" // 툴팁 헤더 이름, 사용 예) {valueX.formatDate("MM/dd")}
493
591
  },
494
592
  "body": { // 툴팁 바디 설정
495
593
  "name": "{name}", // 툴팁 바디 이름, 사용 예) {name}
496
594
  "value": "{valueY.formatNumber('0.00')}", // 툴팁 바디 값, 사용 예) {valueY.formatNumber("0.00")}
497
- "useMarker": true // 툴팁 바디 마커 사용 여부
595
+ "useMarker": true, // 툴팁 바디 마커 사용 여부
596
+ "maxRowCount": 10, // 바디 최대 행 수 — 넘으면 툴팁 안에서 스크롤 (stopActionEnabled 와 함께 사용)
597
+ "nameTruncated": { "enabled": true, "maxLength": 20 } // 이름이 maxLength(기본 20)자를 넘으면 "..." 로 말줄임. header/footer 에도 같은 형태로 지정 가능
498
598
  },
499
599
  "footer": { // 툴팁 푸터 설정
500
600
  "name": "Total", // 툴팁 푸터 이름, 사용 예) Total
@@ -526,7 +626,9 @@ export const StackChartSchema = z.object({
526
626
  "useOthersCount": true, // 기타 항목에 포함된 개수 표시 여부 (기본값: true)
527
627
  "showViewDetails": false, // View Details 버튼 표시 여부 (기본값: false)
528
628
  "showViewDetailsBtn": true, // View Details 버튼 사용 여부 (기본값: true)
529
- "viewDetailsSize": "lg" // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
629
+ "viewDetailsSize": "lg", // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
630
+ "ascOrder": false, // true 면 값이 작은 순으로 Top N 선정 (기본값: false = 큰 순)
631
+ "othersDisabled": false // true 면 Others(기타) 항목을 만들지 않고 Top N 만 표시 (기본값: false)
530
632
  },
531
633
  "animation": { // 애니메이션 설정
532
634
  "duration": 2000, // 애니메이션 지속 시간
@@ -534,10 +636,38 @@ export const StackChartSchema = z.object({
534
636
  }
535
637
  },
536
638
 
639
+ // 커서 설정 (선택)
640
+ "cursor": {
641
+ "visibleX": true, // X축 커서(세로 가이드선) 표시 여부 (기본값: true)
642
+ "visibleY": false, // Y축 커서(가로 가이드선) 표시 여부
643
+ "behavior": "none" // 마우스 드래그 동작: 'none'(기본) | 'zoomX' | 'zoomY' | 'zoomXY' | 'selectX' | 'selectY'
644
+ },
645
+
537
646
  // 범례 설정
538
647
  "legend": {
539
648
  "clickTarget": "none", // 범례 클릭 대상: "none" | "" (기본값: "none")
540
- "useExtension": true // 범례 확장 사용 여부 (기본값: true — 끄려면 false). 켜져 있으면 범례 전체 선택 체크박스 사용 가능
649
+ "useExtension": false, // 범례 확장 사용 여부 (기본값: false — true를 명시해야 켜짐). 켜면 범례 펼치기/접기 + 전체 선택 체크박스 사용 가능. 범례가 많아 접어야 할 때만 true
650
+ "maxRow": 3, // 범례 최대 줄 수 (기본값: 3). 넘치면 범례 영역 안에서 세로 스크롤 / useExtension 사용 시 접힌 상태의 줄 수
651
+ "useExpanding": true, // useExtension 사용 시 펼치기/접기 버튼 사용 여부 (기본값: true)
652
+ "focusItem": true, // 범례 항목에 마우스를 올리면 해당 시리즈만 강조하고 나머지는 흐리게 (기본값: false)
653
+ "useDefaultMarker": true, // 범례 마커를 기본 사각형으로 표시 (기본값: true). false 면 시리즈 모양(라인·불릿 등)을 따름
654
+ "minWidth": 100, // 범례 영역 최소 너비 (px)
655
+ "maxWidth": 300, // 범례 영역 최대 너비 (px)
656
+ "cursorOverStyle": "pointer", // 범례 위 마우스 커서 모양
657
+ "label": { // 범례 라벨 설정
658
+ "maxWidth": 150, // 라벨 최대 너비 (px)
659
+ "oversizedBehavior": "truncate" // 최대 너비 초과 시: 'truncate'(말줄임) | 'wrap' | 'none'
660
+ },
661
+ "verticalLegend": { // 세로 범례 (차트 옆에 항목을 세로로 나열 + 항목별 값 표시). 지정하면 세로 범례로 전환
662
+ "itemHeight": 40, // 항목 높이 (px, 기본값: 50)
663
+ "tooltipDirection": "right", // 범례 항목 툴팁이 뜨는 방향: 'left' | 'right'
664
+ "legendTitle": ["AWS", "GCP"], // 범례 이름 앞머리가 이 값들 중 하나로 시작하면 그 부분을 회색 제목 줄로 분리해 표시
665
+ "valueLabel": { // 항목 오른쪽 값 라벨
666
+ "textAlign": "right", // 정렬
667
+ "fontSize": 11, // 폰트 크기
668
+ "text": "{customValueTooltip['arrow']} {customValueTooltip['diffRatio']}%" // 값 텍스트 (chartUserDefinedFunc 결과 참조 가능). 텍스트 안의 'up'/'down'/'even' 단어는 증감 화살표(↑ 빨강 / ↓ 초록 / ─)로 바뀜. 생략 시 값의 퍼센트 표시
669
+ }
670
+ }
541
671
  }
542
672
  }
543
673
  `),
@@ -739,6 +869,7 @@ export const StackChartSchema = z.object({
739
869
  .optional()
740
870
  .describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
741
871
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
872
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
742
873
  });
743
874
  // opsnow-common-bar-chart
744
875
  export const BarChartSchema = z.object({
@@ -760,12 +891,8 @@ export const BarChartSchema = z.object({
760
891
  "xAxis": {
761
892
  "type": "date", // 축 타입: 'date' | 'value' | 'category' (바형 차트일 경우는 value 사용)
762
893
  "valueField": "date", // X축 값 필드 (컬럼형 차트일 경우 필수, 바형 차트일 경우 절대 생성하면 안됨)
763
- "dateFormats": [ // xAxis type이 'date'일 때 사용
764
- {
765
- "type": "day", // 날짜 단위: 'day' | 'week' | 'month' | 'year'
766
- "dateFormat": "MM/dd" // amCharts5에서 지원하는 날짜 형식
767
- }
768
- ],
894
+ // ⚠️ "dateFormats"는 넣지 말 것 — X축 날짜는 표기 표준이 기본 적용됨 (축: 분·시 HH:mm / 일 MM-dd / 월 yyyy-MM / 년 yyyy, 툴팁: yyyy-MM-dd(HH:mm) / yyyy-MM).
895
+ // dateFormats를 지정하면 축·기간변경·툴팁 포맷이 모두 그 값으로 덮어써져 표준이 깨짐 ('MM/dd' 같은 값 금지)
769
896
  "baseInterval": { // xAxis type이 'date'일 때 사용
770
897
  "timeUnit": "day", // 시간 단위: 'day' | 'week' | 'month' | 'year'
771
898
  "count": 1 // 간격 수(1로 고정이며 변경 불가)
@@ -821,17 +948,35 @@ export const BarChartSchema = z.object({
821
948
  "hover": { // 호버 설정
822
949
  "enabled": true, // 호버 표시 여부
823
950
  "grouped": true // 그룹 표시 여부
951
+ },
952
+ "click": { // 클릭한 막대 강조 (선택) — 클릭한 막대만 clickColor, 나머지는 unClickColor 로 칠함. 카테고리가 1개인 차트에서 사용
953
+ "clickColor": "#086CE8", // 선택된 막대 색상
954
+ "unClickColor": "#B0B6BD", // 선택되지 않은 막대 색상
955
+ "defaultPosition": "end" // 처음에 선택 상태로 둘 막대: "end" = 마지막 막대, 생략 시 첫 번째 막대
824
956
  }
825
957
  },
958
+ "cursorOverStyle": "pointer", // 시리즈 위 마우스 커서 모양 (클릭 이벤트 사용 시 'pointer')
959
+ "templateField": "columnSettings", // chartData 각 행에서 행별 스타일(fill, fillOpacity, fillPattern, stroke, strokeWidth, strokeDasharray 등)을 읽어올 필드명
960
+ "colorByIndex": true, // 카테고리가 아니라 데이터 행 순서(인덱스)별로 색상을 다르게 적용 (기본값: false). 카테고리 1개짜리 차트에서 막대마다 색을 달리할 때
826
961
  "tooltip": { // 툴팁 설정(툴팁 설정시 body 설정 필수)
827
962
  "type": "CI", // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
963
+ "withinArea": true, // 차트 영역 안에서만 툴팁 표시 (기본값: true). false 면 영역 밖(축 라벨 위 등)에서도 표시
964
+ "stopActionEnabled": false, // true 면 키를 누르고 있는 동안 툴팁이 고정되어 툴팁 안을 스크롤·클릭할 수 있음 (기본 키: Ctrl)
965
+ "stopActionKey": "alt", // 툴팁 고정 키를 Alt 로 변경 (생략 시 Ctrl)
966
+ "position": { // 툴팁 위치 설정
967
+ "topFixed": true, // 툴팁을 차트 상단에 고정
968
+ "criteria": "right", // 툴팁을 띄울 방향 고정: 'left' | 'right' (생략 시 공간에 따라 자동)
969
+ "tailDirection": "bottom" // 툴팁 꼬리 방향: 'bottom' (생략 시 기본)
970
+ },
828
971
  "header": { // 툴팁 헤더 설정
829
972
  "name": "{valueX.formatDate('MM/dd')}" // 툴팁 헤더 이름, 사용 예) {valueX.formatDate("MM/dd")}
830
973
  },
831
974
  "body": { // 툴팁 바디 설정
832
975
  "name": "{name}", // 툴팁 바디 이름, 사용 예) {name}
833
976
  "value": "{valueY.formatNumber('0.00')}", // 툴팁 바디 값, 사용 예) {valueY.formatNumber("0.00")}
834
- "useMarker": true // 툴팁 바디 마커 사용 여부
977
+ "useMarker": true, // 툴팁 바디 마커 사용 여부
978
+ "maxRowCount": 10, // 바디 최대 행 수 — 넘으면 툴팁 안에서 스크롤 (stopActionEnabled 와 함께 사용)
979
+ "nameTruncated": { "enabled": true, "maxLength": 20 } // 이름이 maxLength(기본 20)자를 넘으면 "..." 로 말줄임. header/footer 에도 같은 형태로 지정 가능
835
980
  },
836
981
  "footer": { // 툴팁 푸터 설정
837
982
  "name": "Total", // 툴팁 푸터 이름, 사용 예) Total
@@ -863,7 +1008,9 @@ export const BarChartSchema = z.object({
863
1008
  "useOthersCount": true, // 기타 항목에 포함된 개수 표시 여부 (기본값: true)
864
1009
  "showViewDetails": false, // View Details 버튼 표시 여부 (기본값: false)
865
1010
  "showViewDetailsBtn": true, // View Details 버튼 사용 여부 (기본값: true)
866
- "viewDetailsSize": "lg" // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
1011
+ "viewDetailsSize": "lg", // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
1012
+ "ascOrder": false, // true 면 값이 작은 순으로 Top N 선정 (기본값: false = 큰 순)
1013
+ "othersDisabled": false // true 면 Others(기타) 항목을 만들지 않고 Top N 만 표시 (기본값: false)
867
1014
  },
868
1015
  "animation": { // 애니메이션 설정
869
1016
  "duration": 2000, // 애니메이션 지속 시간
@@ -871,10 +1018,52 @@ export const BarChartSchema = z.object({
871
1018
  }
872
1019
  },
873
1020
 
1021
+ // 기준선(축 범위선) 설정 (선택) — 목표값·예산선 등을 축에 가로/세로 선으로 표시
1022
+ "axisRanges": [
1023
+ {
1024
+ "value": 1.5, // 선을 그을 축 값
1025
+ "target": "Y", // 대상 축: 'X' | 'Y' (생략 시 Y축)
1026
+ "color": "#c1222e", // 선·라벨 색상
1027
+ "text": "{value.formatNumber('0,0.00')}", // 선 끝에 표시할 라벨 텍스트
1028
+ "lineStyle": "dot", // 선 스타일: 'dot'(점선). 생략 시 실선
1029
+ "location": 1, // 라벨 위치 (0~1, 1 = 축 끝쪽)
1030
+ "above": true, // 시리즈 위에 그릴지 여부
1031
+ "background": { "fill": "#c1222e" } // 라벨 배경색
1032
+ }
1033
+ ],
1034
+
1035
+ // 커서 설정 (선택)
1036
+ "cursor": {
1037
+ "visibleX": true, // X축 커서(세로 가이드선) 표시 여부 (기본값: true)
1038
+ "visibleY": false, // Y축 커서(가로 가이드선) 표시 여부
1039
+ "behavior": "none" // 마우스 드래그 동작: 'none'(기본) | 'zoomX' | 'zoomY' | 'zoomXY' | 'selectX' | 'selectY'
1040
+ },
1041
+
874
1042
  // 범례 설정
875
1043
  "legend": {
876
1044
  "clickTarget": "none", // 범례 클릭 대상: "none" | "" (기본값: "none")
877
- "useExtension": true // 범례 확장 사용 여부 (기본값: true — 끄려면 false). 켜져 있으면 범례 전체 선택 체크박스 사용 가능
1045
+ "useExtension": false, // 범례 확장 사용 여부 (기본값: false — true를 명시해야 켜짐). 켜면 범례 펼치기/접기 + 전체 선택 체크박스 사용 가능. 범례가 많아 접어야 할 때만 true
1046
+ "maxRow": 3, // 범례 최대 줄 수 (기본값: 3). 넘치면 범례 영역 안에서 세로 스크롤 / useExtension 사용 시 접힌 상태의 줄 수
1047
+ "useExpanding": true, // useExtension 사용 시 펼치기/접기 버튼 사용 여부 (기본값: true)
1048
+ "focusItem": true, // 범례 항목에 마우스를 올리면 해당 시리즈만 강조하고 나머지는 흐리게 (기본값: false)
1049
+ "useDefaultMarker": true, // 범례 마커를 기본 사각형으로 표시 (기본값: true). false 면 시리즈 모양(라인·불릿 등)을 따름
1050
+ "minWidth": 100, // 범례 영역 최소 너비 (px)
1051
+ "maxWidth": 300, // 범례 영역 최대 너비 (px)
1052
+ "cursorOverStyle": "pointer", // 범례 위 마우스 커서 모양
1053
+ "label": { // 범례 라벨 설정
1054
+ "maxWidth": 150, // 라벨 최대 너비 (px)
1055
+ "oversizedBehavior": "truncate" // 최대 너비 초과 시: 'truncate'(말줄임) | 'wrap' | 'none'
1056
+ },
1057
+ "verticalLegend": { // 세로 범례 (차트 옆에 항목을 세로로 나열 + 항목별 값 표시). 지정하면 세로 범례로 전환
1058
+ "itemHeight": 40, // 항목 높이 (px, 기본값: 50)
1059
+ "tooltipDirection": "right", // 범례 항목 툴팁이 뜨는 방향: 'left' | 'right'
1060
+ "legendTitle": ["AWS", "GCP"], // 범례 이름 앞머리가 이 값들 중 하나로 시작하면 그 부분을 회색 제목 줄로 분리해 표시
1061
+ "valueLabel": { // 항목 오른쪽 값 라벨
1062
+ "textAlign": "right", // 정렬
1063
+ "fontSize": 11, // 폰트 크기
1064
+ "text": "{customValueTooltip['arrow']} {customValueTooltip['diffRatio']}%" // 값 텍스트 (chartUserDefinedFunc 결과 참조 가능). 텍스트 안의 'up'/'down'/'even' 단어는 증감 화살표(↑ 빨강 / ↓ 초록 / ─)로 바뀜. 생략 시 값의 퍼센트 표시
1065
+ }
1066
+ }
878
1067
  }
879
1068
  }
880
1069
  `),
@@ -1068,6 +1257,7 @@ export const BarChartSchema = z.object({
1068
1257
  .optional()
1069
1258
  .describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
1070
1259
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
1260
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1071
1261
  });
1072
1262
  // opsnow-common-line-chart
1073
1263
  export const LineChartSchema = z.object({
@@ -1089,12 +1279,8 @@ export const LineChartSchema = z.object({
1089
1279
  "xAxis": {
1090
1280
  "type": "category", // 축 타입: 'date' | 'value' | 'category'
1091
1281
  "valueField": "date", // X축 값 필드
1092
- "dateFormats": [ // xAxis type이 'date'일 때 사용
1093
- {
1094
- "type": "day", // 날짜 단위: 'day' | 'week' | 'month' | 'year'
1095
- "dateFormat": "MM/dd" // amCharts5에서 지원하는 날짜 형식
1096
- }
1097
- ],
1282
+ // ⚠️ "dateFormats"는 넣지 말 것 — X축 날짜는 표기 표준이 기본 적용됨 (축: 분·시 HH:mm / 일 MM-dd / 월 yyyy-MM / 년 yyyy, 툴팁: yyyy-MM-dd(HH:mm) / yyyy-MM).
1283
+ // dateFormats를 지정하면 축·기간변경·툴팁 포맷이 모두 그 값으로 덮어써져 표준이 깨짐 ('MM/dd' 같은 값 금지)
1098
1284
  "baseInterval": { // xAxis type이 'date'일 때 사용
1099
1285
  "timeUnit": "day", // 시간 단위: 'day' | 'week' | 'month' | 'year'
1100
1286
  "count": 1 // 간격 수(1로 고정이며 변경 불가)
@@ -1172,20 +1358,34 @@ export const LineChartSchema = z.object({
1172
1358
  }
1173
1359
  }
1174
1360
  },
1361
+ "cursorOverStyle": "pointer", // 시리즈 위 마우스 커서 모양 (클릭 이벤트 사용 시 'pointer')
1362
+ "templateField": "columnSettings", // chartData 각 행에서 행별 스타일(fill, fillOpacity, fillPattern, stroke, strokeWidth, strokeDasharray 등)을 읽어올 필드명
1363
+ "colorByIndex": true, // 카테고리가 아니라 데이터 행 순서(인덱스)별로 색상을 다르게 적용 (기본값: false). 카테고리 1개짜리 차트에서 막대마다 색을 달리할 때
1175
1364
  "tooltip": { // 툴팁 설정(툴팁 설정시 body 설정 필수)
1176
1365
  "type": "CG", // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
1366
+ "withinArea": true, // 차트 영역 안에서만 툴팁 표시 (기본값: true). false 면 영역 밖(축 라벨 위 등)에서도 표시
1367
+ "stopActionEnabled": false, // true 면 키를 누르고 있는 동안 툴팁이 고정되어 툴팁 안을 스크롤·클릭할 수 있음 (기본 키: Ctrl)
1368
+ "stopActionKey": "alt", // 툴팁 고정 키를 Alt 로 변경 (생략 시 Ctrl)
1369
+ "position": { // 툴팁 위치 설정
1370
+ "topFixed": true, // 툴팁을 차트 상단에 고정
1371
+ "criteria": "right", // 툴팁을 띄울 방향 고정: 'left' | 'right' (생략 시 공간에 따라 자동)
1372
+ "tailDirection": "bottom" // 툴팁 꼬리 방향: 'bottom' (생략 시 기본)
1373
+ },
1177
1374
  "header": { // 툴팁 헤더 설정
1178
1375
  "name": "{valueX.formatDate('MM/dd')}" // 툴팁 헤더 이름, 사용 예) {valueX.formatDate("MM/dd")}
1179
1376
  },
1180
1377
  "body": { // 툴팁 바디 설정
1181
1378
  "name": "{name}", // 툴팁 바디 이름, 사용 예) {name}
1182
1379
  "value": "{valueY.formatNumber('0.00')}", // 툴팁 바디 값, 사용 예) {valueY.formatNumber("0.00")}
1183
- "useMarker": true // 툴팁 바디 마커 사용 여부
1380
+ "useMarker": true, // 툴팁 바디 마커 사용 여부
1381
+ "maxRowCount": 10, // 바디 최대 행 수 — 넘으면 툴팁 안에서 스크롤 (stopActionEnabled 와 함께 사용)
1382
+ "nameTruncated": { "enabled": true, "maxLength": 20 } // 이름이 maxLength(기본 20)자를 넘으면 "..." 로 말줄임. header/footer 에도 같은 형태로 지정 가능
1184
1383
  },
1185
1384
  "footer": { // 툴팁 푸터 설정
1186
1385
  "name": "Total", // 툴팁 푸터 이름, 사용 예) Total
1187
1386
  "value": "{valueYSum.formatNumber('0.00')}" // 툴팁 푸터 값, 사용 예) {valueYSum.formatNumber("0.00")}
1188
1387
  },
1388
+ "excludedCategories": ["MIN", "MAX"], // 툴팁에서 제외할 카테고리 목록 (예: Range Area 의 min/max 보조 시리즈)
1189
1389
  "sort": "byName" // 툴팁 정렬 방향: 'byName' | 'reverse'
1190
1390
  },
1191
1391
  "topNOthers": { // Top N + Others 옵션
@@ -1194,7 +1394,9 @@ export const LineChartSchema = z.object({
1194
1394
  "useOthersCount": true, // 기타 항목에 포함된 개수 표시 여부 (기본값: true)
1195
1395
  "showViewDetails": false, // View Details 버튼 표시 여부 (기본값: false)
1196
1396
  "showViewDetailsBtn": true, // View Details 버튼 사용 여부 (기본값: true)
1197
- "viewDetailsSize": "lg" // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
1397
+ "viewDetailsSize": "lg", // View Details 모달 크기: 'sm' | 'md' | 'lg' (기본값: 'lg')
1398
+ "ascOrder": false, // true 면 값이 작은 순으로 Top N 선정 (기본값: false = 큰 순)
1399
+ "othersDisabled": false // true 면 Others(기타) 항목을 만들지 않고 Top N 만 표시 (기본값: false)
1198
1400
  },
1199
1401
  "animation": { // 애니메이션 설정
1200
1402
  "duration": 2000, // 애니메이션 지속 시간
@@ -1202,10 +1404,38 @@ export const LineChartSchema = z.object({
1202
1404
  }
1203
1405
  },
1204
1406
 
1407
+ // 커서 설정 (선택)
1408
+ "cursor": {
1409
+ "visibleX": true, // X축 커서(세로 가이드선) 표시 여부 (기본값: true)
1410
+ "visibleY": false, // Y축 커서(가로 가이드선) 표시 여부
1411
+ "behavior": "none" // 마우스 드래그 동작: 'none'(기본) | 'zoomX' | 'zoomY' | 'zoomXY' | 'selectX' | 'selectY'
1412
+ },
1413
+
1205
1414
  // 범례 설정
1206
1415
  "legend": {
1207
1416
  "clickTarget": "none", // 범례 클릭 대상: "none" | "" (기본값: "none")
1208
- "useExtension": true // 범례 확장 사용 여부 (기본값: true — 끄려면 false). 켜져 있으면 범례 전체 선택 체크박스 사용 가능
1417
+ "useExtension": false, // 범례 확장 사용 여부 (기본값: false — true를 명시해야 켜짐). 켜면 범례 펼치기/접기 + 전체 선택 체크박스 사용 가능. 범례가 많아 접어야 할 때만 true
1418
+ "maxRow": 3, // 범례 최대 줄 수 (기본값: 3). 넘치면 범례 영역 안에서 세로 스크롤 / useExtension 사용 시 접힌 상태의 줄 수
1419
+ "useExpanding": true, // useExtension 사용 시 펼치기/접기 버튼 사용 여부 (기본값: true)
1420
+ "focusItem": true, // 범례 항목에 마우스를 올리면 해당 시리즈만 강조하고 나머지는 흐리게 (기본값: false)
1421
+ "useDefaultMarker": true, // 범례 마커를 기본 사각형으로 표시 (기본값: true). false 면 시리즈 모양(라인·불릿 등)을 따름
1422
+ "minWidth": 100, // 범례 영역 최소 너비 (px)
1423
+ "maxWidth": 300, // 범례 영역 최대 너비 (px)
1424
+ "cursorOverStyle": "pointer", // 범례 위 마우스 커서 모양
1425
+ "label": { // 범례 라벨 설정
1426
+ "maxWidth": 150, // 라벨 최대 너비 (px)
1427
+ "oversizedBehavior": "truncate" // 최대 너비 초과 시: 'truncate'(말줄임) | 'wrap' | 'none'
1428
+ },
1429
+ "verticalLegend": { // 세로 범례 (차트 옆에 항목을 세로로 나열 + 항목별 값 표시). 지정하면 세로 범례로 전환
1430
+ "itemHeight": 40, // 항목 높이 (px, 기본값: 50)
1431
+ "tooltipDirection": "right", // 범례 항목 툴팁이 뜨는 방향: 'left' | 'right'
1432
+ "legendTitle": ["AWS", "GCP"], // 범례 이름 앞머리가 이 값들 중 하나로 시작하면 그 부분을 회색 제목 줄로 분리해 표시
1433
+ "valueLabel": { // 항목 오른쪽 값 라벨
1434
+ "textAlign": "right", // 정렬
1435
+ "fontSize": 11, // 폰트 크기
1436
+ "text": "{customValueTooltip['arrow']} {customValueTooltip['diffRatio']}%" // 값 텍스트 (chartUserDefinedFunc 결과 참조 가능). 텍스트 안의 'up'/'down'/'even' 단어는 증감 화살표(↑ 빨강 / ↓ 초록 / ─)로 바뀜. 생략 시 값의 퍼센트 표시
1437
+ }
1438
+ }
1209
1439
  }
1210
1440
  }
1211
1441
  `),
@@ -1384,6 +1614,7 @@ export const LineChartSchema = z.object({
1384
1614
  .optional()
1385
1615
  .describe("OpsNow US 기본(basic) 색상 팔레트 사용 여부 (boolean, 기본값 true). false면 mix 팔레트를 사용합니다. chartCategoryColorByVendor가 지정되면 그 설정이 우선합니다."),
1386
1616
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
1617
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1387
1618
  chartNoRowsText: z.string().optional().describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
1388
1619
  });
1389
1620
  // opsnow-common-pie-chart
@@ -1396,7 +1627,14 @@ export const PieChartSchema = z.object({
1396
1627
  // 차트 기본 설정
1397
1628
  "chart": {
1398
1629
  "innerRadius": "p62", // 내부 반지름 (퍼센트 값을 문자열로 표시: 예) 20% -> 'p20', 30% -> 'p30', ...)
1399
- "layout": "horizontal" // 레이아웃: 'horizontal' | 'vertical'
1630
+ "layout": "horizontal", // 레이아웃: 'horizontal' | 'vertical'
1631
+ "radius": "p80", // 바깥 반지름 (innerRadius 와 같은 형식: 80% -> 'p80')
1632
+ "startAngle": 180, // 시작 각도 (반원 파이 등: startAngle 180, endAngle 360)
1633
+ "endAngle": 360, // 끝 각도
1634
+ "paddingTop": 0, // 상단 패딩 (px). paddingBottom / paddingLeft / paddingRight 도 동일
1635
+ "paddingBottom": 0,
1636
+ "paddingLeft": 0,
1637
+ "paddingRight": 0
1400
1638
  },
1401
1639
 
1402
1640
  // 라벨 설정
@@ -1410,6 +1648,8 @@ export const PieChartSchema = z.object({
1410
1648
  "series": {
1411
1649
  "valueField": "cost", // 값 필드명
1412
1650
  "categoryField": "ratioName", // 카테고리 필드명
1651
+ "cursorOverStyle": "pointer", // 조각 위 마우스 커서 모양 (클릭 이벤트 사용 시 'pointer')
1652
+ "legendValueText": "{valuePercentTotal.formatNumber('0.00p')}", // 범례 값 라벨 텍스트 포맷 (기본값: 비율 %). 예) 금액+비율: "{value.formatNumber('#,###.00')} ({valuePercentTotal.formatNumber('0.00p')})"
1413
1653
  "tooltip": { // 툴팁 설정(툴팁 설정시 body 설정 필수)
1414
1654
  "type": "CI", // CI: 각 카테고리를 보여줄때 | CG: 모든 카테고리를 보여줄때
1415
1655
  "position": { // 툴팁 위치 설정
@@ -1430,6 +1670,8 @@ export const PieChartSchema = z.object({
1430
1670
  // 범례 설정
1431
1671
  "legend": {
1432
1672
  "layout": "vertical", // 범례 레이아웃: 'horizontal' | 'vertical'
1673
+ "height": "p100", // 범례 영역 높이 (퍼센트 문자열: 100% -> 'p100', 숫자면 px)
1674
+ "maxHeight": "p80", // 범례 영역 최대 높이 — 넘으면 범례 안에서 스크롤 (Legend Scroll)
1433
1675
  "valueLabel": { // 값 라벨 설정
1434
1676
  "textAlign": "right", // 텍스트 정렬
1435
1677
  "fontSize": 11 // 폰트 크기
@@ -1521,6 +1763,7 @@ export const PieChartSchema = z.object({
1521
1763
  ]`),
1522
1764
  useOpsnowUs: z.boolean().optional().describe("OpsNow US 기본(basic) 색상 팔레트 사용 여부 (boolean, 기본값 true). false면 mix 팔레트를 사용합니다. chartCategoryColorByVendor가 지정되면 그 설정이 우선합니다."),
1523
1765
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
1766
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1524
1767
  chartNoRowsText: z.string().optional().describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
1525
1768
  chartLocaleMessage: z.array(z.object({
1526
1769
  name: z.string().describe("차트에서 사용하는 필드의 값 전체 또는 일부"),
@@ -1619,6 +1862,7 @@ export const GaugeChartSchema = z.object({
1619
1862
  { name: '사용량', locale: $t('usage') }
1620
1863
  ]`),
1621
1864
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
1865
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1622
1866
  });
1623
1867
  // opsnow-common-heatmap-chart
1624
1868
  export const HeatmapChartSchema = z.object({
@@ -1782,6 +2026,7 @@ export const HeatmapChartSchema = z.object({
1782
2026
  ]`),
1783
2027
  langCd: z.enum(['ko', 'en', 'ja', 'zh', 'ar']).optional().describe("언어 코드"),
1784
2028
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부"),
2029
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1785
2030
  onChartClick: z.string().optional().describe('셀 클릭 시 호출되는 콜백 함수(stringified). 클릭 시 { xField, yField, valueField, from: "heatmap" } 객체를 전달합니다.'),
1786
2031
  // 샘플(스켈레톤) 차트 설정 — chartProps 없이 chartSample* 계열만 전달하면 실데이터 로딩 전 미리보기(스켈레톤) 차트가 렌더링됩니다.
1787
2032
  chartSampleProps: z.object({}).optional().describe("샘플(스켈레톤) 차트 속성 (object, 기본값 없음). chartProps와 동일한 구조의 JSON입니다. chartProps 없이 chartSampleProps만 전달하면 차트가 샘플(미리보기/스켈레톤) 모드로 렌더링됩니다."),
@@ -1815,6 +2060,10 @@ export const BubbleChartSchema = z.object({
1815
2060
 
1816
2061
  // X축 설정 (수치 축)
1817
2062
  "xAxis": {
2063
+ "min": 0, // 축 최소값 직접 지정
2064
+ "max": 100, // 축 최대값 직접 지정
2065
+ "strictMinMax": true, // min/max 를 엄격히 적용 (자동 보정 안 함)
2066
+ "renderer": { "minGridDistance": 40 }, // 격자선 최소 간격 (px)
1818
2067
  "gridHidden": false, // 격자선 숨김 여부
1819
2068
  "labelHidden": false, // 라벨 숨김 여부
1820
2069
  "extraMin": 0.1, // 축 최소쪽 여백 비율 (0~1) — bullet 이 가장자리에 잘리지 않도록 패딩
@@ -1824,6 +2073,10 @@ export const BubbleChartSchema = z.object({
1824
2073
 
1825
2074
  // Y축 설정 (수치 축)
1826
2075
  "yAxis": {
2076
+ "min": 0, // 축 최소값 직접 지정
2077
+ "max": 100, // 축 최대값 직접 지정
2078
+ "strictMinMax": true, // min/max 를 엄격히 적용 (자동 보정 안 함)
2079
+ "renderer": { "minGridDistance": 40 }, // 격자선 최소 간격 (px)
1827
2080
  "gridHidden": false,
1828
2081
  "labelHidden": false,
1829
2082
  "extraMin": 0.1,
@@ -1898,6 +2151,7 @@ export const BubbleChartSchema = z.object({
1898
2151
  locale: z.string()
1899
2152
  })).optional().describe("샘플 차트 데이터 다국어 적용 목록 (object[], 기본값 없음). chartLocaleData와 동일한 구조이며 샘플(스켈레톤) 모드에서 사용됩니다."),
1900
2153
  isDarkMode: z.boolean().optional().describe("다크 모드 활성화 여부 (boolean, 기본값 없음 — 미지정 시 MUI 테마의 palette.mode를 따릅니다)"),
2154
+ useSafeResolution: z.boolean().optional().describe("iOS 캔버스 메모리 제한 회피용 — true면 해상도 1(devicePixelRatio 무시)로 렌더링 (boolean, 기본값 false). iPhone/iPad 사파리에서 차트가 하얗게 비거나 깨질 때, 또는 한 화면에 차트가 많을 때 사용. 화질이 약간 흐려지므로 필요한 화면에만"),
1901
2155
  chartNoRowsText: z.string().optional().describe("차트 데이터가 없을 때 표시할 텍스트 (string, 기본값 없음)"),
1902
2156
  chartTooltipDetailText: z.string().optional().describe("툴팁에서 보여주는 상세 텍스트"),
1903
2157
  chartLocaleData: z.array(z.object({
@@ -1940,6 +2194,8 @@ export function createChartComponent() {
1940
2194
  props.push(`chartLocaleMessage={${JSON.stringify(args.chartLocaleMessage)}}`);
1941
2195
  if (args.isDarkMode !== undefined)
1942
2196
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2197
+ if (args.useSafeResolution !== undefined)
2198
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
1943
2199
  const code = `<OpsnowCommonGaugeChart ${props.join(' ')} />`;
1944
2200
  return {
1945
2201
  content: [
@@ -2002,6 +2258,8 @@ export function createChartComponent() {
2002
2258
  props.push(`chartUserDefinedFunc={${jsxExpr(args.chartUserDefinedFunc)}}`);
2003
2259
  if (args.isDarkMode !== undefined)
2004
2260
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2261
+ if (args.useSafeResolution !== undefined)
2262
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2005
2263
  if (args.chartNoRowsText)
2006
2264
  props.push(`chartNoRowsText="${args.chartNoRowsText}"`);
2007
2265
  if (args.chartLocaleMessage)
@@ -2089,6 +2347,8 @@ export function createChartComponent() {
2089
2347
  props.push(`langCd="${args.langCd}"`);
2090
2348
  if (args.isDarkMode !== undefined)
2091
2349
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2350
+ if (args.useSafeResolution !== undefined)
2351
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2092
2352
  if (args.chartNoRowsText)
2093
2353
  props.push(`chartNoRowsText="${args.chartNoRowsText}"`);
2094
2354
  const code = `<OpsnowCommonLineChart ${props.join(' ')} />`;
@@ -2177,6 +2437,8 @@ export function createChartComponent() {
2177
2437
  props.push(`onTopNPopupDetailClick={${jsxExpr(args.onTopNPopupDetailClick)}}`);
2178
2438
  if (args.isDarkMode !== undefined)
2179
2439
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2440
+ if (args.useSafeResolution !== undefined)
2441
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2180
2442
  const code = `<OpsnowCommonBarChart ${props.join(' ')} />`;
2181
2443
  return {
2182
2444
  content: [
@@ -2264,6 +2526,8 @@ export function createChartComponent() {
2264
2526
  props.push(`onTopNPopupDetailClick={${jsxExpr(args.onTopNPopupDetailClick)}}`);
2265
2527
  if (args.isDarkMode !== undefined)
2266
2528
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2529
+ if (args.useSafeResolution !== undefined)
2530
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2267
2531
  const code = `<OpsnowCommonStackChart ${props.join(' ')} />`;
2268
2532
  return {
2269
2533
  content: [
@@ -2354,6 +2618,8 @@ export function createChartComponent() {
2354
2618
  props.push(`chartFoldLegend="${args.chartFoldLegend}"`);
2355
2619
  if (args.isDarkMode !== undefined)
2356
2620
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2621
+ if (args.useSafeResolution !== undefined)
2622
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2357
2623
  const code = `<OpsnowCommonXyMultiChart ${props.join(' ')} />`;
2358
2624
  return {
2359
2625
  content: [
@@ -2401,6 +2667,8 @@ export function createChartComponent() {
2401
2667
  props.push(`langCd="${args.langCd}"`);
2402
2668
  if (args.isDarkMode !== undefined)
2403
2669
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2670
+ if (args.useSafeResolution !== undefined)
2671
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2404
2672
  if (args.onChartClick)
2405
2673
  props.push(`onChartClick={${jsxExpr(args.onChartClick)}}`);
2406
2674
  if (args.chartSampleProps)
@@ -2472,6 +2740,8 @@ export function createChartComponent() {
2472
2740
  props.push(`chartSampleLocaleData={${jsxExpr(args.chartSampleLocaleData)}}`);
2473
2741
  if (args.isDarkMode !== undefined)
2474
2742
  props.push(`isDarkMode={${jsxExpr(args.isDarkMode)}}`);
2743
+ if (args.useSafeResolution !== undefined)
2744
+ props.push(`useSafeResolution={${jsxExpr(args.useSafeResolution)}}`);
2475
2745
  if (args.chartNoRowsText)
2476
2746
  props.push(`chartNoRowsText="${args.chartNoRowsText}"`);
2477
2747
  if (args.chartTooltipDetailText)