@viewkitjs/views 0.5.0 → 0.6.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 (413) hide show
  1. package/CHANGELOG.md +620 -0
  2. package/README.md +4 -2
  3. package/dist/atoms/Avatar.d.ts +2 -0
  4. package/dist/atoms/Avatar.js +13 -0
  5. package/dist/atoms/CellMore.d.ts +2 -0
  6. package/dist/atoms/CellMore.js +4 -0
  7. package/dist/atoms/DisabledReason.d.ts +11 -0
  8. package/dist/atoms/DisabledReason.js +10 -0
  9. package/dist/atoms/DrillRows.d.ts +2 -2
  10. package/dist/atoms/DrillRows.js +7 -5
  11. package/dist/atoms/Loading.d.ts +6 -0
  12. package/dist/atoms/Loading.js +4 -1
  13. package/dist/atoms/PanelRows.js +3 -5
  14. package/dist/atoms/Pill.d.ts +2 -0
  15. package/dist/atoms/Pill.js +25 -0
  16. package/dist/atoms/RangeCalendar.d.ts +8 -0
  17. package/dist/atoms/RangeCalendar.js +30 -0
  18. package/dist/atoms/RelationRoles.js +2 -2
  19. package/dist/atoms/SelectionSheet.js +5 -4
  20. package/dist/atoms/ToolbarButton.d.ts +2 -0
  21. package/dist/atoms/ToolbarButton.js +18 -0
  22. package/dist/atoms/defaults.js +10 -0
  23. package/dist/atoms/types.d.ts +141 -1
  24. package/dist/cells/cell-format.d.ts +10 -1
  25. package/dist/cells/cell-title.d.ts +5 -1
  26. package/dist/cells/cell-title.js +2 -2
  27. package/dist/cells/cell-values.js +22 -7
  28. package/dist/cells/relation-wrap.js +1 -1
  29. package/dist/contract.d.ts +351 -15
  30. package/dist/contract.js +482 -4
  31. package/dist/display/actor.js +1 -1
  32. package/dist/display/boolean.js +5 -0
  33. package/dist/display/entity-chip.d.ts +12 -9
  34. package/dist/display/entity-chip.js +4 -5
  35. package/dist/display/fit-values.d.ts +34 -0
  36. package/dist/display/fit-values.js +45 -0
  37. package/dist/display/location.js +1 -1
  38. package/dist/display/multi-value.js +72 -8
  39. package/dist/display/options.d.ts +9 -1
  40. package/dist/display/relation.js +1 -1
  41. package/dist/display/rich-text.js +17 -6
  42. package/dist/display/select.js +6 -4
  43. package/dist/display/status-steps.d.ts +8 -0
  44. package/dist/display/status-steps.js +18 -0
  45. package/dist/display/viewer.js +1 -0
  46. package/dist/editors/BodyFrame.d.ts +29 -0
  47. package/dist/editors/BodyFrame.js +80 -0
  48. package/dist/editors/DateEditor.js +13 -17
  49. package/dist/editors/LocationEditor.d.ts +2 -0
  50. package/dist/editors/LocationEditor.js +29 -5
  51. package/dist/editors/NameEditor.d.ts +2 -0
  52. package/dist/editors/NameEditor.js +27 -7
  53. package/dist/editors/NumberEditor.d.ts +18 -0
  54. package/dist/editors/NumberEditor.js +29 -2
  55. package/dist/editors/RangeEditor.d.ts +2 -0
  56. package/dist/editors/RangeEditor.js +29 -4
  57. package/dist/editors/SelectEditor.d.ts +5 -0
  58. package/dist/editors/SelectEditor.js +3 -2
  59. package/dist/editors/TextEditor.d.ts +11 -1
  60. package/dist/editors/TextEditor.js +25 -8
  61. package/dist/editors/ValueListEditor.d.ts +7 -0
  62. package/dist/editors/ValueListEditor.js +60 -48
  63. package/dist/editors/body-panel.d.ts +7 -0
  64. package/dist/editors/body-panel.js +8 -0
  65. package/dist/editors/edit-session.d.ts +20 -3
  66. package/dist/editors/edit-session.js +43 -3
  67. package/dist/editors/leave-scope.d.ts +23 -0
  68. package/dist/editors/leave-scope.js +28 -0
  69. package/dist/editors/number-body.d.ts +29 -0
  70. package/dist/editors/number-body.js +37 -0
  71. package/dist/editors/parts-body.d.ts +66 -0
  72. package/dist/editors/parts-body.js +114 -0
  73. package/dist/editors/tab-ends.d.ts +5 -0
  74. package/dist/editors/tab-ends.js +7 -0
  75. package/dist/editors/text-body.d.ts +16 -0
  76. package/dist/editors/text-body.js +30 -0
  77. package/dist/editors/values-body.d.ts +47 -0
  78. package/dist/editors/values-body.js +140 -0
  79. package/dist/field-row/FieldRow.d.ts +7 -0
  80. package/dist/field-row/FieldRow.js +44 -24
  81. package/dist/field-row/FieldRowLane.js +12 -4
  82. package/dist/field-row/editors/RowChipsEditor.js +3 -1
  83. package/dist/field-row/editors/RowEditor.js +2 -1
  84. package/dist/field-row/editors/RowNameEditor.d.ts +5 -2
  85. package/dist/field-row/editors/RowNameEditor.js +12 -5
  86. package/dist/field-row/editors/RowNumberEditor.js +18 -2
  87. package/dist/field-row/editors/RowPlaceEditor.js +4 -2
  88. package/dist/field-row/editors/RowRangeEditor.d.ts +5 -2
  89. package/dist/field-row/editors/RowRangeEditor.js +13 -6
  90. package/dist/field-row/editors/RowRelationEditor.js +5 -2
  91. package/dist/field-row/editors/RowSelectEditor.js +4 -1
  92. package/dist/field-row/editors/RowTextEditor.d.ts +1 -1
  93. package/dist/field-row/editors/RowTextEditor.js +12 -3
  94. package/dist/field-row/editors/RowValueListEditor.d.ts +2 -1
  95. package/dist/field-row/editors/RowValueListEditor.js +17 -4
  96. package/dist/field-row/editors/host.d.ts +3 -0
  97. package/dist/field-row/editors/row-session.d.ts +12 -1
  98. package/dist/field-row/editors/row-session.js +52 -2
  99. package/dist/field-row/field-row-button.d.ts +40 -0
  100. package/dist/field-row/field-row-button.js +18 -0
  101. package/dist/field-row/field-row-checkbox.d.ts +9 -0
  102. package/dist/field-row/field-row-checkbox.js +7 -0
  103. package/dist/filters/filter-model.d.ts +2 -0
  104. package/dist/grid/chrome/GridAddColumn.js +17 -3
  105. package/dist/grid/chrome/GridAggregateMenu.d.ts +2 -0
  106. package/dist/grid/chrome/GridAggregateMenu.js +2 -0
  107. package/dist/grid/chrome/GridCellEditors.js +16 -6
  108. package/dist/grid/chrome/GridCellOutline.d.ts +7 -4
  109. package/dist/grid/chrome/GridCellOutline.js +4 -2
  110. package/dist/grid/chrome/GridChipsEditor.js +3 -1
  111. package/dist/grid/chrome/GridColumnMenu.d.ts +4 -1
  112. package/dist/grid/chrome/GridColumnMenu.js +5 -3
  113. package/dist/grid/chrome/GridColumnSortSection.d.ts +20 -0
  114. package/dist/grid/chrome/GridColumnSortSection.js +18 -1
  115. package/dist/grid/chrome/GridFooter.d.ts +4 -1
  116. package/dist/grid/chrome/GridFooter.js +6 -4
  117. package/dist/grid/chrome/GridGroupMenu.d.ts +5 -1
  118. package/dist/grid/chrome/GridGroupMenu.js +30 -8
  119. package/dist/grid/chrome/GridHeader.d.ts +5 -1
  120. package/dist/grid/chrome/GridHeader.js +9 -5
  121. package/dist/grid/chrome/GridLongTextEditor.js +15 -11
  122. package/dist/grid/chrome/GridNameEditor.js +4 -2
  123. package/dist/grid/chrome/GridNumberEditor.d.ts +8 -1
  124. package/dist/grid/chrome/GridNumberEditor.js +15 -3
  125. package/dist/grid/chrome/GridPager.d.ts +7 -0
  126. package/dist/grid/chrome/GridPager.js +34 -0
  127. package/dist/grid/chrome/GridPlaceEditor.js +4 -2
  128. package/dist/grid/chrome/GridRangeEditor.js +12 -4
  129. package/dist/grid/chrome/GridRelationEditor.js +5 -2
  130. package/dist/grid/chrome/GridRow.js +18 -6
  131. package/dist/grid/chrome/GridRowActions.d.ts +8 -3
  132. package/dist/grid/chrome/GridRowActions.js +16 -6
  133. package/dist/grid/chrome/GridRowCells.js +23 -7
  134. package/dist/grid/chrome/GridRowGlyph.d.ts +3 -1
  135. package/dist/grid/chrome/GridRowGlyph.js +7 -2
  136. package/dist/grid/chrome/GridSelectEditor.js +6 -3
  137. package/dist/grid/chrome/GridStructure.d.ts +6 -1
  138. package/dist/grid/chrome/GridStructure.js +32 -8
  139. package/dist/grid/chrome/GridTable.js +36 -24
  140. package/dist/grid/chrome/GridTableSurface.d.ts +5 -1
  141. package/dist/grid/chrome/GridTableSurface.js +5 -2
  142. package/dist/grid/chrome/GridTextEditor.d.ts +5 -1
  143. package/dist/grid/chrome/GridTextEditor.js +13 -3
  144. package/dist/grid/chrome/GridValueListEditor.d.ts +12 -4
  145. package/dist/grid/chrome/GridValueListEditor.js +11 -3
  146. package/dist/grid/chrome/StuckMarker.d.ts +3 -1
  147. package/dist/grid/chrome/StuckMarker.js +6 -2
  148. package/dist/grid/chrome/cells.d.ts +4 -2
  149. package/dist/grid/chrome/cells.js +2 -2
  150. package/dist/grid/chrome/grid-add-column-items.d.ts +1 -1
  151. package/dist/grid/chrome/grid-add-column-items.js +8 -1
  152. package/dist/grid/chrome/grid-button.d.ts +32 -0
  153. package/dist/grid/chrome/grid-button.js +12 -0
  154. package/dist/grid/chrome/grid-cell-classes.d.ts +38 -0
  155. package/dist/grid/chrome/grid-cell-classes.js +30 -0
  156. package/dist/grid/chrome/grid-column-menu-items.d.ts +3 -0
  157. package/dist/grid/chrome/grid-column-menu-items.js +32 -3
  158. package/dist/grid/chrome/grid-columns-template.d.ts +27 -0
  159. package/dist/grid/chrome/grid-columns-template.js +13 -0
  160. package/dist/grid/chrome/grid-edit-session.d.ts +4 -1
  161. package/dist/grid/chrome/grid-edit-session.js +11 -1
  162. package/dist/grid/chrome/grid-group-menu-items.d.ts +8 -1
  163. package/dist/grid/chrome/grid-group-menu-items.js +17 -0
  164. package/dist/grid/chrome/grid-group-menu-parts.d.ts +10 -6
  165. package/dist/grid/chrome/grid-group-menu-parts.js +4 -2
  166. package/dist/grid/chrome/grid-hover.d.ts +4 -1
  167. package/dist/grid/chrome/grid-hover.js +16 -6
  168. package/dist/grid/chrome/grid-pages.d.ts +15 -0
  169. package/dist/grid/chrome/grid-pages.js +9 -0
  170. package/dist/grid/chrome/grid-row-menu-items.js +18 -10
  171. package/dist/grid/chrome/grid-row-props.d.ts +6 -2
  172. package/dist/grid/chrome/grid-row-window.d.ts +7 -0
  173. package/dist/grid/chrome/grid-row-window.js +35 -1
  174. package/dist/grid/chrome/grid-table-props.d.ts +38 -4
  175. package/dist/grid/chrome/useGridColumnLayout.d.ts +3 -1
  176. package/dist/grid/chrome/useGridColumnLayout.js +29 -9
  177. package/dist/grid/chrome/useGridPartColumns.js +1 -1
  178. package/dist/grid/chrome/useGridScrollArea.js +2 -0
  179. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +1 -0
  180. package/dist/grid/chrome/useGridTableInteractionModel.js +5 -3
  181. package/dist/grid/chrome/useGridTableSelection.d.ts +3 -1
  182. package/dist/grid/chrome/useGridTableSelection.js +2 -2
  183. package/dist/grid/chrome/useHeaderDragReorder.js +2 -0
  184. package/dist/grid/core/editing-controller.d.ts +36 -11
  185. package/dist/grid/core/editing-controller.js +92 -25
  186. package/dist/grid/core/grid-aria.d.ts +4 -0
  187. package/dist/grid/core/grid-aria.js +6 -4
  188. package/dist/grid/core/grid-focus.d.ts +6 -0
  189. package/dist/grid/core/grid-focus.js +28 -5
  190. package/dist/grid/core/useGridEditing.d.ts +11 -2
  191. package/dist/grid/core/useGridEditing.js +9 -5
  192. package/dist/grid/core/write-states.d.ts +20 -0
  193. package/dist/grid/core/write-states.js +21 -0
  194. package/dist/grid/grid-format-props.d.ts +26 -0
  195. package/dist/grid/grid-format-props.js +65 -0
  196. package/dist/grid/index.d.ts +3 -1
  197. package/dist/grid/index.js +1 -0
  198. package/dist/grid/useGridTablePrefs.d.ts +19 -20
  199. package/dist/grid/useGridTablePrefs.js +6 -58
  200. package/dist/grid/useGridTableSettings.d.ts +60 -0
  201. package/dist/grid/useGridTableSettings.js +61 -0
  202. package/dist/internal/count.d.ts +3 -0
  203. package/dist/internal/count.js +3 -0
  204. package/dist/model/body-frame.d.ts +16 -0
  205. package/dist/model/body-frame.js +5 -0
  206. package/dist/model/column-capabilities.d.ts +4 -1
  207. package/dist/model/column-capabilities.js +4 -1
  208. package/dist/model/column-filters.d.ts +7 -4
  209. package/dist/model/column-filters.js +26 -18
  210. package/dist/model/column-inspect.d.ts +3 -2
  211. package/dist/model/column-inspect.js +3 -1
  212. package/dist/model/column-sort.d.ts +11 -0
  213. package/dist/model/column-sort.js +14 -0
  214. package/dist/model/one-value.d.ts +6 -0
  215. package/dist/model/one-value.js +5 -0
  216. package/dist/model/part-write.js +1 -1
  217. package/dist/model/place-parts.d.ts +6 -0
  218. package/dist/model/place-parts.js +14 -0
  219. package/dist/model/relation-filters.d.ts +13 -2
  220. package/dist/model/relation-filters.js +9 -4
  221. package/dist/model/row-icon.d.ts +16 -6
  222. package/dist/model/settings-columns.d.ts +34 -0
  223. package/dist/model/settings-columns.js +146 -0
  224. package/dist/model/settings-look.d.ts +17 -0
  225. package/dist/model/settings-look.js +23 -0
  226. package/dist/model/view-rules.js +6 -2
  227. package/dist/panels/availability.d.ts +26 -0
  228. package/dist/panels/availability.js +28 -0
  229. package/dist/panels/filter/DateFilterBody.d.ts +42 -0
  230. package/dist/panels/filter/DateFilterBody.js +64 -0
  231. package/dist/panels/filter/DateFilterCalendar.d.ts +19 -0
  232. package/dist/panels/filter/DateFilterCalendar.js +37 -0
  233. package/dist/panels/filter/DateFilterInput.d.ts +16 -0
  234. package/dist/panels/filter/DateFilterInput.js +37 -0
  235. package/dist/panels/filter/FilterIcon.d.ts +7 -0
  236. package/dist/panels/filter/FilterIcon.js +15 -0
  237. package/dist/panels/filter/MenuSelect.d.ts +12 -0
  238. package/dist/panels/filter/MenuSelect.js +34 -0
  239. package/dist/panels/filter/NumberFilterBody.d.ts +21 -0
  240. package/dist/panels/filter/NumberFilterBody.js +76 -0
  241. package/dist/panels/filter/RangeFilterBody.d.ts +19 -0
  242. package/dist/panels/filter/RangeFilterBody.js +71 -0
  243. package/dist/panels/filter/RelationFilterBody.d.ts +17 -0
  244. package/dist/panels/filter/RelationFilterBody.js +20 -0
  245. package/dist/panels/filter/TextFilterBody.d.ts +31 -0
  246. package/dist/panels/filter/TextFilterBody.js +44 -0
  247. package/dist/panels/filter/TimeScopeDetail.d.ts +6 -0
  248. package/dist/panels/filter/TimeScopeDetail.js +47 -0
  249. package/dist/panels/filter/details.d.ts +17 -0
  250. package/dist/panels/filter/details.js +73 -0
  251. package/dist/panels/filter/filter-list.d.ts +23 -0
  252. package/dist/panels/filter/filter-list.js +38 -0
  253. package/dist/panels/group-sort.d.ts +24 -0
  254. package/dist/panels/group-sort.js +58 -0
  255. package/dist/panels/index.d.ts +24 -0
  256. package/dist/panels/index.js +17 -0
  257. package/dist/panels/labels.d.ts +37 -0
  258. package/dist/panels/labels.js +166 -0
  259. package/dist/panels/model.d.ts +343 -0
  260. package/dist/panels/model.js +77 -0
  261. package/dist/panels/react/GroupBucketsList.d.ts +16 -0
  262. package/dist/panels/react/GroupBucketsList.js +38 -0
  263. package/dist/panels/react/LayoutColumnsList.d.ts +24 -0
  264. package/dist/panels/react/LayoutColumnsList.js +71 -0
  265. package/dist/panels/react/PopoverColumnDetail.d.ts +11 -0
  266. package/dist/panels/react/PopoverColumnDetail.js +24 -0
  267. package/dist/panels/react/chrome.d.ts +17 -0
  268. package/dist/panels/react/chrome.js +8 -0
  269. package/dist/panels/react/column-refusals.d.ts +7 -0
  270. package/dist/panels/react/column-refusals.js +14 -0
  271. package/dist/panels/react/customize.d.ts +26 -0
  272. package/dist/panels/react/customize.js +98 -0
  273. package/dist/panels/react/drag.d.ts +2 -0
  274. package/dist/panels/react/drag.js +6 -0
  275. package/dist/panels/react/field-editor.d.ts +10 -0
  276. package/dist/panels/react/field-editor.js +1 -0
  277. package/dist/panels/react/filter-panel.d.ts +15 -0
  278. package/dist/panels/react/filter-panel.js +48 -0
  279. package/dist/panels/react/layout-detail.d.ts +4 -0
  280. package/dist/panels/react/layout-detail.js +21 -0
  281. package/dist/panels/react/order-details.d.ts +32 -0
  282. package/dist/panels/react/order-details.js +81 -0
  283. package/dist/panels/react/panel-header.d.ts +10 -0
  284. package/dist/panels/react/panel-header.js +12 -0
  285. package/dist/panels/react/panel-sheet.d.ts +19 -0
  286. package/dist/panels/react/panel-sheet.js +22 -0
  287. package/dist/panels/react/popover.d.ts +71 -0
  288. package/dist/panels/react/popover.js +47 -0
  289. package/dist/panels/react/root-list.d.ts +6 -0
  290. package/dist/panels/react/root-list.js +31 -0
  291. package/dist/panels/react/toolbar/ReadyToolbar.d.ts +42 -0
  292. package/dist/panels/react/toolbar/ReadyToolbar.js +92 -0
  293. package/dist/panels/react/toolbar/Toolbar.d.ts +16 -0
  294. package/dist/panels/react/toolbar/Toolbar.js +34 -0
  295. package/dist/panels/react/toolbar/ToolbarButton.d.ts +5 -0
  296. package/dist/panels/react/toolbar/ToolbarButton.js +9 -0
  297. package/dist/panels/react/toolbar/ToolbarFilter.d.ts +19 -0
  298. package/dist/panels/react/toolbar/ToolbarFilter.js +32 -0
  299. package/dist/panels/react/toolbar/ToolbarNew.d.ts +12 -0
  300. package/dist/panels/react/toolbar/ToolbarNew.js +21 -0
  301. package/dist/panels/react/toolbar/ToolbarOptions.d.ts +25 -0
  302. package/dist/panels/react/toolbar/ToolbarOptions.js +33 -0
  303. package/dist/panels/react/toolbar/ToolbarSearch.d.ts +9 -0
  304. package/dist/panels/react/toolbar/ToolbarSearch.js +41 -0
  305. package/dist/panels/react/toolbar/ToolbarSort.d.ts +12 -0
  306. package/dist/panels/react/toolbar/ToolbarSort.js +16 -0
  307. package/dist/panels/react/toolbar/ToolbarViews.d.ts +13 -0
  308. package/dist/panels/react/toolbar/ToolbarViews.js +24 -0
  309. package/dist/panels/react/toolbar/context.d.ts +29 -0
  310. package/dist/panels/react/toolbar/context.js +49 -0
  311. package/dist/panels/react/toolbar/panel-part.d.ts +37 -0
  312. package/dist/panels/react/toolbar/panel-part.js +37 -0
  313. package/dist/panels/react/toolbar/panel-state.d.ts +9 -0
  314. package/dist/panels/react/toolbar/panel-state.js +12 -0
  315. package/dist/panels/react/toolbar/use-box-narrow.d.ts +2 -0
  316. package/dist/panels/react/toolbar/use-box-narrow.js +18 -0
  317. package/dist/panels/react/toolbar/use-list-settings-state.d.ts +10 -0
  318. package/dist/panels/react/toolbar/use-list-settings-state.js +10 -0
  319. package/dist/panels/react/view-actions.d.ts +4 -0
  320. package/dist/panels/react/view-actions.js +37 -0
  321. package/dist/panels/react/view-footer.d.ts +16 -0
  322. package/dist/panels/react/view-footer.js +11 -0
  323. package/dist/panels/react/views-row/FoldingViewRow.d.ts +4 -0
  324. package/dist/panels/react/views-row/FoldingViewRow.js +105 -0
  325. package/dist/panels/react/views-row/HScrollRow.d.ts +7 -0
  326. package/dist/panels/react/views-row/HScrollRow.js +42 -0
  327. package/dist/panels/react/views-row/PillGroup.d.ts +30 -0
  328. package/dist/panels/react/views-row/PillGroup.js +86 -0
  329. package/dist/panels/react/views-row/ViewAxes.d.ts +6 -0
  330. package/dist/panels/react/views-row/ViewAxes.js +16 -0
  331. package/dist/panels/react/views-row/ViewCreatePill.d.ts +7 -0
  332. package/dist/panels/react/views-row/ViewCreatePill.js +11 -0
  333. package/dist/panels/react/views-row/ViewPicker.d.ts +5 -0
  334. package/dist/panels/react/views-row/ViewPicker.js +65 -0
  335. package/dist/panels/react/views-row/ViewPickerRow.d.ts +7 -0
  336. package/dist/panels/react/views-row/ViewPickerRow.js +18 -0
  337. package/dist/panels/react/views-row/ViewTabs.d.ts +31 -0
  338. package/dist/panels/react/views-row/ViewTabs.js +29 -0
  339. package/dist/panels/react/views-row/menu-classes.d.ts +6 -0
  340. package/dist/panels/react/views-row/menu-classes.js +3 -0
  341. package/dist/panels/react/views-row/use-anchored-toggle.d.ts +19 -0
  342. package/dist/panels/react/views-row/use-anchored-toggle.js +31 -0
  343. package/dist/panels/react.d.ts +51 -0
  344. package/dist/panels/react.js +43 -0
  345. package/dist/panels/settings/axes.d.ts +28 -0
  346. package/dist/panels/settings/axes.js +71 -0
  347. package/dist/panels/settings/filters.d.ts +5 -0
  348. package/dist/panels/settings/filters.js +62 -0
  349. package/dist/panels/settings/group-buckets.d.ts +23 -0
  350. package/dist/panels/settings/group-buckets.js +73 -0
  351. package/dist/panels/settings/input.d.ts +69 -0
  352. package/dist/panels/settings/input.js +1 -0
  353. package/dist/panels/settings/layout.d.ts +5 -0
  354. package/dist/panels/settings/layout.js +244 -0
  355. package/dist/panels/settings/order.d.ts +19 -0
  356. package/dist/panels/settings/order.js +271 -0
  357. package/dist/panels/settings/settings-panels.d.ts +17 -0
  358. package/dist/panels/settings/settings-panels.js +28 -0
  359. package/dist/panels/toolbar/clear.d.ts +9 -0
  360. package/dist/panels/toolbar/clear.js +26 -0
  361. package/dist/panels/toolbar/counts.d.ts +15 -0
  362. package/dist/panels/toolbar/counts.js +21 -0
  363. package/dist/panels/toolbar/edit-view.d.ts +5 -0
  364. package/dist/panels/toolbar/edit-view.js +18 -0
  365. package/dist/panels/toolbar/model.d.ts +34 -0
  366. package/dist/panels/toolbar/model.js +52 -0
  367. package/dist/panels/use-filter-opened.d.ts +8 -0
  368. package/dist/panels/use-filter-opened.js +11 -0
  369. package/dist/panels/view-state.d.ts +38 -0
  370. package/dist/panels/view-state.js +1 -0
  371. package/dist/panels/views-row/model.d.ts +131 -0
  372. package/dist/panels/views-row/model.js +14 -0
  373. package/dist/provider/ViewsProvider.d.ts +46 -6
  374. package/dist/provider/ViewsProvider.js +32 -2
  375. package/dist/provider/components.d.ts +258 -11
  376. package/dist/provider/context.d.ts +21 -2
  377. package/dist/react.d.ts +5 -2
  378. package/dist/selection/SelectionBar.js +13 -7
  379. package/dist/selection/bar-overflow.js +14 -1
  380. package/dist/selection/bar-parts.d.ts +4 -2
  381. package/dist/selection/bar-parts.js +5 -3
  382. package/dist/selection/useListSelectionShortcuts.d.ts +3 -2
  383. package/dist/selection/useListSelectionShortcuts.js +1 -1
  384. package/dist/selection/verbs.d.ts +7 -0
  385. package/docs/contract.md +307 -41
  386. package/docs/getting-started.md +1 -1
  387. package/docs/guides/atoms.md +37 -5
  388. package/docs/guides/columns.md +1 -1
  389. package/docs/guides/display.md +3 -2
  390. package/docs/guides/editors.md +4 -3
  391. package/docs/guides/selection.md +4 -2
  392. package/docs/guides/the-grid.md +21 -11
  393. package/docs/guides/the-provider.md +22 -6
  394. package/docs/index.md +2 -2
  395. package/docs/install.md +2 -3
  396. package/docs/reference/cells.md +1 -1
  397. package/docs/reference/display.md +5 -4
  398. package/docs/reference/editors-location.md +3 -1
  399. package/docs/reference/editors-name.md +3 -1
  400. package/docs/reference/editors-number.md +1 -0
  401. package/docs/reference/editors-range.md +3 -1
  402. package/docs/reference/editors-session.md +1 -0
  403. package/docs/reference/editors-text.md +2 -2
  404. package/docs/reference/editors-value-list.md +1 -1
  405. package/docs/reference/field-row.md +2 -2
  406. package/docs/reference/grid.md +8 -5
  407. package/docs/reference/panels-react.md +101 -0
  408. package/docs/reference/panels.md +123 -0
  409. package/docs/reference/react.md +39 -16
  410. package/docs/reference/selection.md +5 -5
  411. package/docs/reference/views.md +17 -12
  412. package/package.json +16 -6
  413. package/skills/views/SKILL.md +4 -3
