@viewkitjs/views 0.0.0-stage → 0.1.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 (270) hide show
  1. package/CHANGELOG.md +420 -0
  2. package/LICENSE.md +7 -0
  3. package/README.md +50 -2
  4. package/dist/atoms/CommandMenu.d.ts +2 -0
  5. package/dist/atoms/CommandMenu.js +20 -0
  6. package/dist/atoms/List.d.ts +2 -0
  7. package/dist/atoms/List.js +6 -0
  8. package/dist/atoms/LoadMore.d.ts +2 -0
  9. package/dist/atoms/LoadMore.js +25 -0
  10. package/dist/atoms/Loading.d.ts +2 -0
  11. package/dist/atoms/Loading.js +7 -0
  12. package/dist/atoms/PlatformMark.d.ts +2 -0
  13. package/dist/atoms/PlatformMark.js +4 -0
  14. package/dist/atoms/RelationLink.d.ts +2 -0
  15. package/dist/atoms/RelationLink.js +6 -0
  16. package/dist/atoms/Row.d.ts +3 -0
  17. package/dist/atoms/Row.js +30 -0
  18. package/dist/atoms/RowMenu.d.ts +2 -0
  19. package/dist/atoms/RowMenu.js +101 -0
  20. package/dist/atoms/StatusBadge.d.ts +2 -0
  21. package/dist/atoms/StatusBadge.js +7 -0
  22. package/dist/atoms/StatusMarker.d.ts +2 -0
  23. package/dist/atoms/StatusMarker.js +19 -0
  24. package/dist/atoms/Tag.d.ts +2 -0
  25. package/dist/atoms/Tag.js +13 -0
  26. package/dist/atoms/TickBox.d.ts +2 -0
  27. package/dist/atoms/TickBox.js +8 -0
  28. package/dist/atoms/defaults.d.ts +2 -0
  29. package/dist/atoms/defaults.js +27 -0
  30. package/dist/atoms/tones.d.ts +5 -0
  31. package/dist/atoms/tones.js +28 -0
  32. package/dist/atoms/types.d.ts +178 -0
  33. package/dist/atoms/types.js +3 -0
  34. package/dist/cells/cell-format.d.ts +138 -0
  35. package/dist/cells/cell-format.js +16 -0
  36. package/dist/cells/cell-title.d.ts +17 -0
  37. package/dist/cells/cell-title.js +8 -0
  38. package/dist/cells/cell-values.d.ts +28 -0
  39. package/dist/cells/cell-values.js +87 -0
  40. package/dist/cells/index.d.ts +4 -0
  41. package/dist/cells/index.js +4 -0
  42. package/dist/cells/legacy-field.d.ts +52 -0
  43. package/dist/cells/legacy-field.js +164 -0
  44. package/dist/cells/relation-wrap.d.ts +3 -0
  45. package/dist/cells/relation-wrap.js +24 -0
  46. package/dist/cells/use-cell-format.d.ts +5 -0
  47. package/dist/cells/use-cell-format.js +10 -0
  48. package/dist/contract.d.ts +431 -0
  49. package/dist/contract.js +663 -0
  50. package/dist/display/actor.d.ts +4 -0
  51. package/dist/display/actor.js +26 -0
  52. package/dist/display/boolean.d.ts +18 -0
  53. package/dist/display/boolean.js +43 -0
  54. package/dist/display/breakdown.d.ts +15 -0
  55. package/dist/display/breakdown.js +32 -0
  56. package/dist/display/currency.d.ts +9 -0
  57. package/dist/display/currency.js +29 -0
  58. package/dist/display/date.d.ts +12 -0
  59. package/dist/display/date.js +26 -0
  60. package/dist/display/display-cores.d.ts +31 -0
  61. package/dist/display/display-cores.js +57 -0
  62. package/dist/display/entity-chip.d.ts +26 -0
  63. package/dist/display/entity-chip.js +9 -0
  64. package/dist/display/format.d.ts +51 -0
  65. package/dist/display/format.js +181 -0
  66. package/dist/display/index.d.ts +8 -0
  67. package/dist/display/index.js +7 -0
  68. package/dist/display/link.d.ts +29 -0
  69. package/dist/display/link.js +48 -0
  70. package/dist/display/location.d.ts +7 -0
  71. package/dist/display/location.js +15 -0
  72. package/dist/display/multi-value.d.ts +18 -0
  73. package/dist/display/multi-value.js +28 -0
  74. package/dist/display/name.d.ts +6 -0
  75. package/dist/display/name.js +14 -0
  76. package/dist/display/number.d.ts +11 -0
  77. package/dist/display/number.js +27 -0
  78. package/dist/display/options.d.ts +153 -0
  79. package/dist/display/options.js +1 -0
  80. package/dist/display/percent.d.ts +4 -0
  81. package/dist/display/percent.js +33 -0
  82. package/dist/display/phone.d.ts +10 -0
  83. package/dist/display/phone.js +38 -0
  84. package/dist/display/range.d.ts +6 -0
  85. package/dist/display/range.js +29 -0
  86. package/dist/display/relation.d.ts +4 -0
  87. package/dist/display/relation.js +29 -0
  88. package/dist/display/rich-text.d.ts +10 -0
  89. package/dist/display/rich-text.js +34 -0
  90. package/dist/display/select.d.ts +6 -0
  91. package/dist/display/select.js +38 -0
  92. package/dist/display/text-class.d.ts +23 -0
  93. package/dist/display/text-class.js +5 -0
  94. package/dist/display/text.d.ts +19 -0
  95. package/dist/display/text.js +8 -0
  96. package/dist/display/use-display-options.d.ts +2 -0
  97. package/dist/display/use-display-options.js +14 -0
  98. package/dist/display/user.d.ts +11 -0
  99. package/dist/display/user.js +10 -0
  100. package/dist/display/value-list.d.ts +10 -0
  101. package/dist/display/value-list.js +12 -0
  102. package/dist/display/viewer.d.ts +4 -0
  103. package/dist/display/viewer.js +11 -0
  104. package/dist/display/web-href.d.ts +8 -0
  105. package/dist/display/web-href.js +12 -0
  106. package/dist/editors/ChipsEditor.d.ts +59 -0
  107. package/dist/editors/ChipsEditor.js +73 -0
  108. package/dist/editors/DateEditor.d.ts +25 -0
  109. package/dist/editors/DateEditor.js +122 -0
  110. package/dist/editors/LocationEditor.d.ts +22 -0
  111. package/dist/editors/LocationEditor.js +229 -0
  112. package/dist/editors/NameEditor.d.ts +22 -0
  113. package/dist/editors/NameEditor.js +91 -0
  114. package/dist/editors/NumberEditor.d.ts +67 -0
  115. package/dist/editors/NumberEditor.js +86 -0
  116. package/dist/editors/RangeEditor.d.ts +22 -0
  117. package/dist/editors/RangeEditor.js +70 -0
  118. package/dist/editors/RelationEditor.d.ts +65 -0
  119. package/dist/editors/RelationEditor.js +64 -0
  120. package/dist/editors/SelectEditor.d.ts +72 -0
  121. package/dist/editors/SelectEditor.js +59 -0
  122. package/dist/editors/ValueListEditor.d.ts +38 -0
  123. package/dist/editors/ValueListEditor.js +217 -0
  124. package/dist/editors/edit-cores.d.ts +83 -0
  125. package/dist/editors/edit-cores.js +38 -0
  126. package/dist/editors/edit-session.d.ts +74 -0
  127. package/dist/editors/edit-session.js +35 -0
  128. package/dist/editors/open-values.d.ts +28 -0
  129. package/dist/editors/open-values.js +26 -0
  130. package/dist/editors/relation-source.d.ts +66 -0
  131. package/dist/editors/relation-source.js +102 -0
  132. package/dist/fields/binding.d.ts +87 -0
  133. package/dist/fields/binding.js +117 -0
  134. package/dist/fields/currency.d.ts +92 -0
  135. package/dist/fields/currency.js +55 -0
  136. package/dist/fields/denomination.d.ts +42 -0
  137. package/dist/fields/denomination.js +11 -0
  138. package/dist/fields/edit-core-types.d.ts +40 -0
  139. package/dist/fields/edit-core-types.js +29 -0
  140. package/dist/fields/format-knobs.d.ts +34 -0
  141. package/dist/fields/format-knobs.js +36 -0
  142. package/dist/fields/menus.d.ts +28 -0
  143. package/dist/fields/menus.js +1 -0
  144. package/dist/fields/money.d.ts +59 -0
  145. package/dist/fields/money.js +77 -0
  146. package/dist/fields/number-edit.d.ts +11 -0
  147. package/dist/fields/number-edit.js +17 -0
  148. package/dist/fields/prepare-write.d.ts +55 -0
  149. package/dist/fields/prepare-write.js +67 -0
  150. package/dist/fields/relation-source-types.d.ts +54 -0
  151. package/dist/fields/relation-source-types.js +1 -0
  152. package/dist/figures.d.ts +52 -0
  153. package/dist/figures.js +63 -0
  154. package/dist/filters/date-filter.d.ts +2 -0
  155. package/dist/filters/date-filter.js +1 -0
  156. package/dist/filters/filter-model.d.ts +177 -0
  157. package/dist/filters/filter-model.js +41 -0
  158. package/dist/filters/number-filter.d.ts +2 -0
  159. package/dist/filters/number-filter.js +1 -0
  160. package/dist/filters/range-filter.d.ts +2 -0
  161. package/dist/filters/range-filter.js +1 -0
  162. package/dist/filters/registry.d.ts +136 -0
  163. package/dist/filters/registry.js +46 -0
  164. package/dist/filters/relation-filter.d.ts +16 -0
  165. package/dist/filters/relation-filter.js +53 -0
  166. package/dist/filters/text-filter.d.ts +2 -0
  167. package/dist/filters/text-filter.js +1 -0
  168. package/dist/filters/types.d.ts +27 -0
  169. package/dist/filters/types.js +1 -0
  170. package/dist/grouping/sort-groups.d.ts +18 -0
  171. package/dist/grouping/sort-groups.js +33 -0
  172. package/dist/grouping/types.d.ts +10 -0
  173. package/dist/grouping/types.js +1 -0
  174. package/dist/index.d.ts +29 -0
  175. package/dist/index.js +29 -0
  176. package/dist/internal/chip.d.ts +4 -0
  177. package/dist/internal/chip.js +3 -0
  178. package/dist/internal/cx.d.ts +3 -0
  179. package/dist/internal/cx.js +3 -0
  180. package/dist/model/aggregates.d.ts +59 -0
  181. package/dist/model/aggregates.js +186 -0
  182. package/dist/model/card-density.d.ts +8 -0
  183. package/dist/model/card-density.js +10 -0
  184. package/dist/model/card-layout.d.ts +85 -0
  185. package/dist/model/card-layout.js +90 -0
  186. package/dist/model/column-capabilities.d.ts +162 -0
  187. package/dist/model/column-capabilities.js +233 -0
  188. package/dist/model/column-filters.d.ts +106 -0
  189. package/dist/model/column-filters.js +321 -0
  190. package/dist/model/column-format.d.ts +103 -0
  191. package/dist/model/column-format.js +1 -0
  192. package/dist/model/column-from.d.ts +28 -0
  193. package/dist/model/column-from.js +160 -0
  194. package/dist/model/column-inspect.d.ts +18 -0
  195. package/dist/model/column-inspect.js +6 -0
  196. package/dist/model/column-knobs.d.ts +20 -0
  197. package/dist/model/column-knobs.js +16 -0
  198. package/dist/model/column-money.d.ts +13 -0
  199. package/dist/model/column-money.js +27 -0
  200. package/dist/model/column-order.d.ts +36 -0
  201. package/dist/model/column-order.js +68 -0
  202. package/dist/model/column-schema.d.ts +335 -0
  203. package/dist/model/column-schema.js +1 -0
  204. package/dist/model/column-sort.d.ts +17 -0
  205. package/dist/model/column-sort.js +11 -0
  206. package/dist/model/column-state.d.ts +77 -0
  207. package/dist/model/column-state.js +95 -0
  208. package/dist/model/column-types.d.ts +109 -0
  209. package/dist/model/column-types.js +50 -0
  210. package/dist/model/column-warnings.d.ts +44 -0
  211. package/dist/model/column-warnings.js +24 -0
  212. package/dist/model/density.d.ts +3 -0
  213. package/dist/model/density.js +13 -0
  214. package/dist/model/field-type-of.d.ts +21 -0
  215. package/dist/model/field-type-of.js +11 -0
  216. package/dist/model/filter-capabilities.d.ts +1 -0
  217. package/dist/model/filter-capabilities.js +1 -0
  218. package/dist/model/filter-pushdown.d.ts +106 -0
  219. package/dist/model/filter-pushdown.js +147 -0
  220. package/dist/model/index.d.ts +40 -0
  221. package/dist/model/index.js +21 -0
  222. package/dist/model/part-rows.d.ts +28 -0
  223. package/dist/model/part-rows.js +40 -0
  224. package/dist/model/preferences.d.ts +151 -0
  225. package/dist/model/preferences.js +84 -0
  226. package/dist/model/prefs-buckets.d.ts +173 -0
  227. package/dist/model/prefs-buckets.js +71 -0
  228. package/dist/model/relation-filters.d.ts +45 -0
  229. package/dist/model/relation-filters.js +78 -0
  230. package/dist/model/render-count.d.ts +2 -0
  231. package/dist/model/render-count.js +24 -0
  232. package/dist/model/row-icon.d.ts +23 -0
  233. package/dist/model/row-icon.js +5 -0
  234. package/dist/model/view-rules.d.ts +73 -0
  235. package/dist/model/view-rules.js +216 -0
  236. package/dist/provider/ViewsProvider.d.ts +26 -0
  237. package/dist/provider/ViewsProvider.js +12 -0
  238. package/dist/provider/components.d.ts +222 -0
  239. package/dist/provider/components.js +3 -0
  240. package/dist/provider/context.d.ts +19 -0
  241. package/dist/provider/context.js +10 -0
  242. package/dist/provider/icons.d.ts +6 -0
  243. package/dist/provider/icons.js +1 -0
  244. package/dist/provider/ports.d.ts +35 -0
  245. package/dist/provider/ports.js +8 -0
  246. package/dist/react.d.ts +9 -0
  247. package/dist/react.js +4 -0
  248. package/dist/selection/SelectCheckbox.d.ts +17 -0
  249. package/dist/selection/SelectCheckbox.js +11 -0
  250. package/dist/selection/index.d.ts +7 -0
  251. package/dist/selection/index.js +6 -0
  252. package/dist/selection/model.d.ts +55 -0
  253. package/dist/selection/model.js +86 -0
  254. package/dist/selection/row-click.d.ts +35 -0
  255. package/dist/selection/row-click.js +20 -0
  256. package/dist/selection/types.d.ts +17 -0
  257. package/dist/selection/types.js +1 -0
  258. package/dist/selection/useCheckDragSelect.d.ts +61 -0
  259. package/dist/selection/useCheckDragSelect.js +165 -0
  260. package/dist/selection/useListSelection.d.ts +39 -0
  261. package/dist/selection/useListSelection.js +48 -0
  262. package/dist/selection/useListSelectionShortcuts.d.ts +6 -0
  263. package/dist/selection/useListSelectionShortcuts.js +14 -0
  264. package/dist/selection/useRestIntent.d.ts +18 -0
  265. package/dist/selection/useRestIntent.js +35 -0
  266. package/docs/contract.md +453 -0
  267. package/docs/install.md +105 -0
  268. package/docs/reshaping.md +19 -0
  269. package/package.json +114 -3
  270. package/skills/views/SKILL.md +87 -0
