open-grid 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (294) hide show
  1. package/CHANGELOG.md +376 -353
  2. package/README.md +1 -1
  3. package/dist/OpenGrid-B7m7ei7f.cjs +7385 -0
  4. package/dist/OpenGrid-CeUdO_fM.js +7398 -0
  5. package/dist/index-CeJ-0-80.cjs +260 -0
  6. package/dist/index-DnarQ4eR.js +266 -0
  7. package/dist/index-DrCPRuYi.js +548 -0
  8. package/dist/index-JjfWY3Bt.cjs +520 -0
  9. package/dist/open-grid-base.css +12 -1
  10. package/dist/open-grid-react.cjs +27 -1
  11. package/dist/open-grid-react.js +22 -82
  12. package/dist/open-grid-vue.cjs +31 -1
  13. package/dist/open-grid-vue.js +29 -79
  14. package/dist/open-grid.cjs +272 -6
  15. package/dist/open-grid.js +177 -266
  16. package/dist/types/bench/perf.d.ts +14 -8
  17. package/dist/types/core/AppearanceResolver.d.ts +98 -11
  18. package/dist/types/core/CFRenderBridge.d.ts +13 -0
  19. package/dist/types/core/CellEditManager.d.ts +73 -0
  20. package/dist/types/core/CellEventHandler.d.ts +99 -2
  21. package/dist/types/core/CellTypeRegistry.d.ts +24 -0
  22. package/dist/types/core/ChartManager.d.ts +51 -3
  23. package/dist/types/core/ColumnLayout.d.ts +100 -2
  24. package/dist/types/core/ContextMenu.d.ts +43 -2
  25. package/dist/types/core/CrossGridController.d.ts +86 -15
  26. package/dist/types/core/CrossGridMapper.d.ts +43 -5
  27. package/dist/types/core/CrossGridRegistry.d.ts +36 -2
  28. package/dist/types/core/DataLayer.d.ts +210 -15
  29. package/dist/types/core/DetailManager.d.ts +106 -15
  30. package/dist/types/core/DragVisuals.d.ts +33 -4
  31. package/dist/types/core/EventEmitter.d.ts +54 -0
  32. package/dist/types/core/ExportManager.d.ts +66 -1
  33. package/dist/types/core/ExtensionPointRegistry.d.ts +160 -14
  34. package/dist/types/core/FilterPanel.d.ts +17 -2
  35. package/dist/types/core/FilterSelect.d.ts +37 -13
  36. package/dist/types/core/FindBarManager.d.ts +26 -0
  37. package/dist/types/core/FlatRowModel.d.ts +54 -11
  38. package/dist/types/core/FooterManager.d.ts +53 -1
  39. package/dist/types/core/FormulaController.d.ts +139 -10
  40. package/dist/types/core/FormulaEngine.d.ts +15 -4
  41. package/dist/types/core/GridComposer.d.ts +54 -6
  42. package/dist/types/core/GridRenderer.d.ts +143 -10
  43. package/dist/types/core/GridShuttle.d.ts +44 -4
  44. package/dist/types/core/GroupEngine.d.ts +68 -10
  45. package/dist/types/core/GroupTreeManager.d.ts +86 -2
  46. package/dist/types/core/IconRegistry.d.ts +56 -9
  47. package/dist/types/core/KeyboardManager.d.ts +88 -4
  48. package/dist/types/core/MaskingEngine.d.ts +10 -9
  49. package/dist/types/core/MathUtils.d.ts +58 -5
  50. package/dist/types/core/MergeEngine.d.ts +45 -10
  51. package/dist/types/core/MutationService.d.ts +113 -10
  52. package/dist/types/core/OGDecimal.d.ts +144 -13
  53. package/dist/types/core/OpenGrid.d.ts +99 -0
  54. package/dist/types/core/OrgChart.d.ts +56 -1
  55. package/dist/types/core/OverrideKernel.d.ts +59 -15
  56. package/dist/types/core/Pagination.d.ts +38 -4
  57. package/dist/types/core/PivotEngine.d.ts +37 -0
  58. package/dist/types/core/RangeSelectionManager.d.ts +121 -7
  59. package/dist/types/core/RenderController.d.ts +56 -0
  60. package/dist/types/core/RowDragDrop.d.ts +52 -6
  61. package/dist/types/core/RowManager.d.ts +55 -0
  62. package/dist/types/core/SkinRegistry.d.ts +55 -15
  63. package/dist/types/core/SortFilterManager.d.ts +80 -1
  64. package/dist/types/core/TreeEngine.d.ts +60 -6
  65. package/dist/types/core/TriggerManager.d.ts +46 -0
  66. package/dist/types/core/VirtualScroll.d.ts +64 -0
  67. package/dist/types/core/WorksheetManager.d.ts +61 -2
  68. package/dist/types/core/XmlConverter.d.ts +56 -23
  69. package/dist/types/core/a11y/AccessibilityAdapter.d.ts +103 -0
  70. package/dist/types/core/a11y/AriaIntent.d.ts +34 -0
  71. package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +64 -0
  72. package/dist/types/core/a11y/LiveRegionController.d.ts +89 -0
  73. package/dist/types/core/a11y/OverlayStack.d.ts +36 -0
  74. package/dist/types/core/a11y/VisualEquivRegistry.d.ts +37 -0
  75. package/dist/types/core/a11y/index.d.ts +13 -0
  76. package/dist/types/core/a11y/ports.d.ts +24 -0
  77. package/dist/types/core/appearance/Appearance.d.ts +68 -0
  78. package/dist/types/core/appearance/AppearanceAxis.d.ts +94 -0
  79. package/dist/types/core/appearance/AppearanceComposer.d.ts +45 -0
  80. package/dist/types/core/appearance/AppearanceProvider.d.ts +50 -0
  81. package/dist/types/core/appearance/AppearanceView.d.ts +51 -0
  82. package/dist/types/core/appearance/DensityRegistry.d.ts +36 -0
  83. package/dist/types/core/appearance/ResolvedAppearanceSnapshot.d.ts +84 -0
  84. package/dist/types/core/appearance/TextureRegistry.d.ts +32 -0
  85. package/dist/types/core/appearance/ThemeMetaRegistry.d.ts +67 -0
  86. package/dist/types/core/appearance/axisAdapters.d.ts +37 -0
  87. package/dist/types/core/appearance/defaults.d.ts +10 -0
  88. package/dist/types/core/appearance/index.d.ts +20 -0
  89. package/dist/types/core/appearance/tokenCatalog.d.ts +30 -0
  90. package/dist/types/core/cf/CFEngine.d.ts +56 -0
  91. package/dist/types/core/cf/CFEvaluator.d.ts +24 -0
  92. package/dist/types/core/cf/CFRule.d.ts +127 -0
  93. package/dist/types/core/cf/ColorScale.d.ts +49 -0
  94. package/dist/types/core/cf/InkResolver.d.ts +33 -0
  95. package/dist/types/core/cf/appearance.d.ts +20 -0
  96. package/dist/types/core/cf/encoders.d.ts +61 -0
  97. package/dist/types/core/cf/eval-types.d.ts +93 -0
  98. package/dist/types/core/cf/index.d.ts +21 -0
  99. package/dist/types/core/cf/lineage.d.ts +32 -0
  100. package/dist/types/core/cf/predicates.d.ts +27 -0
  101. package/dist/types/core/cf/serialize.d.ts +46 -0
  102. package/dist/types/core/chart/CanvasAdapter.d.ts +50 -1
  103. package/dist/types/core/chart/DataExtractor.d.ts +53 -12
  104. package/dist/types/core/chart/a11y.d.ts +22 -0
  105. package/dist/types/core/chart/chart-type-registry.d.ts +53 -0
  106. package/dist/types/core/chart/downsample-report.d.ts +36 -0
  107. package/dist/types/core/chart/downsample.d.ts +26 -1
  108. package/dist/types/core/chart/engine/ChartEngineRegistry.d.ts +52 -0
  109. package/dist/types/core/chart/geometry.d.ts +96 -0
  110. package/dist/types/core/chart/hittest.d.ts +21 -3
  111. package/dist/types/core/chart/palette.d.ts +96 -12
  112. package/dist/types/core/chart/parity.d.ts +12 -0
  113. package/dist/types/core/chart/provenance.d.ts +47 -0
  114. package/dist/types/core/chart/scales.d.ts +28 -1
  115. package/dist/types/core/chart/scene.d.ts +102 -0
  116. package/dist/types/core/chart/server.d.ts +36 -0
  117. package/dist/types/core/chart/surfaces/CanvasSurface.d.ts +48 -0
  118. package/dist/types/core/chart/surfaces/ServerRasterSurface.d.ts +26 -0
  119. package/dist/types/core/chart/surfaces/SvgSurface.d.ts +24 -0
  120. package/dist/types/core/chart/surfaces/pattern-overlay.d.ts +24 -0
  121. package/dist/types/core/chart/types.d.ts +107 -10
  122. package/dist/types/core/command/CommandBus.d.ts +51 -0
  123. package/dist/types/core/command/CommandRegistry.d.ts +43 -0
  124. package/dist/types/core/command/CommandStack.d.ts +38 -0
  125. package/dist/types/core/command/ICommand.d.ts +110 -0
  126. package/dist/types/core/command/commands/CellWriteCommand.d.ts +32 -0
  127. package/dist/types/core/command/commands/CompositeCommand.d.ts +17 -0
  128. package/dist/types/core/command/commands/RowCommands.d.ts +39 -0
  129. package/dist/types/core/command/index.d.ts +9 -0
  130. package/dist/types/core/command/support.d.ts +51 -0
  131. package/dist/types/core/coordinate/ColumnMetrics.d.ts +30 -0
  132. package/dist/types/core/coordinate/CoordinateKernel.d.ts +88 -0
  133. package/dist/types/core/coordinate/FrozenPanes.d.ts +29 -0
  134. package/dist/types/core/coordinate/MergeSourceAdapter.d.ts +18 -0
  135. package/dist/types/core/coordinate/NodeBudget.d.ts +33 -0
  136. package/dist/types/core/coordinate/ResizeGovernor.d.ts +50 -0
  137. package/dist/types/core/coordinate/RowMetrics.d.ts +37 -0
  138. package/dist/types/core/coordinate/ViewPermutation.d.ts +23 -0
  139. package/dist/types/core/coordinate/index.d.ts +10 -0
  140. package/dist/types/core/coordinate/ports.d.ts +45 -0
  141. package/dist/types/core/coordinate/types.d.ts +76 -0
  142. package/dist/types/core/detail/DetailGlyph.d.ts +42 -7
  143. package/dist/types/core/detail/DetailSplice.d.ts +42 -11
  144. package/dist/types/core/detail/DetailState.d.ts +80 -11
  145. package/dist/types/core/detail/SubgridCache.d.ts +72 -10
  146. package/dist/types/core/detail/index.d.ts +8 -0
  147. package/dist/types/core/domain/AggregateResult.d.ts +54 -0
  148. package/dist/types/core/domain/CellAddress.d.ts +61 -0
  149. package/dist/types/core/domain/CellValueAccess.d.ts +29 -0
  150. package/dist/types/core/domain/Delta.d.ts +37 -0
  151. package/dist/types/core/domain/DomainValue.d.ts +80 -0
  152. package/dist/types/core/domain/Missing.d.ts +65 -0
  153. package/dist/types/core/domain/Money.d.ts +42 -0
  154. package/dist/types/core/domain/NormalizationBasis.d.ts +47 -0
  155. package/dist/types/core/domain/Plain.d.ts +45 -0
  156. package/dist/types/core/domain/Quantity.d.ts +32 -0
  157. package/dist/types/core/domain/Ratios.d.ts +100 -0
  158. package/dist/types/core/domain/ThresholdSet.d.ts +46 -0
  159. package/dist/types/core/domain/ValueType.d.ts +71 -0
  160. package/dist/types/core/domain/rounding.d.ts +25 -0
  161. package/dist/types/core/domain/strategies.d.ts +38 -0
  162. package/dist/types/core/editors/CellEditor.d.ts +29 -2
  163. package/dist/types/core/editors/DateEditor.d.ts +18 -0
  164. package/dist/types/core/editors/SelectEditor.d.ts +29 -0
  165. package/dist/types/core/export/ChannelRegistry.d.ts +18 -0
  166. package/dist/types/core/export/ExportManifest.d.ts +13 -0
  167. package/dist/types/core/export/GridArtifactSource.d.ts +62 -0
  168. package/dist/types/core/export/Provenance.d.ts +34 -0
  169. package/dist/types/core/export/StreamPump.d.ts +28 -0
  170. package/dist/types/core/export/channels/CsvChannel.d.ts +20 -0
  171. package/dist/types/core/export/channels/JsonChannel.d.ts +18 -0
  172. package/dist/types/core/export/channels/XlsxChannel.d.ts +53 -0
  173. package/dist/types/core/export/channels/XmlChannel.d.ts +21 -0
  174. package/dist/types/core/export/channels/capabilities.d.ts +13 -0
  175. package/dist/types/core/export/index.d.ts +24 -0
  176. package/dist/types/core/export/print/OutputChannelAdapter.d.ts +61 -0
  177. package/dist/types/core/export/print/Paginator.d.ts +48 -0
  178. package/dist/types/core/export/print/PrintRenderTarget.d.ts +36 -0
  179. package/dist/types/core/export/sinks.d.ts +40 -0
  180. package/dist/types/core/export/types.d.ts +211 -0
  181. package/dist/types/core/extension/DeprecationManager.d.ts +42 -0
  182. package/dist/types/core/extension/IExtension.d.ts +90 -0
  183. package/dist/types/core/extension/Registry.d.ts +142 -0
  184. package/dist/types/core/extension/SlotRegistry.d.ts +46 -0
  185. package/dist/types/core/extension/adapters.d.ts +44 -0
  186. package/dist/types/core/extension/conformance.d.ts +47 -0
  187. package/dist/types/core/extension/index.d.ts +16 -0
  188. package/dist/types/core/extension/registries.d.ts +31 -0
  189. package/dist/types/core/extension/reserved.d.ts +10 -0
  190. package/dist/types/core/format/DisplayFormatter.d.ts +47 -0
  191. package/dist/types/core/format/FormatCache.d.ts +20 -0
  192. package/dist/types/core/format/FormatterRegistry.d.ts +22 -0
  193. package/dist/types/core/format/grammar/AstRenderer.d.ts +10 -0
  194. package/dist/types/core/format/grammar/FormatCompiler.d.ts +16 -0
  195. package/dist/types/core/format/index.d.ts +55 -0
  196. package/dist/types/core/format/pipeline/DomainTypeResolver.d.ts +8 -0
  197. package/dist/types/core/format/pipeline/LocaleFormat.d.ts +11 -0
  198. package/dist/types/core/format/pipeline/ValueInterpreter.d.ts +8 -0
  199. package/dist/types/core/format/policy/MaskPolicy.d.ts +8 -0
  200. package/dist/types/core/format/policy/NegativePolicy.d.ts +12 -0
  201. package/dist/types/core/format/policy/NullPolicy.d.ts +10 -0
  202. package/dist/types/core/format/policy/TruncatePolicy.d.ts +11 -0
  203. package/dist/types/core/format/types.d.ts +292 -0
  204. package/dist/types/core/formula/CalcCacheStore.d.ts +89 -0
  205. package/dist/types/core/formula/CalcProvenance.d.ts +44 -0
  206. package/dist/types/core/formula/CalcService.d.ts +137 -0
  207. package/dist/types/core/formula/CyclePathReporter.d.ts +28 -0
  208. package/dist/types/core/formula/FormulaEvaluator.d.ts +35 -1
  209. package/dist/types/core/formula/FormulaGraph.d.ts +84 -7
  210. package/dist/types/core/formula/FormulaParser.d.ts +9 -0
  211. package/dist/types/core/formula/FormulaStore.d.ts +63 -1
  212. package/dist/types/core/formula/FunctionRegistry.d.ts +138 -0
  213. package/dist/types/core/formula/Generation.d.ts +86 -0
  214. package/dist/types/core/formula/RecalcCoordinator.d.ts +151 -9
  215. package/dist/types/core/formula/ReferenceRewriter.d.ts +81 -0
  216. package/dist/types/core/formula/functions/essential.d.ts +3 -0
  217. package/dist/types/core/formula/functions/extended/index.d.ts +10 -0
  218. package/dist/types/core/formula/normalizeRefs.d.ts +34 -3
  219. package/dist/types/core/formula/numericLiteral.d.ts +11 -1
  220. package/dist/types/core/formula/serializeFormula.d.ts +10 -1
  221. package/dist/types/core/formula/types.d.ts +71 -8
  222. package/dist/types/core/host/CapabilityRegistry.d.ts +61 -0
  223. package/dist/types/core/host/GridHostDriver.d.ts +27 -0
  224. package/dist/types/core/host/GridHostPort.d.ts +37 -0
  225. package/dist/types/core/host/SliceOwnershipGuard.d.ts +27 -0
  226. package/dist/types/core/host/archCheck.d.ts +26 -0
  227. package/dist/types/core/host/index.d.ts +6 -0
  228. package/dist/types/core/host/reconcile.d.ts +22 -0
  229. package/dist/types/core/i18n/LocaleContext.d.ts +40 -0
  230. package/dist/types/core/i18n/types.d.ts +26 -1
  231. package/dist/types/core/icons/bootstrap-icons.d.ts +4 -2
  232. package/dist/types/core/quality/ContrastAuditor.d.ts +64 -0
  233. package/dist/types/core/quality/DeterminismKernel.d.ts +68 -0
  234. package/dist/types/core/quality/PerfBaseline.d.ts +23 -0
  235. package/dist/types/core/quality/PerfSpec.d.ts +95 -0
  236. package/dist/types/core/quality/RealBrowserGate.d.ts +69 -0
  237. package/dist/types/core/quality/RegressionJudge.d.ts +35 -0
  238. package/dist/types/core/quality/ReleaseGate.d.ts +94 -0
  239. package/dist/types/core/quality/VisualRegression.d.ts +74 -0
  240. package/dist/types/core/quality/hooks.d.ts +53 -0
  241. package/dist/types/core/quality/index.d.ts +20 -0
  242. package/dist/types/core/quality/pixelMetrics.d.ts +24 -0
  243. package/dist/types/core/range/ClipboardCodec.d.ts +46 -4
  244. package/dist/types/core/range/FillEngine.d.ts +69 -9
  245. package/dist/types/core/range/RangeModel.d.ts +100 -13
  246. package/dist/types/core/range/RangeQuery.d.ts +24 -2
  247. package/dist/types/core/range/types.d.ts +27 -11
  248. package/dist/types/core/realtime/BackpressureScheduler.d.ts +0 -0
  249. package/dist/types/core/realtime/FreshnessClock.d.ts +34 -0
  250. package/dist/types/core/realtime/IRealtimeSource.d.ts +82 -0
  251. package/dist/types/core/realtime/LiveStateGuard.d.ts +23 -0
  252. package/dist/types/core/realtime/PollingSource.d.ts +42 -0
  253. package/dist/types/core/realtime/RealtimeController.d.ts +54 -0
  254. package/dist/types/core/realtime/RtAnnouncePolicy.d.ts +53 -0
  255. package/dist/types/core/realtime/RtApplyCommand.d.ts +29 -0
  256. package/dist/types/core/realtime/RtChartTargetTrigger.d.ts +26 -0
  257. package/dist/types/core/realtime/StreamingSource.d.ts +47 -0
  258. package/dist/types/core/realtime/backoff.d.ts +12 -0
  259. package/dist/types/core/realtime/index.d.ts +13 -0
  260. package/dist/types/core/realtime/ports.d.ts +80 -0
  261. package/dist/types/core/render/CellApplier.d.ts +18 -0
  262. package/dist/types/core/render/CellErrorBoundary.d.ts +65 -0
  263. package/dist/types/core/render/CellPipeline.d.ts +39 -0
  264. package/dist/types/core/render/CellRenderRequest.d.ts +209 -0
  265. package/dist/types/core/render/CellStageRegistry.d.ts +53 -0
  266. package/dist/types/core/render/OverlayCompositor.d.ts +38 -0
  267. package/dist/types/core/render/RenderBudget.d.ts +67 -0
  268. package/dist/types/core/render/contrast.d.ts +33 -0
  269. package/dist/types/core/render/index.d.ts +35 -0
  270. package/dist/types/core/render/stages/BackgroundStage.d.ts +14 -0
  271. package/dist/types/core/render/stages/DecoratorStage.d.ts +12 -0
  272. package/dist/types/core/render/stages/OverlayStage.d.ts +12 -0
  273. package/dist/types/core/render/stages/ValueRendererStage.d.ts +15 -0
  274. package/dist/types/core/render/stages/index.d.ts +14 -0
  275. package/dist/types/core/renderers/CellRenderer.d.ts +100 -8
  276. package/dist/types/core/state/AutosaveController.d.ts +63 -0
  277. package/dist/types/core/state/IStatePersistence.d.ts +59 -0
  278. package/dist/types/core/state/MultiTabGuard.d.ts +33 -0
  279. package/dist/types/core/state/SchemaMigrator.d.ts +33 -0
  280. package/dist/types/core/state/SemVerPolicy.d.ts +39 -0
  281. package/dist/types/core/state/StateCodec.d.ts +75 -0
  282. package/dist/types/core/state/index.d.ts +6 -0
  283. package/dist/types/core/types.d.ts +17 -0
  284. package/dist/types/react/OpenGrid.d.ts +54 -0
  285. package/dist/types/react/index.d.ts +5 -0
  286. package/dist/types/realtime/index.d.ts +1 -0
  287. package/dist/types/vue/index.d.ts +5 -0
  288. package/dist/types/vue/types.d.ts +35 -0
  289. package/dist/xlsx.min-BQ1o3sB6.cjs +11793 -0
  290. package/dist/{xlsx.min-Wavxcamn.js → xlsx.min-Bbz2ZypC.js} +453 -566
  291. package/package.json +112 -110
  292. package/dist/OpenGrid-B0Spm0rU.js +0 -10404
  293. package/dist/OpenGrid-CuXj0isp.cjs +0 -97
  294. package/dist/xlsx.min-Bx-LxWOf.cjs +0 -138
