@viewkitjs/views 0.4.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 (447) hide show
  1. package/CHANGELOG.md +768 -0
  2. package/README.md +5 -3
  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 +3 -0
  10. package/dist/atoms/DrillRows.js +27 -0
  11. package/dist/atoms/Loading.d.ts +6 -0
  12. package/dist/atoms/Loading.js +4 -1
  13. package/dist/atoms/PanelRows.d.ts +5 -0
  14. package/dist/atoms/PanelRows.js +38 -0
  15. package/dist/atoms/PanelSearch.d.ts +2 -0
  16. package/dist/atoms/PanelSearch.js +21 -0
  17. package/dist/atoms/Pill.d.ts +2 -0
  18. package/dist/atoms/Pill.js +25 -0
  19. package/dist/atoms/RangeCalendar.d.ts +8 -0
  20. package/dist/atoms/RangeCalendar.js +30 -0
  21. package/dist/atoms/RelationRoles.js +2 -2
  22. package/dist/atoms/SelectionSheet.d.ts +3 -0
  23. package/dist/atoms/SelectionSheet.js +31 -0
  24. package/dist/atoms/ToolbarButton.d.ts +2 -0
  25. package/dist/atoms/ToolbarButton.js +18 -0
  26. package/dist/atoms/defaults.js +22 -0
  27. package/dist/atoms/types.d.ts +257 -1
  28. package/dist/cells/cell-format.d.ts +10 -1
  29. package/dist/cells/cell-title.d.ts +5 -1
  30. package/dist/cells/cell-title.js +2 -2
  31. package/dist/cells/cell-values.js +22 -7
  32. package/dist/cells/relation-wrap.js +1 -1
  33. package/dist/contract.d.ts +515 -18
  34. package/dist/contract.js +660 -5
  35. package/dist/display/actor.js +1 -1
  36. package/dist/display/boolean.js +5 -0
  37. package/dist/display/entity-chip.d.ts +12 -9
  38. package/dist/display/entity-chip.js +4 -5
  39. package/dist/display/fit-values.d.ts +34 -0
  40. package/dist/display/fit-values.js +45 -0
  41. package/dist/display/location.js +1 -1
  42. package/dist/display/multi-value.js +72 -8
  43. package/dist/display/options.d.ts +9 -1
  44. package/dist/display/relation.js +1 -1
  45. package/dist/display/rich-text.js +17 -6
  46. package/dist/display/select.js +6 -4
  47. package/dist/display/status-steps.d.ts +8 -0
  48. package/dist/display/status-steps.js +18 -0
  49. package/dist/display/viewer.js +1 -0
  50. package/dist/editors/BodyFrame.d.ts +29 -0
  51. package/dist/editors/BodyFrame.js +80 -0
  52. package/dist/editors/DateEditor.js +13 -17
  53. package/dist/editors/LocationEditor.d.ts +2 -0
  54. package/dist/editors/LocationEditor.js +29 -5
  55. package/dist/editors/NameEditor.d.ts +2 -0
  56. package/dist/editors/NameEditor.js +27 -7
  57. package/dist/editors/NumberEditor.d.ts +18 -0
  58. package/dist/editors/NumberEditor.js +29 -2
  59. package/dist/editors/RangeEditor.d.ts +2 -0
  60. package/dist/editors/RangeEditor.js +29 -4
  61. package/dist/editors/SelectEditor.d.ts +5 -0
  62. package/dist/editors/SelectEditor.js +3 -2
  63. package/dist/editors/TextEditor.d.ts +11 -1
  64. package/dist/editors/TextEditor.js +25 -8
  65. package/dist/editors/ValueListEditor.d.ts +7 -0
  66. package/dist/editors/ValueListEditor.js +60 -48
  67. package/dist/editors/body-panel.d.ts +7 -0
  68. package/dist/editors/body-panel.js +8 -0
  69. package/dist/editors/edit-session.d.ts +20 -3
  70. package/dist/editors/edit-session.js +43 -3
  71. package/dist/editors/leave-scope.d.ts +23 -0
  72. package/dist/editors/leave-scope.js +28 -0
  73. package/dist/editors/number-body.d.ts +29 -0
  74. package/dist/editors/number-body.js +37 -0
  75. package/dist/editors/parts-body.d.ts +66 -0
  76. package/dist/editors/parts-body.js +114 -0
  77. package/dist/editors/tab-ends.d.ts +5 -0
  78. package/dist/editors/tab-ends.js +7 -0
  79. package/dist/editors/text-body.d.ts +16 -0
  80. package/dist/editors/text-body.js +30 -0
  81. package/dist/editors/values-body.d.ts +47 -0
  82. package/dist/editors/values-body.js +140 -0
  83. package/dist/field-row/FieldRow.d.ts +7 -0
  84. package/dist/field-row/FieldRow.js +44 -24
  85. package/dist/field-row/FieldRowLane.js +12 -4
  86. package/dist/field-row/editors/RowChipsEditor.js +3 -1
  87. package/dist/field-row/editors/RowEditor.js +2 -1
  88. package/dist/field-row/editors/RowNameEditor.d.ts +5 -2
  89. package/dist/field-row/editors/RowNameEditor.js +12 -5
  90. package/dist/field-row/editors/RowNumberEditor.js +18 -2
  91. package/dist/field-row/editors/RowPlaceEditor.js +4 -2
  92. package/dist/field-row/editors/RowRangeEditor.d.ts +5 -2
  93. package/dist/field-row/editors/RowRangeEditor.js +13 -6
  94. package/dist/field-row/editors/RowRelationEditor.js +5 -2
  95. package/dist/field-row/editors/RowSelectEditor.js +4 -1
  96. package/dist/field-row/editors/RowTextEditor.d.ts +1 -1
  97. package/dist/field-row/editors/RowTextEditor.js +12 -3
  98. package/dist/field-row/editors/RowValueListEditor.d.ts +2 -1
  99. package/dist/field-row/editors/RowValueListEditor.js +17 -4
  100. package/dist/field-row/editors/host.d.ts +3 -0
  101. package/dist/field-row/editors/row-session.d.ts +12 -1
  102. package/dist/field-row/editors/row-session.js +52 -2
  103. package/dist/field-row/field-row-button.d.ts +40 -0
  104. package/dist/field-row/field-row-button.js +18 -0
  105. package/dist/field-row/field-row-checkbox.d.ts +9 -0
  106. package/dist/field-row/field-row-checkbox.js +7 -0
  107. package/dist/figures.d.ts +5 -48
  108. package/dist/figures.js +1 -63
  109. package/dist/filters/filter-model.d.ts +2 -0
  110. package/dist/grid/chrome/GridAddColumn.js +17 -3
  111. package/dist/grid/chrome/GridAggregateMenu.d.ts +2 -0
  112. package/dist/grid/chrome/GridAggregateMenu.js +2 -0
  113. package/dist/grid/chrome/GridCellEditors.js +16 -6
  114. package/dist/grid/chrome/GridCellOutline.d.ts +7 -4
  115. package/dist/grid/chrome/GridCellOutline.js +4 -2
  116. package/dist/grid/chrome/GridChipsEditor.js +3 -1
  117. package/dist/grid/chrome/GridColumnMenu.d.ts +7 -4
  118. package/dist/grid/chrome/GridColumnMenu.js +5 -3
  119. package/dist/grid/chrome/GridColumnSortSection.d.ts +23 -3
  120. package/dist/grid/chrome/GridColumnSortSection.js +18 -1
  121. package/dist/grid/chrome/GridFooter.d.ts +4 -1
  122. package/dist/grid/chrome/GridFooter.js +6 -4
  123. package/dist/grid/chrome/GridGroupMenu.d.ts +7 -3
  124. package/dist/grid/chrome/GridGroupMenu.js +30 -8
  125. package/dist/grid/chrome/GridHeader.d.ts +5 -1
  126. package/dist/grid/chrome/GridHeader.js +9 -5
  127. package/dist/grid/chrome/GridLongTextEditor.js +15 -11
  128. package/dist/grid/chrome/GridNameEditor.js +4 -2
  129. package/dist/grid/chrome/GridNumberEditor.d.ts +8 -1
  130. package/dist/grid/chrome/GridNumberEditor.js +15 -3
  131. package/dist/grid/chrome/GridPager.d.ts +7 -0
  132. package/dist/grid/chrome/GridPager.js +34 -0
  133. package/dist/grid/chrome/GridPlaceEditor.js +4 -2
  134. package/dist/grid/chrome/GridRangeEditor.js +12 -4
  135. package/dist/grid/chrome/GridRelationEditor.js +5 -2
  136. package/dist/grid/chrome/GridRow.js +18 -6
  137. package/dist/grid/chrome/GridRowActions.d.ts +8 -3
  138. package/dist/grid/chrome/GridRowActions.js +16 -6
  139. package/dist/grid/chrome/GridRowCells.js +23 -7
  140. package/dist/grid/chrome/GridRowGlyph.d.ts +3 -1
  141. package/dist/grid/chrome/GridRowGlyph.js +7 -2
  142. package/dist/grid/chrome/GridSelectEditor.js +6 -3
  143. package/dist/grid/chrome/GridStructure.d.ts +6 -1
  144. package/dist/grid/chrome/GridStructure.js +32 -8
  145. package/dist/grid/chrome/GridTable.js +36 -24
  146. package/dist/grid/chrome/GridTableSurface.d.ts +5 -1
  147. package/dist/grid/chrome/GridTableSurface.js +5 -2
  148. package/dist/grid/chrome/GridTextEditor.d.ts +5 -1
  149. package/dist/grid/chrome/GridTextEditor.js +13 -3
  150. package/dist/grid/chrome/GridValueListEditor.d.ts +12 -4
  151. package/dist/grid/chrome/GridValueListEditor.js +11 -3
  152. package/dist/grid/chrome/StuckMarker.d.ts +3 -1
  153. package/dist/grid/chrome/StuckMarker.js +6 -2
  154. package/dist/grid/chrome/cells.d.ts +4 -2
  155. package/dist/grid/chrome/cells.js +2 -2
  156. package/dist/grid/chrome/grid-add-column-items.d.ts +1 -1
  157. package/dist/grid/chrome/grid-add-column-items.js +8 -1
  158. package/dist/grid/chrome/grid-button.d.ts +32 -0
  159. package/dist/grid/chrome/grid-button.js +12 -0
  160. package/dist/grid/chrome/grid-cell-classes.d.ts +38 -0
  161. package/dist/grid/chrome/grid-cell-classes.js +30 -0
  162. package/dist/grid/chrome/grid-column-menu-items.d.ts +3 -0
  163. package/dist/grid/chrome/grid-column-menu-items.js +32 -3
  164. package/dist/grid/chrome/grid-columns-template.d.ts +27 -0
  165. package/dist/grid/chrome/grid-columns-template.js +13 -0
  166. package/dist/grid/chrome/grid-edit-session.d.ts +4 -1
  167. package/dist/grid/chrome/grid-edit-session.js +11 -1
  168. package/dist/grid/chrome/grid-group-menu-items.d.ts +8 -1
  169. package/dist/grid/chrome/grid-group-menu-items.js +17 -0
  170. package/dist/grid/chrome/grid-group-menu-parts.d.ts +10 -6
  171. package/dist/grid/chrome/grid-group-menu-parts.js +4 -2
  172. package/dist/grid/chrome/grid-hover.d.ts +4 -1
  173. package/dist/grid/chrome/grid-hover.js +16 -6
  174. package/dist/grid/chrome/grid-pages.d.ts +15 -0
  175. package/dist/grid/chrome/grid-pages.js +9 -0
  176. package/dist/grid/chrome/grid-row-menu-items.js +18 -10
  177. package/dist/grid/chrome/grid-row-props.d.ts +6 -2
  178. package/dist/grid/chrome/grid-row-window.d.ts +7 -0
  179. package/dist/grid/chrome/grid-row-window.js +35 -1
  180. package/dist/grid/chrome/grid-table-props.d.ts +38 -4
  181. package/dist/grid/chrome/useGridColumnLayout.d.ts +3 -1
  182. package/dist/grid/chrome/useGridColumnLayout.js +29 -9
  183. package/dist/grid/chrome/useGridPartColumns.js +1 -1
  184. package/dist/grid/chrome/useGridScrollArea.js +2 -0
  185. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +1 -0
  186. package/dist/grid/chrome/useGridTableInteractionModel.js +5 -3
  187. package/dist/grid/chrome/useGridTableSelection.d.ts +3 -1
  188. package/dist/grid/chrome/useGridTableSelection.js +2 -2
  189. package/dist/grid/chrome/useHeaderDragReorder.js +2 -0
  190. package/dist/grid/core/editing-controller.d.ts +36 -11
  191. package/dist/grid/core/editing-controller.js +92 -25
  192. package/dist/grid/core/grid-aria.d.ts +4 -0
  193. package/dist/grid/core/grid-aria.js +6 -4
  194. package/dist/grid/core/grid-focus.d.ts +6 -0
  195. package/dist/grid/core/grid-focus.js +28 -5
  196. package/dist/grid/core/useGridEditing.d.ts +11 -2
  197. package/dist/grid/core/useGridEditing.js +9 -5
  198. package/dist/grid/core/write-states.d.ts +20 -0
  199. package/dist/grid/core/write-states.js +21 -0
  200. package/dist/grid/grid-format-props.d.ts +26 -0
  201. package/dist/grid/grid-format-props.js +65 -0
  202. package/dist/grid/index.d.ts +3 -1
  203. package/dist/grid/index.js +1 -0
  204. package/dist/grid/useGridTablePrefs.d.ts +20 -21
  205. package/dist/grid/useGridTablePrefs.js +6 -58
  206. package/dist/grid/useGridTableSettings.d.ts +60 -0
  207. package/dist/grid/useGridTableSettings.js +61 -0
  208. package/dist/grouping/sort-groups.d.ts +6 -7
  209. package/dist/internal/count.d.ts +3 -0
  210. package/dist/internal/count.js +3 -0
  211. package/dist/model/aggregates.d.ts +3 -3
  212. package/dist/model/aggregates.js +17 -71
  213. package/dist/model/body-frame.d.ts +16 -0
  214. package/dist/model/body-frame.js +5 -0
  215. package/dist/model/column-capabilities.d.ts +4 -1
  216. package/dist/model/column-capabilities.js +4 -1
  217. package/dist/model/column-filters.d.ts +7 -4
  218. package/dist/model/column-filters.js +26 -18
  219. package/dist/model/column-inspect.d.ts +3 -2
  220. package/dist/model/column-inspect.js +3 -1
  221. package/dist/model/column-order.d.ts +2 -2
  222. package/dist/model/column-schema.d.ts +6 -7
  223. package/dist/model/column-sort.d.ts +11 -0
  224. package/dist/model/column-sort.js +14 -0
  225. package/dist/model/column-state.d.ts +3 -20
  226. package/dist/model/column-state.js +1 -4
  227. package/dist/model/column-types.d.ts +1 -15
  228. package/dist/model/column-types.js +1 -1
  229. package/dist/model/one-value.d.ts +6 -0
  230. package/dist/model/one-value.js +5 -0
  231. package/dist/model/part-columns.d.ts +1 -6
  232. package/dist/model/part-columns.js +1 -1
  233. package/dist/model/part-rows.d.ts +2 -9
  234. package/dist/model/part-rows.js +1 -10
  235. package/dist/model/part-write.js +1 -1
  236. package/dist/model/place-parts.d.ts +6 -0
  237. package/dist/model/place-parts.js +14 -0
  238. package/dist/model/preferences.d.ts +3 -23
  239. package/dist/model/preferences.js +1 -17
  240. package/dist/model/prefs-buckets.d.ts +0 -27
  241. package/dist/model/prefs-buckets.js +1 -1
  242. package/dist/model/relation-filters.d.ts +13 -3
  243. package/dist/model/relation-filters.js +9 -4
  244. package/dist/model/row-icon.d.ts +17 -11
  245. package/dist/model/settings-columns.d.ts +34 -0
  246. package/dist/model/settings-columns.js +146 -0
  247. package/dist/model/settings-look.d.ts +17 -0
  248. package/dist/model/settings-look.js +23 -0
  249. package/dist/model/view-rules.d.ts +32 -6
  250. package/dist/model/view-rules.js +99 -23
  251. package/dist/panels/availability.d.ts +26 -0
  252. package/dist/panels/availability.js +28 -0
  253. package/dist/panels/filter/DateFilterBody.d.ts +42 -0
  254. package/dist/panels/filter/DateFilterBody.js +64 -0
  255. package/dist/panels/filter/DateFilterCalendar.d.ts +19 -0
  256. package/dist/panels/filter/DateFilterCalendar.js +37 -0
  257. package/dist/panels/filter/DateFilterInput.d.ts +16 -0
  258. package/dist/panels/filter/DateFilterInput.js +37 -0
  259. package/dist/panels/filter/FilterIcon.d.ts +7 -0
  260. package/dist/panels/filter/FilterIcon.js +15 -0
  261. package/dist/panels/filter/MenuSelect.d.ts +12 -0
  262. package/dist/panels/filter/MenuSelect.js +34 -0
  263. package/dist/panels/filter/NumberFilterBody.d.ts +21 -0
  264. package/dist/panels/filter/NumberFilterBody.js +76 -0
  265. package/dist/panels/filter/RangeFilterBody.d.ts +19 -0
  266. package/dist/panels/filter/RangeFilterBody.js +71 -0
  267. package/dist/panels/filter/RelationFilterBody.d.ts +17 -0
  268. package/dist/panels/filter/RelationFilterBody.js +20 -0
  269. package/dist/panels/filter/TextFilterBody.d.ts +31 -0
  270. package/dist/panels/filter/TextFilterBody.js +44 -0
  271. package/dist/panels/filter/TimeScopeDetail.d.ts +6 -0
  272. package/dist/panels/filter/TimeScopeDetail.js +47 -0
  273. package/dist/panels/filter/details.d.ts +17 -0
  274. package/dist/panels/filter/details.js +73 -0
  275. package/dist/panels/filter/filter-list.d.ts +23 -0
  276. package/dist/panels/filter/filter-list.js +38 -0
  277. package/dist/panels/group-sort.d.ts +24 -0
  278. package/dist/panels/group-sort.js +58 -0
  279. package/dist/panels/index.d.ts +24 -0
  280. package/dist/panels/index.js +17 -0
  281. package/dist/panels/labels.d.ts +37 -0
  282. package/dist/panels/labels.js +166 -0
  283. package/dist/panels/model.d.ts +343 -0
  284. package/dist/panels/model.js +77 -0
  285. package/dist/panels/react/GroupBucketsList.d.ts +16 -0
  286. package/dist/panels/react/GroupBucketsList.js +38 -0
  287. package/dist/panels/react/LayoutColumnsList.d.ts +24 -0
  288. package/dist/panels/react/LayoutColumnsList.js +71 -0
  289. package/dist/panels/react/PopoverColumnDetail.d.ts +11 -0
  290. package/dist/panels/react/PopoverColumnDetail.js +24 -0
  291. package/dist/panels/react/chrome.d.ts +17 -0
  292. package/dist/panels/react/chrome.js +8 -0
  293. package/dist/panels/react/column-refusals.d.ts +7 -0
  294. package/dist/panels/react/column-refusals.js +14 -0
  295. package/dist/panels/react/customize.d.ts +26 -0
  296. package/dist/panels/react/customize.js +98 -0
  297. package/dist/panels/react/drag.d.ts +2 -0
  298. package/dist/panels/react/drag.js +6 -0
  299. package/dist/panels/react/field-editor.d.ts +10 -0
  300. package/dist/panels/react/field-editor.js +1 -0
  301. package/dist/panels/react/filter-panel.d.ts +15 -0
  302. package/dist/panels/react/filter-panel.js +48 -0
  303. package/dist/panels/react/layout-detail.d.ts +4 -0
  304. package/dist/panels/react/layout-detail.js +21 -0
  305. package/dist/panels/react/order-details.d.ts +32 -0
  306. package/dist/panels/react/order-details.js +81 -0
  307. package/dist/panels/react/panel-header.d.ts +10 -0
  308. package/dist/panels/react/panel-header.js +12 -0
  309. package/dist/panels/react/panel-sheet.d.ts +19 -0
  310. package/dist/panels/react/panel-sheet.js +22 -0
  311. package/dist/panels/react/popover.d.ts +71 -0
  312. package/dist/panels/react/popover.js +47 -0
  313. package/dist/panels/react/root-list.d.ts +6 -0
  314. package/dist/panels/react/root-list.js +31 -0
  315. package/dist/panels/react/toolbar/ReadyToolbar.d.ts +42 -0
  316. package/dist/panels/react/toolbar/ReadyToolbar.js +92 -0
  317. package/dist/panels/react/toolbar/Toolbar.d.ts +16 -0
  318. package/dist/panels/react/toolbar/Toolbar.js +34 -0
  319. package/dist/panels/react/toolbar/ToolbarButton.d.ts +5 -0
  320. package/dist/panels/react/toolbar/ToolbarButton.js +9 -0
  321. package/dist/panels/react/toolbar/ToolbarFilter.d.ts +19 -0
  322. package/dist/panels/react/toolbar/ToolbarFilter.js +32 -0
  323. package/dist/panels/react/toolbar/ToolbarNew.d.ts +12 -0
  324. package/dist/panels/react/toolbar/ToolbarNew.js +21 -0
  325. package/dist/panels/react/toolbar/ToolbarOptions.d.ts +25 -0
  326. package/dist/panels/react/toolbar/ToolbarOptions.js +33 -0
  327. package/dist/panels/react/toolbar/ToolbarSearch.d.ts +9 -0
  328. package/dist/panels/react/toolbar/ToolbarSearch.js +41 -0
  329. package/dist/panels/react/toolbar/ToolbarSort.d.ts +12 -0
  330. package/dist/panels/react/toolbar/ToolbarSort.js +16 -0
  331. package/dist/panels/react/toolbar/ToolbarViews.d.ts +13 -0
  332. package/dist/panels/react/toolbar/ToolbarViews.js +24 -0
  333. package/dist/panels/react/toolbar/context.d.ts +29 -0
  334. package/dist/panels/react/toolbar/context.js +49 -0
  335. package/dist/panels/react/toolbar/panel-part.d.ts +37 -0
  336. package/dist/panels/react/toolbar/panel-part.js +37 -0
  337. package/dist/panels/react/toolbar/panel-state.d.ts +9 -0
  338. package/dist/panels/react/toolbar/panel-state.js +12 -0
  339. package/dist/panels/react/toolbar/use-box-narrow.d.ts +2 -0
  340. package/dist/panels/react/toolbar/use-box-narrow.js +18 -0
  341. package/dist/panels/react/toolbar/use-list-settings-state.d.ts +10 -0
  342. package/dist/panels/react/toolbar/use-list-settings-state.js +10 -0
  343. package/dist/panels/react/view-actions.d.ts +4 -0
  344. package/dist/panels/react/view-actions.js +37 -0
  345. package/dist/panels/react/view-footer.d.ts +16 -0
  346. package/dist/panels/react/view-footer.js +11 -0
  347. package/dist/panels/react/views-row/FoldingViewRow.d.ts +4 -0
  348. package/dist/panels/react/views-row/FoldingViewRow.js +105 -0
  349. package/dist/panels/react/views-row/HScrollRow.d.ts +7 -0
  350. package/dist/panels/react/views-row/HScrollRow.js +42 -0
  351. package/dist/panels/react/views-row/PillGroup.d.ts +30 -0
  352. package/dist/panels/react/views-row/PillGroup.js +86 -0
  353. package/dist/panels/react/views-row/ViewAxes.d.ts +6 -0
  354. package/dist/panels/react/views-row/ViewAxes.js +16 -0
  355. package/dist/panels/react/views-row/ViewCreatePill.d.ts +7 -0
  356. package/dist/panels/react/views-row/ViewCreatePill.js +11 -0
  357. package/dist/panels/react/views-row/ViewPicker.d.ts +5 -0
  358. package/dist/panels/react/views-row/ViewPicker.js +65 -0
  359. package/dist/panels/react/views-row/ViewPickerRow.d.ts +7 -0
  360. package/dist/panels/react/views-row/ViewPickerRow.js +18 -0
  361. package/dist/panels/react/views-row/ViewTabs.d.ts +31 -0
  362. package/dist/panels/react/views-row/ViewTabs.js +29 -0
  363. package/dist/panels/react/views-row/menu-classes.d.ts +6 -0
  364. package/dist/panels/react/views-row/menu-classes.js +3 -0
  365. package/dist/panels/react/views-row/use-anchored-toggle.d.ts +19 -0
  366. package/dist/panels/react/views-row/use-anchored-toggle.js +31 -0
  367. package/dist/panels/react.d.ts +51 -0
  368. package/dist/panels/react.js +43 -0
  369. package/dist/panels/settings/axes.d.ts +28 -0
  370. package/dist/panels/settings/axes.js +71 -0
  371. package/dist/panels/settings/filters.d.ts +5 -0
  372. package/dist/panels/settings/filters.js +62 -0
  373. package/dist/panels/settings/group-buckets.d.ts +23 -0
  374. package/dist/panels/settings/group-buckets.js +73 -0
  375. package/dist/panels/settings/input.d.ts +69 -0
  376. package/dist/panels/settings/input.js +1 -0
  377. package/dist/panels/settings/layout.d.ts +5 -0
  378. package/dist/panels/settings/layout.js +244 -0
  379. package/dist/panels/settings/order.d.ts +19 -0
  380. package/dist/panels/settings/order.js +271 -0
  381. package/dist/panels/settings/settings-panels.d.ts +17 -0
  382. package/dist/panels/settings/settings-panels.js +28 -0
  383. package/dist/panels/toolbar/clear.d.ts +9 -0
  384. package/dist/panels/toolbar/clear.js +26 -0
  385. package/dist/panels/toolbar/counts.d.ts +15 -0
  386. package/dist/panels/toolbar/counts.js +21 -0
  387. package/dist/panels/toolbar/edit-view.d.ts +5 -0
  388. package/dist/panels/toolbar/edit-view.js +18 -0
  389. package/dist/panels/toolbar/model.d.ts +34 -0
  390. package/dist/panels/toolbar/model.js +52 -0
  391. package/dist/panels/use-filter-opened.d.ts +8 -0
  392. package/dist/panels/use-filter-opened.js +11 -0
  393. package/dist/panels/view-state.d.ts +38 -0
  394. package/dist/panels/view-state.js +1 -0
  395. package/dist/panels/views-row/model.d.ts +131 -0
  396. package/dist/panels/views-row/model.js +14 -0
  397. package/dist/provider/ViewsProvider.d.ts +50 -6
  398. package/dist/provider/ViewsProvider.js +33 -2
  399. package/dist/provider/components.d.ts +274 -11
  400. package/dist/provider/context.d.ts +23 -2
  401. package/dist/provider/desktop.d.ts +3 -0
  402. package/dist/provider/desktop.js +7 -4
  403. package/dist/react.d.ts +5 -2
  404. package/dist/selection/SelectionBar.d.ts +18 -0
  405. package/dist/selection/SelectionBar.js +98 -0
  406. package/dist/selection/SelectionBarPhone.d.ts +3 -0
  407. package/dist/selection/SelectionBarPhone.js +14 -0
  408. package/dist/selection/bar-overflow.d.ts +12 -0
  409. package/dist/selection/bar-overflow.js +55 -0
  410. package/dist/selection/bar-parts.d.ts +17 -0
  411. package/dist/selection/bar-parts.js +19 -0
  412. package/dist/selection/index.d.ts +2 -0
  413. package/dist/selection/index.js +1 -0
  414. package/dist/selection/types.d.ts +3 -2
  415. package/dist/selection/useListSelectionShortcuts.d.ts +3 -2
  416. package/dist/selection/useListSelectionShortcuts.js +1 -1
  417. package/dist/selection/verbs.d.ts +41 -0
  418. package/dist/selection/verbs.js +1 -0
  419. package/docs/contract.md +355 -35
  420. package/docs/getting-started.md +1 -1
  421. package/docs/guides/atoms.md +39 -6
  422. package/docs/guides/columns.md +1 -1
  423. package/docs/guides/display.md +3 -2
  424. package/docs/guides/editors.md +4 -3
  425. package/docs/guides/selection.md +35 -21
  426. package/docs/guides/the-grid.md +24 -13
  427. package/docs/guides/the-provider.md +24 -6
  428. package/docs/index.md +2 -0
  429. package/docs/install.md +3 -1
  430. package/docs/reference/cells.md +1 -1
  431. package/docs/reference/display.md +5 -4
  432. package/docs/reference/editors-location.md +3 -1
  433. package/docs/reference/editors-name.md +3 -1
  434. package/docs/reference/editors-number.md +1 -0
  435. package/docs/reference/editors-range.md +3 -1
  436. package/docs/reference/editors-session.md +1 -0
  437. package/docs/reference/editors-text.md +2 -2
  438. package/docs/reference/editors-value-list.md +1 -1
  439. package/docs/reference/field-row.md +2 -2
  440. package/docs/reference/grid.md +10 -7
  441. package/docs/reference/panels-react.md +101 -0
  442. package/docs/reference/panels.md +123 -0
  443. package/docs/reference/react.md +45 -12
  444. package/docs/reference/selection.md +11 -3
  445. package/docs/reference/views.md +41 -38
  446. package/package.json +33 -4
  447. package/skills/views/SKILL.md +5 -4
