@viewkitjs/views 0.1.0 → 0.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 (390) hide show
  1. package/CHANGELOG.md +767 -1
  2. package/README.md +92 -41
  3. package/dist/atoms/LoadMore.js +11 -1
  4. package/dist/atoms/Row.js +1 -1
  5. package/dist/atoms/RowMenu.d.ts +1 -1
  6. package/dist/atoms/RowMenu.js +20 -6
  7. package/dist/atoms/types.d.ts +4 -4
  8. package/dist/cells/cell-format.d.ts +3 -3
  9. package/dist/cells/cell-title.d.ts +1 -2
  10. package/dist/cells/cell-title.js +2 -2
  11. package/dist/cells/cell-values.js +6 -3
  12. package/dist/contract.d.ts +79 -8
  13. package/dist/contract.js +55 -8
  14. package/dist/display/converted.d.ts +19 -0
  15. package/dist/display/converted.js +12 -0
  16. package/dist/display/format.d.ts +16 -1
  17. package/dist/display/format.js +10 -1
  18. package/dist/display/index.d.ts +2 -1
  19. package/dist/display/index.js +2 -1
  20. package/dist/display/link-click.d.ts +11 -0
  21. package/dist/display/link-click.js +3 -0
  22. package/dist/display/link.js +12 -6
  23. package/dist/display/location.d.ts +4 -3
  24. package/dist/display/location.js +12 -5
  25. package/dist/display/multi-value.d.ts +1 -1
  26. package/dist/display/multi-value.js +1 -1
  27. package/dist/display/options.d.ts +8 -2
  28. package/dist/display/percent.js +10 -3
  29. package/dist/display/phone.d.ts +2 -1
  30. package/dist/display/phone.js +11 -2
  31. package/dist/display/relation.js +1 -1
  32. package/dist/editors/ChipsEditor.d.ts +9 -4
  33. package/dist/editors/ChipsEditor.js +7 -3
  34. package/dist/editors/DateEditor.d.ts +21 -6
  35. package/dist/editors/DateEditor.js +118 -30
  36. package/dist/editors/EditorPanel.d.ts +61 -0
  37. package/dist/editors/EditorPanel.js +54 -0
  38. package/dist/editors/LocationEditor.d.ts +3 -0
  39. package/dist/editors/LocationEditor.js +28 -21
  40. package/dist/editors/NameEditor.d.ts +3 -0
  41. package/dist/editors/NameEditor.js +15 -10
  42. package/dist/editors/NumberEditor.d.ts +3 -0
  43. package/dist/editors/NumberEditor.js +7 -7
  44. package/dist/editors/RangeEditor.d.ts +16 -1
  45. package/dist/editors/RangeEditor.js +22 -6
  46. package/dist/editors/RelationEditor.d.ts +13 -28
  47. package/dist/editors/RelationEditor.js +17 -40
  48. package/dist/editors/RelationSetEditor.d.ts +53 -0
  49. package/dist/editors/RelationSetEditor.js +112 -0
  50. package/dist/editors/SelectEditor.d.ts +21 -3
  51. package/dist/editors/SelectEditor.js +55 -9
  52. package/dist/editors/TextEditor.d.ts +51 -0
  53. package/dist/editors/TextEditor.js +81 -0
  54. package/dist/editors/ValueListEditor.d.ts +5 -2
  55. package/dist/editors/ValueListEditor.js +11 -9
  56. package/dist/editors/edit-cores.d.ts +13 -10
  57. package/dist/editors/edit-cores.js +7 -6
  58. package/dist/editors/edit-session.d.ts +21 -11
  59. package/dist/editors/edit-session.js +19 -5
  60. package/dist/editors/keep-inside.d.ts +12 -0
  61. package/dist/editors/keep-inside.js +20 -0
  62. package/dist/editors/open-value.d.ts +21 -0
  63. package/dist/editors/open-value.js +36 -0
  64. package/dist/editors/open-values.d.ts +4 -0
  65. package/dist/editors/open-values.js +7 -0
  66. package/dist/editors/relation-kinds.d.ts +7 -0
  67. package/dist/editors/relation-kinds.js +21 -0
  68. package/dist/editors/relation-panel.d.ts +69 -0
  69. package/dist/editors/relation-panel.js +40 -0
  70. package/dist/field-row/FieldNoteLine.d.ts +14 -0
  71. package/dist/field-row/FieldNoteLine.js +14 -0
  72. package/dist/field-row/FieldRow.d.ts +73 -0
  73. package/dist/field-row/FieldRow.js +157 -0
  74. package/dist/field-row/FieldRowLane.d.ts +19 -0
  75. package/dist/field-row/FieldRowLane.js +11 -0
  76. package/dist/field-row/editors/RowChipsEditor.d.ts +11 -0
  77. package/dist/field-row/editors/RowChipsEditor.js +25 -0
  78. package/dist/field-row/editors/RowDateEditor.d.ts +16 -0
  79. package/dist/field-row/editors/RowDateEditor.js +18 -0
  80. package/dist/field-row/editors/RowEditor.d.ts +39 -0
  81. package/dist/field-row/editors/RowEditor.js +64 -0
  82. package/dist/field-row/editors/RowNameEditor.d.ts +4 -0
  83. package/dist/field-row/editors/RowNameEditor.js +15 -0
  84. package/dist/field-row/editors/RowNumberEditor.d.ts +12 -0
  85. package/dist/field-row/editors/RowNumberEditor.js +18 -0
  86. package/dist/field-row/editors/RowPlaceEditor.d.ts +8 -0
  87. package/dist/field-row/editors/RowPlaceEditor.js +18 -0
  88. package/dist/field-row/editors/RowRangeEditor.d.ts +4 -0
  89. package/dist/field-row/editors/RowRangeEditor.js +15 -0
  90. package/dist/field-row/editors/RowRelationEditor.d.ts +20 -0
  91. package/dist/field-row/editors/RowRelationEditor.js +77 -0
  92. package/dist/field-row/editors/RowSelectEditor.d.ts +13 -0
  93. package/dist/field-row/editors/RowSelectEditor.js +23 -0
  94. package/dist/field-row/editors/RowTextEditor.d.ts +15 -0
  95. package/dist/field-row/editors/RowTextEditor.js +16 -0
  96. package/dist/field-row/editors/RowValueListEditor.d.ts +4 -0
  97. package/dist/field-row/editors/RowValueListEditor.js +21 -0
  98. package/dist/field-row/editors/host.d.ts +59 -0
  99. package/dist/field-row/editors/host.js +1 -0
  100. package/dist/field-row/editors/row-session.d.ts +49 -0
  101. package/dist/field-row/editors/row-session.js +49 -0
  102. package/dist/field-row/index.d.ts +5 -0
  103. package/dist/field-row/index.js +5 -0
  104. package/dist/field-row/row-target.d.ts +20 -0
  105. package/dist/field-row/row-target.js +3 -0
  106. package/dist/field-row/useFieldWrite.d.ts +45 -0
  107. package/dist/field-row/useFieldWrite.js +190 -0
  108. package/dist/field-row/useRowSettlement.d.ts +33 -0
  109. package/dist/field-row/useRowSettlement.js +23 -0
  110. package/dist/fields/binding.d.ts +7 -2
  111. package/dist/fields/binding.js +13 -6
  112. package/dist/fields/currency.d.ts +0 -10
  113. package/dist/fields/currency.js +0 -14
  114. package/dist/fields/edit-core-types.d.ts +9 -9
  115. package/dist/fields/edit-core-types.js +6 -6
  116. package/dist/fields/money.d.ts +6 -0
  117. package/dist/fields/money.js +11 -0
  118. package/dist/fields/number-edit.d.ts +6 -0
  119. package/dist/fields/number-edit.js +4 -0
  120. package/dist/fields/prepare-write.js +6 -1
  121. package/dist/fields/relation-source-types.d.ts +12 -0
  122. package/dist/fields/write-target.d.ts +50 -0
  123. package/dist/fields/write-target.js +10 -0
  124. package/dist/filters/filter-model.d.ts +0 -1
  125. package/dist/filters/registry.d.ts +3 -36
  126. package/dist/filters/registry.js +0 -38
  127. package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
  128. package/dist/grid/chrome/GridAddColumn.js +29 -0
  129. package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
  130. package/dist/grid/chrome/GridAggregateMenu.js +29 -0
  131. package/dist/grid/chrome/GridCellEditors.d.ts +71 -0
  132. package/dist/grid/chrome/GridCellEditors.js +126 -0
  133. package/dist/grid/chrome/GridCellOutline.d.ts +49 -0
  134. package/dist/grid/chrome/GridCellOutline.js +16 -0
  135. package/dist/grid/chrome/GridChipsEditor.d.ts +38 -0
  136. package/dist/grid/chrome/GridChipsEditor.js +35 -0
  137. package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
  138. package/dist/grid/chrome/GridColumnColorSection.js +40 -0
  139. package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
  140. package/dist/grid/chrome/GridColumnDateSection.js +23 -0
  141. package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
  142. package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
  143. package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
  144. package/dist/grid/chrome/GridColumnMenu.js +103 -0
  145. package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
  146. package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
  147. package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
  148. package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
  149. package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
  150. package/dist/grid/chrome/GridColumnSortSection.js +16 -0
  151. package/dist/grid/chrome/GridDateEditor.d.ts +34 -0
  152. package/dist/grid/chrome/GridDateEditor.js +19 -0
  153. package/dist/grid/chrome/GridFlyout.d.ts +44 -0
  154. package/dist/grid/chrome/GridFlyout.js +80 -0
  155. package/dist/grid/chrome/GridFooter.d.ts +33 -0
  156. package/dist/grid/chrome/GridFooter.js +85 -0
  157. package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
  158. package/dist/grid/chrome/GridGroupMenu.js +64 -0
  159. package/dist/grid/chrome/GridHeader.d.ts +66 -0
  160. package/dist/grid/chrome/GridHeader.js +42 -0
  161. package/dist/grid/chrome/GridLongTextEditor.d.ts +55 -0
  162. package/dist/grid/chrome/GridLongTextEditor.js +69 -0
  163. package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
  164. package/dist/grid/chrome/GridMenuRow.js +15 -0
  165. package/dist/grid/chrome/GridNameEditor.d.ts +24 -0
  166. package/dist/grid/chrome/GridNameEditor.js +21 -0
  167. package/dist/grid/chrome/GridNumberEditor.d.ts +49 -0
  168. package/dist/grid/chrome/GridNumberEditor.js +51 -0
  169. package/dist/grid/chrome/GridPlaceEditor.d.ts +26 -0
  170. package/dist/grid/chrome/GridPlaceEditor.js +22 -0
  171. package/dist/grid/chrome/GridRangeEditor.d.ts +30 -0
  172. package/dist/grid/chrome/GridRangeEditor.js +21 -0
  173. package/dist/grid/chrome/GridRelationEditor.d.ts +45 -0
  174. package/dist/grid/chrome/GridRelationEditor.js +92 -0
  175. package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
  176. package/dist/grid/chrome/GridResizeHandle.js +19 -0
  177. package/dist/grid/chrome/GridRow.d.ts +31 -0
  178. package/dist/grid/chrome/GridRow.js +179 -0
  179. package/dist/grid/chrome/GridRowActions.d.ts +32 -0
  180. package/dist/grid/chrome/GridRowActions.js +25 -0
  181. package/dist/grid/chrome/GridRowCells.d.ts +4 -0
  182. package/dist/grid/chrome/GridRowCells.js +128 -0
  183. package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
  184. package/dist/grid/chrome/GridRowGlyph.js +13 -0
  185. package/dist/grid/chrome/GridSelectEditor.d.ts +33 -0
  186. package/dist/grid/chrome/GridSelectEditor.js +43 -0
  187. package/dist/grid/chrome/GridStructure.d.ts +47 -0
  188. package/dist/grid/chrome/GridStructure.js +41 -0
  189. package/dist/grid/chrome/GridTable.d.ts +4 -0
  190. package/dist/grid/chrome/GridTable.js +192 -0
  191. package/dist/grid/chrome/GridTableSurface.d.ts +52 -0
  192. package/dist/grid/chrome/GridTableSurface.js +15 -0
  193. package/dist/grid/chrome/GridTextEditor.d.ts +45 -0
  194. package/dist/grid/chrome/GridTextEditor.js +38 -0
  195. package/dist/grid/chrome/GridValueListEditor.d.ts +30 -0
  196. package/dist/grid/chrome/GridValueListEditor.js +19 -0
  197. package/dist/grid/chrome/StuckMarker.d.ts +16 -0
  198. package/dist/grid/chrome/StuckMarker.js +34 -0
  199. package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
  200. package/dist/grid/chrome/cell-clipboard.js +28 -0
  201. package/dist/grid/chrome/cell-cut-off.d.ts +11 -0
  202. package/dist/grid/chrome/cell-cut-off.js +20 -0
  203. package/dist/grid/chrome/cells.d.ts +21 -0
  204. package/dist/grid/chrome/cells.js +19 -0
  205. package/dist/grid/chrome/checks.d.ts +32 -0
  206. package/dist/grid/chrome/checks.js +32 -0
  207. package/dist/grid/chrome/column-glyph.d.ts +14 -0
  208. package/dist/grid/chrome/column-glyph.js +44 -0
  209. package/dist/grid/chrome/editors.d.ts +9 -0
  210. package/dist/grid/chrome/editors.js +10 -0
  211. package/dist/grid/chrome/grid-cell-classes.d.ts +53 -0
  212. package/dist/grid/chrome/grid-cell-classes.js +32 -0
  213. package/dist/grid/chrome/grid-cell-link.d.ts +13 -0
  214. package/dist/grid/chrome/grid-cell-link.js +9 -0
  215. package/dist/grid/chrome/grid-edit-session.d.ts +63 -0
  216. package/dist/grid/chrome/grid-edit-session.js +118 -0
  217. package/dist/grid/chrome/grid-hover.d.ts +60 -0
  218. package/dist/grid/chrome/grid-hover.js +81 -0
  219. package/dist/grid/chrome/grid-menu-focus.d.ts +43 -0
  220. package/dist/grid/chrome/grid-menu-focus.js +93 -0
  221. package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
  222. package/dist/grid/chrome/grid-menu-search.js +7 -0
  223. package/dist/grid/chrome/grid-row-menu-key.d.ts +15 -0
  224. package/dist/grid/chrome/grid-row-menu-key.js +36 -0
  225. package/dist/grid/chrome/grid-row-props.d.ts +143 -0
  226. package/dist/grid/chrome/grid-row-props.js +1 -0
  227. package/dist/grid/chrome/grid-row-window.d.ts +61 -0
  228. package/dist/grid/chrome/grid-row-window.js +212 -0
  229. package/dist/grid/chrome/grid-scroll-owner.d.ts +38 -0
  230. package/dist/grid/chrome/grid-scroll-owner.js +75 -0
  231. package/dist/grid/chrome/grid-styles.d.ts +40 -0
  232. package/dist/grid/chrome/grid-styles.js +9 -0
  233. package/dist/grid/chrome/grid-table-props.d.ts +172 -0
  234. package/dist/grid/chrome/grid-table-props.js +1 -0
  235. package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
  236. package/dist/grid/chrome/useGridBatchApi.js +35 -0
  237. package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
  238. package/dist/grid/chrome/useGridColumnLayout.js +206 -0
  239. package/dist/grid/chrome/useGridFocus.d.ts +45 -0
  240. package/dist/grid/chrome/useGridFocus.js +122 -0
  241. package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
  242. package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
  243. package/dist/grid/chrome/useGridKeyboard.d.ts +64 -0
  244. package/dist/grid/chrome/useGridKeyboard.js +450 -0
  245. package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
  246. package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
  247. package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
  248. package/dist/grid/chrome/useGridRailReveal.js +67 -0
  249. package/dist/grid/chrome/useGridRangeActions.d.ts +51 -0
  250. package/dist/grid/chrome/useGridRangeActions.js +195 -0
  251. package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
  252. package/dist/grid/chrome/useGridRangeGestures.js +237 -0
  253. package/dist/grid/chrome/useGridRowContextMenu.d.ts +37 -0
  254. package/dist/grid/chrome/useGridRowContextMenu.js +153 -0
  255. package/dist/grid/chrome/useGridScaleStyles.d.ts +3 -0
  256. package/dist/grid/chrome/useGridScaleStyles.js +28 -0
  257. package/dist/grid/chrome/useGridScrollArea.d.ts +21 -0
  258. package/dist/grid/chrome/useGridScrollArea.js +65 -0
  259. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +78 -0
  260. package/dist/grid/chrome/useGridTableInteractionModel.js +249 -0
  261. package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
  262. package/dist/grid/chrome/useGridTableSelection.js +55 -0
  263. package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
  264. package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
  265. package/dist/grid/core/clipboard-model.d.ts +83 -0
  266. package/dist/grid/core/clipboard-model.js +291 -0
  267. package/dist/grid/core/column-values.d.ts +27 -0
  268. package/dist/grid/core/column-values.js +76 -0
  269. package/dist/grid/core/commit-model.d.ts +41 -0
  270. package/dist/grid/core/commit-model.js +3 -0
  271. package/dist/grid/core/coordinates.d.ts +48 -0
  272. package/dist/grid/core/coordinates.js +27 -0
  273. package/dist/grid/core/edge-scroll.d.ts +21 -0
  274. package/dist/grid/core/edge-scroll.js +23 -0
  275. package/dist/grid/core/edit-values.d.ts +9 -0
  276. package/dist/grid/core/edit-values.js +1 -0
  277. package/dist/grid/core/editing-controller.d.ts +60 -0
  278. package/dist/grid/core/editing-controller.js +266 -0
  279. package/dist/grid/core/editing-model.d.ts +87 -0
  280. package/dist/grid/core/editing-model.js +148 -0
  281. package/dist/grid/core/flat-rows.d.ts +35 -0
  282. package/dist/grid/core/flat-rows.js +20 -0
  283. package/dist/grid/core/grid-aria.d.ts +27 -0
  284. package/dist/grid/core/grid-aria.js +39 -0
  285. package/dist/grid/core/grid-focus.d.ts +54 -0
  286. package/dist/grid/core/grid-focus.js +148 -0
  287. package/dist/grid/core/grid-scale.d.ts +14 -0
  288. package/dist/grid/core/grid-scale.js +8 -0
  289. package/dist/grid/core/nav.d.ts +94 -0
  290. package/dist/grid/core/nav.js +92 -0
  291. package/dist/grid/core/pending-reconciliation.d.ts +53 -0
  292. package/dist/grid/core/pending-reconciliation.js +51 -0
  293. package/dist/grid/core/range-model.d.ts +25 -0
  294. package/dist/grid/core/range-model.js +59 -0
  295. package/dist/grid/core/row-window.d.ts +40 -0
  296. package/dist/grid/core/row-window.js +43 -0
  297. package/dist/grid/core/spreadsheet-operations.d.ts +101 -0
  298. package/dist/grid/core/spreadsheet-operations.js +280 -0
  299. package/dist/grid/core/useGridEditing.d.ts +46 -0
  300. package/dist/grid/core/useGridEditing.js +93 -0
  301. package/dist/grid/core/useGridRange.d.ts +20 -0
  302. package/dist/grid/core/useGridRange.js +24 -0
  303. package/dist/grid/core/value-equality.d.ts +54 -0
  304. package/dist/grid/core/value-equality.js +80 -0
  305. package/dist/grid/index.d.ts +18 -0
  306. package/dist/grid/index.js +5 -0
  307. package/dist/grid/useGridTablePrefs.d.ts +49 -0
  308. package/dist/grid/useGridTablePrefs.js +99 -0
  309. package/dist/index.d.ts +1 -1
  310. package/dist/index.js +1 -1
  311. package/dist/internal/viewport.d.ts +3 -0
  312. package/dist/internal/viewport.js +15 -0
  313. package/dist/model/column-capabilities.d.ts +3 -2
  314. package/dist/model/column-capabilities.js +28 -8
  315. package/dist/model/column-from.js +3 -0
  316. package/dist/model/column-inspect.d.ts +10 -2
  317. package/dist/model/column-inspect.js +9 -0
  318. package/dist/model/column-schema.d.ts +6 -1
  319. package/dist/model/column-state.d.ts +1 -1
  320. package/dist/model/column-types.d.ts +3 -1
  321. package/dist/model/column-types.js +1 -1
  322. package/dist/model/density.js +3 -3
  323. package/dist/model/filter-capabilities.d.ts +1 -1
  324. package/dist/model/filter-capabilities.js +1 -1
  325. package/dist/model/index.d.ts +4 -6
  326. package/dist/model/index.js +0 -1
  327. package/dist/model/preferences.d.ts +7 -7
  328. package/dist/model/preferences.js +0 -1
  329. package/dist/model/prefs-buckets.d.ts +0 -1
  330. package/dist/model/prefs-buckets.js +0 -3
  331. package/dist/model/render-count.d.ts +6 -0
  332. package/dist/model/render-count.js +11 -0
  333. package/dist/provider/ViewsProvider.d.ts +6 -2
  334. package/dist/provider/ViewsProvider.js +12 -2
  335. package/dist/provider/components.d.ts +35 -9
  336. package/dist/provider/components.js +4 -2
  337. package/dist/provider/context.d.ts +8 -4
  338. package/dist/provider/desktop.d.ts +9 -0
  339. package/dist/provider/desktop.js +22 -0
  340. package/dist/provider/menu-groups.d.ts +8 -0
  341. package/dist/provider/menu-groups.js +38 -0
  342. package/dist/provider/plain-input.d.ts +8 -0
  343. package/dist/provider/plain-input.js +5 -0
  344. package/dist/provider/ports.d.ts +22 -0
  345. package/dist/provider/ports.js +1 -0
  346. package/dist/react.d.ts +3 -2
  347. package/dist/react.js +1 -0
  348. package/dist/selection/SelectCheckbox.d.ts +3 -1
  349. package/dist/selection/SelectCheckbox.js +2 -2
  350. package/dist/selection/useCheckDragSelect.js +6 -5
  351. package/docs/contract.md +202 -72
  352. package/docs/getting-started.md +250 -0
  353. package/docs/guides/atoms.md +245 -0
  354. package/docs/guides/cells.md +302 -0
  355. package/docs/guides/columns.md +413 -0
  356. package/docs/guides/display.md +204 -0
  357. package/docs/guides/editors.md +462 -0
  358. package/docs/guides/ports.md +246 -0
  359. package/docs/guides/selection.md +270 -0
  360. package/docs/guides/the-grid.md +696 -0
  361. package/docs/guides/the-provider.md +448 -0
  362. package/docs/index.md +52 -0
  363. package/docs/install.md +9 -47
  364. package/docs/reference/cells.md +28 -0
  365. package/docs/reference/display.md +44 -0
  366. package/docs/reference/editors-chips.md +6 -0
  367. package/docs/reference/editors-date.md +6 -0
  368. package/docs/reference/editors-location.md +10 -0
  369. package/docs/reference/editors-name.md +6 -0
  370. package/docs/reference/editors-number.md +11 -0
  371. package/docs/reference/editors-open-values.md +10 -0
  372. package/docs/reference/editors-panel.md +12 -0
  373. package/docs/reference/editors-range.md +6 -0
  374. package/docs/reference/editors-relation.md +12 -0
  375. package/docs/reference/editors-select.md +9 -0
  376. package/docs/reference/editors-session.md +11 -0
  377. package/docs/reference/editors-text.md +9 -0
  378. package/docs/reference/editors-value-list.md +6 -0
  379. package/docs/reference/editors.md +5 -0
  380. package/docs/reference/field-row.md +16 -0
  381. package/docs/reference/grid.md +39 -0
  382. package/docs/reference/react.md +89 -0
  383. package/docs/reference/selection.md +33 -0
  384. package/docs/reference/views.md +622 -0
  385. package/package.json +27 -4
  386. package/skills/views/SKILL.md +20 -5
  387. package/dist/filters/types.d.ts +0 -27
  388. package/dist/filters/types.js +0 -1
  389. package/dist/model/filter-pushdown.d.ts +0 -106
  390. package/dist/model/filter-pushdown.js +0 -147