@@ -1,8 +1,15 @@
1
1
  /**
2
2
  * ThemeContext — DOM-free 값 객체. 활성 색 테마(및 미래의 스킨) 식별자를 운반한다.
3
3
  * R12a 에서 resolver 메서드는 아직 이 컨텍스트로 분기하지 않는다(반환은 항상 `var()` 문자열이라
4
- * 브라우저가 런타임에 테마별로 재계산 → 오늘의 zero-rerender 테마 전환을 보존, 현상맵 §1.3).
4
+ * 브라우저가 런타임에 테마별로 재계산 → 오늘의 zero-rerender 테마 전환을 보존).
5
5
  * R12b(스킨)에서 `skin` 을 읽어 FORM 토큰을 해결하는 자리를 여기 마련해 둔다.
6
+ * / ThemeContext — a DOM-free value object carrying the active color theme (and future skin)
7
+ * identifiers. In R12a the resolver methods do not yet branch on this context (returns are always
8
+ * `var()` strings so the browser recomputes per-theme at runtime → preserving today's
9
+ * zero-rerender theme switching). R12b (skins) will read `skin` here to resolve FORM tokens.
10
+ *
11
+ * @param theme - 활성 색 테마 id / Active color theme id
12
+ * @param skin - 활성 스킨 id(FORM 축, R12b) / Active skin id (FORM axis, R12b)
6
13
  */
