@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
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { useContext } from "react";
|
|
4
|
+
import { linkPlatform } from "@viewkitjs/fields";
|
|
5
|
+
import { cx } from "../internal/cx.js";
|
|
6
|
+
import { ViewsContext } from "../provider/context.js";
|
|
7
|
+
import { cellTextClass } from "./text-class.js";
|
|
8
|
+
import { renderValueList } from "./value-list.js";
|
|
9
|
+
import { webHref } from "./web-href.js";
|
|
10
|
+
export function renderUrl(_field, value, opts) {
|
|
11
|
+
if (Array.isArray(value))
|
|
12
|
+
return renderValueList(value, (one) => _jsx(WebAddress, { address: String(one), opts: single(opts) }), opts);
|
|
13
|
+
return _jsx(WebAddress, { address: String(value), opts: opts });
|
|
14
|
+
}
|
|
15
|
+
function single(opts) {
|
|
16
|
+
return opts ? { ...opts, wrap: false } : opts;
|
|
17
|
+
}
|
|
18
|
+
function WebAddress({ address, opts }) {
|
|
19
|
+
const views = useContext(ViewsContext);
|
|
20
|
+
const label = address.replace(/^https?:\/\//, "");
|
|
21
|
+
const href = webHref(address);
|
|
22
|
+
const link = opts?.slotOwnsClick || href === null ? (_jsx("span", { className: cellTextClass(opts?.wrap), children: label })) : (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", "data-no-nav": true, className: cx(cellTextClass(opts?.wrap), "text-(color:--vk-fg-brand) hover:underline"), children: label }));
|
|
23
|
+
const platform = views && href !== null ? linkPlatform(address, views.conventions) : null;
|
|
24
|
+
if (!platform || !views)
|
|
25
|
+
return link;
|
|
26
|
+
return (_jsxs("span", { className: "inline-flex max-w-full min-w-0 items-baseline gap-1.5", children: [_jsx(views.atoms.PlatformMark, { platform: platform }), link] }));
|
|
27
|
+
}
|
|
28
|
+
export function renderDomain(_field, value, opts) {
|
|
29
|
+
if (Array.isArray(value))
|
|
30
|
+
return renderValueList(value, (one) => domainLink(String(one), single(opts)), opts);
|
|
31
|
+
return domainLink(String(value), opts);
|
|
32
|
+
}
|
|
33
|
+
function domainLink(domain, opts) {
|
|
34
|
+
const href = webHref(domain);
|
|
35
|
+
if (opts?.slotOwnsClick || href === null)
|
|
36
|
+
return _jsx("span", { className: cellTextClass(opts?.wrap), children: domain });
|
|
37
|
+
return (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", "data-no-nav": true, className: cx(cellTextClass(opts?.wrap), "text-(color:--vk-fg-brand) hover:underline"), children: domain }));
|
|
38
|
+
}
|
|
39
|
+
export function renderEmail(_field, value, opts) {
|
|
40
|
+
if (Array.isArray(value))
|
|
41
|
+
return renderValueList(value, (one) => renderEmailAddress(String(one)), opts);
|
|
42
|
+
if (value == null || value === "")
|
|
43
|
+
return null;
|
|
44
|
+
return renderValueList([value], (one) => renderEmailAddress(String(one)), opts);
|
|
45
|
+
}
|
|
46
|
+
function renderEmailAddress(address) {
|
|
47
|
+
return (_jsx("a", { href: `mailto:${address}`, "data-no-nav": true, className: "text-(color:--vk-fg) underline decoration-dotted decoration-(color:--vk-fg-subtle)/40 decoration-1 underline-offset-[3px] transition-colors hover:decoration-(color:--vk-fg-subtle)/60", onClick: (event) => event.stopPropagation(), children: address }));
|
|
48
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
2
|
+
import type { DisplayOptions } from "./options.js";
|
|
3
|
+
/** A place remains structured until the display boundary, then reads as one line. A cell draws it short, its city
|
|
4
|
+
* and its country (`locationShort`); a host with room for the whole value (`wrap: "full"`) draws the whole place
|
|
5
|
+
* (`locationText`). The country is named in the viewer's language. A list of places (a lookup through a many
|
|
6
|
+
* relation, VK-63) draws through the several-values layout, each place written so. */
|
|
7
|
+
export declare function renderLocation(field: FieldDefOf<"location">, value: unknown, opts?: DisplayOptions): string | import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { locationShort, locationText } from "@viewkitjs/fields";
|
|
4
|
+
import { MultiValueCell } from "./multi-value.js";
|
|
5
|
+
export function renderLocation(field, value, opts) {
|
|
6
|
+
void field;
|
|
7
|
+
const write = opts?.wrap === "full" ? locationText : locationShort;
|
|
8
|
+
if (Array.isArray(value)) {
|
|
9
|
+
const places = value.map((place) => write(place, opts?.viewer?.locale)).filter(Boolean);
|
|
10
|
+
if (places.length === 0)
|
|
11
|
+
return null;
|
|
12
|
+
return (_jsx(MultiValueCell, { items: places, wrap: !!opts?.wrap, title: places.join(", "), slotOwnsClick: opts?.slotOwnsClick }));
|
|
13
|
+
}
|
|
14
|
+
return write(value, opts?.viewer?.locale) || null;
|
|
15
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
export declare function MultiValueCell({ items, details, wrap, title, slotOwnsClick, }: {
|
|
3
|
+
/** One rendered node per value, in order. Each is drawn by its TYPE's item
|
|
4
|
+
* renderer, and the same nodes are reused in the popover — so an address
|
|
5
|
+
* stays a `mailto:` and a relation chip still opens its own entity. */
|
|
6
|
+
items: ReactNode[];
|
|
7
|
+
/** One word per value drawn beside it in the popover (a value's label), never in the cell. */
|
|
8
|
+
details?: (string | null)[];
|
|
9
|
+
/** The user's "Wrap columns" toggle. BINARY here, unlike `DisplayOptions.wrap`
|
|
10
|
+
* — a chip list either flows onto more rows or does not; there is no
|
|
11
|
+
* uncapped state to ask for, because the overflow is a count, not a clip. */
|
|
12
|
+
wrap?: boolean;
|
|
13
|
+
/** The whole set as plain text, for the native hover. */
|
|
14
|
+
title?: string;
|
|
15
|
+
/** A host whose own slot owns the click (see `DisplayOptions`) — the overflow
|
|
16
|
+
* count draws as plain text, and mounts no popover at all. */
|
|
17
|
+
slotOwnsClick?: boolean;
|
|
18
|
+
}): import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
|
|
3
|
+
import { useRef, useState } from "react";
|
|
4
|
+
import { cx } from "../internal/cx.js";
|
|
5
|
+
import { useViews } from "../provider/context.js";
|
|
6
|
+
const VISIBLE_FLAT = 1;
|
|
7
|
+
const VISIBLE_WRAPPED = 3;
|
|
8
|
+
const ROW_INSET = 14;
|
|
9
|
+
export function MultiValueCell({ items, details, wrap, title, slotOwnsClick, }) {
|
|
10
|
+
const { atoms, components, messages } = useViews();
|
|
11
|
+
const [open, setOpen] = useState(false);
|
|
12
|
+
const anchor = useRef(null);
|
|
13
|
+
const trigger = useRef(null);
|
|
14
|
+
if (items.length === 0)
|
|
15
|
+
return null;
|
|
16
|
+
const shown = items.slice(0, wrap ? VISIBLE_WRAPPED : VISIBLE_FLAT);
|
|
17
|
+
const hidden = items.length - shown.length;
|
|
18
|
+
const content = (_jsxs("span", { ref: anchor, className: cx("flex min-w-0 items-center gap-1", wrap && "flex-wrap gap-y-0.5"), title: title, children: [shown.map((item, index) => (_jsx("span", { className: "flex min-w-0 items-center truncate", children: item }, index))), hidden > 0 &&
|
|
19
|
+
(slotOwnsClick ? (_jsxs("span", { className: "shrink-0 text-[10px] leading-[0.9rem] text-(color:--vk-fg-subtle)", children: ["+", hidden] })) : (_jsxs("button", { ref: trigger, type: "button", tabIndex: -1, "data-no-nav": true, "aria-label": messages({ key: "views.display.show-all", values: { count: items.length } }), "aria-haspopup": "dialog", "aria-expanded": open, onClick: (event) => {
|
|
20
|
+
event.stopPropagation();
|
|
21
|
+
setOpen((current) => !current);
|
|
22
|
+
}, className: cx("shrink-0 rounded-md [corner-shape:squircle] border border-(color:--vk-border)", "bg-(color:--vk-ground) px-1 text-[10px] leading-[0.9rem] text-(color:--vk-fg-subtle) shadow-xs", "transition-colors hover:bg-(color:--vk-hovered) hover:text-(color:--vk-fg)"), children: ["+", hidden] })))] }));
|
|
23
|
+
if (hidden === 0 || slotOwnsClick)
|
|
24
|
+
return content;
|
|
25
|
+
const { Popover } = components;
|
|
26
|
+
const { List, Row } = atoms;
|
|
27
|
+
return (_jsxs(_Fragment, { children: [content, _jsx(Popover, { open: open, onOpenChange: (next) => setOpen(next), anchor: anchor, side: "bottom", align: "start", sideOffset: 4, alignOffset: -(ROW_INSET + 1), chrome: "menu", className: "w-72", onPanelClick: (event) => event.stopPropagation(), onOutsidePress: (event) => (trigger.current?.contains(event.target) ? false : undefined), children: _jsx(List, { className: "max-h-72 overflow-y-auto overscroll-contain scrollbar-overlay", children: items.map((item, index) => (_jsx(Row, { interactive: false, wrap: true, size: "compact", label: item, trailing: details?.[index] ? (_jsx("span", { className: "shrink-0 text-xs text-(color:--vk-fg-subtle)", children: details[index] })) : undefined }, index))) }) })] }));
|
|
28
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
2
|
+
import type { DisplayOptions } from "./options.js";
|
|
3
|
+
/** A name reads as the person writes it: the full name, else the given and family names (`nameText`), else
|
|
4
|
+
* the words the host gives an empty name (`nameFallback`, an email say), else nothing. A list of names (a lookup
|
|
5
|
+
* through a many relation, VK-63) draws through the several-values layout, each name written so. */
|
|
6
|
+
export declare function renderName(field: FieldDefOf<"name">, value: unknown, opts?: DisplayOptions): string | import("react/jsx-runtime").JSX.Element | null;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { nameText } from "@viewkitjs/fields";
|
|
4
|
+
import { MultiValueCell } from "./multi-value.js";
|
|
5
|
+
export function renderName(field, value, opts) {
|
|
6
|
+
void field;
|
|
7
|
+
if (Array.isArray(value)) {
|
|
8
|
+
const names = value.map(nameText).filter(Boolean);
|
|
9
|
+
if (names.length === 0)
|
|
10
|
+
return opts?.nameFallback || null;
|
|
11
|
+
return (_jsx(MultiValueCell, { items: names, wrap: !!opts?.wrap, title: names.join(", "), slotOwnsClick: opts?.slotOwnsClick }));
|
|
12
|
+
}
|
|
13
|
+
return nameText(value) || opts?.nameFallback || null;
|
|
14
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
3
|
+
import type { DisplayOptions } from "./options.js";
|
|
4
|
+
/**
|
|
5
|
+
* A number — plain or duration, the two readings a NUMBER still has. Money and
|
|
6
|
+
* percentages left for cores of their own (`currency.tsx`, `percent.tsx`).
|
|
7
|
+
*
|
|
8
|
+
* A value that isn't a number at all renders as itself — the same honesty the
|
|
9
|
+
* date core shows an unparseable date.
|
|
10
|
+
*/
|
|
11
|
+
export declare function renderNumber(field: FieldDefOf<"number">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { bandTone, isIntegerField } from "@viewkitjs/fields";
|
|
4
|
+
import { STATUS_TEXT } from "../atoms/tones.js";
|
|
5
|
+
import { cx } from "../internal/cx.js";
|
|
6
|
+
import { CellSuffix, formatNumberValue } from "./format.js";
|
|
7
|
+
import { cellTextClass } from "./text-class.js";
|
|
8
|
+
import { useDisplayOptions } from "./use-display-options.js";
|
|
9
|
+
export function renderNumber(field, value, opts) {
|
|
10
|
+
const n = typeof value === "number" ? value : Number(value);
|
|
11
|
+
if (Number.isNaN(n))
|
|
12
|
+
return _jsx("span", { className: cellTextClass(opts?.wrap), children: String(value) });
|
|
13
|
+
return _jsx(NumberValue, { field: field, n: n, opts: opts });
|
|
14
|
+
}
|
|
15
|
+
function NumberValue({ field, n, opts: given }) {
|
|
16
|
+
const opts = useDisplayOptions(given);
|
|
17
|
+
const format = field.format;
|
|
18
|
+
const signed = format && "signed" in format ? format.signed : undefined;
|
|
19
|
+
const signedTone = format && "signedTone" in format ? format.signedTone : undefined;
|
|
20
|
+
const suffix = format && "suffix" in format ? format.suffix : undefined;
|
|
21
|
+
const bands = format && "bands" in format ? format.bands : undefined;
|
|
22
|
+
const plainDecimals = format && "decimals" in format ? format.decimals : undefined;
|
|
23
|
+
const integer = isIntegerField(field);
|
|
24
|
+
const shown = integer ? { ...opts, decimals: 0 } : opts;
|
|
25
|
+
const tone = bandTone(bands, n, integer ? 0 : (opts?.decimals ?? plainDecimals ?? 2));
|
|
26
|
+
return (_jsxs("span", { className: cx(cellTextClass(opts?.wrap), "tabular-nums", tone ? STATUS_TEXT[tone] : signed && signedTone !== "neutral" && n > 0 && STATUS_TEXT.success), children: [formatNumberValue(n, format, shown), suffix && _jsx(CellSuffix, { children: suffix })] }));
|
|
27
|
+
}
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { CategoryColor } from "@viewkitjs/fields/design/category-colors";
|
|
3
|
+
import type { CurrencyFormat, DateStyle, FieldMessageResolver, NumberFormat, PercentDisplay, PercentFormat, RelationValue } from "@viewkitjs/fields";
|
|
4
|
+
import type { DurationStyle } from "@viewkitjs/fields/format/time";
|
|
5
|
+
import type { ViewsMessageResolver } from "../contract.js";
|
|
6
|
+
/**
|
|
7
|
+
* What the number FORMATTER accepts — wider than what a number FIELD declares.
|
|
8
|
+
*
|
|
9
|
+
* `percent` and `currency` are types now, not number styles, so `NumberFormat`
|
|
10
|
+
* no longer names them. The formatter still has to print all three, because a
|
|
11
|
+
* footer sum, a column menu's live preview and the three display cores all
|
|
12
|
+
* reach one string function: the two typed cores fold their field's format into
|
|
13
|
+
* this shape (`{ style: "percent", decimals }`) and hand it over.
|
|
14
|
+
*/
|
|
15
|
+
export type NumberLikeFormat = NumberFormat | ({
|
|
16
|
+
style: "percent";
|
|
17
|
+
} & PercentFormat) | ({
|
|
18
|
+
style: "currency";
|
|
19
|
+
currency?: string;
|
|
20
|
+
} & CurrencyFormat);
|
|
21
|
+
/**
|
|
22
|
+
* WHAT A FIELD CANNOT KNOW.
|
|
23
|
+
*
|
|
24
|
+
* A `FieldDef` describes the value: its type, its vocabulary, how it presents.
|
|
25
|
+
* Everything else a renderer needs comes from the surface drawing it — the row
|
|
26
|
+
* this value sits on (its currency), the user's per-column overrides (a date
|
|
27
|
+
* style, a decimals count), the host's own chrome (where a relation chip goes,
|
|
28
|
+
* whether the slot already owns the click). Those arrive here, so a core takes
|
|
29
|
+
* two arguments and stays portable: the field, and the answers.
|
|
30
|
+
*
|
|
31
|
+
* Everything is optional on purpose. `renderFieldValue(field, value)` with no
|
|
32
|
+
* options at all is a legal call and draws the field's own defaults — that is
|
|
33
|
+
* what makes a core liftable into a surface that has no list underneath it.
|
|
34
|
+
*/
|
|
35
|
+
/**
|
|
36
|
+
* How a host wraps ONE relation chip with its own click-through.
|
|
37
|
+
*
|
|
38
|
+
* The core draws the identity — avatar/icon + label — and nothing else, because
|
|
39
|
+
* where a chip GOES is not a property of the field: the grid resolves the
|
|
40
|
+
* entity's drawer from this app's registry, the detail panel opens its own
|
|
41
|
+
* stack, and a calendar card wants no click at all. Each host supplies the
|
|
42
|
+
* verb; the identity inside stays one object.
|
|
43
|
+
*/
|
|
44
|
+
export type RelationWrap = (relation: RelationValue, chip: ReactNode) => ReactNode;
|
|
45
|
+
/** Viewer-owned context. No mutable locale or timezone singleton lives in fields. */
|
|
46
|
+
export type FieldViewerContext = {
|
|
47
|
+
locale: string;
|
|
48
|
+
timeZone?: string;
|
|
49
|
+
/** The viewer's country, from the conventions: a phone of that country is written as at home. */
|
|
50
|
+
region?: string;
|
|
51
|
+
now: Date;
|
|
52
|
+
/** Fields' own words (`time.ago`). Default: fields' English. */
|
|
53
|
+
fieldMessages?: FieldMessageResolver;
|
|
54
|
+
/** The views package's words (`views.display.*`). Default: the package's English. */
|
|
55
|
+
messages?: ViewsMessageResolver;
|
|
56
|
+
};
|
|
57
|
+
/** Complete host presentation seam; Phase 4 routes every formatter through it. */
|
|
58
|
+
export type FieldPresentation = {
|
|
59
|
+
message: FieldMessageResolver;
|
|
60
|
+
number: (input: {
|
|
61
|
+
value: number;
|
|
62
|
+
format?: NumberLikeFormat;
|
|
63
|
+
decimals?: number;
|
|
64
|
+
currency?: string;
|
|
65
|
+
context: FieldViewerContext;
|
|
66
|
+
}) => string;
|
|
67
|
+
duration: (input: {
|
|
68
|
+
milliseconds: number;
|
|
69
|
+
style?: DurationStyle;
|
|
70
|
+
context: FieldViewerContext;
|
|
71
|
+
}) => string;
|
|
72
|
+
calendarDay: (input: {
|
|
73
|
+
day: string;
|
|
74
|
+
style: Exclude<DateStyle, "relative">;
|
|
75
|
+
context: FieldViewerContext;
|
|
76
|
+
}) => string;
|
|
77
|
+
instant: (input: {
|
|
78
|
+
instant: string | Date;
|
|
79
|
+
style: Exclude<DateStyle, "relative">;
|
|
80
|
+
withTime: boolean;
|
|
81
|
+
context: FieldViewerContext;
|
|
82
|
+
}) => string;
|
|
83
|
+
relativeCalendarDay: (input: {
|
|
84
|
+
day: string;
|
|
85
|
+
context: FieldViewerContext;
|
|
86
|
+
}) => string;
|
|
87
|
+
relativeInstant: (input: {
|
|
88
|
+
instant: string | Date;
|
|
89
|
+
context: FieldViewerContext;
|
|
90
|
+
}) => string;
|
|
91
|
+
};
|
|
92
|
+
export type DisplayOptions = {
|
|
93
|
+
/** Complete host-supplied formatting and message implementation. */
|
|
94
|
+
presentation?: FieldPresentation;
|
|
95
|
+
/** Immutable viewer inputs supplied alongside a presentation implementation. */
|
|
96
|
+
viewer?: FieldViewerContext;
|
|
97
|
+
/** select: per-user colour overrides (a list preference) — resolved by the caller. */
|
|
98
|
+
optionColors?: Record<string, CategoryColor>;
|
|
99
|
+
/**
|
|
100
|
+
* select/multiselect: the LIST's pre-registry label rule for a value no option
|
|
101
|
+
* names. Absent, a stray value renders as the muted "unknown" chip (spec §3.6)
|
|
102
|
+
* — a registry field never invents a label for a code its vocabulary refuses.
|
|
103
|
+
*/
|
|
104
|
+
labelFallback?: (value: string) => string;
|
|
105
|
+
dateStyle?: DateStyle;
|
|
106
|
+
durationStyle?: DurationStyle;
|
|
107
|
+
decimals?: number;
|
|
108
|
+
/** currency: the code this VALUE is in — resolved by the caller, which has the row. */
|
|
109
|
+
currency?: string;
|
|
110
|
+
/** name: the words drawn for an empty name — resolved by the caller, which has the row (an email, say). */
|
|
111
|
+
nameFallback?: string;
|
|
112
|
+
/** date: the per-user show-time override — wins over the field's `withTime`. */
|
|
113
|
+
withTime?: boolean;
|
|
114
|
+
/** percent: the workspace's display choice — wins over the field's `format.display`. */
|
|
115
|
+
percentDisplay?: PercentDisplay;
|
|
116
|
+
/**
|
|
117
|
+
* The "wrap" toggle: text-bearing values clamp to three lines instead of
|
|
118
|
+
* truncating. `"full"` is the third state — the whole value, newlines kept,
|
|
119
|
+
* no cap — which only a host with room asks for (`FieldRow`, for a
|
|
120
|
+
* `format.long` text field). See `cellTextClass`.
|
|
121
|
+
*/
|
|
122
|
+
wrap?: boolean | "full";
|
|
123
|
+
/** boolean `icon` style: the two-state glyph. A node, so it cannot live on the field. */
|
|
124
|
+
booleanIcon?: (on: boolean) => ReactNode;
|
|
125
|
+
/** boolean `marker`: the badge's words. Falls back to the field's own label. */
|
|
126
|
+
marker?: {
|
|
127
|
+
label?: string;
|
|
128
|
+
title?: string;
|
|
129
|
+
};
|
|
130
|
+
/** boolean `marker`: this row's reason sentence. */
|
|
131
|
+
markerReason?: string | null;
|
|
132
|
+
/** boolean `marker`: clear the exception — the one-way `true → false` verb. */
|
|
133
|
+
onResolve?: () => void;
|
|
134
|
+
/**
|
|
135
|
+
* Two-way (`checkbox` / `icon`) booleans: flip the value. Its
|
|
136
|
+
* PRESENCE is the affordance — without it the display draws a plain,
|
|
137
|
+
* unclickable glyph, which is what a read-only or locked field looks like.
|
|
138
|
+
*/
|
|
139
|
+
onToggle?: (next: boolean) => void;
|
|
140
|
+
/** Temporarily disables a two-way control while preserving its rendered shape. */
|
|
141
|
+
booleanDisabled?: boolean;
|
|
142
|
+
/** relation: the caller's glyph for a kind. The field core has no app registry. */
|
|
143
|
+
entityIcon?: (kind: string | undefined) => ReactNode;
|
|
144
|
+
/** relation: the caller wraps each chip with its own click-through. Absent = inert. */
|
|
145
|
+
relationWrap?: RelationWrap;
|
|
146
|
+
/**
|
|
147
|
+
* A host whose own slot already owns the click and the drag — a calendar event
|
|
148
|
+
* card, whose outer element is the button. Every core draws its bare content:
|
|
149
|
+
* an overflow count is plain text with no popover trigger, a two-way boolean
|
|
150
|
+
* shows its glyph with no toggle. Set once by the host, never per field.
|
|
151
|
+
*/
|
|
152
|
+
slotOwnsClick?: boolean;
|
|
153
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { bandTone, isIntegerField } from "@viewkitjs/fields";
|
|
4
|
+
import { STATUS_TEXT } from "../atoms/tones.js";
|
|
5
|
+
import { cx } from "../internal/cx.js";
|
|
6
|
+
import { CellSuffix, formatNumberValue } from "./format.js";
|
|
7
|
+
import { cellTextClass } from "./text-class.js";
|
|
8
|
+
import { useDisplayOptions } from "./use-display-options.js";
|
|
9
|
+
const RING_MASK = "radial-gradient(farthest-side, transparent calc(100% - 3.5px), #000 calc(100% - 3px))";
|
|
10
|
+
export function renderPercent(field, value, opts) {
|
|
11
|
+
const n = typeof value === "number" ? value : Number(value);
|
|
12
|
+
if (Number.isNaN(n))
|
|
13
|
+
return _jsx("span", { className: cellTextClass(opts?.wrap), children: String(value) });
|
|
14
|
+
return _jsx(PercentValue, { field: field, n: n, opts: opts });
|
|
15
|
+
}
|
|
16
|
+
function PercentValue({ field, n, opts: given }) {
|
|
17
|
+
const opts = useDisplayOptions(given);
|
|
18
|
+
const decimals = isIntegerField(field) ? 0 : (opts?.decimals ?? field.format?.decimals ?? 0);
|
|
19
|
+
const figure = formatNumberValue(n, { style: "plain", decimals }, { ...opts, decimals });
|
|
20
|
+
const tone = bandTone(field.format?.bands, n, decimals);
|
|
21
|
+
const toneClass = tone ? STATUS_TEXT[tone] : undefined;
|
|
22
|
+
const display = opts?.percentDisplay ?? field.format?.display ?? "text";
|
|
23
|
+
if (display === "text") {
|
|
24
|
+
return (_jsxs("span", { className: cx(cellTextClass(opts?.wrap), "tabular-nums", toneClass), children: [figure, _jsx(CellSuffix, { children: "%" })] }));
|
|
25
|
+
}
|
|
26
|
+
const clamped = Math.max(0, Math.min(100, n));
|
|
27
|
+
const figureSlot = `${5 + (decimals > 0 ? decimals + 1 : 0)}ch`;
|
|
28
|
+
return (_jsxs("span", { className: cx("flex min-w-0 items-center gap-2", display === "bar" && "w-full flex-1"), style: display === "bar" ? { maxWidth: `calc(6rem + 0.5rem + ${figureSlot})` } : undefined, children: [display === "bar" ? (_jsx("span", { className: "h-1.5 min-w-0 flex-1 overflow-hidden rounded-full bg-(color:--vk-neutral)", "aria-hidden": true, children: _jsx("span", { className: "block h-full bg-(color:--vk-brand)", style: { width: `${clamped}%` } }) })) : (_jsx("span", { className: "h-4 w-4 shrink-0 rounded-full", style: {
|
|
29
|
+
background: `conic-gradient(var(--vk-brand) ${clamped}%, var(--vk-neutral) 0)`,
|
|
30
|
+
WebkitMaskImage: RING_MASK,
|
|
31
|
+
maskImage: RING_MASK,
|
|
32
|
+
}, "aria-hidden": true })), _jsxs("span", { className: cx("shrink-0 text-right tabular-nums", toneClass), style: { width: figureSlot }, children: [figure, _jsx(CellSuffix, { children: "%" })] })] }));
|
|
33
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { FieldDefOf } from "@viewkitjs/fields/types";
|
|
3
|
+
import type { DisplayOptions } from "./options.js";
|
|
4
|
+
/**
|
|
5
|
+
* A phone in its international form, written the way its country writes it for a viewer at home (the viewer's
|
|
6
|
+
* region, from the conventions) and internationally for anyone else, its extension in the package's words after
|
|
7
|
+
* it, dialled by its RFC 3966 link. A phone stored as typed, before phones had one form, is drawn as before (its
|
|
8
|
+
* text, a link of its digits and a leading `+`) and flagged as not yet in the international form.
|
|
9
|
+
*/
|
|
10
|
+
export declare function renderPhone(_field: FieldDefOf<"phone">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { phoneHref, phoneText, readPhone } from "@viewkitjs/fields/phone";
|
|
4
|
+
import { resolveViewsMessage } from "../contract.js";
|
|
5
|
+
import { cx } from "../internal/cx.js";
|
|
6
|
+
import { CHIP_INTERACTIVE } from "../internal/chip.js";
|
|
7
|
+
import { cellTextClass } from "./text-class.js";
|
|
8
|
+
import { renderValueList } from "./value-list.js";
|
|
9
|
+
export function renderPhone(_field, value, opts) {
|
|
10
|
+
if (Array.isArray(value))
|
|
11
|
+
return renderValueList(value, (one) => phoneNode(one, opts && { ...opts, wrap: false }), opts, (one) => phoneLine(one, opts) ?? String(one));
|
|
12
|
+
return phoneNode(value, opts);
|
|
13
|
+
}
|
|
14
|
+
function phoneLine(value, opts) {
|
|
15
|
+
const reading = readPhone(value);
|
|
16
|
+
if (!reading)
|
|
17
|
+
return null;
|
|
18
|
+
if (reading.kind !== "international")
|
|
19
|
+
return reading.text;
|
|
20
|
+
const words = opts?.viewer?.messages ?? resolveViewsMessage;
|
|
21
|
+
const { extension } = reading.value;
|
|
22
|
+
const number = phoneText({ ...reading.value, extension: null }, opts?.viewer?.region);
|
|
23
|
+
return extension ? `${number} ${words({ key: "views.display.phone-extension", values: { extension } })}` : number;
|
|
24
|
+
}
|
|
25
|
+
function phoneNode(value, opts) {
|
|
26
|
+
const reading = readPhone(value);
|
|
27
|
+
if (!reading)
|
|
28
|
+
return null;
|
|
29
|
+
const words = opts?.viewer?.messages ?? resolveViewsMessage;
|
|
30
|
+
const text = phoneLine(value, opts) ?? "";
|
|
31
|
+
const asTyped = reading.kind === "international"
|
|
32
|
+
? undefined
|
|
33
|
+
: { "data-as-typed": "", title: words({ key: "views.display.phone-as-typed" }) };
|
|
34
|
+
if (opts?.slotOwnsClick) {
|
|
35
|
+
return (_jsx("span", { className: cellTextClass(opts?.wrap), ...asTyped, children: text }));
|
|
36
|
+
}
|
|
37
|
+
return (_jsx("a", { href: phoneHref(value) ?? undefined, "data-no-nav": true, className: cx(cellTextClass(opts?.wrap), CHIP_INTERACTIVE), onClick: (event) => event.stopPropagation(), ...asTyped, children: text }));
|
|
38
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
3
|
+
import type { DisplayOptions } from "./options.js";
|
|
4
|
+
/** A low and a high end — "11–50", "10,001+", "up to 50" — then the code and
|
|
5
|
+
* the period of an amount range. */
|
|
6
|
+
export declare function renderRange(field: FieldDefOf<"range">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { rangeText } from "@viewkitjs/fields";
|
|
4
|
+
import { useViews } from "../provider/context.js";
|
|
5
|
+
import { CellSuffix } from "./format.js";
|
|
6
|
+
import { cellTextClass } from "./text-class.js";
|
|
7
|
+
const PERIOD_SHORT = {
|
|
8
|
+
hour: "/h",
|
|
9
|
+
day: "/day",
|
|
10
|
+
week: "/wk",
|
|
11
|
+
month: "/mo",
|
|
12
|
+
year: "/yr",
|
|
13
|
+
};
|
|
14
|
+
export function renderRange(field, value, opts) {
|
|
15
|
+
return _jsx(RangeValueCell, { field: field, value: value, opts: opts });
|
|
16
|
+
}
|
|
17
|
+
function RangeValueCell({ field, value, opts, }) {
|
|
18
|
+
const { conventions } = useViews();
|
|
19
|
+
const text = rangeText(field, value, conventions);
|
|
20
|
+
if (!text)
|
|
21
|
+
return null;
|
|
22
|
+
const unit = field.of === "percent"
|
|
23
|
+
? "%"
|
|
24
|
+
: field.of === "currency"
|
|
25
|
+
? field.code?.fixed
|
|
26
|
+
: field.format?.suffix;
|
|
27
|
+
const period = field.period ? PERIOD_SHORT[field.period] : undefined;
|
|
28
|
+
return (_jsxs("span", { className: cellTextClass(opts?.wrap), title: text, children: [_jsx("span", { className: "tabular-nums", children: text }), unit && _jsx(CellSuffix, { children: unit }), period && _jsx(CellSuffix, { children: period })] }));
|
|
29
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { orderLinks, relationKinds, resolveRelationValue, } from "@viewkitjs/fields";
|
|
4
|
+
import { CHIP_BASE } from "../internal/chip.js";
|
|
5
|
+
import { useViews } from "../provider/context.js";
|
|
6
|
+
import { EntityChipIdentity } from "./entity-chip.js";
|
|
7
|
+
import { MultiValueCell } from "./multi-value.js";
|
|
8
|
+
import { cellTextClass } from "./text-class.js";
|
|
9
|
+
export function renderRelation(field, value, opts) {
|
|
10
|
+
if (Array.isArray(value)) {
|
|
11
|
+
const chips = orderLinks(field, value
|
|
12
|
+
.map((entry) => resolveRelationValue(entry, relationKinds(field)[0]))
|
|
13
|
+
.filter((entry) => entry != null));
|
|
14
|
+
if (chips.length === 0)
|
|
15
|
+
return null;
|
|
16
|
+
return (_jsx(MultiValueCell, { items: chips.map((chip) => _jsx(RelationChip, { relation: chip, opts: opts })), wrap: !!opts?.wrap, title: chips.map((chip) => chip.label).join(", "), slotOwnsClick: opts?.slotOwnsClick }));
|
|
17
|
+
}
|
|
18
|
+
const relation = resolveRelationValue(value, relationKinds(field)[0]);
|
|
19
|
+
if (!relation)
|
|
20
|
+
return null;
|
|
21
|
+
return _jsx(RelationChip, { relation: relation, opts: opts });
|
|
22
|
+
}
|
|
23
|
+
function RelationChip({ relation, opts }) {
|
|
24
|
+
const Glyph = useViews().icons.relation;
|
|
25
|
+
const chip = (_jsx(EntityChipIdentity, { label: relation.label, avatarUrl: relation.avatarUrl, iconOverride: relation.icon ?? opts?.entityIcon?.(relation.entity), fallbackIcon: _jsx(Glyph, { className: "h-3 w-3 shrink-0 text-(color:--vk-fg-subtlest)" }), labelClassName: cellTextClass(opts?.wrap) }));
|
|
26
|
+
if (opts?.relationWrap)
|
|
27
|
+
return opts.relationWrap(relation, chip);
|
|
28
|
+
return (_jsx("span", { className: CHIP_BASE, title: relation.label, children: chip }));
|
|
29
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
3
|
+
import type { DisplayOptions } from "./options.js";
|
|
4
|
+
/**
|
|
5
|
+
* Markdown, drawn three ways by how much room the surface has. One line: the
|
|
6
|
+
* first line with words, stripped. Wrapped (a card, a wrapped grid): the plain
|
|
7
|
+
* lines, clamped. `"full"` (a drawer row): the app's own renderer, folded past a
|
|
8
|
+
* height with Show more.
|
|
9
|
+
*/
|
|
10
|
+
export declare function renderRichText(_field: FieldDefOf<"rich_text">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
3
|
+
import { useLayoutEffect, useRef, useState } from "react";
|
|
4
|
+
import { markdownFirstLine, markdownPlainText } from "@viewkitjs/fields";
|
|
5
|
+
import { cx } from "../internal/cx.js";
|
|
6
|
+
import { useViews } from "../provider/context.js";
|
|
7
|
+
import { cellTextClass } from "./text-class.js";
|
|
8
|
+
const FOLDED_PX = 160;
|
|
9
|
+
export function renderRichText(_field, value, opts) {
|
|
10
|
+
const text = String(value);
|
|
11
|
+
if (opts?.wrap === "full")
|
|
12
|
+
return _jsx(RichTextBlock, { source: text });
|
|
13
|
+
if (opts?.wrap) {
|
|
14
|
+
return (_jsx("span", { className: cx(cellTextClass(true), "whitespace-pre-line"), children: markdownPlainText(text) }));
|
|
15
|
+
}
|
|
16
|
+
const line = markdownFirstLine(text);
|
|
17
|
+
return (_jsx("span", { className: cellTextClass(false), title: line, children: line }));
|
|
18
|
+
}
|
|
19
|
+
function RichTextBlock({ source }) {
|
|
20
|
+
const { components, messages } = useViews();
|
|
21
|
+
const { Markdown } = components;
|
|
22
|
+
const boxRef = useRef(null);
|
|
23
|
+
const [tall, setTall] = useState(false);
|
|
24
|
+
const [open, setOpen] = useState(false);
|
|
25
|
+
useLayoutEffect(() => {
|
|
26
|
+
const el = boxRef.current;
|
|
27
|
+
if (el)
|
|
28
|
+
setTall(el.scrollHeight > FOLDED_PX + 8);
|
|
29
|
+
}, [source]);
|
|
30
|
+
return (_jsxs("div", { className: "min-w-0", children: [_jsxs("div", { ref: boxRef, className: cx("relative min-w-0 overflow-hidden", !open && tall && "max-h-40"), children: [_jsx(Markdown, { source: source }), !open && tall && (_jsx("div", { className: "pointer-events-none absolute inset-x-0 bottom-0 h-10 bg-linear-to-t from-(color:--vk-ground) to-transparent" }))] }), tall && (_jsx("button", { type: "button", "data-no-nav": true, onClick: (event) => {
|
|
31
|
+
event.stopPropagation();
|
|
32
|
+
setOpen((was) => !was);
|
|
33
|
+
}, className: "mt-1 text-xs text-(color:--vk-fg-subtle) hover:text-(color:--vk-fg)", children: messages({ key: open ? "views.display.show-less" : "views.display.show-more" }) }))] }));
|
|
34
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import { type FieldDefOf } from "@viewkitjs/fields";
|
|
3
|
+
import type { DisplayOptions } from "./options.js";
|
|
4
|
+
export declare function renderSelect(field: FieldDefOf<"select">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
5
|
+
export declare function renderStatus(field: FieldDefOf<"status">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
6
|
+
export declare function renderMultiselect(field: FieldDefOf<"multiselect">, value: unknown, opts?: DisplayOptions): ReactNode;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { resolveCategoryColor } from "@viewkitjs/fields/design/category-colors";
|
|
4
|
+
import { optionFor } from "@viewkitjs/fields";
|
|
5
|
+
import { useViews } from "../provider/context.js";
|
|
6
|
+
import { MultiValueCell } from "./multi-value.js";
|
|
7
|
+
export function renderSelect(field, value, opts) {
|
|
8
|
+
return renderOptionValue(field, String(value), "category", opts, field.vocabulary === "custom-values");
|
|
9
|
+
}
|
|
10
|
+
export function renderStatus(field, value, opts) {
|
|
11
|
+
return renderOptionValue(field, String(value), "status", opts);
|
|
12
|
+
}
|
|
13
|
+
export function renderMultiselect(field, value, opts) {
|
|
14
|
+
const values = (Array.isArray(value) ? value : [value]).map(String);
|
|
15
|
+
const selfLabelled = field.vocabulary === "custom-values";
|
|
16
|
+
return (_jsx(MultiValueCell, { items: values.map((v) => renderOptionValue(field, v, undefined, opts, selfLabelled)), wrap: !!opts?.wrap, title: values.join(", "), slotOwnsClick: opts?.slotOwnsClick }));
|
|
17
|
+
}
|
|
18
|
+
function renderOptionValue(field, value, style, opts, selfLabelled = false) {
|
|
19
|
+
const option = optionFor(field, value);
|
|
20
|
+
const label = option?.label ?? opts?.labelFallback?.(value) ?? (selfLabelled ? value : undefined);
|
|
21
|
+
if (label === undefined)
|
|
22
|
+
return _jsx(StrayOption, { value: value });
|
|
23
|
+
if (style === "status")
|
|
24
|
+
return _jsx(OptionStatus, { slot: option?.slot ?? "muted", label: label, icon: option?.icon });
|
|
25
|
+
return (_jsx(OptionCategory, { label: label, color: resolveCategoryColor(value, field.options, opts?.optionColors), icon: option?.icon }));
|
|
26
|
+
}
|
|
27
|
+
function StrayOption({ value }) {
|
|
28
|
+
const { messages } = useViews();
|
|
29
|
+
return (_jsx("span", { className: "text-(color:--vk-fg-subtle)", title: messages({ key: "views.display.not-an-option" }), children: value }));
|
|
30
|
+
}
|
|
31
|
+
function OptionStatus({ slot, label, icon }) {
|
|
32
|
+
const { atoms: { StatusBadge }, components: { AppIcon }, } = useViews();
|
|
33
|
+
return (_jsx(StatusBadge, { slot: slot, label: label, className: "border-0", leading: icon ? _jsx(AppIcon, { name: icon, className: "size-3 shrink-0" }) : undefined }));
|
|
34
|
+
}
|
|
35
|
+
function OptionCategory({ label, color, icon }) {
|
|
36
|
+
const { atoms: { Tag }, components: { AppIcon }, } = useViews();
|
|
37
|
+
return (_jsx(Tag, { label: label, color: color, leading: icon ? _jsx(AppIcon, { name: icon, className: "size-3 shrink-0" }) : undefined }));
|
|
38
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How a text-bearing value handles being longer than the box it is in: one line
|
|
3
|
+
* ending in an ellipsis, up to three wrapped lines, or the whole thing.
|
|
4
|
+
*
|
|
5
|
+
* Three is a CAP, not a target. An uncapped wrap lets a single 800-character
|
|
6
|
+
* note make a forty-line row, and a table stops being scannable — which is the
|
|
7
|
+
* only reason to be in one. One function so the cap lives in one place rather
|
|
8
|
+
* than in every core that draws text.
|
|
9
|
+
*
|
|
10
|
+
* THE THIRD STATE EXISTS BECAUSE THE CAP IS A TABLE'S CONCERN. A drawer row has
|
|
11
|
+
* no column left of it to keep scannable and the whole width of the panel to
|
|
12
|
+
* spend, so a field that carries paragraphs — a description, a note — is
|
|
13
|
+
* readable there or nowhere: clamped, its remainder survives only in a native
|
|
14
|
+
* hover title or by clicking into the editor, which is reading by accident.
|
|
15
|
+
* `"full"` keeps the newlines too, because a value written in paragraphs is one.
|
|
16
|
+
* The HOST asks for it, never the field: `FieldRow` does, for a `format.long`
|
|
17
|
+
* text field, and the grid, the board and the calendar never do.
|
|
18
|
+
*
|
|
19
|
+
* Its own module rather than a member of `format.ts`: that file turns values
|
|
20
|
+
* into strings, this one is paint, and the multi-value layout needs the paint
|
|
21
|
+
* without the formatters.
|
|
22
|
+
*/
|
|
23
|
+
export declare function cellTextClass(wrap?: boolean | "full"): string;
|