open-grid 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 All notable changes to OPEN_GRID will be documented in this file.
 
+## [1.2.0] - 2026-07-05
+
+### Added
+- **다국어(i18n) — 리소스 분리** / **Internationalization — separated resources.**
+  UI 문자열(라벨·aria-label·announce·툴팁·플레이스홀더)을 코어에서 분리해 로케일 카탈로그로 관리.
+  `SkinRegistry`/`IconRegistry`와 동형인 `LocaleRegistry`(전역 싱글턴 + 인스턴스별 child 체인 + never-throw 폴백).
+  - 옵션: `new OpenGrid(el, { locale: 'en', messages: { ... } })`
+  - 메서드: `grid.setLocale('en')` / `grid.getLocale()` / `grid.setMessage(key, value)` / `grid.t(key, params)`
+  - 등록: `localeRegistry.register('ja', { ... })`, `OpenGrid.defineLocale(id, messages)`
+  - 내장 로케일 `ko`(기본)·`en`. 폴백 체인 = 인스턴스 오버라이드 → 활성 로케일 → ko → 키 원문.
+  - `setLocale` 시 상주 크롬(페이지네이션·찾기 바) 재라벨 + 컨텍스트메뉴/필터패널 재구성 + `lang` 속성 갱신 + `localeChange` 이벤트.
+  - 공개 export: `LocaleRegistry`/`localeRegistry`/`t` + 타입 `LocaleMessages`/`PartialLocaleMessages`/`LocaleMessageKey`/`MessageValue`.
+
+### Changed
+- **하위호환 보장** — 기본 로케일 `ko` 고정. `locale`/`messages` 미지정 시 렌더 결과는 이전과 동일(byte-identical).
+  개발자 대면 오류 메시지(throw/console)와 숫자·날짜 포맷은 i18n 범위에서 제외(로그 안정성·별도 축).
+
+### Docs
+- **TypeDoc API 문서 파이프라인** — `npm run docs`로 공개 API 문서 생성. 공개 표면에 한·영 병행 JSDoc.
+
+## [1.1.1] - 2026-07-04
+
+### Added
+- **스킨 (형태 축)** — 색 테마와 직교하는 형태 스킨 6종(sharp/rounded/stitch/flat/high-contrast/material).
+  `data-og-skin` 속성 + `grid.setSkin(name)`, `OpenGrid.defineSkin(name, delta)`(FORM 토큰만 허용), `grid.setSkinVar(k,v)`.
+  색 테마와 자유 조합(예: crimson 테마 + stitch 스킨). 접근성 위험이 있는 neumorph는 기본 카탈로그에서 제외.
+- **아이콘 세트** — Bootstrap Icons(MIT) 기반 역할(role) 아이콘 64종. `renderIcon(role, {size})`,
+  `grid.setIcon(role, key)`(인스턴스 격리), `OpenGrid.defineIconSet(map)`(전역). 공개 export 추가:
+  `renderIcon`/`IconRegistry`/`iconRegistry`/`DEFAULT_ICON_ROLES`/`SkinRegistry`/`skinRegistry`.
+- **버튼 렌더러 아이콘** — `renderer:{ type:'button', icon:'search', label:'…', iconPos:'left'|'right' }`로
+  버튼 라벨과 아이콘을 함께 표시.
+
+### Changed
+- 그리드 셀/행/헤더 보더를 `--og-border-style`/`--og-divider-style` 토큰으로 승격 — 스킨이 선(보더 스타일)을 제어한다.
+  토큰 미설정 시 `solid` 폴백(기존 렌더와 동일).
+- 내부 코어 리팩토링(협력자 분리) — 공개 API·동작 변화 없음(행동 보존).
+
+### Notes
+- Bootstrap Icons(MIT) 라이선스를 `THIRD_PARTY_LICENSES.txt`에 포함.
+
 ## [1.1.0] - 2026-07-03
 
 ### Added

package/README.md

