open-grid 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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

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)