@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
|
@@ -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', '
|
|
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 =
|
|
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("
|
|
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'
|
|
Binary file
|
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.
|
|
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",
|