@@ -0,0 +1,17 @@
1
+ import { type ListDensity, type ListPersonalLayer, type ListSettings, type ListSettingsChange } from "@viewkitjs/fields/query";
2
+ import { type ListDefaults } from "./prefs-buckets.js";
3
+ /** Every look setting, resolved. */
4
+ export type SeenLook = {
5
+ density: ListDensity;
6
+ verticalBorders: boolean;
7
+ rowIcon: boolean;
8
+ freezeIdentity: boolean;
9
+ alwaysCheckboxes: boolean;
10
+ };
11
+ /** The look a person sees: their layer's, else the view's, else the default (the reader's own, for vertical
12
+ * borders). */
13
+ export declare function seenLook(settings: ListSettings, layer: ListPersonalLayer, defaults?: ListDefaults): SeenLook;
14
+ /** One look setting set on the view, as a change. `null` takes it out. Vertical borders set to the reader's default
15
+ * is the view following that default: the key is taken out, so a default changed later still reaches the view.
16
+ * Empty when nothing changes. */
17
+ export declare function lookChange<K extends keyof SeenLook>(settings: ListSettings, key: K, value: SeenLook[K] | null, defaults?: ListDefaults): ListSettingsChange;
@@ -0,0 +1,23 @@
1
+ import { settingsChange, } from "@viewkitjs/fields/query";
2
+ import { LIST_VIEW_PREF_DEFAULTS } from "./preferences.js";
3
+ import { verticalBordersDefault } from "./prefs-buckets.js";
4
+ export function seenLook(settings, layer, defaults) {
5
+ const view = settings.look;
6
+ const own = layer.look ?? {};
7
+ return {
8
+ density: own.density ?? view.density ?? LIST_VIEW_PREF_DEFAULTS.gridScale,
9
+ verticalBorders: own.verticalBorders ?? view.verticalBorders ?? verticalBordersDefault(defaults),
10
+ rowIcon: own.rowIcon ?? view.rowIcon ?? LIST_VIEW_PREF_DEFAULTS.gridRowIcon,
11
+ freezeIdentity: own.freezeIdentity ?? view.freezeIdentity ?? LIST_VIEW_PREF_DEFAULTS.gridFreezeIdentity,
12
+ alwaysCheckboxes: own.alwaysCheckboxes ?? view.alwaysCheckboxes ?? LIST_VIEW_PREF_DEFAULTS.gridAlwaysCheckboxes,
13
+ };
14
+ }
15
+ export function lookChange(settings, key, value, defaults) {
16
+ const follows = key === "verticalBorders" && value === verticalBordersDefault(defaults);
17
+ const look = { ...settings.look };
18
+ if (follows || value === null)
19
+ delete look[key];
20
+ else
21
+ look[key] = value;
22
+ return settingsChange(settings, { ...settings, look });
23
+ }
@@ -1,5 +1,5 @@
1
1
  import { type FieldType } from "@viewkitjs/fields";
