@bluewardai/react-ui 0.0.0-stage → 0.2.0
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/CHANGELOG.md +80 -0
- package/LICENSE +21 -0
- package/NOTICE +8 -0
- package/README.md +70 -2
- package/dist/index.js +3269 -0
- package/dist/index.js.map +1 -0
- package/dist/styles.css +2 -0
- package/package.json +41 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
버전 번호 규칙: `주.부.수` (예: 0.1.0)
|
|
4
|
+
- 수(patch): 버그 수정
|
|
5
|
+
- 부(minor): 기능 추가 (기존 사용법은 그대로)
|
|
6
|
+
- 주(major): 기존 사용법이 바뀌는 변경
|
|
7
|
+
|
|
8
|
+
## 0.2.0 — 2026-11-20
|
|
9
|
+
|
|
10
|
+
디자인 개편: C안 "정돈" + Blueward 블루 (회사 소개 페이지 iACCOUNTING5와 같은 색 계열).
|
|
11
|
+
|
|
12
|
+
- 강조색을 파랑(#2563db)에서 Blueward 블루(#1f5fd1)로 변경, 진한 바탕은 네이비(#0b1f44), 옅은 강조 바탕은 하늘(#e6effc)
|
|
13
|
+
- 배경·테두리·글자 중립색도 푸른 기가 도는 회색으로 함께 조정 (선 #e4e9f3, 본문 #1f2937, 보조 글자 #52627d)
|
|
14
|
+
- 네이비 채움 버튼(`tone="neutral"`)도 소개 페이지 네이비와 같은 색
|
|
15
|
+
- 상태 색을 더 선명하게: 위험 빨강 #c2271c → #e02d3c, 완료 초록 #15803d → #11845b (흰 글자 대비 4.5 이상 유지). 배지 글자는 한 단계 진한 색을 써서 작은 글자도 잘 읽히게 함
|
|
16
|
+
- 모서리: 버튼·입력칸 10px, 카드 14px, 배지는 알약 모양, 체크박스 5px
|
|
17
|
+
- 입력칸 기본 높이 36px → 40px, 버튼 글자 굵기 600
|
|
18
|
+
- 글꼴 목록에서 `Pretendard Variable`을 먼저 찾도록 변경 (글꼴 파일은 사용하는 앱이 불러와야 함)
|
|
19
|
+
- 새 모양 토큰: `--radius-control`, `--radius-check`, `--radius-badge`, `--radius-card`, `--font-weight-control`, `--font-family-numeric`
|
|
20
|
+
- 기존 0.1.0을 쓰는 화면은 색과 크기가 달라진다(사용법은 같아서 부(minor) 버전으로 올림)
|
|
21
|
+
|
|
22
|
+
`Button` 스타일 확장
|
|
23
|
+
- 모양 `variant`: solid · soft · outline · ghost · link (5가지), 색 `tone`: brand · neutral · danger · success (4가지) → 20가지 조합
|
|
24
|
+
- 글자 뒤 아이콘 `iconEnd`, 누를 때 살짝 눌리는 효과
|
|
25
|
+
- 예전 이름(primary · secondary · danger · ghost)은 그대로 동작 (기본값 outline + neutral = 예전 secondary와 같음)
|
|
26
|
+
|
|
27
|
+
새 컴포넌트 `DataGrid` (1단계: 조회용)
|
|
28
|
+
- 행·열 가상화 (5만 행 × 100열에서 정렬 20~100ms, 필터 30ms, 검색 50~220ms, 합계 33열 약 110ms — 개발 PC 측정)
|
|
29
|
+
- 여러 줄 머리글(같은 윗줄 자동 병합), 왼쪽·오른쪽 틀고정, 합계 행 위쪽 고정(기본) / 아래
|
|
30
|
+
- 정렬(Shift+클릭 다중), 머리글 필터(값 목록·숫자/날짜 범위), 빠른 검색(일치 글자 강조, 쉼표·하이픈 무시)
|
|
31
|
+
- 선택(단일·다중·체크 칸·Shift 범위·전체), 선택 시 일괄 작업 막대
|
|
32
|
+
- 컬럼 설정 패널(보이기·순서·고정·행 높이) + 브라우저 저장, 너비 조절·더블클릭 자동 맞춤
|
|
33
|
+
- 키보드 이동, Ctrl+C 복사(엑셀 붙여넣기용 탭 구분), 엑셀(.xlsx) 내보내기(외부 라이브러리 없이 직접 생성)
|
|
34
|
+
- 불러오는 중(뼈대 행·진행 막대) · 데이터 없음 · 오류 상태
|
|
35
|
+
- 머리글 옅은 바탕 + 컬럼 세로선, 묶음 머리글 전체 너비 밑줄, `gridLines` 옵션, 묶음 안 컬럼 고정 시 묶음 전체 고정, 그리드 모서리 6px(`--radius-grid`)
|
|
36
|
+
|
|
37
|
+
라이트 / 다크 테마
|
|
38
|
+
- `<html data-theme="dark">`이면 모든 색 토큰이 다크 값으로 바뀜 (컴포넌트 코드 변경 없이 전체 적용)
|
|
39
|
+
- `useTheme()` · `setTheme('light'|'dark'|'system')` · `getTheme()`: 선택 저장(localStorage), 운영체제 설정 따르기, 다른 탭과 동기화
|
|
40
|
+
- `THEME_INIT_SCRIPT`: index.html에 넣어 첫 화면 번쩍임 방지
|
|
41
|
+
- 테마를 바꿀 때 0.2초 크로스페이드 (브라우저 표준 View Transitions API, 표가 커도 느려지지 않음). "동작 줄이기" 설정·미지원 브라우저는 즉시 전환
|
|
42
|
+
- 새 토큰: 옅은 상태 바탕 위 글자색 `--color-status-{success|warning|danger|info}-text`, 검색 강조 `--color-highlight`, 가장자리 그림자 `--shadow-edge`
|
|
43
|
+
- Badge·DataGrid의 상태 글자색을 새 토큰으로 바꿈 (다크에서도 읽히게)
|
|
44
|
+
|
|
45
|
+
새 컴포넌트
|
|
46
|
+
- `SideNav`: 여러 단계(최대 5단계 고려) 왼쪽 메뉴. 지금 화면까지 자동 펼침, 단계별 들여쓰기·안내선, 배지, 새 창 링크, 키보드 ←→
|
|
47
|
+
- `searchable`: 메뉴 검색(깊은 단계도 이름으로, 경로 표시·일치 글자 강조, Enter 이동)
|
|
48
|
+
- `collapsed`: 접은 메뉴(아이콘 줄) + 마우스를 올리면 뜨는 펼침 창(여러 단계 그대로), 처리 건수 빨간 점
|
|
49
|
+
- `Menu`: 드롭다운 메뉴 (Trigger · Content · Item · RadioGroup/RadioItem · Header · Label · Separator), 키보드·바깥 클릭 닫기
|
|
50
|
+
- 깊은 단계 모양 정리(2~5단계가 섞여도 같은 규칙): 안내선은 1단계 아래 하나만, 더 깊은 단계는 12px 들여쓰기(5단계에서 멈춤), 굵은 글씨는 맨 위 단계·선택 메뉴만, 선택·hover 바탕은 글자 시작 위치부터, 아래 단계 선택 막대 제거
|
|
51
|
+
- 긴 메뉴 이름 마우스 올리면 전체 이름(title), 지금 화면 메뉴가 가려져 있으면 보이게 스크롤
|
|
52
|
+
- 검색칸 포커스: 바깥 빛 없이 흰 바탕 + 1px 블루 테두리, 돋보기 블루
|
|
53
|
+
- 메뉴 검색: 결과로 이동해도 검색어·결과 목록을 지우지 않음(지금 화면 결과가 강조됨). 한글 조합 중 Enter는 이동으로 처리하지 않음
|
|
54
|
+
- 아이콘 추가: home · user · logout · menu · lock · eye · eyeOff · sun · moon · monitor
|
|
55
|
+
|
|
56
|
+
`DataGrid` 셀 표현 · 셀 범위 선택 (irisbright-ui5 GridTable 기능 이전)
|
|
57
|
+
- 셀 모양 `kind`: `badge`(상태 배지, 값별 색 표·점) · `link`(누르는 글자) · `button`(행 안 작은 버튼, 행별 사용 가능 여부) → `onCellAction`
|
|
58
|
+
- 번호 모양 `formatType`: `businessNumber` · `registrationNumber` · `mask` (화면·검색·복사·엑셀 모두 같은 모양)
|
|
59
|
+
- 조건부 글자색 `cellTone`, 음수 빨강 `negative: 'danger'`, `cellClassName`, 잘린 글자 마우스 올리면 전체 보기(`tooltip`)
|
|
60
|
+
- 행 상태 색 `rowState`: 왼쪽 색 막대 + 옅은 바탕 (info · success · warning · danger · muted)
|
|
61
|
+
- 셀 범위 선택 `rangeSelection`(기본 켜짐): 끌기 · Shift+클릭 · Shift+방향키 · Ctrl+A · Ctrl+방향키, 가장자리 자동 스크롤
|
|
62
|
+
- 범위 복사(Ctrl+C → 엑셀에 바로 붙여넣기), 아래 줄에 선택 칸 수 · 합계 · 평균 표시 (UI5에는 없던 기능)
|
|
63
|
+
- 정렬·필터·검색이 바뀌면 범위를 지워 엉뚱한 칸이 선택된 채 남지 않게 함
|
|
64
|
+
- 클립보드 권한이 막힌 환경에서도 복사되도록 예전 방식으로 다시 시도
|
|
65
|
+
- 바뀐 동작: 범위 선택을 쓰는 표에서 Shift+클릭은 칸 범위. 행 연속 선택은 체크 칸 Shift+클릭 (Ctrl+클릭은 그대로 행 하나씩)
|
|
66
|
+
|
|
67
|
+
새 공용 기능: 엑셀 (외부 라이브러리 없음)
|
|
68
|
+
- `exportToExcel(options)`: 표 데이터를 바로 내려받기 (제목 줄, 계산 컬럼, 합계 줄, 머리글 꾸밈, 틀 고정, 자동 필터, 시트 여러 개)
|
|
69
|
+
- `createWorkbook()`: 시트·셀·스타일(굵게·색·배경·정렬·테두리·숫자 형식)·병합·틀 고정·자동 필터를 직접 다루는 API
|
|
70
|
+
- `addTableSheet()`, `downloadBlob()`
|
|
71
|
+
- 브라우저 표준 압축(CompressionStream)으로 파일 크기 약 1/10 (1,000행 317KB → 28KB)
|
|
72
|
+
- DataGrid의 엑셀 다운로드도 이 공용 기능을 사용
|
|
73
|
+
|
|
74
|
+
## 0.1.0 — 2026-11-19
|
|
75
|
+
|
|
76
|
+
첫 배포.
|
|
77
|
+
|
|
78
|
+
- 디자인 토큰: 색상, 간격, 반경, 글꼴, 그림자, 겹침 순서 (`styles.css`의 CSS 변수)
|
|
79
|
+
- 컴포넌트: `Button`, `IconButton`, `TextField`, `Field`, `Checkbox`, `RadioGroup`/`Radio`, `Switch`, `Badge`, `Spinner`, `Icon`
|
|
80
|
+
- 아이콘 34개 (`iconNames`로 목록 조회)
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 rendez0829
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/NOTICE
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
Blueward React UI
|
|
2
|
+
Package: @bluewardai/react-ui
|
|
3
|
+
Author and maintainer: rendez0829
|
|
4
|
+
Copyright (c) 2026 rendez0829.
|
|
5
|
+
Licensed under the MIT License. See LICENSE.
|
|
6
|
+
|
|
7
|
+
This package has no runtime dependencies other than its React peer dependency.
|
|
8
|
+
All components, styles, and icon shapes were written for this package.
|
package/README.md
CHANGED
|
@@ -1,3 +1,71 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @bluewardai/react-ui
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Blueward 업무 화면용 React 컴포넌트. React 외에 다른 라이브러리에 의존하지 않습니다.
|
|
4
|
+
|
|
5
|
+
## 설치
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install @bluewardai/react-ui
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
React 19가 필요합니다.
|
|
12
|
+
|
|
13
|
+
## 사용법
|
|
14
|
+
|
|
15
|
+
앱 시작 파일에서 스타일을 한 번 불러옵니다.
|
|
16
|
+
|
|
17
|
+
```jsx
|
|
18
|
+
// src/main.jsx
|
|
19
|
+
import '@bluewardai/react-ui/styles.css'
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
화면에서 컴포넌트를 import해서 씁니다.
|
|
23
|
+
|
|
24
|
+
```jsx
|
|
25
|
+
import { useState } from 'react'
|
|
26
|
+
import { Button, TextField } from '@bluewardai/react-ui'
|
|
27
|
+
|
|
28
|
+
export function SearchBar({ onSearch }) {
|
|
29
|
+
const [keyword, setKeyword] = useState('')
|
|
30
|
+
return (
|
|
31
|
+
<div style={{ display: 'flex', gap: 8, alignItems: 'flex-end' }}>
|
|
32
|
+
<TextField label="거래처" value={keyword} onChange={(e) => setKeyword(e.target.value)} />
|
|
33
|
+
<Button variant="primary" icon="search" onClick={() => onSearch(keyword)}>
|
|
34
|
+
조회
|
|
35
|
+
</Button>
|
|
36
|
+
</div>
|
|
37
|
+
)
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## 제공 항목
|
|
42
|
+
|
|
43
|
+
| 이름 | 설명 |
|
|
44
|
+
|---|---|
|
|
45
|
+
| `Button` | 버튼 (primary · secondary · ghost · danger, sm · md · lg, 로딩) |
|
|
46
|
+
| `IconButton` | 아이콘만 있는 버튼 |
|
|
47
|
+
| `TextField` | 라벨·도움말·오류가 포함된 한 줄 입력 |
|
|
48
|
+
| `Field` | 직접 만든 입력 요소에 라벨·오류 틀을 씌우는 공통 틀 |
|
|
49
|
+
| `Checkbox` | 체크박스 (부분 선택 지원) |
|
|
50
|
+
| `RadioGroup`, `Radio` | 라디오 묶음 |
|
|
51
|
+
| `Switch` | 즉시 적용되는 켜기/끄기 |
|
|
52
|
+
| `Badge` | 상태 배지 |
|
|
53
|
+
| `Spinner` | 로딩 표시 |
|
|
54
|
+
| `Icon`, `iconNames` | 선 아이콘 34개 |
|
|
55
|
+
|
|
56
|
+
## 디자인 토큰
|
|
57
|
+
|
|
58
|
+
`styles.css`가 `:root`에 CSS 변수를 정의합니다. 앱 스타일에서도 같은 값을 쓸 수 있습니다.
|
|
59
|
+
|
|
60
|
+
```css
|
|
61
|
+
.panel {
|
|
62
|
+
padding: var(--space-16);
|
|
63
|
+
border: 1px solid var(--color-border-default);
|
|
64
|
+
border-radius: var(--radius-8);
|
|
65
|
+
color: var(--color-text-primary);
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## 라이선스
|
|
70
|
+
|
|
71
|
+
MIT © rendez0829
|