open-grid 1.0.1 → 1.0.6

package/CHANGELOG.md

@@ -0,0 +1,265 @@
+# Changelog
+
+All notable changes to OPEN_GRID will be documented in this file.
+
+## [1.0.5] - 2026-06-24
+
+### Changed
+- **런타임 의존성 0 (zero runtime dependencies)** — Excel 내보내기에 쓰이는 `xlsx`·`xlsx-js-style`을
+  `dependencies` → `devDependencies`로 옮겼다. 이들은 **빌드 시 `dist/`에 번들로 포함**되므로
+  (`src`의 `import('xlsx-js-style')`가 빌드 과정에서 `dist/xlsx.min-*.js` 청크로 변환됨),
+  설치하는 쪽에서 별도로 받을 필요가 없다 — `npm install open-grid`는 외부 런타임 의존성을
+  하나도 끌어오지 않는다. **Excel 내보내기는 번들된 SheetJS로 그대로 동작**한다(설치 불필요).
+  코드·동작 변경 없음(의존성 분류만 정정). 번들된 SheetJS는 Apache-2.0이며 `NOTICE`/`THIRD_PARTY_LICENSES.txt`로 귀속 표기됨.
+
+## [1.0.4] - 2026-06-24
+
+### Changed
+- **소개 문구(intro) 추가** — README 상단과 npm `description`에 제품 소개 문구를 추가하고
+  npm 배지 버전 표기를 현행화했다. 코드·기능 변경 없음(문서/메타데이터만).
+  ("zero-dependency **core**" — Excel 내보내기는 SheetJS를 번들하므로 "코어 무의존"으로 정확히 표기.)
+
+## [1.0.3] - 2026-06-24
+
+### Changed
+- **라이선스 준수 내역을 배포 패키지에 명시** — 발행 tarball에 `CHANGELOG.md`를 포함하고,
+  README·변경 이력에 1.0.2의 라이선스 컴플라이언스 조치(아래)를 명확히 기재했다.
+  코드·기능 변경 없음(문서/배포 메타데이터만).
+
+## [1.0.2] - 2026-06-24
+
+### Fixed — 라이선스 컴플라이언스 (잠재적 라이선스 위반 소지 해소)
+- **문제** — Excel 내보내기 기능에 쓰이는 `xlsx`(SheetJS Community Edition)와
+  `xlsx-js-style`는 **Apache License 2.0** 라이선스이며 빌드 결과물(`dist/`)에 번들되어
+  함께 배포된다. 그런데 1.0.1까지의 배포 패키지에는 OPEN_GRID 자체의 **MIT LICENSE만**
+  들어 있고, Apache-2.0가 재배포 시 요구하는 **라이선스 사본과 저작권 귀속 고지가 누락**
+  되어 있었다(Apache-2.0 §4(a)·§4(c) 미충족 → **잠재적 라이선스 위반 소지**).
+- **해결** — 배포 패키지에 다음을 추가하고 `files`에 포함해 함께 배포한다:
+  - `THIRD_PARTY_LICENSES.txt` — Apache License 2.0 **전문** + 번들 구성요소 식별·저작권 고지
+  - `NOTICE` — SheetJS LLC(`xlsx`) 및 SheetJS LLC·Brent Ely(`xlsx-js-style`) 저작권 귀속
+  - README에 "Third-party licenses" 안내 추가
+- **영향 범위** — OPEN_GRID 본체 라이선스(MIT)와 코드는 **변경 없음**. MIT와 Apache-2.0는
+  서로 호환되어 **라이선스 충돌은 없으며**, 누락돼 있던 Apache-2.0 **귀속 의무만 충족**시킨
+  조치다.
+
+## [1.0.1] - 2026-06-24
+
+### Fixed
+- **그리드 초기화 크래시 수정** — `summary` 푸터를 사용하는 그리드를 생성할 때
+  `Cannot read properties of undefined (reading 'getStrategy')` 로 초기화가 실패하던 문제.
+  생성자에서 OverrideKernel 부착(및 strategy resolver 배선)을 최초 마운트 **이전**으로
+  옮겨, 초기 푸터/그룹 렌더가 strategy 슬롯을 조회할 때 커널이 항상 준비되도록 했다.
+  (피벗·집계 푸터·그룹 합계 등 `summary`/`footer` 옵션을 쓰는 모든 구성에 영향.)
+
+## [1.0.0] - 2026-06-23
+
+첫 정식 메이저 릴리스. 본문(코어) 코드 무수정으로 동작을 확장하는 `grid.override()` API와 헤더 줄바꿈을 추가.
+
+### Added
+- **`grid.override()` — 본문 무수정 동작 확장 API** (신규 `src/core/OverrideKernel.ts`)
+  - `grid.override(name, (orig, ...args) => result)` — 메서드 래핑. `orig()`는 `super`처럼 항상 호출 가능.
+    합성 순서는 FIFO 좌측폴드(나중에 건 것이 가장 바깥), 재진입 깊이 32 + 사이클 가드.
+  - `grid.override.strategy(slot, fn)` — 6개 알고리즘 슬롯 교체: 정렬 비교(sortComparator),
+    필터 술어(filterPredicate), 표시 포맷터(displayFormatter), 엑셀 직렬화(cellSerializer),
+    그룹 키(groupKeyFn), 집계 연산(summaryOp).
+  - `grid.restore(name)` / `grid.restoreAll()` — 원복. `destroy()` 시 자동 전체 복원.
+  - `OpenGrid.defaultOverride(name, fn)` / `OpenGrid.defaults.strategy(slot, fn)` — 전역(앞으로 생성될 모든 그리드) 기본 오버라이드.
+  - 오류는 기본(strict) 그대로 전파. 기존 메서드 본문은 한 줄도 수정하지 않음(C1 원칙 준수).
+- **헤더 줄바꿈** — `ColumnDef.headerWrap?: boolean` + 헤더 문자열 `\n` 줄바꿈 + 헤더 높이 자동 확장.
+- **override 데모 32종 × 5 프레임워크**(Vanilla/React/Vue/jQuery/Angular) — `examples/override/`, 허브 포함.
+- **그리드 튜닝 참고자료 페이지** — 아키텍처/시퀀스 UML 다이어그램 기반 내부 동작 설명.
+- **AI 에이전트용 override 가이드**(KO/EN) + 개발 가이드 override 챕터.
+
+### Tests
+- override 코어 + 헤더 줄바꿈 단위 테스트 추가. 전체 테스트 통과(회귀 0).
+
+## [0.3.2] - 2026-06-18
+
+### Fixed
+- **셀 줄바꿈(col.wrap)이 실제로 꺾이지 않던 문제** — `.og-cell--wrap` 는 셀에 적용됐지만, 내부 텍스트
+  span(`.og-cell-text`)을 렌더러가 인라인 `white-space:nowrap` 으로 렌더해 클래스만으로는 못 이겼다.
+  `.og-cell--wrap .og-cell-text/.og-cell-date { white-space: normal !important; text-overflow: clip !important }`
+  로 인라인을 무력화. e2e 도 셀이 아닌 **내부 span + 실제 줄 수**를 검증하도록 강화.
+  (npm `open-grid@0.3.1` 은 이 수정 직전에 발행되어 wrap 미동작 → **0.3.2 로 재발행**, npm latest = 0.3.2.)
+
+## [0.3.1] - 2026-06-17
+
+### Fixed
+- **Host CSS isolation — 임베드 시 호스트 테마 CSS inbound 상속으로 레이아웃/색상 깨짐** (foxnail.kr/WordPress 통합에서 발견)
+  - 원인: 헤더가 실제 `<table>`/`<th>` 라서, 임베드 호스트(WordPress 등)의 element/높은 특이도 셀렉터
+    (`th,td`, `.entry-content th`, `.fn-post-content th` 등)가 그리드 헤더로 침범 — `line-height`, `border`,
+    `background`, `color`, `table{margin}` 등이 새어들어와 헤더가 깨지거나 호스트 색(navy/white)으로 칠해짐.
+    바디는 `<div>` 라 안전. (헤더 `<th>` 는 element 셀렉터라 그리드의 클래스/상속값을 이김)
+  - `src/core/GridRenderer.ts` — 헤더 `<th>` 의 모든 시각 속성을 **인라인으로 고정**(인라인이 호스트 셀렉터를 이김):
+    `background`/`color`/`line-height`/`font-size`/`vertical-align`/`border-top·left` (data + extra/rownumber/check 컬럼 전부).
+    헤더 `<table>` 에 `og-header-table` 클래스 부여 + 인라인 `margin:0;border-spacing:0`.
+  - `src/styles/base.css` — `.og-container { line-height: normal }` (바디 셀 메트릭 격리) 및 헤더 클래스 기본 방어.
+  - **WordPress 전역 스타일 `:where([style*="border-color"]){border-style:solid}` 대응** — 그리드 인라인 보더가
+    `var(--og-border-color)` 를 참조해 "border-color" 문자열에 매칭되면, 폭 미지정 변에 `medium`(3px) 보더가
+    강제돼 헤더(`.og-header`)·그룹행·병합셀의 좌/우/상에 굵은 선이 생기고 바디 컬럼선과 어긋나던 문제 수정.
+    `GridRenderer.ts` 의 단일변 인라인 보더에 `border:0` 선행(미지정 변 폭 0 명시). 테마 무관(전 테마 동일 적용).
+- **컨텍스트메뉴 위치 — 임베드 호스트의 transform 조상 아래에서 마우스 좌표를 벗어남** (그리드 너비 확대 시 두드러짐)
+  - `src/core/ContextMenu.ts` — 메뉴를 그리드 컨테이너 대신 `document.body` 에 부착 → `position:fixed` 가
+    항상 뷰포트 기준으로 동작. 테마 변수 보존을 위해 `data-og-theme` 복사 + `.og-context-menu` 에 `--og-cm-*` 정의 확장.
+
+### Added
+- **셀 툴팁** — `column.tooltip`(문자열|함수) 또는 그리드 옵션 `tooltips: true`(모든 셀에 값 자동 노출).
+  헤더 셀도 `title` 노출(잘린 헤더 가독성).
+- **셀 줄바꿈(wrap)** — `column.wrap: true` 시 nowrap+ellipsis 대신 여러 줄 표시(`white-space:normal`).
+  가상 스크롤 고정 행 높이와 함께 `rowHeight` 확대 권장.
+- 회귀 테스트: `test/e2e/host-isolation.spec.ts` + 적대적 호스트 픽스처 `examples/host-isolation/`
+  (line-height/border/margin/색상 격리 + 컨텍스트메뉴 transform 조상 + 툴팁/wrap, before/after 변별 — 10 케이스).
+
+## [0.3.0] - 2026-06-05
+
+### Added
+- **개발 가이드 DB화 완성** — 39개 섹션 전체 SQLite DB화 (G1~G6)
+  - G1: 시작하기 (npm 설치, 퀵스타트, 기본 설정)
+  - G2: 데이터/옵션 (컬럼 정의, 데이터 옵션, 선택/체크박스/DnD/상태 관리)
+  - G3: 편집/이벤트 (셀 편집, 셀 타입, 마스킹, 병합, 이벤트, 트리거)
+  - G4: 그룹/페이징 (그룹, 트리, 푸터, 페이지네이션, 파인드바, 키보드)
+  - G5: 고급/내보내기 (피벗, 워크시트, SAP, XML, 수식, 조직도, Excel/CSV/인쇄)
+  - G6: 스타일/API (테마, 커스텀, 폰트, 사이징, 접근성, 그리드/컬럼/이벤트 API)
+- **전 프레임워크 데모 완성** — React / Vue / jQuery / Angular / Vanilla 각 49개 섹션
+  - Angular A~H: AngularJS 1.x CDN 기반, `$scope.$apply` 없이 ng-show/ng-hide 패턴
+- **Guide 렌더러** — `lang='html'` 감지 시 innerHTML 직접 주입 방식으로 전환 (pre/code 래핑 없음)
+
+## [0.2.0] - 2026-06-04
+
+### Fixed
+- **Formula 셀 클릭 버그** — `CellEventHandler.ts`: formula 컬럼 cellClick 시 `e.value`가 `undefined`이던 문제 수정
+  - `row[col.field]` 대신 `evaluateFormula()`로 직접 계산 후 주입
+
+### Added
+- **React 데모** — `demo-react/index.php` 신규 (React 18 CDN, `useRef+useEffect+createRoot` 패턴)
+- React 프레임워크 전 섹션(A~H, 49개) DB 삽입 완료
+- 선택/필터셀렉트 API 버그 수정 (`getSelections()`, `valueMap` 기반 표시)
+
+## [0.1.2] - 2026-05-30
+
+### Added (Sprint 29 추가분)
+- **변경 추적 API 보강**
+  - `getChanges()` — `{ added, edited, removed }` 한 번에 반환. edited 행에 `_changedFields` 포함
+  - `getEditedRows()` — 수정된 행만 반환 (기존 `getChangedRows()` 개선판)
+  - `getChangedColumns()` — `{ row, fields, diff[] }` 형태로 컬럼 단위 diff 반환 (oldValue/newValue 포함)
+  - `getOriginalRow(rowIndex)` — 수정 전 원본 행 데이터 반환
+- **합계 / 소계 (Footer)**
+  - `setFooter(FooterDef[])` — 런타임 푸터 설정 (SUM/AVG/MIN/MAX/COUNT)
+  - `getFooterValue(field)` — 특정 필드 집계 결과 조회
+  - `getFooterData()` — 전체 집계 데이터 배열 조회
+  - OGDecimal 기반 정밀 계산 — 소수점 누적 오류 없음 (0.1 × 10 = 정확히 1.00)
+  - 데이터 수정/추가/삭제 시 푸터 자동 재계산
+- **Guide** — Ch26(변경 추적), Ch27(합계/소계) 추가 → 총 27챕터
+- **Vanilla 데모** — '변경 추적' 섹션, '합계/소계' 섹션 추가
+
+## [0.1.1] - 2026-05-30
+
+### Added (Sprint 29)
+- **columnReorder** — `columnReorder: true` 옵션으로 헤더 드래그 컬럼 순서 변경 지원
+  - `onColumnReorder` 이벤트 콜백 (`{ fromIndex, toIndex, field }`)
+  - 드래그 중 시각 피드백 (`og-col-dragging` / `og-col-drop-over` CSS 클래스)
+- **Guide** — 개발 가이드 4개 챕터 신규 추가 (Ch22~Ch25)
+  - Ch22: 데이터 마스킹 (10종 타입, 셀/컬럼 단위 해제, maskOnExport)
+  - Ch23: 조직도 (OrgChart API, setData, expandAll/collapseAll, 테마 연동)
+  - Ch24: 페이지네이션 (API, 서버사이드, React/Vue 예제)
+  - Ch25: 키보드 단축키 (WCAG 2.2 준수 표, aria-label 설정)
+- **E2E Tests** — sprint29.spec.ts 25개 시나리오 추가
+  - checkColumn 선택/해제, 컨텍스트 메뉴 렌더링/닫힘, 테마 전환(data-og-theme), 키보드 네비게이션, 셀 편집, 정렬(aria-sort)
+
+### Changed
+- `GridRenderer` 내부 콜백에 `onColDragStart` / `onColDrop` / `getColDragIdx` 추가
+
+## [0.1.0] - 2026-05-24
+
+### Added
+- **Core Engine**
+  - `OpenGrid` class — main grid instance with `new OpenGrid(container, options)` API
+  - `DataLayer` — CRUD, state tracking (added/edited/removed), sort, filter
+  - `VirtualScroll` — rAF-based rendering with row pooling (100k+ rows)
+  - `ColumnLayout` — group headers, frozen columns, flex widths
+  - `EventEmitter` — on/once/off/emit event system
+
+- **Cell Renderers** (8 types)
+  - text, number (format), date, checkbox, button, badge, link, template
+
+- **Cell Editors** (5 types)
+  - text, number, select, date, checkbox
+  - Inline editing: click / dblclick / F2 entry, Enter/Tab/Esc exit
+
+- **Grouping + Summary**
+  - `groupBy(fields[])` — multi-level hierarchical grouping
+  - `summary` option — SUM / AVG / MIN / MAX / COUNT per column
+  - `expandAll()` / `collapseAll()` / `clearGroup()`
+
+- **Tree Grid**
+  - `enableTree()` / `disableTree()` — flat-to-tree via `treeId` / `treeParentId`
+  - `expandNodes(ids)` / `expandAllNodes()` / `collapseAllNodes()`
+  - Indent + toggle arrow rendering per depth level
+
+- **Cell Merge**
+  - `mergeCells([{row, col, rowSpan?, colSpan?}])` — manual merge
+  - `autoMerge(fields[])` — auto rowSpan for consecutive identical values
+  - `clearMerge()` — remove all merges
+
+- **Row Drag & Drop**
+  - `draggable: true` option
+  - Ghost row + drop indicator
+  - `reorderRow(from, to)` public API
+  - `onRowDrop` callback
+
+- **Filter UI**
+  - Column header filter icon
+  - 9 operators: `=`, `!=`, `contains`, `startsWith`, `endsWith`, `>`, `<`, `>=`, `<=`
+
+- **Export**
+  - `exportExcel(options?)` — SheetJS xlsx (dynamic import, code-split)
+  - `exportCsv(options?)` — BOM-aware CSV
+  - `exportJson(options?)` — JSON download
+
+- **Pagination**
+  - `pagination: true` + `pageSize` option
+  - Page size selector (10/20/50/100/200)
+  - First/Prev/Next/Last navigation
+
+- **Keyboard Navigation**
+  - Arrow keys — cell navigation
+  - Tab / Shift+Tab — next/prev cell
+  - F2 / Enter — start edit
+  - Escape — cancel edit / clear focus
+  - Ctrl+C / Ctrl+V — clipboard
+
+- **UI**
+  - Column resize (drag)
+  - Multi-sort (Shift+click)
+  - Dark theme (`theme: 'dark'`)
+  - CSS Variables — full theme customization
+  - `setTheme(theme)` / `setThemeVar(key, value)`
+
+- **Vue 3 Component** (`open-grid/vue`)
+  - Composition API, `defineProps` / `defineEmits`
+  - Reactive `data` / `columns` watchers
+  - `grid` instance exposed via `defineExpose`
+
+- **React 18 Component** (`open-grid/react`)
+  - Hooks-based (`useRef`, `useEffect`)
+  - `OpenGridReact` + `OpenGridWithRef` (forwardRef)
+  - `stateColumn`, `draggable`, `onRowDrop` props
+
+- **API Naming** — distinctive, self-consistent method names
+  - `readCell`, `writeCell` for cell access
+  - `orderBy` for sorting
+  - `jumpToRow` for scrolling
+  - `getSelections` for selection
+  - (40+ purpose-built method names)
+
+### Performance
+- Multi-sort 100k rows: 1789ms → **40ms** (44× improvement via Schwartzian transform)
+- Single sort 100k rows: ~38ms
+- Filter 100k rows: ~17ms
+- Group build 100k rows: ~3ms (5 groups)
+- Tree build 100k rows: ~25ms
+
+### Tests
+- 124 unit tests across 7 test files
+- EventEmitter (7), DataLayer (14), GroupEngine (18), TreeEngine (20),
+  MergeEngine (16), CellEditor (23), CellRenderer (26)