@@ -0,0 +1,92 @@
1
+ const GRID_ARROW_DIRS = {
2
+ ArrowUp: "up",
3
+ ArrowDown: "down",
4
+ ArrowLeft: "left",
5
+ ArrowRight: "right",
6
+ };
7
+ export function gridNavIntent(e) {
8
+ if (e.altKey)
9
+ return null;
10
+ const mod = e.metaKey || e.ctrlKey;
11
+ if (e.key.toLowerCase() === "a")
12
+ return mod && !e.shiftKey ? { kind: "selectAll" } : null;
13
+ const dir = GRID_ARROW_DIRS[e.key];
14
+ if (dir) {
15
+ if (mod || !e.shiftKey)
16
+ return null;
17
+ return { kind: "cell", target: { kind: "step", dir }, extend: true };
18
+ }
19
+ if (e.key === "Home" || e.key === "End") {
20
+ const edge = e.key === "Home" ? "start" : "end";
21
+ return {
22
+ kind: "cell",
23
+ target: mod ? { kind: "tableEdge", edge } : { kind: "rowEdge", edge },
24
+ extend: e.shiftKey,
25
+ };
26
+ }
27
+ return null;
28
+ }
29
+ export function resolveNavTarget(from, target, visibleRowIds, visibleColIds) {
30
+ if (target.kind === "step")
31
+ return nextCellPos(from, target.dir, visibleRowIds, visibleColIds);
32
+ if (visibleRowIds.length === 0 || visibleColIds.length === 0)
33
+ return null;
34
+ const columnId = target.edge === "start" ? visibleColIds[0] : visibleColIds[visibleColIds.length - 1];
35
+ if (target.kind === "tableEdge") {
36
+ const rowId = target.edge === "start" ? visibleRowIds[0] : visibleRowIds[visibleRowIds.length - 1];
37
+ return { rowId, columnId };
38
+ }
39
+ return visibleRowIds.includes(from.rowId) ? { rowId: from.rowId, columnId } : null;
40
+ }
41
+ export function wholeTableRect(visibleRowIds, visibleColIds) {
42
+ if (visibleRowIds.length === 0 || visibleColIds.length === 0)
43
+ return null;
44
+ return {
45
+ anchor: { rowId: visibleRowIds[0], columnId: visibleColIds[0] },
46
+ head: {
47
+ rowId: visibleRowIds[visibleRowIds.length - 1],
48
+ columnId: visibleColIds[visibleColIds.length - 1],
49
+ },
50
+ };
51
+ }
52
+ export function activeRangeHead(ranges, visibleRowIds, visibleColIds) {
53
+ const head = ranges[ranges.length - 1]?.head;
54
+ if (!head)
55
+ return null;
56
+ if (!visibleRowIds.includes(head.rowId) || !visibleColIds.includes(head.columnId))
57
+ return null;
58
+ return head;
59
+ }
60
+ export function nextCellPos(pos, dir, visibleRowIds, visibleColIds) {
61
+ const r = visibleRowIds.indexOf(pos.rowId);
62
+ const c = visibleColIds.indexOf(pos.columnId);
63
+ if (r < 0 || c < 0)
64
+ return null;
65
+ if (dir === "up" || dir === "down") {
66
+ const nr = r + (dir === "down" ? 1 : -1);
67
+ if (nr < 0 || nr >= visibleRowIds.length)
68
+ return null;
69
+ return { rowId: visibleRowIds[nr], columnId: pos.columnId };
70
+ }
71
+ const nc = c + (dir === "right" ? 1 : -1);
72
+ if (nc < 0 || nc >= visibleColIds.length)
73
+ return null;
74
+ return { rowId: pos.rowId, columnId: visibleColIds[nc] };
75
+ }
76
+ export function nextCellLinear(pos, backwards, visibleRowIds, visibleColIds) {
77
+ const r = visibleRowIds.indexOf(pos.rowId);
78
+ const c = visibleColIds.indexOf(pos.columnId);
79
+ if (r < 0 || c < 0)
80
+ return null;
81
+ const nc = c + (backwards ? -1 : 1);
82
+ if (nc >= 0 && nc < visibleColIds.length) {
83
+ return { rowId: pos.rowId, columnId: visibleColIds[nc] };
84
+ }
85
+ const nr = r + (backwards ? -1 : 1);
86
+ if (nr < 0 || nr >= visibleRowIds.length)
87
+ return null;
88
+ return {
89
+ rowId: visibleRowIds[nr],
90
+ columnId: backwards ? visibleColIds[visibleColIds.length - 1] : visibleColIds[0],
91
+ };
92
+ }
@@ -0,0 +1,53 @@
1
+ import type { ListColumn } from "../../model/column-schema.js";
2
+ /**
3
+ * Reconciling the optimistic overlay with what the server actually holds.
4
+ *
5
+ * Its own module rather than another block in `spreadsheet-operations`: those
6
+ * functions PLAN edits from a selection (copy, clear, paste, fill), these read
7
+ * the aftermath of edits that already happened. Splitting them is also what
8
+ * keeps that file under the line ceiling — the policy there is split, not
9
+ * raise.
10
+ */
11
+ /**
12
+ * Which pending overlays a freshly-landed row set has settled.
13
+ *
14
+ * Two ways an overlay is finished with, not one:
15
+ * - the server value now MATCHES it — the write landed;
16
+ * - the write has already settled and the server value still doesn't match —
17
+ * somebody else wrote something different, so the server has moved on.
18
+ *
19
+ * The second case is why `hasInflight` is asked. Without it an overlay whose
20
+ * value lost a race was kept forever, and the cell showed the user's stale
21
+ * local value on top of server truth indefinitely — reachable in normal use as
22
+ * soon as a list polls.
23
+ */
24
+ export declare function findGridPendingMatches<Row>(rows: readonly Row[], columns: readonly ListColumn<Row>[], getRowId: (row: Row) => string, pendingByRow: ReadonlyMap<string, Readonly<Record<string, unknown>>>, hasInflight?: (rowId: string, columnId: string) => boolean): string[];
25
+ /**
26
+ * The cells where the server now holds a value that is nobody's but a third
27
+ * party's — the visible half of last-write-wins.
28
+ *
29
+ * Writes here are not versioned: two people editing one row means the second
30
+ * save reverts the first and neither is told. Detecting it is cheap because the
31
+ * overlay already knows what we sent and (via `baselineOf`) what the cell held
32
+ * before we sent it. So a settled, unlanded cell falls into three buckets and
33
+ * only ONE is worth interrupting someone over:
34
+ *
35
+ * - server ≈ our value → it landed, merely reshaped. Silence.
36
+ * - server ≈ our baseline → our write didn't take (refused, or rolled back
37
+ * elsewhere). Silence — the rejection path owns
38
+ * that story and already toasts it.
39
+ * - a third value entirely → somebody else wrote while we were writing.
40
+ *
41
+ * When the save answered what it kept (`stored`), the overlay already holds
42
+ * that value, so the first bucket catches it, read by structure for an object.
43
+ *
44
+ * Pure, and separate from `findGridPendingMatches` on purpose: that answers
45
+ * "which overlays are finished with", this answers "which of them were taken
46
+ * from us". Two questions, and only the second is worth a word to the user.
47
+ */
48
+ export declare function findSupersededCells<Row>(rows: readonly Row[], columns: readonly ListColumn<Row>[], getRowId: (row: Row) => string, pendingByRow: ReadonlyMap<string, Readonly<Record<string, unknown>>>, hasInflight: (rowId: string, columnId: string) => boolean, baselineOf: (rowId: string, columnId: string) => unknown): {
49
+ rowId: string;
50
+ columnId: string;
51
+ column: ListColumn<Row>;
52
+ serverValue: unknown;
53
+ }[];
@@ -0,0 +1,51 @@
1
+ import { gridCellKey } from "./commit-model.js";
2
+ import { sameListValue } from "@viewkitjs/fields";
3
+ import { isEmptyValue, isGridKeptValue, looselyEqualValue, sameKeptValue } from "./value-equality.js";
4
+ export function findGridPendingMatches(rows, columns, getRowId, pendingByRow, hasInflight) {
5
+ const byId = new Map(rows.map((row) => [getRowId(row), row]));
6
+ const byColumn = new Map(columns.map((column) => [column.id, column]));
7
+ const matched = [];
8
+ for (const [rowId, pending] of pendingByRow) {
9
+ const row = byId.get(rowId);
10
+ if (row == null)
11
+ continue;
12
+ for (const [columnId, value] of Object.entries(pending)) {
13
+ const col = byColumn.get(columnId);
14
+ const read = col?.editAccessor ?? col?.accessor;
15
+ if (!read)
16
+ continue;
17
+ const server = read(row);
18
+ const landed = (isGridKeptValue(value) ? sameKeptValue(server, value) : sameListValue(server, value)) ||
19
+ (isEmptyValue(value) && isEmptyValue(server));
20
+ const superseded = !landed && hasInflight != null && !hasInflight(rowId, columnId);
21
+ if (landed || superseded)
22
+ matched.push(gridCellKey(rowId, columnId));
23
+ }
24
+ }
25
+ return matched;
26
+ }
27
+ export function findSupersededCells(rows, columns, getRowId, pendingByRow, hasInflight, baselineOf) {
28
+ const byId = new Map(rows.map((row) => [getRowId(row), row]));
29
+ const byColumn = new Map(columns.map((column) => [column.id, column]));
30
+ const taken = [];
31
+ for (const [rowId, pending] of pendingByRow) {
32
+ const row = byId.get(rowId);
33
+ if (row == null)
34
+ continue;
35
+ for (const [columnId, value] of Object.entries(pending)) {
36
+ const col = byColumn.get(columnId);
37
+ const read = col?.editAccessor ?? col?.accessor;
38
+ if (!col || !read)
39
+ continue;
40
+ if (hasInflight(rowId, columnId))
41
+ continue;
42
+ const serverValue = read(row);
43
+ if (isGridKeptValue(value) ? sameKeptValue(serverValue, value) : looselyEqualValue(serverValue, value))
44
+ continue;
45
+ if (looselyEqualValue(serverValue, baselineOf(rowId, columnId)))
46
+ continue;
47
+ taken.push({ rowId, columnId, column: col, serverValue });
48
+ }
49
+ }
50
+ return taken;
51
+ }
@@ -0,0 +1,25 @@
1
+ import { type GridCellPos, type GridCellRect } from "./coordinates.js";
2
+ export type GridCellRange = {
3
+ anchor: GridCellPos;
4
+ head: GridCellPos;
5
+ };
6
+ /** One horizontal slice of a range, in visible column indices, for one row. */
7
+ export type GridRowRangeSpan = {
8
+ startCol: number;
9
+ endCol: number;
10
+ top: boolean;
11
+ bottom: boolean;
12
+ /** Column index carrying the active range's fill dot, or null. */
13
+ dotCol: number | null;
14
+ };
15
+ export declare function setSingleRange(pos: GridCellPos): GridCellRange[];
16
+ export declare function setRectRange(anchor: GridCellPos, head: GridCellPos): GridCellRange[];
17
+ export declare function beginRangeDrag(ranges: readonly GridCellRange[], pos: GridCellPos, additive: boolean): GridCellRange[];
18
+ export declare function extendActiveRange(ranges: readonly GridCellRange[], pos: GridCellPos, fallbackAnchor?: GridCellPos): GridCellRange[];
19
+ export declare function addCellRange(ranges: readonly GridCellRange[], pos: GridCellPos): GridCellRange[];
20
+ export declare function resolveActiveRangeRect(ranges: readonly GridCellRange[], focused: GridCellPos | null, visibleRowIds: readonly string[], visibleColIds: readonly string[]): GridCellRect | null;
21
+ /**
22
+ * Resolve ranges to per-row spans against the current visible order. The
23
+ * ordinary one-cell focus ring is intentionally not duplicated as a range.
24
+ */
25
+ export declare function computeRowRangeSpans(ranges: readonly GridCellRange[], visibleRowIds: readonly string[], visibleColIds: readonly string[]): Map<string, GridRowRangeSpan[]>;
@@ -0,0 +1,59 @@
1
+ import { resolveCellRect } from "./coordinates.js";
2
+ export function setSingleRange(pos) {
3
+ return [{ anchor: pos, head: pos }];
4
+ }
5
+ export function setRectRange(anchor, head) {
6
+ return [{ anchor, head }];
7
+ }
8
+ export function beginRangeDrag(ranges, pos, additive) {
9
+ const next = { anchor: pos, head: pos };
10
+ return additive ? [...ranges, next] : [next];
11
+ }
12
+ export function extendActiveRange(ranges, pos, fallbackAnchor) {
13
+ if (ranges.length === 0)
14
+ return [{ anchor: fallbackAnchor ?? pos, head: pos }];
15
+ const last = ranges[ranges.length - 1];
16
+ if (last.head.rowId === pos.rowId && last.head.columnId === pos.columnId) {
17
+ return ranges;
18
+ }
19
+ return [...ranges.slice(0, -1), { anchor: last.anchor, head: pos }];
20
+ }
21
+ export function addCellRange(ranges, pos) {
22
+ return [...ranges, { anchor: pos, head: pos }];
23
+ }
24
+ export function resolveActiveRangeRect(ranges, focused, visibleRowIds, visibleColIds) {
25
+ const active = ranges[ranges.length - 1] ?? (focused ? { anchor: focused, head: focused } : null);
26
+ return active ? resolveCellRect(active.anchor, active.head, visibleRowIds, visibleColIds) : null;
27
+ }
28
+ export function computeRowRangeSpans(ranges, visibleRowIds, visibleColIds) {
29
+ const out = new Map();
30
+ if (ranges.length === 0)
31
+ return out;
32
+ if (ranges.length === 1 &&
33
+ ranges[0].anchor.rowId === ranges[0].head.rowId &&
34
+ ranges[0].anchor.columnId === ranges[0].head.columnId) {
35
+ return out;
36
+ }
37
+ ranges.forEach((range, rangeIndex) => {
38
+ const rect = resolveCellRect(range.anchor, range.head, visibleRowIds, visibleColIds);
39
+ if (!rect)
40
+ return;
41
+ const active = rangeIndex === ranges.length - 1;
42
+ for (let r = rect.r1; r <= rect.r2; r++) {
43
+ const rowId = visibleRowIds[r];
44
+ const span = {
45
+ startCol: rect.c1,
46
+ endCol: rect.c2,
47
+ top: r === rect.r1,
48
+ bottom: r === rect.r2,
49
+ dotCol: active && r === rect.r2 ? rect.c2 : null,
50
+ };
51
+ const existing = out.get(rowId);
52
+ if (existing)
53
+ existing.push(span);
54
+ else
55
+ out.set(rowId, [span]);
56
+ }
57
+ });
58
+ return out;
59
+ }
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Which rows a group draws: the ones its scroll owner shows, plus a margin, plus the rows kept drawn wherever they
3
+ * are (the focused, the editing, a focused checkbox's and the last revealed). Pure arithmetic over one row height, so every row of the
4
+ * grid is the same height (cells never wrap) and a group's rows sit at `index × rowHeight` below its first.
5
+ */
6
+ /** Rows drawn beyond each edge of the view (the timed structures in `bench/pages/structures/` drew 10). */
7
+ export declare const GRID_WINDOW_OVERSCAN = 10;
8
+ /** Rows each open group draws from its top where nothing can be measured: no layout engine, a hidden box, the first render. */
9
+ export declare const GRID_WINDOW_FALLBACK_ROWS = 30;
10
+ /** Rows [start, end) a group draws; null: none. */
11
+ export type GridRowRange = {
12
+ start: number;
13
+ end: number;
14
+ } | null;
15
+ /** A group's rows region in the content's coordinates: where its first row starts, where its box (the clip) ends. */
16
+ export type GridRowRegion = {
17
+ top: number;
18
+ bottom: number;
19
+ };
20
+ export declare function gridGroupRange({ view, region, rowHeight, count, overscan, }: {
21
+ view: {
22
+ top: number;
23
+ bottom: number;
24
+ };
25
+ region: GridRowRegion;
26
+ rowHeight: number;
27
+ count: number;
28
+ overscan?: number;
29
+ }): GridRowRange;
30
+ export type GridRowSegment = {
31
+ kind: "rows";
32
+ start: number;
33
+ end: number;
34
+ } | {
35
+ kind: "gap";
36
+ start: number;
37
+ end: number;
38
+ };
39
+ /** The rows and gaps one group draws, in order, covering [0, count) once: the range, plus each kept index as its own run. */
40
+ export declare function gridRowSegments(count: number, range: GridRowRange, kept: readonly number[]): GridRowSegment[];
@@ -0,0 +1,43 @@
1
+ export const GRID_WINDOW_OVERSCAN = 10;
2
+ export const GRID_WINDOW_FALLBACK_ROWS = 30;
3
+ export function gridGroupRange({ view, region, rowHeight, count, overscan = GRID_WINDOW_OVERSCAN, }) {
4
+ if (rowHeight <= 0 || count <= 0)
5
+ return null;
6
+ const top = Math.max(view.top, region.top);
7
+ const bottom = Math.min(view.bottom, region.bottom, region.top + count * rowHeight);
8
+ if (bottom <= top)
9
+ return null;
10
+ const start = Math.max(0, Math.floor((top - region.top) / rowHeight) - overscan);
11
+ const end = Math.min(count, Math.ceil((bottom - region.top) / rowHeight) + overscan);
12
+ return end > start ? { start, end } : null;
13
+ }
14
+ export function gridRowSegments(count, range, kept) {
15
+ if (count <= 0)
16
+ return [];
17
+ const runs = [];
18
+ if (range)
19
+ runs.push({ start: Math.max(0, range.start), end: Math.min(count, range.end) });
20
+ for (const index of kept)
21
+ if (index >= 0 && index < count)
22
+ runs.push({ start: index, end: index + 1 });
23
+ runs.sort((a, b) => a.start - b.start);
24
+ const segments = [];
25
+ let at = 0;
26
+ for (const run of runs) {
27
+ if (run.end <= run.start)
28
+ continue;
29
+ const last = segments[segments.length - 1];
30
+ if (last?.kind === "rows" && run.start <= last.end) {
31
+ last.end = Math.max(last.end, run.end);
32
+ at = last.end;
33
+ continue;
34
+ }
35
+ if (run.start > at)
36
+ segments.push({ kind: "gap", start: at, end: run.start });
37
+ segments.push({ kind: "rows", start: run.start, end: run.end });
38
+ at = run.end;
39
+ }
40
+ if (at < count)
41
+ segments.push({ kind: "gap", start: at, end: count });
42
+ return segments;
43
+ }
@@ -0,0 +1,101 @@
1
+ import { type GridClipboardCell, type GridPasteSource } from "./clipboard-model.js";
2
+ import { type ListSettingsConfig } from "../../model/column-capabilities.js";
3
+ import { type ViewsMessageResolver } from "../../contract.js";
4
+ import type { FieldConventions } from "@viewkitjs/fields";
5
+ import type { ListColumn } from "../../model/column-schema.js";
6
+ import { type GridCellPos, type GridCellRect } from "./coordinates.js";
7
+ import { type GridCellRange } from "./range-model.js";
8
+ import type { GridEditCell } from "./editing-model.js";
9
+ /**
10
+ * The visible grid, as these operations see it.
11
+ *
12
+ * TWO IDENTITIES, and keeping them apart is the whole reason this type carries
13
+ * a map rather than a row list. A row can be RENDERED more than once — grouping
14
+ * by a multi-value column (tags) puts it under each of its values — so:
15
+ *
16
+ * - `visibleRowIds` holds a row KEY per rendered row, unique by construction,
17
+ * and every position in this module (rects, anchors, heads) is in terms of
18
+ * it. That is what makes "the third row on screen" mean one thing.
19
+ * - `rowId` inside `rowByKey` is the DATA id, shared by every instance of the
20
+ * same row. Commits, the optimistic overlay and selection use that one, so
21
+ * editing a row under one tag repaints it under the other.
22
+ *
23
+ * Collapse the two and a duplicated row breaks both ways at once: positions
24
+ * resolve to whichever copy comes first, and a write lands on a key no route
25
+ * knows.
26
+ */
27
+ export type GridSpreadsheetModel<Row> = {
28
+ /** Every rendered row, for deriving a column's option values. A row drawn
29
+ * under two groups appears twice; the derivation dedupes, so it costs
30
+ * nothing and stays honest about what is on screen. */
31
+ rows: readonly Row[];
32
+ /** Row key → the rendered row and the DATA id behind it. */
33
+ rowByKey: ReadonlyMap<string, {
34
+ row: Row;
35
+ rowId: string;
36
+ }>;
37
+ /** Row KEYS in render order. */
38
+ visibleRowIds: readonly string[];
39
+ visibleColumns: readonly ListColumn<Row>[];
40
+ /** Keyed by DATA id — an overlay belongs to the row, not to one copy of it. */
41
+ pendingByRow: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
42
+ /** The app's conventions (the provider's): a paste reads numbers and dates in them. */
43
+ conventions: FieldConventions;
44
+ /** The app's words (the provider's): a refused paste says why in them. */
45
+ messages?: ViewsMessageResolver;
46
+ /** The list's settings (the grid's `listConfig`): a column they lock takes no write from a
47
+ * clear, a paste or a fill, and is refused in the sentence an edit of one cell says. */
48
+ listConfig?: ListSettingsConfig;
49
+ };
50
+ type GridPlannedEdit<Row> = GridEditCell<Row> & {
51
+ row: Row;
52
+ };
53
+ /** The cells a paste or a fill refused for one reason, the reason in the app's words. */
54
+ export type GridRefusal = {
55
+ reason: string;
56
+ count: number;
57
+ };
58
+ export declare function buildGridCopyMatrix<Row>(model: GridSpreadsheetModel<Row>, rect: GridCellRect): GridClipboardCell[][];
59
+ /** Does the rect hold a column that may be emptied, by its declaration? The list's locks are
60
+ * not asked here: a rect of only locked columns plans a clear, and the plan says the lock,
61
+ * rather than "the fields are required". */
62
+ export declare function gridRectHasClearable<Row>(columns: readonly ListColumn<Row>[], rect: GridCellRect): boolean;
63
+ type GridClearPlan<Row> = {
64
+ edits: GridPlannedEdit<Row>[];
65
+ /** The cells the list's locks refused, one entry per locked column. A column that can't be
66
+ * written or emptied by its declaration is passed over without a word, as it always was. */
67
+ refusals: GridRefusal[];
68
+ /** The fields the clear left as they were because they can't be empty: each writable, unlocked column of the
69
+ * selection that isn't clearable and holds a value in at least one of its rows, by label, in column order. */
70
+ required: string[];
71
+ };
72
+ export declare function planGridClear<Row>(model: GridSpreadsheetModel<Row>, rect: GridCellRect): GridClearPlan<Row>;
73
+ type GridPastePlan<Row> = {
74
+ edits: GridPlannedEdit<Row>[];
75
+ skipped: number;
76
+ /** Why the skipped cells were refused, one entry per reason. */
77
+ refusals: GridRefusal[];
78
+ targetCount: number;
79
+ /** Successful matrix extent; absent for scalar-repeat and empty plans. */
80
+ selection: {
81
+ anchor: GridCellPos;
82
+ head: GridCellPos;
83
+ } | null;
84
+ };
85
+ export declare function planGridPaste<Row>(model: GridSpreadsheetModel<Row>, matrix: readonly (readonly GridPasteSource[])[], anchor: {
86
+ rowIdx: number;
87
+ colIdx: number;
88
+ }, activeRect: GridCellRect | null, selectValuesByColumn: Readonly<Record<string, readonly string[]>>): GridPastePlan<Row>;
89
+ export declare function extendGridFillPreview(ranges: readonly GridCellRange[], targetRowId: string | null, visibleRowIds: readonly string[], visibleColIds: readonly string[]): GridCellRange[];
90
+ type GridFillPlan<Row> = {
91
+ edits: GridPlannedEdit<Row>[];
92
+ selectionHead: GridCellPos | null;
93
+ /** Target cells the fill refused (an amount into a record in another currency). */
94
+ skipped: number;
95
+ /** Why the skipped cells were refused, one entry per reason. */
96
+ refusals: GridRefusal[];
97
+ /** The cells the fill reached: the target rows across the source's columns. */
98
+ targetCount: number;
99
+ };
100
+ export declare function planGridFill<Row>(model: GridSpreadsheetModel<Row>, ranges: readonly GridCellRange[], focused: GridCellPos | null, targetRowId: string): GridFillPlan<Row>;
101
+ export {};