open-grid 1.2.1 → 1.3.1

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.
Files changed (258) hide show
  1. package/CHANGELOG.md +388 -365
  2. package/dist/{OpenGrid-0r_543Kj.cjs → OpenGrid-B7m7ei7f.cjs} +1222 -1029
  3. package/dist/{OpenGrid-HmhGVC2V.js → OpenGrid-CeUdO_fM.js} +1613 -1418
  4. package/dist/index-CeJ-0-80.cjs +260 -0
  5. package/dist/index-DnarQ4eR.js +266 -0
  6. package/dist/index-DrCPRuYi.js +548 -0
  7. package/dist/index-JjfWY3Bt.cjs +520 -0
  8. package/dist/open-grid-base.css +12 -1
  9. package/dist/open-grid-react.cjs +1 -1
  10. package/dist/open-grid-react.js +1 -1
  11. package/dist/open-grid-vue.cjs +7 -7
  12. package/dist/open-grid-vue.js +2 -2
  13. package/dist/open-grid.cjs +1 -1
  14. package/dist/open-grid.js +2 -2
  15. package/dist/types/bench/perf.d.ts +14 -8
  16. package/dist/types/core/AppearanceResolver.d.ts +98 -11
  17. package/dist/types/core/CFRenderBridge.d.ts +13 -0
  18. package/dist/types/core/CellTypeRegistry.d.ts +24 -0
  19. package/dist/types/core/ColumnLayout.d.ts +100 -2
  20. package/dist/types/core/CrossGridMapper.d.ts +43 -5
  21. package/dist/types/core/DataLayer.d.ts +210 -15
  22. package/dist/types/core/DragVisuals.d.ts +33 -4
  23. package/dist/types/core/EventEmitter.d.ts +54 -0
  24. package/dist/types/core/FilterSelect.d.ts +26 -5
  25. package/dist/types/core/FormulaEngine.d.ts +15 -4
  26. package/dist/types/core/GridRenderer.d.ts +143 -10
  27. package/dist/types/core/GridShuttle.d.ts +26 -10
  28. package/dist/types/core/GroupEngine.d.ts +68 -10
  29. package/dist/types/core/IconRegistry.d.ts +31 -13
  30. package/dist/types/core/MathUtils.d.ts +58 -5
  31. package/dist/types/core/MergeEngine.d.ts +45 -10
  32. package/dist/types/core/OGDecimal.d.ts +144 -13
  33. package/dist/types/core/OpenGrid.d.ts +401 -122
  34. package/dist/types/core/OrgChart.d.ts +32 -11
  35. package/dist/types/core/PivotEngine.d.ts +37 -0
  36. package/dist/types/core/RowDragDrop.d.ts +52 -6
  37. package/dist/types/core/SkinRegistry.d.ts +86 -19
  38. package/dist/types/core/TreeEngine.d.ts +60 -6
  39. package/dist/types/core/VirtualScroll.d.ts +64 -0
  40. package/dist/types/core/XmlConverter.d.ts +40 -0
  41. package/dist/types/core/a11y/AccessibilityAdapter.d.ts +103 -0
  42. package/dist/types/core/a11y/AriaIntent.d.ts +34 -0
  43. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +64 -0
  44. package/dist/types/core/a11y/LiveRegionController.d.ts +89 -0
  45. package/dist/types/core/a11y/OverlayStack.d.ts +36 -0
  46. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +37 -0
  47. package/dist/types/core/a11y/index.d.ts +13 -0
  48. package/dist/types/core/a11y/ports.d.ts +24 -0
  49. package/dist/types/core/appearance/Appearance.d.ts +68 -0
  50. package/dist/types/core/appearance/AppearanceAxis.d.ts +94 -0
  51. package/dist/types/core/appearance/AppearanceComposer.d.ts +45 -0
  52. package/dist/types/core/appearance/AppearanceProvider.d.ts +50 -0
  53. package/dist/types/core/appearance/AppearanceView.d.ts +51 -0
  54. package/dist/types/core/appearance/DensityRegistry.d.ts +36 -0
  55. package/dist/types/core/appearance/ResolvedAppearanceSnapshot.d.ts +84 -0
  56. package/dist/types/core/appearance/TextureRegistry.d.ts +32 -0
  57. package/dist/types/core/appearance/ThemeMetaRegistry.d.ts +67 -0
  58. package/dist/types/core/appearance/axisAdapters.d.ts +37 -0
  59. package/dist/types/core/appearance/defaults.d.ts +10 -0
  60. package/dist/types/core/appearance/index.d.ts +20 -0
  61. package/dist/types/core/appearance/tokenCatalog.d.ts +30 -0
  62. package/dist/types/core/cf/CFEngine.d.ts +56 -0
  63. package/dist/types/core/cf/CFEvaluator.d.ts +24 -0
  64. package/dist/types/core/cf/CFRule.d.ts +127 -0
  65. package/dist/types/core/cf/ColorScale.d.ts +49 -0
  66. package/dist/types/core/cf/InkResolver.d.ts +33 -0
  67. package/dist/types/core/cf/appearance.d.ts +20 -0
  68. package/dist/types/core/cf/encoders.d.ts +61 -0
  69. package/dist/types/core/cf/eval-types.d.ts +93 -0
  70. package/dist/types/core/cf/index.d.ts +21 -0
  71. package/dist/types/core/cf/lineage.d.ts +32 -0
  72. package/dist/types/core/cf/predicates.d.ts +27 -0
  73. package/dist/types/core/cf/serialize.d.ts +46 -0
  74. package/dist/types/core/chart/CanvasAdapter.d.ts +50 -1
  75. package/dist/types/core/chart/DataExtractor.d.ts +53 -12
  76. package/dist/types/core/chart/a11y.d.ts +22 -0
  77. package/dist/types/core/chart/chart-type-registry.d.ts +53 -0
  78. package/dist/types/core/chart/downsample-report.d.ts +36 -0
  79. package/dist/types/core/chart/downsample.d.ts +26 -1
  80. package/dist/types/core/chart/engine/ChartEngineRegistry.d.ts +52 -0
  81. package/dist/types/core/chart/geometry.d.ts +96 -0
  82. package/dist/types/core/chart/hittest.d.ts +21 -3
  83. package/dist/types/core/chart/palette.d.ts +96 -12
  84. package/dist/types/core/chart/parity.d.ts +12 -0
  85. package/dist/types/core/chart/provenance.d.ts +47 -0
  86. package/dist/types/core/chart/scales.d.ts +28 -1
  87. package/dist/types/core/chart/scene.d.ts +102 -0
  88. package/dist/types/core/chart/server.d.ts +36 -0
  89. package/dist/types/core/chart/surfaces/CanvasSurface.d.ts +48 -0
  90. package/dist/types/core/chart/surfaces/ServerRasterSurface.d.ts +26 -0
  91. package/dist/types/core/chart/surfaces/SvgSurface.d.ts +24 -0
  92. package/dist/types/core/chart/surfaces/pattern-overlay.d.ts +24 -0
  93. package/dist/types/core/chart/types.d.ts +102 -21
  94. package/dist/types/core/command/CommandBus.d.ts +51 -0
  95. package/dist/types/core/command/CommandRegistry.d.ts +43 -0
  96. package/dist/types/core/command/CommandStack.d.ts +38 -0
  97. package/dist/types/core/command/ICommand.d.ts +110 -0
  98. package/dist/types/core/command/commands/CellWriteCommand.d.ts +32 -0
  99. package/dist/types/core/command/commands/CompositeCommand.d.ts +17 -0
  100. package/dist/types/core/command/commands/RowCommands.d.ts +39 -0
  101. package/dist/types/core/command/index.d.ts +9 -0
  102. package/dist/types/core/command/support.d.ts +51 -0
  103. package/dist/types/core/coordinate/ColumnMetrics.d.ts +30 -0
  104. package/dist/types/core/coordinate/CoordinateKernel.d.ts +88 -0
  105. package/dist/types/core/coordinate/FrozenPanes.d.ts +29 -0
  106. package/dist/types/core/coordinate/MergeSourceAdapter.d.ts +18 -0
  107. package/dist/types/core/coordinate/NodeBudget.d.ts +33 -0
  108. package/dist/types/core/coordinate/ResizeGovernor.d.ts +50 -0
  109. package/dist/types/core/coordinate/RowMetrics.d.ts +37 -0
  110. package/dist/types/core/coordinate/ViewPermutation.d.ts +23 -0
  111. package/dist/types/core/coordinate/index.d.ts +10 -0
  112. package/dist/types/core/coordinate/ports.d.ts +45 -0
  113. package/dist/types/core/coordinate/types.d.ts +76 -0
  114. package/dist/types/core/detail/DetailGlyph.d.ts +42 -7
  115. package/dist/types/core/detail/DetailSplice.d.ts +42 -11
  116. package/dist/types/core/detail/DetailState.d.ts +80 -11
  117. package/dist/types/core/detail/SubgridCache.d.ts +72 -10
  118. package/dist/types/core/detail/index.d.ts +8 -0
  119. package/dist/types/core/domain/AggregateResult.d.ts +54 -0
  120. package/dist/types/core/domain/CellAddress.d.ts +61 -0
  121. package/dist/types/core/domain/CellValueAccess.d.ts +29 -0
  122. package/dist/types/core/domain/Delta.d.ts +37 -0
  123. package/dist/types/core/domain/DomainValue.d.ts +80 -0
  124. package/dist/types/core/domain/Missing.d.ts +65 -0
  125. package/dist/types/core/domain/Money.d.ts +42 -0
  126. package/dist/types/core/domain/NormalizationBasis.d.ts +47 -0
  127. package/dist/types/core/domain/Plain.d.ts +45 -0
  128. package/dist/types/core/domain/Quantity.d.ts +32 -0
  129. package/dist/types/core/domain/Ratios.d.ts +100 -0
  130. package/dist/types/core/domain/ThresholdSet.d.ts +46 -0
  131. package/dist/types/core/domain/ValueType.d.ts +71 -0
  132. package/dist/types/core/domain/rounding.d.ts +25 -0
  133. package/dist/types/core/domain/strategies.d.ts +38 -0
  134. package/dist/types/core/editors/DateEditor.d.ts +18 -0
  135. package/dist/types/core/editors/SelectEditor.d.ts +29 -0
  136. package/dist/types/core/export/ChannelRegistry.d.ts +18 -0
  137. package/dist/types/core/export/ExportManifest.d.ts +13 -0
  138. package/dist/types/core/export/GridArtifactSource.d.ts +62 -0
  139. package/dist/types/core/export/Provenance.d.ts +34 -0
  140. package/dist/types/core/export/StreamPump.d.ts +28 -0
  141. package/dist/types/core/export/channels/CsvChannel.d.ts +20 -0
  142. package/dist/types/core/export/channels/JsonChannel.d.ts +18 -0
  143. package/dist/types/core/export/channels/XlsxChannel.d.ts +53 -0
  144. package/dist/types/core/export/channels/XmlChannel.d.ts +21 -0
  145. package/dist/types/core/export/channels/capabilities.d.ts +13 -0
  146. package/dist/types/core/export/index.d.ts +24 -0
  147. package/dist/types/core/export/print/OutputChannelAdapter.d.ts +61 -0
  148. package/dist/types/core/export/print/Paginator.d.ts +48 -0
  149. package/dist/types/core/export/print/PrintRenderTarget.d.ts +36 -0
  150. package/dist/types/core/export/sinks.d.ts +40 -0
  151. package/dist/types/core/export/types.d.ts +211 -0
  152. package/dist/types/core/extension/DeprecationManager.d.ts +42 -0
  153. package/dist/types/core/extension/IExtension.d.ts +90 -0
  154. package/dist/types/core/extension/Registry.d.ts +142 -0
  155. package/dist/types/core/extension/SlotRegistry.d.ts +46 -0
  156. package/dist/types/core/extension/adapters.d.ts +44 -0
  157. package/dist/types/core/extension/conformance.d.ts +47 -0
  158. package/dist/types/core/extension/index.d.ts +16 -0
  159. package/dist/types/core/extension/registries.d.ts +31 -0
  160. package/dist/types/core/extension/reserved.d.ts +10 -0
  161. package/dist/types/core/format/DisplayFormatter.d.ts +47 -0
  162. package/dist/types/core/format/FormatCache.d.ts +20 -0
  163. package/dist/types/core/format/FormatterRegistry.d.ts +22 -0
  164. package/dist/types/core/format/grammar/AstRenderer.d.ts +10 -0
  165. package/dist/types/core/format/grammar/FormatCompiler.d.ts +16 -0
  166. package/dist/types/core/format/index.d.ts +55 -0
  167. package/dist/types/core/format/pipeline/DomainTypeResolver.d.ts +8 -0
  168. package/dist/types/core/format/pipeline/LocaleFormat.d.ts +11 -0
  169. package/dist/types/core/format/pipeline/ValueInterpreter.d.ts +8 -0
  170. package/dist/types/core/format/policy/MaskPolicy.d.ts +8 -0
  171. package/dist/types/core/format/policy/NegativePolicy.d.ts +12 -0
  172. package/dist/types/core/format/policy/NullPolicy.d.ts +10 -0
  173. package/dist/types/core/format/policy/TruncatePolicy.d.ts +11 -0
  174. package/dist/types/core/format/types.d.ts +292 -0
  175. package/dist/types/core/formula/CalcCacheStore.d.ts +89 -0
  176. package/dist/types/core/formula/CalcProvenance.d.ts +44 -0
  177. package/dist/types/core/formula/CalcService.d.ts +137 -0
  178. package/dist/types/core/formula/CyclePathReporter.d.ts +28 -0
  179. package/dist/types/core/formula/FormulaEvaluator.d.ts +35 -1
  180. package/dist/types/core/formula/FormulaGraph.d.ts +84 -7
  181. package/dist/types/core/formula/FormulaParser.d.ts +9 -0
  182. package/dist/types/core/formula/FormulaStore.d.ts +63 -1
  183. package/dist/types/core/formula/FunctionRegistry.d.ts +138 -0
  184. package/dist/types/core/formula/Generation.d.ts +86 -0
  185. package/dist/types/core/formula/RecalcCoordinator.d.ts +151 -9
  186. package/dist/types/core/formula/ReferenceRewriter.d.ts +81 -0
  187. package/dist/types/core/formula/functions/essential.d.ts +3 -0
  188. package/dist/types/core/formula/functions/extended/index.d.ts +10 -0
  189. package/dist/types/core/formula/normalizeRefs.d.ts +34 -3
  190. package/dist/types/core/formula/numericLiteral.d.ts +11 -1
  191. package/dist/types/core/formula/serializeFormula.d.ts +10 -1
  192. package/dist/types/core/host/CapabilityRegistry.d.ts +61 -0
  193. package/dist/types/core/host/GridHostDriver.d.ts +27 -0
  194. package/dist/types/core/host/GridHostPort.d.ts +37 -0
  195. package/dist/types/core/host/SliceOwnershipGuard.d.ts +27 -0
  196. package/dist/types/core/host/archCheck.d.ts +26 -0
  197. package/dist/types/core/host/index.d.ts +6 -0
  198. package/dist/types/core/host/reconcile.d.ts +22 -0
  199. package/dist/types/core/i18n/LocaleContext.d.ts +40 -0
  200. package/dist/types/core/i18n/LocaleRegistry.d.ts +0 -0
  201. package/dist/types/core/i18n/types.d.ts +67 -11
  202. package/dist/types/core/icons/bootstrap-icons.d.ts +4 -2
  203. package/dist/types/core/quality/ContrastAuditor.d.ts +64 -0
  204. package/dist/types/core/quality/DeterminismKernel.d.ts +68 -0
  205. package/dist/types/core/quality/PerfBaseline.d.ts +23 -0
  206. package/dist/types/core/quality/PerfSpec.d.ts +95 -0
  207. package/dist/types/core/quality/RealBrowserGate.d.ts +69 -0
  208. package/dist/types/core/quality/RegressionJudge.d.ts +35 -0
  209. package/dist/types/core/quality/ReleaseGate.d.ts +94 -0
  210. package/dist/types/core/quality/VisualRegression.d.ts +74 -0
  211. package/dist/types/core/quality/hooks.d.ts +53 -0
  212. package/dist/types/core/quality/index.d.ts +20 -0
  213. package/dist/types/core/quality/pixelMetrics.d.ts +24 -0
  214. package/dist/types/core/range/ClipboardCodec.d.ts +46 -4
  215. package/dist/types/core/range/FillEngine.d.ts +69 -9
  216. package/dist/types/core/range/RangeModel.d.ts +100 -13
  217. package/dist/types/core/range/types.d.ts +27 -11
  218. package/dist/types/core/realtime/BackpressureScheduler.d.ts +0 -0
  219. package/dist/types/core/realtime/FreshnessClock.d.ts +34 -0
  220. package/dist/types/core/realtime/IRealtimeSource.d.ts +82 -0
  221. package/dist/types/core/realtime/LiveStateGuard.d.ts +23 -0
  222. package/dist/types/core/realtime/PollingSource.d.ts +42 -0
  223. package/dist/types/core/realtime/RealtimeController.d.ts +54 -0
  224. package/dist/types/core/realtime/RtAnnouncePolicy.d.ts +53 -0
  225. package/dist/types/core/realtime/RtApplyCommand.d.ts +29 -0
  226. package/dist/types/core/realtime/RtChartTargetTrigger.d.ts +26 -0
  227. package/dist/types/core/realtime/StreamingSource.d.ts +47 -0
  228. package/dist/types/core/realtime/backoff.d.ts +12 -0
  229. package/dist/types/core/realtime/index.d.ts +13 -0
  230. package/dist/types/core/realtime/ports.d.ts +80 -0
  231. package/dist/types/core/render/CellApplier.d.ts +18 -0
  232. package/dist/types/core/render/CellErrorBoundary.d.ts +65 -0
  233. package/dist/types/core/render/CellPipeline.d.ts +39 -0
  234. package/dist/types/core/render/CellRenderRequest.d.ts +209 -0
  235. package/dist/types/core/render/CellStageRegistry.d.ts +53 -0
  236. package/dist/types/core/render/OverlayCompositor.d.ts +38 -0
  237. package/dist/types/core/render/RenderBudget.d.ts +67 -0
  238. package/dist/types/core/render/contrast.d.ts +33 -0
  239. package/dist/types/core/render/index.d.ts +35 -0
  240. package/dist/types/core/render/stages/BackgroundStage.d.ts +14 -0
  241. package/dist/types/core/render/stages/DecoratorStage.d.ts +12 -0
  242. package/dist/types/core/render/stages/OverlayStage.d.ts +12 -0
  243. package/dist/types/core/render/stages/ValueRendererStage.d.ts +15 -0
  244. package/dist/types/core/render/stages/index.d.ts +14 -0
  245. package/dist/types/core/state/AutosaveController.d.ts +63 -0
  246. package/dist/types/core/state/IStatePersistence.d.ts +59 -0
  247. package/dist/types/core/state/MultiTabGuard.d.ts +33 -0
  248. package/dist/types/core/state/SchemaMigrator.d.ts +33 -0
  249. package/dist/types/core/state/SemVerPolicy.d.ts +39 -0
  250. package/dist/types/core/state/StateCodec.d.ts +75 -0
  251. package/dist/types/core/state/index.d.ts +6 -0
  252. package/dist/types/core/types.d.ts +511 -226
  253. package/dist/types/react/OpenGrid.d.ts +54 -0
  254. package/dist/types/react/index.d.ts +5 -0
  255. package/dist/types/realtime/index.d.ts +1 -0
  256. package/dist/types/vue/index.d.ts +5 -0
  257. package/dist/types/vue/types.d.ts +35 -0
  258. package/package.json +112 -111
