@ckeditor/ckeditor5-table 0.0.0-nightly-next-20260108.0 → 0.0.0-nightly-20260109.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 (274) hide show
  1. package/build/table.js +5 -0
  2. package/build/translations/af.js +1 -0
  3. package/build/translations/ar.js +1 -0
  4. package/build/translations/ast.js +1 -0
  5. package/build/translations/az.js +1 -0
  6. package/build/translations/be.js +1 -0
  7. package/build/translations/bg.js +1 -0
  8. package/build/translations/bn.js +1 -0
  9. package/build/translations/bs.js +1 -0
  10. package/build/translations/ca.js +1 -0
  11. package/build/translations/cs.js +1 -0
  12. package/build/translations/da.js +1 -0
  13. package/build/translations/de-ch.js +1 -0
  14. package/build/translations/de.js +1 -0
  15. package/build/translations/el.js +1 -0
  16. package/build/translations/en-au.js +1 -0
  17. package/build/translations/en-gb.js +1 -0
  18. package/build/translations/eo.js +1 -0
  19. package/build/translations/es-co.js +1 -0
  20. package/build/translations/es.js +1 -0
  21. package/build/translations/et.js +1 -0
  22. package/build/translations/eu.js +1 -0
  23. package/build/translations/fa.js +1 -0
  24. package/build/translations/fi.js +1 -0
  25. package/build/translations/fr.js +1 -0
  26. package/build/translations/gl.js +1 -0
  27. package/build/translations/gu.js +1 -0
  28. package/build/translations/he.js +1 -0
  29. package/build/translations/hi.js +1 -0
  30. package/build/translations/hr.js +1 -0
  31. package/build/translations/hu.js +1 -0
  32. package/build/translations/hy.js +1 -0
  33. package/build/translations/id.js +1 -0
  34. package/build/translations/it.js +1 -0
  35. package/build/translations/ja.js +1 -0
  36. package/build/translations/jv.js +1 -0
  37. package/build/translations/kk.js +1 -0
  38. package/build/translations/km.js +1 -0
  39. package/build/translations/kn.js +1 -0
  40. package/build/translations/ko.js +1 -0
  41. package/build/translations/ku.js +1 -0
  42. package/build/translations/lt.js +1 -0
  43. package/build/translations/lv.js +1 -0
  44. package/build/translations/ms.js +1 -0
  45. package/build/translations/nb.js +1 -0
  46. package/build/translations/ne.js +1 -0
  47. package/build/translations/nl.js +1 -0
  48. package/build/translations/no.js +1 -0
  49. package/build/translations/oc.js +1 -0
  50. package/build/translations/pl.js +1 -0
  51. package/build/translations/pt-br.js +1 -0
  52. package/build/translations/pt.js +1 -0
  53. package/build/translations/ro.js +1 -0
  54. package/build/translations/ru.js +1 -0
  55. package/build/translations/si.js +1 -0
  56. package/build/translations/sk.js +1 -0
  57. package/build/translations/sl.js +1 -0
  58. package/build/translations/sq.js +1 -0
  59. package/build/translations/sr-latn.js +1 -0
  60. package/build/translations/sr.js +1 -0
  61. package/build/translations/sv.js +1 -0
  62. package/build/translations/th.js +1 -0
  63. package/build/translations/ti.js +1 -0
  64. package/build/translations/tk.js +1 -0
  65. package/build/translations/tr.js +1 -0
  66. package/build/translations/tt.js +1 -0
  67. package/build/translations/ug.js +1 -0
  68. package/build/translations/uk.js +1 -0
  69. package/build/translations/ur.js +1 -0
  70. package/build/translations/uz.js +1 -0
  71. package/build/translations/vi.js +1 -0
  72. package/build/translations/zh-cn.js +1 -0
  73. package/build/translations/zh.js +1 -0
  74. package/ckeditor5-metadata.json +7 -16
  75. package/dist/index-content.css +30 -30
  76. package/dist/index-editor.css +170 -104
  77. package/dist/index.css +237 -147
  78. package/dist/index.css.map +1 -1
  79. package/dist/index.js +2433 -448
  80. package/dist/index.js.map +1 -1
  81. package/lang/contexts.json +4 -2
  82. package/package.json +35 -25
  83. package/{dist → src}/augmentation.d.ts +15 -4
  84. package/src/augmentation.js +5 -0
  85. package/{dist → src}/commands/insertcolumncommand.d.ts +1 -5
  86. package/src/commands/insertcolumncommand.js +71 -0
  87. package/{dist → src}/commands/insertrowcommand.d.ts +1 -5
  88. package/src/commands/insertrowcommand.js +70 -0
  89. package/{dist → src}/commands/inserttablecommand.d.ts +1 -5
  90. package/src/commands/inserttablecommand.js +69 -0
  91. package/{dist → src}/commands/inserttablelayoutcommand.d.ts +1 -5
  92. package/src/commands/inserttablelayoutcommand.js +65 -0
  93. package/{dist → src}/commands/mergecellcommand.d.ts +3 -7
  94. package/src/commands/mergecellcommand.js +206 -0
  95. package/{dist → src}/commands/mergecellscommand.d.ts +1 -5
  96. package/src/commands/mergecellscommand.js +94 -0
  97. package/{dist → src}/commands/removecolumncommand.d.ts +1 -5
  98. package/src/commands/removecolumncommand.js +109 -0
  99. package/{dist → src}/commands/removerowcommand.d.ts +1 -5
  100. package/src/commands/removerowcommand.js +82 -0
  101. package/{dist → src}/commands/selectcolumncommand.d.ts +1 -5
  102. package/src/commands/selectcolumncommand.js +60 -0
  103. package/{dist → src}/commands/selectrowcommand.d.ts +1 -5
  104. package/src/commands/selectrowcommand.js +56 -0
  105. package/{dist → src}/commands/setheadercolumncommand.d.ts +1 -5
  106. package/src/commands/setheadercolumncommand.js +76 -0
  107. package/{dist → src}/commands/setheaderrowcommand.d.ts +1 -5
  108. package/src/commands/setheaderrowcommand.js +83 -0
  109. package/{dist → src}/commands/splitcellcommand.d.ts +1 -5
  110. package/src/commands/splitcellcommand.js +58 -0
  111. package/{dist → src}/converters/downcast.d.ts +2 -6
  112. package/src/converters/downcast.js +298 -0
  113. package/{dist → src}/converters/table-caption-post-fixer.d.ts +1 -5
  114. package/src/converters/table-caption-post-fixer.js +55 -0
  115. package/{dist → src}/converters/table-cell-paragraph-post-fixer.d.ts +1 -5
  116. package/src/converters/table-cell-paragraph-post-fixer.js +109 -0
  117. package/{dist → src}/converters/table-cell-refresh-handler.d.ts +1 -5
  118. package/src/converters/table-cell-refresh-handler.js +47 -0
  119. package/{dist → src}/converters/table-headings-refresh-handler.d.ts +1 -5
  120. package/src/converters/table-headings-refresh-handler.js +51 -0
  121. package/{dist → src}/converters/table-layout-post-fixer.d.ts +1 -5
  122. package/src/converters/table-layout-post-fixer.js +369 -0
  123. package/{dist → src}/converters/tableproperties.d.ts +2 -6
  124. package/src/converters/tableproperties.js +444 -0
  125. package/{dist → src}/converters/upcasttable.d.ts +1 -5
  126. package/src/converters/upcasttable.js +385 -0
  127. package/{dist → src}/index.d.ts +5 -6
  128. package/src/index.js +98 -0
  129. package/{dist → src}/plaintableoutput.d.ts +1 -5
  130. package/src/plaintableoutput.js +49 -0
  131. package/{dist → src}/table.d.ts +2 -6
  132. package/src/table.js +50 -0
  133. package/{dist → src}/tablecaption/tablecaptionediting.d.ts +2 -6
  134. package/src/tablecaption/tablecaptionediting.js +136 -0
  135. package/{dist → src}/tablecaption/tablecaptionui.d.ts +1 -5
  136. package/src/tablecaption/tablecaptionui.js +64 -0
  137. package/{dist → src}/tablecaption/toggletablecaptioncommand.d.ts +1 -5
  138. package/src/tablecaption/toggletablecaptioncommand.js +105 -0
  139. package/{dist → src}/tablecaption/utils.d.ts +1 -5
  140. package/src/tablecaption/utils.js +61 -0
  141. package/{dist → src}/tablecaption.d.ts +1 -5
  142. package/src/tablecaption.js +34 -0
  143. package/{dist → src}/tablecellproperties/commands/tablecellbackgroundcolorcommand.d.ts +1 -5
  144. package/src/tablecellproperties/commands/tablecellbackgroundcolorcommand.js +30 -0
  145. package/{dist → src}/tablecellproperties/commands/tablecellbordercolorcommand.d.ts +2 -6
  146. package/src/tablecellproperties/commands/tablecellbordercolorcommand.js +44 -0
  147. package/{dist → src}/tablecellproperties/commands/tablecellborderstylecommand.d.ts +2 -6
  148. package/src/tablecellproperties/commands/tablecellborderstylecommand.js +44 -0
  149. package/{dist → src}/tablecellproperties/commands/tablecellborderwidthcommand.d.ts +2 -6
  150. package/src/tablecellproperties/commands/tablecellborderwidthcommand.js +64 -0
  151. package/{dist → src}/tablecellproperties/commands/tablecellheightcommand.d.ts +1 -5
  152. package/src/tablecellproperties/commands/tablecellheightcommand.js +51 -0
  153. package/{dist → src}/tablecellproperties/commands/tablecellhorizontalalignmentcommand.d.ts +1 -5
  154. package/src/tablecellproperties/commands/tablecellhorizontalalignmentcommand.js +30 -0
  155. package/{dist → src}/tablecellproperties/commands/tablecellpaddingcommand.d.ts +2 -6
  156. package/src/tablecellproperties/commands/tablecellpaddingcommand.js +64 -0
  157. package/{dist → src}/tablecellproperties/commands/tablecellpropertycommand.d.ts +2 -6
  158. package/src/tablecellproperties/commands/tablecellpropertycommand.js +138 -0
  159. package/{dist → src}/tablecellproperties/commands/tablecelltypecommand.d.ts +6 -6
  160. package/src/tablecellproperties/commands/tablecelltypecommand.js +167 -0
  161. package/{dist → src}/tablecellproperties/commands/tablecellverticalalignmentcommand.d.ts +1 -5
  162. package/src/tablecellproperties/commands/tablecellverticalalignmentcommand.js +38 -0
  163. package/{dist → src}/tablecellproperties/tablecellpropertiesediting.d.ts +1 -5
  164. package/src/tablecellproperties/tablecellpropertiesediting.js +412 -0
  165. package/{dist → src}/tablecellproperties/tablecellpropertiesui.d.ts +2 -6
  166. package/src/tablecellproperties/tablecellpropertiesui.js +385 -0
  167. package/src/tablecellproperties/tablecellpropertiesuiexperimental.d.ts +128 -0
  168. package/src/tablecellproperties/tablecellpropertiesuiexperimental.js +408 -0
  169. package/src/tablecellproperties/ui/tablecellpropertiesview.d.ts +229 -0
  170. package/src/tablecellproperties/ui/tablecellpropertiesview.js +612 -0
  171. package/{dist/tablecellproperties/ui/tablecellpropertiesview.d.ts → src/tablecellproperties/ui/tablecellpropertiesviewexperimental.d.ts} +12 -15
  172. package/src/tablecellproperties/ui/tablecellpropertiesviewexperimental.js +744 -0
  173. package/{dist → src}/tablecellproperties.d.ts +1 -5
  174. package/src/tablecellproperties.js +40 -0
  175. package/{dist → src}/tablecellwidth/commands/tablecellwidthcommand.d.ts +1 -5
  176. package/src/tablecellwidth/commands/tablecellwidthcommand.js +51 -0
  177. package/{dist → src}/tablecellwidth/tablecellwidthediting.d.ts +1 -5
  178. package/src/tablecellwidth/tablecellwidthediting.js +53 -0
  179. package/{dist → src}/tableclipboard.d.ts +3 -7
  180. package/src/tableclipboard.js +500 -0
  181. package/{dist → src}/tablecolumnresize/constants.d.ts +0 -4
  182. package/src/tablecolumnresize/constants.js +33 -0
  183. package/{dist → src}/tablecolumnresize/converters.d.ts +1 -5
  184. package/src/tablecolumnresize/converters.js +62 -0
  185. package/{dist → src}/tablecolumnresize/tablecolumnresizeediting.d.ts +2 -6
  186. package/src/tablecolumnresize/tablecolumnresizeediting.js +729 -0
  187. package/{dist → src}/tablecolumnresize/tablewidthscommand.d.ts +2 -6
  188. package/src/tablecolumnresize/tablewidthscommand.js +61 -0
  189. package/{dist → src}/tablecolumnresize/utils.d.ts +2 -6
  190. package/src/tablecolumnresize/utils.js +370 -0
  191. package/{dist → src}/tablecolumnresize.d.ts +1 -5
  192. package/src/tablecolumnresize.js +36 -0
  193. package/{dist → src}/tableconfig.d.ts +6 -30
  194. package/src/tableconfig.js +5 -0
  195. package/{dist → src}/tableediting.d.ts +2 -6
  196. package/src/tableediting.js +246 -0
  197. package/{dist → src}/tablekeyboard.d.ts +3 -7
  198. package/src/tablekeyboard.js +273 -0
  199. package/{dist → src}/tablelayout/commands/tabletypecommand.d.ts +1 -5
  200. package/src/tablelayout/commands/tabletypecommand.js +68 -0
  201. package/{dist → src}/tablelayout/tablelayoutediting.d.ts +1 -5
  202. package/src/tablelayout/tablelayoutediting.js +295 -0
  203. package/{dist → src}/tablelayout/tablelayoutui.d.ts +1 -5
  204. package/src/tablelayout/tablelayoutui.js +196 -0
  205. package/{dist → src}/tablelayout.d.ts +1 -5
  206. package/src/tablelayout.js +37 -0
  207. package/{dist → src}/tablemouse/mouseeventsobserver.d.ts +1 -5
  208. package/src/tablemouse/mouseeventsobserver.js +34 -0
  209. package/{dist → src}/tablemouse.d.ts +1 -5
  210. package/src/tablemouse.js +178 -0
  211. package/{dist → src}/tableproperties/commands/tablealignmentcommand.d.ts +1 -5
  212. package/src/tableproperties/commands/tablealignmentcommand.js +30 -0
  213. package/{dist → src}/tableproperties/commands/tablebackgroundcolorcommand.d.ts +1 -5
  214. package/src/tableproperties/commands/tablebackgroundcolorcommand.js +30 -0
  215. package/{dist → src}/tableproperties/commands/tablebordercolorcommand.d.ts +2 -6
  216. package/src/tableproperties/commands/tablebordercolorcommand.js +44 -0
  217. package/{dist → src}/tableproperties/commands/tableborderstylecommand.d.ts +2 -6
  218. package/src/tableproperties/commands/tableborderstylecommand.js +44 -0
  219. package/{dist → src}/tableproperties/commands/tableborderwidthcommand.d.ts +2 -6
  220. package/src/tableproperties/commands/tableborderwidthcommand.js +64 -0
  221. package/{dist → src}/tableproperties/commands/tableheightcommand.d.ts +1 -5
  222. package/src/tableproperties/commands/tableheightcommand.js +54 -0
  223. package/{dist → src}/tableproperties/commands/tablepropertycommand.d.ts +2 -6
  224. package/src/tableproperties/commands/tablepropertycommand.js +103 -0
  225. package/{dist → src}/tableproperties/commands/tablewidthcommand.d.ts +1 -5
  226. package/src/tableproperties/commands/tablewidthcommand.js +54 -0
  227. package/{dist → src}/tableproperties/tablepropertiesediting.d.ts +1 -5
  228. package/src/tableproperties/tablepropertiesediting.js +546 -0
  229. package/{dist → src}/tableproperties/tablepropertiesui.d.ts +2 -6
  230. package/src/tableproperties/tablepropertiesui.js +374 -0
  231. package/src/tableproperties/tablepropertiesuiexperimental.d.ts +136 -0
  232. package/src/tableproperties/tablepropertiesuiexperimental.js +375 -0
  233. package/{dist → src}/tableproperties/ui/tablepropertiesview.d.ts +2 -14
  234. package/src/tableproperties/ui/tablepropertiesview.js +520 -0
  235. package/src/tableproperties/ui/tablepropertiesviewexperimental.d.ts +216 -0
  236. package/src/tableproperties/ui/tablepropertiesviewexperimental.js +544 -0
  237. package/{dist → src}/tableproperties.d.ts +1 -5
  238. package/src/tableproperties.js +40 -0
  239. package/{dist → src}/tableselection.d.ts +2 -6
  240. package/src/tableselection.js +323 -0
  241. package/{dist → src}/tabletoolbar.d.ts +2 -6
  242. package/src/tabletoolbar.js +63 -0
  243. package/{dist → src}/tableui.d.ts +1 -5
  244. package/src/tableui.js +335 -0
  245. package/{dist → src}/tableutils.d.ts +2 -6
  246. package/src/tableutils.js +1282 -0
  247. package/{dist → src}/tablewalker.d.ts +1 -5
  248. package/src/tablewalker.js +489 -0
  249. package/{dist → src}/ui/colorinputview.d.ts +2 -6
  250. package/src/ui/colorinputview.js +305 -0
  251. package/{dist → src}/ui/inserttableview.d.ts +2 -6
  252. package/src/ui/inserttableview.js +192 -0
  253. package/{dist → src}/utils/common.d.ts +2 -6
  254. package/src/utils/common.js +118 -0
  255. package/{dist → src}/utils/structure.d.ts +1 -5
  256. package/src/utils/structure.js +452 -0
  257. package/{dist → src}/utils/table-properties.d.ts +1 -5
  258. package/src/utils/table-properties.js +121 -0
  259. package/{dist → src}/utils/ui/contextualballoon.d.ts +2 -6
  260. package/src/utils/ui/contextualballoon.js +111 -0
  261. package/{dist → src}/utils/ui/table-properties.d.ts +2 -6
  262. package/src/utils/ui/table-properties.js +390 -0
  263. package/src/utils/ui/table-propertiesexperimental.d.ts +215 -0
  264. package/src/utils/ui/table-propertiesexperimental.js +391 -0
  265. package/{dist → src}/utils/ui/widget.d.ts +1 -5
  266. package/src/utils/ui/widget.js +56 -0
  267. package/theme/formrow-experimental.css +15 -0
  268. package/theme/formrow.css +0 -2
  269. package/theme/tablecellproperties-experimental.css +4 -0
  270. package/theme/tableform-experimental.css +61 -0
  271. package/theme/tableform.css +5 -1
  272. package/theme/tableproperties-experimental.css +78 -0
  273. package/theme/tableproperties.css +0 -60
  274. package/dist/tablecellproperties/tablecellpropertiesutils.d.ts +0 -22
