@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
@@ -1,5 +1,5 @@
1
1
  import type { CityWord, PercentDisplay, PostalWord, RegionWord } from "@viewkitjs/fields";
2
- type FigureKind = "none" | "sum" | "avg" | "min" | "max" | "count" | "filled" | "unique" | "ratio";
2
+ import type { FigureKind } from "@viewkitjs/fields/query";
3
3
  type OptionColour = "gray" | "blue" | "green" | "amber" | "red" | "purple" | "pink" | "teal";
4
4
  type DateStyle = "short" | "long" | "numeric" | "relative";
5
5
  type DurationStyle = "adaptive" | "clock" | "units";
@@ -10,14 +10,14 @@ export declare const VK_PREFIX: "vk";
10
10
  /** The parts of the grid, as `data-slot` values. `data-slot` is one attribute shared by
11
11
  * every component copy in an app, so each value carries the prefix. Board's arrive with
12
12
  * the board. */
13
- export declare const GRID_SLOTS: readonly ["vk-grid", "vk-grid-scroll", "vk-grid-head", "vk-grid-header", "vk-grid-header-cell", "vk-grid-row", "vk-grid-rows", "vk-grid-gap", "vk-grid-cell", "vk-grid-group", "vk-grid-group-head", "vk-grid-group-header", "vk-grid-footer", "vk-grid-footer-cell", "vk-grid-rail", "vk-grid-tail", "vk-grid-row-more", "vk-grid-editor", "vk-grid-outline", "vk-grid-resize-handle", "vk-grid-column-menu", "vk-grid-flyout", "vk-grid-group-menu", "vk-grid-aggregate-menu"];
13
+ export declare const GRID_SLOTS: readonly ["vk-grid", "vk-grid-pan", "vk-grid-scroll", "vk-grid-head", "vk-grid-header", "vk-grid-header-cell", "vk-grid-row", "vk-grid-rows", "vk-grid-gap", "vk-grid-cell", "vk-grid-group", "vk-grid-group-head", "vk-grid-group-header", "vk-grid-footer", "vk-grid-footer-cell", "vk-grid-rail", "vk-grid-tail", "vk-grid-row-more", "vk-grid-editor", "vk-grid-outline", "vk-grid-resize-handle", "vk-grid-column-menu", "vk-grid-flyout", "vk-grid-group-menu", "vk-grid-aggregate-menu"];
14
14
  export type GridSlot = (typeof GRID_SLOTS)[number];
15
15
  /** The flags the rendering styles, as `data-*` attributes present when true. */
16
16
  export declare const GRID_STATES: readonly ["focused", "selected", "editing", "in-range", "range-edge", "pending", "invalid", "dragging", "empty", "frozen", "scrolled", "parked"];
17
17
  export type GridState = (typeof GRID_STATES)[number];
18
18
  /** The CSS variables the package owns: geometry and density. Its colours are `VK_COLOURS`, which the app declares.
19
19
  * The last three are `densityStyle`'s, written on the root of a rows view an app draws itself. */
20
- export declare const VK_TOKENS: readonly ["--vk-scale", "--vk-row-h", "--vk-head-h", "--vk-footer-h", "--vk-label-h", "--vk-line-h", "--vk-px", "--vk-tail-pl", "--vk-rail-w", "--vk-rail-gap", "--vk-tail-w", "--vk-indent", "--vk-frozen-w", "--vk-scroll-mt", "--vk-glyph", "--vk-head-glyph", "--vk-text", "--vk-text-xs", "--vk-text-10", "--vk-head-text", "--vk-scrolled", "--vk-parked", "--vk-frozen-on", "--vk-row-py", "--vk-head-mb", "--vk-row-gap"];
20
+ export declare const VK_TOKENS: readonly ["--vk-scale", "--vk-row-h", "--vk-head-h", "--vk-footer-h", "--vk-label-h", "--vk-line-h", "--vk-px", "--vk-tail-pl", "--vk-rail-w", "--vk-rail-gap", "--vk-tail-w", "--vk-indent", "--vk-frozen-w", "--vk-scroll-mt", "--vk-glyph", "--vk-head-glyph", "--vk-text", "--vk-text-xs", "--vk-text-10", "--vk-head-text", "--vk-scrolled", "--vk-pin", "--vk-stick", "--vk-parked", "--vk-frozen-on", "--vk-row-py", "--vk-head-mb", "--vk-row-gap"];
21
21
  export type VkToken = (typeof VK_TOKENS)[number];
22
22
  /** The colours the rendering paints, each a CSS variable the APP declares — the package
23
23
  * sets none, and names no variable of the app's own. An app maps each onto its tokens once
@@ -27,8 +27,10 @@ export type VkToken = (typeof VK_TOKENS)[number];
27
27
  export declare const VK_COLOURS: readonly ["--vk-fg", "--vk-fg-subtle", "--vk-fg-subtlest", "--vk-fg-brand", "--vk-fg-selected", "--vk-fg-on-brand", "--vk-ground", "--vk-overlay", "--vk-hovered", "--vk-pressed", "--vk-neutral", "--vk-neutral-hovered", "--vk-brand", "--vk-brand-subtlest", "--vk-danger", "--vk-danger-subtlest", "--vk-border", "--vk-border-subtle", "--vk-border-bold", "--vk-border-brand"];
28
28
  export type VkColour = (typeof VK_COLOURS)[number];
29
29
  /** Colours the default atoms and the display read with a built-in fallback — the status
30
- * hues and the category hues — so an app that declares none of them still reads right. */
31
- export declare const VK_OPTIONAL_COLOURS: readonly ["--vk-success", "--vk-warning", "--vk-info", "--vk-label-blue", "--vk-label-green", "--vk-label-amber", "--vk-label-red", "--vk-label-purple", "--vk-label-pink", "--vk-label-teal"];
30
+ * hues and the category hues — so an app that declares none of them still reads right.
31
+ * `--vk-float-shadow` is a whole `box-shadow` value: the drop under what floats over a list
32
+ * (the selection bar). */
33
+ export declare const VK_OPTIONAL_COLOURS: readonly ["--vk-success", "--vk-warning", "--vk-info", "--vk-label-blue", "--vk-label-green", "--vk-label-amber", "--vk-label-red", "--vk-label-purple", "--vk-label-pink", "--vk-label-teal", "--vk-float-shadow"];
32
34
  export type VkOptionalColour = (typeof VK_OPTIONAL_COLOURS)[number];