package/CHANGELOG.md CHANGED
@@ -1,365 +1,388 @@
1
- # Changelog
2
-
3
- All notable changes to OPEN_GRID will be documented in this file.
4
-
5
- ## [1.2.1] - 2026-07-05
6
-
7
- ### Fixed
8
- - **ES 번들 미니파이** / **ES bundle minification.** Vite lib 모드가 ES 포맷 청크에 minify 를
9
- 적용하지 않아 ESM(`module`) 번들 전체가 비압축(주석·공백 포함)으로 배포되던 문제를 수정.
10
- 이제 모든 청크를 esbuild 로 압축하고 JSDoc 주석을 번들에서 제거한다 —
11
- ES 코어 청크 gzip **135KB → 98KB (약 -27%)**. (이전 모든 버전에 존재하던 결함)
12
-
13
- ### Docs
14
- - 공개 API 선언 원본·오케스트레이터/매니저 38개 파일에 한·영 병행 JSDoc 확대.
15
- - 번들 사이즈 게이트 추가 (`npm run size`).
16
-
17
- ## [1.2.0] - 2026-07-05
18
-
19
- ### Added
20
- - **다국어(i18n) — 리소스 분리** / **Internationalization — separated resources.**
21
- UI 문자열(라벨·aria-label·announce·툴팁·플레이스홀더)을 코어에서 분리해 로케일 카탈로그로 관리.
22
- `SkinRegistry`/`IconRegistry`와 동형인 `LocaleRegistry`(전역 싱글턴 + 인스턴스별 child 체인 + never-throw 폴백).
23
- - 옵션: `new OpenGrid(el, { locale: 'en', messages: { ... } })`
24
- - 메서드: `grid.setLocale('en')` / `grid.getLocale()` / `grid.setMessage(key, value)` / `grid.t(key, params)`
25
- - 등록: `localeRegistry.register('ja', { ... })`, `OpenGrid.defineLocale(id, messages)`
26
- - 내장 로케일 `ko`(기본)·`en`. 폴백 체인 = 인스턴스 오버라이드 → 활성 로케일 → ko → 키 원문.
27
- - `setLocale` 시 상주 크롬(페이지네이션·찾기 바) 재라벨 + 컨텍스트메뉴/필터패널 재구성 + `lang` 속성 갱신 + `localeChange` 이벤트.
28
- - 공개 export: `LocaleRegistry`/`localeRegistry`/`t` + 타입 `LocaleMessages`/`PartialLocaleMessages`/`LocaleMessageKey`/`MessageValue`.
29
-
30
- ### Changed
31
- - **하위호환 보장** — 기본 로케일 `ko` 고정. `locale`/`messages` 미지정 시 렌더 결과는 이전과 동일(byte-identical).
32
- 개발자 대면 오류 메시지(throw/console)와 숫자·날짜 포맷은 i18n 범위에서 제외(로그 안정성·별도 축).
33
-
34
- ### Docs
35
- - **TypeDoc API 문서 파이프라인** — `npm run docs`로 공개 API 문서 생성. 공개 표면에 한·영 병행 JSDoc.
36
-
37
- ## [1.1.1] - 2026-07-04
38
-
39
- ### Added
40
- - **스킨 (형태 축)** — 색 테마와 직교하는 형태 스킨 6종(sharp/rounded/stitch/flat/high-contrast/material).
41
- `data-og-skin` 속성 + `grid.setSkin(name)`, `OpenGrid.defineSkin(name, delta)`(FORM 토큰만 허용), `grid.setSkinVar(k,v)`.
42
- 색 테마와 자유 조합(예: crimson 테마 + stitch 스킨). 접근성 위험이 있는 neumorph는 기본 카탈로그에서 제외.
43
- - **아이콘 세트** — Bootstrap Icons(MIT) 기반 역할(role) 아이콘 64종. `renderIcon(role, {size})`,
44
- `grid.setIcon(role, key)`(인스턴스 격리), `OpenGrid.defineIconSet(map)`(전역). 공개 export 추가:
45
- `renderIcon`/`IconRegistry`/`iconRegistry`/`DEFAULT_ICON_ROLES`/`SkinRegistry`/`skinRegistry`.
46
- - **버튼 렌더러 아이콘** — `renderer:{ type:'button', icon:'search', label:'…', iconPos:'left'|'right' }`로
47
- 버튼 라벨과 아이콘을 함께 표시.
48
-
49
- ### Changed
50
- - 그리드 셀/행/헤더 보더를 `--og-border-style`/`--og-divider-style` 토큰으로 승격 — 스킨이 선(보더 스타일)을 제어한다.
51
- 토큰 미설정 시 `solid` 폴백(기존 렌더와 동일).
52
- - 내부 코어 리팩토링(협력자 분리) — 공개 API·동작 변화 없음(행동 보존).
53
-
54
- ### Notes
55
- - Bootstrap Icons(MIT) 라이선스를 `THIRD_PARTY_LICENSES.txt`에 포함.
56
-
57
- ## [1.1.0] - 2026-07-03
58
-
59
- ### Added
60
- - **범위 선택 + 채우기 (F1)** — 셀 범위를 드래그로 선택하고 복제/시리즈 채우기, 클립보드(TSV) 복사·붙여넣기,
61
- 키보드 채우기(Ctrl+D/R)를 지원한다. `rangeSelection` 옵션, `fillRange`/`getActiveRange`/`getRangeValues` API.
62
- - **마스터/디테일 (F2)** — 행을 펼쳐 상세 패널(HTML renderer 또는 서브그리드)을 표시한다. `masterDetail` 옵션,
63
- `expandRow`/`collapseRow`/`getDetailInstance` API, `rowExpand` 이벤트, 중첩 깊이 제한.
64
- - **수식 셀 (F3)** — 셀에 `=B1*C1`, `=SUM(C1:C10)` 같은 수식을 넣어 자동 계산한다. `[field]`/A1 참조 공존,
65
- 19개 함수, 정밀 산술, 에러 코드(#REF/#VALUE/#CYCLE 등), 정렬·필터·행삭제 시 안정적 재계산.
66
- `formula` 옵션, `setCellFormula`/`getCellFormula` API, `formulaRecalc`(대량 재계산 시 `large` 신호) 이벤트.
67
- - **그리드 데이터 통합 차트 (F4)** — 그리드 데이터로 bar/line 차트를 호출 한 번에 그린다. 5종 소스
68
- (columns/checked/selection/all/range), LTTB 다운샘플 + 샘플링 배지, 라이브 갱신(데이터·수식 편집 반영),
69
- 색약 대응 팔레트, 접근성(role=img·시각숨김 데이터표·키보드 순회·실 button 범례), 외부 런타임 의존성 0의
70
- 내장 canvas 렌더러. `chart` 옵션, `createChart`/`getCharts`/`destroyCharts` API.
71
- - **stitch 테마** — 리넨/크라프트 색감에 실땀(점선) 보더를 입힌 핸드크래프트 스타일 테마. 12개 → 13개 내장 테마.
72
- - **`fallbackViewportHeight` 옵션 (옵트인 안전장치)** — 그리드 컨테이너에 확정 높이가 없어 대량 데이터에서
73
- 전 행이 DOM 렌더되는 것을 막는다. 기본 OFF(기존 동작 완전 불변)이며, 컨테이너가 스크롤 제약 없이 전
74
- 콘텐츠를 담는 "언바운드" 상태를 감지했을 때만 가상 스크롤 뷰포트를 이 값(px)으로 클램프한다.
75
- (1순위 권장은 여전히 그리드 컨테이너에 확정 높이를 주는 것.)
76
-
77
- ### Fixed
78
- - 통합 차트(F4) 코어 리뷰 반영 — 사용자 지정 `size` 좌표가 히트테스트/툴팁에 반영되지 않던 문제,
79
- 라이브 재렌더 시 범례 포커스 유실, 컨테이너 리사이즈/DPR 변경 시 재렌더 부재 등 12건 수정.
80
-
81
- ## [1.0.8] - 2026-07-01
82
-
83
- ### Fixed
84
- - **`grid.override('getDisplayValue')` 커스터마이징이 셀 화면에 반영되지 않던 버그 수정** —
85
- 텍스트·불리언 등 셀 렌더 경로가 내부적으로 `getDisplayValue()`를 거치지 않아,
86
- `getDisplayValue`를 오버라이드해도 셀에 표시되는 값이 바뀌지 않던 문제를 고쳤다.
87
- 이제 렌더러가 인스턴스 콜백을 통해 `getDisplayValue()` 결과를 표시값으로 사용한다.
88
- 오버라이드·전략이 등록되지 않은 경우 기존 렌더 경로로 폴백하므로 기존 동작은
89
- 100% 보존된다(출력 바이트 동일, 회귀 없음). 단위 테스트 408건 통과.
90
-
91
- ## [1.0.7] - 2026-06-27
92
-
93
- ### Fixed
94
- - **워크시트(다중 시트) 데이터 미표시 버그 수정** — `addWorksheet()`로 시트를 추가하거나 탭을
95
- 전환할 때 헤더·탭은 그려지지만 **데이터 행이 렌더되지 않던** 문제를 고쳤다. 원인은 시트 전환
96
- 콜백이 내부 데이터만 갱신하고 가상 스크롤(virtual scroll)의 총 행수를 갱신하지 않아 보이는
97
- 행 범위가 비어 있었던 것. 시트 전환 시 `setData`와 동일한 경로(총 행수·aria·컬럼 폭 재계산)를
98
- 거치도록 통합해 시트마다 컬럼 구성이 달라도 올바르게 표시된다.
99
-
100
- ## [1.0.6] - 2026-06-26
101
-
102
- ### Changed
103
- - 메타데이터·문서 정리(기능·동작 변경 없음). 발행 패키지를 경량화(소스맵 제외)했다.
104
-
105
- ## [1.0.5] - 2026-06-24
106
-
107
- ### Changed
108
- - **런타임 의존성 0 (zero runtime dependencies)** — Excel 내보내기에 쓰이는 `xlsx`·`xlsx-js-style`을
109
- `dependencies` → `devDependencies`로 옮겼다. 이들은 **빌드 시 `dist/`에 번들로 포함**되므로
110
- (`src`의 `import('xlsx-js-style')`가 빌드 과정에서 `dist/xlsx.min-*.js` 청크로 변환됨),
111
- 설치하는 쪽에서 별도로 받을 필요가 없다 — `npm install open-grid`는 외부 런타임 의존성을
112
- 하나도 끌어오지 않는다. **Excel 내보내기는 번들된 SheetJS로 그대로 동작**한다(설치 불필요).
113
- 코드·동작 변경 없음(의존성 분류만 정정). 번들된 SheetJS는 Apache-2.0이며 `NOTICE`/`THIRD_PARTY_LICENSES.txt`로 귀속 표기됨.
114
-
115
- ## [1.0.4] - 2026-06-24
116
-
117
- ### Changed
118
- - **소개 문구(intro) 추가** — README 상단과 npm `description`에 제품 소개 문구를 추가하고
119
- npm 배지 버전 표기를 현행화했다. 코드·기능 변경 없음(문서/메타데이터만).
120
- ("zero-dependency **core**" — Excel 내보내기는 SheetJS를 번들하므로 "코어 무의존"으로 정확히 표기.)
121
-
122
- ## [1.0.3] - 2026-06-24
123
-
124
- ### Changed
125
- - **라이선스 준수 내역을 배포 패키지에 명시** — 발행 tarball에 `CHANGELOG.md`를 포함하고,
126
- README·변경 이력에 1.0.2의 라이선스 컴플라이언스 조치(아래)를 명확히 기재했다.
127
- 코드·기능 변경 없음(문서/배포 메타데이터만).
128
-
129
- ## [1.0.2] - 2026-06-24
130
-
131
- ### Fixed — 라이선스 컴플라이언스 (잠재적 라이선스 위반 소지 해소)
132
- - **문제** — Excel 내보내기 기능에 쓰이는 `xlsx`(SheetJS Community Edition)와
133
- `xlsx-js-style`는 **Apache License 2.0** 라이선스이며 빌드 결과물(`dist/`)에 번들되어
134
- 함께 배포된다. 그런데 1.0.1까지의 배포 패키지에는 OPEN_GRID 자체의 **MIT LICENSE만**
135
- 들어 있고, Apache-2.0가 재배포 시 요구하는 **라이선스 사본과 저작권 귀속 고지가 누락**
136
- 되어 있었다(Apache-2.0 §4(a)·§4(c) 미충족 → **잠재적 라이선스 위반 소지**).
137
- - **해결** — 배포 패키지에 다음을 추가하고 `files`에 포함해 함께 배포한다:
138
- - `THIRD_PARTY_LICENSES.txt` — Apache License 2.0 **전문** + 번들 구성요소 식별·저작권 고지
139
- - `NOTICE` — SheetJS LLC(`xlsx`) 및 SheetJS LLC·Brent Ely(`xlsx-js-style`) 저작권 귀속
140
- - README에 "Third-party licenses" 안내 추가
141
- - **영향 범위** — OPEN_GRID 본체 라이선스(MIT)와 코드는 **변경 없음**. MIT와 Apache-2.0는
142
- 서로 호환되어 **라이선스 충돌은 없으며**, 누락돼 있던 Apache-2.0 **귀속 의무만 충족**시킨
143
- 조치다.
144
-
145
- ## [1.0.1] - 2026-06-24
146
-
147
- ### Fixed
148
- - **그리드 초기화 크래시 수정** — `summary` 푸터를 사용하는 그리드를 생성할 때
149
- `Cannot read properties of undefined (reading 'getStrategy')` 로 초기화가 실패하던 문제.
150
- 생성자에서 OverrideKernel 부착(및 strategy resolver 배선)을 최초 마운트 **이전**으로
151
- 옮겨, 초기 푸터/그룹 렌더가 strategy 슬롯을 조회할 때 커널이 항상 준비되도록 했다.
152
- (피벗·집계 푸터·그룹 합계 등 `summary`/`footer` 옵션을 쓰는 모든 구성에 영향.)
153
-
154
- ## [1.0.0] - 2026-06-23
155
-
156
- 첫 정식 메이저 릴리스. 본문(코어) 코드 무수정으로 동작을 확장하는 `grid.override()` API와 헤더 줄바꿈을 추가.
157
-
158
- ### Added
159
- - **`grid.override()` — 본문 무수정 동작 확장 API** (신규 `src/core/OverrideKernel.ts`)
160
- - `grid.override(name, (orig, ...args) => result)` — 메서드 래핑. `orig()`는 `super`처럼 항상 호출 가능.
161
- 합성 순서는 FIFO 좌측폴드(나중에 건 것이 가장 바깥), 재진입 깊이 32 + 사이클 가드.
162
- - `grid.override.strategy(slot, fn)` — 6개 알고리즘 슬롯 교체: 정렬 비교(sortComparator),
163
- 필터 술어(filterPredicate), 표시 포맷터(displayFormatter), 엑셀 직렬화(cellSerializer),
164
- 그룹 키(groupKeyFn), 집계 연산(summaryOp).
165
- - `grid.restore(name)` / `grid.restoreAll()` — 원복. `destroy()` 시 자동 전체 복원.
166
- - `OpenGrid.defaultOverride(name, fn)` / `OpenGrid.defaults.strategy(slot, fn)` — 전역(앞으로 생성될 모든 그리드) 기본 오버라이드.
167
- - 오류는 기본(strict) 그대로 전파. 기존 메서드 본문은 한 줄도 수정하지 않음(C1 원칙 준수).
168
- - **헤더 줄바꿈** — `ColumnDef.headerWrap?: boolean` + 헤더 문자열 `\n` 줄바꿈 + 헤더 높이 자동 확장.
169
- - **override 데모 32종 × 5 프레임워크**(Vanilla/React/Vue/jQuery/Angular) — `examples/override/`, 허브 포함.
170
- - **그리드 튜닝 참고자료 페이지** — 아키텍처/시퀀스 UML 다이어그램 기반 내부 동작 설명.
171
- - **AI 에이전트용 override 가이드**(KO/EN) + 개발 가이드 override 챕터.
172
-
173
- ### Tests
174
- - override 코어 + 헤더 줄바꿈 단위 테스트 추가. 전체 테스트 통과(회귀 0).
175
-
176
- ## [0.3.2] - 2026-06-18
177
-
178
- ### Fixed
179
- - **셀 줄바꿈(col.wrap)이 실제로 꺾이지 않던 문제** — `.og-cell--wrap` 는 셀에 적용됐지만, 내부 텍스트
180
- span(`.og-cell-text`)을 렌더러가 인라인 `white-space:nowrap` 으로 렌더해 클래스만으로는 못 이겼다.
181
- `.og-cell--wrap .og-cell-text/.og-cell-date { white-space: normal !important; text-overflow: clip !important }`
182
- 로 인라인을 무력화. e2e 도 셀이 아닌 **내부 span + 실제 줄 수**를 검증하도록 강화.
183
- (npm `open-grid@0.3.1` 은 이 수정 직전에 발행되어 wrap 미동작 → **0.3.2 로 재발행**, npm latest = 0.3.2.)
184
-
185
- ## [0.3.1] - 2026-06-17
186
-
187
- ### Fixed
188
- - **Host CSS isolation — 임베드 시 호스트 테마 CSS inbound 상속으로 레이아웃/색상 깨짐** (foxnail.kr/WordPress 통합에서 발견)
189
- - 원인: 헤더가 실제 `<table>`/`<th>` 라서, 임베드 호스트(WordPress 등)의 element/높은 특이도 셀렉터
190
- (`th,td`, `.entry-content th`, `.fn-post-content th` 등)가 그리드 헤더로 침범 — `line-height`, `border`,
191
- `background`, `color`, `table{margin}` 등이 새어들어와 헤더가 깨지거나 호스트 색(navy/white)으로 칠해짐.
192
- 바디는 `<div>` 라 안전. (헤더 `<th>` 는 element 셀렉터라 그리드의 클래스/상속값을 이김)
193
- - `src/core/GridRenderer.ts` — 헤더 `<th>` 의 모든 시각 속성을 **인라인으로 고정**(인라인이 호스트 셀렉터를 이김):
194
- `background`/`color`/`line-height`/`font-size`/`vertical-align`/`border-top·left` (data + extra/rownumber/check 컬럼 전부).
195
- 헤더 `<table>` 에 `og-header-table` 클래스 부여 + 인라인 `margin:0;border-spacing:0`.
196
- - `src/styles/base.css` — `.og-container { line-height: normal }` (바디 셀 메트릭 격리) 및 헤더 클래스 기본 방어.
197
- - **WordPress 전역 스타일 `:where([style*="border-color"]){border-style:solid}` 대응** — 그리드 인라인 보더가
198
- `var(--og-border-color)` 를 참조해 "border-color" 문자열에 매칭되면, 폭 미지정 변에 `medium`(3px) 보더가
199
- 강제돼 헤더(`.og-header`)·그룹행·병합셀의 좌/우/상에 굵은 선이 생기고 바디 컬럼선과 어긋나던 문제 수정.
200
- `GridRenderer.ts` 의 단일변 인라인 보더에 `border:0` 선행(미지정 변 폭 0 명시). 테마 무관(전 테마 동일 적용).
201
- - **컨텍스트메뉴 위치 — 임베드 호스트의 transform 조상 아래에서 마우스 좌표를 벗어남** (그리드 너비 확대 시 두드러짐)
202
- - `src/core/ContextMenu.ts` — 메뉴를 그리드 컨테이너 대신 `document.body` 에 부착 → `position:fixed` 가
203
- 항상 뷰포트 기준으로 동작. 테마 변수 보존을 위해 `data-og-theme` 복사 + `.og-context-menu` 에 `--og-cm-*` 정의 확장.
204
-
205
- ### Added
206
- - **셀 툴팁** — `column.tooltip`(문자열|함수) 또는 그리드 옵션 `tooltips: true`(모든 셀에 값 자동 노출).
207
- 헤더 셀도 `title` 노출(잘린 헤더 가독성).
208
- - **셀 줄바꿈(wrap)** — `column.wrap: true` 시 nowrap+ellipsis 대신 여러 줄 표시(`white-space:normal`).
209
- 가상 스크롤 고정 행 높이와 함께 `rowHeight` 확대 권장.
210
- - 회귀 테스트: `test/e2e/host-isolation.spec.ts` + 적대적 호스트 픽스처 `examples/host-isolation/`
211
- (line-height/border/margin/색상 격리 + 컨텍스트메뉴 transform 조상 + 툴팁/wrap, before/after 변별 — 10 케이스).
212
-
213
- ## [0.3.0] - 2026-06-05
214
-
215
- ### Added
216
- - **개발 가이드 DB화 완성** — 39개 섹션 전체 SQLite DB화 (G1~G6)
217
- - G1: 시작하기 (npm 설치, 퀵스타트, 기본 설정)
218
- - G2: 데이터/옵션 (컬럼 정의, 데이터 옵션, 선택/체크박스/DnD/상태 관리)
219
- - G3: 편집/이벤트 (셀 편집, 셀 타입, 마스킹, 병합, 이벤트, 트리거)
220
- - G4: 그룹/페이징 (그룹, 트리, 푸터, 페이지네이션, 파인드바, 키보드)
221
- - G5: 고급/내보내기 (피벗, 워크시트, SAP, XML, 수식, 조직도, Excel/CSV/인쇄)
222
- - G6: 스타일/API (테마, 커스텀, 폰트, 사이징, 접근성, 그리드/컬럼/이벤트 API)
223
- - **전 프레임워크 데모 완성** — React / Vue / jQuery / Angular / Vanilla 각 49개 섹션
224
- - Angular A~H: AngularJS 1.x CDN 기반, `$scope.$apply` 없이 ng-show/ng-hide 패턴
225
- - **Guide 렌더러** — `lang='html'` 감지 시 innerHTML 직접 주입 방식으로 전환 (pre/code 래핑 없음)
226
-
227
- ## [0.2.0] - 2026-06-04
228
-
229
- ### Fixed
230
- - **Formula 셀 클릭 버그** — `CellEventHandler.ts`: formula 컬럼 cellClick 시 `e.value`가 `undefined`이던 문제 수정
231
- - `row[col.field]` 대신 `evaluateFormula()`로 직접 계산 후 주입
232
-
233
- ### Added
234
- - **React 데모** — `demo-react/index.php` 신규 (React 18 CDN, `useRef+useEffect+createRoot` 패턴)
235
- - React 프레임워크 전 섹션(A~H, 49개) DB 삽입 완료
236
- - 선택/필터셀렉트 API 버그 수정 (`getSelections()`, `valueMap` 기반 표시)
237
-
238
- ## [0.1.2] - 2026-05-30
239
-
240
- ### Added (Sprint 29 추가분)
241
- - **변경 추적 API 보강**
242
- - `getChanges()` — `{ added, edited, removed }` 한 번에 반환. edited 행에 `_changedFields` 포함
243
- - `getEditedRows()` — 수정된 행만 반환 (기존 `getChangedRows()` 개선판)
244
- - `getChangedColumns()` — `{ row, fields, diff[] }` 형태로 컬럼 단위 diff 반환 (oldValue/newValue 포함)
245
- - `getOriginalRow(rowIndex)` — 수정 전 원본 행 데이터 반환
246
- - **합계 / 소계 (Footer)**
247
- - `setFooter(FooterDef[])` — 런타임 푸터 설정 (SUM/AVG/MIN/MAX/COUNT)
248
- - `getFooterValue(field)` — 특정 필드 집계 결과 조회
249
- - `getFooterData()` — 전체 집계 데이터 배열 조회
250
- - OGDecimal 기반 정밀 계산 — 소수점 누적 오류 없음 (0.1 × 10 = 정확히 1.00)
251
- - 데이터 수정/추가/삭제 시 푸터 자동 재계산
252
- - **Guide** — Ch26(변경 추적), Ch27(합계/소계) 추가 → 총 27챕터
253
- - **Vanilla 데모** — '변경 추적' 섹션, '합계/소계' 섹션 추가
254
-
255
- ## [0.1.1] - 2026-05-30
256
-
257
- ### Added (Sprint 29)
258
- - **columnReorder** — `columnReorder: true` 옵션으로 헤더 드래그 컬럼 순서 변경 지원
259
- - `onColumnReorder` 이벤트 콜백 (`{ fromIndex, toIndex, field }`)
260
- - 드래그 중 시각 피드백 (`og-col-dragging` / `og-col-drop-over` CSS 클래스)
261
- - **Guide** — 개발 가이드 4개 챕터 신규 추가 (Ch22~Ch25)
262
- - Ch22: 데이터 마스킹 (10종 타입, 셀/컬럼 단위 해제, maskOnExport)
263
- - Ch23: 조직도 (OrgChart API, setData, expandAll/collapseAll, 테마 연동)
264
- - Ch24: 페이지네이션 (API, 서버사이드, React/Vue 예제)
265
- - Ch25: 키보드 단축키 (WCAG 2.2 준수 표, aria-label 설정)
266
- - **E2E Tests** — sprint29.spec.ts 25개 시나리오 추가
267
- - checkColumn 선택/해제, 컨텍스트 메뉴 렌더링/닫힘, 테마 전환(data-og-theme), 키보드 네비게이션, 셀 편집, 정렬(aria-sort)
268
-
269
- ### Changed
270
- - `GridRenderer` 내부 콜백에 `onColDragStart` / `onColDrop` / `getColDragIdx` 추가
271
-
272
- ## [0.1.0] - 2026-05-24
273
-
274
- ### Added
275
- - **Core Engine**
276
- - `OpenGrid` class — main grid instance with `new OpenGrid(container, options)` API
277
- - `DataLayer` — CRUD, state tracking (added/edited/removed), sort, filter
278
- - `VirtualScroll` — rAF-based rendering with row pooling (100k+ rows)
279
- - `ColumnLayout` — group headers, frozen columns, flex widths
280
- - `EventEmitter` — on/once/off/emit event system
281
-
282
- - **Cell Renderers** (8 types)
283
- - text, number (format), date, checkbox, button, badge, link, template
284
-
285
- - **Cell Editors** (5 types)
286
- - text, number, select, date, checkbox
287
- - Inline editing: click / dblclick / F2 entry, Enter/Tab/Esc exit
288
-
289
- - **Grouping + Summary**
290
- - `groupBy(fields[])` — multi-level hierarchical grouping
291
- - `summary` option — SUM / AVG / MIN / MAX / COUNT per column
292
- - `expandAll()` / `collapseAll()` / `clearGroup()`
293
-
294
- - **Tree Grid**
295
- - `enableTree()` / `disableTree()` — flat-to-tree via `treeId` / `treeParentId`
296
- - `expandNodes(ids)` / `expandAllNodes()` / `collapseAllNodes()`
297
- - Indent + toggle arrow rendering per depth level
298
-
299
- - **Cell Merge**
300
- - `mergeCells([{row, col, rowSpan?, colSpan?}])` — manual merge
301
- - `autoMerge(fields[])` — auto rowSpan for consecutive identical values
302
- - `clearMerge()` — remove all merges
303
-
304
- - **Row Drag & Drop**
305
- - `draggable: true` option
306
- - Ghost row + drop indicator
307
- - `reorderRow(from, to)` public API
308
- - `onRowDrop` callback
309
-
310
- - **Filter UI**
311
- - Column header filter icon
312
- - 9 operators: `=`, `!=`, `contains`, `startsWith`, `endsWith`, `>`, `<`, `>=`, `<=`
313
-
314
- - **Export**
315
- - `exportExcel(options?)` — SheetJS xlsx (dynamic import, code-split)
316
- - `exportCsv(options?)` — BOM-aware CSV
317
- - `exportJson(options?)` — JSON download
318
-
319
- - **Pagination**
320
- - `pagination: true` + `pageSize` option
321
- - Page size selector (10/20/50/100/200)
322
- - First/Prev/Next/Last navigation
323
-
324
- - **Keyboard Navigation**
325
- - Arrow keys — cell navigation
326
- - Tab / Shift+Tab — next/prev cell
327
- - F2 / Enter — start edit
328
- - Escape — cancel edit / clear focus
329
- - Ctrl+C / Ctrl+V — clipboard
330
-
331
- - **UI**
332
- - Column resize (drag)
333
- - Multi-sort (Shift+click)
334
- - Dark theme (`theme: 'dark'`)
335
- - CSS Variables — full theme customization
336
- - `setTheme(theme)` / `setThemeVar(key, value)`
337
-
338
- - **Vue 3 Component** (`open-grid/vue`)
339
- - Composition API, `defineProps` / `defineEmits`
340
- - Reactive `data` / `columns` watchers
341
- - `grid` instance exposed via `defineExpose`
342
-
343
- - **React 18 Component** (`open-grid/react`)
344
- - Hooks-based (`useRef`, `useEffect`)
345
- - `OpenGridReact` + `OpenGridWithRef` (forwardRef)
346
- - `stateColumn`, `draggable`, `onRowDrop` props
347
-
348
- - **API Naming** — distinctive, self-consistent method names
349
- - `readCell`, `writeCell` for cell access
350
- - `orderBy` for sorting
351
- - `jumpToRow` for scrolling
352
- - `getSelections` for selection
353
- - (40+ purpose-built method names)
354
-
355
- ### Performance
356
- - Multi-sort 100k rows: 1789ms → **40ms** (44× improvement via Schwartzian transform)
357
- - Single sort 100k rows: ~38ms
358
- - Filter 100k rows: ~17ms
359
- - Group build 100k rows: ~3ms (5 groups)
360
- - Tree build 100k rows: ~25ms
361
-
362
- ### Tests
363
- - 124 unit tests across 7 test files
364
- - EventEmitter (7), DataLayer (14), GroupEngine (18), TreeEngine (20),
365
- MergeEngine (16), CellEditor (23), CellRenderer (26)
1
+ # Changelog
2
+
3
+ All notable changes to OPEN_GRID will be documented in this file.
4
+
5
+ ## [1.3.1] - 2026-07-15
6
+
7
+ ### Docs
8
+ - **공개 API JSDoc 인간화** / **Human-readable public API JSDoc.** TypeDoc 이 소비하는 공개
9
+ 표면(OpenGrid·GridOptions/ColumnDef·i18n·Icon/Skin·GridShuttle·OrgChart·XmlConverter·
10
+ FilterSelect·chart 타입)의 주석을 "언제·왜 쓰나 + 무엇을 얻나" 중심으로 다시 써서
11
+ 읽기 쉽게 승격하고, 표준 IT 용어로 교정했다. `@example` 다수 추가.
12
+ 코드 로직은 한 줄도 바뀌지 않았다(주석 전용).
13
+ / Rewrote the comments on the public API surface consumed by TypeDoc to lead with
14
+ when/why-to-use and what-you-get, added many `@example`s, and normalized terminology.
15
+ No logic changed (comments only).
16
+
17
+ ## [1.3.0] - 2026-07-15
18
+
19
+ ### Added
20
+ - **조건부서식(CF)** / Conditional formatting — 데이터바·히트맵·아이콘셋·규칙 우선순위(DD-05).
21
+ - **통합 차트 서브시스템** / Integrated chart subsystem — 헤드리스 차트 코어·소스 어댑터(DD-06).
22
+ - **실시간 데이터** / Realtime data — 스트리밍/폴링 소스·백프레셔(DD-07).
23
+ - **외관 신규 축** / Appearance axes — 밀도(density)·질감(texture) setter (DD-11).
24
+
25
+ ### Notes
26
+ - 데모/차트 연동(Apache ECharts)은 라이브러리에 번들되지 않으며 외부에서 로드된다(번들 크기 영향 0).
27
+
28
+ ## [1.2.1] - 2026-07-05
29
+
30
+ ### Fixed
31
+ - **ES 번들 미니파이** / **ES bundle minification.** Vite lib 모드가 ES 포맷 청크에 minify 를
32
+ 적용하지 않아 ESM(`module`) 번들 전체가 비압축(주석·공백 포함)으로 배포되던 문제를 수정.
33
+ 이제 모든 청크를 esbuild 로 압축하고 JSDoc 주석을 번들에서 제거한다 —
34
+ ES 코어 청크 gzip **135KB → 98KB (약 -27%)**. (이전 모든 버전에 존재하던 결함)
35
+
36
+ ### Docs
37
+ - 공개 API 선언 원본·오케스트레이터/매니저 38개 파일에 한·영 병행 JSDoc 확대.
38
+ - 번들 사이즈 게이트 추가 (`npm run size`).
39
+
40
+ ## [1.2.0] - 2026-07-05
41
+
42
+ ### Added
43
+ - **다국어(i18n) — 리소스 분리** / **Internationalization — separated resources.**
44
+ UI 문자열(라벨·aria-label·announce·툴팁·플레이스홀더)을 코어에서 분리해 로케일 카탈로그로 관리.
45
+ `SkinRegistry`/`IconRegistry`와 동형인 `LocaleRegistry`(전역 싱글턴 + 인스턴스별 child 체인 + never-throw 폴백).
46
+ - 옵션: `new OpenGrid(el, { locale: 'en', messages: { ... } })`
47
+ - 메서드: `grid.setLocale('en')` / `grid.getLocale()` / `grid.setMessage(key, value)` / `grid.t(key, params)`
48
+ - 등록: `localeRegistry.register('ja', { ... })`, `OpenGrid.defineLocale(id, messages)`
49
+ - 내장 로케일 `ko`(기본)·`en`. 폴백 체인 = 인스턴스 오버라이드 → 활성 로케일 → ko → 키 원문.
50
+ - `setLocale` 시 상주 크롬(페이지네이션·찾기 바) 재라벨 + 컨텍스트메뉴/필터패널 재구성 + `lang` 속성 갱신 + `localeChange` 이벤트.
51
+ - 공개 export: `LocaleRegistry`/`localeRegistry`/`t` + 타입 `LocaleMessages`/`PartialLocaleMessages`/`LocaleMessageKey`/`MessageValue`.
52
+
53
+ ### Changed
54
+ - **하위호환 보장** — 기본 로케일 `ko` 고정. `locale`/`messages` 미지정 시 렌더 결과는 이전과 동일(byte-identical).
55
+ 개발자 대면 오류 메시지(throw/console)와 숫자·날짜 포맷은 i18n 범위에서 제외(로그 안정성·별도 축).
56
+
57
+ ### Docs
58
+ - **TypeDoc API 문서 파이프라인** — `npm run docs`로 공개 API 문서 생성. 공개 표면에 한·영 병행 JSDoc.
59
+
60
+ ## [1.1.1] - 2026-07-04
61
+
62
+ ### Added
63
+ - **스킨 (형태 축)** — 색 테마와 직교하는 형태 스킨 6종(sharp/rounded/stitch/flat/high-contrast/material).
64
+ `data-og-skin` 속성 + `grid.setSkin(name)`, `OpenGrid.defineSkin(name, delta)`(FORM 토큰만 허용), `grid.setSkinVar(k,v)`.
65
+ 색 테마와 자유 조합(예: crimson 테마 + stitch 스킨). 접근성 위험이 있는 neumorph는 기본 카탈로그에서 제외.
66
+ - **아이콘 세트** — Bootstrap Icons(MIT) 기반 역할(role) 아이콘 64종. `renderIcon(role, {size})`,
67
+ `grid.setIcon(role, key)`(인스턴스 격리), `OpenGrid.defineIconSet(map)`(전역). 공개 export 추가:
68
+ `renderIcon`/`IconRegistry`/`iconRegistry`/`DEFAULT_ICON_ROLES`/`SkinRegistry`/`skinRegistry`.
69
+ - **버튼 렌더러 아이콘** — `renderer:{ type:'button', icon:'search', label:'…', iconPos:'left'|'right' }`로
70
+ 버튼 라벨과 아이콘을 함께 표시.
71
+
72
+ ### Changed
73
+ - 그리드 셀/행/헤더 보더를 `--og-border-style`/`--og-divider-style` 토큰으로 승격 — 스킨이 선(보더 스타일)을 제어한다.
74
+ 토큰 미설정 시 `solid` 폴백(기존 렌더와 동일).
75
+ - 내부 코어 리팩토링(협력자 분리) — 공개 API·동작 변화 없음(행동 보존).
76
+
77
+ ### Notes
78
+ - Bootstrap Icons(MIT) 라이선스를 `THIRD_PARTY_LICENSES.txt`에 포함.
79
+
80
+ ## [1.1.0] - 2026-07-03
81
+
82
+ ### Added
83
+ - **범위 선택 + 채우기 (F1)** — 셀 범위를 드래그로 선택하고 복제/시리즈 채우기, 클립보드(TSV) 복사·붙여넣기,
84
+ 키보드 채우기(Ctrl+D/R)를 지원한다. `rangeSelection` 옵션, `fillRange`/`getActiveRange`/`getRangeValues` API.
85
+ - **마스터/디테일 (F2)** — 행을 펼쳐 상세 패널(HTML renderer 또는 서브그리드)을 표시한다. `masterDetail` 옵션,
86
+ `expandRow`/`collapseRow`/`getDetailInstance` API, `rowExpand` 이벤트, 중첩 깊이 제한.
87
+ - **수식 셀 (F3)** — 셀에 `=B1*C1`, `=SUM(C1:C10)` 같은 수식을 넣어 자동 계산한다. `[field]`/A1 참조 공존,
88
+ 19개 함수, 정밀 산술, 에러 코드(#REF/#VALUE/#CYCLE 등), 정렬·필터·행삭제 시 안정적 재계산.
89
+ `formula` 옵션, `setCellFormula`/`getCellFormula` API, `formulaRecalc`(대량 재계산 시 `large` 신호) 이벤트.
90
+ - **그리드 데이터 통합 차트 (F4)** — 그리드 데이터로 bar/line 차트를 호출 한 번에 그린다. 5종 소스
91
+ (columns/checked/selection/all/range), LTTB 다운샘플 + 샘플링 배지, 라이브 갱신(데이터·수식 편집 반영),
92
+ 색약 대응 팔레트, 접근성(role=img·시각숨김 데이터표·키보드 순회·실 button 범례), 외부 런타임 의존성 0의
93
+ 내장 canvas 렌더러. `chart` 옵션, `createChart`/`getCharts`/`destroyCharts` API.
94
+ - **stitch 테마** — 리넨/크라프트 색감에 실땀(점선) 보더를 입힌 핸드크래프트 스타일 테마. 12개 → 13개 내장 테마.
95
+ - **`fallbackViewportHeight` 옵션 (옵트인 안전장치)** — 그리드 컨테이너에 확정 높이가 없어 대량 데이터에서
96
+ 전 행이 DOM 렌더되는 것을 막는다. 기본 OFF(기존 동작 완전 불변)이며, 컨테이너가 스크롤 제약 없이 전
97
+ 콘텐츠를 담는 "언바운드" 상태를 감지했을 때만 가상 스크롤 뷰포트를 이 값(px)으로 클램프한다.
98
+ (1순위 권장은 여전히 그리드 컨테이너에 확정 높이를 주는 것.)
99
+
100
+ ### Fixed
101
+ - 통합 차트(F4) 코어 리뷰 반영 — 사용자 지정 `size` 좌표가 히트테스트/툴팁에 반영되지 않던 문제,
102
+ 라이브 재렌더 시 범례 포커스 유실, 컨테이너 리사이즈/DPR 변경 시 재렌더 부재 등 12건 수정.
103
+
104
+ ## [1.0.8] - 2026-07-01
105
+
106
+ ### Fixed
107
+ - **`grid.override('getDisplayValue')` 커스터마이징이 셀 화면에 반영되지 않던 버그 수정** —
108
+ 텍스트·불리언 등 셀 렌더 경로가 내부적으로 `getDisplayValue()`를 거치지 않아,
109
+ `getDisplayValue`를 오버라이드해도 셀에 표시되는 값이 바뀌지 않던 문제를 고쳤다.
110
+ 이제 렌더러가 인스턴스 콜백을 통해 `getDisplayValue()` 결과를 표시값으로 사용한다.
111
+ 오버라이드·전략이 등록되지 않은 경우 기존 렌더 경로로 폴백하므로 기존 동작은
112
+ 100% 보존된다(출력 바이트 동일, 회귀 없음). 단위 테스트 408건 통과.
113
+
114
+ ## [1.0.7] - 2026-06-27
115
+
116
+ ### Fixed
117
+ - **워크시트(다중 시트) 데이터 미표시 버그 수정** — `addWorksheet()`로 시트를 추가하거나 탭을
118
+ 전환할 때 헤더·탭은 그려지지만 **데이터 행이 렌더되지 않던** 문제를 고쳤다. 원인은 시트 전환
119
+ 콜백이 내부 데이터만 갱신하고 가상 스크롤(virtual scroll)의 총 행수를 갱신하지 않아 보이는
120
+ 행 범위가 비어 있었던 것. 시트 전환 시 `setData`와 동일한 경로(총 행수·aria·컬럼 폭 재계산)를
121
+ 거치도록 통합해 시트마다 컬럼 구성이 달라도 올바르게 표시된다.
122
+
123
+ ## [1.0.6] - 2026-06-26
124
+
125
+ ### Changed
126
+ - 메타데이터·문서 정리(기능·동작 변경 없음). 발행 패키지를 경량화(소스맵 제외)했다.
127
+
128
+ ## [1.0.5] - 2026-06-24
129
+
130
+ ### Changed
131
+ - **런타임 의존성 0 (zero runtime dependencies)** — Excel 내보내기에 쓰이는 `xlsx`·`xlsx-js-style`을
132
+ `dependencies` → `devDependencies`로 옮겼다. 이들은 **빌드 시 `dist/`에 번들로 포함**되므로
133
+ (`src`의 `import('xlsx-js-style')`가 빌드 과정에서 `dist/xlsx.min-*.js` 청크로 변환됨),
134
+ 설치하는 쪽에서 별도로 받을 필요가 없다 — `npm install open-grid`는 외부 런타임 의존성을
135
+ 하나도 끌어오지 않는다. **Excel 내보내기는 번들된 SheetJS로 그대로 동작**한다(설치 불필요).
136
+ 코드·동작 변경 없음(의존성 분류만 정정). 번들된 SheetJS는 Apache-2.0이며 `NOTICE`/`THIRD_PARTY_LICENSES.txt`로 귀속 표기됨.
137
+
138
+ ## [1.0.4] - 2026-06-24
139
+
140
+ ### Changed
141
+ - **소개 문구(intro) 추가** — README 상단과 npm `description`에 제품 소개 문구를 추가하고
142
+ npm 배지 버전 표기를 현행화했다. 코드·기능 변경 없음(문서/메타데이터만).
143
+ ("zero-dependency **core**" — Excel 내보내기는 SheetJS를 번들하므로 "코어 무의존"으로 정확히 표기.)
144
+
145
+ ## [1.0.3] - 2026-06-24
146
+
147
+ ### Changed
148
+ - **라이선스 준수 내역을 배포 패키지에 명시** — 발행 tarball에 `CHANGELOG.md`를 포함하고,
149
+ README·변경 이력에 1.0.2의 라이선스 컴플라이언스 조치(아래)를 명확히 기재했다.
150
+ 코드·기능 변경 없음(문서/배포 메타데이터만).
151
+
152
+ ## [1.0.2] - 2026-06-24
153
+
154
+ ### Fixed — 라이선스 컴플라이언스 (잠재적 라이선스 위반 소지 해소)
155
+ - **문제** — Excel 내보내기 기능에 쓰이는 `xlsx`(SheetJS Community Edition)와
156
+ `xlsx-js-style`는 **Apache License 2.0** 라이선스이며 빌드 결과물(`dist/`)에 번들되어
157
+ 함께 배포된다. 그런데 1.0.1까지의 배포 패키지에는 OPEN_GRID 자체의 **MIT LICENSE만**
158
+ 들어 있고, Apache-2.0가 재배포 시 요구하는 **라이선스 사본과 저작권 귀속 고지가 누락**
159
+ 되어 있었다(Apache-2.0 §4(a)·§4(c) 미충족 → **잠재적 라이선스 위반 소지**).
160
+ - **해결** — 배포 패키지에 다음을 추가하고 `files`에 포함해 함께 배포한다:
161
+ - `THIRD_PARTY_LICENSES.txt` — Apache License 2.0 **전문** + 번들 구성요소 식별·저작권 고지
162
+ - `NOTICE` — SheetJS LLC(`xlsx`) 및 SheetJS LLC·Brent Ely(`xlsx-js-style`) 저작권 귀속
163
+ - README에 "Third-party licenses" 안내 추가
164
+ - **영향 범위** — OPEN_GRID 본체 라이선스(MIT)와 코드는 **변경 없음**. MIT와 Apache-2.0는
165
+ 서로 호환되어 **라이선스 충돌은 없으며**, 누락돼 있던 Apache-2.0 **귀속 의무만 충족**시킨
166
+ 조치다.
167
+
168
+ ## [1.0.1] - 2026-06-24
169
+
170
+ ### Fixed
171
+ - **그리드 초기화 크래시 수정** — `summary` 푸터를 사용하는 그리드를 생성할 때
172
+ `Cannot read properties of undefined (reading 'getStrategy')` 로 초기화가 실패하던 문제.
173
+ 생성자에서 OverrideKernel 부착(및 strategy resolver 배선)을 최초 마운트 **이전**으로
174
+ 옮겨, 초기 푸터/그룹 렌더가 strategy 슬롯을 조회할 때 커널이 항상 준비되도록 했다.
175
+ (피벗·집계 푸터·그룹 합계 등 `summary`/`footer` 옵션을 쓰는 모든 구성에 영향.)
176
+
177
+ ## [1.0.0] - 2026-06-23
178
+
179
+ 첫 정식 메이저 릴리스. 본문(코어) 코드 무수정으로 동작을 확장하는 `grid.override()` API와 헤더 줄바꿈을 추가.
180
+
181
+ ### Added
182
+ - **`grid.override()` — 본문 무수정 동작 확장 API** (신규 `src/core/OverrideKernel.ts`)
183
+ - `grid.override(name, (orig, ...args) => result)` — 메서드 래핑. `orig()`는 `super`처럼 항상 호출 가능.
184
+ 합성 순서는 FIFO 좌측폴드(나중에 건 것이 가장 바깥), 재진입 깊이 32 + 사이클 가드.
185
+ - `grid.override.strategy(slot, fn)` — 6개 알고리즘 슬롯 교체: 정렬 비교(sortComparator),
186
+ 필터 술어(filterPredicate), 표시 포맷터(displayFormatter), 엑셀 직렬화(cellSerializer),
187
+ 그룹 키(groupKeyFn), 집계 연산(summaryOp).
188
+ - `grid.restore(name)` / `grid.restoreAll()` — 원복. `destroy()` 시 자동 전체 복원.
189
+ - `OpenGrid.defaultOverride(name, fn)` / `OpenGrid.defaults.strategy(slot, fn)` — 전역(앞으로 생성될 모든 그리드) 기본 오버라이드.
190
+ - 오류는 기본(strict) 그대로 전파. 기존 메서드 본문은 한 줄도 수정하지 않음(C1 원칙 준수).
191
+ - **헤더 줄바꿈** — `ColumnDef.headerWrap?: boolean` + 헤더 문자열 `\n` 줄바꿈 + 헤더 높이 자동 확장.
192
+ - **override 데모 32종 × 5 프레임워크**(Vanilla/React/Vue/jQuery/Angular) — `examples/override/`, 허브 포함.
193
+ - **그리드 튜닝 참고자료 페이지** — 아키텍처/시퀀스 UML 다이어그램 기반 내부 동작 설명.
194
+ - **AI 에이전트용 override 가이드**(KO/EN) + 개발 가이드 override 챕터.
195
+
196
+ ### Tests
197
+ - override 코어 + 헤더 줄바꿈 단위 테스트 추가. 전체 테스트 통과(회귀 0).
198
+
199
+ ## [0.3.2] - 2026-06-18
200
+
201
+ ### Fixed
202
+ - **셀 줄바꿈(col.wrap)이 실제로 꺾이지 않던 문제** — `.og-cell--wrap` 는 셀에 적용됐지만, 내부 텍스트
203
+ span(`.og-cell-text`)을 렌더러가 인라인 `white-space:nowrap` 으로 렌더해 클래스만으로는 못 이겼다.
204
+ `.og-cell--wrap .og-cell-text/.og-cell-date { white-space: normal !important; text-overflow: clip !important }`
205
+ 로 인라인을 무력화. e2e 도 셀이 아닌 **내부 span + 실제 줄 수**를 검증하도록 강화.
206
+ (npm `open-grid@0.3.1` 은 이 수정 직전에 발행되어 wrap 미동작 → **0.3.2 로 재발행**, npm latest = 0.3.2.)
207
+
208
+ ## [0.3.1] - 2026-06-17
209
+
210
+ ### Fixed
211
+ - **Host CSS isolation — 임베드 시 호스트 테마 CSS inbound 상속으로 레이아웃/색상 깨짐** (foxnail.kr/WordPress 통합에서 발견)
212
+ - 원인: 헤더가 실제 `<table>`/`<th>` 라서, 임베드 호스트(WordPress 등)의 element/높은 특이도 셀렉터
213
+ (`th,td`, `.entry-content th`, `.fn-post-content th` 등)가 그리드 헤더로 침범 — `line-height`, `border`,
214
+ `background`, `color`, `table{margin}` 등이 새어들어와 헤더가 깨지거나 호스트 색(navy/white)으로 칠해짐.
215
+ 바디는 `<div>` 라 안전. (헤더 `<th>` 는 element 셀렉터라 그리드의 클래스/상속값을 이김)
216
+ - `src/core/GridRenderer.ts` — 헤더 `<th>` 의 모든 시각 속성을 **인라인으로 고정**(인라인이 호스트 셀렉터를 이김):
217
+ `background`/`color`/`line-height`/`font-size`/`vertical-align`/`border-top·left` (data + extra/rownumber/check 컬럼 전부).
218
+ 헤더 `<table>` 에 `og-header-table` 클래스 부여 + 인라인 `margin:0;border-spacing:0`.
219
+ - `src/styles/base.css` — `.og-container { line-height: normal }` (바디 셀 메트릭 격리) 및 헤더 클래스 기본 방어.
220
+ - **WordPress 전역 스타일 `:where([style*="border-color"]){border-style:solid}` 대응** — 그리드 인라인 보더가
221
+ `var(--og-border-color)` 를 참조해 "border-color" 문자열에 매칭되면, 폭 미지정 변에 `medium`(3px) 보더가
222
+ 강제돼 헤더(`.og-header`)·그룹행·병합셀의 좌/우/상에 굵은 선이 생기고 바디 컬럼선과 어긋나던 문제 수정.
223
+ `GridRenderer.ts` 의 단일변 인라인 보더에 `border:0` 선행(미지정 변 폭 0 명시). 테마 무관(전 테마 동일 적용).
224
+ - **컨텍스트메뉴 위치 — 임베드 호스트의 transform 조상 아래에서 마우스 좌표를 벗어남** (그리드 너비 확대 시 두드러짐)
225
+ - `src/core/ContextMenu.ts` — 메뉴를 그리드 컨테이너 대신 `document.body` 에 부착 → `position:fixed` 가
226
+ 항상 뷰포트 기준으로 동작. 테마 변수 보존을 위해 `data-og-theme` 복사 + `.og-context-menu` 에 `--og-cm-*` 정의 확장.
227
+
228
+ ### Added
229
+ - **셀 툴팁** — `column.tooltip`(문자열|함수) 또는 그리드 옵션 `tooltips: true`(모든 셀에 값 자동 노출).
230
+ 헤더 셀도 `title` 노출(잘린 헤더 가독성).
231
+ - **셀 줄바꿈(wrap)** — `column.wrap: true` 시 nowrap+ellipsis 대신 여러 줄 표시(`white-space:normal`).
232
+ 가상 스크롤 고정 행 높이와 함께 `rowHeight` 확대 권장.
233
+ - 회귀 테스트: `test/e2e/host-isolation.spec.ts` + 적대적 호스트 픽스처 `examples/host-isolation/`
234
+ (line-height/border/margin/색상 격리 + 컨텍스트메뉴 transform 조상 + 툴팁/wrap, before/after 변별 — 10 케이스).
235
+
236
+ ## [0.3.0] - 2026-06-05
237
+
238
+ ### Added
239
+ - **개발 가이드 DB화 완성** — 39개 섹션 전체 SQLite DB화 (G1~G6)
240
+ - G1: 시작하기 (npm 설치, 퀵스타트, 기본 설정)
241
+ - G2: 데이터/옵션 (컬럼 정의, 데이터 옵션, 선택/체크박스/DnD/상태 관리)
242
+ - G3: 편집/이벤트 (셀 편집, 셀 타입, 마스킹, 병합, 이벤트, 트리거)
243
+ - G4: 그룹/페이징 (그룹, 트리, 푸터, 페이지네이션, 파인드바, 키보드)
244
+ - G5: 고급/내보내기 (피벗, 워크시트, SAP, XML, 수식, 조직도, Excel/CSV/인쇄)
245
+ - G6: 스타일/API (테마, 커스텀, 폰트, 사이징, 접근성, 그리드/컬럼/이벤트 API)
246
+ - **전 프레임워크 데모 완성** — React / Vue / jQuery / Angular / Vanilla 각 49개 섹션
247
+ - Angular A~H: AngularJS 1.x CDN 기반, `$scope.$apply` 없이 ng-show/ng-hide 패턴
248
+ - **Guide 렌더러** — `lang='html'` 감지 시 innerHTML 직접 주입 방식으로 전환 (pre/code 래핑 없음)
249
+
250
+ ## [0.2.0] - 2026-06-04
251
+
252
+ ### Fixed
253
+ - **Formula 셀 클릭 버그** — `CellEventHandler.ts`: formula 컬럼 cellClick 시 `e.value`가 `undefined`이던 문제 수정
254
+ - `row[col.field]` 대신 `evaluateFormula()`로 직접 계산 후 주입
255
+
256
+ ### Added
257
+ - **React 데모** — `demo-react/index.php` 신규 (React 18 CDN, `useRef+useEffect+createRoot` 패턴)
258
+ - React 프레임워크 전 섹션(A~H, 49개) DB 삽입 완료
259
+ - 선택/필터셀렉트 API 버그 수정 (`getSelections()`, `valueMap` 기반 표시)
260
+
261
+ ## [0.1.2] - 2026-05-30
262
+
263
+ ### Added (Sprint 29 추가분)
264
+ - **변경 추적 API 보강**
265
+ - `getChanges()` — `{ added, edited, removed }` 한 번에 반환. edited 행에 `_changedFields` 포함
266
+ - `getEditedRows()` — 수정된 행만 반환 (기존 `getChangedRows()` 개선판)
267
+ - `getChangedColumns()` — `{ row, fields, diff[] }` 형태로 컬럼 단위 diff 반환 (oldValue/newValue 포함)
268
+ - `getOriginalRow(rowIndex)` — 수정 전 원본 행 데이터 반환
269
+ - **합계 / 소계 (Footer)**
270
+ - `setFooter(FooterDef[])` — 런타임 푸터 설정 (SUM/AVG/MIN/MAX/COUNT)
271
+ - `getFooterValue(field)` — 특정 필드 집계 결과 조회
272
+ - `getFooterData()` — 전체 집계 데이터 배열 조회
273
+ - OGDecimal 기반 정밀 계산 — 소수점 누적 오류 없음 (0.1 × 10 = 정확히 1.00)
274
+ - 데이터 수정/추가/삭제 시 푸터 자동 재계산
275
+ - **Guide** — Ch26(변경 추적), Ch27(합계/소계) 추가 → 총 27챕터
276
+ - **Vanilla 데모** — '변경 추적' 섹션, '합계/소계' 섹션 추가
277
+
278
+ ## [0.1.1] - 2026-05-30
279
+
280
+ ### Added (Sprint 29)
281
+ - **columnReorder** — `columnReorder: true` 옵션으로 헤더 드래그 컬럼 순서 변경 지원
282
+ - `onColumnReorder` 이벤트 콜백 (`{ fromIndex, toIndex, field }`)
283
+ - 드래그 중 시각 피드백 (`og-col-dragging` / `og-col-drop-over` CSS 클래스)
284
+ - **Guide** — 개발 가이드 4개 챕터 신규 추가 (Ch22~Ch25)
285
+ - Ch22: 데이터 마스킹 (10종 타입, 셀/컬럼 단위 해제, maskOnExport)
286
+ - Ch23: 조직도 (OrgChart API, setData, expandAll/collapseAll, 테마 연동)
287
+ - Ch24: 페이지네이션 (API, 서버사이드, React/Vue 예제)
288
+ - Ch25: 키보드 단축키 (WCAG 2.2 준수 표, aria-label 설정)
289
+ - **E2E Tests** — sprint29.spec.ts 25개 시나리오 추가
290
+ - checkColumn 선택/해제, 컨텍스트 메뉴 렌더링/닫힘, 테마 전환(data-og-theme), 키보드 네비게이션, 셀 편집, 정렬(aria-sort)
291
+
292
+ ### Changed
293
+ - `GridRenderer` 내부 콜백에 `onColDragStart` / `onColDrop` / `getColDragIdx` 추가
294
+
295
+ ## [0.1.0] - 2026-05-24
296
+
297
+ ### Added
298
+ - **Core Engine**
299
+ - `OpenGrid` class — main grid instance with `new OpenGrid(container, options)` API
300
+ - `DataLayer` — CRUD, state tracking (added/edited/removed), sort, filter
301
+ - `VirtualScroll` — rAF-based rendering with row pooling (100k+ rows)
302
+ - `ColumnLayout` — group headers, frozen columns, flex widths
303
+ - `EventEmitter` — on/once/off/emit event system
304
+
305
+ - **Cell Renderers** (8 types)
306
+ - text, number (format), date, checkbox, button, badge, link, template
307
+
308
+ - **Cell Editors** (5 types)
309
+ - text, number, select, date, checkbox
310
+ - Inline editing: click / dblclick / F2 entry, Enter/Tab/Esc exit
311
+
312
+ - **Grouping + Summary**
313
+ - `groupBy(fields[])` — multi-level hierarchical grouping
314
+ - `summary` option — SUM / AVG / MIN / MAX / COUNT per column
315
+ - `expandAll()` / `collapseAll()` / `clearGroup()`
316
+
317
+ - **Tree Grid**
318
+ - `enableTree()` / `disableTree()` — flat-to-tree via `treeId` / `treeParentId`
319
+ - `expandNodes(ids)` / `expandAllNodes()` / `collapseAllNodes()`
320
+ - Indent + toggle arrow rendering per depth level
321
+
322
+ - **Cell Merge**
323
+ - `mergeCells([{row, col, rowSpan?, colSpan?}])` — manual merge
324
+ - `autoMerge(fields[])` — auto rowSpan for consecutive identical values
325
+ - `clearMerge()` — remove all merges
326
+
327
+ - **Row Drag & Drop**
328
+ - `draggable: true` option
329
+ - Ghost row + drop indicator
330
+ - `reorderRow(from, to)` public API
331
+ - `onRowDrop` callback
332
+
333
+ - **Filter UI**
334
+ - Column header filter icon
335
+ - 9 operators: `=`, `!=`, `contains`, `startsWith`, `endsWith`, `>`, `<`, `>=`, `<=`
336
+
337
+ - **Export**
338
+ - `exportExcel(options?)` — SheetJS xlsx (dynamic import, code-split)
339
+ - `exportCsv(options?)` — BOM-aware CSV
340
+ - `exportJson(options?)` — JSON download
341
+
342
+ - **Pagination**
343
+ - `pagination: true` + `pageSize` option
344
+ - Page size selector (10/20/50/100/200)
345
+ - First/Prev/Next/Last navigation
346
+
347
+ - **Keyboard Navigation**
348
+ - Arrow keys — cell navigation
349
+ - Tab / Shift+Tab — next/prev cell
350
+ - F2 / Enter — start edit
351
+ - Escape — cancel edit / clear focus
352
+ - Ctrl+C / Ctrl+V — clipboard
353
+
354
+ - **UI**
355
+ - Column resize (drag)
356
+ - Multi-sort (Shift+click)
357
+ - Dark theme (`theme: 'dark'`)
358
+ - CSS Variables — full theme customization
359
+ - `setTheme(theme)` / `setThemeVar(key, value)`
360
+
361
+ - **Vue 3 Component** (`open-grid/vue`)
362
+ - Composition API, `defineProps` / `defineEmits`
363
+ - Reactive `data` / `columns` watchers
364
+ - `grid` instance exposed via `defineExpose`
365
+
366
+ - **React 18 Component** (`open-grid/react`)
367
+ - Hooks-based (`useRef`, `useEffect`)
368
+ - `OpenGridReact` + `OpenGridWithRef` (forwardRef)
369
+ - `stateColumn`, `draggable`, `onRowDrop` props
370
+
371
+ - **API Naming** — distinctive, self-consistent method names
372
+ - `readCell`, `writeCell` for cell access
373
+ - `orderBy` for sorting
374
+ - `jumpToRow` for scrolling
375
+ - `getSelections` for selection
376
+ - (40+ purpose-built method names)
377
+
378
+ ### Performance
379
+ - Multi-sort 100k rows: 1789ms → **40ms** (44× improvement via Schwartzian transform)
380
+ - Single sort 100k rows: ~38ms
381
+ - Filter 100k rows: ~17ms
382
+ - Group build 100k rows: ~3ms (5 groups)
383
+ - Tree build 100k rows: ~25ms
384
+
385
+ ### Tests
386
+ - 124 unit tests across 7 test files
387
+ - EventEmitter (7), DataLayer (14), GroupEngine (18), TreeEngine (20),
388
+ MergeEngine (16), CellEditor (23), CellRenderer (26)