2
- import { type FilterRelationRule, type FilterRule, type FilterTree, type ViewFieldReader } from "@viewkitjs/fields/query";
2
+ import { type FilterNode, type FilterRelationRule, type FilterRule, type FilterTree, type ViewFieldReader } from "@viewkitjs/fields/query";
3
3
  import type { ListColumn } from "./column-schema.js";
4
4
  import type { ListFilterRule, ListFilterRuleState } from "./preferences.js";
5
5
  /** THE KEY A COLUMN IS KNOWN BY OFF THE GRID — its FIELD, when it has one, and
@@ -29,15 +29,41 @@ opts?: {
29
29
  export declare function rootRulesByColumn<Row>(tree: FilterTree, columns: ListColumn<Row>[], opts?: {
30
30
  parts?: boolean;
31
31
  }): ListFilterRuleState;
32
- /** The tree with its root rules replaced by `state`, a whole-value key per column and, with `parts`, a part key per
33
- * part row. Groups, relation rules and every rule no panel row can name (a country `is_none_of`, a part no table
34
- * lists, a whole rule `toListFilterRule` maps to null) are kept as they are, never cleared. */
35
- export declare function withRootRuleState<Row>(tree: FilterTree, columns: ListColumn<Row>[], state: ListFilterRuleState, opts?: {
32
+ /** A filter tree as a panel edits it. */
33
+ export type FilterPanelState = {
34
+ /** How the root's items combine. */
35
+ op: FilterTree["op"];
36
+ /** One rule per row: a column's whole value under its id; with `parts`, a part row's under its part key. */
37
+ rules: ListFilterRuleState;
38
+ /** Every root item no row draws, whole and in its order: and/or/not groups, relation rules, a second rule on a row
39
+ * already drawn, and a rule no row can show (an operator its editor doesn't write, a field no column carries). */
40
+ rest: readonly FilterNode[];
41
+ };
42
+ /** A quick-filter panel's picks, by field key: an option's codes, a yes/no field's "true" or "false". */
43
+ export type QuickValues = Readonly<Record<string, readonly string[]>>;
44
+ /** A field a quick-filter panel offers: its key and the type its value is read as, one whose rule picks options. */
45
+ export type QuickValueField = {
46
+ key: string;
47
+ type: FieldType;
48
+ };
49
+ /** The tree as the panel draws it: a rule per column (and, with `parts`, per part row), and the rest kept whole. */
50
+ export declare function filterPanelFromTree<Row>(tree: FilterTree, columns: ListColumn<Row>[], opts?: {
51
+ parts?: boolean;
52
+ }): FilterPanelState;
53
+ /** The tree the panel's state says: the rows' rules in column order, then the rest as it was kept. A key no row
54
+ * names writes nothing. `treeFromFilterPanel(filterPanelFromTree(tree))` holds every rule `tree` held. */
55
+ export declare function treeFromFilterPanel<Row>(panel: FilterPanelState, columns: ListColumn<Row>[], opts?: {
36
56
  parts?: boolean;
37
57
  }): FilterTree;
58
+ /** The picks a quick-filter panel draws: each offered field's root rule that picks options, as its values. */
59
+ export declare function quickValuesFromTree(tree: FilterTree, fields: readonly QuickValueField[]): QuickValues;
60
+ /** The tree with the offered fields' picks written as ordinary root rules (a field with none picked has none);
61
+ * every other item kept, a rule on an offered field the panel can't show (an `is_none_of`) among them. */
62
+ export declare function withQuickValues(tree: FilterTree, fields: readonly QuickValueField[], values: QuickValues): FilterTree;
38
63
  /** The root relation rules, by relation field key — the Filter panel's Related records rows (POR-704). */
39
64
  export declare function rootRelationRules(tree: FilterTree): Record<string, FilterRelationRule>;
40
- /** The tree with its root relation rules replaced by `rules`; every other rule and group untouched. */
65
+ /** The tree with its root relation rules replaced by `rules`; every other rule and group untouched, and a set-aside
66
+ * relation rule kept, since no row shows it. */
41
67
  export declare function withRootRelationRules(tree: FilterTree, rules: Readonly<Record<string, FilterRelationRule>>): FilterTree;
42
68
  /** Replace (or drop, on null) the root rule for one column, or with `part` its rule on that part of the value; groups
43
69
  * untouched. */
@@ -2,20 +2,30 @@ import { valueTypeOf } from "@viewkitjs/fields";
2
2
  import { denominationOf } from "../fields/denomination.js";
3
3
  import { isFilterGroup, isRelationRule, operatorsFor, } from "@viewkitjs/fields/query";
4
4
  import { FILTER_PART_ROWS, partKey } from "./part-rows.js";
5
+ import { keptParts } from "./place-parts.js";
5
6
  export function fieldKeyOf(col) {
6
7
  return col.field?.key ?? col.id;
7
8
  }
8
9
  export function fromListFilterRule(fieldKey, type, rule, part) {
9
- const whole = wholeFromListFilterRule(fieldKey, type, rule);
10
+ const read = wholeFromListFilterRule(fieldKey, type, rule);
11
+ const whole = read && VALUELESS.has(read.operator) ? { ...read, value: null } : read;
10
12
  return whole && part !== undefined ? { ...whole, part } : whole;
11
13
  }
14
+ const VALUELESS = new Set(["is_empty", "is_not_empty"]);
15
+ function numberEnds(value) {
16
+ return {
17
+ value: value[0] == null ? null : Number(value[0]),
18
+ value2: value[1] == null ? null : Number(value[1]),
19
+ };
20
+ }
12
21
  function wholeFromListFilterRule(fieldKey, type, rule) {
13
22
  switch (rule.editor) {
14
23
  case "text":
15
24
  return { fieldKey, operator: rule.operator, value: rule.query };
16
25
  case "number":
17
26
  return rule.operator === "between"
18
- ? { fieldKey, operator: "between", value: [rule.value ?? 0, rule.value2 ?? 0] }
27
+ ?
28
+ { fieldKey, operator: "between", value: [rule.value ?? null, rule.value2 ?? null] }
19
29
  : { fieldKey, operator: rule.operator, value: rule.value };
20
30
  case "date":
21
31
  if (rule.operator === "is_relative")
@@ -59,12 +69,7 @@ export function toListFilterRule(type, rule, opts) {
59
69
  case "percent":
60
70
  case "currency":
61
71
  if (Array.isArray(rule.value))
62
- return {
63
- editor: "number",
64
- operator: "between",
65
- value: Number(rule.value[0]),
66
- value2: Number(rule.value[1]),
67
- };
72
+ return { editor: "number", operator: "between", ...numberEnds(rule.value) };
68
73
  return {
69
74
  editor: "number",
70
75
  operator: rule.operator,
@@ -131,7 +136,7 @@ function partListFilterRule(type, rule, part) {
131
136
  return null;
132
137
  if (type === "range")
133
138
  return Array.isArray(rule.value)
134
- ? { editor: "number", operator: "between", value: Number(rule.value[0]), value2: Number(rule.value[1]) }
139
+ ? { editor: "number", operator: "between", ...numberEnds(rule.value) }
135
140
  : {
136
141
  editor: "number",
137
142
  operator: rule.operator,
@@ -150,42 +155,112 @@ function partListFilterRule(type, rule, part) {
150
155
  export function rootRulesByColumn(tree, columns, opts) {
151
156
  const out = {};
152
157
  for (const item of tree.items) {
153
- if (isFilterGroup(item) || isRelationRule(item))
158
+ if (isFilterGroup(item) || isRelationRule(item) || item.setAside)
154
159
  continue;
155
160
  const col = columns.find((c) => fieldKeyOf(c) === item.fieldKey);
156
161
  if (!col?.field)
157
162
  continue;
158
- const rule = toListFilterRule(valueTypeOf(col.field), item, opts);
163
+ const type = valueTypeOf(col.field);
164
+ if (item.part !== undefined && !keptParts(col.field, FILTER_PART_ROWS[type] ?? []).includes(item.part))
165
+ continue;
166
+ const rule = toListFilterRule(type, item, opts);
159
167
  if (rule)
160
168
  out[item.part === undefined ? col.id : partKey(col.id, item.part)] = rule;
161
169
  }
162
170
  return out;
163
171
  }
164
- export function withRootRuleState(tree, columns, state, opts) {
165
- const named = rootRulesByColumn(tree, columns, opts);
166
- let next = tree;
172
+ function columnRows(columns, opts) {
173
+ const rows = [];
167
174
  for (const col of columns) {
168
175
  if (!col.field)
169
176
  continue;
170
- const parts = opts?.parts ? (FILTER_PART_ROWS[valueTypeOf(col.field)] ?? []) : [];
171
- for (const part of [undefined, ...parts]) {
172
- const key = part === undefined ? col.id : partKey(col.id, part);
173
- const rule = state[key] ?? null;
174
- if (rule || key in named)
175
- next = withRootRule(next, col, rule, part);
177
+ const type = valueTypeOf(col.field);
178
+ const fieldKey = fieldKeyOf(col);
179
+ rows.push({ key: col.id, fieldKey, type });
180
+ if (opts?.parts)
181
+ for (const part of keptParts(col.field, FILTER_PART_ROWS[type] ?? []))
182
+ rows.push({ key: partKey(col.id, part), fieldKey, type, part });
183
+ }
184
+ return rows;
185
+ }
186
+ const quickRows = (fields) => fields.map((f) => ({ key: f.key, fieldKey: f.key, type: f.type }));
187
+ function sameValue(a, b) {
188
+ if (a === b)
189
+ return true;
190
+ if (Array.isArray(a) || Array.isArray(b))
191
+ return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((x, i) => sameValue(x, b[i]));
192
+ if (a && b && typeof a === "object" && typeof b === "object") {
193
+ const keys = Object.keys(a);
194
+ return (keys.length === Object.keys(b).length &&
195
+ keys.every((k) => sameValue(a[k], b[k])));
196
+ }
197
+ return false;
198
+ }
199
+ function sameRule(a, b) {
200
+ if (a.fieldKey !== b.fieldKey || a.part !== b.part || a.operator !== b.operator)
201
+ return false;
202
+ return VALUELESS.has(a.operator) || sameValue(a.value, b.value);
203
+ }
204
+ function readRows(tree, rows) {
205
+ const rules = {};
206
+ const rest = [];
207
+ for (const item of tree.items) {
208
+ if (isFilterGroup(item) || isRelationRule(item) || item.setAside) {
209
+ rest.push(item);
210
+ continue;
176
211
  }
212
+ const row = rows.find((r) => !(r.key in rules) && r.fieldKey === item.fieldKey && r.part === item.part);
213
+ const rule = row ? toListFilterRule(row.type, item, { parts: true }) : null;
214
+ const back = row && rule ? fromListFilterRule(row.fieldKey, row.type, rule, row.part) : null;
215
+ if (row && rule && back && sameRule(back, item))
216
+ rules[row.key] = rule;
217
+ else
218
+ rest.push(item);
219
+ }
220
+ return { rules, rest };
221
+ }
222
+ function writeRows(op, rows, rules, rest) {
223
+ const items = [];
224
+ for (const row of rows) {
225
+ const rule = rules[row.key];
226
+ const next = rule ? fromListFilterRule(row.fieldKey, row.type, rule, row.part) : null;
227
+ if (next)
228
+ items.push(next);
229
+ }
230
+ return { op, items: [...items, ...rest] };
231
+ }
232
+ export function filterPanelFromTree(tree, columns, opts) {
233
+ return { op: tree.op, ...readRows(tree, columnRows(columns, opts)) };
234
+ }
235
+ export function treeFromFilterPanel(panel, columns, opts) {
236
+ return writeRows(panel.op, columnRows(columns, opts), panel.rules, panel.rest);
237
+ }
238
+ export function quickValuesFromTree(tree, fields) {
239
+ const out = {};
240
+ for (const [key, rule] of Object.entries(readRows(tree, quickRows(fields)).rules))
241
+ if (rule.editor === "options")
242
+ out[key] = rule.values;
243
+ return out;
244
+ }
245
+ export function withQuickValues(tree, fields, values) {
246
+ const rows = quickRows(fields);
247
+ const rules = {};
248
+ for (const f of fields) {
249
+ const picked = values[f.key];
250
+ if (picked?.length)
251
+ rules[f.key] = { editor: "options", values: [...picked] };
177
252
  }
178
- return next;
253
+ return writeRows(tree.op, rows, rules, readRows(tree, rows).rest);
179
254
  }
180
255
  export function rootRelationRules(tree) {
181
256
  const out = {};
182
257
  for (const item of tree.items)
183
- if (isRelationRule(item))
258
+ if (isRelationRule(item) && !item.setAside)
184
259
  out[item.fieldKey] = item;
185
260
  return out;
186
261
  }
187
262
  export function withRootRelationRules(tree, rules) {
188
- const kept = tree.items.filter((item) => !isRelationRule(item));
263
+ const kept = tree.items.filter((item) => !isRelationRule(item) || item.setAside);
189
264
  return { op: tree.op, items: [...kept, ...Object.values(rules)] };
190
265
  }
191
266
  export function withRootRule(tree, col, rule, part) {
@@ -193,6 +268,7 @@ export function withRootRule(tree, col, rule, part) {
193
268
  const type = col.field ? valueTypeOf(col.field) : undefined;
194
269
  const kept = tree.items.filter((item) => isFilterGroup(item) ||
195
270
  isRelationRule(item) ||
271
+ item.setAside ||
196
272
  item.fieldKey !== key ||
197
273
  item.part !== part ||
198
274
  (part !== undefined && (!type || !toListFilterRule(type, item, { parts: true }))));
@@ -0,0 +1,26 @@
1
+ import { type ViewsMessageResolver } from "../contract.js";
2
+ import type { LayoutConfig, LayoutViewChoice, ToggleConfig, ViewOptionInputs } from "./model.js";
3
+ /**
4
+ * Which sections of the view options exist for a render, and on which
5
+ * viewport. Split from `model.ts` — the server-safe contracts — so that file
6
+ * holds shapes and the small predicates on them, and this one the two
7
+ * resolutions the desktop popover and the mobile sheet both draw from.
8
+ */
9
+ /** What the "For you" section actually shows, resolved once so the desktop
10
+ * popover and the mobile sheet can't drift on the gate or the fallback label —
11
+ * they render the same three fields with different chrome. `null` means the
12
+ * section does not exist for this render (no `personal`, or one with nothing
13
+ * in it for the active view). */
14
+ type ResolvedPersonalSection<V extends string = string> = {
15
+ label: string;
16
+ toggles: ToggleConfig[];
17
+ choices: LayoutViewChoice<V>[];
18
+ onReset?: () => void;
19
+ };
20
+ export declare function resolvePersonalSection<V extends string>(layout: LayoutConfig<V>, messages?: ViewsMessageResolver): ResolvedPersonalSection<V> | null;
21
+ /** Desktop-only controls must not create an empty mobile View sheet. */
22
+ export declare function getViewOptionAvailability<S extends string, G extends string, T extends string>({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, }: ViewOptionInputs<S, G, T>): {
23
+ desktop: boolean;
24
+ mobile: boolean;
25
+ };
26
+ export {};
@@ -0,0 +1,28 @@
1
+ import { resolveViewsMessage } from "../contract.js";
2
+ export function resolvePersonalSection(layout, messages = resolveViewsMessage) {
3
+ const personal = layout.personal;
4
+ if (!personal)
5
+ return null;
6
+ const toggles = personal.toggles ?? [];
7
+ const choices = (personal.choices ?? []).filter((choice) => !choice.views || choice.views.includes(layout.value));
8
+ if (toggles.length === 0 && choices.length === 0)
9
+ return null;
10
+ return {
11
+ label: personal.label ?? messages({ key: "views.panels.for-you" }),
12
+ toggles,
13
+ choices,
14
+ onReset: personal.onReset,
15
+ };
16
+ }
17
+ export function getViewOptionAvailability({ filters, sort, group, timeScopeConfig, dateRangeConfigs, toggles, layout, }) {
18
+ const shared = !!filters?.length || !!sort || !!group || !!timeScopeConfig || !!dateRangeConfigs?.length;
19
+ const hasPersonal = layout ? resolvePersonalSection(layout) !== null : false;
20
+ const mobileLayout = !!layout &&
21
+ (hasPersonal ||
22
+ !layout.desktopOnly ||
23
+ (layout.mobileValue != null && layout.onMobileChange !== undefined));
24
+ return {
25
+ desktop: shared || !!toggles?.length || !!layout,
26
+ mobile: shared || !!toggles?.some((toggle) => !toggle.desktopOnly) || mobileLayout,
27
+ };
28
+ }
@@ -0,0 +1,42 @@
1
+ import { type Dispatch, type ReactNode, type RefObject, type SetStateAction } from "react";
2
+ import { type DateFilterEditingEnd } from "./DateFilterCalendar.js";
3
+ import type { FilterConfigDate } from "../../filters/filter-model.js";
4
+ import { type DateFilterOperator, type DateFilterRule } from "@viewkitjs/fields/query";
5
+ /** The date editor's state, shared by the popover's editor and the sheet's. */
6
+ export type DateFilterEditor = {
7
+ rule: DateFilterRule;
8
+ dates: 0 | 1 | 2;
9
+ relative: boolean;
10
+ editing: DateFilterEditingEnd;
11
+ setEditing: Dispatch<SetStateAction<DateFilterEditingEnd>>;
12
+ fromInputRef: RefObject<HTMLInputElement | null>;
13
+ toInputRef: RefObject<HTMLInputElement | null>;
14
+ set: (patch: Partial<DateFilterRule>) => void;
15
+ setOperator: (op: DateFilterOperator) => void;
16
+ };
17
+ export declare function useDateFilterEditor(filter: FilterConfigDate): DateFilterEditor;
18
+ /**
19
+ * Everything under the operator: the date fields when the rule takes dates,
20
+ * the host's relative pair when it is relative, then the calendar.
21
+ */
22
+ export declare function DateFilterFields({ editor, relativePair, cellSize, }: {
23
+ editor: DateFilterEditor;
24
+ relativePair: ReactNode;
25
+ cellSize: string;
26
+ }): import("react/jsx-runtime").JSX.Element;
27
+ /**
28
+ * The date dimension's editor: the operator, the relative pair when it
29
+ * applies, then a full-width calendar.
30
+ *
31
+ * MENUS rather than a radio list, unlike the text and number editors. A date
32
+ * rule is up to three choices at once (operator × direction × unit) and the
33
+ * calendar has to stay in view while they are made — nine stacked radio rows
34
+ * would push it off the panel, which is the one thing the editor exists to
35
+ * show. A phone's sheet draws its own body around `DateFilterFields` instead:
36
+ * a menu portals out of a sheet, and its closing press closes the sheet.
37
+ */
38
+ export declare function DateFilterBody({ filter, fieldClassName, }: {
39
+ filter: FilterConfigDate;
40
+ /** The editor's padding, in place of the default. */
41
+ fieldClassName?: string;
42
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,64 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { useRef, useState, } from "react";
4
+ import { cx } from "../../internal/cx.js";
5
+ import { useViews } from "../../provider/context.js";
6
+ import { DateFilterCalendar } from "./DateFilterCalendar.js";
7
+ import { DateFilterInput } from "./DateFilterInput.js";
8
+ import { MenuSelect } from "./MenuSelect.js";
9
+ import { DATE_FILTER_OPERATORS, dateFilterOperatorLabel, DEFAULT_DATE_FILTER_RULE, RELATIVE_DIRECTIONS, RELATIVE_UNITS, dateFilterDates, } from "@viewkitjs/fields/query";
10
+ const EDITOR_PADDING = "px-2 pt-2 pb-1";
11
+ const UNSET_RULE = { operator: "is", from: null, to: null };
12
+ export function useDateFilterEditor(filter) {
13
+ const [editing, setEditing] = useState("from");
14
+ const fromInputRef = useRef(null);
15
+ const toInputRef = useRef(null);
16
+ const rule = filter.value ?? UNSET_RULE;
17
+ const set = (patch) => filter.onChange({ ...rule, ...patch });
18
+ const setOperator = (op) => {
19
+ const shape = dateFilterDates(op);
20
+ setEditing("from");
21
+ set({
22
+ operator: op,
23
+ from: shape === 0 ? null : rule.from,
24
+ to: shape === 2 ? rule.to : null,
25
+ ...(op === "is_relative"
26
+ ? {
27
+ direction: rule.direction ?? DEFAULT_DATE_FILTER_RULE.direction,
28
+ unit: rule.unit ?? DEFAULT_DATE_FILTER_RULE.unit,
29
+ }
30
+ : {}),
31
+ });
32
+ };
33
+ return {
34
+ rule,
35
+ dates: dateFilterDates(rule.operator),
36
+ relative: rule.operator === "is_relative",
37
+ editing,
38
+ setEditing,
39
+ fromInputRef,
40
+ toInputRef,
41
+ set,
42
+ setOperator,
43
+ };
44
+ }
45
+ export function DateFilterFields({ editor, relativePair, cellSize, }) {
46
+ const { messages } = useViews();
47
+ const { rule, dates, relative, editing, setEditing, fromInputRef, toInputRef, set } = editor;
48
+ return (_jsxs(_Fragment, { children: [dates > 0 && (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(DateFilterInput, { value: rule.from ?? null, onCommit: (key) => set({ from: key }), placeholder: messages({ key: dates === 2 ? "views.panels.date-start" : "views.panels.date-placeholder" }), active: editing === "from", onActivate: () => setEditing("from"), inputRef: fromInputRef }), dates === 2 && (_jsx(DateFilterInput, { value: rule.to ?? null, onCommit: (key) => set({ to: key }), placeholder: messages({ key: "views.panels.date-end" }), active: editing === "to", onActivate: () => setEditing("to"), inputRef: toInputRef }))] })), relative && relativePair, (dates > 0 || relative) && (_jsx(DateFilterCalendar, { rule: rule, dates: dates, relative: relative, editing: editing, setEditing: setEditing, setRule: set, fromInputRef: fromInputRef, toInputRef: toInputRef, cellSize: cellSize }))] }));
49
+ }
50
+ export function DateFilterBody({ filter, fieldClassName, }) {
51
+ const { conventions, messages } = useViews();
52
+ const editor = useDateFilterEditor(filter);
53
+ const { rule, set } = editor;
54
+ const operators = DATE_FILTER_OPERATORS.map((op) => ({ ...op, label: dateFilterOperatorLabel(op.value, conventions) }));
55
+ const directions = RELATIVE_DIRECTIONS.map((d) => ({
56
+ ...d,
57
+ label: conventions.messages({ key: "filter.relative-direction", values: { direction: d.value } }),
58
+ }));
59
+ const units = RELATIVE_UNITS.map((u) => ({
60
+ ...u,
61
+ label: conventions.messages({ key: "filter.relative-unit", values: { unit: u.value } }),
62
+ }));
63
+ return (_jsxs("div", { "data-vs-inset": true, className: cx("space-y-2", fieldClassName ?? EDITOR_PADDING), children: [_jsx("div", { children: _jsx(MenuSelect, { value: rule.operator, options: operators, onChange: (next) => editor.setOperator(next), label: messages({ key: "views.panels.date-operator" }), look: "sentence" }) }), _jsx(DateFilterFields, { editor: editor, cellSize: "1.875rem", relativePair: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(MenuSelect, { value: rule.direction ?? "this", options: directions, onChange: (direction) => set({ direction }), label: messages({ key: "views.panels.date-direction" }), look: "field", className: "flex-1" }), _jsx(MenuSelect, { value: rule.unit ?? "week", options: units, onChange: (unit) => set({ unit }), label: messages({ key: "views.panels.date-unit" }), look: "field", className: "flex-1" })] }) })] }));
64
+ }
@@ -0,0 +1,19 @@
1
+ import type { Dispatch, RefObject, SetStateAction } from "react";
2
+ import { type DateFilterRule } from "@viewkitjs/fields/query";
3
+ export type DateFilterEditingEnd = "from" | "to";
4
+ /**
5
+ * The date filter's month and its armed range-end interaction contract, drawn through the
6
+ * `RangeCalendar` atom. The end being edited is ALWAYS one of the two: a press sets it, and on a
7
+ * two-date rule hands the caret to the other end's box.
8
+ */
9
+ export declare function DateFilterCalendar({ rule, dates, relative, editing, setEditing, setRule, fromInputRef, toInputRef, cellSize, }: {
10
+ rule: DateFilterRule;
11
+ dates: number;
12
+ relative: boolean;
13
+ editing: DateFilterEditingEnd;
14
+ setEditing: Dispatch<SetStateAction<DateFilterEditingEnd>>;
15
+ setRule: (patch: Partial<DateFilterRule>) => void;
16
+ fromInputRef: RefObject<HTMLInputElement | null>;
17
+ toInputRef: RefObject<HTMLInputElement | null>;
18
+ cellSize: string;
19
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,37 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ import { resolveRelativeWindow } from "@viewkitjs/fields/query";
5
+ export function DateFilterCalendar({ rule, dates, relative, editing, setEditing, setRule, fromInputRef, toInputRef, cellSize, }) {
6
+ const { atoms, conventions, messages } = useViews();
7
+ const preview = relative
8
+ ? resolveRelativeWindow(rule.direction ?? "this", rule.unit ?? "week", undefined, conventions)
9
+ : null;
10
+ const limit = (() => {
11
+ if (dates !== 2)
12
+ return undefined;
13
+ const other = editing === "from" ? rule.to : rule.from;
14
+ if (!other)
15
+ return undefined;
16
+ return editing === "from" ? { after: other } : { before: other };
17
+ })();
18
+ return (_jsxs("div", { onMouseDown: (event) => {
19
+ if (editing)
20
+ event.preventDefault();
21
+ }, children: [_jsx(atoms.RangeCalendar, { mode: dates === 2 || relative ? "range" : "single", from: rule.from ?? null, to: dates === 2 ? (rule.to ?? null) : null, armed: editing, limit: limit, window: preview ? { from: preview.from, to: preview.to } : undefined, cellSize: cellSize, locale: conventions.locale, onSelect: (next, day) => {
22
+ if (relative)
23
+ return;
24
+ if (dates !== 2 && !relative) {
25
+ setRule({ from: next.from });
26
+ return;
27
+ }
28
+ if (day) {
29
+ setRule(editing === "from" ? { from: day } : { to: day });
30
+ const nextEnd = editing === "from" ? "to" : "from";
31
+ setEditing(nextEnd);
32
+ (nextEnd === "to" ? toInputRef : fromInputRef).current?.focus();
33
+ return;
34
+ }
35
+ setRule({ from: next.from, to: next.to });
36
+ } }), relative && (_jsx("p", { className: "pt-1 text-[11px] text-(color:--vk-fg-subtle)", children: messages({ key: "views.panels.date-relative-note" }) }))] }));
37
+ }
@@ -0,0 +1,16 @@
1
+ import { type RefObject } from "react";
2
+ /**
3
+ * A date that can be typed without replacing the calendar. The draft remains
4
+ * local while it is incomplete; only a complete day or an explicit clear is
5
+ * committed to the filter rule.
6
+ */
7
+ export declare function DateFilterInput({ value, onCommit, placeholder, active, onActivate, inputRef, }: {
8
+ value: string | null;
9
+ onCommit: (key: string | null) => void;
10
+ placeholder: string;
11
+ /** The calendar continues to target this end even while it owns the click. */
12
+ active?: boolean;
13
+ onActivate?: () => void;
14
+ /** Allows a calendar pick to hand the caret to the opposite range end. */
15
+ inputRef?: RefObject<HTMLInputElement | null>;
16
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,37 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useEffect, useRef, useState } from "react";
4
+ import { useViews } from "../../provider/context.js";
5
+ import { formatDayInput, parseDateInput } from "@viewkitjs/fields/query";
6
+ const ACTIVE_BOX = "bg-(color:--vk-neutral) ring-1 ring-(color:--vk-border-brand)";
7
+ export function DateFilterInput({ value, onCommit, placeholder, active = false, onActivate, inputRef, }) {
8
+ const { PanelSearch } = useViews().atoms;
9
+ const [draft, setDraft] = useState(formatDayInput(value));
10
+ const committed = useRef(value);
11
+ useEffect(() => {
12
+ if (value !== committed.current) {
13
+ committed.current = value;
14
+ setDraft(formatDayInput(value));
15
+ }
16
+ }, [value]);
17
+ const commit = (raw) => {
18
+ const key = raw.trim() === "" ? null : parseDateInput(raw);
19
+ if (raw.trim() !== "" && key == null)
20
+ return;
21
+ committed.current = key;
22
+ onCommit(key);
23
+ };
24
+ useEffect(() => {
25
+ if (draft === formatDayInput(committed.current))
26
+ return;
27
+ const id = setTimeout(() => commit(draft), 300);
28
+ return () => clearTimeout(id);
29
+ }, [draft]);
30
+ return (_jsx("div", { className: "min-w-0 flex-1", children: _jsx(PanelSearch, { value: draft, onChange: setDraft, onClear: () => {
31
+ setDraft("");
32
+ commit("");
33
+ }, onKeyDown: (event) => {
34
+ if (event.key === "Enter")
35
+ commit(draft);
36
+ }, onFocus: onActivate, inputRef: inputRef, className: active ? ACTIVE_BOX : undefined, placeholder: placeholder, leading: null, inputMode: "numeric" }) }));
37
+ }
@@ -0,0 +1,7 @@
1
+ import type { ReactNode } from "react";
2
+ import type { FilterConfig } from "../../filters/filter-model.js";
3
+ /** A filter row's glyph: the filter's own, else its kind's, else the plain filter mark. */
4
+ export declare function FilterIcon<T extends string>({ filter, className, }: {
5
+ filter: FilterConfig<T>;
6
+ className: string;
7
+ }): ReactNode;
@@ -0,0 +1,15 @@
1
+ "use client";
2
+ import { jsx as _jsx } from "react/jsx-runtime";
3
+ import { useViews } from "../../provider/context.js";
4
+ const FILTER_KIND_ICONS = {
5
+ status: "filterStatus",
6
+ category: "filterCategory",
7
+ metric: "filterMetric",
8
+ };
9
+ export function FilterIcon({ filter, className, }) {
10
+ const { icons } = useViews();
11
+ if (filter.icon)
12
+ return filter.icon;
13
+ const Glyph = icons[(filter.kind && FILTER_KIND_ICONS[filter.kind]) || "filter"];
14
+ return _jsx(Glyph, { className: className });
15
+ }
@@ -0,0 +1,12 @@
1
+ export declare function MenuSelect<V extends string>({ value, options, onChange, label, look, className, }: {
2
+ value: V;
3
+ options: readonly {
4
+ value: V;
5
+ label: string;
6
+ }[];
7
+ onChange: (next: V) => void;
8
+ /** The menu's name, which a screen reader announces as it opens. */
9
+ label: string;
10
+ look: "sentence" | "field";
11
+ className?: string;
12
+ }): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,34 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
+ import { useRef, useState } from "react";
4
+ import { cx } from "../../internal/cx.js";
5
+ import { ELEMENT_RESET } from "../../internal/reset.js";
6
+ import { useViews } from "../../provider/context.js";
7
+ const LOOKS = {
8
+ sentence: "inline-flex items-center gap-1 whitespace-nowrap text-sm font-medium text-(color:--vk-fg)",
9
+ field: "flex h-8 w-full items-center justify-between gap-1 whitespace-nowrap rounded-lg border border-(color:--vk-border) px-2.5 text-sm text-(color:--vk-fg)",
10
+ };
11
+ export function MenuSelect({ value, options, onChange, label, look, className, }) {
12
+ const { components, icons } = useViews();
13
+ const { Menu } = components;
14
+ const Chevron = icons.chevronDown;
15
+ const [open, setOpen] = useState(false);
16
+ const anchor = useRef(null);
17
+ const openAtPress = useRef(null);
18
+ const chosen = options.find((option) => option.value === value)?.label ?? value;
19
+ return (_jsxs(_Fragment, { children: [_jsxs("button", { ref: anchor, type: "button", "aria-haspopup": "menu", "aria-expanded": open, onPointerDownCapture: () => {
20
+ openAtPress.current = open;
21
+ }, onClick: () => {
22
+ const wasOpen = openAtPress.current ?? open;
23
+ openAtPress.current = null;
24
+ setOpen(!wasOpen);
25
+ }, className: cx(ELEMENT_RESET, LOOKS[look], className), children: [_jsx("span", { className: "truncate", children: chosen }), _jsx(Chevron, { className: cx("size-4 shrink-0", look === "sentence" ? "opacity-60" : "opacity-50") })] }), _jsx(Menu, { open: open, onOpenChange: (next) => setOpen(next), anchor: anchor, label: label, items: options.map((option) => ({
26
+ key: option.value,
27
+ label: option.label,
28
+ checked: option.value === value,
29
+ onSelect: () => {
30
+ setOpen(false);
31
+ onChange(option.value);
32
+ },
33
+ })) })] }));
34
+ }