package/package.json CHANGED
@@ -1,6 +1,117 @@
1
1
  {
2
2
  "name": "@viewkitjs/views",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.0",
4
+ "description": "ViewKit views — the grid, board, calendar and list over typed fields: a headless engine and a default rendering written to skin discipline. By Sheaf.",
5
+ "license": "UNLICENSED",
6
+ "type": "module",
7
+ "sideEffects": false,
8
+ "files": [
9
+ "dist",
10
+ "skills",
11
+ "docs",
12
+ "README.md",
13
+ "CHANGELOG.md",
14
+ "LICENSE.md"
15
+ ],
16
+ "engines": {
17
+ "node": ">=20"
18
+ },
19
+ "exports": {
20
+ ".": {
21
+ "types": "./dist/index.d.ts",
22
+ "default": "./dist/index.js"
23
+ },
24
+ "./react": {
25
+ "types": "./dist/react.d.ts",
26
+ "default": "./dist/react.js"
27
+ },
28
+ "./display": {
29
+ "types": "./dist/display/index.d.ts",
30
+ "default": "./dist/display/index.js"
31
+ },
32
+ "./editors": {
33
+ "types": "./dist/editors/edit-cores.d.ts",
34
+ "default": "./dist/editors/edit-cores.js"
35
+ },
36
+ "./editors/select": {
37
+ "types": "./dist/editors/SelectEditor.d.ts",
38
+ "default": "./dist/editors/SelectEditor.js"
39
+ },
40
+ "./editors/relation": {
41
+ "types": "./dist/editors/RelationEditor.d.ts",
42
+ "default": "./dist/editors/RelationEditor.js"
43
+ },
44
+ "./editors/number": {
45
+ "types": "./dist/editors/NumberEditor.d.ts",
46
+ "default": "./dist/editors/NumberEditor.js"
47
+ },
48
+ "./editors/range": {
49
+ "types": "./dist/editors/RangeEditor.d.ts",
50
+ "default": "./dist/editors/RangeEditor.js"
51
+ },
52
+ "./editors/name": {
53
+ "types": "./dist/editors/NameEditor.d.ts",
54
+ "default": "./dist/editors/NameEditor.js"
55
+ },
56
+ "./editors/location": {
57
+ "types": "./dist/editors/LocationEditor.d.ts",
58
+ "default": "./dist/editors/LocationEditor.js"
59
+ },
60
+ "./editors/value-list": {
61
+ "types": "./dist/editors/ValueListEditor.d.ts",
62
+ "default": "./dist/editors/ValueListEditor.js"
63
+ },
64
+ "./editors/date": {
65
+ "types": "./dist/editors/DateEditor.d.ts",
66
+ "default": "./dist/editors/DateEditor.js"
67
+ },
68
+ "./editors/chips": {
69
+ "types": "./dist/editors/ChipsEditor.d.ts",
70
+ "default": "./dist/editors/ChipsEditor.js"
71
+ },
72
+ "./editors/session": {
73
+ "types": "./dist/editors/edit-session.d.ts",
74
+ "default": "./dist/editors/edit-session.js"
75
+ },
76
+ "./editors/open-values": {
77
+ "types": "./dist/editors/open-values.d.ts",
78
+ "default": "./dist/editors/open-values.js"
79
+ },
80
+ "./cells": {
81
+ "types": "./dist/cells/index.d.ts",
82
+ "default": "./dist/cells/index.js"
83
+ },
84
+ "./selection": {
85
+ "types": "./dist/selection/index.d.ts",
86
+ "default": "./dist/selection/index.js"
87
+ },
88
+ "./package.json": "./package.json"
89
+ },
90
+ "publishConfig": {
91
+ "registry": "https://registry.npmjs.org/",
92
+ "access": "public"
93
+ },
94
+ "peerDependencies": {
95
+ "@viewkitjs/fields": "^0.8.0",
96
+ "react": "^19.0.0",
97
+ "react-dom": "^19.0.0",
98
+ "zod": "^4.1.12"
99
+ },
100
+ "devDependencies": {
101
+ "@testing-library/react": "^16.3.2",
102
+ "@types/node": "^20",
103
+ "@types/react": "^19",
104
+ "@types/react-dom": "^19",
105
+ "react": "19.2.0",
106
+ "react-dom": "19.2.0",
107
+ "typescript": "^5",
108
+ "vitest": "^4.1.5",
109
+ "zod": "^4.1.12",
110
+ "@viewkitjs/fields": "0.8.0"
111
+ },
112
+ "scripts": {
113
+ "typecheck": "tsc -p tsconfig.json",
114
+ "build": "node ../../../scripts/clean-package-dist.mjs viewkit/views && tsc -p tsconfig.build.json && tsc -p tsconfig.types.json && node ../../../scripts/finalize-package-declarations.mjs viewkit/views",
115
+ "check": "node ../../../scripts/check-views-package.mjs"
116
+ }
6
117
  }
