@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.
- package/CHANGELOG.md +420 -0
- package/LICENSE.md +7 -0
- package/README.md +50 -2
- package/dist/atoms/CommandMenu.d.ts +2 -0
- package/dist/atoms/CommandMenu.js +20 -0
- package/dist/atoms/List.d.ts +2 -0
- package/dist/atoms/List.js +6 -0
- package/dist/atoms/LoadMore.d.ts +2 -0
- package/dist/atoms/LoadMore.js +25 -0
- package/dist/atoms/Loading.d.ts +2 -0
- package/dist/atoms/Loading.js +7 -0
- package/dist/atoms/PlatformMark.d.ts +2 -0
- package/dist/atoms/PlatformMark.js +4 -0
- package/dist/atoms/RelationLink.d.ts +2 -0
- package/dist/atoms/RelationLink.js +6 -0
- package/dist/atoms/Row.d.ts +3 -0
- package/dist/atoms/Row.js +30 -0
- package/dist/atoms/RowMenu.d.ts +2 -0
- package/dist/atoms/RowMenu.js +101 -0
- package/dist/atoms/StatusBadge.d.ts +2 -0
- package/dist/atoms/StatusBadge.js +7 -0
- package/dist/atoms/StatusMarker.d.ts +2 -0
- package/dist/atoms/StatusMarker.js +19 -0
- package/dist/atoms/Tag.d.ts +2 -0
- package/dist/atoms/Tag.js +13 -0
- package/dist/atoms/TickBox.d.ts +2 -0
- package/dist/atoms/TickBox.js +8 -0
- package/dist/atoms/defaults.d.ts +2 -0
- package/dist/atoms/defaults.js +27 -0
- package/dist/atoms/tones.d.ts +5 -0
- package/dist/atoms/tones.js +28 -0
- package/dist/atoms/types.d.ts +178 -0
- package/dist/atoms/types.js +3 -0
- package/dist/cells/cell-format.d.ts +138 -0
- package/dist/cells/cell-format.js +16 -0
- package/dist/cells/cell-title.d.ts +17 -0
- package/dist/cells/cell-title.js +8 -0
- package/dist/cells/cell-values.d.ts +28 -0
- package/dist/cells/cell-values.js +87 -0
- package/dist/cells/index.d.ts +4 -0
- package/dist/cells/index.js +4 -0
- package/dist/cells/legacy-field.d.ts +52 -0
- package/dist/cells/legacy-field.js +164 -0
- package/dist/cells/relation-wrap.d.ts +3 -0
- package/dist/cells/relation-wrap.js +24 -0
- package/dist/cells/use-cell-format.d.ts +5 -0
- package/dist/cells/use-cell-format.js +10 -0
- package/dist/contract.d.ts +431 -0
- package/dist/contract.js +663 -0
- package/dist/display/actor.d.ts +4 -0
- package/dist/display/actor.js +26 -0
- package/dist/display/boolean.d.ts +18 -0
- package/dist/display/boolean.js +43 -0
- package/dist/display/breakdown.d.ts +15 -0
- package/dist/display/breakdown.js +32 -0
- package/dist/display/currency.d.ts +9 -0
- package/dist/display/currency.js +29 -0
- package/dist/display/date.d.ts +12 -0
- package/dist/display/date.js +26 -0
- package/dist/display/display-cores.d.ts +31 -0
- package/dist/display/display-cores.js +57 -0
- package/dist/display/entity-chip.d.ts +26 -0
- package/dist/display/entity-chip.js +9 -0
- package/dist/display/format.d.ts +51 -0
- package/dist/display/format.js +181 -0
- package/dist/display/index.d.ts +8 -0
- package/dist/display/index.js +7 -0
- package/dist/display/link.d.ts +29 -0
- package/dist/display/link.js +48 -0
- package/dist/display/location.d.ts +7 -0
- package/dist/display/location.js +15 -0
- package/dist/display/multi-value.d.ts +18 -0
- package/dist/display/multi-value.js +28 -0
- package/dist/display/name.d.ts +6 -0
- package/dist/display/name.js +14 -0
- package/dist/display/number.d.ts +11 -0
- package/dist/display/number.js +27 -0
- package/dist/display/options.d.ts +153 -0
- package/dist/display/options.js +1 -0
- package/dist/display/percent.d.ts +4 -0
- package/dist/display/percent.js +33 -0
- package/dist/display/phone.d.ts +10 -0
- package/dist/display/phone.js +38 -0
- package/dist/display/range.d.ts +6 -0
- package/dist/display/range.js +29 -0
- package/dist/display/relation.d.ts +4 -0
- package/dist/display/relation.js +29 -0
- package/dist/display/rich-text.d.ts +10 -0
- package/dist/display/rich-text.js +34 -0
- package/dist/display/select.d.ts +6 -0
- package/dist/display/select.js +38 -0
- package/dist/display/text-class.d.ts +23 -0
- package/dist/display/text-class.js +5 -0
- package/dist/display/text.d.ts +19 -0
- package/dist/display/text.js +8 -0
- package/dist/display/use-display-options.d.ts +2 -0
- package/dist/display/use-display-options.js +14 -0
- package/dist/display/user.d.ts +11 -0
- package/dist/display/user.js +10 -0
- package/dist/display/value-list.d.ts +10 -0
- package/dist/display/value-list.js +12 -0
- package/dist/display/viewer.d.ts +4 -0
- package/dist/display/viewer.js +11 -0
- package/dist/display/web-href.d.ts +8 -0
- package/dist/display/web-href.js +12 -0
- package/dist/editors/ChipsEditor.d.ts +59 -0
- package/dist/editors/ChipsEditor.js +73 -0
- package/dist/editors/DateEditor.d.ts +25 -0
- package/dist/editors/DateEditor.js +122 -0
- package/dist/editors/LocationEditor.d.ts +22 -0
- package/dist/editors/LocationEditor.js +229 -0
- package/dist/editors/NameEditor.d.ts +22 -0
- package/dist/editors/NameEditor.js +91 -0
- package/dist/editors/NumberEditor.d.ts +67 -0
- package/dist/editors/NumberEditor.js +86 -0
- package/dist/editors/RangeEditor.d.ts +22 -0
- package/dist/editors/RangeEditor.js +70 -0
- package/dist/editors/RelationEditor.d.ts +65 -0
- package/dist/editors/RelationEditor.js +64 -0
- package/dist/editors/SelectEditor.d.ts +72 -0
- package/dist/editors/SelectEditor.js +59 -0
- package/dist/editors/ValueListEditor.d.ts +38 -0
- package/dist/editors/ValueListEditor.js +217 -0
- package/dist/editors/edit-cores.d.ts +83 -0
- package/dist/editors/edit-cores.js +38 -0
- package/dist/editors/edit-session.d.ts +74 -0
- package/dist/editors/edit-session.js +35 -0
- package/dist/editors/open-values.d.ts +28 -0
- package/dist/editors/open-values.js +26 -0
- package/dist/editors/relation-source.d.ts +66 -0
- package/dist/editors/relation-source.js +102 -0
- package/dist/fields/binding.d.ts +87 -0
- package/dist/fields/binding.js +117 -0
- package/dist/fields/currency.d.ts +92 -0
- package/dist/fields/currency.js +55 -0
- package/dist/fields/denomination.d.ts +42 -0
- package/dist/fields/denomination.js +11 -0
- package/dist/fields/edit-core-types.d.ts +40 -0
- package/dist/fields/edit-core-types.js +29 -0
- package/dist/fields/format-knobs.d.ts +34 -0
- package/dist/fields/format-knobs.js +36 -0
- package/dist/fields/menus.d.ts +28 -0
- package/dist/fields/menus.js +1 -0
- package/dist/fields/money.d.ts +59 -0
- package/dist/fields/money.js +77 -0
- package/dist/fields/number-edit.d.ts +11 -0
- package/dist/fields/number-edit.js +17 -0
- package/dist/fields/prepare-write.d.ts +55 -0
- package/dist/fields/prepare-write.js +67 -0
- package/dist/fields/relation-source-types.d.ts +54 -0
- package/dist/fields/relation-source-types.js +1 -0
- package/dist/figures.d.ts +52 -0
- package/dist/figures.js +63 -0
- package/dist/filters/date-filter.d.ts +2 -0
- package/dist/filters/date-filter.js +1 -0
- package/dist/filters/filter-model.d.ts +177 -0
- package/dist/filters/filter-model.js +41 -0
- package/dist/filters/number-filter.d.ts +2 -0
- package/dist/filters/number-filter.js +1 -0
- package/dist/filters/range-filter.d.ts +2 -0
- package/dist/filters/range-filter.js +1 -0
- package/dist/filters/registry.d.ts +136 -0
- package/dist/filters/registry.js +46 -0
- package/dist/filters/relation-filter.d.ts +16 -0
- package/dist/filters/relation-filter.js +53 -0
- package/dist/filters/text-filter.d.ts +2 -0
- package/dist/filters/text-filter.js +1 -0
- package/dist/filters/types.d.ts +27 -0
- package/dist/filters/types.js +1 -0
- package/dist/grouping/sort-groups.d.ts +18 -0
- package/dist/grouping/sort-groups.js +33 -0
- package/dist/grouping/types.d.ts +10 -0
- package/dist/grouping/types.js +1 -0
- package/dist/index.d.ts +29 -0
- package/dist/index.js +29 -0
- package/dist/internal/chip.d.ts +4 -0
- package/dist/internal/chip.js +3 -0
- package/dist/internal/cx.d.ts +3 -0
- package/dist/internal/cx.js +3 -0
- package/dist/model/aggregates.d.ts +59 -0
- package/dist/model/aggregates.js +186 -0
- package/dist/model/card-density.d.ts +8 -0
- package/dist/model/card-density.js +10 -0
- package/dist/model/card-layout.d.ts +85 -0
- package/dist/model/card-layout.js +90 -0
- package/dist/model/column-capabilities.d.ts +162 -0
- package/dist/model/column-capabilities.js +233 -0
- package/dist/model/column-filters.d.ts +106 -0
- package/dist/model/column-filters.js +321 -0
- package/dist/model/column-format.d.ts +103 -0
- package/dist/model/column-format.js +1 -0
- package/dist/model/column-from.d.ts +28 -0
- package/dist/model/column-from.js +160 -0
- package/dist/model/column-inspect.d.ts +18 -0
- package/dist/model/column-inspect.js +6 -0
- package/dist/model/column-knobs.d.ts +20 -0
- package/dist/model/column-knobs.js +16 -0
- package/dist/model/column-money.d.ts +13 -0
- package/dist/model/column-money.js +27 -0
- package/dist/model/column-order.d.ts +36 -0
- package/dist/model/column-order.js +68 -0
- package/dist/model/column-schema.d.ts +335 -0
- package/dist/model/column-schema.js +1 -0
- package/dist/model/column-sort.d.ts +17 -0
- package/dist/model/column-sort.js +11 -0
- package/dist/model/column-state.d.ts +77 -0
- package/dist/model/column-state.js +95 -0
- package/dist/model/column-types.d.ts +109 -0
- package/dist/model/column-types.js +50 -0
- package/dist/model/column-warnings.d.ts +44 -0
- package/dist/model/column-warnings.js +24 -0
- package/dist/model/density.d.ts +3 -0
- package/dist/model/density.js +13 -0
- package/dist/model/field-type-of.d.ts +21 -0
- package/dist/model/field-type-of.js +11 -0
- package/dist/model/filter-capabilities.d.ts +1 -0
- package/dist/model/filter-capabilities.js +1 -0
- package/dist/model/filter-pushdown.d.ts +106 -0
- package/dist/model/filter-pushdown.js +147 -0
- package/dist/model/index.d.ts +40 -0
- package/dist/model/index.js +21 -0
- package/dist/model/part-rows.d.ts +28 -0
- package/dist/model/part-rows.js +40 -0
- package/dist/model/preferences.d.ts +151 -0
- package/dist/model/preferences.js +84 -0
- package/dist/model/prefs-buckets.d.ts +173 -0
- package/dist/model/prefs-buckets.js +71 -0
- package/dist/model/relation-filters.d.ts +45 -0
- package/dist/model/relation-filters.js +78 -0
- package/dist/model/render-count.d.ts +2 -0
- package/dist/model/render-count.js +24 -0
- package/dist/model/row-icon.d.ts +23 -0
- package/dist/model/row-icon.js +5 -0
- package/dist/model/view-rules.d.ts +73 -0
- package/dist/model/view-rules.js +216 -0
- package/dist/provider/ViewsProvider.d.ts +26 -0
- package/dist/provider/ViewsProvider.js +12 -0
- package/dist/provider/components.d.ts +222 -0
- package/dist/provider/components.js +3 -0
- package/dist/provider/context.d.ts +19 -0
- package/dist/provider/context.js +10 -0
- package/dist/provider/icons.d.ts +6 -0
- package/dist/provider/icons.js +1 -0
- package/dist/provider/ports.d.ts +35 -0
- package/dist/provider/ports.js +8 -0
- package/dist/react.d.ts +9 -0
- package/dist/react.js +4 -0
- package/dist/selection/SelectCheckbox.d.ts +17 -0
- package/dist/selection/SelectCheckbox.js +11 -0
- package/dist/selection/index.d.ts +7 -0
- package/dist/selection/index.js +6 -0
- package/dist/selection/model.d.ts +55 -0
- package/dist/selection/model.js +86 -0
- package/dist/selection/row-click.d.ts +35 -0
- package/dist/selection/row-click.js +20 -0
- package/dist/selection/types.d.ts +17 -0
- package/dist/selection/types.js +1 -0
- package/dist/selection/useCheckDragSelect.d.ts +61 -0
- package/dist/selection/useCheckDragSelect.js +165 -0
- package/dist/selection/useListSelection.d.ts +39 -0
- package/dist/selection/useListSelection.js +48 -0
- package/dist/selection/useListSelectionShortcuts.d.ts +6 -0
- package/dist/selection/useListSelectionShortcuts.js +14 -0
- package/dist/selection/useRestIntent.d.ts +18 -0
- package/dist/selection/useRestIntent.js +35 -0
- package/docs/contract.md +453 -0
- package/docs/install.md +105 -0
- package/docs/reshaping.md +19 -0
- package/package.json +114 -3
- 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.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
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.
|