@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
@@ -16,20 +16,25 @@ const variantList = [
16
16
  // z.enum에 [string, ...string[]] 타입으로 변환
17
17
  const variantListForEnum = variantList;
18
18
  // 1. CommonPalette 색상 그룹과 단계 정의
19
+ // style 2.x 런타임 팔레트 기준 (pink 없음, gray만 0 단계 있음)
19
20
  const commonPaletteColors = [
20
- 'gray', 'darkblue', 'blue', 'skyblue', 'green', 'cyan', 'yellow', 'pink', 'purple', 'orange', 'red',
21
- // 필요시 etc. 추가
21
+ 'gray', 'darkblue', 'blue', 'skyblue', 'green', 'cyan', 'yellow', 'purple', 'orange', 'red',
22
22
  ];
23
23
  const commonPaletteDepths = [
24
- '100', '200', '300', '400', '500', '600', '700', '800', '900',
24
+ '50', '100', '200', '300', '400', '500', '600', '700', '800', '900',
25
25
  ];
26
+ const commonPaletteEtc = ['white', 'surface', 'shadow1', 'shadow2'];
26
27
  // 2. 모든 조합을 string literal union 타입으로 생성
27
- const commonPaletteList = commonPaletteColors.flatMap(color => commonPaletteDepths.map(depth => `commonPalette.${color}.${depth}`));
28
+ const commonPaletteList = [
29
+ 'commonPalette.gray.0',
30
+ ...commonPaletteColors.flatMap(color => commonPaletteDepths.map(depth => `commonPalette.${color}.${depth}`)),
31
+ ...commonPaletteEtc.map(key => `commonPalette.etc.${key}`),
32
+ ];
28
33
  const commonPaletteListForEnum = commonPaletteList;
29
34
  export const TypographySchema = z.object({
30
35
  text: z.string().describe("표시할 텍스트"),
31
36
  variant: z.enum(variantListForEnum).describe("타이포그래피 스타일(variant, e-r1~e-b13만 허용)"),
32
- color: z.enum(commonPaletteListForEnum).optional().describe("텍스트 색상 또는 CommonPalette 팔레트 값만 허용 (예: commonPalette.green.300)"),
37
+ color: z.enum(commonPaletteListForEnum).optional().describe("CommonPalette 팔레트 경로 (예: commonPalette.green.300, commonPalette.gray.0, commonPalette.etc.white)"),
33
38
  theme: z.enum([
34
39
  "primary", "secondary", "warning", "success", "error", "info", "description", "disabled"
35
40
  ]).optional().describe("테마 색상"),
@@ -53,6 +58,7 @@ export function createTypographyComponent() {
53
58
 
54
59
  - variant: e-r1~e-b13만 허용
55
60
  - 예제 테이블 스타일에 맞는 Typography만 생성 가능
61
+ - sx·className은 적용되지 않음 (내부에서 덮어씀) — 여백 등은 바깥 <Box sx={{ ... }}>로 감싸서 적용. 색·굵기·크기는 color·fontWeight·fontSize prop 사용
56
62
 
57
63
  \`\`\`javascript
58
64
  import { OpsnowCommonTypography } from '@opsnow-common/opsnow-common-style'
package/build/index.js CHANGED
@@ -57,6 +57,47 @@ import axios from 'axios';
57
57
  import { getAxios } from '@opsnow-common/opsnow-finops-common-axios';
58
58
  const response = await getAxios().get('/api/endpoint');
59
59
 
60
+ 공통 오류 팝업 (initializeCommonAxios가 기본 등록): 401·404·500·502·503·504 + network(응답 없이 끝난 요청 — 네트워크 끊김·타임아웃·CORS 헤더 없는 504 등, 요청 취소는 제외)에 공통 오류 팝업이 자동으로 뜹니다.
61
+ - 화면에서 같은 오류에 대해 별도 오류 팝업/토스트를 또 띄우지 마세요 (이중 표시). catch에서는 화면 상태(예: 그리드 status=ERROR)만 바꿉니다.
62
+ - userErrorHandlingCallbackObject를 넘기면 기본 콜백 전체가 대체됩니다(병합 아님) — 커스텀할 때는 network 키까지 포함하세요: { 401: fn, 500: fn, default: fn, network: fn }
63
+ - 재시도 대상 오류는 재시도가 모두 끝난 뒤 한 번만 콜백이 호출되고, 504·응답 없는 오류는 재시도하지 않습니다.
64
+
65
+ **앱 초기화 / 테마 (@opsnow-common/opsnow-finops-common-ui-loader)** — 새 앱 부트스트랩·테마 토글을 만들 때만 해당
66
+ - main.jsx (렌더 전 1회): initializeCommonAxios({ timeout, requestHeaders, retryTimeInterval, userErrorHandlingCallbackObject? }) — getAxios()는 이 호출 뒤에만 동작. 공통 오류 팝업도 여기서 등록됨
67
+ - initialize(routes, { useO360Keycloak, platformApiPrefix }) — 공통 라우트(404·Unauthorized) 등 공통 설정
68
+ - commonInitialize({ useGTM, gtmId, loginUser, useClarity, clarityId, ... }) — 로그인 사용자 확정 후 GTM·Clarity 등 분석 도구 초기화 (한 번만)
69
+ - 테마: <GlobalProvider themeName={currentTheme}> 에 THEME_NAMES.OPSNOW_COMMON_THEME | THEME_NAMES.OPSNOW_DARK_THEME 를 넘깁니다.
70
+ 테마는 쿠키(THEME_COOKIE_NAME='opsnowTheme', 상위 도메인)로 서브도메인 앱 간 동기화됩니다 — 로더가 import 시 쿠키→localStorage를 자동 화해하고 GlobalProvider가 themeName 변경 시 쿠키를 기록하므로 쿠키를 직접 쓰지 마세요.
71
+ 저장은 commonUILocalStorage.setItem(THEME_STORAGE_KEY, theme) (THEME_STORAGE_KEY='currentTheme'). 첫 렌더 전 복원은 localStorage 'opsnow-common-storage.currentTheme'(JSON 문자열)을 읽습니다.
72
+ - 컴포넌트 밖(유틸·상수)에서 현재 MUI 테마 객체가 필요하면 getCurrentTheme() — 컴포넌트 안에서는 useTheme()
73
+ - OpsnowCommonSelectItem · OpsnowCommonAutocompleteItem 은 컴포넌트가 아니라 items 원소 TS 타입입니다 (import type { OpsnowCommonSelectItem } from '@opsnow-common/opsnow-finops-common-ui-loader')
74
+
75
+ **CRITICAL: 날짜 표기 표준 — finOpsDateUtils 사용 (dayjs/moment/toLocaleString으로 직접 포맷 금지)**
76
+ 화면에 날짜·기간·일시·시간대를 표시할 때는 반드시 공통 utils의 표기 표준 함수를 씁니다 (@opsnow-common/opsnow-finops-common-utils ≥1.0.3 — package.json 확인).
77
+ DataGrid의 date 타입 컬럼·차트 X축은 이미 표준 포맷이 적용되므로 그 안에서는 쓰지 않습니다 (그리드 밖 텍스트·카드·필터 요약·파일명 등에 사용).
78
+
79
+ const { finOpsDateUtils } = useGlobalContext(); // import { useGlobalContext } from '@opsnow-common/opsnow-finops-common-ui-loader'
80
+
81
+ formatDate(v) → '2026-10-01' (값 없음/잘못된 값 → '-')
82
+ formatMonth(v) → '2026-10'
83
+ formatPeriod(start, end) → '2026-10-01 ~ 2026-10-07' (한쪽만 없으면 '- ~ 2026-10-13')
84
+ formatPeriod(start, end, { unit: 'month' }) → '2026-08 ~ 2026-10'
85
+ formatDateTime(v) → '2026-10-07 14:00 (UTC+9)' (시간대 기본 표시, 24시간제)
86
+ 옵션: seconds(초 표시) · inputUtc(입력값을 UTC로 해석 → 브라우저 시간대로 변환) · displayUtc(UTC로 표시) · showTimeZone(false면 시간대 생략)
87
+ getTimeZoneLabel() → '(UTC+9)' / getTimeZoneLabel({ displayUtc: true }) → '(UTC)' — 그리드 밖 표/카드 헤더에 시간대 한 번 표기
88
+ formatFileNameDate(v = 지금) → '20261016' — 다운로드 파일명 날짜
89
+
90
+ ⚠️ formatDateTime은 기본 inputUtc: false (입력값을 브라우저 시간으로 봄). 서버가 UTC로 주는 일시는 반드시 { inputUtc: true } — 그리드 date 컬럼(자동 UTC 해석)과 다르니 주의
91
+ ⚠️ 시간대를 표시했으면 같은 화면의 각 셀에는 showTimeZone: false로 생략하고 헤더에만 getTimeZoneLabel()을 붙입니다
92
+ ❌ 신규 코드 금지 (언어별로 포맷이 달라져 표기 표준 아님): getLocaleDate, getYyyyMmDdFormatDate, getLocaleNowDateForFileNameSuffix
93
+
94
+ **공통 헤더 (OpsnowFinopsCommonHeader, @opsnow-common/opsnow-finops-common-header)** — 앱 레이아웃에 헤더를 배치할 때만 해당
95
+ - noticeTypeLabels: 알림 팝업의 공지 타입 배지 라벨을 앱이 현재 언어로 번역해 주입합니다. 키는 noticeType 대문자:
96
+ noticeTypeLabels={{ NOTICE: '공지', RELEASE: '신규 소식', SERVICE_OUTAGE: '장애', EVENT: '이벤트', MAINTENANCE: '점검' }} // 실제로는 t('...') 결과
97
+ 주입하지 않은 키는 영어 기본값(Notice/Release/Service Outage/Event/Maintenance)으로 표시. 언어 전환 시 값도 바뀌도록 현재 locale 기준으로 넘기세요
98
+ - 공지 아이콘·팝업은 데스크톱 헤더에만 있습니다 (모바일 메뉴에는 공지 아이콘이 없음 — 모바일 전용 공지 진입점을 따로 만들지 마세요). 공지 자체를 끄려면 showNotice={false}
99
+ - 통화 전환은 헤더의 showCurrencySwitcher/currencySwitcherProps로 — getComponentSpec({ component: "CurrencySwitcher" }) 참고
100
+
60
101
  **CRITICAL: OpsnowCommonDataGrid Usage Rules**
61
102
 
62
103
  Before implementing OpsnowCommonDataGrid, you MUST use getUIExamples tool with 'DataGrid' parameter first!
@@ -112,10 +153,12 @@ Just like color tokens (theme.palette.commonPalette), all layout spacing uses th
112
153
  cardGap 16px - gap between elements inside a card
113
154
  cardPadding '16px 20px' - padding of a filter bar / card container
114
155
  pagePadding 24px - page content padding
156
+ minTouchTarget 44px - minimum size of touch targets (buttons/icons on mobile)
115
157
 
116
158
  Use theme in sx/styled: sx={theme => ({ gap: theme.commonSpacing.filterGap })} or sx={{ gap: theme => theme.commonSpacing.filterLabelGap }}.
117
159
  Pure CSS (no theme context): var(--opsnow-spacing-filter-gap), --opsnow-spacing-filter-label-gap, --opsnow-spacing-section-gap, --opsnow-spacing-card-gap, --opsnow-spacing-card-padding, --opsnow-spacing-page-padding, --opsnow-spacing-filter-row-gap.
118
160
  Outside theme context (constants/utils): import { commonSpacing } from '@opsnow-common/opsnow-common-style'; commonSpacing.filterGap // '24px'.
161
+ Responsive (@opsnow-common/opsnow-common-style): useOpsnowBreakpoint() → { isMobile(<900), isTablet(900~1199), isDesktop(≥1200), isTabletUp, device } only when the render tree differs; for style-only changes use theme.breakpoints.down('md') or the media-query strings mobileOnly / tabletUp / desktopUp inside sx/styled (no re-render). Constants: OPSNOW_BREAKPOINT_VALUES, OPSNOW_MOBILE_MAX_WIDTH (767.95 — current header/grid mobile boundary), OPSNOW_DESKTOP_MIN_WIDTH (1200), OPSNOW_MIN_TOUCH_TARGET (44).
119
162
  Found hardcoded px spacing? You MUST replace it: (1) use the token for that purpose → (2) if none fits, use theme.spacing(n) for generic multiples (base 4px → theme.spacing(2) = 8px) → (3) still nothing? DO NOT keep px — ask to add a new token in the style package (one row).
120
163
 
121
164
  --- Filter layout (Select/Autocomplete/DatePicker/DataGrid search area) ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opsnow-mcp/opsnow-mcp-common-ui-server",
3
- "version": "1.0.40",
3
+ "version": "1.0.42",
4
4
  "type": "module",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -12,6 +12,7 @@
12
12
  "scripts": {
13
13
  "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
14
14
  "build:skill": "npx tsx scripts/build-skill.ts",
15
+ "sync:icons": "npx tsx scripts/sync-icon-names.ts",
15
16
  "build:skill:clean": "rm -rf skills/plugins/opsnow-common-ui-skill/skills && npm run build:skill",
16
17
  "build:all": "npm run build && npm run build:skill",
17
18
  "start": "node --loader ts-node/esm src/index.ts",