@@ -0,0 +1,87 @@
1
+ ---
2
+ name: views
3
+ description: Mount and adapt @viewkitjs/views — the provider, the components map, the atoms, the ports, the icon names and the message keys the grid, board, calendar and list render through. Use when an application installs the views package, writes its adapter over its own UI primitives, swaps the default atoms for its own rows, badges and tags, or binds the package's messages to its translations. Do not use for field definitions (that is @viewkitjs/fields) or for persistence.
4
+ ---
5
+
6
+ # ViewKit views
7
+
8
+ Use the package through its declared doors only — `@viewkitjs/views` and `@viewkitjs/views/react` —
9
+ never a deep path.
10
+
11
+ ## Mount the provider once
12
+
13
+ Every view reads its primitives, its atoms, its icons, its ports, its wording and its field
14
+ conventions from one `ViewsProvider` above it. Mount it once, at the app's client root. The
15
+ rendering paints through its own colour names (`--vk-fg`, `--vk-ground`, …), which your stylesheet
16
+ declares once: `docs/install.md` step 3 holds the block for stock shadcn.
17
+
18
+ <!-- viewkit-example:provider -->
19
+
20
+ ```tsx
21
+ "use client";
22
+ import type { ReactNode } from "react";
23
+ import { defineConventions } from "@viewkitjs/fields";
24
+ import {
25
+ ViewsProvider,
26
+ type ViewsAtoms,
27
+ type ViewsComponents,
28
+ type ViewsIcons,
29
+ type ViewsPorts,
30
+ } from "@viewkitjs/views/react";
31
+
32
+ declare const components: ViewsComponents;
33
+ declare const icons: ViewsIcons;
34
+ declare const ports: ViewsPorts;
35
+ declare const MyTag: ViewsAtoms["Tag"];
36
+
37
+ const conventions = defineConventions({ locale: "en-GB", timeZone: "UTC" });
38
+
39
+ export function AppViews({ children }: { children: ReactNode }) {
40
+ return (
41
+ <ViewsProvider
42
+ components={components}
43
+ icons={icons}
44
+ ports={ports}
45
+ conventions={conventions}
46
+ atoms={{ Tag: MyTag }}
47
+ >
48
+ {children}
49
+ </ViewsProvider>
50
+ );
51
+ }
52
+ ```
53
+
54
+ ## Write the adapter against the contract
55
+
56
+ `docs/contract.md` lists the eleven components, the four ports and the icon names. Implement
57
+ `ViewsComponents` over your own shadcn copies: a controlled `open` with `onOpenChange(open, details)`,
58
+ an `anchor` element or ref on the popover and the menu, and no `asChild`; `AppIcon` is your own
59
+ icon component by your own names. The shapes are Base UI's; `docs/contract.md`'s "Writing an
60
+ adapter" says what a Base UI adapter does where its copies stop short. Implement `ViewsIcons` by meaning
61
+ (`sortAsc`, `relation`, `more`), never by a library's glyph name. Hand in `ViewsPorts` from your own
62
+ toast, haptics, clipboard and a per-device store.
63
+
64
+ ## Bind the messages and swap the atoms
65
+
66
+ The package words only its own strings — a closed list of `{ key, values }` messages under
67
+ `views.editors.*`, `views.display.*`, `views.menus.*` and `views.grid.*`; a string `@viewkitjs/fields` already keys
68
+ stays a fields message. `messages` defaults to `resolveViewsMessage`, the package's English. With
69
+ next-intl, scope the translator to the namespace (`useTranslations("views")`; a root translator over a
70
+ typed catalog can overflow TypeScript) and read each key without its `views.` prefix:
71
+ `(m) => { const key = m.key.slice("views.".length); return t.has(key) ? t(key, "values" in m ? m.values : undefined) : resolveViewsMessage(m); }`.
72
+
73
+ The atoms — `List`, `Row`, `RowContent`, `TickBox`, `StatusBadge`, `StatusMarker`, `Tag`, `CommandMenu`,
74
+ `RelationLink`, `Loading`, `LoadMore`, `PlatformMark`, `RowMenu` — ship as defaults drawn from your theme. Swap any of them through `atoms` so the views wear
75
+ your own menus and pills. `CommandMenu`, `RowMenu` and `RelationLink` are your app's own pieces — the verb menu a
76
+ command cell opens, the row's right-click menu, and where a relation chip goes; their defaults are the map's menu,
77
+ the map's menu at the pointer (its Delete asks the browser's own confirm), and a chip that goes nowhere. `Loading` and `LoadMore` are your waits — the list reloading, and how it asks for more rows; their
78
+ defaults are a plain ring and a sentinel past the last row. `PlatformMark` is a link's platform, drawn before
79
+ it: the package ships no brand art, so its default draws nothing and a link looks plain; you draw your own
80
+ marks by `platform.key`.
81
+ The field display is `@viewkitjs/views/display`; the editors are `@viewkitjs/views/editors/<name>`, each
82
+ drawn through the map and the atoms — your app hosts them (the popover, the anchor, the write) and never
83
+ writes one. A place's editor is `editors/location` (the country first, then its parts, a region from its list; its
84
+ 27 `views.editors.place-*` words are yours to translate). Several emails, phones, links or domains edit in
85
+ `editors/value-list` (a row each: the value, its label, a main mark), committed as one list; bind `labels: false`
86
+ where your row keeps only the values. A name's editor is `editors/name` (given, family and full); its display draws an empty name
87
+ as the words you give it, `nameFallback` in the display options or `nameFallback(row)` on a column.