33
35
  /** Layout the APP may declare, read with a built-in fallback. `--vk-gutter` is the side padding the
34
36
  * page gives its content: the grid's rows run edge to edge and line their content up with it.
@@ -42,25 +44,33 @@ export type VkOptionalLayout = (typeof VK_OPTIONAL_LAYOUT)[number];
42
44
  /** The grid's own machinery, set and read by the grid alone: prefixed because they share the
43
45
  * global namespace, and not public. An app neither sets nor reads them, and they may change in
44
46
  * any release. `--vk-drag-shift` is a header cell's offset while its column is dragged;
45
- * `--vk-cols` is the columns' template, set on the scroll area and read by every row. */
46
- export declare const VK_INTERNAL: readonly ["--vk-drag-shift", "--vk-cols"];
47
+ * `--vk-cols` is the columns' template, set on the rows' box and read by every row; `--vk-hold-x` and `--vk-sx` are
48
+ * the offsets that hold the frozen block, the rail, a group's name and the empty message at the left while the
49
+ * lab's lock is on and the table is scrolled sideways. */
50
+ export declare const VK_INTERNAL: readonly ["--vk-drag-shift", "--vk-cols", "--vk-hold-x", "--vk-sx"];
47
51
  export type VkInternal = (typeof VK_INTERNAL)[number];
48
52
  /** Internal families: a prefix, one variable per key after it. `--vk-col-w-<id>` is one
49
53
  * column's resolved width, set on the grid's root for every visible column. */
50
54
  export declare const VK_INTERNAL_FAMILIES: readonly ["--vk-col-w-"];
51
55
  /** The primitives an app hands in through the provider. */
52
- export declare const COMPONENT_NAMES: readonly ["Button", "Popover", "Tooltip", "Checkbox", "Menu", "Command", "Calendar", "Collapse", "Sheet", "AppIcon", "Markdown"];
56
+ export declare const COMPONENT_NAMES: readonly ["Button", "Popover", "Tooltip", "Checkbox", "Menu", "Collapse", "Sheet", "AppIcon", "Markdown"];
53
57
  export type ComponentName = (typeof COMPONENT_NAMES)[number];
54
- /** The primitives an app may hand in, each with a plain default the provider fills: apart from
55
- * `COMPONENT_NAMES`, which lists the ones it must. */
56
- export declare const OPTIONAL_COMPONENT_NAMES: readonly ["Input"];
58
+ /** The primitives an app may leave out, apart from `COMPONENT_NAMES`, which lists the ones it must hand
59
+ * in: `Input` has a plain default; `Command` and `Calendar`, reached without one, throw an error naming
60
+ * it; without `Picker`, the lists draw from `Command`; without `DateBody`, the date editor draws its own
61
+ * around `Calendar`. */
62
+ export declare const OPTIONAL_COMPONENT_NAMES: readonly ["Input", "Command", "Picker", "Calendar", "DateBody"];
57
63
  export type OptionalComponentName = (typeof OPTIONAL_COMPONENT_NAMES)[number];
58
- /** The pieces the rendering is built from, and the app's own pieces it cannot draw itself (a command cell's verb menu, the row's right-click menu, where a relation goes, a wait, how a list asks for more). Each ships as a default; an app swaps any of them through the provider's `atoms`. */
59
- export declare const ATOM_NAMES: readonly ["Row", "RowContent", "TickBox", "StatusBadge", "StatusMarker", "Tag", "List", "CommandMenu", "RelationLink", "Loading", "LoadMore", "PlatformMark", "RowMenu"];
64
+ /** The pieces the rendering is built from, and the app's own pieces it cannot draw itself (a command cell's verb menu, the row's right-click menu, where a relation goes, a wait, how a list asks for more), and the rows the panels draw with. Each ships as a default; an app swaps any of them through the provider's `atoms`. */
65
+ export declare const ATOM_NAMES: readonly ["Row", "RowContent", "TickBox", "StatusBadge", "StatusMarker", "Tag", "List", "CommandMenu", "RelationLink", "RelationRoles", "Loading", "LoadMore", "PlatformMark", "RowMenu", "SelectionSheet", "ChoiceRow", "CheckRow", "RadioRow", "DirectionButton", "MenuRow", "ToggleRow", "PanelSearch"];
60
66
  export type AtomName = (typeof ATOM_NAMES)[number];
61
67
  /** The default atoms' `data-slot` values: prefixed, like the grid's. */
62
- export declare const ATOM_SLOTS: readonly ["vk-row", "vk-row-content", "vk-tick", "vk-status", "vk-marker", "vk-tag", "vk-list", "vk-command-menu", "vk-relation-link", "vk-loading", "vk-load-more", "vk-platform", "vk-row-menu"];
68
+ export declare const ATOM_SLOTS: readonly ["vk-row", "vk-row-content", "vk-tick", "vk-status", "vk-marker", "vk-tag", "vk-list", "vk-command-menu", "vk-relation-link", "vk-relation-roles", "vk-loading", "vk-load-more", "vk-platform", "vk-row-menu", "vk-choice-row", "vk-check-row", "vk-radio-row", "vk-direction", "vk-menu-row", "vk-toggle-row", "vk-panel-search", "vk-selection-sheet"];
63
69
  export type AtomSlot = (typeof ATOM_SLOTS)[number];