package/NOTICE

@@ -0,0 +1,21 @@
+OPEN_GRID
+Copyright (c) 2026 OPEN_GRID Contributors
+
+This product is licensed under the MIT License (see LICENSE).
+
+This product bundles third-party components that are licensed under the
+Apache License, Version 2.0. Their attribution notices are reproduced below,
+and the full license texts are provided in THIRD_PARTY_LICENSES.txt.
+
+-----------------------------------------------------------------------
+SheetJS Community Edition (xlsx)
+Copyright (C) 2012-present SheetJS LLC
+https://sheetjs.com/
+Licensed under the Apache License, Version 2.0.
+
+xlsx-js-style
+Copyright (C) 2012-present SheetJS LLC
+Copyright (C) 2021-present Brent Ely (gitbrent)
+https://github.com/gitbrent/xlsx-js-style/
+Licensed under the Apache License, Version 2.0.
+-----------------------------------------------------------------------

package/README.md

@@ -1,10 +1,15 @@
 # OPEN_GRID
 
+**Meet Open Grid** — the ultra-light data grid with a **zero-dependency core** that fits
+effortlessly into any tech stack. React, Vue, Angular, jQuery, or pure JavaScript — it just
+works. MIT-licensed for full commercial freedom, endlessly customizable, and enhanced with an
+AI-friendly override guide so you can push your grid further than ever.
+
 High-performance, framework-agnostic data grid with virtual scrolling, inline editing, grouping, tree view, drag-and-drop, change tracking, footer aggregation, and column reorder.
 
 [![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-0.4.0-orange)](https://www.npmjs.com/package/open-grid)
+[![npm](https://img.shields.io/badge/npm-1.0.4-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)**
@@ -365,3 +370,30 @@ CSS 변수로 완전한 테마 커스터마이즈 가능:
 ## License
 
 MIT © OPEN_GRID Contributors
+
+### Zero runtime dependencies (Excel still works out of the box)
+
+`npm install open-grid` pulls **no external runtime dependencies** — the core grid is fully
+self-contained.
+
+**Excel export works out of the box, with nothing extra to install.** It uses SheetJS
+(`xlsx-js-style`), which is **bundled inside the package** (in `dist/`) and loaded on demand
+only when you actually export. You do **not** need to add `xlsx`/`xlsx-js-style` to your
+project — they ship inside OPEN_GRID. (They are listed under `devDependencies` because they are
+needed to *build* the bundle, not to *use* it.)
+
+### Third-party licenses
+
+The bundled Excel export uses **SheetJS Community Edition (`xlsx`)** and
+**`xlsx-js-style`**, both licensed under the **Apache License, Version 2.0**
+(© SheetJS LLC, and Brent Ely for the style fork). Their attribution notices
+and the full license text are included in [`NOTICE`](NOTICE) and
+[`THIRD_PARTY_LICENSES.txt`](THIRD_PARTY_LICENSES.txt).
+
+> **As of 1.0.2**, these `NOTICE` and `THIRD_PARTY_LICENSES.txt` files are shipped
+> inside the published package to satisfy the Apache-2.0 attribution requirements
+> for the bundled components — resolving a potential license-compliance gap in
+> earlier releases (≤ 1.0.1), which shipped only the MIT license without the
+> required Apache-2.0 notices. OPEN_GRID's own MIT license is unchanged; MIT and
+> Apache-2.0 are compatible, so this was an attribution fix only. See
+> [`CHANGELOG.md`](CHANGELOG.md) for details.

package/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,229 @@
+OPEN_GRID — Third-Party Software Licenses
+=========================================
+
+The OPEN_GRID distribution (the `dist/` directory of the published npm package)
+bundles the following third-party open-source components. OPEN_GRID itself is
+licensed under the MIT License (see LICENSE). The components below are
+redistributed under the Apache License, Version 2.0, a copy of which is
+reproduced in full at the end of this file.
+
+-----------------------------------------------------------------------
+1. SheetJS Community Edition (xlsx)
+   Copyright (C) 2012-present SheetJS LLC
+   Homepage: https://sheetjs.com/
+   License:  Apache License, Version 2.0
+   Bundled as: dist/xlsx.min-*.js  (used by the Excel export feature)
+
+2. xlsx-js-style
+   Copyright (C) 2012-present SheetJS LLC
+   Copyright (C) 2021-present Brent Ely (gitbrent)
+   Homepage: https://github.com/gitbrent/xlsx-js-style/
+   License:  Apache License, Version 2.0
+   (A style-preserving fork of SheetJS Community Edition; portions of its
+    code are bundled together with the Excel export feature.)
+-----------------------------------------------------------------------
+
+The complete text of the Apache License, Version 2.0 follows.
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright (C) 2012-present   SheetJS LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   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.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "open-grid",
-  "version": "1.0.1",
-  "description": "High-performance, framework-agnostic data grid with Vue 3 and React 18 support",
+  "version": "1.0.6",
+  "description": "Ultra-light data grid with a zero-dependency core — works with React, Vue, Angular, jQuery, or vanilla JS. MIT-licensed, endlessly customizable, with an AI-friendly override guide.",
   "type": "module",
   "main": "dist/open-grid.cjs",
   "module": "dist/open-grid.js",
@@ -27,7 +27,10 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_LICENSES.txt"
   ],
   "scripts": {
     "dev": "vite",
@@ -78,9 +81,7 @@
     "vite": "^5.2.0",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^1.6.0",
-    "vue": "^3.4.0"
-  },
-  "dependencies": {
+    "vue": "^3.4.0",
     "xlsx": "^0.18.5",
     "xlsx-js-style": "^1.2.0"
   },
@@ -96,5 +97,12 @@
   ],
   "license": "MIT",
   "author": "OPEN_GRID Contributors",
-  "homepage": "https://foxnail.kr/open-grid/demo/v2/index.php"
+  "homepage": "https://foxnail.kr/open-grid/demo/v2/index.php",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/farmerkweon/OpenGrid.git"
+  },
+  "bugs": {
+    "url": "https://github.com/farmerkweon/OpenGrid/issues"
+  }
 }