@@ -0,0 +1,271 @@
1
+ import { isOpenVocabulary, looksAhead, presentedDef, relationSortBy, valueTypeOf, } from "@viewkitjs/fields";
2
+ import { settingsChange, } from "@viewkitjs/fields/query";
3
+ import { resolveViewsMessage } from "../../contract.js";
4
+ import { columnLabel } from "../../model/column-capabilities.js";
5
+ import { groupableColumns, sortableColumns, sortDirFor } from "../../model/column-order.js";
6
+ import { columnSortParts, effectiveSortKey } from "../../model/column-sort.js";
7
+ import { parsePartKey, partKey, partLabel } from "../../model/part-rows.js";
8
+ import { groupOrderFor } from "../model.js";
9
+ import { groupEntries, withAllGroupsVisible, withGroupOrder, withGroupVisible, withManualOrder, } from "./group-buckets.js";
10
+ const MANUAL = "manual";
11
+ const GRANULARITIES = new Set([
12
+ "relative",
13
+ "due",
14
+ "day",
15
+ "week",
16
+ "month",
17
+ "year",
18
+ ]);
19
+ function liveSorts(sorts) {
20
+ return sorts.some((sort) => sort.setAside) ? sorts.filter((sort) => !sort.setAside) : sorts;
21
+ }
22
+ function groupHidesEmpty(group) {
23
+ return group.hideEmpty !== false;
24
+ }
25
+ function liveGroup(group) {
26
+ return group?.setAside ? null : group;
27
+ }
28
+ function keepSetAsideSorts(next, stored) {
29
+ const kept = stored.filter((sort) => sort.setAside && !next.some((n) => n.fieldKey === sort.fieldKey));
30
+ return [...next, ...kept].slice(0, Math.max(3, next.length));
31
+ }
32
+ function write(input, next) {
33
+ const change = settingsChange(input.settings, next);
34
+ if (Object.keys(change).length > 0)
35
+ input.onChange(change);
36
+ }
37
+ function sortOptionsFrom(columns, messages) {
38
+ const whole = new Map(sortableColumns(columns).map((entry) => [entry.column, entry.key]));
39
+ const seen = new Set();
40
+ return columns.flatMap((column) => {
41
+ const field = column.field;
42
+ if (!field)
43
+ return [];
44
+ const key = whole.get(column);
45
+ const own = key ? [{ value: key, label: columnLabel(column), defaultDir: sortDirFor(field) }] : [];
46
+ const parts = columnSortParts(column, true)
47
+ .map((part) => ({
48
+ value: partKey(field.key, part),
49
+ label: partLabel(columnLabel(column), "location", part, messages),
50
+ defaultDir: "asc",
51
+ }))
52
+ .filter((option) => !seen.has(option.value) && !!seen.add(option.value));
53
+ return [...own, ...parts];
54
+ });
55
+ }
56
+ function placeSortsBy(columns, fieldKey, part) {
57
+ return columns.some((column) => column.field?.key === fieldKey && columnSortParts(column, true).includes(part));
58
+ }
59
+ export function settingsSort(input) {
60
+ const { settings, columns } = input;
61
+ const messages = input.resolve ?? resolveViewsMessage;
62
+ const first = liveSorts(settings.sorts)[0];
63
+ const sortKeyOf = (fieldKey, by) => {
64
+ if (by !== undefined && placeSortsBy(columns, fieldKey, by))
65
+ return partKey(fieldKey, by);
66
+ const column = columns.find((candidate) => candidate.field?.key === fieldKey);
67
+ return column ? effectiveSortKey(column, true) : undefined;
68
+ };
69
+ const fieldOf = (sortKey) => columns.find((column) => effectiveSortKey(column, true) === sortKey)?.field?.key;
70
+ const manual = !!input.manualOrder && settings.rowOrderMode === MANUAL;
71
+ const value = manual ? MANUAL : ((first ? sortKeyOf(first.fieldKey, first.by) : undefined) ?? "");
72
+ const base = input.sortOptions ? [...input.sortOptions] : sortOptionsFrom(columns, messages);
73
+ const picked = value && value !== MANUAL && !base.some((option) => option.value === value)
74
+ ? sortOptionsFrom(columns, messages).find((option) => option.value === value)
75
+ : undefined;
76
+ const fields = picked ? [...base, picked] : base;
77
+ const options = input.manualOrder
78
+ ? [
79
+ {
80
+ value: MANUAL,
81
+ label: messages({ key: "views.panels.sort-manual" }),
82
+ defaultDir: "asc",
83
+ },
84
+ ...fields,
85
+ ]
86
+ : fields;
87
+ return {
88
+ options,
89
+ value,
90
+ dir: manual ? "asc" : (first?.direction ?? "asc"),
91
+ defaultValue: input.defaultSort ?? "",
92
+ onChange: ({ value: next, dir }) => {
93
+ if (next === MANUAL) {
94
+ write(input, { ...settings, rowOrderMode: MANUAL });
95
+ return;
96
+ }
97
+ const { id, part } = parsePartKey(next);
98
+ const byPart = !!next && part !== undefined && placeSortsBy(columns, id, part);
99
+ const fieldKey = byPart ? id : next ? fieldOf(next) : undefined;
100
+ const sorts = keepSetAsideSorts(fieldKey ? [{ fieldKey, direction: dir, ...(byPart && { by: part }) }] : [], settings.sorts);
101
+ write(input, {
102
+ ...settings,
103
+ ...(input.manualOrder && settings.rowOrderMode === MANUAL
104
+ ? { rowOrderMode: "fields" }
105
+ : {}),
106
+ sorts,
107
+ });
108
+ },
109
+ };
110
+ }
111
+ const DATE_GRANULARITIES = ["relative", "day", "week", "month", "year"];
112
+ export function groupDimensionFor(field, label, resolve = resolveViewsMessage) {
113
+ const base = { value: field.key, label, fieldKey: field.key };
114
+ const word = (key) => resolve({ key });
115
+ const lifecycle = {
116
+ value: "lifecycle",
117
+ label: word("views.panels.group-order-lifecycle"),
118
+ };
119
+ const count = { value: "count", label: word("views.panels.group-order-count") };
120
+ const name = { value: "name", label: word("views.panels.group-order-name") };
121
+ const type = valueTypeOf(field);
122
+ if (type === "date" || type === "datetime") {
123
+ const ahead = looksAhead(field);
124
+ const granularities = (ahead ? ["due", ...DATE_GRANULARITIES.slice(1)] : DATE_GRANULARITIES).map((value) => ({
125
+ value,
126
+ label: word(`views.panels.granularity-${value}`),
127
+ }));
128
+ return {
129
+ ...base,
130
+ orderOptions: [
131
+ {
132
+ value: "name",
133
+ label: word("views.panels.group-order-date"),
134
+ defaultDir: ahead ? "asc" : "desc",
135
+ },
136
+ count,
137
+ ],
138
+ defaultOrder: "name",
139
+ granularities,
140
+ defaultGranularity: ahead ? "due" : "relative",
141
+ };
142
+ }
143
+ if (type === "boolean")
144
+ return { ...base, orderOptions: [lifecycle, count], defaultOrder: "lifecycle" };
145
+ const declaresOptions = "options" in field && Array.isArray(field.options) && field.options.length > 0;
146
+ const open = isOpenVocabulary(presentedDef(field));
147
+ if (type === "status" ||
148
+ (type === "select" && !open) ||
149
+ (type === "multiselect" && declaresOptions) ||
150
+ relationSortBy(field)) {
151
+ return { ...base, orderOptions: [lifecycle, count, name], defaultOrder: "lifecycle" };
152
+ }
153
+ return { ...base, orderOptions: [count, name], defaultOrder: "name" };
154
+ }
155
+ function groupSpecOf(dimension) {
156
+ const granularity = dimension.defaultGranularity;
157
+ return {
158
+ fieldKey: dimension.fieldKey,
159
+ order: groupOrderFor(dimension),
160
+ ...(granularity && GRANULARITIES.has(granularity)
161
+ ? { granularity: granularity }
162
+ : {}),
163
+ hideEmpty: true,
164
+ buckets: [],
165
+ };
166
+ }
167
+ function dimensionsOf(input, group) {
168
+ const { columns } = input;
169
+ const resolve = input.resolve ?? resolveViewsMessage;
170
+ const listed = input.groupDimensions
171
+ ? [...input.groupDimensions]
172
+ : groupableColumns(columns).map((column) => groupDimensionFor(column.field, columnLabel(column), resolve));
173
+ if (!group || listed.some((dimension) => dimension.fieldKey === group.fieldKey))
174
+ return listed;
175
+ const column = columns.find((candidate) => candidate.field?.key === group.fieldKey);
176
+ return column?.field
177
+ ? [...listed, groupDimensionFor(column.field, columnLabel(column), resolve)]
178
+ : listed;
179
+ }
180
+ function groupVisibility(group, heads, setGroup) {
181
+ return {
182
+ hideEmpty: {
183
+ value: groupHidesEmpty(group),
184
+ onChange: (next) => setGroup({ ...group, hideEmpty: next }),
185
+ },
186
+ ...(heads.length > 0
187
+ ? {
188
+ groups: {
189
+ entries: groupEntries(heads, group),
190
+ onToggle: (key, visible) => setGroup(withGroupVisible(group, key, visible)),
191
+ onShowAll: () => setGroup(withAllGroupsVisible(group, heads, true)),
192
+ onHideAll: () => setGroup(withAllGroupsVisible(group, heads, false)),
193
+ onReorder: (keys) => setGroup(withManualOrder(group, keys)),
194
+ },
195
+ }
196
+ : {}),
197
+ };
198
+ }
199
+ export function settingsGroup(input) {
200
+ const { settings } = input;
201
+ const heads = input.groupHeads ?? [];
202
+ const group = liveGroup(settings.group);
203
+ const listed = dimensionsOf(input, group);
204
+ const active = group
205
+ ? listed.find((dimension) => dimension.fieldKey === group.fieldKey)
206
+ : undefined;
207
+ const validGranularity = (dimension, value) => value !== undefined &&
208
+ GRANULARITIES.has(value) &&
209
+ (dimension.granularities ?? []).some((choice) => choice.value === value)
210
+ ? value
211
+ : undefined;
212
+ const setGroup = (next) => write(input, { ...settings, group: next });
213
+ const granularity = active && group ? validGranularity(active, group.granularity) : undefined;
214
+ return {
215
+ dimensions: listed,
216
+ value: active?.value ?? "none",
217
+ order: active && group
218
+ ? { [active.value]: group.order }
219
+ : {},
220
+ ...(active && granularity ? { granularity: { [active.value]: granularity } } : {}),
221
+ onChange: ({ value, order, granularity: picked }) => {
222
+ if (value === "none")
223
+ return settings.group ? setGroup(null) : undefined;
224
+ const dimension = listed.find((candidate) => candidate.value === value);
225
+ if (!dimension)
226
+ return;
227
+ const nextGranularity = validGranularity(dimension, picked?.[value] ?? dimension.defaultGranularity);
228
+ const nextOrder = order[value] ?? groupOrderFor(dimension);
229
+ const same = group?.fieldKey === dimension.fieldKey;
230
+ const rekeyed = same &&
231
+ validGranularity(dimension, group.granularity ?? dimension.defaultGranularity) !==
232
+ nextGranularity;
233
+ const next = {
234
+ fieldKey: dimension.fieldKey,
235
+ order: nextOrder,
236
+ ...(nextGranularity &&
237
+ !(same && group.granularity === undefined && nextGranularity === validGranularity(dimension, dimension.defaultGranularity))
238
+ ? { granularity: nextGranularity }
239
+ : {}),
240
+ ...(same
241
+ ? group.hideEmpty !== undefined
242
+ ? { hideEmpty: group.hideEmpty }
243
+ : {}
244
+ : { hideEmpty: true }),
245
+ buckets: same && !rekeyed ? group.buckets : [],
246
+ };
247
+ const orderChanged = same && (group.order.mode !== nextOrder.mode || group.order.dir !== nextOrder.dir);
248
+ setGroup(orderChanged && !rekeyed ? withGroupOrder(next, nextOrder, heads) : next);
249
+ },
250
+ ...(active && group ? groupVisibility(group, heads, setGroup) : {}),
251
+ };
252
+ }
253
+ export function settingsGroupBy(input) {
254
+ const { settings, columns } = input;
255
+ const group = liveGroup(settings.group);
256
+ return {
257
+ fieldKey: group?.fieldKey ?? null,
258
+ onChange: (fieldKey) => {
259
+ if (fieldKey === null)
260
+ return settings.group ? write(input, { ...settings, group: null }) : undefined;
261
+ const field = columns.find((column) => column.field?.key === fieldKey)?.field;
262
+ if (!field)
263
+ return;
264
+ const listed = input.groupDimensions?.find((dimension) => dimension.fieldKey === fieldKey);
265
+ const next = group?.fieldKey === fieldKey
266
+ ? group
267
+ : groupSpecOf(listed ?? groupDimensionFor(field, field.label, input.resolve ?? resolveViewsMessage));
268
+ write(input, { ...settings, group: next });
269
+ },
270
+ };
271
+ }
@@ -0,0 +1,17 @@
1
+ import { type ListLayout } from "@viewkitjs/fields/query";
2
+ import type { FilterConfig } from "../../filters/filter-model.js";
3
+ import type { GridGroupByState } from "../../grid/chrome/GridColumnMenu.js";
4
+ import type { GroupConfig, LayoutConfig, SortConfig } from "../model.js";
5
+ import type { SettingsPanelsInput } from "./input.js";
6
+ export type SettingsPanels = {
7
+ filters: FilterConfig<string>[];
8
+ sort: SortConfig<string>;
9
+ group: GroupConfig<string>;
10
+ groupBy: GridGroupByState;
11
+ layout: LayoutConfig<ListLayout>;
12
+ /** A board lane shown or hidden: the lanes of the board's field written in `laneOrder`. */
13
+ setLaneVisible: (laneKey: string, visible: boolean, laneOrder: readonly string[]) => void;
14
+ /** The groups the person folded: their layer's. */
15
+ setFolded: (folded: readonly string[]) => void;
16
+ };
17
+ export declare function settingsPanels<Row>(input: SettingsPanelsInput<Row>): SettingsPanels;
@@ -0,0 +1,28 @@
1
+ import { settingsChange } from "@viewkitjs/fields/query";
2
+ import { boardFieldOf, withLaneVisible } from "./axes.js";
3
+ import { settingsFilters } from "./filters.js";
4
+ import { settingsLayout } from "./layout.js";
5
+ import { settingsGroup, settingsGroupBy, settingsSort } from "./order.js";
6
+ export function settingsPanels(input) {
7
+ const { settings, columns, onChange, onLayerChange } = input;
8
+ return {
9
+ filters: settingsFilters(input),
10
+ sort: settingsSort(input),
11
+ group: settingsGroup(input),
12
+ groupBy: settingsGroupBy(input),
13
+ layout: settingsLayout(input),
14
+ setLaneVisible: (laneKey, visible, laneOrder) => {
15
+ const fieldKey = boardFieldOf(settings, columns, input.boardField)?.field?.key;
16
+ if (!fieldKey)
17
+ return;
18
+ const change = settingsChange(settings, withLaneVisible(settings, fieldKey, laneKey, visible, laneOrder));
19
+ if (Object.keys(change).length > 0)
20
+ onChange(change);
21
+ },
22
+ setFolded: (folded) => {
23
+ const held = input.layer.folded ?? [];
24
+ if (folded.length !== held.length || folded.some((key, at) => key !== held[at]))
25
+ onLayerChange({ folded: [...folded] });
26
+ },
27
+ };
28
+ }
@@ -0,0 +1,9 @@
1
+ import { type ListSettingsChange } from "@viewkitjs/fields/query";
2
+ import type { SettingsPanelsInput } from "../settings/input.js";
3
+ /** What a ✕ clears: `filters` the filter rows alone (the Filter button's); `options` the filter rows, the sort (back
4
+ * to its default) and the group (to none) where Options shows it, what Customize's count counts: on a board the
5
+ * group is the table's, kept untouched (`groupShown`; `phone` reads the phone's own layout). `null` when nothing
6
+ * would change. */
7
+ export declare function settingsCleared<Row>(input: Omit<SettingsPanelsInput<Row>, "onChange" | "onLayerChange">, scope: "options" | "filters", { phone }?: {
8
+ phone?: boolean;
9
+ }): ListSettingsChange | null;
@@ -0,0 +1,26 @@
1
+ import { LIST_SETTINGS_LIMITS, applySettingsChange, settingsChange, } from "@viewkitjs/fields/query";
2
+ import { clearViewOptions } from "../model.js";
3
+ import { settingsPanels } from "../settings/settings-panels.js";
4
+ import { groupShown } from "./counts.js";
5
+ export function settingsCleared(input, scope, { phone = false } = {}) {
6
+ let draft = input.settings;
7
+ for (let pass = 0; pass <= LIST_SETTINGS_LIMITS.filterItems + 2; pass++) {
8
+ let moved = false;
9
+ const panels = settingsPanels({
10
+ ...input,
11
+ settings: draft,
12
+ onLayerChange: () => { },
13
+ onChange: (change) => {
14
+ draft = applySettingsChange(draft, change);
15
+ moved = true;
16
+ },
17
+ });
18
+ clearViewOptions(scope === "filters"
19
+ ? { filters: panels.filters }
20
+ : { filters: panels.filters, sort: panels.sort, group: groupShown(panels.group, panels.layout, phone) });
21
+ if (!moved)
22
+ break;
23
+ }
24
+ const change = settingsChange(input.settings, draft);
25
+ return Object.keys(change).length > 0 ? change : null;
26
+ }
@@ -0,0 +1,15 @@
1
+ import { type ViewsMessageResolver } from "../../contract.js";
2
+ import type { GroupConfig, LayoutConfig, ToggleConfig } from "../model.js";
3
+ import { type CollectionViewsInput } from "../views-row/model.js";
4
+ /** The toggle's key: a list that declares its own under it is not given a second. */
5
+ export declare const SHOW_COUNTS_KEY = "show_counts";
6
+ /** Every axis that doesn't say `hideCounts` itself hides its counts while `show` is false. */
7
+ export declare function withCounts<V extends string>(views: CollectionViewsInput<V> | undefined, show: boolean): CollectionViewsInput<V> | undefined;
8
+ /** The toolbar's own Show counts, for the Options panel's toggles: absent when no option carries a number
9
+ * (a toggle that changes nothing visible is worse than none), or when `toggles` already holds one keyed
10
+ * `show_counts`. Its label is `views.panels.show-counts`, worded by `messages`. */
11
+ export declare function countsToggle<V extends string>(views: CollectionViewsInput<V> | undefined, toggles: readonly ToggleConfig[] | undefined, show: boolean, onChange: (next: boolean) => void, messages?: ViewsMessageResolver): ToggleConfig | undefined;
12
+ /** On a board the Group panel isn't offered: the board is laid out by its own field, and the view's grouping
13
+ * is kept, untouched, for the table. `undefined` while the active layout (the phone's own, on a phone) is
14
+ * one the layout's `hidesGroupFor` names. */
15
+ export declare function groupShown<D extends string, V extends string>(group: GroupConfig<D> | undefined, layout: LayoutConfig<V> | undefined, phone: boolean): GroupConfig<D> | undefined;
@@ -0,0 +1,21 @@
1
+ import { resolveViewsMessage } from "../../contract.js";
2
+ import { toViewAxes } from "../views-row/model.js";
3
+ export const SHOW_COUNTS_KEY = "show_counts";
4
+ export function withCounts(views, show) {
5
+ const axes = toViewAxes(views);
6
+ if (!axes)
7
+ return views;
8
+ return axes.map((axis) => (axis.hideCounts === undefined ? { ...axis, hideCounts: !show } : axis));
9
+ }
10
+ export function countsToggle(views, toggles, show, onChange, messages = resolveViewsMessage) {
11
+ const hasCounts = !!toViewAxes(views)?.some((axis) => axis.options.some((option) => typeof option.count === "number"));
12
+ if (!hasCounts || toggles?.some((toggle) => toggle.key === SHOW_COUNTS_KEY))
13
+ return undefined;
14
+ return { key: SHOW_COUNTS_KEY, label: messages({ key: "views.panels.show-counts" }), value: show, onChange };
15
+ }
16
+ export function groupShown(group, layout, phone) {
17
+ const active = phone ? (layout?.mobileValue ?? layout?.value) : layout?.value;
18
+ if (!group || active === undefined || !layout?.hidesGroupFor?.includes(active))
19
+ return group;
20
+ return undefined;
21
+ }
@@ -0,0 +1,5 @@
1
+ import type { ViewsMenuItem } from "../../provider/components.js";
2
+ import type { CollectionViewsInput } from "../views-row/model.js";
3
+ /** `item` at the head of the active option's menu on every axis whose active option has one; an axis whose active
4
+ * view has no verbs gains none. One config in, one config out; an array, an array. */
5
+ export declare function withEditView<V extends string>(views: CollectionViewsInput<V> | undefined, item: ViewsMenuItem): CollectionViewsInput<V> | undefined;
@@ -0,0 +1,18 @@
1
+ function onAxis(axis, item) {
2
+ return {
3
+ ...axis,
4
+ options: axis.options.map((option) => option.value === axis.value && option.menu?.length
5
+ ? {
6
+ ...option,
7
+ menu: [item, ...option.menu.map((row, at) => (at === 0 ? { ...row, separatorBefore: true } : row))],
8
+ }
9
+ : option),
10
+ };
11
+ }
12
+ export function withEditView(views, item) {
13
+ if (!views)
14
+ return views;
15
+ if (Array.isArray(views))
16
+ return views.map((axis) => onAxis(axis, item));
17
+ return onAxis(views, item);
18
+ }
@@ -0,0 +1,34 @@
1
+ /** Which body a toolbar draws. */
2
+ export type ToolbarForm = "row" | "narrow" | "phone";
3
+ /** Where a part stands. `side` defaults to `start`, `line` to `1`. `role: "search"` is the one part the
4
+ * forms move: the narrow form's first line, filled, and the phone's row when nothing stands at the start. */
5
+ export type ToolbarPlacement = {
6
+ key: string;
7
+ side?: "start" | "end";
8
+ line?: 1 | 2;
9
+ role?: "search";
10
+ };
11
+ /** One part in a line. `fill` is a part that takes the line's room (the search, as a field). */
12
+ export type ToolbarSlot = {
13
+ key: string;
14
+ fill: boolean;
15
+ };
16
+ /** One line of a toolbar: what stands at its start and its end, and the size its buttons take. `main` is the
17
+ * row's and the phone's line, `search` a line led by the search field, `views` the narrow form's flowing
18
+ * line, `below` the second line. */
19
+ export type ToolbarLine = {
20
+ kind: "main" | "search" | "views" | "below";
21
+ start: ToolbarSlot[];
22
+ end: ToolbarSlot[];
23
+ size: "md" | "sm";
24
+ };
25
+ /** The box width, in px, under which a toolbar draws its narrow form: the portal's one compact breakpoint. */
26
+ export declare const TOOLBAR_NARROW_BELOW = 700;
27
+ /** The form: a phone draws its own row whatever its box; a narrow box draws the narrow panel; not measured
28
+ * yet (`null`), the row. */
29
+ export declare function toolbarForm({ phone, narrow }: {
30
+ phone: boolean;
31
+ narrow: boolean | null;
32
+ }): ToolbarForm;
33
+ /** Lays the parts out into lines for `form`, keeping the order they were handed in on each side. */
34
+ export declare function arrangeToolbar(parts: readonly ToolbarPlacement[], form: ToolbarForm): ToolbarLine[];
@@ -0,0 +1,52 @@
1
+ export const TOOLBAR_NARROW_BELOW = 700;
2
+ export function toolbarForm({ phone, narrow }) {
3
+ if (phone)
4
+ return "phone";
5
+ return narrow === true ? "narrow" : "row";
6
+ }
7
+ const at = (key, fill = false) => ({ key, fill });
8
+ const isSearch = (part) => part.role === "search";
9
+ const onLine = (part) => part.line ?? 1;
10
+ const sideOf = (part) => part.side ?? "start";
11
+ function kept(lines) {
12
+ return lines.filter((line) => line.start.length + line.end.length > 0);
13
+ }
14
+ export function arrangeToolbar(parts, form) {
15
+ const first = parts.filter((part) => onLine(part) === 1);
16
+ const second = parts.filter((part) => onLine(part) === 2);
17
+ const search = first.find(isSearch);
18
+ const start = first.filter((part) => sideOf(part) === "start" && part !== search);
19
+ const end = first.filter((part) => sideOf(part) === "end" && part !== search);
20
+ const secondInOrder = [...second.filter((part) => sideOf(part) === "start"), ...second.filter((part) => sideOf(part) === "end")];
21
+ const below = {
22
+ kind: "below",
23
+ start: second.filter((part) => sideOf(part) === "start").map((part) => at(part.key)),
24
+ end: second.filter((part) => sideOf(part) === "end").map((part) => at(part.key)),
25
+ size: "md",
26
+ };
27
+ const searchLine = {
28
+ kind: "search",
29
+ start: search ? [at(search.key, true)] : [],
30
+ end: end.map((part) => at(part.key)),
31
+ size: "sm",
32
+ };
33
+ if (form === "narrow") {
34
+ return kept([
35
+ searchLine,
36
+ { kind: "views", start: [...start, ...secondInOrder].map((part) => at(part.key)), end: [], size: "sm" },
37
+ ]);
38
+ }
39
+ if (form === "phone" && start.length === 0)
40
+ return kept([searchLine, below]);
41
+ if (form === "row") {
42
+ const placed = (side) => first.filter((part) => sideOf(part) === side).map((part) => at(part.key));
43
+ return kept([{ kind: "main", start: placed("start"), end: placed("end"), size: "md" }, below]);
44
+ }
45
+ const trailing = search && sideOf(search) === "start"
46
+ ? [search, ...end]
47
+ : first.filter((part) => sideOf(part) === "end");
48
+ return kept([
49
+ { kind: "main", start: start.map((part) => at(part.key)), end: trailing.map((part) => at(part.key)), size: "md" },
50
+ below,
51
+ ]);
52
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * A Filter row's detail tells its host it opened (POR-845), once per row it shows: the host may then ask for what
3
+ * the row offers — an open field's values, read from the database. A re-render asks nothing more.
4
+ */
5
+ export declare function useFilterOpened(filter: {
6
+ key: string;
7
+ onOpen?: () => void;
8
+ }): void;
@@ -0,0 +1,11 @@
1
+ "use client";
2
+ import { useEffect, useRef } from "react";
3
+ export function useFilterOpened(filter) {
4
+ const onOpen = useRef(filter.onOpen);
5
+ useEffect(() => {
6
+ onOpen.current = filter.onOpen;
7
+ });
8
+ useEffect(() => {
9
+ onOpen.current?.();
10
+ }, [filter.key]);
11
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * THE VIEW AS A THING SHARED WITH OTHERS — how far what this person sees has
3
+ * drifted from it, and the two verbs that settle the drift.
4
+ *
5
+ * Present only on a list showing a SHARED saved view. When it is, the
6
+ * Customize trigger's badge counts `changes` (dimensions that differ from
7
+ * everyone's view — Linear's dot, with a number) instead of "active filters",
8
+ * its ✕ is `onReset`, and the panel's footer carries Reset · Set default for
9
+ * everyone. A personal view or a list with no saved view passes nothing and
10
+ * keeps the active-options count: there is no "everyone's" to differ from.
11
+ *
12
+ * Its own module rather than a block in `model.ts`: the model is the toolbar's
13
+ * dimension vocabulary (filters, sort, group…) and is at its size ceiling;
14
+ * this is about the view as an object, which is a different thing.
15
+ */
16
+ export type CollectionViewState = {
17
+ /** Dimensions in which what you see differs from the shared view. */
18
+ changes: number;
19
+ /** Everyone's view moved after this person's edits were seeded from it. */
20
+ stale: boolean;
21
+ /** Owner or admin — may set what they see as everyone's. */
22
+ canPublish: boolean;
23
+ /** A write is in flight; the two verbs wait. */
24
+ pending: boolean;
25
+ /** Back to everyone's view. */
26
+ onReset: () => void;
27
+ /** Make what you see everyone's view. */
28
+ onPublish: () => void;
29
+ };
30
+ /**
31
+ * Export CSV, when the list offers one: the Customize panel's actions row and the phone sheet's foot. `count`
32
+ * is what the row labels, the rows the export would take; `run` builds and downloads the file, and says how it
33
+ * went. Absent, the row stays parked.
34
+ */
35
+ export type CollectionExportCsv = {
36
+ count: number;
37
+ run: () => Promise<void>;
38
+ };
@@ -0,0 +1 @@
1
+ export {};