70
+ /** The selection bar's `data-slot` values: prefixed, like the grid's. The fixed box the app places,
71
+ * the pill inside it, and the count that clears the selection. */
72
+ export declare const SELECTION_SLOTS: readonly ["vk-selection-bar", "vk-selection-pill", "vk-selection-chip"];
73
+ export type SelectionSlot = (typeof SELECTION_SLOTS)[number];
64
74
  /** The editor panel's `data-slot` values: prefixed, like the grid's. */
65
75
  export declare const EDITOR_SLOTS: readonly ["vk-editor-panel", "vk-editor-bar", "vk-editor-refusal", "vk-text-editor"];
66
76
  export type EditorSlot = (typeof EDITOR_SLOTS)[number];
@@ -73,10 +83,10 @@ export declare const PORT_NAMES: readonly ["toast", "haptics", "clipboard", "vie
73
83
  export type PortName = (typeof PORT_NAMES)[number];
74
84
  /** The glyphs the rendering asks the app for, by what they mean, never by a
75
85
  * library's name. The app maps each to its own icon component. */
76
- export declare const ICON_NAMES: readonly ["text", "longText", "number", "percent", "currency", "date", "datetime", "duration", "boolean", "select", "status", "multiselect", "relation", "user", "url", "domain", "email", "phone", "location", "name", "actor", "rich_text", "range", "lookup", "rollup", "formula", "computed", "automation", "apiKey", "system", "add", "edit", "delete", "copy", "cut", "paste", "clear", "hide", "show", "lock", "pin", "wrap", "more", "close", "check", "warning", "drag", "resize", "open", "selectRow", "chevronDown", "chevronRight", "caretDown", "caretRight", "sortAsc", "sortDesc", "enter", "calendar", "time", "progress", "moveLeft", "moveRight", "group", "clearSort", "sortRowsUp", "sortRowsDown"];
86
+ export declare const ICON_NAMES: readonly ["text", "longText", "number", "percent", "currency", "date", "datetime", "duration", "boolean", "select", "status", "multiselect", "relation", "user", "url", "domain", "email", "phone", "location", "name", "actor", "rich_text", "range", "lookup", "rollup", "formula", "computed", "automation", "apiKey", "system", "add", "edit", "delete", "copy", "cut", "paste", "clear", "hide", "show", "lock", "pin", "wrap", "more", "close", "check", "warning", "drag", "resize", "open", "selectRow", "chevronDown", "chevronRight", "caretDown", "caretRight", "sortAsc", "sortDesc", "enter", "calendar", "time", "progress", "moveLeft", "moveRight", "group", "clearSort", "sortRowsUp", "sortRowsDown", "search", "reset"];
77
87
  export type ViewsIconName = (typeof ICON_NAMES)[number];
78
88
  /** Every visible string the views package owns is a key under one of these. */
79
- export declare const MESSAGE_NAMESPACES: readonly ["views.grid", "views.editors", "views.menus", "views.display"];
89
+ export declare const MESSAGE_NAMESPACES: readonly ["views.grid", "views.editors", "views.menus", "views.display", "views.selection", "views.panels"];
80
90
  export type ViewsMessageNamespace = (typeof MESSAGE_NAMESPACES)[number];
81
91
  /** A message the package emits: its key and the values a host may interpolate,
82
92
  * never a sentence. A string `@viewkitjs/fields` already keys stays a fields
@@ -299,6 +309,25 @@ export type ViewsMessage = {
299
309
  key: "views.menus.row-delete-confirm";
300
310
  } | {
301
311
  key: "views.menus.row-delete-failed";
312
+ } | {
313
+ key: "views.menus.row-menu";
314
+ } | {
315
+ key: "views.menus.commands";
316
+ values: {
317
+ field: string;
318
+ };
319
+ } | {
320
+ key: "views.menus.commands-unnamed";
321
+ } | {
322
+ key: "views.menus.figure-menu";
323
+ values: {
324
+ field: string;
325
+ };
326
+ } | {
327
+ key: "views.menus.column-menu";
328
+ values: {
329
+ field: string;
330
+ };
302
331
  } | {
303
332
  key: "views.grid.figure";
304
333
  values: {
@@ -416,6 +445,17 @@ export type ViewsMessage = {
416
445
  count: number;
417
446
  reason: string;
418
447
  };
448
+ } | {
449
+ key: "views.grid.commit-refused";
450
+ values: {
451
+ field: string;
452
+ };
453
+ } | {
454
+ key: "views.grid.commit-refused-many";
455
+ values: {
456
+ count: number;
457
+ reason?: string;
458
+ };
419
459
  } | {
420
460
  key: "views.grid.changed-elsewhere";
421
461
  values: {
@@ -484,6 +524,161 @@ export type ViewsMessage = {
484
524
  };
485
525
  } | {
486
526
  key: "views.display.as-shown";
527
+ } | {
528
+ key: "views.panels.for-you";
529
+ } | {
530
+ key: "views.panels.group-order-most";
531
+ } | {
532
+ key: "views.panels.group-order-fewest";
533
+ } | {
534
+ key: "views.panels.group-order-newest";
535
+ } | {
536
+ key: "views.panels.group-order-oldest";
537
+ } | {
538
+ key: "views.panels.group-order-alphabetical";
539
+ } | {
540
+ key: "views.panels.group-order-reverse-alphabetical";
541
+ } | {
542
+ key: "views.panels.group-order-reversed";
543
+ values: {
544
+ label: string;
545
+ };
546
+ } | {
547
+ key: "views.panels.group-order-default";
548
+ } | {
549
+ key: "views.panels.group-order-count";
550
+ } | {
551
+ key: "views.panels.group-order-name";
552
+ } | {
553
+ key: "views.panels.group-order-manual";
554
+ } | {
555
+ key: "views.panels.quantifier";
556
+ values: {
557
+ quantifier: "any" | "none" | "every";
558
+ };
559
+ } | {
560
+ key: "views.panels.join-or";
561
+ } | {
562
+ key: "views.panels.join-and";
563
+ } | {
564
+ key: "views.panels.relation-condition-options";
565
+ values: {
566
+ field: string;
567
+ options: string;
568
+ };
569
+ } | {
570
+ key: "views.panels.relation-condition";
571
+ values: {
572
+ field: string;
573
+ value: string;
574
+ };
575
+ } | {
576
+ key: "views.panels.relation-sentence";
577
+ values: {
578
+ rule: "all" | "any" | "none" | "every" | "every-unmatched";
579
+ subject: string;
580
+ one: string;
581
+ many: string;
582
+ /** The held conditions, joined; empty when none holds. */
583
+ conditions: string;
584
+ };
585
+ } | {
586
+ key: "views.panels.filter-unavailable";
587
+ } | {
588
+ key: "views.panels.filter-all";
589
+ } | {
590
+ key: "views.panels.relation-value-one";
591
+ values: {
592
+ quantifier: string;
593
+ field: string;
594
+ value: string;
595
+ };
596
+ } | {
597
+ key: "views.panels.relation-value-many";
598
+ values: {
599
+ quantifier: string;
600
+ count: number;
601
+ };
602
+ } | {
603
+ key: "views.panels.filter-all-of";
604
+ values: {
605
+ field: string;
606
+ };
607
+ } | {
608
+ key: "views.panels.filter-selected";
609
+ values: {
610
+ count: number;
611
+ };
612
+ } | {
613
+ key: "views.panels.date-range-all";
614
+ } | {
615
+ key: "views.panels.date-range-between";
616
+ values: {
617
+ from: string;
618
+ to: string;
619
+ };
620
+ } | {
621
+ key: "views.panels.date-range-from";
622
+ values: {
623
+ from: string;
624
+ };
625
+ } | {
626
+ key: "views.panels.date-range-until";
627
+ values: {
628
+ to: string;
629
+ };
630
+ } | {
631
+ key: "views.panels.time-scope-custom";
632
+ } | {
633
+ key: "views.panels.sort-value";
634
+ values: {
635
+ label: string;
636
+ dir: "asc" | "desc";
637
+ };
638
+ } | {
639
+ key: "views.panels.group-none";
640
+ } | {
641
+ key: "views.panels.filter-count";
642
+ values: {
643
+ count: number;
644
+ };
645
+ } | {
646
+ key: "views.panels.direction";
647
+ values: {
648
+ dir: "asc" | "desc";
649
+ };
650
+ } | {
651
+ key: "views.panels.toggle-reset";
652
+ values: {
653
+ label: string;
654
+ };
655
+ } | {
656
+ key: "views.panels.toggle-reset-hint";
657
+ } | {
658
+ key: "views.panels.search-clear";
659
+ } | {
660
+ key: "views.selection.count";
661
+ values: {
662
+ count: number;
663
+ };
664
+ } | {
665
+ key: "views.selection.selected";
666
+ } | {
667
+ key: "views.selection.deselect-all";
668
+ } | {
669
+ key: "views.selection.clear";
670
+ } | {
671
+ key: "views.selection.delete";
672
+ } | {
673
+ key: "views.selection.more";
674
+ } | {
675
+ key: "views.selection.more-label";
676
+ } | {
677
+ key: "views.selection.actions";
678
+ } | {
679
+ key: "views.selection.sheet-label";
680
+ } | {
681
+ key: "views.selection.escape";
487
682
  };
