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,25 +1,40 @@
1
- /** render() 옵션. size 미지정 시 svg 는 viewBox/CSS 로 크기를 상속(width/height 속성 생략). */
1
+ /**
2
+ * render() 옵션. size 미지정 시 svg 는 viewBox/CSS 로 크기를 상속(width/height 속성 생략).
3
+ * / render() options. When size is omitted, the svg inherits its size from viewBox/CSS (width/height attrs skipped).
4
+ */
2
5
  export interface IconRenderOptions {
3
- /** px 정사각 크기(width=height). 미지정 시 속성 생략(CSS/컨테이너가 결정). */
6
+ /** px 정사각 크기(width=height). 미지정 시 속성 생략(CSS/컨테이너가 결정). / Square size in px (width=height); omitted when unset (CSS/container decides). */
4
7
  size?: number;
5
- /** 접근성 제목. 지정 시 <title> + role="img" 추가(스크린리더). 미지정 시 장식용(부모가 aria 담당). */
8
+ /** 접근성 제목. 지정 시 <title> + role="img" 추가(스크린리더). 미지정 시 장식용(부모가 aria 담당). / Accessible title; adds <title> + role="img" when set (screen readers). Decorative otherwise (parent owns aria). */
6
9
  title?: string;
7
- /** true → SVGElement(DOMParser) 반환. 기본 false → SVG 마크업 문자열. */
10
+ /** true → SVGElement(DOMParser) 반환. 기본 false → SVG 마크업 문자열. / true → return an SVGElement (DOMParser). Default false → SVG markup string. @defaultValue false */
8
11
  el?: boolean;
9
12
  }
10
13
  /**
11
14
  * 시맨틱 ROLE → 아이콘 key(`BOOTSTRAP_ICONS` 의 symbolId) 기본 매핑.
15
+ * / Default map of semantic ROLE → icon key (a `BOOTSTRAP_ICONS` symbolId).
16
+ *
12
17
  * 렌더 코드는 이 역할 이름만 참조한다. key 교체는 이 표(혹은 register/setIcon)만 고치면 된다.
13
18
  * 참고 스왑: `row.delete`→`trash3`(Bootstrap 의 표준 휴지통, task 의 'trash' 동족), `chart.line`→`graph-up`.
19
+ * / Render code references only these role names; swapping a glyph means editing this table (or register/setIcon).
14
20
  */
15
21
  export declare const DEFAULT_ICON_ROLES: Readonly<Record<string, string>>;
16
22
  /**
17
23
  * IconRegistry — role → 글리프 본문(inner SVG markup) 해석 + svg 래핑.
24
+ * / IconRegistry — resolves role → glyph body (inner SVG markup) and wraps it in an svg.
18
25
  *
19
26
  * 저장 단위는 **글리프 본문 문자열**(<path>/<g> 마크업). register(role, svgOrKey) 는
20
27
  * - svgOrKey 가 `BOOTSTRAP_ICONS` 의 알려진 key 면 그 본문으로,
21
28
  * - 아니면 **원시 SVG 본문**(사용자 커스텀 <path…>)으로 저장한다.
22
29
  * 부모 체인(_parent)으로 per-instance 오버라이드 레지스트리를 전역 위에 얹는다(멀티그리드 격리).
30
+ * / The storage unit is the glyph body string (<path>/<g> markup). register(role, svgOrKey) stores either
31
+ * the body of a known `BOOTSTRAP_ICONS` key, or the raw SVG body otherwise. A parent chain (_parent) layers
32
+ * a per-instance override registry on top of the global one (multi-grid isolation).
33
+ *
34
+ * @example
35
+ * const reg = iconRegistry.child();
36
+ * reg.register('sort.asc', 'arrow-up');
37
+ * const svg = reg.render('sort.asc', { size: 16 }) as string;
23
38
  */
