@viewkitjs/views 0.3.0 → 0.5.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 (288) hide show
  1. package/CHANGELOG.md +641 -0
  2. package/README.md +3 -3
  3. package/dist/atoms/CommandMenu.d.ts +1 -1
  4. package/dist/atoms/CommandMenu.js +7 -3
  5. package/dist/atoms/DrillRows.d.ts +3 -0
  6. package/dist/atoms/DrillRows.js +25 -0
  7. package/dist/atoms/PanelRows.d.ts +5 -0
  8. package/dist/atoms/PanelRows.js +40 -0
  9. package/dist/atoms/PanelSearch.d.ts +2 -0
  10. package/dist/atoms/PanelSearch.js +21 -0
  11. package/dist/atoms/RelationRoles.d.ts +2 -0
  12. package/dist/atoms/RelationRoles.js +6 -0
  13. package/dist/atoms/Row.js +2 -1
  14. package/dist/atoms/RowMenu.js +2 -1
  15. package/dist/atoms/SelectionSheet.d.ts +3 -0
  16. package/dist/atoms/SelectionSheet.js +30 -0
  17. package/dist/atoms/StatusMarker.js +3 -1
  18. package/dist/atoms/Tag.js +2 -1
  19. package/dist/atoms/defaults.js +14 -0
  20. package/dist/atoms/types.d.ts +146 -8
  21. package/dist/cells/cell-values.js +4 -2
  22. package/dist/cells/relation-wrap.js +3 -1
  23. package/dist/contract.d.ts +212 -17
  24. package/dist/contract.js +208 -6
  25. package/dist/display/boolean.js +3 -1
  26. package/dist/display/date.d.ts +1 -1
  27. package/dist/display/date.js +4 -2
  28. package/dist/display/format.js +20 -4
  29. package/dist/display/link.js +4 -3
  30. package/dist/display/multi-value.js +2 -1
  31. package/dist/display/percent.js +2 -1
  32. package/dist/display/phone.js +2 -1
  33. package/dist/display/range.js +3 -13
  34. package/dist/display/relation.js +23 -8
  35. package/dist/display/rich-text.js +2 -1
  36. package/dist/editors/ChipsEditor.d.ts +5 -1
  37. package/dist/editors/ChipsEditor.js +15 -2
  38. package/dist/editors/DateEditor.d.ts +2 -0
  39. package/dist/editors/DateEditor.js +76 -10
  40. package/dist/editors/EditorPanel.d.ts +14 -4
  41. package/dist/editors/EditorPanel.js +21 -4
  42. package/dist/editors/LocationEditor.js +35 -3
  43. package/dist/editors/NumberEditor.js +3 -2
  44. package/dist/editors/RangeEditor.d.ts +8 -0
  45. package/dist/editors/RangeEditor.js +3 -2
  46. package/dist/editors/RelationEditor.d.ts +2 -0
  47. package/dist/editors/RelationEditor.js +16 -2
  48. package/dist/editors/RelationSetEditor.d.ts +4 -2
  49. package/dist/editors/RelationSetEditor.js +36 -2
  50. package/dist/editors/SelectEditor.d.ts +5 -2
  51. package/dist/editors/SelectEditor.js +31 -4
  52. package/dist/editors/TextEditor.js +3 -1
  53. package/dist/editors/ValueListEditor.d.ts +3 -0
  54. package/dist/editors/ValueListEditor.js +10 -4
  55. package/dist/editors/edit-session.d.ts +14 -2
  56. package/dist/editors/edit-session.js +13 -5
  57. package/dist/editors/escape-rule.d.ts +12 -0
  58. package/dist/editors/escape-rule.js +8 -0
  59. package/dist/editors/open-value.js +2 -1
  60. package/dist/editors/picker-slot.d.ts +25 -0
  61. package/dist/editors/picker-slot.js +37 -0
  62. package/dist/editors/relation-picker.d.ts +44 -0
  63. package/dist/editors/relation-picker.js +49 -0
  64. package/dist/editors/relation-source.d.ts +1 -0
  65. package/dist/editors/relation-source.js +7 -1
  66. package/dist/field-row/FieldNoteLine.js +2 -1
  67. package/dist/field-row/FieldRow.js +41 -6
  68. package/dist/field-row/FieldRowLane.js +3 -1
  69. package/dist/field-row/editors/RowChipsEditor.js +1 -1
  70. package/dist/field-row/editors/RowDateEditor.js +1 -1
  71. package/dist/field-row/editors/RowEditor.js +2 -1
  72. package/dist/field-row/editors/RowRangeEditor.js +2 -1
  73. package/dist/field-row/editors/RowRelationEditor.js +2 -2
  74. package/dist/field-row/editors/RowSelectEditor.d.ts +1 -1
  75. package/dist/field-row/editors/RowSelectEditor.js +2 -2
  76. package/dist/field-row/editors/RowValueListEditor.js +1 -1
  77. package/dist/field-row/editors/host.d.ts +3 -0
  78. package/dist/field-row/editors/row-session.js +4 -1
  79. package/dist/fields/menus.d.ts +2 -0
  80. package/dist/fields/range-unit.d.ts +7 -0
  81. package/dist/fields/range-unit.js +13 -0
  82. package/dist/figures.d.ts +5 -48
  83. package/dist/figures.js +1 -63
  84. package/dist/grid/chrome/GridAddColumn.d.ts +8 -0
  85. package/dist/grid/chrome/GridAddColumn.js +66 -9
  86. package/dist/grid/chrome/GridAggregateMenu.d.ts +5 -2
  87. package/dist/grid/chrome/GridAggregateMenu.js +33 -4
  88. package/dist/grid/chrome/GridCellEditors.d.ts +9 -2
  89. package/dist/grid/chrome/GridCellEditors.js +24 -5
  90. package/dist/grid/chrome/GridCellOutline.d.ts +3 -2
  91. package/dist/grid/chrome/GridCellOutline.js +11 -1
  92. package/dist/grid/chrome/GridChipsEditor.js +1 -1
  93. package/dist/grid/chrome/GridColumnColorSection.d.ts +2 -0
  94. package/dist/grid/chrome/GridColumnColorSection.js +2 -2
  95. package/dist/grid/chrome/GridColumnDateSection.d.ts +4 -0
  96. package/dist/grid/chrome/GridColumnDateSection.js +2 -2
  97. package/dist/grid/chrome/GridColumnDurationSection.d.ts +4 -0
  98. package/dist/grid/chrome/GridColumnDurationSection.js +2 -2
  99. package/dist/grid/chrome/GridColumnMenu.d.ts +10 -6
  100. package/dist/grid/chrome/GridColumnMenu.js +62 -24
  101. package/dist/grid/chrome/GridColumnNumberSection.d.ts +4 -0
  102. package/dist/grid/chrome/GridColumnNumberSection.js +2 -2
  103. package/dist/grid/chrome/GridColumnPercentSection.d.ts +1 -0
  104. package/dist/grid/chrome/GridColumnPercentSection.js +1 -1
  105. package/dist/grid/chrome/GridColumnSortSection.d.ts +3 -3
  106. package/dist/grid/chrome/GridDateEditor.js +1 -1
  107. package/dist/grid/chrome/GridFooter.js +7 -48
  108. package/dist/grid/chrome/GridGroupMenu.d.ts +11 -5
  109. package/dist/grid/chrome/GridGroupMenu.js +28 -13
  110. package/dist/grid/chrome/GridHeader.d.ts +3 -1
  111. package/dist/grid/chrome/GridHeader.js +8 -8
  112. package/dist/grid/chrome/GridNumberEditor.js +3 -24
  113. package/dist/grid/chrome/GridRangeEditor.js +3 -2
  114. package/dist/grid/chrome/GridRelationEditor.js +2 -2
  115. package/dist/grid/chrome/GridRow.d.ts +2 -1
  116. package/dist/grid/chrome/GridRow.js +13 -37
  117. package/dist/grid/chrome/GridRowActions.js +2 -1
  118. package/dist/grid/chrome/GridRowCells.js +9 -4
  119. package/dist/grid/chrome/GridSelectEditor.js +30 -20
  120. package/dist/grid/chrome/GridStructure.d.ts +11 -4
  121. package/dist/grid/chrome/GridStructure.js +19 -7
  122. package/dist/grid/chrome/GridTable.js +138 -16
  123. package/dist/grid/chrome/GridTableSurface.d.ts +25 -12
  124. package/dist/grid/chrome/GridTableSurface.js +13 -6
  125. package/dist/grid/chrome/GridTextEditor.js +3 -1
  126. package/dist/grid/chrome/GridValueListEditor.js +1 -1
  127. package/dist/grid/chrome/cell-clipboard.d.ts +1 -1
  128. package/dist/grid/chrome/cell-clipboard.js +1 -1
  129. package/dist/grid/chrome/checks.d.ts +10 -2
  130. package/dist/grid/chrome/checks.js +17 -11
  131. package/dist/grid/chrome/column-glyph.d.ts +2 -2
  132. package/dist/grid/chrome/column-glyph.js +4 -0
  133. package/dist/grid/chrome/grid-add-column-items.d.ts +13 -0
  134. package/dist/grid/chrome/grid-add-column-items.js +40 -0
  135. package/dist/grid/chrome/grid-cell-classes.d.ts +2 -0
  136. package/dist/grid/chrome/grid-cell-classes.js +10 -4
  137. package/dist/grid/chrome/grid-column-menu-items.d.ts +75 -0
  138. package/dist/grid/chrome/grid-column-menu-items.js +263 -0
  139. package/dist/grid/chrome/grid-edit-escape.d.ts +4 -0
  140. package/dist/grid/chrome/grid-edit-escape.js +12 -0
  141. package/dist/grid/chrome/grid-edit-session.d.ts +2 -1
  142. package/dist/grid/chrome/grid-edit-session.js +14 -1
  143. package/dist/grid/chrome/grid-figure-value.d.ts +25 -0
  144. package/dist/grid/chrome/grid-figure-value.js +40 -0
  145. package/dist/grid/chrome/grid-fitted-box.d.ts +15 -0
  146. package/dist/grid/chrome/grid-fitted-box.js +26 -0
  147. package/dist/grid/chrome/grid-group-menu-items.d.ts +31 -0
  148. package/dist/grid/chrome/grid-group-menu-items.js +75 -0
  149. package/dist/grid/chrome/grid-group-menu-parts.d.ts +27 -0
  150. package/dist/grid/chrome/grid-group-menu-parts.js +19 -0
  151. package/dist/grid/chrome/grid-hover.d.ts +1 -0
  152. package/dist/grid/chrome/grid-hover.js +13 -1
  153. package/dist/grid/chrome/grid-lab.d.ts +7 -0
  154. package/dist/grid/chrome/grid-lab.js +7 -0
  155. package/dist/grid/chrome/grid-menu-focus.d.ts +12 -0
  156. package/dist/grid/chrome/grid-menu-focus.js +13 -0
  157. package/dist/grid/chrome/{useGridRowContextMenu.d.ts → grid-row-menu-items.d.ts} +15 -4
  158. package/dist/grid/chrome/{useGridRowContextMenu.js → grid-row-menu-items.js} +15 -18
  159. package/dist/grid/chrome/grid-row-props.d.ts +3 -1
  160. package/dist/grid/chrome/grid-row-window.d.ts +15 -5
  161. package/dist/grid/chrome/grid-row-window.js +44 -10
  162. package/dist/grid/chrome/grid-rows-menu.d.ts +38 -0
  163. package/dist/grid/chrome/grid-rows-menu.js +83 -0
  164. package/dist/grid/chrome/grid-table-props.d.ts +53 -8
  165. package/dist/grid/chrome/useGridBandFigures.d.ts +26 -0
  166. package/dist/grid/chrome/useGridBandFigures.js +50 -0
  167. package/dist/grid/chrome/useGridBoxes.d.ts +22 -0
  168. package/dist/grid/chrome/useGridBoxes.js +22 -0
  169. package/dist/grid/chrome/useGridColumnLayout.js +29 -4
  170. package/dist/grid/chrome/useGridKeyboard.js +7 -2
  171. package/dist/grid/chrome/useGridPartColumns.d.ts +5 -0
  172. package/dist/grid/chrome/useGridPartColumns.js +9 -0
  173. package/dist/grid/chrome/useGridRangeGestures.js +2 -1
  174. package/dist/grid/chrome/useGridRecorder.d.ts +16 -0
  175. package/dist/grid/chrome/useGridRecorder.js +144 -0
  176. package/dist/grid/chrome/useGridRowOpener.d.ts +41 -0
  177. package/dist/grid/chrome/useGridRowOpener.js +83 -0
  178. package/dist/grid/chrome/useGridScrollArea.d.ts +38 -12
  179. package/dist/grid/chrome/useGridScrollArea.js +70 -17
  180. package/dist/grid/chrome/useGridTableInteractionModel.d.ts +1 -0
  181. package/dist/grid/chrome/useGridTableInteractionModel.js +67 -9
  182. package/dist/grid/core/clipboard-model.d.ts +11 -3
  183. package/dist/grid/core/clipboard-model.js +9 -4
  184. package/dist/grid/core/commit-model.d.ts +7 -0
  185. package/dist/grid/core/editing-controller.d.ts +31 -1
  186. package/dist/grid/core/editing-controller.js +65 -0
  187. package/dist/grid/core/grid-recorder.d.ts +111 -0
  188. package/dist/grid/core/grid-recorder.js +223 -0
  189. package/dist/grid/core/part-edits.d.ts +18 -0
  190. package/dist/grid/core/part-edits.js +48 -0
  191. package/dist/grid/core/pending-reconciliation.js +12 -3
  192. package/dist/grid/core/refusal-sentence.d.ts +3 -0
  193. package/dist/grid/core/refusal-sentence.js +15 -0
  194. package/dist/grid/core/row-opened-from.d.ts +21 -0
  195. package/dist/grid/core/row-opened-from.js +11 -0
  196. package/dist/grid/core/useGridEditing.d.ts +16 -2
  197. package/dist/grid/core/useGridEditing.js +10 -4
  198. package/dist/grid/core/value-equality.d.ts +19 -1
  199. package/dist/grid/core/value-equality.js +24 -0
  200. package/dist/grid/index.d.ts +4 -1
  201. package/dist/grid/index.js +1 -0
  202. package/dist/grid/useGridTablePrefs.d.ts +1 -1
  203. package/dist/grid-lab.d.ts +18 -0
  204. package/dist/grid-lab.js +16 -0
  205. package/dist/grouping/sort-groups.d.ts +6 -7
  206. package/dist/index.d.ts +1 -0
  207. package/dist/index.js +1 -0
  208. package/dist/internal/reset.d.ts +9 -0
  209. package/dist/internal/reset.js +1 -0
  210. package/dist/model/aggregates.d.ts +3 -3
  211. package/dist/model/aggregates.js +17 -71
  212. package/dist/model/column-capabilities.d.ts +29 -2
  213. package/dist/model/column-capabilities.js +27 -3
  214. package/dist/model/column-filters.js +24 -4
  215. package/dist/model/column-inspect.d.ts +2 -1
  216. package/dist/model/column-order.d.ts +2 -2
  217. package/dist/model/column-schema.d.ts +18 -7
  218. package/dist/model/column-state.d.ts +9 -20
  219. package/dist/model/column-state.js +1 -4
  220. package/dist/model/column-types.d.ts +1 -15
  221. package/dist/model/column-types.js +1 -1
  222. package/dist/model/part-columns.d.ts +17 -0
  223. package/dist/model/part-columns.js +67 -0
  224. package/dist/model/part-rows.d.ts +3 -10
  225. package/dist/model/part-rows.js +6 -11
  226. package/dist/model/part-write.d.ts +11 -0
  227. package/dist/model/part-write.js +52 -0
  228. package/dist/model/preferences.d.ts +3 -23
  229. package/dist/model/preferences.js +1 -17
  230. package/dist/model/prefs-buckets.d.ts +0 -27
  231. package/dist/model/prefs-buckets.js +1 -1
  232. package/dist/model/relation-filters.d.ts +0 -1
  233. package/dist/model/relation-filters.js +1 -1
  234. package/dist/model/row-icon.d.ts +5 -9
  235. package/dist/model/view-rules.d.ts +32 -6
  236. package/dist/model/view-rules.js +101 -21
  237. package/dist/provider/ViewsProvider.d.ts +22 -2
  238. package/dist/provider/ViewsProvider.js +21 -2
  239. package/dist/provider/components.d.ts +197 -9
  240. package/dist/provider/context.d.ts +12 -1
  241. package/dist/provider/desktop.d.ts +3 -0
  242. package/dist/provider/desktop.js +7 -4
  243. package/dist/provider/menu-groups.d.ts +3 -2
  244. package/dist/provider/menu-groups.js +13 -7
  245. package/dist/provider/missing-slot.d.ts +10 -0
  246. package/dist/provider/missing-slot.js +15 -0
  247. package/dist/provider/plain-input.d.ts +3 -2
  248. package/dist/provider/plain-input.js +3 -1
  249. package/dist/react.d.ts +3 -2
  250. package/dist/selection/SelectionBar.d.ts +18 -0
  251. package/dist/selection/SelectionBar.js +92 -0
  252. package/dist/selection/SelectionBarPhone.d.ts +3 -0
  253. package/dist/selection/SelectionBarPhone.js +14 -0
  254. package/dist/selection/bar-overflow.d.ts +12 -0
  255. package/dist/selection/bar-overflow.js +42 -0
  256. package/dist/selection/bar-parts.d.ts +15 -0
  257. package/dist/selection/bar-parts.js +17 -0
  258. package/dist/selection/index.d.ts +2 -0
  259. package/dist/selection/index.js +1 -0
  260. package/dist/selection/types.d.ts +3 -2
  261. package/dist/selection/verbs.d.ts +34 -0
  262. package/dist/selection/verbs.js +1 -0
  263. package/docs/contract.md +142 -39
  264. package/docs/getting-started.md +1 -1
  265. package/docs/guides/atoms.md +32 -4
  266. package/docs/guides/columns.md +1 -1
  267. package/docs/guides/display.md +1 -1
  268. package/docs/guides/editors.md +3 -3
  269. package/docs/guides/ports.md +1 -1
  270. package/docs/guides/selection.md +32 -20
  271. package/docs/guides/the-grid.md +43 -21
  272. package/docs/guides/the-provider.md +14 -4
  273. package/docs/index.md +2 -0
  274. package/docs/install.md +8 -1
  275. package/docs/reference/editors-date.md +2 -0
  276. package/docs/reference/editors-panel.md +4 -4
  277. package/docs/reference/editors-range.md +1 -1
  278. package/docs/reference/editors-relation.md +3 -3
  279. package/docs/reference/editors-select.md +1 -1
  280. package/docs/reference/editors-session.md +3 -2
  281. package/docs/reference/editors-value-list.md +1 -1
  282. package/docs/reference/field-row.md +2 -2
  283. package/docs/reference/grid.md +25 -6
  284. package/docs/reference/react.md +30 -8
  285. package/docs/reference/selection.md +10 -2
  286. package/docs/reference/views.md +42 -36
  287. package/package.json +22 -3
  288. package/skills/views/SKILL.md +3 -3