488
683
  export type ViewsMessageKey = ViewsMessage["key"];
489
684
  /** A place's word, as a message key: the region, city or postal-code word a country's format names
@@ -493,7 +688,7 @@ export type PlaceWordKey = Extract<ViewsMessageKey, `views.editors.place-${"regi
493
688
  export declare function placeWordKey(kind: "region", word: RegionWord): PlaceWordKey;
494
689
  export declare function placeWordKey(kind: "city", word: CityWord): PlaceWordKey;
495
690
  export declare function placeWordKey(kind: "postal", word: PostalWord): PlaceWordKey;
496
- export declare const VIEWS_MESSAGE_KEYS: readonly ["views.editors.tag-remove", "views.editors.marker-resolve", "views.editors.marker-no-reason", "views.editors.range-low", "views.editors.range-high", "views.editors.name-given", "views.editors.name-family", "views.editors.name-full", "views.editors.values-add", "views.editors.values-label", "views.editors.values-main", "views.editors.values-make-main", "views.editors.values-remove", "views.editors.discard", "views.editors.save", "views.editors.open-email", "views.editors.open-phone", "views.editors.open-link", "views.editors.place-country", "views.editors.place-country-search", "views.editors.place-change-country", "views.editors.place-region-search", "views.editors.place-line1", "views.editors.place-line2", "views.editors.place-region-area", "views.editors.place-region-county", "views.editors.place-region-department", "views.editors.place-region-district", "views.editors.place-region-do-si", "views.editors.place-region-emirate", "views.editors.place-region-island", "views.editors.place-region-oblast", "views.editors.place-region-parish", "views.editors.place-region-prefecture", "views.editors.place-region-province", "views.editors.place-region-state", "views.editors.place-city-city", "views.editors.place-city-district", "views.editors.place-city-post-town", "views.editors.place-city-suburb", "views.editors.place-postal-eircode", "views.editors.place-postal-pin", "views.editors.place-postal-postal", "views.editors.place-postal-zip", "views.editors.place-required", "views.editors.place-region", "views.menus.part-row", "views.menus.sort-asc", "views.menus.sort-desc", "views.menus.sort-clear", "views.menus.group-by", "views.menus.ungroup", "views.menus.move-left", "views.menus.move-right", "views.menus.hide-column", "views.menus.format", "views.menus.date-style", "views.menus.show-time", "views.menus.duration-style", "views.menus.decimals", "views.menus.automatic", "views.menus.currency", "views.menus.percent-display", "views.menus.percent-display-option", "views.menus.colour", "views.menus.colours-reset", "views.menus.group-options", "views.menus.group-sort", "views.menus.search", "views.menus.group-show", "views.menus.group-count", "views.menus.group-hide", "views.menus.add-column-search", "views.menus.add-column-no-match", "views.menus.add-column-all-shown", "views.menus.copy", "views.menus.cut", "views.menus.paste", "views.menus.clear", "views.menus.edit", "views.menus.row-open", "views.menus.row-select", "views.menus.row-delete", "views.menus.row-delete-confirm", "views.menus.row-delete-failed", "views.grid.figure", "views.grid.figure-pick", "views.grid.add-column", "views.grid.loading", "views.grid.select-row", "views.grid.select-group", "views.grid.select-all", "views.grid.row-menu", "views.grid.group-expand", "views.grid.group-collapse", "views.grid.change-value", "views.grid.value", "views.grid.edit-value", "views.grid.read-only", "views.grid.read-only-why", "views.grid.locked", "views.grid.not-clearable", "views.grid.computed", "views.grid.cell-read-only", "views.grid.clear-none", "views.grid.clear-required", "views.grid.write-not-list", "views.grid.write-not-boolean", "views.grid.write-marker", "views.grid.write-not-email", "views.grid.write-not-url", "views.grid.write-not-link", "views.grid.write-not-linkable", "views.grid.paste-refused", "views.grid.paste-empty", "views.grid.paste-not-number", "views.grid.paste-not-duration", "views.grid.paste-not-date", "views.grid.paste-not-option", "views.grid.paste-ambiguous-option", "views.grid.paste-other-currency", "views.grid.paste-pick", "views.grid.paste-not-linkable", "views.grid.paste-not-range", "views.grid.paste-skipped", "views.grid.fill-skipped", "views.grid.changed-elsewhere", "views.grid.changed-elsewhere-cells", "views.grid.saved-value", "views.grid.saved-values", "views.grid.row-left", "views.display.just-now", "views.display.in", "views.display.today", "views.display.yesterday", "views.display.tomorrow", "views.display.month", "views.display.not-an-option", "views.display.needs-attention", "views.display.boolean", "views.display.show-all", "views.display.show-more", "views.display.show-less", "views.display.phone-extension", "views.display.phone-as-typed", "views.display.converted-from", "views.display.as-shown"];
691
+ export declare const VIEWS_MESSAGE_KEYS: readonly ["views.editors.tag-remove", "views.editors.marker-resolve", "views.editors.marker-no-reason", "views.editors.range-low", "views.editors.range-high", "views.editors.name-given", "views.editors.name-family", "views.editors.name-full", "views.editors.values-add", "views.editors.values-label", "views.editors.values-main", "views.editors.values-make-main", "views.editors.values-remove", "views.editors.discard", "views.editors.save", "views.editors.open-email", "views.editors.open-phone", "views.editors.open-link", "views.editors.place-country", "views.editors.place-country-search", "views.editors.place-change-country", "views.editors.place-region-search", "views.editors.place-line1", "views.editors.place-line2", "views.editors.place-region-area", "views.editors.place-region-county", "views.editors.place-region-department", "views.editors.place-region-district", "views.editors.place-region-do-si", "views.editors.place-region-emirate", "views.editors.place-region-island", "views.editors.place-region-oblast", "views.editors.place-region-parish", "views.editors.place-region-prefecture", "views.editors.place-region-province", "views.editors.place-region-state", "views.editors.place-city-city", "views.editors.place-city-district", "views.editors.place-city-post-town", "views.editors.place-city-suburb", "views.editors.place-postal-eircode", "views.editors.place-postal-pin", "views.editors.place-postal-postal", "views.editors.place-postal-zip", "views.editors.place-required", "views.editors.place-region", "views.menus.part-row", "views.menus.sort-asc", "views.menus.sort-desc", "views.menus.sort-clear", "views.menus.group-by", "views.menus.ungroup", "views.menus.move-left", "views.menus.move-right", "views.menus.hide-column", "views.menus.format", "views.menus.date-style", "views.menus.show-time", "views.menus.duration-style", "views.menus.decimals", "views.menus.automatic", "views.menus.currency", "views.menus.percent-display", "views.menus.percent-display-option", "views.menus.colour", "views.menus.colours-reset", "views.menus.group-options", "views.menus.group-sort", "views.menus.search", "views.menus.group-show", "views.menus.group-count", "views.menus.group-hide", "views.menus.add-column-search", "views.menus.add-column-no-match", "views.menus.add-column-all-shown", "views.menus.copy", "views.menus.cut", "views.menus.paste", "views.menus.clear", "views.menus.edit", "views.menus.row-open", "views.menus.row-select", "views.menus.row-delete", "views.menus.row-delete-confirm", "views.menus.row-delete-failed", "views.menus.row-menu", "views.menus.commands", "views.menus.commands-unnamed", "views.menus.figure-menu", "views.menus.column-menu", "views.grid.figure", "views.grid.figure-pick", "views.grid.add-column", "views.grid.loading", "views.grid.select-row", "views.grid.select-group", "views.grid.select-all", "views.grid.row-menu", "views.grid.group-expand", "views.grid.group-collapse", "views.grid.change-value", "views.grid.value", "views.grid.edit-value", "views.grid.read-only", "views.grid.read-only-why", "views.grid.locked", "views.grid.not-clearable", "views.grid.computed", "views.grid.cell-read-only", "views.grid.clear-none", "views.grid.clear-required", "views.grid.write-not-list", "views.grid.write-not-boolean", "views.grid.write-marker", "views.grid.write-not-email", "views.grid.write-not-url", "views.grid.write-not-link", "views.grid.write-not-linkable", "views.grid.paste-refused", "views.grid.paste-empty", "views.grid.paste-not-number", "views.grid.paste-not-duration", "views.grid.paste-not-date", "views.grid.paste-not-option", "views.grid.paste-ambiguous-option", "views.grid.paste-other-currency", "views.grid.paste-pick", "views.grid.paste-not-linkable", "views.grid.paste-not-range", "views.grid.paste-skipped", "views.grid.fill-skipped", "views.grid.commit-refused", "views.grid.commit-refused-many", "views.grid.changed-elsewhere", "views.grid.changed-elsewhere-cells", "views.grid.saved-value", "views.grid.saved-values", "views.grid.row-left", "views.display.just-now", "views.display.in", "views.display.today", "views.display.yesterday", "views.display.tomorrow", "views.display.month", "views.display.not-an-option", "views.display.needs-attention", "views.display.boolean", "views.display.show-all", "views.display.show-more", "views.display.show-less", "views.display.phone-extension", "views.display.phone-as-typed", "views.display.converted-from", "views.display.as-shown", "views.panels.for-you", "views.panels.group-order-most", "views.panels.group-order-fewest", "views.panels.group-order-newest", "views.panels.group-order-oldest", "views.panels.group-order-alphabetical", "views.panels.group-order-reverse-alphabetical", "views.panels.group-order-reversed", "views.panels.group-order-default", "views.panels.group-order-count", "views.panels.group-order-name", "views.panels.group-order-manual", "views.panels.quantifier", "views.panels.join-or", "views.panels.join-and", "views.panels.relation-condition-options", "views.panels.relation-condition", "views.panels.relation-sentence", "views.panels.filter-unavailable", "views.panels.filter-all", "views.panels.relation-value-one", "views.panels.relation-value-many", "views.panels.filter-all-of", "views.panels.filter-selected", "views.panels.date-range-all", "views.panels.date-range-between", "views.panels.date-range-from", "views.panels.date-range-until", "views.panels.time-scope-custom", "views.panels.sort-value", "views.panels.group-none", "views.panels.filter-count", "views.panels.direction", "views.panels.toggle-reset", "views.panels.toggle-reset-hint", "views.panels.search-clear", "views.selection.count", "views.selection.selected", "views.selection.deselect-all", "views.selection.clear", "views.selection.delete", "views.selection.more", "views.selection.more-label", "views.selection.actions", "views.selection.sheet-label", "views.selection.escape"];
497
692
  /** What an app hands in: its wording for every message. A resolver that words
498
693
  * only some keys calls `resolveViewsMessage` for the rest; the provider does not. */