@@ -9,7 +9,7 @@ High-performance, framework-agnostic data grid with virtual scrolling, inline ed
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
-[![npm](https://img.shields.io/badge/npm-1.0.4-orange)](https://www.npmjs.com/package/open-grid)
+[![npm](https://img.shields.io/badge/npm-1.2.0-orange)](https://www.npmjs.com/package/open-grid)
 
 📖 **[개발 가이드](https://foxnail.kr/open-grid/demo/v2/guide/index.php)** — 설치부터 고급 API까지 단계별 가이드
 🔗 **[데모/홈페이지](https://foxnail.kr/open-grid/demo/v2/index.php)**
@@ -28,6 +28,7 @@ High-performance, framework-agnostic data grid with virtual scrolling, inline ed
 | Column Reorder (drag header, `columnReorder: true`) | ✅ |
 | Frozen Columns | ✅ |
 | Row/Column Groups (header merge) | ✅ |
+| Localization / i18n (built-in `ko`·`en`, `setLocale`, custom locales) | ✅ |
 | Grouping + Summary (SUM/AVG/MIN/MAX/COUNT) | ✅ |
 | Tree Grid (flat → hierarchy, expand/collapse) | ✅ |
 | OrgChart (organization chart with theme) | ✅ |
@@ -350,6 +351,34 @@ CSS 변수로 완전한 테마 커스터마이즈 가능:
 }
 ```
 
+## Localization (i18n)
+
+All built-in UI strings — labels, `aria-label`s, live-region announcements, tooltips, placeholders —
+are kept in swappable locale catalogs, separated from the core. Ships with **`ko` (default) and `en`**.
+Existing apps are unaffected: without a `locale`/`messages` option, output is byte-identical to before.
+
+```ts
+import { OpenGrid, localeRegistry } from 'open-grid';
+
+// 1) Pick a built-in locale per instance
+const grid = new OpenGrid(el, { columns, locale: 'en' });
+
+// 2) Switch at runtime (re-labels chrome, updates the `lang` attribute, emits `localeChange`)
+grid.setLocale('ko');
+
+// 3) Override just a few messages for one instance
+new OpenGrid(el, { locale: 'en', messages: { contextMenu: { sortAsc: 'Sort A→Z' } } });
+
+// 4) Register a custom locale globally (partial dictionaries are fine — missing keys fall back)
+localeRegistry.register('ja', { contextMenu: { find: '検索' }, pagination: { rowsPerPage: '行/ページ:' } });
+new OpenGrid(el, { locale: 'ja' });
+```
+
+Fallback chain: instance override → active locale → `ko` (complete catalog) → raw key.
+Number/date formatting and developer-facing error messages are intentionally out of scope
+(use `Intl` and keep logs grep-stable). See the
+[Localization guide](https://foxnail.kr/open-grid/demo/v2/guide/index.php) for the full key reference.
+
 ## Changelog
 
 ### v0.1.2 (2026-05-30)

package/THIRD_PARTY_LICENSES.txt

@@ -227,3 +227,46 @@ The complete text of the Apache License, Version 2.0 follows.
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
+
+
+-----------------------------------------------------------------------
+3. Bootstrap Icons
+   Copyright (c) 2019-2024 The Bootstrap Authors
+   Homepage: https://icons.getbootstrap.com/
+   Source:   https://github.com/twbs/icons
+   Version:  1.13.1
+   License:  MIT License (SPDX: MIT)
+   Bundled as: curated inline SVG glyph bodies embedded in the compiled
+    distribution (dist/*.js, from src/core/icons/bootstrap-icons.ts) — the
+    icon glyphs used by the grid UI (sorting, filtering, editing, row/column
+    ops, export, chart-type, status and general UI icons). No runtime
+    dependency is added; only the glyphs actually used are embedded.
+-----------------------------------------------------------------------
+
+The complete text of the MIT License, as distributed with Bootstrap Icons,
+follows.
+
+
+                                 MIT License
+
+The MIT License (MIT)
+
+Copyright (c) 2019-2024 The Bootstrap Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.