24
39
  export declare class IconRegistry {
25
40
  private _roles;
@@ -28,28 +43,60 @@ export declare class IconRegistry {
28
43
  /**
29
44
  * role 에 글리프를 등록/교체. svgOrKey 가 알려진 아이콘 key 면 그 본문을, 아니면 원시 SVG
30
45
  * 본문 마크업으로 간주한다(코어 편집 없이 아이콘 교체 — OCP).
46
+ * / Register/replace a glyph for a role. A known icon key resolves to its body; otherwise svgOrKey is
47
+ * treated as raw SVG body markup (swap icons without editing core — OCP).
48
+ *
49
+ * @param role - 시맨틱 역할 키(예: 'sort.asc') / Semantic role key (e.g. 'sort.asc')
50
+ * @param svgOrKey - 알려진 아이콘 key 또는 원시 SVG 본문 / A known icon key or raw SVG body
51
+ * @returns 체이닝용 this / this for chaining
31
52
  */
32
53
  register(role: string, svgOrKey: string): this;
33
- /** role 이 (자신 또는 부모 체인에) 등록돼 있는가. */
54
+ /** role 이 (자신 또는 부모 체인에) 등록돼 있는가. / Whether a role is registered (self or parent chain). */
34
55
  has(role: string): boolean;
35
- /** role → 글리프 본문(inner markup). 미등록이면 null(부모 체인까지 조회). */
56
+ /**
57
+ * role → 글리프 본문(inner markup). 미등록이면 null(부모 체인까지 조회).
58
+ * / role → glyph body (inner markup); null if unregistered (searches up the parent chain).
59
+ *
60
+ * @param role - 조회할 역할 키 / Role key to resolve
61
+ * @returns 글리프 본문 또는 null / Glyph body or null
62
+ */
36
63
  resolveBody(role: string): string | null;
37
- /** 이 레지스트리를 부모로 하는 자식(per-instance 오버라이드용) 생성. */
64
+ /** 이 레지스트리를 부모로 하는 자식(per-instance 오버라이드용) 생성. / Create a child registry with this as parent (for per-instance overrides). */
38
65
  child(): IconRegistry;
39
66
  /**
40
67
  * role 을 `<svg viewBox=ICON_VIEWBOX>` 로 렌더. 기본 반환은 SVG 마크업 문자열(innerHTML 용);
41
68
  * opts.el 이면 SVGElement. 미지원 role 은 빈 svg 폴백(never throw).
42
69
  * 스킨 토큰: fill=currentColor(presentation attr) + stroke-linejoin=var(--og-icon-corner,miter).
70
+ * / Render a role as `<svg viewBox=ICON_VIEWBOX>`. Returns SVG markup string by default (for innerHTML);
71
+ * opts.el returns an SVGElement. Unknown roles fall back to an empty svg (never throws).
72
+ *
73
+ * @param role - 렌더할 역할 키 / Role key to render
74
+ * @param opts - 렌더 옵션 / Render options
75
+ * @returns SVG 마크업 문자열 또는 SVGElement(opts.el) / SVG markup string, or SVGElement when opts.el
43
76
  */
44
77
  render(role: string, opts?: IconRenderOptions): string | SVGElement;
45
- /** 등록된 role 목록(자신만, 디버깅/테스트용). */
78
+ /** 등록된 role 목록(자신만, 디버깅/테스트용). / List of registered roles (self only; for debugging/tests). */
46
79
  roles(): string[];
47
80
  }
48
81
  /**
49
82
  * 프로세스 공유 기본 아이콘 레지스트리(시맨틱 role 시드 완료).
83
+ * / Process-shared default icon registry (seeded with semantic roles).
84
+ *
50
85
  * CellRenderer 등 팩토리 생성 렌더러(인스턴스 컨텍스트 없음)가 이 초크포인트로 아이콘을 얻는다.
51
86
  * per-instance 교체는 `grid.setIcon()`(이 레지스트리의 child) 로, 전역 확장은 `defineIconSet()` 로.
87
+ * / Factory-created renderers (e.g. CellRenderer, without instance context) obtain icons through this
88
+ * chokepoint. Per-instance swaps go through `grid.setIcon()` (a child of this registry); global extension
89
+ * through `defineIconSet()`.
52
90
  */
53
91
  export declare const iconRegistry: IconRegistry;
54
- /** 편의 정적 render — 공유 기본 레지스트리로 위임(`IconRegistry.render(role, opts)`). */
92
+ /**
93
+ * 편의 정적 render — 공유 기본 레지스트리로 위임(`IconRegistry.render(role, opts)`).
94
+ * / Convenience static render — delegates to the shared default registry (`IconRegistry.render(role, opts)`).
95
+ *
96
+ * @param role - 렌더할 역할 키 / Role key to render
97
+ * @param opts - 렌더 옵션 / Render options
98
+ * @returns SVG 마크업 문자열 또는 SVGElement(opts.el) / SVG markup string, or SVGElement when opts.el
99
+ * @example
100
+ * el.innerHTML = renderIcon('filter') as string;
101
+ */
55
102
  export declare function renderIcon(role: string, opts?: IconRenderOptions): string | SVGElement;
@@ -2,45 +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
- /** F1 범위 선택 배선 훅(M-3/M-4/M-5) — RangeSelectionManager 가 그대로 구현한다. */
5
+ /**
6
+ * F1 범위 선택 배선 훅(M-3/M-4/M-5) — RangeSelectionManager 가 그대로 구현한다.
7
+ * / F1 range-selection wiring hooks (M-3/M-4/M-5) — implemented directly by
8
+ * `RangeSelectionManager`.
9
+ */
6
10
  export interface RangeKeyboardHooks {
11
+ /** 범위 선택 모드(`selection:'cells'`)가 활성인지. / Whether range-select mode (`selection:'cells'`) is active. */
7
12
  isEnabled(): boolean;
13
+ /** 현재 유효한 범위 선택이 있는지. / Whether there is a currently valid range selection. */
8
14
  hasSelection(): boolean;
15
+ /**
16
+ * 포커스를 지정 방향으로 확장한다(Shift+화살표). / Extend the focus range in the given direction (Shift+Arrow).
17
+ * @param dir - 확장 방향 / Direction to extend
18
+ */
9
19
  extendFocus(dir: 'up' | 'down' | 'left' | 'right'): void;
20
+ /**
21
+ * Ctrl+D/Ctrl+R 채우기를 축 방향으로 실행한다. / Run a Ctrl+D/Ctrl+R fill along the given axis.
22
+ * @param axis - 채우기 축(`'down'` = Ctrl+D, `'right'` = Ctrl+R) / Fill axis (`'down'` for Ctrl+D, `'right'` for Ctrl+R)
23
+ */
10
24
  ctrlFill(axis: 'down' | 'right'): void;
25
+ /** 범위 선택을 해제한다. / Clear the range selection. */
11
26
  clear(): void;
12
- /** 범위 없으면 null(호출측이 기존 focusCell/selectedRows 경로로 폴백) */
27
+ /**
28
+ * 범위 없으면 null(호출측이 기존 focusCell/selectedRows 경로로 폴백)
29
+ * / Returns `null` when there is no range (caller falls back to the
30
+ * focusCell/selectedRows path).
31
+ * @returns 범위의 TSV 텍스트, 또는 `null` / TSV text of the range, or `null`
32
+ */
13
33
  copyText(): string | null;
14
- /** true = 배치 경유로 처리함, false = 범위 없음(폴백) */
34
+ /**
35
+ * true = 배치 경유로 처리함, false = 범위 없음(폴백)
36
+ * / `true` if handled via the batch path, `false` if there is no range (caller falls back).
37
+ * @param text - 붙여넣을 TSV 텍스트 / TSV text to paste
38
+ * @returns 배치 경유로 처리되었는지 여부 / Whether this was handled via the batch path
39
+ */
15
40
  pasteText(text: string): boolean;
16
41
  }
42
+ /**
43
+ * {@link KeyboardManager} 의존성 주입 계약. / Dependency-injection contract for {@link KeyboardManager}.
44
+ */
17
45
  export interface KeyboardDeps<T extends Record<string, any>> {
46
+ /** 셀 편집 매니저 조회. / Look up the cell edit manager. */
18
47
  getEditMgr: () => CellEditManager<T>;
48
+ /** 행 선택/체크 매니저 조회. / Look up the row selection/check manager. */
19
49
  getRowMgr: () => RowManager<T>;
50
+ /** 현재 데이터 레이어 조회. / Look up the current data layer. */
20
51
  getData: () => DataLayer<T>;
52
+ /** 현재 컬럼 레이아웃 조회. / Look up the current column layout. */
21
53
  getColLayout: () => ColumnLayout<T>;
54
+ /** 현재 그리드 옵션 조회. / Look up the current grid options. */
22
55
  getOptions: () => any;
56
+ /** 키보드 포커스 셀을 설정한다. / Set the keyboard-focused cell. */
23
57
  setFocusCell: (ri: number, ci: number) => void;
58
+ /** 행 드래그(Ctrl+화살표) 이동을 처리한다. / Handle a row drag (Ctrl+Arrow) move. */
24
59
  handleRowDrop: (from: number, to: number) => void;
60
+ /** 바디를 다시 그린다. / Re-render the body. */
25
61
  doRender: () => void;
62
+ /** 스크린리더용 상태 안내. / Announce a status message for screen readers. */
26
63
  announce: (msg: string) => void;
27
64
  /** i18n: 행 이동 announce 해석. / i18n: resolve row-move announce. */
28
65
  t: (key: string, params?: Record<string, string | number>) => string;
66
+ /** 그리드 이벤트를 발행한다. / Emit a grid event. */
29
67
  emit: (event: string, ...args: any[]) => void;
68
+ /** 현재 렌더된 가시 행 범위(`[start, end]`)를 조회. / Look up the currently rendered visible row range (`[start, end]`). */
30
69
  visRange: () => [number, number];
70
+ /** 포커스 셀에 대한 공개 키 이벤트를 발행한다. / Emit a public key event for the focused cell. */
31
71
  handleCellKeyEvt: (eventName: 'cellKeyDown' | 'cellKeyUp' | 'cellKeyPress', e: KeyboardEvent) => void;
32
- /** M-4: 붙여넣기 쓰기 퍼널을 writeCell(배치)로 교체(CON-2, 의도적 동작 변경) */
72
+ /** M-4: 붙여넣기 쓰기 퍼널을 writeCell(배치)로 교체(CON-2, 의도적 동작 변경)
73
+ * / M-4: replaces the paste write funnel with batched `writeCell` (CON-2, an
74
+ * intentional behavior change). */
33
75
  writeCells?: (patches: Array<{
34
76
  rowIndex: number;
35
77
  field: string;
36
78
  value: any;
37
79
  }>) => number;
80
+ /** 범위 선택 배선 훅 조회(범위 선택 미사용 시 `null`). / Look up the range-selection wiring hooks (or `null` when range selection is unused). */
38
81
  getRangeHooks?: () => RangeKeyboardHooks | null;
39
82
  }
83
+ /**
84
+ * 키보드 내비게이션·단축키(복사/붙여넣기/행 이동/범위 선택)를 처리하는 매니저.
85
+ * / Handles keyboard navigation and shortcuts (copy/paste, row move, range selection).
86
+ *
87
+ * `handleKeyDown` 하나로 모든 키 입력을 받아, 클립보드·범위선택 훅·기본 셀 포커스
88
+ * 이동 순으로 우선순위를 매겨 위임한다.
89
+ * / A single `handleKeyDown` entry point receives all key input and dispatches by
90
+ * priority: clipboard shortcuts, range-selection hooks, then plain cell-focus movement.
91
+ */
40
92
  export declare class KeyboardManager<T extends Record<string, any> = any> {
41
93
  private _d;
42
94
  constructor(deps: KeyboardDeps<T>);
95
+ /**
96
+ * 그리드 컨테이너의 키다운 이벤트를 처리한다. / Handle a keydown event on the grid container.
97
+ *
98
+ * 편집 중이면 무시하고, 이후 순서대로 처리한다: 공개 `cellKeyDown` 발행 →
99
+ * 복사/붙여넣기(Ctrl+C/V) → 범위 채우기(Ctrl+D/R)·범위 확장(Shift+화살표) →
100
+ * 행 드래그(Ctrl+화살표) → 기본 셀 포커스 이동/Tab/Home/End/PageUp/PageDown →
101
+ * 체크·선택 토글(Space) → 편집 시작(F2/Enter) → 포커스/범위 해제(Escape).
102
+ * / While editing, this is a no-op. Otherwise, processing order is: emit the
103
+ * public `cellKeyDown` event → copy/paste (Ctrl+C/V) → range fill (Ctrl+D/R) /
104
+ * range extend (Shift+Arrow) → row drag (Ctrl+Arrow) → plain cell-focus movement
105
+ * (arrows/Tab/Home/End/PageUp/PageDown) → check/select toggle (Space) → start
106
+ * editing (F2/Enter) → clear focus/range (Escape).
107
+ *
108
+ * @param e - 원본 키보드 이벤트 / The originating keyboard event
109
+ */
43
110
  handleKeyDown(e: KeyboardEvent): void;
111
+ /**
112
+ * 현재 선택을 클립보드에 TSV 로 복사한다. / Copy the current selection to the clipboard as TSV.
113
+ *
114
+ * 우선순위: 범위 선택(있으면 그 TSV) → 단일 포커스 셀 값 → 다중 선택 행(TSV).
115
+ * / Priority: range selection (its TSV, if any) → single focused cell value →
116
+ * multi-row selection (TSV).
117
+ * @internal
118
+ */
44
119
  private _copyToClipboard;
120
+ /**
121
+ * 클립보드의 TSV 텍스트를 붙여넣는다. / Paste TSV text from the clipboard.
122
+ *
123
+ * 범위 선택이 있으면 범위 붙여넣기(타일 전개)가 우선하고, 그렇지 않으면 포커스
124
+ * 셀을 기준으로 배치 `writeCells` 를 호출한다.
125
+ * / Range paste (tiled expansion) takes priority when a range is selected;
126
+ * otherwise this calls batched `writeCells` anchored at the focus cell.
127
+ * @internal
128
+ */
45
129
  private _pasteFromClipboard;
46
130
  }
@@ -1,21 +1,22 @@
1
- /** 지원 마스킹 타입 */
1
+ /** 지원 마스킹 타입. / Supported masking types. */
2
2
  export type MaskType = 'ssn' | 'phone' | 'mobile' | 'email' | 'credit' | 'account' | 'password' | 'name' | 'ip' | 'partial';
3
- /** 마스킹 상세 옵션 */
3
+ /** 마스킹 상세 옵션. / Detailed masking options. */
4
4
  export interface MaskDef {
5
+ /** 마스킹 타입. / Masking type. */
5
6
  type: MaskType;
6
- /** 마스킹 치환 문자 (기본: '*') */
7
+ /** 마스킹 치환 문자. 기본 '*'. / Masking replacement character. Default '*'. @defaultValue '*' */
7
8
  char?: string;
8
- /** partial/account: 앞 N자리 표시 */
9
+ /** partial/account: 앞 N자리 표시. / partial/account: reveal the first N characters. */
9
10
  visiblePrefix?: number;
10
- /** partial/account: 뒤 N자리 표시 */
11
+ /** partial/account: 뒤 N자리 표시. / partial/account: reveal the last N characters. */
11
12
  visibleSuffix?: number;
12
13
  }
13
14
  /**
14
- * 원본 값에 마스킹을 적용해 표시용 문자열을 반환.
15
+ * 원본 값에 마스킹을 적용해 표시용 문자열을 반환. / Apply masking to a raw value and return a display string.
15
16
  *
16
- * @param value 원본 값 (null/undefined → 빈 문자열 그대로 반환)
17
- * @param maskDef 마스킹 타입 또는 상세 옵션
18
- * @returns 마스킹된 문자열
17
+ * @param value - 원본 값 (null/undefined → 빈 문자열 그대로 반환) / Raw value (null/undefined → empty string)
18
+ * @param maskDef - 마스킹 타입 또는 상세 옵션 / Masking type or detailed options
19
+ * @returns 마스킹된 문자열 / The masked string
19
20
  *
20
21
  * @example
21
22
  * applyMask('930101-1234567', 'ssn') // '930101-1******'
@@ -1,26 +1,79 @@
1
1
  /**
2
- * 소수점 precision 자리로 반올림 (epsilon round).
2
+ * 소수점 precision 자리로 반올림 (epsilon round). / Round to `precision` decimal places (epsilon round).
3
+ *
3
4
  * 0.1+0.2+... 누적 오차를 최종 표시 단계에서 제거한다.
5
+ * / Removes accumulated 0.1+0.2+… floating-point error at the final display step.
6
+ *
7
+ * @param val - 반올림할 값 / Value to round
8
+ * @param precision - 소수점 자리수(기본 10) / Number of decimal places (default 10)
9
+ * @returns 반올림된 값 / The rounded value
4
10
  */
5
11
  export declare function round(val: number, precision?: number): number;
6
12
  /**
7
13
  * Kahan compensated summation — 대량 합산 시 부동소수점 오차 최소화.
14
+ * / Kahan compensated summation — minimizes floating-point error over large sums.
15
+ *
8
16
  * 시간복잡도 O(n), 공간 O(1). 빈 배열 → 0 반환.
17
+ * / Time O(n), space O(1). Empty array → returns 0.
18
+ *
19
+ * @param arr - 합산할 숫자 배열 / Numbers to sum
20
+ * @returns 보정 합계 / The compensated sum
9
21
  */
10
22
  export declare function kahanSum(arr: number[]): number;
11
23
  /**
12
- * 안전 사칙연산 — 두 수의 곱셈 스케일링으로 소수점 오차 방지.
24
+ * 안전 덧셈 — 결과를 precision 반올림해 소수점 오차 방지. / Safe addition — rounds the result to `precision` to avoid float error.
25
+ *
26
+ * @param a - 피연산자 1 / First operand
27
+ * @param b - 피연산자 2 / Second operand
28
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
29
+ * @returns 반올림된 합 / The rounded sum
13
30
  */
14
31
  export declare function safeAdd(a: number, b: number, precision?: number): number;
32
+ /**
33
+ * 안전 뺄셈 — 결과를 precision 반올림. / Safe subtraction — rounds the result to `precision`.
34
+ *
35
+ * @param a - 피연산자 1 / First operand
36
+ * @param b - 피연산자 2 / Second operand
37
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
38
+ * @returns 반올림된 차 / The rounded difference
39
+ */
15
40
  export declare function safeSub(a: number, b: number, precision?: number): number;
41
+ /**
42
+ * 안전 곱셈 — 결과를 precision 반올림. / Safe multiplication — rounds the result to `precision`.
43
+ *
44
+ * @param a - 피연산자 1 / First operand
45
+ * @param b - 피연산자 2 / Second operand
46
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
47
+ * @returns 반올림된 곱 / The rounded product
48
+ */
16
49
  export declare function safeMul(a: number, b: number, precision?: number): number;
50
+ /**
51
+ * 안전 나눗셈 — 결과를 precision 반올림. 0 나눗셈은 예외. / Safe division — rounds the result; throws on divide-by-zero.
52
+ *
53
+ * @param a - 피제수 / Dividend
54
+ * @param b - 제수(0 금지) / Divisor (must be non-zero)
55
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
56
+ * @returns 반올림된 몫 / The rounded quotient
57
+ * @throws b 가 0 이면 Error / Error when `b` is 0
58
+ */
17
59
  export declare function safeDiv(a: number, b: number, precision?: number): number;
18
60
  /**
19
- * Kahan 합산 후 precision 반올림.
20
- * SUM/AVG footer 계산에 사용.
61
+ * Kahan 합산 후 precision 반올림. / Kahan sum followed by `precision` rounding.
62
+ *
63
+ * SUM/AVG footer 계산에 사용. / Used for SUM/AVG footer computation.
64
+ *
65
+ * @param arr - 합산할 숫자 배열 / Numbers to sum
66
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
67
+ * @returns 반올림된 보정 합계 / The rounded compensated sum
21
68
  */
22
69
  export declare function kahanSumRounded(arr: number[], precision?: number): number;
23
70
  /**
24
- * Kahan AVG — 합산 후 count로 나누기.
71
+ * Kahan AVG — 합산 후 count로 나누기. / Kahan average — sum, then divide by count.
72
+ *
73
+ * 빈 배열 → 0 반환. / Empty array → returns 0.
74
+ *
75
+ * @param arr - 평균 낼 숫자 배열 / Numbers to average
76
+ * @param precision - 소수점 자리수(기본 10) / Decimal places (default 10)
77
+ * @returns 반올림된 평균 / The rounded average
25
78
  */
26
79
  export declare function kahanAvg(arr: number[], precision?: number): number;
@@ -1,35 +1,70 @@
1
1
  /**
2
- * 셀 병합 관리 엔진.
2
+ * 셀 병합 관리 엔진. / Cell-merge management engine.
3
3
  *
4
- * 두 가지 병합 방식 지원:
5
- * 1. 동적 병합: mergeCells([{row, col, rowSpan, colSpan}])
6
- * 2. 자동 병합: 같은 필드에 같은 값이 연속되면 자동으로 rowSpan
4
+ * 두 가지 병합 방식 지원 / Supports two merge modes:
5
+ * 1. 동적 병합 / Explicit merge: applyMergeCells([{row, col, rowSpan, colSpan}])
6
+ * 2. 자동 병합 / Auto merge: 같은 필드에 같은 값이 연속되면 자동으로 rowSpan
7
+ * / consecutive equal values in a field collapse into a rowSpan automatically
7
8
  */
9
+ /** 병합 대상 셀 정의(기준 셀). / A cell to merge (the anchor cell). */
8
10
  export interface MergeCell {
11
+ /** 표시 행 인덱스(0-base). / Display row index (0-based). */
9
12
  row: number;
13
+ /** 리프 컬럼 인덱스(0-base). / Leaf column index (0-based). */
10
14
  col: number;
15
+ /** 세로 병합 칸 수(1 이상, 기본 1). / Vertical span count (>=1, default 1). */
11
16
  rowSpan?: number;
17
+ /** 가로 병합 칸 수(1 이상, 기본 1). / Horizontal span count (>=1, default 1). */
12
18
  colSpan?: number;
13
19
  }
20
+ /** 특정 (row,col) 셀의 병합 결과 정보. / Resolved merge info for a specific (row,col) cell. */
14
21
  export interface MergeInfo {
22
+ /** 세로 병합 칸 수. / Vertical span count. */
15
23
  rowSpan: number;
24
+ /** 가로 병합 칸 수. / Horizontal span count. */
16
25
  colSpan: number;
26
+ /** 병합으로 숨겨진 셀(렌더링 생략). / Cell hidden by a merge (skipped in rendering). */
17
27
  hidden: boolean;
18
28
  }
29
+ /**
30
+ * 병합 맵 계산·조회를 담당하는 엔진. / Engine that computes and serves the merge map.
31
+ *
32
+ * @example
33
+ * const merge = new MergeEngine();
34
+ * merge.applyMergeCells([{ row: 0, col: 1, rowSpan: 2 }]);
35
+ * merge.getInfo(0, 1); // { rowSpan: 2, colSpan: 1, hidden: false }
36
+ */
19
37
  export declare class MergeEngine {
20
38
  private _map;
21
39
  private static _key;
22
- /** 수동 병합 정의 목록으로 맵 구성 */
40
+ /**
41
+ * 수동 병합 정의 목록으로 맵 구성. / Build the merge map from an explicit list of merge cells.
42
+ *
43
+ * 각 기준 셀은 span 을 갖고, 병합에 삼켜진 하위 셀은 `hidden:true` 로 표시된다.
44
+ * / Each anchor cell keeps its span; cells swallowed by the merge are marked `hidden:true`.
45
+ *
46
+ * @param cells - 병합할 셀 정의 목록 / List of cells to merge
47
+ */
23
48
  applyMergeCells(cells: MergeCell[]): void;
24
49
  /**
25
- * 자동 병합: 지정 컬럼 인덱스 목록에 대해 연속 같은 값을 rowSpan으로 병합.
26
- * data: 현재 표시 순서의 행 배열, colIndexes: 자동병합할 leaf 컬럼 인덱스
27
- * fields: colIndexes[i] 에 대응하는 field 이름
50
+ * 자동 병합: 지정 컬럼에서 연속 같은 값을 rowSpan 으로 병합.
51
+ * / Auto merge: collapse consecutive equal values in the given columns into rowSpans.
52
+ *
53
+ * @param data - 현재 표시 순서의 행 배열 / Rows in current display order
54
+ * @param colIndexes - 자동 병합할 leaf 컬럼 인덱스 목록 / Leaf column indexes to auto-merge
55
+ * @param fields - colIndexes[i] 에 대응하는 field 이름 / Field names matching each `colIndexes[i]`
28
56
  */
29
57
  applyAutoMerge(data: Record<string, any>[], colIndexes: number[], fields: string[]): void;
30
- /** 셀 병합 정보 조회. 없으면 null */
58
+ /**
59
+ * 셀 병합 정보 조회. / Look up merge info for a cell.
60
+ *
61
+ * @param row - 표시 행 인덱스 / Display row index
62
+ * @param col - 리프 컬럼 인덱스 / Leaf column index
63
+ * @returns 병합 정보, 없으면 null / Merge info, or null if the cell is not merged
64
+ */
31
65
  getInfo(row: number, col: number): MergeInfo | null;
32
- /** 병합 맵 초기화 */
66
+ /** 병합 맵 초기화. / Clear the merge map. */
33
67
  clear(): void;
68
+ /** 병합 맵이 비었는지 여부. / Whether the merge map is empty. */
34
69
  get isEmpty(): boolean;
35
70
  }