package/README.md CHANGED
@@ -10,7 +10,7 @@ The grid, its cells, the field display and the editors over typed fields: a head
10
10
  pnpm add @viewkitjs/views @viewkitjs/fields zod
11
11
  ```
12
12
 
13
- ESM only. Node 20 or later. `react` and `react-dom` 19 and `@viewkitjs/fields` are peer dependencies. Add one `@source` line so Tailwind sees the package, and map its colours onto your theme: [docs/install.md](./docs/install.md).
13
+ ESM only. Node 20 or later. `react` and `react-dom` 19 and `@viewkitjs/fields` are peer dependencies; `@dnd-kit/core`, `@dnd-kit/sortable` and `@dnd-kit/utilities` are optional ones, installed only to use `/panels`. Add one `@source` line so Tailwind sees the package, and map its colours onto your theme: [docs/install.md](./docs/install.md).
14
14
 
15
15
  ## Getting started
16
16
 
@@ -69,7 +69,7 @@ Guides:
69
69
  - [The grid](./docs/guides/the-grid.md): grouping, sorting, writes, preferences, figures and the editing rules.
70
70
  - [The rendering contract](./docs/contract.md): every public name and what each door holds; [reshaping a view](./docs/reshaping.md): the cheapest change first.
71
71
 
72
- References, one per door, each naming every export: [`@viewkitjs/views`](./docs/reference/views.md), [`/react`](./docs/reference/react.md), [`/display`](./docs/reference/display.md), [`/editors`](./docs/reference/editors.md), [`/editors/select`](./docs/reference/editors-select.md), [`/editors/text`](./docs/reference/editors-text.md), [`/editors/relation`](./docs/reference/editors-relation.md), [`/editors/number`](./docs/reference/editors-number.md), [`/editors/range`](./docs/reference/editors-range.md), [`/editors/name`](./docs/reference/editors-name.md), [`/editors/location`](./docs/reference/editors-location.md), [`/editors/value-list`](./docs/reference/editors-value-list.md), [`/editors/date`](./docs/reference/editors-date.md), [`/editors/chips`](./docs/reference/editors-chips.md), [`/editors/session`](./docs/reference/editors-session.md), [`/editors/panel`](./docs/reference/editors-panel.md), [`/editors/open-values`](./docs/reference/editors-open-values.md), [`/field-row`](./docs/reference/field-row.md), [`/cells`](./docs/reference/cells.md), [`/selection`](./docs/reference/selection.md), [`/grid`](./docs/reference/grid.md).
72
+ References, one per door, each naming every export: [`@viewkitjs/views`](./docs/reference/views.md), [`/react`](./docs/reference/react.md), [`/display`](./docs/reference/display.md), [`/editors`](./docs/reference/editors.md), [`/editors/select`](./docs/reference/editors-select.md), [`/editors/text`](./docs/reference/editors-text.md), [`/editors/relation`](./docs/reference/editors-relation.md), [`/editors/number`](./docs/reference/editors-number.md), [`/editors/range`](./docs/reference/editors-range.md), [`/editors/name`](./docs/reference/editors-name.md), [`/editors/location`](./docs/reference/editors-location.md), [`/editors/value-list`](./docs/reference/editors-value-list.md), [`/editors/date`](./docs/reference/editors-date.md), [`/editors/chips`](./docs/reference/editors-chips.md), [`/editors/session`](./docs/reference/editors-session.md), [`/editors/panel`](./docs/reference/editors-panel.md), [`/editors/open-values`](./docs/reference/editors-open-values.md), [`/field-row`](./docs/reference/field-row.md), [`/cells`](./docs/reference/cells.md), [`/selection`](./docs/reference/selection.md) and [`/grid`](./docs/reference/grid.md).
73
73
 
74
74
  ## Doors
75
75
 
@@ -87,7 +87,7 @@ References, one per door, each naming every export: [`@viewkitjs/views`](./docs/
87
87
  | `@viewkitjs/views/selection` | a list's selection: the model, the hook, the row checkbox, drag-select and the row-click rules |
88
88
  | `@viewkitjs/views/grid` | the grid: the table, its props, its preferences, and the helpers a host shares with it |
89
89
 
90
- Twenty-one doors; there are no other subpaths.
90
+ Twenty-one doors; there are no other subpaths. A twenty-second, `@viewkitjs/views/panels` (what a list's panels read and say), is still being built and comes in a later release, with the controls.
91
91
 
92
92
  ## For coding agents
93
93
 
@@ -1,2 +1,2 @@
1
1
  import type { ViewsCommandMenuProps } from "./types.js";
2
- export declare function DefaultCommandMenu({ trigger, items, align }: ViewsCommandMenuProps): import("react/jsx-runtime").JSX.Element;
2
+ export declare function DefaultCommandMenu({ trigger, items, align, label }: ViewsCommandMenuProps): import("react/jsx-runtime").JSX.Element;
@@ -2,19 +2,23 @@
2
2
  import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useRef, useState } from "react";
4
4
  import { useViews } from "../provider/context.js";
5
- export function DefaultCommandMenu({ trigger, items, align = "start" }) {
6
- const { Menu } = useViews().components;
5
+ export function DefaultCommandMenu({ trigger, items, align = "start", label }) {
6
+ const { components, messages } = useViews();
7
+ const { Menu } = components;
7
8
  const [open, setOpen] = useState(false);
8
9
  const anchor = useRef(null);
9
10
  return (_jsxs(_Fragment, { children: [_jsx("span", { ref: anchor, "data-slot": "vk-command-menu", className: "inline-flex min-w-0", onClick: (event) => {
10
11
  event.stopPropagation();
11
12
  setOpen((current) => !current);
12
- }, children: trigger }), _jsx(Menu, { open: open, onOpenChange: (next) => setOpen(next), anchor: anchor, align: align, items: items.map((item, index) => ({
13
+ }, children: trigger }), _jsx(Menu, { open: open, onOpenChange: (next) => setOpen(next), anchor: anchor, align: align, label: messages(label === undefined
14
+ ? { key: "views.menus.commands-unnamed" }
15
+ : { key: "views.menus.commands", values: { field: label } }), items: items.map((item, index) => ({
13
16
  key: String(index),
14
17
  label: item.label,
15
18
  icon: item.icon,
16
19
  onSelect: item.onClick,
17
20
  destructive: item.destructive,
18
21
  disabled: item.disabled,
22
+ disabledReason: item.disabledReason,
19
23
  })) })] }));
20
24
  }
@@ -0,0 +1,3 @@
1
+ import type { ViewsMenuRowProps, ViewsToggleRowProps } from "./types.js";
2
+ export declare function DefaultMenuRow({ icon, label, value, active, disabled, onClick }: ViewsMenuRowProps): import("react/jsx-runtime").JSX.Element;
3
+ export declare function DefaultToggleRow({ icon, label, active, disabled, onClick, reset }: ViewsToggleRowProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,25 @@
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
+ const ROW = "flex w-full items-center gap-2.5 rounded-md px-2 py-1.5 text-left transition-colors hover:bg-(color:--vk-hovered)";
7
+ function Glyph({ active, children }) {
8
+ return (_jsx("span", { className: cx("flex size-4 shrink-0 items-center justify-center", active ? "text-(color:--vk-fg-brand)" : "text-(color:--vk-fg-subtle)"), children: children }));
9
+ }
10
+ export function DefaultMenuRow({ icon, label, value, active, disabled, onClick }) {
11
+ const Chevron = useViews().icons.chevronRight;
12
+ return (_jsxs("button", { type: "button", "data-slot": "vk-menu-row", "data-chosen": active || undefined, "data-disabled": disabled || undefined, onClick: onClick, disabled: disabled, className: cx(ELEMENT_RESET, ROW, disabled && "cursor-default opacity-50 hover:bg-transparent"), children: [_jsx(Glyph, { active: active, children: icon }), _jsx("span", { className: cx("flex-1 whitespace-nowrap text-sm font-medium", active ? "text-(color:--vk-fg-brand)" : "text-(color:--vk-fg)"), children: label }), _jsx("span", { className: cx("max-w-[120px] shrink-0 truncate whitespace-nowrap text-xs", active ? "text-(color:--vk-fg-brand)" : "text-(color:--vk-fg-subtle)"), children: value }), disabled ? null : _jsx(Chevron, { className: "size-3.5 shrink-0 text-(color:--vk-fg-subtlest)" })] }));
13
+ }
14
+ function SwitchMark({ on }) {
15
+ return (_jsx("span", { "aria-hidden": "true", className: cx("inline-flex h-4 w-7 shrink-0 items-center rounded-full border-2 transition-colors", on ? "border-transparent bg-(color:--vk-brand)" : "border-(color:--vk-border) bg-transparent"), children: _jsx("span", { className: cx("block size-3 rounded-full transition-transform", on ? "translate-x-3 bg-(color:--vk-fg-on-brand)" : "translate-x-0 bg-(color:--vk-border)") }) }));
16
+ }
17
+ export function DefaultToggleRow({ icon, label, active, disabled, onClick, reset }) {
18
+ const { icons, messages } = useViews();
19
+ const Reset = icons.reset;
20
+ const labelText = _jsx("span", { className: "flex-1 whitespace-nowrap text-sm font-medium text-(color:--vk-fg)", children: label });
21
+ if (reset) {
22
+ return (_jsxs("div", { "data-slot": "vk-toggle-row", "data-checked": active || undefined, className: ROW, children: [_jsxs("button", { type: "button", onClick: onClick, disabled: disabled, "aria-pressed": active, className: cx(ELEMENT_RESET, "flex min-w-0 flex-1 items-center gap-2.5 text-left"), children: [_jsx(Glyph, { active: active, children: icon }), labelText] }), _jsx("button", { type: "button", onClick: reset.onReset, "aria-label": messages({ key: "views.panels.toggle-reset", values: { label } }), title: messages({ key: "views.panels.toggle-reset-hint" }), className: cx(ELEMENT_RESET, "flex size-5 shrink-0 items-center justify-center rounded-full text-(color:--vk-fg-subtle) transition-colors hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)"), children: _jsx(Reset, { className: "size-3" }) }), _jsx("button", { type: "button", onClick: onClick, disabled: disabled, "aria-pressed": active, className: cx(ELEMENT_RESET, "flex h-5 shrink-0 items-center"), children: _jsx(SwitchMark, { on: active }) })] }));
23
+ }
24
+ return (_jsxs("button", { type: "button", "data-slot": "vk-toggle-row", "data-checked": active || undefined, onClick: onClick, disabled: disabled, "aria-pressed": active, className: cx(ELEMENT_RESET, ROW, disabled && "cursor-default opacity-50 hover:bg-transparent"), children: [_jsx(Glyph, { active: active, children: icon }), labelText, _jsx(SwitchMark, { on: active })] }));
25
+ }
@@ -0,0 +1,5 @@
1
+ import type { ViewsCheckRowProps, ViewsChoiceRowProps, ViewsDirectionButtonProps, ViewsRadioRowProps } from "./types.js";
2
+ export declare function DefaultChoiceRow({ selected, label, description, meta, leading, trailing, onClick, onMouseDown, disabled, className, role, "aria-selected": ariaSelected, }: ViewsChoiceRowProps): import("react/jsx-runtime").JSX.Element;
3
+ export declare function DefaultCheckRow({ checked, onClick, children, leading, trailing, disabled, className }: ViewsCheckRowProps): import("react/jsx-runtime").JSX.Element;
4
+ export declare function DefaultRadioRow({ selected, label, onClick, leading, trailing, className, checkClassName, labelClassName, mark, disabled, disabledReason, }: ViewsRadioRowProps): import("react/jsx-runtime").JSX.Element;
5
+ export declare function DefaultDirectionButton({ dir, onClick, className, iconClassName }: ViewsDirectionButtonProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,40 @@
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
+ const ROW = "flex w-full items-center gap-2.5 rounded-md px-2 py-1.5 text-left text-sm transition-colors hover:bg-(color:--vk-hovered)";
7
+ const CHOSEN = "font-medium text-(color:--vk-fg-selected)";
8
+ const DISABLED = "pointer-events-none opacity-50";
9
+ const DISABLED_REASON_DELAY_MS = 1000;
10
+ function ChosenCheck({ className }) {
11
+ const Check = useViews().icons.check;
12
+ return (_jsx("span", { className: "ml-auto flex size-4 shrink-0 items-center justify-center text-(color:--vk-fg-selected)", children: _jsx(Check, { className: cx("size-3.5", className) }) }));
13
+ }
14
+ function Slot({ children }) {
15
+ return _jsx("span", { className: "flex shrink-0 items-center", children: children });
16
+ }
17
+ export function DefaultChoiceRow({ selected = false, label, description, meta, leading, trailing, onClick, onMouseDown, disabled, className, role, "aria-selected": ariaSelected, }) {
18
+ return (_jsxs("button", { type: "button", "data-slot": "vk-choice-row", "data-chosen": selected || undefined, onClick: onClick, onMouseDown: onMouseDown, disabled: disabled, role: role, "aria-selected": ariaSelected, className: cx(ELEMENT_RESET, ROW, selected ? CHOSEN : "text-(color:--vk-fg)", disabled && DISABLED, className), children: [leading ? _jsx(Slot, { children: leading }) : null, _jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [_jsx("span", { className: "truncate", children: label }), description ? (_jsx("span", { className: "mt-0.5 truncate text-[11px] font-normal leading-snug text-(color:--vk-fg-subtle)", children: description })) : null] }), meta ? (_jsx("span", { className: cx("ml-3.5 shrink-0 truncate text-xs font-normal", selected ? "text-(color:--vk-fg-brand)" : "text-(color:--vk-fg-subtle)"), children: meta })) : null, trailing ? _jsx(Slot, { children: trailing }) : null, selected && !meta ? _jsx(ChosenCheck, {}) : null] }));
19
+ }
20
+ export function DefaultCheckRow({ checked, onClick, children, leading, trailing, disabled, className }) {
21
+ const { TickBox } = useViews().atoms;
22
+ return (_jsxs("button", { type: "button", "data-slot": "vk-check-row", "data-checked": checked || undefined, "aria-pressed": checked, onClick: onClick, disabled: disabled, className: cx(ELEMENT_RESET, ROW, "text-(color:--vk-fg)", disabled && DISABLED, className), children: [_jsx(TickBox, { checked: checked }), leading ? _jsx(Slot, { children: leading }) : null, _jsx("span", { className: "inline-flex min-w-0 flex-1 items-center", children: children }), trailing ? _jsx(Slot, { children: trailing }) : null] }));
23
+ }
24
+ export function DefaultRadioRow({ selected, label, onClick, leading, trailing, className, checkClassName, labelClassName, mark = "check", disabled, disabledReason, }) {
25
+ const { atoms, components } = useViews();
26
+ const box = mark === "box";
27
+ const row = (_jsxs("div", { "data-slot": "vk-radio-row", "data-chosen": selected || undefined, "data-disabled": disabled || undefined, className: cx(ROW, disabled && DISABLED, className), children: [_jsxs("button", { type: "button", "aria-pressed": selected, disabled: disabled, "aria-disabled": disabled || undefined, onClick: disabled ? undefined : onClick, className: cx(ELEMENT_RESET, "flex min-w-0 flex-1 items-center gap-2.5 text-left", !box && selected ? CHOSEN : "text-(color:--vk-fg)"), children: [box ? _jsx(atoms.TickBox, { checked: selected }) : null, leading ? _jsx(Slot, { children: leading }) : null, _jsx("span", { className: cx("flex-1 truncate text-sm", labelClassName), children: label }), !box && selected ? _jsx(ChosenCheck, { className: checkClassName }) : null] }), trailing] }));
28
+ if (!disabled || !disabledReason)
29
+ return row;
30
+ return (_jsx(components.Tooltip, { content: disabledReason, side: "right", delayMs: DISABLED_REASON_DELAY_MS, children: _jsx("span", { className: "block", children: row }) }));
31
+ }
32
+ export function DefaultDirectionButton({ dir, onClick, className, iconClassName }) {
33
+ const { icons, messages } = useViews();
34
+ const Arrow = icons.sortAsc;
35
+ return (_jsx("button", { type: "button", "data-slot": "vk-direction", "data-dir": dir, "aria-label": messages({ key: "views.panels.direction", values: { dir } }), onPointerDown: (event) => event.stopPropagation(), onClick: (event) => {
36
+ event.preventDefault();
37
+ event.stopPropagation();
38
+ onClick();
39
+ }, className: cx(ELEMENT_RESET, "inline-flex size-5 shrink-0 cursor-pointer items-center justify-center rounded-sm text-(color:--vk-fg-brand) transition-colors hover:bg-(color:--vk-brand-subtlest)", className), children: _jsx(Arrow, { className: cx("size-3.5 transition-transform duration-200 ease-out", dir === "desc" && "rotate-180", iconClassName) }) }));
40
+ }
@@ -0,0 +1,2 @@
1
+ import type { ViewsPanelSearchProps } from "./types.js";
2
+ export declare function DefaultPanelSearch({ value, onChange, onClear, placeholder, autoFocus, onKeyDown, onFocus, inputRef, className, leading, suffix, inputMode, }: ViewsPanelSearchProps): import("react/jsx-runtime").JSX.Element;
@@ -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 { cx } from "../internal/cx.js";
5
+ import { ELEMENT_RESET } from "../internal/reset.js";
6
+ import { useViews } from "../provider/context.js";
7
+ export function DefaultPanelSearch({ value, onChange, onClear, placeholder, autoFocus = false, onKeyDown, onFocus, inputRef, className, leading, suffix, inputMode, }) {
8
+ const { icons, messages } = useViews();
9
+ const ownRef = useRef(null);
10
+ const ref = inputRef ?? ownRef;
11
+ const Search = icons.search;
12
+ const Close = icons.close;
13
+ const lead = leading === undefined ? _jsx(Search, { className: "size-4 text-(color:--vk-fg-subtlest)" }) : leading;
14
+ return (_jsxs("div", { "data-slot": "vk-panel-search", className: cx("flex items-center gap-1.5 rounded-lg bg-(color:--vk-neutral) px-2.5 py-1.5 transition-colors focus-within:ring-1 focus-within:ring-(color:--vk-border-brand)", className), children: [lead ? _jsx("span", { className: "flex shrink-0 items-center", children: lead }) : null, _jsx("input", { ref: ref, type: "text", value: value, autoFocus: autoFocus, autoComplete: "off", onChange: (event) => onChange(event.target.value), onKeyDown: onKeyDown, onFocus: onFocus, placeholder: placeholder, inputMode: inputMode, className: cx(ELEMENT_RESET, "min-w-0 flex-1 bg-transparent text-base text-(color:--vk-fg) outline-hidden placeholder:text-(color:--vk-fg-subtlest) md:text-sm") }), suffix != null ? _jsx("span", { className: "shrink-0 text-xs text-(color:--vk-fg-subtlest)", children: suffix }) : null, value.length > 0 ? (_jsx("button", { type: "button", "aria-label": messages({ key: "views.panels.search-clear" }), onClick: () => {
15
+ if (onClear)
16
+ onClear();
17
+ else
18
+ onChange("");
19
+ ref.current?.focus();
20
+ }, className: cx(ELEMENT_RESET, "-mr-1 inline-flex size-5 shrink-0 items-center justify-center rounded-sm text-(color:--vk-fg-subtlest) transition-colors hover:text-(color:--vk-fg)"), children: _jsx(Close, { className: "size-3.5" }) })) : null] }));
21
+ }
@@ -0,0 +1,2 @@
1
+ import type { ViewsRelationRolesProps } from "./types.js";
2
+ export declare function DefaultRelationRoles({ relation, roles }: ViewsRelationRolesProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,6 @@
1
+ "use client";
2
+ import { jsxs as _jsxs } from "react/jsx-runtime";
3
+ export function DefaultRelationRoles({ relation, roles }) {
4
+ const labels = roles.map((role) => role.label).join(", ");
5
+ return (_jsxs("span", { "data-slot": "vk-relation-roles", title: `${relation.label} · ${labels}`, className: "min-w-0 shrink-[4] truncate text-(color:--vk-fg-subtlest)", children: [" · ", labels] }));
6
+ }
package/dist/atoms/Row.js CHANGED
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { cx } from "../internal/cx.js";
4
+ import { ELEMENT_RESET } from "../internal/reset.js";
4
5
  import { useViews } from "../provider/context.js";
5
6
  const LABEL_SIZE = { compact: "text-[13px]", regular: "text-sm" };
6
7
  function labelClass(label, wrap, size) {
@@ -26,5 +27,5 @@ export function DefaultRow({ onClick, onMouseDown, disabled, interactive = true,
26
27
  if (!interactive) {
27
28
  return (_jsx("div", { "data-slot": "vk-row", title: title, className: cx(frame, className), children: body }));
28
29
  }
29
- return (_jsx("button", { type: "button", "data-slot": "vk-row", "data-disabled": disabled || undefined, "data-open": open || undefined, "aria-haspopup": opens ? "dialog" : undefined, "aria-expanded": opens ? Boolean(open) : undefined, disabled: disabled, onClick: onClick, onMouseDown: onMouseDown, title: title, role: role, "aria-selected": role ? ariaSelected : undefined, className: cx(frame, "group/row transition-colors hover:bg-(color:--vk-hovered) data-open:bg-(color:--vk-pressed) disabled:pointer-events-none disabled:opacity-50", className), children: body }));
30
+ return (_jsx("button", { type: "button", "data-slot": "vk-row", "data-disabled": disabled || undefined, "data-open": open || undefined, "aria-haspopup": opens ? "dialog" : undefined, "aria-expanded": opens ? Boolean(open) : undefined, disabled: disabled, onClick: onClick, onMouseDown: onMouseDown, title: title, role: role, "aria-selected": role ? ariaSelected : undefined, className: cx(ELEMENT_RESET, frame, "group/row transition-colors hover:bg-(color:--vk-hovered) data-open:bg-(color:--vk-pressed) disabled:pointer-events-none disabled:opacity-50", className), children: body }));
30
31
  }
@@ -30,6 +30,7 @@ function hostEntry(item, index) {
30
30
  onSelect: item.onClick,
31
31
  disabled: item.disabled,
32
32
  destructive: item.destructive,
33
+ disabledReason: item.disabledReason,
33
34
  shortcut: item.shortcut,
34
35
  },
35
36
  };
@@ -111,5 +112,5 @@ export function DefaultRowMenu({ children, rowId, items, openHref, onDelete, del
111
112
  }, children: [children, _jsx(Menu, { open: point !== null && rows.length > 0, onOpenChange: (open) => {
112
113
  if (!open)
113
114
  setPoint(null);
114
- }, anchor: point, items: rows })] }));
115
+ }, anchor: point, items: rows, label: messages({ key: "views.menus.row-menu" }) })] }));
115
116
  }
@@ -0,0 +1,3 @@
1
+ import { type ReactNode } from "react";
2
+ import type { ViewsSelectionSheetProps } from "./types.js";
3
+ export declare function DefaultSelectionSheet({ open, onOpenChange, title, verbs, onDelete, deleteLabel, busy }: ViewsSelectionSheetProps): ReactNode;
@@ -0,0 +1,30 @@
1
+ "use client";
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { Fragment, useState } from "react";
4
+ import { cx } from "../internal/cx.js";
5
+ import { useViews } from "../provider/context.js";
6
+ import { OptionLabel } from "../selection/bar-parts.js";
7
+ const DANGER = "text-(color:--vk-danger)";
8
+ export function DefaultSelectionSheet({ open, onOpenChange, title, verbs, onDelete, deleteLabel, busy }) {
9
+ const { components, atoms, icons, messages } = useViews();
10
+ const { Sheet, Collapse } = components;
11
+ const { List, Row } = atoms;
12
+ const [expanded, setExpanded] = useState(null);
13
+ if (!open && expanded !== null)
14
+ setExpanded(null);
15
+ const run = (verb) => () => {
16
+ onOpenChange(false, { reason: "item-press" });
17
+ verb();
18
+ };
19
+ const Trash = icons.delete;
20
+ return (_jsx(Sheet, { open: open, onOpenChange: onOpenChange, title: title, label: messages({ key: "views.selection.sheet-label" }), snap: "auto", children: _jsx("div", { "data-slot": "vk-selection-sheet", children: _jsxs(List, { children: [verbs.map((verb, index) => {
21
+ if (verb.kind === "action") {
22
+ return (_jsx(Row, { label: verb.label, leading: verb.icon, className: cx(verb.destructive && DANGER), disabled: busy || verb.disabled, onClick: run(verb.onClick) }, index));
23
+ }
24
+ const isOpen = expanded === index;
25
+ const rows = verb.kind === "group"
26
+ ? verb.items.map((item, at) => (_jsx(Row, { label: item.label, leading: item.icon, className: cx(item.destructive && DANGER), disabled: busy || item.disabled, onClick: run(item.onClick) }, at)))
27
+ : verb.options.map((option) => (_jsx(Row, { size: "compact", label: _jsx(OptionLabel, { option: option }), disabled: busy, onClick: run(() => verb.onSelect(option.value)) }, option.value)));
28
+ return (_jsxs(Fragment, { children: [_jsx(Row, { label: verb.label, leading: verb.icon, disabled: busy || verb.disabled, open: isOpen, onClick: () => setExpanded(isOpen ? null : index) }), _jsx(Collapse, { open: isOpen, children: _jsx("div", { className: "pl-4", children: rows }) })] }, index));
29
+ }), onDelete ? (_jsx(Row, { label: deleteLabel, leading: _jsx(Trash, { className: "h-4 w-4" }), className: DANGER, disabled: busy, onClick: run(onDelete) })) : null] }) }) }));
30
+ }
@@ -1,6 +1,8 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
3
  import { useRef, useState } from "react";
4
+ import { cx } from "../internal/cx.js";
5
+ import { ELEMENT_RESET } from "../internal/reset.js";
4
6
  import { useViews } from "../provider/context.js";
5
7
  export function DefaultStatusMarker({ slot = "warning", label, title, reason, emptyReason, onResolve, resolveLabel, }) {
6
8
  const { atoms, components, icons, messages } = useViews();
@@ -9,7 +11,7 @@ export function DefaultStatusMarker({ slot = "warning", label, title, reason, em
9
11
  const { Popover, Button } = components;
10
12
  const Badge = atoms.StatusBadge;
11
13
  const Warning = icons.warning;
12
- return (_jsxs(_Fragment, { children: [_jsx("button", { ref: anchor, type: "button", tabIndex: -1, "aria-label": title, "data-slot": "vk-marker", className: "inline-flex max-w-full", onClick: (event) => {
14
+ return (_jsxs(_Fragment, { children: [_jsx("button", { ref: anchor, type: "button", tabIndex: -1, "aria-label": title, "data-slot": "vk-marker", className: cx(ELEMENT_RESET, "inline-flex max-w-full"), onClick: (event) => {
13
15
  event.stopPropagation();
14
16
  setOpen((current) => !current);
15
17
  }, children: _jsx(Badge, { slot: slot, label: label, leading: _jsx(Warning, { className: "size-3" }) }) }), _jsx(Popover, { open: open, onOpenChange: (next) => setOpen(next), anchor: anchor, side: "bottom", align: "start", className: "w-64", onPanelClick: (event) => event.stopPropagation(), onOutsidePress: (event) => anchor.current?.contains(event.target) ? false : undefined, children: _jsxs("div", { className: "flex flex-col gap-2 text-sm", children: [_jsx("span", { className: "text-xs font-medium text-(color:--vk-fg-subtle)", children: title }), _jsx("span", { children: reason || emptyReason || messages({ key: "views.editors.marker-no-reason" }) }), onResolve ? (_jsx(Button, { size: "sm", variant: "outline", onClick: () => {
package/dist/atoms/Tag.js CHANGED
@@ -1,12 +1,13 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { cx } from "../internal/cx.js";
4
+ import { ELEMENT_RESET } from "../internal/reset.js";
4
5
  import { useViews } from "../provider/context.js";
5
6
  import { TAG_TONE } from "./tones.js";
6
7
  export function DefaultTag({ label, color, leading, onRemove, removeLabel, className }) {
7
8
  const { icons, messages } = useViews();
8
9
  const Close = icons.close;
9
- return (_jsxs("span", { "data-slot": "vk-tag", className: cx("inline-flex h-5 max-w-full items-center gap-1 rounded-md px-2 text-xs font-medium", onRemove ? "pr-1" : null, TAG_TONE[color], className), children: [leading ? _jsx("span", { "aria-hidden": "true", className: "flex shrink-0 items-center", children: leading }) : null, _jsx("span", { className: "truncate", children: label }), onRemove ? (_jsx("button", { type: "button", "aria-label": removeLabel ?? messages({ key: "views.editors.tag-remove", values: { label } }), className: "grid size-3.5 shrink-0 place-content-center rounded-full hover:bg-(color:--vk-hovered)", onClick: (event) => {
10
+ return (_jsxs("span", { "data-slot": "vk-tag", className: cx("inline-flex h-5 max-w-full items-center gap-1 rounded-md px-2 text-xs font-medium", onRemove ? "pr-1" : null, TAG_TONE[color], className), children: [leading ? _jsx("span", { "aria-hidden": "true", className: "flex shrink-0 items-center", children: leading }) : null, _jsx("span", { className: "truncate", children: label }), onRemove ? (_jsx("button", { type: "button", "aria-label": removeLabel ?? messages({ key: "views.editors.tag-remove", values: { label } }), className: cx(ELEMENT_RESET, "grid size-3.5 shrink-0 place-content-center rounded-full hover:bg-(color:--vk-hovered)"), onClick: (event) => {
10
11
  event.stopPropagation();
11
12
  onRemove();
12
13
  }, children: _jsx(Close, { className: "size-2.5" }) })) : null] }));
@@ -1,11 +1,16 @@
1
1
  import { DefaultCommandMenu } from "./CommandMenu.js";
2
+ import { DefaultMenuRow, DefaultToggleRow } from "./DrillRows.js";
3
+ import { DefaultCheckRow, DefaultChoiceRow, DefaultDirectionButton, DefaultRadioRow } from "./PanelRows.js";
4
+ import { DefaultPanelSearch } from "./PanelSearch.js";
2
5
  import { DefaultList } from "./List.js";
3
6
  import { DefaultLoading } from "./Loading.js";
4
7
  import { DefaultLoadMore } from "./LoadMore.js";
5
8
  import { DefaultPlatformMark } from "./PlatformMark.js";
6
9
  import { DefaultRelationLink } from "./RelationLink.js";
10
+ import { DefaultRelationRoles } from "./RelationRoles.js";
7
11
  import { DefaultRow, DefaultRowContent } from "./Row.js";
8
12
  import { DefaultRowMenu } from "./RowMenu.js";
13
+ import { DefaultSelectionSheet } from "./SelectionSheet.js";
9
14
  import { DefaultStatusBadge } from "./StatusBadge.js";
10
15
  import { DefaultStatusMarker } from "./StatusMarker.js";
11
16
  import { DefaultTag } from "./Tag.js";
@@ -20,8 +25,17 @@ export const DEFAULT_VIEWS_ATOMS = {
20
25
  Tag: DefaultTag,
21
26
  CommandMenu: DefaultCommandMenu,
22
27
  RelationLink: DefaultRelationLink,
28
+ RelationRoles: DefaultRelationRoles,
23
29
  Loading: DefaultLoading,
24
30
  LoadMore: DefaultLoadMore,
25
31
  PlatformMark: DefaultPlatformMark,
26
32
  RowMenu: DefaultRowMenu,
33
+ ChoiceRow: DefaultChoiceRow,
34
+ CheckRow: DefaultCheckRow,
35
+ RadioRow: DefaultRadioRow,
36
+ DirectionButton: DefaultDirectionButton,
37
+ MenuRow: DefaultMenuRow,
38
+ ToggleRow: DefaultToggleRow,
39
+ PanelSearch: DefaultPanelSearch,
40
+ SelectionSheet: DefaultSelectionSheet,
27
41
  };
@@ -1,8 +1,10 @@
1
- import type { ComponentType, MouseEventHandler, ReactElement, ReactNode } from "react";
1
+ import type { ComponentType, KeyboardEvent, MouseEventHandler, ReactElement, ReactNode, RefObject } from "react";
2
2
  import type { LinkPlatform, RelationValue } from "@viewkitjs/fields";
3
3
  import type { CategoryColor } from "@viewkitjs/fields/design/category-colors";
4
4
  import type { StatusSlot } from "@viewkitjs/fields/design/status-slots";
5
5
  import type { FieldRowMenuItem } from "../fields/menus.js";
6
+ import type { ViewsOpenChange } from "../provider/components.js";
7
+ import type { SelectionVerb } from "../selection/verbs.js";
6
8
  /** A row's inside. Inside a command list's item it is all the row is: the item owns
7
9
  * the element, the highlight and the keyboard. */
8
10
  export type ViewsRowContentProps = {
@@ -101,6 +103,9 @@ export type ViewsCommandMenuProps = {
101
103
  trigger: ReactElement;
102
104
  items: readonly FieldRowMenuItem[];
103
105
  align?: "start" | "center" | "end";
106
+ /** The field the verbs act on: the default names its menu after it (`views.menus.commands`). The
107
+ * cell and the field row hand it; without it the menu is `views.menus.commands-unnamed`. */
108
+ label?: string;
104
109
  };
105
110
  /** Where a relation chip goes: the app's own link around the chip the display drew. The default
106
111
  * goes nowhere — a relation is a fact as often as a destination. */
@@ -108,6 +113,17 @@ export type ViewsRelationLinkProps = {
108
113
  relation: RelationValue;
109
114
  children: ReactNode;
110
115
  };
116
+ /** A link's roles, drawn inside its chip after the record's name: each role's stored value and its label (the
117
+ * field's `links.roles`, else the value itself). Handed only when the link holds one or more, on a many relation
118
+ * that declares `links`. The default draws their labels in the subtle colour after a middle dot; an app swaps in
119
+ * its own (a tag per role, a second line). */
120
+ export type ViewsRelationRolesProps = {
121
+ relation: RelationValue;
122
+ roles: readonly {
123
+ value: string;
124
+ label: string;
125
+ }[];
126
+ };
111
127
  /** A wait: the whole list reloading (`body`), or more rows arriving (`footer`). The default is a
112
128
  * plain ring; an app swaps in its own loader. */
113
129
  export type ViewsLoadingProps = {
@@ -138,17 +154,39 @@ export type ViewsRowMenuItem = {
138
154
  onClick: () => void;
139
155
  destructive?: boolean;
140
156
  disabled?: boolean;
157
+ /** Why the disabled row can't be used, in words, handed to the app's `Menu`. */
158
+ disabledReason?: string;
141
159
  /** A keyboard hint drawn at the row's end, never bound by the menu. */
142
160
  shortcut?: string;
143
161
  };
144
- /** The row's right-click menu, around the row it opens on. The rendering builds `items` (the cell's
145
- * clipboard rows, Select, the host's verbs); the menu adds the page link before them and Delete after.
146
- * The default is the components map's `Menu` at the pointer, its Delete asking the confirm port; an
147
- * app swaps in its own (a long-press that selects). */
162
+ /** The phone's sheet of a selection's verbs, opened by the selection bar's Actions. The default is the
163
+ * components map's `Sheet` holding the atoms' rows: a group's or an options verb's rows open in place under
164
+ * it, and the delete comes last, in words. Picking a row closes the sheet, then runs it, since a verb usually
165
+ * ends by clearing the selection and taking the bar down with it. An app swaps in its own action sheet. */
166
+ export type ViewsSelectionSheetProps = {
167
+ open: boolean;
168
+ onOpenChange: ViewsOpenChange;
169
+ /** "3 selected". */
170
+ title: string;
171
+ verbs: readonly SelectionVerb[];
172
+ /** The bar's own delete, drawn last; absent when the list has no bulk delete. */
173
+ onDelete?: () => void;
174
+ deleteLabel: string;
175
+ /** A batch is running: every row is disabled. */
176
+ busy: boolean;
177
+ };
178
+ /** The rows' right-click menu, around the rows it opens on. The grid mounts ONE for each section's rows'
179
+ * container, never one per row, and AIMS it: its props are those of the row a press or a right-click came
180
+ * from, set in the same event the menu opens on, so a person meets each row's own menu. The rendering
181
+ * builds `items` (the cell's clipboard rows, Select, the host's verbs); the menu adds the page link before
182
+ * them and Delete after. The default is the components map's `Menu` at the pointer, its Delete asking the
183
+ * confirm port; an app swaps in its own (a long-press that selects). */
148
184
  export type ViewsRowMenuProps = {
149
- /** The row: right-click on it, or the row's ⋯, opens the menu. */
185
+ /** The rows' container: a right-click on a row inside it, or a row's ⋯, opens the menu. It takes the
186
+ * props and ref an app's trigger hands it (a `Slot`, `asChild`) and passes them to its element. A
187
+ * right-click on no row arrives already prevented and opens nothing. */
150
188
  children: ReactNode;
151
- /** The row's data id: what `onDelete` is called with. */
189
+ /** The aimed row's data id: what `onDelete` is called with. Empty before any row is aimed at. */
152
190
  rowId: string;
153
191
  items: readonly ViewsRowMenuItem[];
154
192
  /** The row's own page, opened in a new tab. Absent: no Open page row. */
@@ -157,10 +195,101 @@ export type ViewsRowMenuProps = {
157
195
  onDelete?: (rowId: string) => Promise<void>;
158
196
  /** What Delete removes, handed to the confirm port as its `subject`. */
159
197
  deleteLabel?: string;
160
- /** Flips the row's selection, for an app whose long-press selects. Absent when the list can't select.
198
+ /** Flips the selection of the row last pressed, for an app whose long-press selects. Absent when the list
199
+ * can't select, and there from the first render where it can, so a long-press is armed before any press.
161
200
  * The default doesn't use it: on a phone the ⋯ is the way in. */
162
201
  onToggleSelect?: () => void;
163
202
  };
203
+ /** Picks one value: its label, a second line, a right-hand `meta` (a sample, a count), the check when chosen. */
204
+ export type ViewsChoiceRowProps = {
205
+ selected?: boolean;
206
+ label: ReactNode;
207
+ /** A second line under the label. */
208
+ description?: ReactNode;
209
+ /** Right-aligned secondary text; a row with one draws no check, its meta in the brand colour when chosen. */
210
+ meta?: ReactNode;
211
+ leading?: ReactNode;
212
+ trailing?: ReactNode;
213
+ onClick: () => void;
214
+ /** For a row inside an editor that must keep its input focused. */
215
+ onMouseDown?: MouseEventHandler<HTMLButtonElement>;
216
+ disabled?: boolean;
217
+ className?: string;
218
+ role?: string;
219
+ "aria-selected"?: boolean;
220
+ };
221
+ /** Toggles one of many: a tick box on the left shows both states. */
222
+ export type ViewsCheckRowProps = {
223
+ checked: boolean;
224
+ onClick: () => void;
225
+ children: ReactNode;
226
+ leading?: ReactNode;
227
+ trailing?: ReactNode;
228
+ /** Drawn but not togglable for now (a toggle still saving). */
229
+ disabled?: boolean;
230
+ className?: string;
231
+ };
232
+ /** Picks one of a set: `mark="check"` (default) marks the chosen row with a check, `mark="box"` draws a tick
233
+ * box with radio semantics. `trailing` sits outside the choosing button. A disabled row with a
234
+ * `disabledReason` shows it in the map's `Tooltip` once the pointer rests. */
235
+ export type ViewsRadioRowProps = {
236
+ selected: boolean;
237
+ label: string;
238
+ onClick: () => void;
239
+ leading?: ReactNode;
240
+ trailing?: ReactNode;
241
+ className?: string;
242
+ checkClassName?: string;
243
+ labelClassName?: string;
244
+ mark?: "check" | "box";
245
+ disabled?: boolean;
246
+ disabledReason?: string;
247
+ };
248
+ /** A sort's direction arrow, flipped by a press that never reaches the row around it. */
249
+ export type ViewsDirectionButtonProps = {
250
+ dir: "asc" | "desc";
251
+ onClick: () => void;
252
+ className?: string;
253
+ iconClassName?: string;
254
+ };
255
+ /** A drill-in row: a glyph, the section's name, where it stands, and a chevron unless disabled. */
256
+ export type ViewsMenuRowProps = {
257
+ icon: ReactNode;
258
+ label: string;
259
+ value: string;
260
+ active: boolean;
261
+ /** Listed but not openable. */
262
+ disabled?: boolean;
263
+ onClick: () => void;
264
+ };
265
+ /** A boolean that flips in place, a painted switch where the chevron would be; `reset` draws the way back to
266
+ * the reader's default on the row. */
267
+ export type ViewsToggleRowProps = {
268
+ icon?: ReactNode;
269
+ label: string;
270
+ active: boolean;
271
+ disabled?: boolean;
272
+ onClick: () => void;
273
+ reset?: {
274
+ onReset: () => void;
275
+ };
276
+ };
277
+ /** A panel's text box: a filled well with a magnifier. `leading` replaces it, `null` drops it. */
278
+ export type ViewsPanelSearchProps = {
279
+ value: string;
280
+ onChange: (value: string) => void;
281
+ /** Emptying, committed at once; falls back to `onChange("")`. */
282
+ onClear?: () => void;
283
+ placeholder?: string;
284
+ autoFocus?: boolean;
285
+ onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
286
+ onFocus?: () => void;
287
+ inputRef?: RefObject<HTMLInputElement | null>;
288
+ className?: string;
289
+ leading?: ReactNode | null;
290
+ suffix?: ReactNode;
291
+ inputMode?: "text" | "decimal" | "numeric";
292
+ };
164
293
  export type ViewsAtoms = {
165
294
  List: ComponentType<ViewsListProps>;
166
295
  Row: ComponentType<ViewsRowProps>;
@@ -171,8 +300,17 @@ export type ViewsAtoms = {
171
300
  Tag: ComponentType<ViewsTagProps>;
172
301
  CommandMenu: ComponentType<ViewsCommandMenuProps>;
173
302
  RelationLink: ComponentType<ViewsRelationLinkProps>;
303
+ RelationRoles: ComponentType<ViewsRelationRolesProps>;
174
304
  Loading: ComponentType<ViewsLoadingProps>;
175
305
  LoadMore: ComponentType<ViewsLoadMoreProps>;
176
306
  PlatformMark: ComponentType<ViewsPlatformMarkProps>;
177
307
  RowMenu: ComponentType<ViewsRowMenuProps>;
308
+ ChoiceRow: ComponentType<ViewsChoiceRowProps>;
309
+ CheckRow: ComponentType<ViewsCheckRowProps>;
310
+ RadioRow: ComponentType<ViewsRadioRowProps>;
311
+ DirectionButton: ComponentType<ViewsDirectionButtonProps>;
312
+ MenuRow: ComponentType<ViewsMenuRowProps>;
313
+ ToggleRow: ComponentType<ViewsToggleRowProps>;
314
+ PanelSearch: ComponentType<ViewsPanelSearchProps>;
315
+ SelectionSheet: ComponentType<ViewsSelectionSheetProps>;
178
316
  };
@@ -2,6 +2,8 @@
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { valueTypeOf } from "@viewkitjs/fields";
4
4
  import { ConvertedFigure } from "../display/converted.js";
5
+ import { cx } from "../internal/cx.js";
6
+ import { ELEMENT_RESET } from "../internal/reset.js";
5
7
  import { renderFieldValue } from "../display/display-cores.js";
6
8
  import { convertedFromOf } from "../fields/money.js";
7
9
  import { columnLabel } from "../model/column-capabilities.js";
@@ -59,9 +61,9 @@ function CommandCell({ col, cell, items, }) {
59
61
  const Chevron = icons.chevronDown;
60
62
  const verbs = items.map((item) => ({ ...item }));
61
63
  if (CONTROL_VALUES.has(col.type)) {
62
- return (_jsxs("span", { className: "flex min-w-0 items-center gap-1", children: [cell, _jsx(CommandMenu, { items: verbs, align: "start", trigger: _jsx("button", { type: "button", "aria-label": columnLabel(col), className: "shrink-0 -m-1 p-1", children: _jsx(Chevron, { className: "h-3 w-3 opacity-60" }) }) })] }));
64
+ return (_jsxs("span", { className: "flex min-w-0 items-center gap-1", children: [cell, _jsx(CommandMenu, { items: verbs, align: "start", label: columnLabel(col), trigger: _jsx("button", { type: "button", "aria-label": columnLabel(col), className: cx(ELEMENT_RESET, "shrink-0 -m-1 p-1"), children: _jsx(Chevron, { className: "h-3 w-3 opacity-60" }) }) })] }));
63
65
  }
64
- return (_jsx(CommandMenu, { items: verbs, align: "start", trigger: _jsxs("button", { type: "button", "aria-label": columnLabel(col), className: "flex min-w-0 items-center gap-1 text-left", children: [cell, _jsx(Chevron, { className: "h-3 w-3 opacity-60" })] }) }));
66
+ return (_jsx(CommandMenu, { items: verbs, align: "start", label: columnLabel(col), trigger: _jsxs("button", { type: "button", "aria-label": columnLabel(col), className: cx(ELEMENT_RESET, "flex min-w-0 items-center gap-1 text-left"), children: [cell, _jsx(Chevron, { className: "h-3 w-3 opacity-60" })] }) }));
65
67
  }
66
68
  function displayOptionsFor(col, row, opts) {
67
69
  const resolved = resolveRowCurrency(col, row, opts);
@@ -1,6 +1,8 @@
1
1
  "use client";
2
2
  import { jsx as _jsx } from "react/jsx-runtime";
3
3
  import { CHIP_INTERACTIVE } from "../internal/chip.js";
4
+ import { cx } from "../internal/cx.js";
5
+ import { ELEMENT_RESET } from "../internal/reset.js";
4
6
  import { useViews } from "../provider/context.js";
5
7
  export function listRelationWrap(opts) {
6
8
  if (opts?.slotOwnsClick)
@@ -11,7 +13,7 @@ export function listRelationWrap(opts) {
11
13
  return (_jsx("button", { type: "button", "data-no-nav": true, title: relation.label, onClick: (event) => {
12
14
  event.stopPropagation();
13
15
  onOpenRelation(relation);
14
- }, className: CHIP_INTERACTIVE, children: chip }));
16
+ }, className: cx(ELEMENT_RESET, CHIP_INTERACTIVE), children: chip }));
15
17
  };
16
18
  }
17
19
  return function appRelationWrap(relation, chip) {