7
14
  export declare class ThemeContext {
8
15
  readonly theme: string;
@@ -10,85 +17,161 @@ export declare class ThemeContext {
10
17
  constructor(theme?: string, skin?: string);
11
18
  }
12
19
  /**
13
- * propagateAppearance — 분리(portal-ed) UI 로 외관 축을 함께 복사(item3 §4.3, HANMS Q8).
20
+ * propagateAppearance — 분리(portal-ed) UI 로 외관 축을 함께 복사(§4.3).
14
21
  * 두 속성(`data-og-theme` COLOR · `data-og-skin` FORM)을 **한 번에** 복사해, 컴포넌트마다
15
- * 두 번째 속성을 잊어 스킨만 안 먹는 조용한 사고(§6-9)를 구조적으로 막는다.
22
+ * 두 번째 속성을 잊어 스킨만 안 먹는 조용한 사고를 구조적으로 막는다.
16
23
  * `fromEl` 에서 가장 가까운 속성 보유 조상을 찾아 `toEl` 에 복사한다.
24
+ * / propagateAppearance — copy the appearance axes together onto portal-ed UI (§4.3). Copies both
25
+ * attributes (`data-og-theme` COLOR · `data-og-skin` FORM) **in one call**, structurally
26
+ * preventing the silent bug where a component forgets the second attribute and the skin quietly
27
+ * fails to apply. Finds the nearest attribute-bearing ancestor of `fromEl` and copies onto `toEl`.
28
+ *
29
+ * @param fromEl - 외관 속성을 상속받을 원본 요소(null 이면 no-op) / Source element to inherit appearance from (no-op if null)
30
+ * @param toEl - 속성을 복사받을 대상 요소 / Target element to receive the attributes
17
31
  */
18
32
  export declare function propagateAppearance(fromEl: Element | null, toEl: Element): void;
19
- /** border()/focusRing() 형태 옵션(미래 스킨용). 미지정 시 오늘의 기본값 = byte-identical. */
33
+ /**
34
+ * border()/focusRing() 형태 옵션(미래 스킨용). 미지정 시 오늘의 기본값 = byte-identical.
35
+ * / Shape options for border()/focusRing() (for future skins). Unset = today's defaults = byte-identical.
36
+ */
20
37
  export interface BorderOptions {
21
- /** 보더 스타일 키워드(기본 'solid'). */
38
+ /** 보더 스타일 키워드(기본 'solid'). / Border style keyword (default 'solid'). */
22
39
  style?: string;
23
- /** true 면 상태(added/edited/removed·selection·range) 보더 — HANMS G-ST2: 항상 solid 강제. */
40
+ /** true 면 상태(added/edited/removed·selection·range) 보더 — G-ST2: 항상 solid 강제. / true = a state border (added/edited/removed·selection·range) — G-ST2: always forced solid. */
24
41
  state?: boolean;
25
42
  }
43
+ /** focusRing() 형태 옵션. / Shape options for focusRing(). */
26
44
  export interface FocusRingOptions {
45
+ /** 링 두께(px, 최소 2 클램프). / Ring width (px, clamped to a minimum of 2). */
27
46
  width?: number;
47
+ /** 링 스타일('none' 은 solid 로 클램프). / Ring style ('none' is clamped to solid). */
28
48
  style?: string;
49
+ /** 링 색(미지정 시 프라이머리 기반). / Ring color (primary-based if unset). */
29
50
  color?: string;
30
51
  }
52
+ /** 엘리베이션(그림자) 단계. / Elevation (shadow) level. */
31
53
  export type ElevationLevel = 'sm' | 'md' | 'lg';
32
54
  /**
33
55
  * AppearanceResolver — 렌더 레이어가 "형태 값"을 물어보는 단일 지점.
34
56
  * R12a 는 **결정을 객체화**할 뿐 값은 오늘과 동일하다(회귀 0). 상태 없음(순수) — 반환은
35
57
  * `var()` 기반 문자열 또는 px 패스스루라, 인스턴스 공유가 안전하다(멀티그리드 격리 무해).
58
+ * / AppearanceResolver — the single place the render layer asks for "shape values". R12a merely
59
+ * **objectifies the decisions**; the values are identical to today (zero regression). It is
60
+ * stateless (pure) — returns are `var()`-based strings or px pass-throughs, so sharing an
61
+ * instance is safe (harmless to multi-grid isolation).
62
+ *
63
+ * @example
64
+ * const ap = new AppearanceResolver(new ThemeContext('dark'));
65
+ * el.style.border = ap.border(); // "1px solid var(--og-border-color,#e0e0e0)"
66
+ * el.style.outline = ap.focusRing(); // AA-safe, clamped to ≥2px solid
36
67
  */
37
68
  export declare class AppearanceResolver {
38
69
  private _ctx;
39
70
  constructor(_ctx?: ThemeContext);
40
- /** 활성 테마/스킨 컨텍스트(R12b 스킨 해결의 진입점). */
71
+ /** 활성 테마/스킨 컨텍스트(R12b 스킨 해결의 진입점). / The active theme/skin context (entry point for R12b skin resolution). */
41
72
  get context(): ThemeContext;
42
- /** 스킨이 활성(비-default)인가. default 면 오늘의 리터럴을 그대로 반환(byte-identical). */
73
+ /** 스킨이 활성(비-default)인가. default 면 오늘의 리터럴을 그대로 반환(byte-identical). / Whether a skin is active (non-default). When default, today's literals are returned as-is (byte-identical). */
43
74
  private _skinActive;
44
75
  /**
45
76
  * R12b: 스킨 컨텍스트 교체(테마는 유지). 파사드 setSkin 이 호출한 뒤 재렌더하면 인라인 form 사이트가
46
77
  * 이 컨텍스트로 재해석된다. default → named 전환 시 border/divider 가 리터럴 → var() 로 승격.
78
+ * / R12b: swap the skin context (theme kept). After the facade setSkin calls this and re-renders,
79
+ * inline form sites are re-resolved against this context. On default → named, border/divider are
80
+ * promoted from literals to var().
81
+ *
82
+ * @param skin - 새 스킨 id / New skin id
47
83
  */
48
84
  setSkin(skin: string): void;
49
85
  /** border-color 토큰 참조(폴백 포함) — 렌더 코드가 오늘 쓰는 문자열과 동일. */
50
86
  private _borderColorVar;
51
87
  /**
52
88
  * 셀/헤더 가장자리 보더. 오늘의 리터럴 `1px solid var(--og-border-color,#e0e0e0)` 과
53
- * **문자 단위 동일**. HANMS G-ST2: state 보더는 스타일을 solid 로 강제(현재 호출은 state 미지정 → no-op).
89
+ * **문자 단위 동일**. G-ST2: state 보더는 스타일을 solid 로 강제(현재 호출은 state 미지정 → no-op).
90
+ * / Cell/header edge border. **Byte-identical** to today's literal
91
+ * `1px solid var(--og-border-color,#e0e0e0)`. G-ST2: a state border forces solid style (current
92
+ * calls pass no state → no-op).
93
+ *
94
+ * @param opts - 보더 스타일·state 여부(선택) / Border style / state flag (optional)
95
+ * @returns CSS border shorthand 문자열 / A CSS border-shorthand string
54
96
  */
55
97
  border(opts?: BorderOptions): string;
56
98
  /**
57
99
  * 행/섹션 구획선(가로 separator). 오늘은 border() 와 동일 문자열(=`1px solid var(--og-border-color,#e0e0e0)`).
58
100
  * 별도 메서드로 둔 이유: R12b 스킨에서 divider-style 이 border-style 과 갈라질 수 있어(§1.2)
59
101
  * 결정 지점을 미리 분리해 둔다. 현재 출력은 border() 와 byte-identical.
102
+ * / Row/section divider (horizontal separator). Today the same string as border()
103
+ * (=`1px solid var(--og-border-color,#e0e0e0)`). Kept as a separate method because in R12b skins
104
+ * divider-style may diverge from border-style (§1.2), so the decision point is split in advance.
105
+ * Current output is byte-identical to border().
106
+ *
107
+ * @returns CSS border shorthand 문자열(구획선용) / A CSS border-shorthand string (for the divider)
60
108
  */
61
109
  divider(): string;
62
110
  /**
63
- * G-ST1(코어 불변식, HANMS §2): 텍스처 존 제한. 텍스처는 컨테이너 배경·헤더 여백·빈 상태·온보딩
111
+ * G-ST1(코어 불변식, §2): 텍스처 존 제한. 텍스처는 컨테이너 배경·헤더 여백·빈 상태·온보딩
64
112
  * 오버레이에만 렌더되고, **데이터/상태/범위/병합/포커스 셀 배경 뒤에는 절대 렌더 금지**(스킨이 끌 수 없음).
65
113
  * 렌더 레이어가 셀 배경 텍스처를 바를 때 이 메서드로 zone 을 물어본다.
66
114
  * - 금지 zone → 항상 `'none'`(스킨과 무관).
67
115
  * - 허용 zone → `var(--og-texture-bg, none)`(스킨 미설정 시 none = byte-identical).
116
+ * / G-ST1 (core invariant, §2): texture-zone restriction. Texture renders only behind the
117
+ * container background, header padding, empty state, and onboarding overlay, and is **never**
118
+ * rendered behind data/status/range/merge/focus cell backgrounds (a skin cannot turn it on). The
119
+ * render layer asks this method for the zone before painting a cell-background texture.
120
+ * - forbidden zone → always `'none'` (skin-independent).
121
+ * - allowed zone → `var(--og-texture-bg, none)` (none when no skin is set = byte-identical).
122
+ *
123
+ * @param zone - 텍스처를 바르려는 위치 / The zone the texture would paint into
124
+ * @returns `'none'` 또는 텍스처 토큰 문자열 / `'none'` or the texture token string
68
125
  */
69
126
  texture(zone: 'container' | 'header-pad' | 'empty' | 'onboarding' | 'data' | 'status' | 'range' | 'merge' | 'focus'): string;
70
127
  /**
71
128
  * 반경 값 → CSS 길이 문자열. R12a 는 패스스루(`${px}px`)로 오늘의 리터럴을 그대로 보존한다.
72
129
  * 반경 리터럴이 흩어져 있던 결정 지점(이미지/프로그레스/스위치/뱃지/마스킹/상태뱃지)을 이 한 곳으로 모은다.
73
130
  * R12b 에서 `--og-radius-*` 스케일 토큰으로 승격할 착지점.
131
+ * / Radius value → CSS length string. R12a is a pass-through (`${px}px`) that preserves today's
132
+ * literal. It gathers the radius-literal decision points (image/progress/switch/badge/masking/
133
+ * state-badge) into this one place. A landing site for promotion to `--og-radius-*` scale tokens
134
+ * in R12b.
135
+ *
136
+ * @param px - 반경 픽셀 값 / Radius value in px
137
+ * @returns CSS 길이 문자열(`${px}px`) / A CSS length string (`${px}px`)
74
138
  */
75
139
  radius(px: number): string;
76
140
  /**
77
141
  * 데이터/그룹 셀의 인라인 패딩. 오늘의 그룹 셀 리터럴 `2px 8px` 과 동일.
78
142
  * R12b `--og-cell-padding-*` 승격 자리.
143
+ * / Inline padding for data/group cells. Same as today's group-cell literal `2px 8px`. A landing
144
+ * site for promotion to `--og-cell-padding-*` in R12b.
145
+ *
146
+ * @returns CSS padding shorthand 문자열 / A CSS padding-shorthand string
79
147
  */
80
148
  cellPadding(): string;
81
149
  /**
82
150
  * 엘리베이션(box-shadow) — R12b 스킨 축의 형태/잉크 분리 seam(§1.4)을 미리 표기한다.
83
151
  * R12a 에서는 어떤 인라인 사이트도 이 메서드를 경유하지 않는다(현재 그림자 결정이 인라인에 없음).
84
152
  * 값은 미래 토큰 + 오늘과 무해한 기본 geometry/alpha 로, 라우팅 0 이라 출력에 영향 없음.
153
+ * / Elevation (box-shadow) — pre-marks the shape/ink separation seam of the R12b skin axis
154
+ * (§1.4). In R12a no inline site routes through this method (no shadow decision is inline today).
155
+ * The value is a future token plus a harmless default geometry/alpha, and with zero routing it
156
+ * does not affect output.
157
+ *
158
+ * @param level - 그림자 단계(기본 'md') / Shadow level (default 'md')
159
+ * @returns CSS box-shadow 문자열 / A CSS box-shadow string
85
160
  */
86
161
  elevation(level?: ElevationLevel): string;
87
162
  /**
88
- * 포커스 링. HANMS 하드 계약(불변식): 가시 포커스는 비협상 —
163
+ * 포커스 링. 하드 계약(불변식): 가시 포커스는 비협상 —
89
164
  * `width < 2px` 또는 `style: 'none'` 은 최소 `2px solid` 로 **클램프**한다(스킨이 끌 수 없음).
90
165
  * R12a 에서 라우팅되는 인라인 포커스 사이트는 없다(포커스 표시는 CSS 클래스 `.og-cell-focused`).
91
166
  * 기본 반환은 현 프라이머리 색 기반의 AA-safe 링 — 미래 스킨/오버라이드가 이 초크포인트를 경유한다.
167
+ * / Focus ring. Hard contract (invariant): visible focus is non-negotiable — `width < 2px` or
168
+ * `style: 'none'` is **clamped** to at least `2px solid` (a skin cannot turn it off). No inline
169
+ * focus site routes through this in R12a (focus is shown via the CSS class `.og-cell-focused`).
170
+ * The default return is an AA-safe ring based on the current primary color — future
171
+ * skins/overrides pass through this chokepoint.
172
+ *
173
+ * @param opts - 링 두께·스타일·색(선택, 미지정 시 안전 기본값) / Ring width/style/color (optional; safe defaults when unset)
174
+ * @returns CSS outline/border shorthand 문자열 / A CSS outline/border-shorthand string
92
175
  */
93
176
  focusRing(opts?: FocusRingOptions): string;
94
177
  }
@@ -96,5 +179,9 @@ export declare class AppearanceResolver {
96
179
  * 프로세스 공유 기본 resolver. CellRenderer(팩토리로 생성돼 per-instance 컨텍스트를 받지 않음)가
97
180
  * 반경 결정을 이 초크포인트로 보낼 때 사용한다. R12a 반환은 상태 없는 순수값이라 공유가 안전하다.
98
181
  * per-instance(테마 컨텍스트) 주입은 R12b 스킨에서 확장한다.
182
+ * / The process-shared default resolver. Used by cell renderers (factory-created, so they receive
183
+ * no per-instance context) to route radius decisions through this chokepoint. R12a returns
184
+ * stateless pure values, so sharing is safe. Per-instance (theme-context) injection is extended in
185
+ * the R12b skin work.
99
186
  */
100
187
  export declare const defaultAppearance: AppearanceResolver;
@@ -0,0 +1,13 @@
1
+ import { VisualSpec } from './cf/encoders.js';
2
+ /**
3
+ * VisualSpec[] 를 셀 DOM 에 적용한다(데이터바·히트맵·아이콘셋·잉크·aria 텍스트 쌍둥이).
4
+ * cf/ 가 산출한 순수 스펙을 렌더층에서 물질화하는 유일 진입점. 호스트 CSS 격리 위해 전부 인라인 스타일.
5
+ * / Apply VisualSpec[] onto a cell (data-bar/heatmap/icon-set/ink/aria text-twin). The sole point
6
+ * that materializes cf/'s pure specs in the render layer. All-inline styles for host-CSS isolation.
7
+ *
8
+ * @param cellEl - 대상 셀 요소 / Target cell element
9
+ * @param specs - CFEngine.paintFor 산출 시각 스펙 배열 / The VisualSpec array from CFEngine.paintFor
10
+ * @param cellW - 셀 콘텐츠 폭(px) — 데이터바 길이 산출 / Cell content width (px) for bar length
11
+ * @param cellH - 셀 콘텐츠 높이(px) / Cell content height (px)
12
+ */
13
+ export declare function applyVisualSpecs(cellEl: HTMLElement, specs: VisualSpec[], cellW: number, _cellH: number): void;
@@ -3,25 +3,55 @@ import { ColumnLayout } from './ColumnLayout.js';
3
3
  import { GridRenderer } from './GridRenderer.js';
4
4
  import { CellEditor } from './editors/CellEditor.js';
5
5
  import { ColumnDef } from './types.js';
6
+ /**
7
+ * {@link CellEditManager} 의존성 주입 계약. / Dependency-injection contract for {@link CellEditManager}.
8
+ *
9
+ * 셀 편집기의 마운트/커밋에 필요한 데이터·렌더·i18n·수식 접근을 호스트 그리드가 제공한다.
10
+ * / The host grid supplies the data/render/i18n/formula access needed to mount and
11
+ * commit the cell editor.
12
+ */
6
13
  export interface CellEditDeps<T extends Record<string, any>> {
14
+ /** 데이터 레이어. / The data layer. */
7
15
  data: DataLayer<T>;
16
+ /** 컬럼 레이아웃. / The column layout. */
8
17
  colLayout: ColumnLayout<T>;
18
+ /** 현재 렌더러 조회(없으면 `null`). / Look up the current renderer (or `null`). */
9
19
  getRenderer: () => GridRenderer | null;
20
+ /** 그리드 컨테이너 엘리먼트 조회. / Look up the grid container element. */
10
21
  getContainer: () => HTMLElement;
22
+ /** 현재 그리드 옵션 조회. / Look up the current grid options. */
11
23
  getOptions: () => any;
24
+ /** 그리드 이벤트를 발행한다. / Emit a grid event. */
12
25
  emit: (event: string, ...args: any[]) => void;
26
+ /** 바디를 다시 그린다. / Re-render the body. */
13
27
  doRender: () => void;
28
+ /** 스크린리더용 상태 안내. / Announce a status message for screen readers. */
14
29
  announce: (msg: string) => void;
15
30
  /** i18n: 편집 셀 위치 announce 해석 + 에디터 ctx 로케일 주입. / i18n: resolve edit-cell announce + inject locale into editor ctx. */
16
31
  t: (key: string, params?: Record<string, string | number>) => string;
32
+ /** 셀 값을 기록한다(트리거/이벤트 발화 경로). / Write a cell value (goes through the trigger/event path). */
17
33
  writeCell: (ri: number, field: string, value: any) => void;
34
+ /** 지정 행이 보이도록 스크롤한다. / Scroll so the given row is visible. */
18
35
  scrollToRow: (ri: number) => void;
36
+ /** 현재 보이는(펼쳐진) 리프 컬럼 목록 조회. / Look up the currently visible leaf columns. */
19
37
  getVisibleLeaves: () => ColumnDef<T>[];
38
+ /** F3: 해당 셀이 수식을 갖는지 조회. / F3: check whether the cell currently holds a formula. */
20
39
  hasCellFormula?: (ri: number, field: string) => boolean;
40
+ /** F3: 셀의 수식 원문을 조회(없으면 `null`). / F3: get the cell's raw formula source (or `null`). */
21
41
  getCellFormula?: (ri: number, field: string) => string | null;
42
+ /** F3: 셀에 수식을 설정한다. / F3: set a formula on the cell. */
22
43
  setCellFormula?: (ri: number, field: string, formula: string) => void;
44
+ /** F3: 셀의 수식을 제거한다. / F3: clear the cell's formula. */
23
45
  clearCellFormula?: (ri: number, field: string) => void;
24
46
  }
47
+ /**
48
+ * 셀 편집 생명주기(포커스·시작·커밋·취소)를 관리하는 매니저. / Manages the cell edit lifecycle (focus, start, commit, cancel).
49
+ *
50
+ * 활성 에디터 인스턴스와 편집/포커스 대상 셀 좌표를 소유하며, 키보드/마우스 두 진입
51
+ * 경로 모두에서 동일한 편집기 마운트·커밋 흐름을 재사용한다.
52
+ * / Owns the active editor instance and the edit/focus target cell coordinates, and
53
+ * reuses the same editor mount/commit flow for both the keyboard and mouse entry paths.
54
+ */
25
55
  export declare class CellEditManager<T extends Record<string, any> = any> {
26
56
  private _activeEditor;
27
57
  private _editCell;
@@ -29,23 +59,66 @@ export declare class CellEditManager<T extends Record<string, any> = any> {
29
59
  private _dragColIdx;
30
60
  private _d;
31
61
  constructor(deps: CellEditDeps<T>);
62
+ /** 현재 마운트된 에디터 인스턴스(없으면 `null`). / The currently mounted editor instance (or `null`). */
32
63
  get activeEditor(): CellEditor | null;
64
+ /** 현재 편집 중인 셀 좌표(없으면 `null`). / Coordinates of the cell currently being edited (or `null`). */
33
65
  get editCell(): {
34
66
  ri: number;
35
67
  ci: number;
36
68
  } | null;
69
+ /** 현재 키보드 포커스 셀 좌표(없으면 `null`). / Coordinates of the currently keyboard-focused cell (or `null`). */
37
70
  get focusCell(): {
38
71
  ri: number;
39
72
  ci: number;
40
73
  } | null;
74
+ /** 컬럼 드래그 중인 컬럼 인덱스(없으면 `null`). / Column index currently being column-dragged (or `null`). */
41
75
  get dragColIdx(): number | null;
42
76
  set dragColIdx(v: number | null);
77
+ /**
78
+ * 키보드 포커스 셀을 설정하고, 스크롤·재렌더·상태 announce 를 처리한다. / Set the keyboard-focused cell; handles scroll, re-render, and status announce.
79
+ *
80
+ * @param ri - 포커스할 행의 flat index / Flat index of the row to focus
81
+ * @param ci - 포커스할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to focus, among visible leaf columns
82
+ */
43
83
  setFocusCell(ri: number, ci: number): void;
84
+ /** 키보드 포커스 셀을 해제한다. / Clear the keyboard-focused cell. */
44
85
  clearFocusCell(): void;
86
+ /**
87
+ * 키보드 진입(F2/Enter 등)으로 셀 편집을 시작한다. / Start cell editing via a keyboard entry point (F2/Enter, etc.).
88
+ *
89
+ * 토글형 컬럼(checkbox 등)은 에디터를 마운트하지 않고 값을 즉시 반전한다.
90
+ * / For toggle-type columns (checkbox, etc.), this flips the value immediately
91
+ * instead of mounting an editor.
92
+ *
93
+ * @param rowIndex - 편집할 행의 flat index / Flat index of the row to edit
94
+ * @param colIndex - 편집할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to edit, among visible leaf columns
95
+ */
45
96
  startEditByKey(rowIndex: number, colIndex: number): void;
97
+ /**
98
+ * 마우스 진입(클릭/더블클릭)으로 셀 편집을 시작한다. / Start cell editing via a mouse entry point (click/double-click).
99
+ *
100
+ * `editable` 옵션·컬럼별 editable 함수·토글형 컬럼 여부를 모두 확인한 뒤
101
+ * 에디터를 마운트한다.
102
+ * / Checks the `editable` option, any per-column editable function, and whether
103
+ * the column is toggle-type before mounting the editor.
104
+ *
105
+ * @param rowIndex - 편집할 행의 flat index / Flat index of the row to edit
106
+ * @param colIndex - 편집할 컬럼 인덱스(보이는 리프 컬럼 기준) / Column index to edit, among visible leaf columns
107
+ * @param _e - 트리거한 마우스 이벤트(현재 미사용) / The triggering mouse event (currently unused)
108
+ */
46
109
  startEdit(rowIndex: number, colIndex: number, _e: MouseEvent): void;
110
+ /** 활성 에디터의 현재 값으로 편집을 커밋한다(활성 에디터가 없으면 무시). / Commit editing using the active editor's current value (no-op if none is active). */
47
111
  commitEdit(): void;
112
+ /**
113
+ * 지정 값으로 편집을 커밋한다(에디터의 onCommit 콜백 경로). / Commit editing with an explicit value (the editor's onCommit callback path).
114
+ *
115
+ * @param ri - 대상 행의 flat index / Flat index of the target row
116
+ * @param ci - 대상 컬럼 인덱스 / Target column index
117
+ * @param value - 커밋할 값 / Value to commit
118
+ */
48
119
  commitEditWithValue(ri: number, ci: number, value: any): void;
120
+ /** 편집을 취소한다(값 변경 없이 에디터만 해제). / Cancel editing (releases the editor without applying a value change). */
49
121
  cancelEdit(): void;
122
+ /** @internal */
50
123
  private _finishEdit;
51
124
  }
@@ -2,32 +2,129 @@ import { DataLayer } from './DataLayer.js';
2
2
  import { ColumnLayout } from './ColumnLayout.js';
3
3
  import { CellEditManager } from './CellEditManager.js';
4
4
  import { RowManager } from './RowManager.js';
5
+ /**
6
+ * {@link CellEventHandler} 의존성 주입 계약. / Dependency-injection contract for {@link CellEventHandler}.
7
+ *
8
+ * DOM 셀 이벤트를 그리드 선택/편집/범위선택 서브시스템에 연결하는 데 필요한
9
+ * 접근 함수와 배선 훅을 호스트 그리드가 제공한다.
10
+ * / The host grid supplies the accessors and wiring hooks needed to route DOM
11
+ * cell events into the selection/edit/range-selection subsystems.
12
+ */
5
13
  export interface CellEventDeps<T extends Record<string, any>> {
14
+ /** 현재 데이터 레이어 조회. / Look up the current data layer. */
6
15
  getData: () => DataLayer<T>;
16
+ /** 현재 컬럼 레이아웃 조회. / Look up the current column layout. */
7
17
  getColLayout: () => ColumnLayout<T>;
18
+ /** 현재 그리드 옵션 조회. / Look up the current grid options. */
8
19
  getOptions: () => any;
20
+ /** 셀 편집 매니저 조회. / Look up the cell edit manager. */
9
21
  getEditMgr: () => CellEditManager<T>;
22
+ /** 행 선택/체크 매니저 조회. / Look up the row selection/check manager. */
10
23
  getRowMgr: () => RowManager<T>;
24
+ /** 그리드 이벤트를 발행한다. / Emit a grid event. */
11
25
  emit: (event: string, ...args: any[]) => void;
26
+ /** 셀 값을 기록한다(토글/라디오 컬럼 등에서 사용). / Write a cell value (used by toggle/radio columns, etc.). */
12
27
  writeCell: (ri: number, field: string, value: any) => void;
28
+ /** 바디를 다시 그린다. / Re-render the body. */
13
29
  doRender: () => void;
30
+ /** 그리드 컨테이너 엘리먼트 조회. / Look up the grid container element. */
14
31
  getContainer: () => HTMLElement;
15
- /** 'cells' 모드 클릭/Shift+클릭 위임 — RangeSelectionManager.handleClick 로 연결 */
32
+ /** 'cells' 모드 클릭/Shift+클릭 위임 — RangeSelectionManager.handleClick 로 연결
33
+ * / Delegates 'cells'-mode click/Shift+click — wired to `RangeSelectionManager.handleClick`. */
16
34
  onCellsClick?: (ri: number, ci: number, shiftKey: boolean) => void;
17
- /** 범위 드래그 선택 상태머신(§3.1) — RangeSelectionManager.handleCellMouseDown/Move/Up 로 연결 */
35
+ /** 범위 드래그 선택 상태머신(§3.1) — RangeSelectionManager.handleCellMouseDown/Move/Up 로 연결
36
+ * / Range drag-select state machine (§3.1) — wired to `RangeSelectionManager.handleCellMouseDown/Move/Up`. */
18
37
  rangeMouseDown?: (ri: number, ci: number, e: MouseEvent) => void;
38
+ /** {@link rangeMouseDown} 참조 — 드래그 이동 단계. / See {@link rangeMouseDown} — the drag-move phase. */
19
39
  rangeMouseMove?: (ri: number, ci: number, e: MouseEvent) => void;
40
+ /** {@link rangeMouseDown} 참조 — 드래그 종료 단계. / See {@link rangeMouseDown} — the drag-end phase. */
20
41
  rangeMouseUp?: (ri: number, ci: number, e: MouseEvent) => void;
21
42
  }
43
+ /**
44
+ * 셀 DOM 이벤트(클릭·더블클릭·마우스·키)를 라우팅하는 핸들러. / Routes cell DOM events (click, double-click, mouse, key) to the right subsystem.
45
+ *
46
+ * 선택 모드(`single`/`multiple`/`row`/`cells`)에 따라 행/범위 선택을 위임하고,
47
+ * 토글·라디오 컬럼 값 반영, 편집 시작, 그리고 공개 셀/행 이벤트(`cellClick` 등)
48
+ * 발행까지 한 곳에서 처리한다.
49
+ * / Delegates row/range selection based on the selection mode (`single`/`multiple`/
50
+ * `row`/`cells`), applies toggle/radio column values, kicks off editing, and emits
51
+ * the public cell/row events (`cellClick`, etc.) — all in one place.
52
+ */
22
53
  export declare class CellEventHandler<T extends Record<string, any> = any> {
23
54
  private _d;
24
55
  constructor(deps: CellEventDeps<T>);
56
+ /**
57
+ * 셀 클릭을 처리한다: 선택 모드 적용, 토글/라디오 값 반영, `cellClick`/`rowClick`
58
+ * 이벤트 발행, 필요 시 편집 시작까지 수행한다.
59
+ * / Handles a cell click: applies the selection mode, updates toggle/radio values,
60
+ * emits `cellClick`/`rowClick`, and starts editing when appropriate.
61
+ *
62
+ * @param rowIndex - 클릭된 행의 flat index / Flat index of the clicked row
63
+ * @param colIndex - 클릭된 컬럼 인덱스(행 헤더 등은 -1일 수 있음) / Clicked column index (may be -1 for row-header-like clicks)
64
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
65
+ */
25
66
  handleCellClick(rowIndex: number, colIndex: number, e: MouseEvent): void;
67
+ /**
68
+ * 셀 더블클릭을 처리한다: `cellDblClick`/`rowDblClick` 발행, `editMode:'dblclick'` 이면 편집 시작.
69
+ * / Handles a cell double-click: emits `cellDblClick`/`rowDblClick`, and starts editing
70
+ * when `editMode` is `'dblclick'`.
71
+ *
72
+ * @param rowIndex - 대상 행의 flat index / Flat index of the target row
73
+ * @param colIndex - 대상 컬럼 인덱스 / Target column index
74
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
75
+ */
26
76
  handleCellDblClick(rowIndex: number, colIndex: number, e: MouseEvent): void;
77
+ /**
78
+ * 마우스 오버: `cellMouseOver`/`rowMouseOver` 이벤트를 발행한다. / Mouse-over: emits `cellMouseOver`/`rowMouseOver`.
79
+ *
80
+ * @param ri - 대상 행의 flat index / Flat index of the target row
81
+ * @param ci - 대상 컬럼 인덱스 / Target column index
82
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
83
+ */
27
84
  handleCellMouseOver(ri: number, ci: number, e: MouseEvent): void;
85
+ /**
86
+ * 마우스 아웃: `cellMouseOut`/`rowMouseOut` 이벤트를 발행한다. / Mouse-out: emits `cellMouseOut`/`rowMouseOut`.
87
+ *
88
+ * @param ri - 대상 행의 flat index / Flat index of the target row
89
+ * @param ci - 대상 컬럼 인덱스 / Target column index
90
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
91
+ */
28
92
  handleCellMouseOut(ri: number, ci: number, e: MouseEvent): void;
93
+ /**
94
+ * 마우스 다운: 범위 드래그 선택 상태머신을 먼저 위임한 뒤 `cellMouseDown`/`rowMouseDown` 을 발행한다.
95
+ * / Mouse-down: delegates to the range drag-select state machine first, then emits
96
+ * `cellMouseDown`/`rowMouseDown`.
97
+ *
98
+ * @param ri - 대상 행의 flat index / Flat index of the target row
99
+ * @param ci - 대상 컬럼 인덱스 / Target column index
100
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
101
+ */
29
102
  handleCellMouseDown(ri: number, ci: number, e: MouseEvent): void;
103
+ /**
104
+ * 마우스 업: 범위 드래그 선택 종료를 위임한 뒤 `cellMouseUp`/`rowMouseUp` 을 발행한다.
105
+ * / Mouse-up: delegates the drag-select end, then emits `cellMouseUp`/`rowMouseUp`.
106
+ *
107
+ * @param ri - 대상 행의 flat index / Flat index of the target row
108
+ * @param ci - 대상 컬럼 인덱스 / Target column index
109
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
110
+ */
30
111
  handleCellMouseUp(ri: number, ci: number, e: MouseEvent): void;
112
+ /**
113
+ * 마우스 이동: 범위 드래그 확장을 위임한 뒤 `cellMouseMove`/`rowMouseMove` 를 발행한다.
114
+ * / Mouse-move: delegates the drag-select extension, then emits `cellMouseMove`/`rowMouseMove`.
115
+ *
116
+ * @param ri - 대상 행의 flat index / Flat index of the target row
117
+ * @param ci - 대상 컬럼 인덱스 / Target column index
118
+ * @param e - 원본 마우스 이벤트 / The originating mouse event
119
+ */
31
120
  handleCellMouseMove(ri: number, ci: number, e: MouseEvent): void;
121
+ /**
122
+ * 현재 포커스 셀에 대한 키보드 이벤트를 공개 이벤트로 발행한다(편집 중이거나 포커스 셀이 없으면 무시).
123
+ * / Emits a public event for a keyboard action on the currently focused cell
124
+ * (no-op while editing or when there is no focus cell).
125
+ *
126
+ * @param eventName - 발행할 이벤트 종류 / Which event kind to emit
127
+ * @param e - 원본 키보드 이벤트 / The originating keyboard event
128
+ */
32
129
  handleCellKeyEvt(eventName: 'cellKeyDown' | 'cellKeyUp' | 'cellKeyPress', e: KeyboardEvent): void;
33
130
  }
@@ -1,4 +1,28 @@
1
1
  import { ColumnDef } from './types.js';
2
+ /**
3
+ * 컬럼이 토글(체크박스/스위치) 셀인지 판정. / Whether a column renders as a toggle (checkbox/switch) cell.
4
+ *
5
+ * `type` 이 `boolean`/`checkbox` 이거나 renderer 가 `checkbox`/`switch` 이면 참.
6
+ * / True when `type` is `boolean`/`checkbox`, or the renderer is `checkbox`/`switch`.
7
+ *
8
+ * @typeParam T - 행 데이터 타입 / Row data type
9
+ * @param col - 검사할 컬럼 정의 / Column definition to inspect
10
+ * @returns 토글 셀이면 true / true if the column is a toggle cell
11
+ */
2
12
  export declare function isToggleCol<T>(col: ColumnDef<T>): boolean;
13
+ /**
14
+ * 컬럼이 셀렉트(드롭다운) 셀인지 판정. / Whether a column renders as a select (dropdown) cell.
15
+ *
16
+ * @typeParam T - 행 데이터 타입 / Row data type
17
+ * @param col - 검사할 컬럼 정의 / Column definition to inspect
18
+ * @returns `type` 이 `select` 이면 true / true if `type` is `select`
19
+ */
3
20
  export declare function isSelectCol<T>(col: ColumnDef<T>): boolean;
21
+ /**
22
+ * 컬럼이 라디오 버튼 셀인지 판정. / Whether a column renders as a radio-button cell.
23
+ *
24
+ * @typeParam T - 행 데이터 타입 / Row data type
25
+ * @param col - 검사할 컬럼 정의 / Column definition to inspect
26
+ * @returns `type` 이 `radio` 이면 true / true if `type` is `radio`
27
+ */
4
28
  export declare function isRadioCol<T>(col: ColumnDef<T>): boolean;
@@ -2,31 +2,76 @@ import { CellRange } from './types.js';
2
2
  import { FlatRowModel } from './FlatRowModel.js';
3
3
  import { ChartConfig, ChartInstance } from './chart/types.js';
4
4
  import { ChartColumnRef } from './chart/DataExtractor.js';
5
+ /**
6
+ * ChartManager 가 그리드 서브시스템을 읽기 위해 주입받는 클로저 묶음. / Closures injected into
7
+ * ChartManager so it can read grid subsystem state without owning it directly.
8
+ */
5
9
  export interface ChartManagerDeps {
10
+ /** 차트 패널을 붙일 그리드 컨테이너 엘리먼트. / Grid container element the chart panel mounts into. */
6
11
  getContainer(): HTMLElement;
12
+ /** 현재 GridOptions(차트 관련 `options.chart` 포함). / Current GridOptions (includes `options.chart`). */
7
13
  getOptions(): any;
14
+ /** 필터/정렬 적용 전 전체 행. / All rows, before filter/sort. */
8
15
  getAllRows(): Array<Record<string, any>>;
16
+ /** 현재 선택된 행. / Currently selected rows. */
9
17
  getSelectedRows(): Array<Record<string, any>>;
18
+ /** 현재 체크된 행. / Currently checked rows. */
10
19
  getCheckedRows(): Array<Record<string, any>>;
11
- /** ColumnLayout.visibleLeaves 투영(숨김 제외, C0.4). */
20
+ /** ColumnLayout.visibleLeaves 투영(숨김 제외, C0.4). / Projection of ColumnLayout.visibleLeaves (hidden columns excluded, C0.4). */
12
21
  getVisibleColumns(): ChartColumnRef[];
22
+ /** 행 합성 결과를 조회하는 baseline 모델. / Baseline model exposing the composed row structure. */
13
23
  getFlatModel(): FlatRowModel;
24
+ /** stable rowId 로 원본 행을 조회(없으면 undefined). / Look up the source row by stable rowId (undefined if absent). */
14
25
  getRowById(rowId: string): Record<string, any> | undefined;
15
- /** F1 seam(C4). 없으면 range 소스는 selection 으로 강등(§7). */
26
+ /** F1 seam(C4). 없으면 range 소스는 selection 으로 강등(§7). / F1 seam (C4); when absent, a `range` source degrades to `selection` (§7). */
16
27
  getActiveRange?(): CellRange | null;
17
- /** 그리드 이벤트 구독/해제(EventEmitter). */
28
+ /** 그리드 이벤트 구독/해제(EventEmitter). / Subscribe/unsubscribe grid events (EventEmitter). */
18
29
  on(ev: string, cb: (...a: any[]) => void): void;
19
30
  off(ev: string, cb: (...a: any[]) => void): void;
31
+ /** 그리드 이벤트 발행. / Emit a grid event. */
20
32
  emit(ev: string, ...args: any[]): void;
33
+ /** aria-live 영역에 메시지를 공지. / Announce a message via the aria-live region. */
21
34
  announce(msg: string): void;
22
35
  /** i18n: 차트 배지·패널 aria·announce 해석. / i18n: resolve chart badges/panel-aria/announce. */
23
36
  t(key: string, params?: Record<string, string | number>): string;
24
37
  }
38
+ /** F4 차트 인스턴스 핸들(update/refresh/destroy 등). 정의는 chart/types.js 참고.
39
+ * / F4 chart instance handle (update/refresh/destroy, etc.). See chart/types.js for the definition. */
25
40
  export type { ChartInstance } from './chart/types.js';
41
+ /**
42
+ * F4 통합 차트 매니저. / F4 integrated chart manager.
43
+ *
44
+ * 차트 설정(`ChartConfig`)을 받아 데이터 추출 → 다운샘플 → 렌더 스펙 조립 → 어댑터 렌더까지의
45
+ * 파이프라인을 실행하고, 생성된 각 차트를 라이브 갱신(dataChange/formulaRecalc)·리사이즈·파괴까지
46
+ * 책임지고 관리한다. / Given a `ChartConfig`, runs the pipeline from data extraction through
47
+ * downsampling, render-spec assembly, and adapter rendering, then owns each created chart's
48
+ * live updates (dataChange/formulaRecalc), resize handling, and teardown.
49
+ */
26
50
  export declare class ChartManager {
27
51
  private _d;
28
52
  private _charts;
29
53
  constructor(deps: ChartManagerDeps);
54
+ /**
55
+ * 새 차트를 생성해 그리드에 마운트한다. / Create a new chart and mount it into the grid.
56
+ *
57
+ * 범위 스냅샷(source.kind==='range') → 어댑터 결정 → 패널 DOM 구성 → 데이터 추출/렌더 →
58
+ * 배지/라이브구독/리사이즈 관찰까지 한 번에 처리한다. 초기화 도중 실패하면 부분 생성된
59
+ * DOM/구독을 정리하고 원 예외를 다시 던진다.
60
+ * / Handles range snapshotting (when source.kind==='range'), adapter resolution, panel DOM
61
+ * construction, data extraction/render, badges, live subscription, and resize observation in
62
+ * one call. If initialization fails partway, partially created DOM/subscriptions are cleaned up
63
+ * and the original error is re-thrown.
64
+ *
65
+ * @param config - 차트 생성 설정(소스·타입·배치 등) / Chart creation config (source, type, placement, etc.)
66
+ * @returns 생성된 차트 인스턴스 핸들 / Handle for the created chart instance
67
+ * @example
68
+ * const chart = chartManager.createChart({
69
+ * source: { kind: 'selection' },
70
+ * type: 'bar',
71
+ * category: 'name',
72
+ * });
73
+ * chart.on('chartRender', () => console.log('rendered'));
74
+ */
30
75
  createChart(config: ChartConfig): ChartInstance;
31
76
  /**
32
77
  * config.size 가 명시되면 그대로 쓴다. 없으면 host 의 실측 clientWidth(실브라우저에서
@@ -36,7 +81,10 @@ export declare class ChartManager {
36
81
  */
37
82
  private _resolveRenderSize;
38
83
  private _attachResizeObserver;
84
+ /** 파괴되지 않은 모든 차트 인스턴스를 반환한다. / Return all chart instances that have not been destroyed. */
39
85
  getCharts(): ChartInstance[];
86
+ /** 이 매니저가 소유한 모든 차트를 파괴한다(DOM 제거·구독 해제 포함).
87
+ * / Destroy every chart owned by this manager (DOM removal and unsubscription included). */
40
88
  destroyCharts(): void;
41
89
  private _snapshotRange;
42
90
  private _extract;