499
694
  export type ViewsMessageResolver = (message: ViewsMessage) => string;
package/dist/contract.js CHANGED
@@ -1,6 +1,7 @@
1
1
  export const VK_PREFIX = "vk";
2
2
  export const GRID_SLOTS = [
3
3
  "vk-grid",
4
+ "vk-grid-pan",
4
5
  "vk-grid-scroll",
5
6
  "vk-grid-head",
6
7
  "vk-grid-header",
@@ -61,6 +62,8 @@ export const VK_TOKENS = [
61
62
  "--vk-text-10",
62
63
  "--vk-head-text",
63
64
  "--vk-scrolled",
65
+ "--vk-pin",
66
+ "--vk-stick",
64
67
  "--vk-parked",
65
68
  "--vk-frozen-on",
66
69
  "--vk-row-py",
@@ -100,9 +103,10 @@ export const VK_OPTIONAL_COLOURS = [
100
103
  "--vk-label-purple",
101
104
  "--vk-label-pink",
102
105
  "--vk-label-teal",
106
+ "--vk-float-shadow",
103
107
  ];
104
108
  export const VK_OPTIONAL_LAYOUT = ["--vk-gutter", "--vk-scroll-inset-bottom"];
105
- export const VK_INTERNAL = ["--vk-drag-shift", "--vk-cols"];
109
+ export const VK_INTERNAL = ["--vk-drag-shift", "--vk-cols", "--vk-hold-x", "--vk-sx"];
106
110
  export const VK_INTERNAL_FAMILIES = ["--vk-col-w-"];
107
111
  export const COMPONENT_NAMES = [
108
112
  "Button",
@@ -110,15 +114,13 @@ export const COMPONENT_NAMES = [
110
114
  "Tooltip",
111
115
  "Checkbox",
112
116
  "Menu",
113
- "Command",
114
- "Calendar",
115
117
  "Collapse",
116
118
  "Sheet",
117
119
  "AppIcon",
118
120
  "Markdown",
119
121
  ];
120
- export const OPTIONAL_COMPONENT_NAMES = ["Input"];
121
- export const ATOM_NAMES = ["Row", "RowContent", "TickBox", "StatusBadge", "StatusMarker", "Tag", "List", "CommandMenu", "RelationLink", "Loading", "LoadMore", "PlatformMark", "RowMenu"];
122
+ export const OPTIONAL_COMPONENT_NAMES = ["Input", "Command", "Picker", "Calendar", "DateBody"];
123
+ export const ATOM_NAMES = ["Row", "RowContent", "TickBox", "StatusBadge", "StatusMarker", "Tag", "List", "CommandMenu", "RelationLink", "RelationRoles", "Loading", "LoadMore", "PlatformMark", "RowMenu", "SelectionSheet", "ChoiceRow", "CheckRow", "RadioRow", "DirectionButton", "MenuRow", "ToggleRow", "PanelSearch"];
122
124
  export const ATOM_SLOTS = [
123
125
  "vk-row",
124
126
  "vk-row-content",
@@ -129,11 +131,21 @@ export const ATOM_SLOTS = [
129
131
  "vk-list",
130
132
  "vk-command-menu",
131
133
  "vk-relation-link",
134
+ "vk-relation-roles",
132
135
  "vk-loading",
133
136
  "vk-load-more",
134
137
  "vk-platform",
135
138
  "vk-row-menu",
139
+ "vk-choice-row",
140
+ "vk-check-row",
141
+ "vk-radio-row",
142
+ "vk-direction",
143
+ "vk-menu-row",
144
+ "vk-toggle-row",
145
+ "vk-panel-search",
146
+ "vk-selection-sheet",
136
147
  ];
148
+ export const SELECTION_SLOTS = ["vk-selection-bar", "vk-selection-pill", "vk-selection-chip"];
137
149
  export const EDITOR_SLOTS = ["vk-editor-panel", "vk-editor-bar", "vk-editor-refusal", "vk-text-editor"];
138
150
  export const ATOM_STATES = ["chosen", "disabled", "muted", "checked", "open", "status", "platform"];
139
151
  export const PORT_NAMES = ["toast", "haptics", "clipboard", "viewPrefs", "confirm"];
@@ -204,8 +216,17 @@ export const ICON_NAMES = [
204
216
  "clearSort",
205
217
  "sortRowsUp",
206
218
  "sortRowsDown",
219
+ "search",
220
+ "reset",
221
+ ];
222
+ export const MESSAGE_NAMESPACES = [
223
+ "views.grid",
224
+ "views.editors",
225
+ "views.menus",
226
+ "views.display",
227
+ "views.selection",
228
+ "views.panels",
207
229
  ];
208
- export const MESSAGE_NAMESPACES = ["views.grid", "views.editors", "views.menus", "views.display"];
209
230
  export function placeWordKey(kind, word) {
210
231
  return `views.editors.place-${kind}-${word.replace("_", "-")}`;
211
232
  }
@@ -295,6 +316,11 @@ export const VIEWS_MESSAGE_KEYS = [
295
316
  "views.menus.row-delete",
296
317
  "views.menus.row-delete-confirm",
297
318
  "views.menus.row-delete-failed",
319
+ "views.menus.row-menu",
320
+ "views.menus.commands",
321
+ "views.menus.commands-unnamed",
322
+ "views.menus.figure-menu",
323
+ "views.menus.column-menu",
298
324
  "views.grid.figure",
299
325
  "views.grid.figure-pick",
300
326
  "views.grid.add-column",
@@ -336,6 +362,8 @@ export const VIEWS_MESSAGE_KEYS = [
336
362
  "views.grid.paste-not-range",
337
363
  "views.grid.paste-skipped",
338
364
  "views.grid.fill-skipped",
365
+ "views.grid.commit-refused",
366
+ "views.grid.commit-refused-many",
339
367
  "views.grid.changed-elsewhere",
340
368
  "views.grid.changed-elsewhere-cells",
341
369
  "views.grid.saved-value",
@@ -357,6 +385,52 @@ export const VIEWS_MESSAGE_KEYS = [
357
385
  "views.display.phone-as-typed",
358
386
  "views.display.converted-from",
359
387
  "views.display.as-shown",
388
+ "views.panels.for-you",
389
+ "views.panels.group-order-most",
390
+ "views.panels.group-order-fewest",
391
+ "views.panels.group-order-newest",
392
+ "views.panels.group-order-oldest",
393
+ "views.panels.group-order-alphabetical",
394
+ "views.panels.group-order-reverse-alphabetical",
395
+ "views.panels.group-order-reversed",
396
+ "views.panels.group-order-default",
397
+ "views.panels.group-order-count",
398
+ "views.panels.group-order-name",
399
+ "views.panels.group-order-manual",
400
+ "views.panels.quantifier",
401
+ "views.panels.join-or",
402
+ "views.panels.join-and",
403
+ "views.panels.relation-condition-options",
404
+ "views.panels.relation-condition",
405
+ "views.panels.relation-sentence",
406
+ "views.panels.filter-unavailable",
407
+ "views.panels.filter-all",
408
+ "views.panels.relation-value-one",
409
+ "views.panels.relation-value-many",
410
+ "views.panels.filter-all-of",
411
+ "views.panels.filter-selected",
412
+ "views.panels.date-range-all",
413
+ "views.panels.date-range-between",
414
+ "views.panels.date-range-from",
415
+ "views.panels.date-range-until",
416
+ "views.panels.time-scope-custom",
417
+ "views.panels.sort-value",
418
+ "views.panels.group-none",
419
+ "views.panels.filter-count",
420
+ "views.panels.direction",
421
+ "views.panels.toggle-reset",
422
+ "views.panels.toggle-reset-hint",
423
+ "views.panels.search-clear",
424
+ "views.selection.count",
425
+ "views.selection.selected",
426
+ "views.selection.deselect-all",
427
+ "views.selection.clear",
428
+ "views.selection.delete",
429
+ "views.selection.more",
430
+ "views.selection.more-label",
431
+ "views.selection.actions",
432
+ "views.selection.sheet-label",
433
+ "views.selection.escape",
360
434
  ];
361
435
  const _everyKeyListed = true;
362
436
  void _everyKeyListed;
@@ -409,6 +483,24 @@ const DURATION_STYLE_WORDS = {
409
483
  };
410
484
  const PERCENT_DISPLAY_WORDS = { text: "Number", bar: "Bar", ring: "Ring" };
411
485
  const cellsWerent = (count) => (count === 1 ? "1 cell wasn't" : `${count} cells weren't`);
486
+ const QUANTIFIER_WORDS = { any: "Any", none: "None", every: "Every" };
487
+ function relationSentenceWords(values) {
488
+ const { rule, subject, one, many, conditions } = values;
489
+ if (rule === "all")
490
+ return `All ${subject}, whatever their ${many}.`;
491
+ const Subject = subject.charAt(0).toUpperCase() + subject.slice(1);
492
+ const where = conditions ? ` where ${conditions}` : "";
493
+ switch (rule) {
494
+ case "any":
495
+ return `${Subject} with at least one ${one}${where}.`;
496
+ case "none":
497
+ return `${Subject} with no ${one}${where}.`;
498
+ case "every":
499
+ return `${Subject} with only ${many}${where}.`;
500
+ case "every-unmatched":
501
+ return `${Subject} whose every ${one} matches.`;
502
+ }
503
+ }
412
504
  export function resolveViewsMessage(message) {
413
505
  switch (message.key) {
414
506
  case "views.editors.tag-remove":
@@ -581,6 +673,16 @@ export function resolveViewsMessage(message) {
581
673
  return "Delete this row?";
582
674
  case "views.menus.row-delete-failed":
583
675
  return "Failed to delete the row";
676
+ case "views.menus.row-menu":
677
+ return "Row actions";
678
+ case "views.menus.commands":
679
+ return `Actions for ${message.values.field}`;
680
+ case "views.menus.commands-unnamed":
681
+ return "Actions";
682
+ case "views.menus.figure-menu":
683
+ return `Calculate ${message.values.field}`;
684
+ case "views.menus.column-menu":
685
+ return `Options for ${message.values.field}`;
584
686
  case "views.grid.figure":
585
687
  return FIGURE_WORDS[message.values.kind];
586
688
  case "views.grid.figure-pick":
@@ -663,6 +765,12 @@ export function resolveViewsMessage(message) {
663
765
  return `${cellsWerent(message.values.count)} pasted: ${message.values.reason}`;
664
766
  case "views.grid.fill-skipped":
665
767
  return `${cellsWerent(message.values.count)} filled: ${message.values.reason}`;
768
+ case "views.grid.commit-refused":
769
+ return `Couldn't save ${message.values.field}.`;
770
+ case "views.grid.commit-refused-many":
771
+ return message.values.reason
772
+ ? `Couldn't save ${message.values.count} edits: ${message.values.reason}`
773
+ : `Couldn't save ${message.values.count} edits.`;
666
774
  case "views.grid.changed-elsewhere":
667
775
  return `${message.values.field} was changed elsewhere`;
668
776
  case "views.grid.changed-elsewhere-cells":
@@ -706,5 +814,99 @@ export function resolveViewsMessage(message) {
706
814
  return `Converted from ${message.values.code}`;
707
815
  case "views.display.as-shown":
708
816
  return "as shown";
817
+ case "views.panels.for-you":
818
+ return "For you";
819
+ case "views.panels.group-order-most":
820
+ return "Most first";
821
+ case "views.panels.group-order-fewest":
822
+ return "Fewest first";
823
+ case "views.panels.group-order-newest":
824
+ return "Newest first";
825
+ case "views.panels.group-order-oldest":
826
+ return "Oldest first";
827
+ case "views.panels.group-order-alphabetical":
828
+ return "Alphabetical";
829
+ case "views.panels.group-order-reverse-alphabetical":
830
+ return "Reverse alphabetical";
831
+ case "views.panels.group-order-reversed":
832
+ return `${message.values.label}, reversed`;
833
+ case "views.panels.group-order-default":
834
+ return "Default";
835
+ case "views.panels.group-order-count":
836
+ return "Count";
837
+ case "views.panels.group-order-name":
838
+ return "Name";
839
+ case "views.panels.group-order-manual":
840
+ return "Manual";
841
+ case "views.panels.quantifier":
842
+ return QUANTIFIER_WORDS[message.values.quantifier];
843
+ case "views.panels.join-or":
844
+ return " or ";
845
+ case "views.panels.join-and":
846
+ return " and ";
847
+ case "views.panels.relation-condition-options":
848
+ return `${message.values.field.toLowerCase()} is ${message.values.options}`;
849
+ case "views.panels.relation-condition":
850
+ return `${message.values.field.toLowerCase()} ${message.values.value}`;
851
+ case "views.panels.relation-sentence":
852
+ return relationSentenceWords(message.values);
853
+ case "views.panels.filter-unavailable":
854
+ return "Saved filter unavailable";
855
+ case "views.panels.filter-all":
856
+ return "All";
857
+ case "views.panels.relation-value-one":
858
+ return `${message.values.quantifier} · ${message.values.field}: ${message.values.value}`;
859
+ case "views.panels.relation-value-many":
860
+ return `${message.values.quantifier} · ${message.values.count} rules`;
861
+ case "views.panels.filter-all-of":
862
+ return `All ${message.values.field.toLowerCase()}`;
863
+ case "views.panels.filter-selected":
864
+ return `${message.values.count} selected`;
865
+ case "views.panels.date-range-all":
866
+ return "All time";
867
+ case "views.panels.date-range-between":
868
+ return `${message.values.from} — ${message.values.to}`;
869
+ case "views.panels.date-range-from":
870
+ return `From ${message.values.from}`;
871
+ case "views.panels.date-range-until":
872
+ return `Until ${message.values.to}`;
873
+ case "views.panels.time-scope-custom":
874
+ return "Custom";
875
+ case "views.panels.sort-value":
876
+ return `${message.values.label} ${message.values.dir}`;
877
+ case "views.panels.group-none":
878
+ return "None";
879
+ case "views.panels.filter-count":
880
+ if (message.values.count === 0)
881
+ return "None";
882
+ return message.values.count === 1 ? "1 filter" : `${message.values.count} filters`;
883
+ case "views.panels.direction":
884
+ return `Direction: ${message.values.dir === "asc" ? "ascending" : "descending"}`;
885
+ case "views.panels.toggle-reset":
886
+ return `Reset ${message.values.label}`;
887
+ case "views.panels.toggle-reset-hint":
888
+ return "Back to your default";
889
+ case "views.panels.search-clear":
890
+ return "Clear";
891
+ case "views.selection.count":
892
+ return `${message.values.count} selected`;
893
+ case "views.selection.selected":
894
+ return "selected";
895
+ case "views.selection.deselect-all":
896
+ return "Deselect all";
897
+ case "views.selection.clear":
898
+ return "Clear selection";
899
+ case "views.selection.delete":
900
+ return "Delete selected";
901
+ case "views.selection.more":
902
+ return "More";
903
+ case "views.selection.more-label":
904
+ return "More actions";
905
+ case "views.selection.actions":
906
+ return "Actions";
907
+ case "views.selection.sheet-label":
908
+ return "Selection actions";
909
+ case "views.selection.escape":
910
+ return "Esc";
709
911
  }
710
912
  }