@@ -0,0 +1,452 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
+ import { TableWalker } from '../tablewalker.js';
6
+ import { createEmptyTableCell, updateNumericAttribute } from './common.js';
7
+ /**
8
+ * Returns a cropped table according to given dimensions.
9
+
10
+ * To return a cropped table that starts at first row and first column and end in third row and column:
11
+ *
12
+ * ```ts
13
+ * const croppedTable = cropTableToDimensions( table, {
14
+ * startRow: 1,
15
+ * endRow: 3,
16
+ * startColumn: 1,
17
+ * endColumn: 3
18
+ * }, writer );
19
+ * ```
20
+ *
21
+ * Calling the code above for the table below:
22
+ *
23
+ * 0 1 2 3 4 0 1 2
24
+ * ┌───┬───┬───┬───┬───┐
25
+ * 0 │ a │ b │ c │ d │ e │
26
+ * ├───┴───┤ ├───┴───┤ ┌───┬───┬───┐
27
+ * 1 │ f │ │ g │ │ │ │ g │ 0
28
+ * ├───┬───┴───┼───┬───┤ will return: ├───┴───┼───┤
29
+ * 2 │ h │ i │ j │ k │ │ i │ j │ 1
30
+ * ├───┤ ├───┤ │ │ ├───┤
31
+ * 3 │ l │ │ m │ │ │ │ m │ 2
32
+ * ├───┼───┬───┤ ├───┤ └───────┴───┘
33
+ * 4 │ n │ o │ p │ │ q │
34
+ * └───┴───┴───┴───┴───┘
35
+ *
36
+ * @internal
37
+ */
38
+ export function cropTableToDimensions(sourceTable, cropDimensions, writer) {
39
+ const { startRow, startColumn, endRow, endColumn } = cropDimensions;
40
+ // Initialize the cropped table element.
41
+ const croppedTable = writer.createElement('table');
42
+ // Copy table type attribute if present.
43
+ const sourceTableType = sourceTable.getAttribute('tableType');
44
+ if (sourceTableType) {
45
+ writer.setAttribute('tableType', sourceTableType, croppedTable);
46
+ }
47
+ // Create empty table with empty rows equal to crop height.
48
+ const cropHeight = endRow - startRow + 1;
49
+ for (let i = 0; i < cropHeight; i++) {
50
+ writer.insertElement('tableRow', croppedTable, 'end');
51
+ }
52
+ const tableMap = [...new TableWalker(sourceTable, { startRow, endRow, startColumn, endColumn, includeAllSlots: true })];
53
+ // Iterate over source table slots (including empty - spanned - ones).
54
+ for (const { row: sourceRow, column: sourceColumn, cell: tableCell, isAnchor, cellAnchorRow, cellAnchorColumn } of tableMap) {
55
+ // Row index in cropped table.
56
+ const rowInCroppedTable = sourceRow - startRow;
57
+ const row = croppedTable.getChild(rowInCroppedTable);
58
+ // For empty slots: fill the gap with empty table cell.
59
+ if (!isAnchor) {
60
+ // But fill the gap only if the spanning cell is anchored outside cropped area.
61
+ // In the table from method jsdoc those cells are: "c" & "f".
62
+ if (cellAnchorRow < startRow || cellAnchorColumn < startColumn) {
63
+ createEmptyTableCell(writer, writer.createPositionAt(row, 'end'));
64
+ }
65
+ }
66
+ // Otherwise clone the cell with all children and trim if it exceeds cropped area.
67
+ else {
68
+ const tableCellCopy = writer.cloneElement(tableCell);
69
+ writer.append(tableCellCopy, row);
70
+ // Trim table if it exceeds cropped area.
71
+ // In the table from method jsdoc those cells are: "g" & "m".
72
+ trimTableCellIfNeeded(tableCellCopy, sourceRow, sourceColumn, endRow, endColumn, writer);
73
+ }
74
+ }
75
+ // Adjust heading rows & columns in cropped table if crop selection includes headings parts.
76
+ addHeadingsToCroppedTable(croppedTable, sourceTable, startRow, startColumn, writer);
77
+ return croppedTable;
78
+ }
79
+ /**
80
+ * Returns slot info of cells that starts above and overlaps a given row.
81
+ *
82
+ * In a table below, passing `overlapRow = 3`
83
+ *
84
+ * ┌───┬───┬───┬───┬───┐
85
+ * 0 │ a │ b │ c │ d │ e │
86
+ * │ ├───┼───┼───┼───┤
87
+ * 1 │ │ f │ g │ h │ i │
88
+ * ├───┤ ├───┼───┤ │
89
+ * 2 │ j │ │ k │ l │ │
90
+ * │ │ │ ├───┼───┤
91
+ * 3 │ │ │ │ m │ n │ <- overlap row to check
92
+ * ├───┼───┤ │ ├───│
93
+ * 4 │ o │ p │ │ │ q │
94
+ * └───┴───┴───┴───┴───┘
95
+ *
96
+ * will return slot info for cells: "j", "f", "k".
97
+ *
98
+ * @internal
99
+ * @param table The table to check.
100
+ * @param overlapRow The index of the row to check.
101
+ * @param startRow row to start analysis. Use it when it is known that the cells above that row will not overlap. Default value is 0.
102
+ */
103
+ export function getVerticallyOverlappingCells(table, overlapRow, startRow = 0) {
104
+ const cells = [];
105
+ const tableWalker = new TableWalker(table, { startRow, endRow: overlapRow - 1 });
106
+ for (const slotInfo of tableWalker) {
107
+ const { row, cellHeight } = slotInfo;
108
+ const cellEndRow = row + cellHeight - 1;
109
+ if (row < overlapRow && overlapRow <= cellEndRow) {
110
+ cells.push(slotInfo);
111
+ }
112
+ }
113
+ return cells;
114
+ }
115
+ /**
116
+ * Splits the table cell horizontally.
117
+ *
118
+ * @internal
119
+ * @returns Created table cell, if any were created.
120
+ */
121
+ export function splitHorizontally(tableCell, splitRow, writer) {
122
+ const tableRow = tableCell.parent;
123
+ const table = tableRow.parent;
124
+ const rowIndex = tableRow.index;
125
+ const rowspan = parseInt(tableCell.getAttribute('rowspan'));
126
+ const newRowspan = splitRow - rowIndex;
127
+ const newCellAttributes = {};
128
+ const newCellRowSpan = rowspan - newRowspan;
129
+ if (newCellRowSpan > 1) {
130
+ newCellAttributes.rowspan = newCellRowSpan;
131
+ }
132
+ const colspan = parseInt(tableCell.getAttribute('colspan') || '1');
133
+ if (colspan > 1) {
134
+ newCellAttributes.colspan = colspan;
135
+ }
136
+ const startRow = rowIndex;
137
+ const endRow = startRow + newRowspan;
138
+ const tableMap = [...new TableWalker(table, { startRow, endRow, includeAllSlots: true })];
139
+ let newCell = null;
140
+ let columnIndex;
141
+ for (const tableSlot of tableMap) {
142
+ const { row, column, cell } = tableSlot;
143
+ if (cell === tableCell && columnIndex === undefined) {
144
+ columnIndex = column;
145
+ }
146
+ if (columnIndex !== undefined && columnIndex === column && row === endRow) {
147
+ newCell = createEmptyTableCell(writer, tableSlot.getPositionBefore(), newCellAttributes);
148
+ }
149
+ }
150
+ // Update the rowspan attribute after updating table.
151
+ updateNumericAttribute('rowspan', newRowspan, tableCell, writer);
152
+ return newCell;
153
+ }
154
+ /**
155
+ * Returns slot info of cells that starts before and overlaps a given column.
156
+ *
157
+ * In a table below, passing `overlapColumn = 3`
158
+ *
159
+ * 0 1 2 3 4
160
+ * ┌───────┬───────┬───┐
161
+ * │ a │ b │ c │
162
+ * │───┬───┴───────┼───┤
163
+ * │ d │ e │ f │
164
+ * ├───┼───┬───────┴───┤
165
+ * │ g │ h │ i │
166
+ * ├───┼───┼───┬───────┤
167
+ * │ j │ k │ l │ m │
168
+ * ├───┼───┴───┼───┬───┤
169
+ * │ n │ o │ p │ q │
170
+ * └───┴───────┴───┴───┘
171
+ * ^
172
+ * Overlap column to check
173
+ *
174
+ * will return slot info for cells: "b", "e", "i".
175
+ *
176
+ * @internal
177
+ * @param table The table to check.
178
+ * @param overlapColumn The index of the column to check.
179
+ */
180
+ export function getHorizontallyOverlappingCells(table, overlapColumn) {
181
+ const cellsToSplit = [];
182
+ const tableWalker = new TableWalker(table);
183
+ for (const slotInfo of tableWalker) {
184
+ const { column, cellWidth } = slotInfo;
185
+ const cellEndColumn = column + cellWidth - 1;
186
+ if (column < overlapColumn && overlapColumn <= cellEndColumn) {
187
+ cellsToSplit.push(slotInfo);
188
+ }
189
+ }
190
+ return cellsToSplit;
191
+ }
192
+ /**
193
+ * Splits the table cell vertically.
194
+ *
195
+ * @internal
196
+ * @param columnIndex The table cell column index.
197
+ * @param splitColumn The index of column to split cell on.
198
+ * @returns Created table cell.
199
+ */
200
+ export function splitVertically(tableCell, columnIndex, splitColumn, writer) {
201
+ const colspan = parseInt(tableCell.getAttribute('colspan'));
202
+ const newColspan = splitColumn - columnIndex;
203
+ const newCellAttributes = {};
204
+ const newCellColSpan = colspan - newColspan;
205
+ if (newCellColSpan > 1) {
206
+ newCellAttributes.colspan = newCellColSpan;
207
+ }
208
+ const rowspan = parseInt(tableCell.getAttribute('rowspan') || '1');
209
+ if (rowspan > 1) {
210
+ newCellAttributes.rowspan = rowspan;
211
+ }
212
+ const newCell = createEmptyTableCell(writer, writer.createPositionAfter(tableCell), newCellAttributes);
213
+ // Update the colspan attribute after updating table.
214
+ updateNumericAttribute('colspan', newColspan, tableCell, writer);
215
+ return newCell;
216
+ }
217
+ /**
218
+ * Adjusts table cell dimensions to not exceed limit row and column.
219
+ *
220
+ * If table cell width (or height) covers a column (or row) that is after a limit column (or row)
221
+ * this method will trim "colspan" (or "rowspan") attribute so the table cell will fit in a defined limits.
222
+ *
223
+ * @internal
224
+ */
225
+ export function trimTableCellIfNeeded(tableCell, cellRow, cellColumn, limitRow, limitColumn, writer) {
226
+ const colspan = parseInt(tableCell.getAttribute('colspan') || '1');
227
+ const rowspan = parseInt(tableCell.getAttribute('rowspan') || '1');
228
+ const endColumn = cellColumn + colspan - 1;
229
+ if (endColumn > limitColumn) {
230
+ const trimmedSpan = limitColumn - cellColumn + 1;
231
+ updateNumericAttribute('colspan', trimmedSpan, tableCell, writer, 1);
232
+ }
233
+ const endRow = cellRow + rowspan - 1;
234
+ if (endRow > limitRow) {
235
+ const trimmedSpan = limitRow - cellRow + 1;
236
+ updateNumericAttribute('rowspan', trimmedSpan, tableCell, writer, 1);
237
+ }
238
+ }
239
+ /**
240
+ * Sets proper heading attributes to a cropped table.
241
+ */
242
+ function addHeadingsToCroppedTable(croppedTable, sourceTable, startRow, startColumn, writer) {
243
+ const headingRows = parseInt(sourceTable.getAttribute('headingRows') || '0');
244
+ if (headingRows > 0) {
245
+ const headingRowsInCrop = headingRows - startRow;
246
+ updateNumericAttribute('headingRows', headingRowsInCrop, croppedTable, writer, 0);
247
+ }
248
+ const headingColumns = parseInt(sourceTable.getAttribute('headingColumns') || '0');
249
+ if (headingColumns > 0) {
250
+ const headingColumnsInCrop = headingColumns - startColumn;
251
+ updateNumericAttribute('headingColumns', headingColumnsInCrop, croppedTable, writer, 0);
252
+ }
253
+ }
254
+ /**
255
+ * Removes columns that have no cells anchored.
256
+ *
257
+ * In table below:
258
+ *
259
+ * +----+----+----+----+----+----+----+
260
+ * | 00 | 01 | 03 | 04 | 06 |
261
+ * +----+----+----+----+ +----+
262
+ * | 10 | 11 | 13 | | 16 |
263
+ * +----+----+----+----+----+----+----+
264
+ * | 20 | 21 | 23 | 24 | 26 |
265
+ * +----+----+----+----+----+----+----+
266
+ * ^--- empty ---^
267
+ *
268
+ * Will remove columns 2 and 5.
269
+ *
270
+ * **Note:** This is a low-level helper method for clearing invalid model state when doing table modifications.
271
+ * To remove a column from a table use {@link module:table/tableutils~TableUtils#removeColumns `TableUtils.removeColumns()`}.
272
+ *
273
+ * @internal
274
+ * @returns True if removed some columns.
275
+ */
276
+ export function removeEmptyColumns(table, tableUtils) {
277
+ const width = tableUtils.getColumns(table);
278
+ const columnsMap = new Array(width).fill(0);
279
+ for (const { column } of new TableWalker(table)) {
280
+ columnsMap[column]++;
281
+ }
282
+ const emptyColumns = columnsMap.reduce((result, cellsCount, column) => {
283
+ return cellsCount ? result : [...result, column];
284
+ }, []);
285
+ if (emptyColumns.length > 0) {
286
+ // Remove only last empty column because it will recurrently trigger removing empty rows.
287
+ const emptyColumn = emptyColumns[emptyColumns.length - 1];
288
+ // @if CK_DEBUG_TABLE // console.log( `Removing empty column: ${ emptyColumn }.` );
289
+ tableUtils.removeColumns(table, { at: emptyColumn });
290
+ return true;
291
+ }
292
+ return false;
293
+ }
294
+ /**
295
+ * Removes rows that have no cells anchored.
296
+ *
297
+ * In table below:
298
+ *
299
+ * +----+----+----+
300
+ * | 00 | 01 | 02 |
301
+ * +----+----+----+
302
+ * | 10 | 11 | 12 |
303
+ * + + + +
304
+ * | | | | <-- empty
305
+ * +----+----+----+
306
+ * | 30 | 31 | 32 |
307
+ * +----+----+----+
308
+ * | 40 | 42 |
309
+ * + + +
310
+ * | | | <-- empty
311
+ * +----+----+----+
312
+ * | 60 | 61 | 62 |
313
+ * +----+----+----+
314
+ *
315
+ * Will remove rows 2 and 5.
316
+ *
317
+ * **Note:** This is a low-level helper method for clearing invalid model state when doing table modifications.
318
+ * To remove a row from a table use {@link module:table/tableutils~TableUtils#removeRows `TableUtils.removeRows()`}.
319
+ *
320
+ * @internal
321
+ * @returns True if removed some rows.
322
+ */
323
+ export function removeEmptyRows(table, tableUtils) {
324
+ const emptyRows = [];
325
+ const tableRowCount = tableUtils.getRows(table);
326
+ for (let rowIndex = 0; rowIndex < tableRowCount; rowIndex++) {
327
+ const tableRow = table.getChild(rowIndex);
328
+ if (tableRow.isEmpty) {
329
+ emptyRows.push(rowIndex);
330
+ }
331
+ }
332
+ if (emptyRows.length > 0) {
333
+ // Remove only last empty row because it will recurrently trigger removing empty columns.
334
+ const emptyRow = emptyRows[emptyRows.length - 1];
335
+ // @if CK_DEBUG_TABLE // console.log( `Removing empty row: ${ emptyRow }.` );
336
+ tableUtils.removeRows(table, { at: emptyRow });
337
+ return true;
338
+ }
339
+ return false;
340
+ }
341
+ /**
342
+ * Removes rows and columns that have no cells anchored.
343
+ *
344
+ * In table below:
345
+ *
346
+ * +----+----+----+----+
347
+ * | 00 | 02 |
348
+ * +----+----+ +
349
+ * | 10 | |
350
+ * +----+----+----+----+
351
+ * | 20 | 22 | 23 |
352
+ * + + + +
353
+ * | | | | <-- empty row
354
+ * +----+----+----+----+
355
+ * ^--- empty column
356
+ *
357
+ * Will remove row 3 and column 1.
358
+ *
359
+ * **Note:** This is a low-level helper method for clearing invalid model state when doing table modifications.
360
+ * To remove a rows from a table use {@link module:table/tableutils~TableUtils#removeRows `TableUtils.removeRows()`} and
361
+ * {@link module:table/tableutils~TableUtils#removeColumns `TableUtils.removeColumns()`} to remove a column.
362
+ *
363
+ * @internal
364
+ */
365
+ export function removeEmptyRowsColumns(table, tableUtils) {
366
+ const removedColumns = removeEmptyColumns(table, tableUtils);
367
+ // If there was some columns removed then cleaning empty rows was already triggered.
368
+ if (!removedColumns) {
369
+ removeEmptyRows(table, tableUtils);
370
+ }
371
+ }
372
+ /**
373
+ * Returns adjusted last row index if selection covers part of a row with empty slots (spanned by other cells).
374
+ * The `dimensions.lastRow` is equal to last row index but selection might be bigger.
375
+ *
376
+ * This happens *only* on rectangular selection so we analyze a case like this:
377
+ *
378
+ * +---+---+---+---+
379
+ * 0 | a | b | c | d |
380
+ * + + +---+---+
381
+ * 1 | | e | f | g |
382
+ * + +---+ +---+
383
+ * 2 | | h | | i | <- last row, each cell has rowspan = 2,
384
+ * + + + + + so we need to return 3, not 2
385
+ * 3 | | | | |
386
+ * +---+---+---+---+
387
+ *
388
+ * @internal
389
+ * @returns Adjusted last row index.
390
+ */
391
+ export function adjustLastRowIndex(table, dimensions) {
392
+ const lastRowMap = Array.from(new TableWalker(table, {
393
+ startColumn: dimensions.firstColumn,
394
+ endColumn: dimensions.lastColumn,
395
+ row: dimensions.lastRow
396
+ }));
397
+ const everyCellHasSingleRowspan = lastRowMap.every(({ cellHeight }) => cellHeight === 1);
398
+ // It is a "flat" row, so the last row index is OK.
399
+ if (everyCellHasSingleRowspan) {
400
+ return dimensions.lastRow;
401
+ }
402
+ // Otherwise get any cell's rowspan and adjust the last row index.
403
+ const rowspanAdjustment = lastRowMap[0].cellHeight - 1;
404
+ return dimensions.lastRow + rowspanAdjustment;
405
+ }
406
+ /**
407
+ * Returns adjusted last column index if selection covers part of a column with empty slots (spanned by other cells).
408
+ * The `dimensions.lastColumn` is equal to last column index but selection might be bigger.
409
+ *
410
+ * This happens *only* on rectangular selection so we analyze a case like this:
411
+ *
412
+ * 0 1 2 3
413
+ * +---+---+---+---+
414
+ * | a |
415
+ * +---+---+---+---+
416
+ * | b | c | d |
417
+ * +---+---+---+---+
418
+ * | e | f |
419
+ * +---+---+---+---+
420
+ * | g | h |
421
+ * +---+---+---+---+
422
+ * ^
423
+ * last column, each cell has colspan = 2, so we need to return 3, not 2
424
+ *
425
+ * @internal
426
+ * @returns Adjusted last column index.
427
+ */
428
+ export function adjustLastColumnIndex(table, dimensions) {
429
+ const lastColumnMap = Array.from(new TableWalker(table, {
430
+ startRow: dimensions.firstRow,
431
+ endRow: dimensions.lastRow,
432
+ column: dimensions.lastColumn
433
+ }));
434
+ const everyCellHasSingleColspan = lastColumnMap.every(({ cellWidth }) => cellWidth === 1);
435
+ // It is a "flat" column, so the last column index is OK.
436
+ if (everyCellHasSingleColspan) {
437
+ return dimensions.lastColumn;
438
+ }
439
+ // Otherwise get any cell's colspan and adjust the last column index.
440
+ const colspanAdjustment = lastColumnMap[0].cellWidth - 1;
441
+ return dimensions.lastColumn + colspanAdjustment;
442
+ }
443
+ /**
444
+ * Get view `<table>` element from the wrapper.
445
+ */
446
+ export function getViewTableFromWrapper(wrapperView) {
447
+ for (const wrapperChild of wrapperView.getChildren()) {
448
+ if (wrapperChild.is('element', 'table')) {
449
+ return wrapperChild;
450
+ }
451
+ }
452
+ }
@@ -1,7 +1,3 @@
1
- /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
5
1
  /**
6
2
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
7
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
@@ -9,7 +5,7 @@
9
5
  /**
10
6
  * @module table/utils/table-properties
11
7
  */
