@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,10 @@
1
+ import type { ReactNode } from "react";
2
+ export declare function PanelHeader({ title, onBack, onClose, trailing, }: {
3
+ title: ReactNode;
4
+ /** Present on a deep page: the back arrow. */
5
+ onBack?: () => void;
6
+ /** Dismisses the whole panel; a host that can't close itself passes none and draws no dead ✕. */
7
+ onClose?: () => void;
8
+ /** What stands before the ✕ (Customize's "Clear all"). */
9
+ trailing?: ReactNode;
10
+ }): ReactNode;
@@ -0,0 +1,12 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { cx } from "../../internal/cx.js";
4
+ import { ELEMENT_RESET } from "../../internal/reset.js";
5
+ import { useViews } from "../../provider/context.js";
6
+ function HeaderIconButton({ icon, label, onClick, edge, }) {
7
+ return (_jsx("button", { type: "button", onClick: onClick, "aria-label": label, className: cx(ELEMENT_RESET, "-my-1 p-1 inline-flex shrink-0 items-center justify-center rounded-md", "text-(color:--vk-fg-subtle) transition-colors hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)", edge === "left" ? "-ml-1" : "-mr-1"), children: _jsx("span", { className: "flex h-4 w-4 items-center justify-center", children: icon }) }));
8
+ }
9
+ export function PanelHeader({ title, onBack, onClose, trailing, }) {
10
+ const { icons, messages } = useViews();
11
+ return (_jsxs("div", { "data-vs-header": true, className: "flex shrink-0 items-center gap-1.5 border-b border-solid border-(color:--vk-border) px-3 py-2.5", children: [onBack && (_jsx(HeaderIconButton, { icon: _jsx(icons.back, { className: "h-3.5 w-3.5" }), label: messages({ key: "views.panels.back" }), onClick: onBack, edge: "left" })), _jsx("span", { className: "min-w-0 flex-1 truncate text-[15px] font-semibold text-(color:--vk-fg)", children: title }), trailing, onClose && (_jsx(HeaderIconButton, { icon: _jsx(icons.close, { className: "h-3 w-3" }), label: messages({ key: "views.panels.close" }), onClick: onClose, edge: "right" }))] }));
12
+ }
@@ -0,0 +1,19 @@
1
+ import { type ReactNode } from "react";
2
+ /** Whether a panel opened here hangs in a sheet: in a `Toolbar`, its phone form; outside one, a phone by the
3
+ * provider's `desktopQuery`. */
4
+ export declare function useSheetPanels(): boolean;
5
+ /** Whether the sheet's head draws the panel's ✕ (`sheetActions: "head"`), so the panel draws none of its own. */
6
+ export declare function useSheetDrawsClose(): boolean;
7
+ export declare function PanelSheet({ open, onOpenChange, title, snap, slot, headed, children, }: {
8
+ open: boolean;
9
+ onOpenChange: (open: boolean) => void;
10
+ /** The panel's name in words: the sheet's accessible name, and its title unless the panel heads itself. */
11
+ title: string;
12
+ /** The panel draws its own header (its title, its back arrow): the sheet is handed only its name (`label`), so an
13
+ * app's head doesn't title it twice. Default false. */
14
+ headed?: boolean;
15
+ snap: "full" | "auto";
16
+ /** The `data-slot` on the panel's box inside the sheet, where the popover's panel carries one. */
17
+ slot?: string;
18
+ children: ReactNode;
19
+ }): ReactNode;
@@ -0,0 +1,22 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useContext } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ import { useDesktop } from "../../provider/desktop.js";
6
+ import { ToolbarRadioContext, useToolbarSlot } from "./toolbar/context.js";
7
+ export function useSheetPanels() {
8
+ const inToolbar = useContext(ToolbarRadioContext) !== null;
9
+ const { form } = useToolbarSlot();
10
+ const desktop = useDesktop();
11
+ return inToolbar ? form === "phone" : !desktop;
12
+ }
13
+ export function useSheetDrawsClose() {
14
+ return useViews().sheetActions === "head";
15
+ }
16
+ export function PanelSheet({ open, onOpenChange, title, snap, slot, headed = false, children, }) {
17
+ const { components, messages } = useViews();
18
+ const { Sheet } = components;
19
+ const head = useSheetDrawsClose();
20
+ const keep = (event) => event.stopPropagation();
21
+ return (_jsx("span", { className: "contents", onClick: keep, onDoubleClick: keep, onContextMenu: keep, children: _jsx(Sheet, { open: open, onOpenChange: (next) => onOpenChange(next), ...(!headed && { title }), label: title, snap: snap, ...(head && { actions: { close: { label: messages({ key: "views.panels.close" }), onPress: () => onOpenChange(false) } } }), children: _jsx("div", { "data-slot": slot, className: "flex h-full min-h-0 flex-col", children: children }) }) }));
22
+ }
@@ -0,0 +1,71 @@
1
+ import { type ActivePanel, type ViewOptionInputs } from "../model.js";
2
+ import type { CollectionViewState } from "../view-state.js";
3
+ import type { PanelFieldEditor } from "./field-editor.js";
4
+ /**
5
+ * Keep the panel open when the interaction lands in a PORTALLED child of its own: a select's dropdown, a nested
6
+ * popover.
7
+ *
8
+ * Radix renders those outside the panel's DOM subtree, so every click in one (and the dismissal click that
9
+ * closes it) reaches the panel as "outside" and takes the whole thing down with it. Nothing about the click was
10
+ * outside from the user's point of view: they were choosing an operator.
11
+ *
12
+ * Matching on the popper wrapper rather than on a select specifically means any future portalled control inside
13
+ * the panel is covered without a second fix.
14
+ */
15
+ export declare function keepPanelOpenForPortals(event: {
16
+ target: EventTarget | null;
17
+ detail?: {
18
+ originalEvent?: Event;
19
+ };
20
+ preventDefault: () => void;
21
+ }): void;
22
+ /**
23
+ * What the Customize popover adds on top of the app's menu popover, which is the panel itself: the width, the
24
+ * widen-for-a-calendar rule, the z-index that sits under an entity overlay, and its slide-from-the-right motion.
25
+ */
26
+ export declare function viewOptionsPopoverClassName(activePanel: ActivePanel, widthClassName?: string): string;
27
+ /** Which page the panel is on, and the active-options count and clear it starts from. */
28
+ export declare function useViewActivePanel<S extends string = string, G extends string = string, T extends string = string>(args: ViewOptionInputs<S, G, T>): {
29
+ activePanel: ActivePanel;
30
+ setActivePanel: import("react").Dispatch<import("react").SetStateAction<ActivePanel>>;
31
+ reset: () => void;
32
+ anyActive: boolean;
33
+ clearAll: () => void;
34
+ };
35
+ /** What `useViewOptionsPopover` hands the trigger and the panel. */
36
+ export type ViewOptionsPopoverState = {
37
+ open: boolean;
38
+ setOpen: (v: boolean) => void;
39
+ /** The trigger's badge: the drift from everyone's view on a shared view, else the active options. */
40
+ badge: number;
41
+ activePanel: ActivePanel;
42
+ setActivePanel: (p: ActivePanel) => void;
43
+ anyActive: boolean;
44
+ /** The badge's ✕: Reset on a shared view, else clear the active options. */
45
+ clearAll: () => void;
46
+ /** Opens or closes; a close forgets the page, so the panel reopens at its root. */
47
+ handleOpenChange: (next: boolean) => void;
48
+ };
49
+ export declare function useViewOptionsPopover<S extends string = string, G extends string = string, T extends string = string>({ filters, sort, group, timeScopeConfig, dateRangeConfigs, view, }: ViewOptionInputs<S, G, T> & {
50
+ view?: CollectionViewState;
51
+ }): ViewOptionsPopoverState;
52
+ /** The panel for a popover (content only, no popover around it). */
53
+ export declare function ViewOptionsPopoverPanel<S extends string = string, G extends string = string, T extends string = string>({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, activePanel, setActivePanel, anyActive, clearAll, foldFilters, onClose, fill, view, fieldEditor, }: ViewOptionInputs<S, G, T> & {
54
+ activePanel: ActivePanel;
55
+ setActivePanel: (p: ActivePanel) => void;
56
+ anyActive: boolean;
57
+ clearAll: () => void;
58
+ /** The shared view this list shows, when it shows one: see `CollectionViewState`. */
59
+ view?: CollectionViewState;
60
+ /** Consolidate filters + time scope + date ranges behind one "Filter" row (list pages). Off = every
61
+ * dimension is a root row (dashboards). */
62
+ foldFilters?: boolean;
63
+ /** Dismisses the panel, which drives the header's ✕. Every host that owns the open state passes it; one that
64
+ * doesn't renders no ✕. */
65
+ onClose?: () => void;
66
+ /** Full-height host (a drawer): the panel stretches, the body scrolls, and detail max-heights are lifted.
67
+ * Off for popovers. */
68
+ fill?: boolean;
69
+ /** The list's field editor (Add field, Edit field), for the Columns list and a column's settings. */
70
+ fieldEditor?: PanelFieldEditor | null;
71
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,47 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useState } from "react";
4
+ import { cx } from "../../internal/cx.js";
5
+ import { clearViewOptions, countActiveViewOptions, } from "../model.js";
6
+ import { ViewOptionsPanelContent } from "./customize.js";
7
+ export function keepPanelOpenForPortals(event) {
8
+ const source = (event.detail?.originalEvent?.target ?? event.target);
9
+ if (source?.closest?.("[data-radix-popper-content-wrapper]")) {
10
+ event.preventDefault();
11
+ return;
12
+ }
13
+ if (typeof document !== "undefined" && document.body.style.pointerEvents === "none") {
14
+ event.preventDefault();
15
+ return;
16
+ }
17
+ if (source === document.body || source === document.documentElement)
18
+ event.preventDefault();
19
+ }
20
+ export function viewOptionsPopoverClassName(activePanel, widthClassName = "w-60") {
21
+ const isWidePanel = activePanel?.type === "dateRange" || activePanel?.type === "timeScope";
22
+ return cx("z-90", isWidePanel ? "w-62" : widthClassName, "data-[state=open]:slide-in-from-right-3 data-[state=closed]:slide-out-to-right-3", "data-[state=open]:zoom-in-100 data-[state=closed]:zoom-out-100", "duration-150");
23
+ }
24
+ export function useViewActivePanel(args) {
25
+ const [activePanel, setActivePanel] = useState(null);
26
+ const reset = () => setActivePanel(null);
27
+ const anyActive = countActiveViewOptions(args) > 0;
28
+ const clearAll = () => clearViewOptions(args);
29
+ return { activePanel, setActivePanel, reset, anyActive, clearAll };
30
+ }
31
+ export function useViewOptionsPopover({ filters, sort, group, timeScopeConfig, dateRangeConfigs, view, }) {
32
+ const [open, setOpen] = useState(false);
33
+ const active = useViewActivePanel({ filters, sort, group, timeScopeConfig, dateRangeConfigs });
34
+ const { activePanel, setActivePanel } = active;
35
+ const badge = view ? view.changes : countActiveViewOptions({ filters, sort, group, dateRangeConfigs });
36
+ const anyActive = view ? view.changes > 0 : active.anyActive;
37
+ const clearAll = view ? view.onReset : active.clearAll;
38
+ const handleOpenChange = (next) => {
39
+ if (!next)
40
+ setActivePanel(null);
41
+ setOpen(next);
42
+ };
43
+ return { open, setOpen, badge, activePanel, setActivePanel, anyActive, clearAll, handleOpenChange };
44
+ }
45
+ export function ViewOptionsPopoverPanel({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, activePanel, setActivePanel, anyActive, clearAll, foldFilters, onClose, fill, view, fieldEditor, }) {
46
+ return (_jsx(ViewOptionsPanelContent, { filters: filters, sort: sort, group: group, timeScopeConfig: timeScopeConfig, dateRangeConfigs: dateRangeConfigs, toggles: toggles, layout: layout, activePanel: activePanel, onOpenPanel: setActivePanel, anyActive: anyActive, clearAll: clearAll, foldFilters: foldFilters, onClose: onClose, fill: fill, view: view, fieldEditor: fieldEditor }));
47
+ }
@@ -0,0 +1,6 @@
1
+ import { type ActivePanel, type ViewOptionInputs } from "../model.js";
2
+ /** The ordered root menu shared by popover and full-height overlay hosts. */
3
+ export declare function PopoverRootList<S extends string = string, G extends string = string, T extends string = string>({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, onOpenPanel, foldFilters, }: ViewOptionInputs<S, G, T> & {
4
+ onOpenPanel: (panel: ActivePanel) => void;
5
+ foldFilters?: boolean;
6
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,31 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { dimensionRows } from "../filter/filter-list.js";
5
+ import { filterRowValueLabel, groupValueLabel, layoutValueLabel, sortValueLabel } from "../labels.js";
6
+ import { countActiveFilters, isGroupActive, isSortActive } from "../model.js";
7
+ const GLYPH = "h-3.5 w-3.5";
8
+ const ROOT_LIST_CLASS = "p-(--vk-panel-padding,0.375rem)";
9
+ export function PopoverRootList({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, onOpenPanel, foldFilters = true, }) {
10
+ const { atoms, icons, messages } = useViews();
11
+ const { MenuRow, ToggleRow } = atoms;
12
+ const hasToggles = !!toggles && toggles.length > 0;
13
+ const showSubOptions = !layout?.subOptionsFor || layout.value === layout.subOptionsFor;
14
+ const showColumns = layout?.columnsFor ? layout.columnsFor.includes(layout.value) : showSubOptions;
15
+ const hasColumns = showColumns && !!layout?.columns && layout.columns.items.length > 0;
16
+ const hasAnyFilter = (filters?.length ?? 0) > 0 || !!timeScopeConfig || (dateRangeConfigs?.length ?? 0) > 0;
17
+ const activeFilterCount = countActiveFilters({ filters, dateRangeConfigs });
18
+ const layoutRow = layout && (_jsx(MenuRow, { icon: _jsx(icons.layout, { className: GLYPH }), label: layout.label ?? messages({ key: "views.panels.layout" }), value: layoutValueLabel(layout), active: false, onClick: () => onOpenPanel({ type: "layout" }) }));
19
+ const columnsRow = hasColumns && (_jsx(MenuRow, { icon: _jsx(icons.columns, { className: GLYPH }), label: layout.columnsLabelByView?.[layout.value] ?? messages({ key: "views.panels.columns" }), value: messages({
20
+ key: "views.panels.columns-shown",
21
+ values: { count: layout.columns.items.filter((column) => !column.hidden).length },
22
+ }), active: false, onClick: () => onOpenPanel({ type: "columns" }) }));
23
+ const sortRow = sort && (_jsx(MenuRow, { icon: _jsx(icons.sort, { className: GLYPH }), label: sort.label ?? messages({ key: "views.panels.sort" }), value: sortValueLabel(sort, messages), active: isSortActive(sort), onClick: () => onOpenPanel({ type: "sort" }) }));
24
+ const groupRow = group && (_jsx(MenuRow, { icon: _jsx(icons.group, { className: GLYPH }), label: group.label ?? messages({ key: "views.panels.group" }), value: groupValueLabel(group, messages), active: isGroupActive(group), onClick: () => onOpenPanel({ type: "group" }) }));
25
+ const toggleRows = hasToggles &&
26
+ toggles.map((toggle) => (_jsx(ToggleRow, { icon: toggle.icon, label: toggle.label, active: toggle.value, onClick: () => toggle.onChange(!toggle.value), reset: toggle.reset }, toggle.key)));
27
+ if (foldFilters) {
28
+ return (_jsxs("div", { "data-vs-detail": true, className: ROOT_LIST_CLASS, children: [layoutRow, columnsRow, hasAnyFilter && (_jsx(MenuRow, { icon: _jsx(icons.filter, { className: GLYPH }), label: messages({ key: "views.panels.filter" }), value: filterRowValueLabel(activeFilterCount, messages), active: activeFilterCount > 0, onClick: () => onOpenPanel({ type: "filters" }) })), sortRow, groupRow, toggleRows] }));
29
+ }
30
+ return (_jsxs("div", { "data-vs-detail": true, className: ROOT_LIST_CLASS, children: [layoutRow, columnsRow, dimensionRows(filters, undefined, undefined, onOpenPanel), sortRow, groupRow, dimensionRows(undefined, timeScopeConfig, dateRangeConfigs, onOpenPanel), toggleRows] }));
31
+ }
@@ -0,0 +1,42 @@
1
+ import { type ReactNode } from "react";
2
+ import type { ViewsMenuItem } from "../../../provider/components.js";
3
+ import type { ToggleConfig } from "../../model.js";
4
+ import type { SettingsPanelsInput } from "../../settings/input.js";
5
+ import type { CollectionViewState } from "../../view-state.js";
6
+ import type { CollectionViewsInput, ViewsLayout } from "../../views-row/model.js";
7
+ import type { PanelFieldEditor } from "../field-editor.js";
8
+ import type { ToolbarPanelHost } from "./panel-part.js";
9
+ export type ReadyToolbarProps<Row> = SettingsPanelsInput<Row> & {
10
+ /** The list's views; absent, no views row (the phone's search then fills its row). */
11
+ views?: CollectionViewsInput<string>;
12
+ viewsLayout?: ViewsLayout;
13
+ /** Show counts, when the app keeps it; absent, the toolbar holds it, on. */
14
+ showCounts?: boolean;
15
+ onShowCountsChange?: (show: boolean) => void;
16
+ /** One way to add: New fires it. */
17
+ onAdd?: () => void;
18
+ /** Several ways to add: New opens them as a menu. */
19
+ addItems?: ViewsMenuItem[];
20
+ addLabel?: string;
21
+ /** The shared view this list shows: the drift dot on Options and the panel's footer. */
22
+ view?: CollectionViewState;
23
+ /** The list's own toggles for Customize; Show counts is added unless one is keyed `show_counts`. */
24
+ toggles?: ToggleConfig[];
25
+ fieldEditor?: PanelFieldEditor | null;
26
+ searchPlaceholder?: string;
27
+ /** The app's search is under way: the search draws a spinner where its glass is, its field still usable. */
28
+ searching?: boolean;
29
+ /** The app's own hosts for the panels (its side drawer, its sheet); absent, the map's `Popover` (on a phone, its
30
+ * `Sheet`). */
31
+ hosts?: {
32
+ options?: ToolbarPanelHost;
33
+ sort?: ToolbarPanelHost;
34
+ filter?: ToolbarPanelHost;
35
+ };
36
+ /** The phone's row; absent, the provider's `desktopQuery`. */
37
+ phone?: boolean;
38
+ /** The narrow panel; absent, the toolbar's own box decides. */
39
+ narrow?: boolean;
40
+ className?: string;
41
+ };
42
+ export declare function ReadyToolbar<Row>(props: ReadyToolbarProps<Row>): ReactNode;
@@ -0,0 +1,92 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { settingsChange } from "@viewkitjs/fields/query";
4
+ import { useState } from "react";
5
+ import { useViews } from "../../../provider/context.js";
6
+ import { useDesktop } from "../../../provider/desktop.js";
7
+ import { getViewOptionAvailability } from "../../availability.js";
8
+ import { settingsPanels } from "../../settings/settings-panels.js";
9
+ import { settingsCleared } from "../../toolbar/clear.js";
10
+ import { countsToggle, groupShown } from "../../toolbar/counts.js";
11
+ import { withEditView } from "../../toolbar/edit-view.js";
12
+ import { useToolbarPanelState } from "./panel-state.js";
13
+ import { Toolbar } from "./Toolbar.js";
14
+ import { ToolbarFilter } from "./ToolbarFilter.js";
15
+ import { ToolbarNew } from "./ToolbarNew.js";
16
+ import { ToolbarOptions } from "./ToolbarOptions.js";
17
+ import { ToolbarSearch } from "./ToolbarSearch.js";
18
+ import { ToolbarSort } from "./ToolbarSort.js";
19
+ import { ToolbarViews } from "./ToolbarViews.js";
20
+ export function ReadyToolbar(props) {
21
+ const { settings, onChange, views, viewsLayout, onAdd, addItems, addLabel, view, fieldEditor, searchPlaceholder, searching, hosts, narrow, className, } = props;
22
+ const { icons, messages, conventions } = useViews();
23
+ const desktop = useDesktop();
24
+ const phone = props.phone ?? !desktop;
25
+ const options = useToolbarPanelState();
26
+ const sortState = useToolbarPanelState();
27
+ const filterState = useToolbarPanelState();
28
+ const [heldShow, setHeldShow] = useState(true);
29
+ const show = props.showCounts ?? heldShow;
30
+ const setShow = props.onShowCountsChange ?? setHeldShow;
31
+ const input = { ...props, resolve: props.resolve ?? messages, conventions: props.conventions ?? conventions };
32
+ const panels = settingsPanels(input);
33
+ const counts = countsToggle(views, props.toggles, show, setShow, messages);
34
+ const toggles = counts ? [...(props.toggles ?? []), counts] : props.toggles;
35
+ const inputs = {
36
+ filters: panels.filters,
37
+ sort: panels.sort,
38
+ group: groupShown(panels.group, panels.layout, phone),
39
+ layout: panels.layout,
40
+ toggles,
41
+ };
42
+ const clear = (scope) => () => {
43
+ const change = settingsCleared(input, scope, { phone });
44
+ if (change)
45
+ onChange(change);
46
+ };
47
+ const Edit = icons.options;
48
+ const shownViews = getViewOptionAvailability(inputs).desktop
49
+ ? withEditView(views, {
50
+ key: "edit-view",
51
+ label: messages({ key: "views.panels.edit-view" }),
52
+ icon: _jsx(Edit, { className: "h-4 w-4" }),
53
+ onSelect: () => options.onOpenChange(true),
54
+ })
55
+ : views;
56
+ const search = settings.search ?? "";
57
+ const parts = [
58
+ ...(shownViews
59
+ ? [
60
+ { key: "views", node: _jsx(ToolbarViews, { views: shownViews, viewsLayout: viewsLayout, showCounts: show }) },
61
+ { key: "views-stacked", line: 2, node: _jsx(ToolbarViews, { views: shownViews, viewsLayout: viewsLayout, showCounts: show, stacked: true }) },
62
+ ]
63
+ : []),
64
+ {
65
+ key: "search",
66
+ side: "end",
67
+ role: "search",
68
+ node: (_jsx(ToolbarSearch, { value: search, placeholder: searchPlaceholder, searching: searching, onChange: (next) => {
69
+ const change = settingsChange(settings, { ...settings, search: next === "" ? undefined : next });
70
+ if (Object.keys(change).length > 0)
71
+ onChange(change);
72
+ } })),
73
+ },
74
+ {
75
+ key: "sort",
76
+ side: "end",
77
+ node: _jsx(ToolbarSort, { sort: panels.sort, open: sortState.open, onOpenChange: sortState.onOpenChange, host: hosts?.sort }),
78
+ },
79
+ {
80
+ key: "filter",
81
+ side: "end",
82
+ node: (_jsx(ToolbarFilter, { filters: panels.filters, onClear: clear("filters"), open: filterState.open, onOpenChange: filterState.onOpenChange, page: filterState.page, onPageChange: filterState.onPageChange, host: hosts?.filter })),
83
+ },
84
+ {
85
+ key: "options",
86
+ side: "end",
87
+ node: (_jsx(ToolbarOptions, { ...inputs, view: view, fieldEditor: fieldEditor, onClear: view ? view.onReset : clear("options"), open: options.open, onOpenChange: options.onOpenChange, page: options.page, onPageChange: options.onPageChange, host: hosts?.options })),
88
+ },
89
+ { key: "new", side: "end", node: _jsx(ToolbarNew, { onAdd: onAdd, items: addItems, label: addLabel }) },
90
+ ];
91
+ return _jsx(Toolbar, { parts: parts, phone: phone, narrow: narrow, className: className });
92
+ }
@@ -0,0 +1,16 @@
1
+ import { type ReactNode } from "react";
2
+ import { type ToolbarPlacement } from "../../toolbar/model.js";
3
+ /** A part as an app hands it: where it stands, and what it draws. */
4
+ export type ToolbarPart = ToolbarPlacement & {
5
+ node: ReactNode;
6
+ };
7
+ export declare function Toolbar({ parts, phone, narrow, narrowBelow, className, }: {
8
+ parts: readonly ToolbarPart[];
9
+ /** The phone's one row; absent, the provider's answer (`desktopQuery`). */
10
+ phone?: boolean;
11
+ /** True draws the narrow panel, false the row; absent, the frame's own box decides. */
12
+ narrow?: boolean;
13
+ /** The box width under which it is narrow. Default `TOOLBAR_NARROW_BELOW` (700). */
14
+ narrowBelow?: number;
15
+ className?: string;
16
+ }): ReactNode;
@@ -0,0 +1,34 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { Fragment, useRef } from "react";
4
+ import { cx } from "../../../internal/cx.js";
5
+ import { useDesktop } from "../../../provider/desktop.js";
6
+ import { TOOLBAR_NARROW_BELOW, arrangeToolbar, toolbarForm, } from "../../toolbar/model.js";
7
+ import { ToolbarRadioContext, ToolbarSlotContext, useToolbarRadioState } from "./context.js";
8
+ import { useBoxNarrow } from "./use-box-narrow.js";
9
+ const CLUSTER_FADE = "linear-gradient(to right, transparent 0, var(--vk-ground) 1.25rem, var(--vk-ground) 100%)";
10
+ export function Toolbar({ parts, phone, narrow, narrowBelow = TOOLBAR_NARROW_BELOW, className, }) {
11
+ const box = useRef(null);
12
+ const desktop = useDesktop();
13
+ const measured = useBoxNarrow(box, narrowBelow);
14
+ const radio = useToolbarRadioState();
15
+ const form = toolbarForm({ phone: phone ?? !desktop, narrow: narrow ?? measured });
16
+ const lines = arrangeToolbar(parts, form);
17
+ const nodes = new Map(parts.map((part) => [part.key, part.node]));
18
+ return (_jsx(ToolbarRadioContext.Provider, { value: radio, children: _jsx("div", { ref: box, "data-slot": "vk-toolbar", "data-form": form, className: cx("flex w-full flex-col", form === "row" ? "gap-1" : "gap-2", className), children: lines.map((line) => (_jsx(Line, { line: line, form: form, nodes: nodes }, line.kind))) }) }));
19
+ }
20
+ function Line({ line, form, nodes }) {
21
+ const draw = (slots) => slots.map((slot) => (_jsx(ToolbarSlotContext.Provider, { value: { form, fill: slot.fill, size: line.size, line: line.kind }, children: _jsx(Fragment, { children: nodes.get(slot.key) }) }, slot.key)));
22
+ const mark = { "data-slot": "vk-toolbar-line", "data-line": line.kind };
23
+ if (line.kind === "main" && form === "row") {
24
+ return (_jsxs("div", { ...mark, "data-toolbar-row": true, className: "relative flex min-h-9 items-center empty:hidden", children: [_jsx("div", { className: "flex min-w-0 flex-1 items-center gap-2", children: draw(line.start) }), line.end.length > 0 && (_jsx("div", { "data-slot": "vk-toolbar-cluster", "data-toolbar-cluster": true, className: "absolute inset-y-0 right-0 flex items-center gap-1 pl-8", style: { background: CLUSTER_FADE }, children: draw(line.end) }))] }));
25
+ }
26
+ if (line.kind === "main") {
27
+ return (_jsxs("div", { ...mark, className: "flex items-center gap-1.5 empty:hidden", children: [draw(line.start), _jsx("div", { className: "flex min-w-0 flex-1 items-center justify-end gap-1", children: draw(line.end) })] }));
28
+ }
29
+ if (line.kind === "search") {
30
+ const filled = line.start.some((slot) => slot.fill);
31
+ return (_jsxs("div", { ...mark, className: cx("flex items-center gap-0.5 empty:hidden", filled && "rounded-full bg-(color:--vk-neutral) pl-2 pr-1"), children: [filled ? draw(line.start) : _jsx("div", { className: "flex-1" }), draw(line.end)] }));
32
+ }
33
+ return (_jsxs("div", { ...mark, className: "flex flex-wrap items-center gap-2 empty:hidden", children: [draw(line.start), line.end.length > 0 && _jsx("div", { className: "ml-auto flex items-center gap-1", children: draw(line.end) })] }));
34
+ }
@@ -0,0 +1,5 @@
1
+ import type { ReactNode } from "react";
2
+ import type { ViewsToolbarButtonProps } from "../../../atoms/types.js";
3
+ export declare function ToolbarButton({ size, ...props }: Omit<ViewsToolbarButtonProps, "size"> & {
4
+ size?: "md" | "sm";
5
+ }): ReactNode;
@@ -0,0 +1,9 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useViews } from "../../../provider/context.js";
4
+ import { useToolbarSlot } from "./context.js";
5
+ export function ToolbarButton({ size, ...props }) {
6
+ const { atoms } = useViews();
7
+ const slot = useToolbarSlot();
8
+ return _jsx(atoms.ToolbarButton, { ...props, size: size ?? slot.size });
9
+ }
@@ -0,0 +1,19 @@
1
+ import { type ReactNode } from "react";
2
+ import type { FilterConfig } from "../../../filters/filter-model.js";
3
+ import { type ActivePanel, type DateRangeConfig, type TimeScopeConfig } from "../../model.js";
4
+ import { type ToolbarPanelHost } from "./panel-part.js";
5
+ export declare function ToolbarFilter({ filters, timeScopeConfig, dateRangeConfigs, onClear, open, onOpenChange, page: pageIn, onPageChange, host, }: {
6
+ /** The builder's Filter rows: `settingsPanels(…).filters`. */
7
+ filters: FilterConfig<string>[];
8
+ timeScopeConfig?: TimeScopeConfig<string>;
9
+ dateRangeConfigs?: DateRangeConfig[];
10
+ /** The ✕'s clear; absent, each applied filter cleared through its own `onChange` (the builder's rows add up, so the
11
+ * last change clears them all). For one change, pass `settingsCleared(…, "filters")`. */
12
+ onClear?: () => void;
13
+ open?: boolean;
14
+ onOpenChange?: (open: boolean) => void;
15
+ /** The page it is on, when the app holds it; absent, its own, forgotten when it closes. */
16
+ page?: ActivePanel;
17
+ onPageChange?: (page: ActivePanel) => void;
18
+ host?: ToolbarPanelHost;
19
+ }): ReactNode;
@@ -0,0 +1,32 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useState } from "react";
4
+ import { useViews } from "../../../provider/context.js";
5
+ import { clearViewOptions, countActiveFilters, } from "../../model.js";
6
+ import { FilterPanelContent } from "../filter-panel.js";
7
+ import { viewOptionsPopoverClassName } from "../popover.js";
8
+ import { ToolbarPanelPart } from "./panel-part.js";
9
+ export function ToolbarFilter({ filters, timeScopeConfig, dateRangeConfigs, onClear, open, onOpenChange, page: pageIn, onPageChange, host, }) {
10
+ const { icons, messages } = useViews();
11
+ const Glyph = icons.filter;
12
+ const [ownOpen, setOwnOpen] = useState(false);
13
+ const [ownPage, setOwnPage] = useState(null);
14
+ const holdsOpen = open !== undefined && !!onOpenChange;
15
+ const holdsPage = pageIn !== undefined && !!onPageChange;
16
+ const page = holdsPage ? pageIn : ownPage;
17
+ const setPage = holdsPage ? onPageChange : setOwnPage;
18
+ if (filters.length === 0 && !timeScopeConfig && !dateRangeConfigs?.length)
19
+ return null;
20
+ const name = messages({ key: "views.panels.filter" });
21
+ const count = countActiveFilters({ filters, dateRangeConfigs });
22
+ const clear = onClear ?? (() => clearViewOptions({ filters, dateRangeConfigs }));
23
+ const handleOpenChange = (next) => {
24
+ if (!next && !holdsPage)
25
+ setOwnPage(null);
26
+ if (holdsOpen)
27
+ onOpenChange(next);
28
+ else
29
+ setOwnOpen(next);
30
+ };
31
+ return (_jsx(ToolbarPanelPart, { panelKey: "filter", slot: "vk-toolbar-filter", icon: _jsx(Glyph, { className: "h-4 w-4 shrink-0" }), label: name, word: name, count: count, onClear: clear, open: holdsOpen ? open : ownOpen, onOpenChange: handleOpenChange, host: host, popoverClassName: viewOptionsPopoverClassName(page), children: ({ fill, close, closeButton }) => (_jsx(FilterPanelContent, { filters: filters, timeScopeConfig: timeScopeConfig, dateRangeConfigs: dateRangeConfigs, page: page, onPageChange: setPage, onClose: closeButton ? close : undefined, fill: fill })) }));
32
+ }
@@ -0,0 +1,12 @@
1
+ import { type ReactNode } from "react";
2
+ import type { ViewsMenuItem } from "../../../provider/components.js";
3
+ export declare function ToolbarNew({ onAdd, items, label, icon, }: {
4
+ /** One way to add: the button fires it. */
5
+ onAdd?: () => void;
6
+ /** Several ways to add: the button opens them as a menu. */
7
+ items?: ViewsMenuItem[];
8
+ /** The button's name. Default `views.panels.toolbar-new`. */
9
+ label?: string;
10
+ /** The glyph. Default your `add` icon. */
11
+ icon?: ReactNode;
12
+ }): ReactNode;
@@ -0,0 +1,21 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useRef } from "react";
4
+ import { useViews } from "../../../provider/context.js";
5
+ import { useAnchoredToggle } from "../views-row/use-anchored-toggle.js";
6
+ import { useToolbarPanel, useToolbarSlot } from "./context.js";
7
+ import { ToolbarButton } from "./ToolbarButton.js";
8
+ export function ToolbarNew({ onAdd, items, label, icon, }) {
9
+ const { components, icons, messages } = useViews();
10
+ const { Menu } = components;
11
+ const Add = icons.add;
12
+ const slot = useToolbarSlot();
13
+ const anchor = useRef(null);
14
+ const toggle = useAnchoredToggle(anchor);
15
+ useToolbarPanel("new", { open: toggle.open, onOpenChange: toggle.setOpen });
16
+ const hasMenu = !!items && items.length > 0;
17
+ if (!onAdd && !hasMenu && slot.form !== "row")
18
+ return null;
19
+ const name = label ?? messages({ key: "views.panels.toolbar-new" });
20
+ return (_jsxs("span", { "data-slot": "vk-toolbar-new", className: "relative inline-flex shrink-0", children: [_jsx(ToolbarButton, { ref: anchor, icon: icon ?? _jsx(Add, { className: "h-4 w-4 shrink-0" }), label: name, word: name, edge: true, disabled: !onAdd && !hasMenu, popup: hasMenu ? "menu" : undefined, open: hasMenu && toggle.open, onPointerDown: hasMenu ? toggle.triggerProps.onPointerDown : undefined, onClick: (event) => (hasMenu ? toggle.triggerProps.onClick(event) : onAdd?.()) }), hasMenu && (_jsx(Menu, { open: toggle.open, onOpenChange: toggle.onOpenChange, anchor: anchor, items: items, align: "end", label: name }))] }));
21
+ }
@@ -0,0 +1,25 @@
1
+ import { type ReactNode } from "react";
2
+ import { type ActivePanel, type ViewOptionInputs } from "../../model.js";
3
+ import type { CollectionViewState } from "../../view-state.js";
4
+ import type { PanelFieldEditor } from "../field-editor.js";
5
+ import { type ToolbarPanelHost } from "./panel-part.js";
6
+ export declare function ToolbarOptions({ view, fieldEditor, foldFilters, onClear, open, onOpenChange, page: pageIn, onPageChange, host, widthClassName, ...inputs }: ViewOptionInputs & {
7
+ /** The shared view this list shows: the drift dot, and the panel's footer (Reset, Set default for everyone). */
8
+ view?: CollectionViewState;
9
+ /** The list's field editor, for the Columns list and a column's settings. */
10
+ fieldEditor?: PanelFieldEditor | null;
11
+ /** The filter dimensions behind one Filter row (lists). Default true. */
12
+ foldFilters?: boolean;
13
+ /** The ✕'s clear (and the panel's Clear all); absent, each active option cleared through its own `onChange`, or
14
+ * Reset on a shared view (the builder's filter rows add up, so every filter clears). For one change, pass
15
+ * `settingsCleared(…, "options")`. */
16
+ onClear?: () => void;
17
+ open?: boolean;
18
+ onOpenChange?: (open: boolean) => void;
19
+ /** The page it is on, when the app holds it; absent, its own, forgotten when it closes. */
20
+ page?: ActivePanel;
21
+ onPageChange?: (page: ActivePanel) => void;
22
+ host?: ToolbarPanelHost;
23
+ /** The popover's width class. Default `w-60`. */
24
+ widthClassName?: string;
25
+ }): ReactNode;
@@ -0,0 +1,33 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useState } from "react";
4
+ import { useViews } from "../../../provider/context.js";
5
+ import { getViewOptionAvailability } from "../../availability.js";
6
+ import { clearViewOptions, countActiveViewOptions, } from "../../model.js";
7
+ import { ViewOptionsPanelContent } from "../customize.js";
8
+ import { viewOptionsPopoverClassName } from "../popover.js";
9
+ import { ToolbarPanelPart } from "./panel-part.js";
10
+ export function ToolbarOptions({ view, fieldEditor, foldFilters = true, onClear, open, onOpenChange, page: pageIn, onPageChange, host, widthClassName, ...inputs }) {
11
+ const { icons, messages } = useViews();
12
+ const Glyph = icons.options;
13
+ const [ownOpen, setOwnOpen] = useState(false);
14
+ const [ownPage, setOwnPage] = useState(null);
15
+ const holdsOpen = open !== undefined && !!onOpenChange;
16
+ const holdsPage = pageIn !== undefined && !!onPageChange;
17
+ const page = holdsPage ? pageIn : ownPage;
18
+ const setPage = holdsPage ? onPageChange : setOwnPage;
19
+ if (!getViewOptionAvailability(inputs).desktop)
20
+ return null;
21
+ const name = messages({ key: "views.panels.toolbar-options" });
22
+ const count = view ? 0 : countActiveViewOptions(inputs);
23
+ const clear = onClear ?? (view ? view.onReset : () => clearViewOptions(inputs));
24
+ const handleOpenChange = (next) => {
25
+ if (!next && !holdsPage)
26
+ setOwnPage(null);
27
+ if (holdsOpen)
28
+ onOpenChange(next);
29
+ else
30
+ setOwnOpen(next);
31
+ };
32
+ return (_jsx(ToolbarPanelPart, { panelKey: "options", slot: "vk-toolbar-options", icon: _jsx(Glyph, { className: "h-4 w-4 shrink-0" }), label: name, word: name, count: count, onClear: clear, dot: !!view && view.changes > 0, open: holdsOpen ? open : ownOpen, onOpenChange: handleOpenChange, host: host, popoverClassName: viewOptionsPopoverClassName(page, widthClassName), children: ({ fill, close, closeButton }) => (_jsx(ViewOptionsPanelContent, { ...inputs, activePanel: page, onOpenPanel: setPage, anyActive: view ? view.changes > 0 : count > 0, clearAll: clear, foldFilters: foldFilters, onClose: close, closeButton: closeButton, fill: fill, view: view, fieldEditor: fieldEditor })) }));
33
+ }
@@ -0,0 +1,9 @@
1
+ import { type ReactNode } from "react";
2
+ export declare function ToolbarSearch({ value, onChange, placeholder, searching, }: {
3
+ value: string;
4
+ onChange: (value: string) => void;
5
+ /** Default `views.panels.search`. */
6
+ placeholder?: string;
7
+ /** The app's search is under way: a spinner stands where the glass is, and the field stays usable. */
8
+ searching?: boolean;
9
+ }): ReactNode;