@graview/primitives 0.1.0

package/dist/profile.js

@@ -0,0 +1,233 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { humaniseField, labelOf, nameOfAuthor } from "@graview/core";
+import { useGraview } from "@graview/react";
+import { LadderSetting } from "./ladder.js";
+import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { Seats } from "./seats.js";
+import { closeToTrigger, keepInside } from "./popover.js";
+/**
+ * WHO YOU ARE AT THIS KEYBOARD, AND WHAT YOU SET FOR YOURSELF.
+ *
+ * Every app needs one place that answers "who am I signed in as" and holds
+ * the handful of things that are the READER's rather than the
+ * installation's. Text size is the case that forced it: the framework sizes
+ * every surface in `rem` precisely so that one number on the root element
+ * resizes the whole app — and until now nothing anywhere offered that
+ * number, so the property existed and nobody could use it.
+ *
+ * What the pane holds, in the order a person looks for it:
+ *
+ *   who you are — the seat's own name and role, and where the installation
+ *                 is declared, a way into your own record, which the self
+ *                 grant already makes yours to edit and nobody else's;
+ *   which seat  — the switcher, where the app offers a choice, because
+ *                 "who am I" and "be somebody else" belong together;
+ *   your settings — drawn from the DECLARATION. Nothing here knows what
+ *                 "text size" means; it renders what the app declared and
+ *                 the provider has already carried the answer to the root.
+ *   the scheme  — light or dark, which was on the bar alone.
+ *   keeping it — and, for the seat that keeps this installation ONLY, the
+ *                ways into it: its own districts, and its declaration.
+ *
+ * That last block was two pills on the bar, beside the places — which put
+ * administration in the same row as "the week" and "the month", where every
+ * reader saw the app's shape before they saw their own work. They are the
+ * keeper's, they are rare, and they belong behind the same door as "who am
+ * I". A member never sees the block at all, because both controls draw
+ * nothing for a seat that may not administer and the block hides itself
+ * when it holds nothing.
+ *
+ * What is NOT administration stays what it was: a member sees their own
+ * name, their own record and their own text size, and never a person who is
+ * not them.
+ */
+export function Profile({ scheme, onScheme, 
+/** Where a person's own record lives on the routed face, if there is one. */
+profileHref, 
+/**
+ * The ways into the app itself, for the seat that keeps it: showing the
+ * installation's own districts, and opening its declaration in the studio.
+ *
+ * A slot rather than a fixed pair, because the studio lives in a package
+ * this one must not depend on — the same reason the shell takes it as a
+ * node. Both of them render nothing for a seat that may not administer,
+ * and the block they sit in hides itself when they do.
+ */
+keeping, compact = false, }) {
+    const { store, principal, seats, settings, settingValues, chooseSetting, sharing, hostAnswers } = useGraview();
+    const [open, setOpen] = useState(false);
+    const anchor = useRef(null);
+    useEffect(() => {
+        if (!open)
+            return;
+        const away = (event) => {
+            const target = event.target;
+            if (anchor.current?.contains(target))
+                return;
+            /*
+             * A CONTROL IN HERE MAY OPEN SOMETHING BIGGER THAN HERE.
+             *
+             * The studio is a full-screen dialog portalled to the body, and its
+             * button lives in this pane. Treating the first press inside the
+             * studio as "away" closed the pane, which unmounted the button, which
+             * took the portal with it — the studio opened and vanished on the
+             * next click. Anything that is itself a dialog or an overlay is not
+             * away from the thing that opened it.
+             */
+            if (target instanceof Element && target.closest('[role="dialog"], [data-graview-overlay]'))
+                return;
+            setOpen(false);
+        };
+        const key = (event) => {
+            if (event.key === "Escape")
+                closeToTrigger(anchor.current, () => setOpen(false));
+        };
+        document.addEventListener("mousedown", away);
+        document.addEventListener("keydown", key);
+        return () => {
+            document.removeEventListener("mousedown", away);
+            document.removeEventListener("keydown", key);
+        };
+    }, [open]);
+    /*
+     * The person's own record, WHERE THERE IS ONE.
+     *
+     * A principal's id is its user node's id — that is what a self grant
+     * compares — so "who is signed in" is a graph lookup and not a second
+     * identity system. An app with no installation has no such node, and the
+     * pane says who you are from the principal alone rather than inventing a
+     * name.
+     */
+    // Inside an embed the pane stays inside the embed's box (see `keepInside`).
+    const pane = useRef(null);
+    useLayoutEffect(() => {
+        if (open)
+            keepInside(pane.current);
+    }, [open]);
+    const me = principal.id === undefined ? undefined : store.graph.getNode(principal.id);
+    const name = me === undefined
+        ? principal.id === undefined
+            ? "Nobody in particular"
+            : nameOfAuthor(principal, { graph: store.graph, schema: store.schema, seats })
+        : labelOf(store.schema.tryDefinition(me.kind), me);
+    const roles = principal.roles ?? [];
+    return (_jsxs("div", { ref: anchor, style: { position: "relative" }, children: [_jsxs("button", { type: "button", "data-testid": "profile-button", "aria-expanded": open, onClick: () => setOpen((value) => !value), title: "Who you are signed in as, and your own settings", style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: 7,
+                    padding: "4px 11px",
+                    borderRadius: 999,
+                    fontSize: "0.875rem",
+                    whiteSpace: "nowrap",
+                    /* In em, so the room for a name grows with the name. At 220px a
+                       reader on Largest got "Nobody in p…" — the setting made the
+                       words bigger and the box they live in stayed exactly where it
+                       was, which is the clipping the setting exists to prevent. */
+                    maxWidth: "14em",
+                }, children: [_jsx("span", { "aria-hidden": "true", "data-testid": "profile-mark", style: {
+                            display: "inline-flex",
+                            alignItems: "center",
+                            justifyContent: "center",
+                            /* The mark is a letter in a circle: sized in em it stays a
+                               circle around the letter at every text size, where 18px at
+                               2rem was a letter standing outside its own badge. */
+                            width: "1.35em",
+                            height: "1.35em",
+                            borderRadius: 999,
+                            fontSize: "0.75rem",
+                            background: "var(--graview-panel-muted)",
+                            color: "var(--graview-ink-muted)",
+                        }, children: initial(name) }), _jsx("span", { style: compact ? { position: "absolute", width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" } : { overflow: "hidden", textOverflow: "ellipsis" }, children: name }), _jsx("span", { "aria-hidden": "true", "data-testid": "profile-gear", style: { fontSize: "0.75rem", color: "var(--graview-ink-faint)" }, children: "\u2699" })] }), _jsxs("aside", { ref: (element) => {
+                    pane.current = element;
+                }, "aria-label": "Profile", "data-testid": "profile", "data-graview-offstage": "", "data-graview-overlay": "", hidden: !open, style: {
+                    position: "absolute",
+                    top: "calc(100% + 6px)",
+                    right: 0,
+                    zIndex: 20,
+                    width: 280,
+                    maxWidth: "calc(100vw - 32px)",
+                    maxHeight: "min(62cqh, 520px)",
+                    overflowY: "auto",
+                    // Not `overflow: auto`: nothing in here may run off the side.
+                    // A setting's own sentence was clipped mid-word against the
+                    // pane's edge, which is the one thing a text-size control must
+                    // not do.
+                    overflowX: "hidden",
+                    /*
+                     * `hidden` alone is not enough when the element sets its own
+                     * display: an inline `display: grid` beats the browser's
+                     * `[hidden] { display: none }`, so the closed pane stayed on
+                     * top of the bar and swallowed every press aimed at it.
+                     */
+                    display: open ? "grid" : "none",
+                    gap: 12,
+                    padding: 12,
+                    borderRadius: 10,
+                    border: "1px solid var(--graview-edge)",
+                    background: "var(--graview-float)",
+                    boxShadow: "var(--graview-lift-high)",
+                }, children: [_jsxs("div", { style: { display: "grid", gap: 3 }, children: [_jsx("span", { style: eyebrow, children: "Signed in as" }), _jsx("strong", { style: { fontSize: "1rem", fontWeight: 550 }, children: name }), _jsx("span", { style: { fontSize: "0.8125rem", color: "var(--graview-ink-muted)" }, children: roles.length > 0
+                                    ? // A role in words — "Sales manager", never "sales-manager".
+                                        roles.map((role) => humaniseField(role)).join(", ")
+                                    : me === undefined
+                                        ? "This app has no sign-in; everything here is yours."
+                                        : "No role in particular" }), me !== undefined && profileHref !== undefined ? (_jsx("a", { href: profileHref(me.id), "data-testid": "profile-record", style: {
+                                    /*
+                                     * A full fingertip, like every other control the audit
+                                     * counts. It was nineteen pixels tall — and nothing had
+                                     * ever measured it, because until the keeper's own ways
+                                     * in moved here no audited screen opened this pane.
+                                     */
+                                    display: "inline-flex",
+                                    alignItems: "center",
+                                    minHeight: 24,
+                                    justifySelf: "start",
+                                    fontSize: "0.875rem",
+                                    color: "var(--graview-accent)",
+                                }, children: "Your record \u2197" })) : null, sharing ? (
+                            /* How the others here see you — the name on the figure that stands where you are. */
+                            _jsxs("span", { "data-testid": "profile-seen-as", style: { fontSize: "0.8125rem", color: "var(--graview-ink-muted)" }, children: ["Seen by others as ", sharing.name] })) : null] }), _jsxs("div", { className: "graview-profile-keeping", "data-testid": "profile-keeping", style: ruled, children: [_jsx("span", { style: eyebrow, children: "Keeping this app" }), keeping] }), seats.length > 1 ? (_jsxs("div", { style: { display: "grid", gap: 6, ...ruled }, children: [_jsx("span", { style: eyebrow, children: "Sit as somebody else" }), _jsx(Seats, {})] })) : null, hostAnswers ? null : (_jsx("div", { style: { display: "grid", gap: 6, ...ruled }, children: _jsx(LadderSetting, {}) })), settings.length > 0 ? (_jsx("div", { style: { display: "grid", gap: 10, ...ruled }, children: settings.map((setting) => (_jsxs("fieldset", { "data-testid": `setting-${setting.name}`, style: { border: 0, margin: 0, padding: 0, display: "grid", gap: 5 }, children: [_jsx("legend", { style: { ...eyebrow, padding: 0 }, children: setting.title }), setting.description ? (_jsx("span", { style: { fontSize: "0.8125rem", color: "var(--graview-ink-muted)" }, children: setting.description })) : null, _jsx("div", { style: { display: "flex", flexWrap: "wrap", gap: 4 }, children: setting.options.map((option) => {
+                                        const chosen = (settingValues[setting.name] ?? setting.initial) === option.value;
+                                        return (_jsx("button", { type: "button", "aria-pressed": chosen, "data-testid": `setting-${setting.name}-${option.value}`, onClick: () => chooseSetting(setting.name, option.value), style: {
+                                                /*
+                                                 * 24px tall, like every other control the audit
+                                                 * counts — a setting for people who find the
+                                                 * text small must not itself be a small target.
+                                                 */
+                                                minHeight: 24,
+                                                padding: "3px 10px",
+                                                borderRadius: 999,
+                                                fontSize: "0.875rem",
+                                                borderWidth: 1,
+                                                borderStyle: "solid",
+                                                borderColor: chosen ? "var(--graview-accent)" : "var(--graview-edge)",
+                                                color: chosen ? "var(--graview-accent)" : "var(--graview-ink-muted)",
+                                                background: chosen ? "var(--graview-panel)" : "transparent",
+                                            }, children: option.label }, option.value));
+                                    }) })] }, setting.name))) })) : null, scheme !== undefined && onScheme !== undefined ? (_jsxs("div", { style: { display: "grid", gap: 5, ...ruled }, children: [_jsx("span", { style: eyebrow, children: "Scheme" }), _jsx("div", { style: { display: "flex", gap: 4 }, children: ["light", "dark"].map((candidate) => (_jsx("button", { type: "button", "aria-pressed": scheme === candidate, "data-testid": `profile-scheme-${candidate}`, onClick: () => onScheme(candidate), style: {
+                                        minHeight: 24,
+                                        padding: "3px 10px",
+                                        borderRadius: 999,
+                                        fontSize: "0.875rem",
+                                        borderWidth: 1,
+                                        borderStyle: "solid",
+                                        borderColor: scheme === candidate ? "var(--graview-accent)" : "var(--graview-edge)",
+                                        color: scheme === candidate ? "var(--graview-accent)" : "var(--graview-ink-muted)",
+                                        background: scheme === candidate ? "var(--graview-panel)" : "transparent",
+                                    }, children: candidate === "light" ? "☀ Light" : "☾ Dark" }, candidate))) })] })) : null] })] }));
+}
+const eyebrow = {
+    fontSize: "0.75rem",
+    letterSpacing: "0.14em",
+    textTransform: "uppercase",
+    color: "var(--graview-ink-faint)",
+};
+const ruled = {
+    paddingTop: 10,
+    borderTop: "1px solid var(--graview-edge)",
+};
+/** One letter for the mark, from a name rather than from an id. */
+function initial(name) {
+    return (name.trim()[0] ?? "?").toUpperCase();
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.tsx"],"names":[],"mappings":"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"}

package/dist/quick-relations.d.ts

@@ -0,0 +1,16 @@
+import { type AnySchema } from "@graview/core";
+/**
+ * HANDLES THAT CAN BE TOLD APART.
+ *
+ * Cut at eighteen characters, a customer's three test drives — "Wei Haddad
+ * in the 2017 Jeep…", "…2027 Chevrolet…", "…2027 Honda…" — were three
+ * chips reading "Wei Haddad in the…", and three buttons with one name. Where
+ * two cut handles would read the same, the words they share are what gets
+ * cut: "…2017 Jeep Wrangl…". A label that fits, or whose cut is already
+ * its own, is left as it was.
+ */
+export declare function handles(labels: readonly string[], most?: number): string[];
+export declare function QuickRelations<S extends AnySchema>({ inside }?: {
+    readonly inside?: boolean;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=quick-relations.d.ts.map

package/dist/quick-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-relations.d.ts","sourceRoot":"","sources":["../src/quick-relations.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAsCxD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,SAAa,GAAG,MAAM,EAAE,CAmB9E;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,MAAc,EAAE,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,sCA0JzG"}

package/dist/quick-relations.js

@@ -0,0 +1,183 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { labelOf } from "@graview/core";
+import { kindsOfAggregate } from "@graview/layout";
+import { useGraph, useGraview, useSelection } from "@graview/react";
+import { useMemo } from "react";
+import { hueFor } from "./default-views.js";
+/**
+ * THE PEOPLE BEHIND A VIEW, one press away.
+ *
+ * "Which of this week is Parent1's?" used to cost two deliberate gestures —
+ * raise People, then pick the person — for a one-glance question. The
+ * answer machinery has always existed (selecting a node lights everything
+ * it implicates); this is the fast way in: the graph already knows which
+ * few nodes touch the focused group most, so they stand as chips beside
+ * the scene. One click selects and the emphasis path does the rest; the
+ * pane then owns the rail, and Escape (or its ×) brings the chips back.
+ *
+ * Everything is derived and capped: kinds one edge from the focus whose
+ * membership is SMALL — a household's five people, not a season's forty
+ * sessions — ranked by how much of the visible view each one touches. A
+ * crowd never becomes a toolbar; it already has a district.
+ */
+/*
+ * Five, so the panel always finishes above the inspector's docked top edge
+ * — the two share the left rail as a stack, never a collision. A kind with
+ * more members has a district for exactly this.
+ */
+const MOST_MEMBERS = 5;
+/*
+ * ONE kind, not a stack of them. Two labelled rows of wrapping chips read
+ * as debris; the single kind that touches the view most — the people of a
+ * week, the players of a board — is the quick-select that earns the
+ * corner. Everything else already has a district and a legend.
+ */
+const MOST_KINDS = 1;
+/** A chip is a handle, not a sentence: long names cut with their full text on hover. */
+const MOST_LABEL = 18;
+/**
+ * HANDLES THAT CAN BE TOLD APART.
+ *
+ * Cut at eighteen characters, a customer's three test drives — "Wei Haddad
+ * in the 2017 Jeep…", "…2027 Chevrolet…", "…2027 Honda…" — were three
+ * chips reading "Wei Haddad in the…", and three buttons with one name. Where
+ * two cut handles would read the same, the words they share are what gets
+ * cut: "…2017 Jeep Wrangl…". A label that fits, or whose cut is already
+ * its own, is left as it was.
+ */
+export function handles(labels, most = MOST_LABEL) {
+    const cut = (text) => (text.length > most ? `${text.slice(0, most - 1).trimEnd()}…` : text);
+    const first = labels.map(cut);
+    return labels.map((label, index) => {
+        const mine = first[index];
+        const twins = labels.filter((_, other) => first[other] === mine);
+        if (twins.length < 2)
+            return mine;
+        // The words every twin starts with, to a word boundary.
+        let shared = twins.reduce((prefix, other) => {
+            let at = 0;
+            while (at < prefix.length && prefix[at] === other[at])
+                at += 1;
+            return prefix.slice(0, at);
+        }, label);
+        const space = shared.lastIndexOf(" ");
+        shared = space > 0 ? shared.slice(0, space + 1) : "";
+        const rest = label.slice(shared.length);
+        if (shared.length === 0 || rest.length === 0)
+            return mine;
+        return `…${rest.length > most - 1 ? `${rest.slice(0, most - 2).trimEnd()}…` : rest}`;
+    });
+}
+export function QuickRelations({ inside = false } = {}) {
+    const { store, view, brand, menuAt } = useGraview();
+    const { set } = useSelection();
+    const { selection } = useSelection();
+    const nodes = useGraph();
+    const rows = useMemo(() => {
+        if (!view.focusId)
+            return [];
+        const focusKinds = kindsOfAggregate(view.focusId);
+        const inFocus = new Set(focusKinds.length > 0
+            ? nodes.filter((node) => focusKinds.includes(node.kind)).map((node) => node.id)
+            : [view.focusId]);
+        if (inFocus.size === 0)
+            return [];
+        // One pass: everything one edge from the focus group, by kind, with how
+        // many of the visible things each candidate touches.
+        const byKind = new Map();
+        for (const edge of store.graph.allEdges()) {
+            const outward = inFocus.has(edge.from) ? edge.to : inFocus.has(edge.to) ? edge.from : null;
+            if (!outward || inFocus.has(outward))
+                continue;
+            const node = store.graph.getNode(outward);
+            if (!node)
+                continue;
+            if (focusKinds.includes(node.kind))
+                continue;
+            const members = byKind.get(node.kind) ?? new Map();
+            const entry = members.get(node.id) ?? { id: node.id, kind: node.kind, touches: 0 };
+            entry.touches += 1;
+            members.set(node.id, entry);
+            byKind.set(node.kind, members);
+        }
+        return [...byKind.entries()]
+            .filter(([, members]) => members.size > 0 && members.size <= MOST_MEMBERS)
+            .map(([kind, members]) => ({
+            kind,
+            plural: store.schema.tryDefinition(kind)?.plural ?? `${kind}s`,
+            reach: [...members.values()].reduce((sum, entry) => sum + entry.touches, 0),
+            members: [...members.values()].sort((a, b) => b.touches - a.touches || a.id.localeCompare(b.id)),
+        }))
+            .sort((a, b) => b.reach - a.reach)
+            .slice(0, MOST_KINDS);
+    }, [store, nodes, view.focusId]);
+    /*
+     * THE RAIL HAS ONE TENANT AT A TIME. At altitude the legend owns the
+     * corner; in the stack these chips do — until something is selected, at
+     * which point the inspector takes the whole rail and the chips stand
+     * aside (they are the way IN; the pane is where you already are, and its
+     * × or Escape is the way back out, after which the chips return). A
+     * pointer menu quiets the corner the same way.
+     */
+    if (view.overview || rows.length === 0 || menuAt !== null || selection.length > 0) {
+        return null;
+    }
+    return (_jsx("aside", { "aria-label": "Quick select", "data-testid": "quick-relations", style: inside
+            ? { display: "grid", gap: 5 }
+            : {
+                /*
+                 * The SAME dress the legend wears at altitude: one corner, one
+                 * visual language at both heights. Loose chips floating on the
+                 * ground read as something spilled; a panel reads as something
+                 * placed.
+                 */
+                position: "absolute",
+                left: 16,
+                top: 14,
+                zIndex: 5,
+                display: "grid",
+                gap: 5,
+                maxWidth: "min(250px, 21cqw)",
+                padding: "8px 10px",
+                borderRadius: 10,
+                border: "1px solid var(--graview-edge)",
+                background: "var(--graview-float)",
+                boxShadow: "var(--graview-lift-low)",
+                animation: "graview-settle 380ms 120ms ease backwards",
+            }, children: rows.map((row) => (_jsxs("div", { style: { display: "grid", gap: 5 }, children: [_jsx("span", { style: {
+                        fontSize: "0.75rem",
+                        letterSpacing: "0.16em",
+                        textTransform: "uppercase",
+                        color: "var(--graview-ink-faint)",
+                    }, children: row.plural }), _jsx("div", { style: { display: "flex", alignItems: "center", gap: 4, flexWrap: "wrap" }, children: row.members.map((member, index, all) => {
+                        const node = store.graph.getNode(member.id);
+                        if (!node)
+                            return null;
+                        const hue = Math.round(hueFor(member.kind, brand?.accents));
+                        const full = labelOf(store.schema.tryDefinition(member.kind), node);
+                        const shown = handles(all.map((one) => {
+                            const other = store.graph.getNode(one.id);
+                            return other ? labelOf(store.schema.tryDefinition(one.kind), other) : one.id;
+                        }))[index];
+                        return (_jsxs("button", { type: "button", "data-graview-quick": member.id, "aria-label": full, title: `${full} — ${member.touches} of what you are looking at`, onClick: () => set([member.id]), style: {
+                                display: "inline-flex",
+                                alignItems: "center",
+                                gap: 5,
+                                minHeight: 24,
+                                padding: "2px 9px",
+                                fontSize: "0.8125rem",
+                                borderRadius: 999,
+                                cursor: "pointer",
+                                border: "1px solid var(--graview-edge)",
+                                background: "var(--graview-float)",
+                                color: "var(--graview-ink)",
+                            }, children: [_jsx("span", { "aria-hidden": "true", style: {
+                                        width: 7,
+                                        height: 7,
+                                        borderRadius: 999,
+                                        flex: "0 0 auto",
+                                        background: `hsl(${hue} 55% var(--graview-tint-lightness) / 0.9)`,
+                                    } }), shown] }, member.id));
+                    }) })] }, row.kind))) }));
+}
+//# sourceMappingURL=quick-relations.js.map

package/dist/quick-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-relations.js","sourceRoot":"","sources":["../src/quick-relations.tsx"],"names":[],"mappings":"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"}

package/dist/relation-key.d.ts

@@ -0,0 +1,44 @@
+import { resolveKit, type AnySchema } from "@graview/core";
+/**
+ * What the lines mean.
+ *
+ * From the Graview the relations ARE the content, drawn with a colour and a
+ * stroke pattern per edge kind — and nothing said which was which. A picture
+ * of a domain whose only legend is "these are different from each other"
+ * answers the shape of the question and not the question.
+ *
+ * Everything here is derived: the edge kinds come from the schema, the
+ * treatment from the same `connectorStyle` the scene draws with, the
+ * descriptions from the declarations, and the counts from the graph. Nothing
+ * is authored per app, and a new edge kind appears the day it is declared.
+ *
+ * Clicking one selects the kinds it joins, which is the same gesture as
+ * clicking a card: from up here, "show me what this touches" is the only thing
+ * selecting can mean.
+ */
+export declare function RelationKey<S extends AnySchema>({ inside }?: {
+    readonly inside?: boolean;
+}): import("react").JSX.Element | null;
+/**
+ * What a relation is called where a person reads it: the declaration's
+ * description, capitalised, and which kinds it runs between in their
+ * plurals — "The vehicle it is for", "Deals → Vehicles". The edge's name is
+ * the source's word for it and only stands in when nothing else was said.
+ */
+export declare function relationWords(schema: AnySchema, edgeKind: string): {
+    readonly words: string;
+    readonly ends: string;
+};
+/**
+ * ONE RELATION'S MARK, on its own: the same stroke the scene draws and the
+ * key lists, for any surface that names an edge kind — the routed face's
+ * map of the kinds, a record's relation groups. Works with or without the
+ * scene's provider: outside one, the brand's kit is resolved from what the
+ * caller hands over, or the default kit stands.
+ */
+export declare function RelationMark({ edgeKind, kit: given, width }: {
+    readonly edgeKind: string;
+    readonly kit?: Parameters<typeof resolveKit>[0];
+    readonly width?: number;
+}): import("react").JSX.Element;
+//# sourceMappingURL=relation-key.d.ts.map

package/dist/relation-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-key.d.ts","sourceRoot":"","sources":["../src/relation-key.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAS3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,MAAc,EAAE,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,sCA6MtG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAU,EAAE,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,+BASzK"}