12
- import type { BoxStyleSides } from '@ckeditor/ckeditor5-engine';
8
+ import type { BoxStyleSides } from 'ckeditor5/src/engine.js';
13
9
  /**
14
10
  * Returns a string if all four values of box sides are equal.
15
11
  *
@@ -0,0 +1,121 @@
1
+ /**
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
+ import { isObject } from 'es-toolkit/compat';
6
+ /**
7
+ * Returns a string if all four values of box sides are equal.
8
+ *
9
+ * If a string is passed, it is treated as a single value (pass-through).
10
+ *
11
+ * ```ts
12
+ * // Returns 'foo':
13
+ * getSingleValue( { top: 'foo', right: 'foo', bottom: 'foo', left: 'foo' } );
14
+ * getSingleValue( 'foo' );
15
+ *
16
+ * // Returns undefined:
17
+ * getSingleValue( { top: 'foo', right: 'foo', bottom: 'bar', left: 'foo' } );
18
+ * getSingleValue( { top: 'foo', right: 'foo' } );
19
+ * ```
20
+ *
21
+ * @internal
22
+ */
23
+ export function getSingleValue(objectOrString) {
24
+ if (!objectOrString || !isObject(objectOrString)) {
25
+ return objectOrString;
26
+ }
27
+ const { top, right, bottom, left } = objectOrString;
28
+ if (top == right && right == bottom && bottom == left) {
29
+ return top;
30
+ }
31
+ }
32
+ /**
33
+ * Adds a unit to a value if the value is a number or a string representing a number.
34
+ *
35
+ * **Note**: It does nothing to non-numeric values.
36
+ *
37
+ * ```ts
38
+ * getSingleValue( 25, 'px' ); // '25px'
39
+ * getSingleValue( 25, 'em' ); // '25em'
40
+ * getSingleValue( '25em', 'px' ); // '25em'
41
+ * getSingleValue( 'foo', 'px' ); // 'foo'
42
+ * ```
43
+ *
44
+ * @internal
45
+ * @param defaultUnit A default unit added to a numeric value.
46
+ */
47
+ export function addDefaultUnitToNumericValue(value, defaultUnit) {
48
+ const numericValue = parseFloat(value);
49
+ if (Number.isNaN(numericValue)) {
50
+ return value;
51
+ }
52
+ if (String(numericValue) !== String(value)) {
53
+ return value;
54
+ }
55
+ return `${numericValue}${defaultUnit}`;
56
+ }
57
+ /**
58
+ * Returns the normalized configuration.
59
+ *
60
+ * @internal
61
+ * @param config The configuration to normalize.
62
+ * @param options Options used to determine which properties should be added.
63
+ */
64
+ export function getNormalizedDefaultProperties(config, options = {}) {
65
+ const normalizedConfig = {
66
+ borderStyle: 'none',
67
+ borderWidth: '',
68
+ borderColor: '',
69
+ backgroundColor: '',
70
+ width: '',
71
+ height: '',
72
+ ...config
73
+ };
74
+ if (options.includeAlignmentProperty && !normalizedConfig.alignment) {
75
+ normalizedConfig.alignment = 'center';
76
+ }
77
+ if (options.includePaddingProperty && !normalizedConfig.padding) {
78
+ normalizedConfig.padding = '';
79
+ }
80
+ if (options.includeVerticalAlignmentProperty && !normalizedConfig.verticalAlignment) {
81
+ normalizedConfig.verticalAlignment = 'middle';
82
+ }
83
+ if (options.includeHorizontalAlignmentProperty && !normalizedConfig.horizontalAlignment) {
84
+ normalizedConfig.horizontalAlignment = options.isRightToLeftContent ? 'right' : 'left';
85
+ }
86
+ return normalizedConfig;
87
+ }
88
+ /**
89
+ * Returns the normalized default table properties.
90
+ *
91
+ * @internal
92
+ * @param config The configuration to normalize.
93
+ * @param options Options used to determine which properties should be added.
94
+ */
95
+ export function getNormalizedDefaultTableProperties(config, options) {
96
+ return getNormalizedDefaultProperties({
97
+ // It adds support for border none in the table element, keep it in sync with the content styles
98
+ // See more: https://github.com/ckeditor/ckeditor5/issues/6841#issuecomment-1959195608
99
+ borderStyle: 'double',
100
+ borderColor: 'hsl(0, 0%, 70%)',
101
+ borderWidth: '1px',
102
+ ...config
103
+ }, options);
104
+ }
105
+ /**
106
+ * Returns the normalized default cell properties.
107
+ *
108
+ * @internal
109
+ * @param config The configuration to normalize.
110
+ * @param options Options used to determine which properties should be added.
111
+ */
112
+ export function getNormalizedDefaultCellProperties(config, options) {
113
+ return getNormalizedDefaultProperties({
114
+ // It adds support for border none in the table element, keep it in sync with the content styles
115
+ // See more: https://github.com/ckeditor/ckeditor5/issues/6841#issuecomment-1959195608
116
+ borderStyle: 'solid',
117
+ borderColor: 'hsl(0, 0%, 75%)',
118
+ borderWidth: '1px',
119
+ ...config
120
+ }, options);
121
+ }
@@ -1,7 +1,3 @@
1
- /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
5
1
  /**
6
2
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
7
3
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
@@ -9,8 +5,8 @@
9
5
  /**
10
6
  * @module table/utils/ui/contextualballoon
11
7
  */
12
- import { type DomOptimalPositionOptions } from '@ckeditor/ckeditor5-utils';
13
- import type { Editor } from '@ckeditor/ckeditor5-core';
8
+ import { type DomOptimalPositionOptions } from 'ckeditor5/src/utils.js';
9
+ import type { Editor } from 'ckeditor5/src/core.js';
14
10
  /**
15
11
  * A helper utility that positions the
16
12
  * {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon} instance