@graview/primitives 0.1.0

package/dist/workbench/agent-seat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-seat.js","sourceRoot":"","sources":["../../src/workbench/agent-seat.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,GAIT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAqCrD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAsB,EAC7C,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,MAAM,EACN,MAAM,EACN,GAAG,GACe;IAClB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,EAAK,CAAC;IACxF;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE;QACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CACH,iBAAiB,CAAC,KAAK,EAAE;QACvB,iFAAiF;QACjF,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,GAAG;YACP,OAAO;YACP,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD;QACD,kEAAkE;QAClE,+DAA+D;QAC/D,iEAAiE;QACjE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE;KAC7B,CAAC,EACJ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CACxC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,qEAAqE;IACrE,sDAAsD;IACtD,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,SAAS,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAE/C,MAAM,SAAS,GACb,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC;IAE1C;;;;OAIG;IACH,MAAM,OAAO,GAAG,CAAC,SAAS,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClH,MAAM,GAAG,GAAG,CAAC,SAAS;QACpB,CAAC,CAAC,mCACE,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE;YACpB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO;YACzB,CAAC,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,yBACxF,mCAAmC;QACrC,CAAC,CAAC,OAAO;YACP,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,+GAA+G,CAAC;IAEnJ;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAE,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,OAAO,EAAE,KAA6C,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/I,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1D;;;;;;;;;OASG;IACH,OAAO,CACL,gBAAM,KAAK,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,aACrF,iBACE,IAAI,EAAC,QAAQ,iBACA,MAAM,0BACG,SAAS,IAAI,SAAS,EAC5C,QAAQ,EAAE,GAAG,EACb,KAAK,EAAE,OAAO,IAAI,GAAG,EACrB,OAAO,EAAE,GAAG,EAAE;oBACZ,OAAO,CAAC,IAAI,CAAC,CAAC;oBACd,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,KAAK,CAAC,KAAK,IAAI,EAAE;wBACf,IAAI,CAAC;4BACH,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;wBAC5B,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf;;;;+BAIG;4BACH,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;wBACrE,CAAC;gCAAS,CAAC;4BACT,OAAO,CAAC,KAAK,CAAC,CAAC;wBACjB,CAAC;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,CAAC,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,YAE9B,IAAI,CAAC,CAAC,CAAC,CACN,SAAS,CACV,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CACf,sBAAI,KAAK,CAAC,KAAK,CAAC,GAAK,CACtB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACZ,IAAI,CACL,CAAC,CAAC,CAAC,CACF,KAAK,CAAC,KAAK,CAAC,CACb,GACM,EACN,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,CACvB,8BACe,GAAG,MAAM,MAAM,EAC5B,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,GAAG,EAAE,YAElG,OAAO,IAAI,GAAG,GACV,CACR,CAAC,CAAC,CAAC,IAAI,IACH,CACR,CAAC;AACJ,CAAC"}

package/dist/workbench/answer-args.d.ts

@@ -0,0 +1,31 @@
+import { type AnySchema, type Store } from "@graview/core";
+import type { Affordance, OpenParameter } from "@graview/tools";
+/**
+ * The controls for one action's unanswered arguments, walked in order.
+ *
+ * One at a time and in sequence, because an action can need several: drafting
+ * work needs both what it is and how big it is, and asking for the first
+ * while ignoring the second would produce a deliverable with an invented
+ * size. Each argument draws the control its declared shape asks for — a
+ * picker when it names a node, a date field when it is a date, an enum's own
+ * options when it is a choice.
+ */
+export declare function AnswerArgs({ affordance, onApply, onCancel, }: {
+    readonly affordance: Affordance;
+    onApply: (args: Record<string, unknown>) => void;
+    onCancel: () => void;
+}): import("react").JSX.Element | null;
+/** How many choices an ask shows at once. Past this it offers a filter. */
+export declare const SHOWN = 10;
+/**
+ * How one possible answer reads.
+ *
+ * A node reference reads as the node's own label; anything else reads as
+ * itself. `nameOf` would look "yes" up as a node id, fail to find one, and
+ * show the id — which is right for nodes and nonsense for a boolean or an
+ * enum value.
+ */
+export declare function said(store: Store<AnySchema>, shape: NonNullable<OpenParameter["shape"]>, choice: string): string;
+/** A node's own label where there is one, so a picker never offers raw ids. */
+export declare function nameOf(store: Store<AnySchema>, id: string): string;
+//# sourceMappingURL=answer-args.d.ts.map

package/dist/workbench/answer-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-args.d.ts","sourceRoot":"","sources":["../../src/workbench/answer-args.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAItG,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIhE;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,EACzB,UAAU,EACV,OAAO,EACP,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,sCAwSA;AAID,2EAA2E;AAC3E,eAAO,MAAM,KAAK,KAAK,CAAC;AAoBxB;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EACvB,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAC1C,MAAM,EAAE,MAAM,GACb,MAAM,CAIR;AAED,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAsBlE"}

package/dist/workbench/answer-args.js

@@ -0,0 +1,257 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { humaniseField, labelOf, nounOf, tellApart } from "@graview/core";
+import { relationWords } from "../relation-key.js";
+import { edgeOfSelection, kindsOf } from "@graview/layout";
+import { useGraview } from "@graview/react";
+import { useEffect, useId, useMemo, useRef, useState } from "react";
+/**
+ * The controls for one action's unanswered arguments, walked in order.
+ *
+ * One at a time and in sequence, because an action can need several: drafting
+ * work needs both what it is and how big it is, and asking for the first
+ * while ignoring the second would produce a deliverable with an invented
+ * size. Each argument draws the control its declared shape asks for — a
+ * picker when it names a node, a date field when it is a date, an enum's own
+ * options when it is a choice.
+ */
+export function AnswerArgs({ affordance, onApply, onCancel, }) {
+    const { store } = useGraview();
+    const [answers, setAnswers] = useState({});
+    const [draft, setDraft] = useState("");
+    /** What has been chosen so far, for an argument that takes several. */
+    const [picked, setPicked] = useState(NOTHING_PICKED);
+    // Stable across the walk's steps, so the group's label never dangles.
+    const promptId = useId();
+    const asked = useRef(null);
+    const remaining = affordance.open.filter((parameter) => !(parameter.name in answers));
+    const parameter = remaining[0];
+    useEffect(() => setDraft(""), [parameter?.name]);
+    /*
+     * AND IT IS ON THE SCREEN.
+     *
+     * The pane scrolls inside itself, and an ask opened under a list of acts
+     * taller than the pane lands below its fold: on a phone the field, the
+     * Apply and the Skip were all off the bottom of the window, so pressing
+     * an act looked like pressing a button that did nothing. The ask is the
+     * thing that just happened, so it is what the pane shows. `nearest`
+     * moves the pane the least amount that works and leaves everything
+     * already visible where it is.
+     */
+    useEffect(() => {
+        // Optional: jsdom has no scrolling at all, and a pane that cannot
+        // scroll needs none.
+        asked.current?.scrollIntoView?.({ block: "nearest", inline: "nearest" });
+    }, [parameter?.name]);
+    if (!parameter)
+        return null;
+    /*
+     * An OPTIONAL argument may be passed over. A skipped one is answered
+     * `undefined` here so the walk moves on, and left out of what is applied,
+     * so the mutation sees only what was actually said. Skipping every one
+     * of them is allowed: the mutation's own refusal then says what it
+     * needed, on the button, which is the honest answer to an empty change.
+     */
+    const answer = (value) => {
+        const next = { ...answers, [parameter.name]: value };
+        const outstanding = affordance.open.filter((other) => !(other.name in next));
+        if (outstanding.length === 0) {
+            onApply(Object.fromEntries(Object.entries(next).filter(([, given]) => given !== undefined)));
+        }
+        else
+            setAnswers(next);
+    };
+    const skip = parameter.optional ? (_jsx("button", { type: "button", onClick: () => answer(undefined), style: { fontSize: "0.8125rem" }, children: "Skip" })) : null;
+    const shape = parameter.shape ?? { type: "unknown" };
+    const choices = choicesFor(parameter, shape);
+    /*
+     * A PICKER THAT DROPS CHOICES MAKES THE ACT IMPOSSIBLE, AND SAYS NOTHING.
+     *
+     * This listed the first ten and stopped. A property with twenty-two
+     * practices on it offered ten of them under "Name something that helps",
+     * and the other twelve could not be chosen at all — not behind a control,
+     * not summarised as "+12", simply absent, with the panel looking exactly
+     * as it would if ten were all there were.
+     *
+     * Ten is still the right number to SHOW; a wall of forty chips is its own
+     * kind of unusable. What was missing is the way through — a filter, and a
+     * count of what is not on screen. Neither is a new idea here: the strip
+     * has had both since it was written. It just never reached the ask.
+     */
+    const [among, setAmong] = useState("");
+    /* Two candidates with one name are told apart by what differs (see `tellApart`). */
+    const apart = useMemo(() => {
+        const nodes = choices.map((choice) => store.graph.getNode(choice)).filter((node) => node !== undefined);
+        return tellApart(nodes, (kind) => store.schema.tryDefinition(kind));
+    }, [choices, store]);
+    const say = (choice) => {
+        const words = said(store, shape, choice);
+        const told = apart.get(choice);
+        return told ? `${words} · ${told}` : words;
+    };
+    const matching = useMemo(() => {
+        const term = among.trim().toLowerCase();
+        if (term === "")
+            return choices;
+        return choices.filter((choice) => say(choice).toLowerCase().includes(term));
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [choices, among, store, shape, apart]);
+    /*
+     * AN ARGUMENT THAT TAKES A LIST IS ANSWERED WITH A LIST.
+     *
+     * "Invite somebody as coordinator and gardener" is one act with several
+     * roles in one argument. Answered one press at a time it would be one
+     * role, silently — so the presses TOGGLE and a separate one settles the
+     * question. Nothing else about the walk changes: it is still one
+     * parameter, still skippable when optional, still applied when the last
+     * outstanding one is answered.
+     */
+    const several = shape.type === "several";
+    /*
+     * THE ASK SAYS WHAT IT IS ASKING, IN WORDS.
+     *
+     * The text branch has said so since W-004 — the input's own label and
+     * placeholder are the question. The CHOICES branch said nothing at all: an
+     * act with one node reference to fill put two bare buttons on the strip
+     * ("Ana", "Bo") under no heading, so what was being asked was a guess for
+     * anyone looking and unsaid entirely for anyone listening. And where a
+     * step counter did name the parameter it used the declaration's
+     * IDENTIFIER — "dependsOn · 1 of 2" — which is the same bug W-004 fixed
+     * one element lower down.
+     */
+    /*
+     * A NODE PICKER IS NAMED BY WHAT IT PICKS — "Item", not "Id".
+     *
+     * The routed face has said so since it was written ("the argument's name
+     * is an implementation detail, and the kinds it accepts are the
+     * declaration's own word for the thing" — `formFields` in
+     * `@graview/pages`), and the strip asked with the argument's identifier.
+     * Every scaffolded app names its subject argument `id`, as the skills'
+     * own examples do, so an act offered from the FAR END of its tie — "Hand
+     * one back", standing on the person — put the word "Id" over a list of
+     * items.
+     */
+    const asking = parameter.kinds && parameter.kinds.length > 0 && !parameter.kinds.includes("*")
+        ? parameter.kinds.map((kind) => humaniseField(nounOf(store.schema.tryDefinition(kind), kind))).join(" or ")
+        : humaniseField(parameter.name);
+    const step = affordance.open.length > 1
+        ? `${asking} · ${affordance.open.length - remaining.length + 1} of ${affordance.open.length}`
+        : asking;
+    return (_jsxs("div", { ref: asked, "data-graview-asking": affordance.id, style: {
+            display: "grid",
+            /*
+             * THE ASK FITS THE PANE IT OPENS IN.
+             *
+             * An auto track takes the min-content width of what is in it, and a
+             * text input's is its own default size — so a field, an Apply and a
+             * Skip came to 257 inside a 236-wide rail, and the Skip was drawn
+             * past the pane's edge, half of it painted and none of it reachable
+             * without scrolling a pane that shows no scrollbar. `minmax(0, 1fr)`
+             * says the track may not be wider than the pane; the input already
+             * carries `minWidth: 0`, so it is the thing that gives.
+             */
+            gridTemplateColumns: "minmax(0, 1fr)",
+            gap: 4,
+            padding: "5px 0 2px",
+        }, children: [affordance.open.length > 1 || choices.length > 0 ? (_jsx("span", { id: promptId, style: { fontSize: "0.75rem", color: "var(--graview-ink-faint)" }, children: step })) : null, choices.length > SHOWN ? (_jsx("input", { type: "search", value: among, onChange: (event) => setAmong(event.target.value), placeholder: `Filter ${choices.length}…`, "aria-label": `Filter ${asking}`, "data-testid": "ask-filter", style: { font: "inherit", fontSize: "0.8125rem", minWidth: 0, padding: "3px 7px" } })) : null, choices.length > 0 ? (_jsxs("div", { role: "group", "aria-labelledby": promptId, style: { display: "flex", flexWrap: "wrap", gap: 4 }, children: [matching.slice(0, SHOWN).map((choice) => {
+                        const held = picked.includes(choice);
+                        return (_jsx("button", { type: "button", "aria-label": `${asking}: ${say(choice)}`, ...(several ? { "aria-pressed": held } : {}), style: {
+                                padding: "3px 9px",
+                                fontSize: "0.8125rem",
+                                ...(held
+                                    ? { borderColor: "var(--graview-accent)", color: "var(--graview-accent)" }
+                                    : {}),
+                            }, onClick: () => several
+                                ? setPicked((current) => current.includes(choice)
+                                    ? current.filter((other) => other !== choice)
+                                    : [...current, choice])
+                                : answer(shape.type === "boolean" ? choice === "yes" : choice), children: say(choice) }, choice));
+                    }), matching.length > SHOWN ? (_jsxs("span", { "data-testid": "ask-more", style: { alignSelf: "center", fontSize: "0.75rem", color: "var(--graview-ink-faint)" }, children: [matching.length - SHOWN, " more \u2014 type to narrow"] })) : null, matching.length === 0 ? (_jsxs("span", { "data-testid": "ask-none", style: { alignSelf: "center", fontSize: "0.75rem", color: "var(--graview-ink-faint)" }, children: ["None of the ", choices.length, " match that."] })) : null, several ? (_jsx("button", { type: "button", disabled: picked.length === 0, style: { fontSize: "0.8125rem" }, onClick: () => {
+                            const chosen = picked;
+                            setPicked(NOTHING_PICKED);
+                            answer(chosen);
+                        }, children: remaining.length > 1 ? "Next" : "Apply" })) : null, skip] })) : (_jsxs("form", { 
+                // And where even a shrunk field would leave no room to type, the
+                // buttons drop to a line of their own rather than squeezing it to
+                // nothing.
+                style: { display: "flex", flexWrap: "wrap", gap: 4 }, onSubmit: (event) => {
+                    event.preventDefault();
+                    if (draft.trim().length === 0)
+                        return;
+                    answer(shape.type === "number" ? Number(draft) : draft);
+                }, children: [_jsx("input", { autoFocus: true, type: shape.type === "date" ? (shape.time ? "datetime-local" : "date") : shape.type === "number" ? "number" : "text", "aria-label": humaniseField(parameter.name), placeholder: humaniseField(parameter.name), value: draft, ...(shape.type === "number" && shape.min !== undefined ? { min: shape.min } : {}), ...(shape.type === "number" && shape.max !== undefined ? { max: shape.max } : {}), onChange: (event) => setDraft(event.target.value), onKeyDown: (event) => {
+                            if (event.key === "Escape")
+                                onCancel();
+                        }, style: {
+                            flex: 1,
+                            minWidth: 0,
+                            font: "inherit",
+                            fontSize: "0.875rem",
+                            padding: "5px 8px",
+                            borderRadius: 7,
+                            border: "1px solid var(--graview-edge)",
+                            background: "var(--graview-panel)",
+                            color: "var(--graview-ink)",
+                        } }), _jsx("button", { type: "submit", disabled: draft.trim().length === 0, style: { fontSize: "0.8125rem" }, children: remaining.length > 1 ? "Next" : "Apply" }), skip] }))] }));
+}
+const NOTHING_PICKED = [];
+/** How many choices an ask shows at once. Past this it offers a filter. */
+export const SHOWN = 10;
+function choicesFor(parameter, shape) {
+    if (parameter.candidates && parameter.candidates.length > 0)
+        return parameter.candidates;
+    if (shape.type === "choice")
+        return shape.options;
+    // SEVERAL OF A CHOICE is the same list of buttons; what differs is that
+    // pressing one adds it rather than settling the question.
+    if (shape.type === "several" && shape.of.type === "choice")
+        return shape.of.options;
+    // Yes or no is a choice of two, and reads better as two buttons than as
+    // a text field somebody has to know to type "true" into.
+    if (shape.type === "boolean")
+        return YES_NO;
+    return [];
+}
+/** The two answers to a boolean, in the words a person would use. */
+const YES_NO = ["yes", "no"];
+/**
+ * How one possible answer reads.
+ *
+ * A node reference reads as the node's own label; anything else reads as
+ * itself. `nameOf` would look "yes" up as a node id, fail to find one, and
+ * show the id — which is right for nodes and nonsense for a boolean or an
+ * enum value.
+ */
+export function said(store, shape, choice) {
+    if (shape.type === "boolean" || shape.type === "choice")
+        return choice;
+    if (shape.type === "several" && shape.of.type === "choice")
+        return choice;
+    return nameOf(store, choice);
+}
+/** A node's own label where there is one, so a picker never offers raw ids. */
+export function nameOf(store, id) {
+    /*
+     * A selected KIND CARD names its kind, in the plural the declaration
+     * already carries — "Gardeners", never "kind:gardener". In an empty app
+     * the kind card is the first thing anyone selects, so the raw id here was
+     * the first string the interface ever showed them.
+     */
+    const edge = edgeOfSelection(id);
+    // A relation by its words ("Where they work"), never its name ("Works at").
+    if (edge)
+        return relationWords(store.schema, edge.kind).words;
+    const kinds = kindsOf(id);
+    if (kinds.length > 0) {
+        return kinds
+            .map((kind) => {
+            const definition = store.schema.tryDefinition(kind);
+            return definition?.plural ?? `${kind}s`;
+        })
+            .join(" + ");
+    }
+    const node = store.graph.getNode(id);
+    if (!node)
+        return id;
+    return labelOf(store.schema.tryDefinition(node.kind), node);
+}
+//# sourceMappingURL=answer-args.js.map

package/dist/workbench/answer-args.js.map

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

package/dist/workbench/back-out.d.ts

@@ -0,0 +1,71 @@
+import { type ViewState } from "@graview/layout";
+/**
+ * WHERE THE KEYBOARD GOES WHEN ESCAPE TAKES AWAY WHAT IT STOOD ON.
+ *
+ * Backing out of a record removes its card; the keyboard was on the card, or
+ * on the title renamed in it a moment ago, and fell to `<body>`. Chromium
+ * then tabs on from wherever the card was, into the zoom buttons, and WebKit
+ * from somewhere else again. The honest place is the card that still draws
+ * what was left — the district holding its chip — and failing that any card
+ * in the scene, so the next arrow or Enter still means the picture.
+ *
+ * Asked for a while rather than once, because a card leaving on a rise may
+ * fade out before it is removed; and only while the keyboard is still on
+ * nothing, so a person who moved it in the meantime keeps where they went.
+ */
+export declare function landTheKeyboard(stoodOn: HTMLElement, left: string | null, tries?: number): void;
+/**
+ * Escape backs out one level: leave the full page, then the Graview, then
+ * drop the selection, then the raised relation, then the focus. A spatial
+ * interface has to have a way out that does not require finding the right
+ * small × in a trail.
+ *
+ * THE OVERVIEW IS ONLY A RUNG WHEN IT IS SOMETHING YOU CLIMBED TO. An app
+ * that OPENS from altitude — which is what `graview create` writes, and what
+ * every app with no in-stack default does — is already home up there, and
+ * leaving it would be going further IN. It is also, until this was fixed, the
+ * state in which Escape did nothing at all: the provider lands a focusless
+ * descent back on the overview (deliberately, so the key is never a void),
+ * which means the rung neither moved nor fell through, and every rung below
+ * it — the selection, the moves, the raised relation — was unreachable from
+ * the first screen of every scaffolded app.
+ */
+export declare function BackOut({ home }: {
+    readonly home: string | null;
+}): null;
+/**
+ * The way out to the Graview, and back — one control, two directions.
+ *
+ * The framework's own name for the view of the whole thing, which is the
+ * right name: everything else here is a lens over part of the graph, and this
+ * is the graph. It is a TOGGLE and presents as one: labelled "Graview" from
+ * the ground (the place it takes you) and "Focus" from altitude (the way back
+ * down), with the pressed state saying the same thing to a screen reader.
+ *
+ * THE MARK MORPHS. The scene's own rising is a morph rather than a cut — the
+ * grid dissolves into the iso lattice, the districts grow out of their cards,
+ * all riding one registered number. The control sits beside the scene rather
+ * than inside it, so it carries its OWN copy of that number, transitioned on
+ * the same 640ms curve (`.graview-altitude-control` in the theme): the three
+ * kinds on their ring gather into one node inside one ring as the scene
+ * rises, and open back out as it lands. Where an engine cannot register the
+ * property the scene cuts, and so does the mark — the same mechanism, so they
+ * cannot disagree.
+ */
+/**
+ * Where "Focus" lands from altitude when nothing is focused.
+ *
+ * An app that opens from the city has no in-stack default, and the provider
+ * lands a focusless descent back on the overview — which made the control a
+ * button that did nothing, in every such app. Descending has to go
+ * SOMEWHERE: into the district that is selected, or the first one declared.
+ */
+/**
+ * WHERE "FOCUS" LANDS FROM ALTITUDE: the drive-in that is focused, else the
+ * selected kind's, else the first kind that has a drive-in — a kind with a
+ * picture of its own is a better place to walk up to than the first kind
+ * in the declaration — else the first kind at all.
+ */
+export declare function descentTarget(view: ViewState, kinds: readonly string[], driveIns?: readonly string[]): string | null;
+export declare function OverviewButton(): import("react").JSX.Element;
+//# sourceMappingURL=back-out.d.ts.map

package/dist/workbench/back-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"back-out.d.ts","sourceRoot":"","sources":["../../src/workbench/back-out.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EAEf,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,SAAK,GAAG,IAAI,CAmB3F;AAGD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,QAgEjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;;;GAOG;AACH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,GAAG,IAAI,CAKxH;AAED,wBAAgB,cAAc,gCAoH7B"}

package/dist/workbench/back-out.js

@@ -0,0 +1,238 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { aggregateId, kindOfCard, withFocus, withoutMoves, withOverview, withoutSearch, kindsOfAggregate, } from "@graview/layout";
+import { useGraview, useJackIn, useNavigation, useSelection } from "@graview/react";
+import { useEffect } from "react";
+/**
+ * WHERE THE KEYBOARD GOES WHEN ESCAPE TAKES AWAY WHAT IT STOOD ON.
+ *
+ * Backing out of a record removes its card; the keyboard was on the card, or
+ * on the title renamed in it a moment ago, and fell to `<body>`. Chromium
+ * then tabs on from wherever the card was, into the zoom buttons, and WebKit
+ * from somewhere else again. The honest place is the card that still draws
+ * what was left — the district holding its chip — and failing that any card
+ * in the scene, so the next arrow or Enter still means the picture.
+ *
+ * Asked for a while rather than once, because a card leaving on a rise may
+ * fade out before it is removed; and only while the keyboard is still on
+ * nothing, so a person who moved it in the meantime keeps where they went.
+ */
+export function landTheKeyboard(stoodOn, left, tries = 40) {
+    const attempt = (remaining) => {
+        const active = document.activeElement;
+        const onNothing = active === null || active === document.body || active === stoodOn;
+        if (!onNothing)
+            return;
+        if (stoodOn.isConnected) {
+            if (remaining > 0)
+                setTimeout(() => attempt(remaining - 1), 25);
+            return;
+        }
+        const escaped = left === null ? null : left.replace(/["\\]/g, "\\$&");
+        const target = (escaped === null
+            ? null
+            : (document.querySelector(`[data-graview-view="${escaped}"]`) ??
+                document.querySelector(`[data-graview-pick="${escaped}"]`)?.closest("[data-graview-view]"))) ??
+            document.querySelector("[data-graview-view][tabindex]");
+        target?.focus({ preventScroll: true });
+    };
+    attempt(tries);
+}
+/**
+ * Escape backs out one level: leave the full page, then the Graview, then
+ * drop the selection, then the raised relation, then the focus. A spatial
+ * interface has to have a way out that does not require finding the right
+ * small × in a trail.
+ *
+ * THE OVERVIEW IS ONLY A RUNG WHEN IT IS SOMETHING YOU CLIMBED TO. An app
+ * that OPENS from altitude — which is what `graview create` writes, and what
+ * every app with no in-stack default does — is already home up there, and
+ * leaving it would be going further IN. It is also, until this was fixed, the
+ * state in which Escape did nothing at all: the provider lands a focusless
+ * descent back on the overview (deliberately, so the key is never a void),
+ * which means the rung neither moved nor fell through, and every rung below
+ * it — the selection, the moves, the raised relation — was unreachable from
+ * the first screen of every scaffolded app.
+ */
+export function BackOut({ home }) {
+    const { view, focus, show, go } = useNavigation();
+    const { homeView } = useGraview();
+    const { selection, clear } = useSelection();
+    const { isJackedIn, exit } = useJackIn();
+    // Up here on purpose, with somewhere below to land: only then is rising
+    // something Escape can undo.
+    const overview = (view.overview ?? false) && homeView.overview !== true;
+    useEffect(() => {
+        const onKey = (event) => {
+            if (event.key !== "Escape")
+                return;
+            // Never steal Escape from a field someone is typing in.
+            const active = document.activeElement;
+            if (active instanceof HTMLInputElement || active instanceof HTMLTextAreaElement)
+                return;
+            /*
+             * A POPOVER IS THE OUTERMOST RUNG, and it climbs down by itself.
+             *
+             * The activity rail, the problems list and the chat each close on
+             * Escape with a listener of their own — and this one ran too, so one
+             * press closed the rail AND dropped the selection under it (or, on
+             * the ground, backed out of the focus). Whatever is open over the
+             * scene owns the press; the ladder takes the next one.
+             *
+             * Asked in the CAPTURE phase, because the popover's own listener sits
+             * on the document, runs first in the bubble, and React commits its
+             * closing in the microtask between listeners — by the time a bubble
+             * listener on the window looked, the popover was already gone.
+             */
+            // A pane kept in the tree but hidden — the profile, shut — is not open over anything.
+            if (document.querySelector("[data-graview-overlay]:not([hidden])"))
+                return;
+            // The keyboard, if it is on the picture: the rung may take its card away.
+            const stoodOn = active instanceof HTMLElement && active.closest("[data-graview-view]") !== null ? active : null;
+            if (stoodOn)
+                landTheKeyboard(stoodOn, view.focusId ?? null);
+            /*
+             * Outermost first, and the full page is the outermost thing there is.
+             *
+             * It is a modal dialog covering everything, and Escape did not close it
+             * — the first press dropped the selection underneath it instead, which
+             * from inside the page looked like Escape doing nothing at all. A modal
+             * that cannot be dismissed from the keyboard is a trap; the only way
+             * out was the button.
+             */
+            if (isJackedIn)
+                exit();
+            // A search lights the whole picture, so it comes off first, and the
+            // emphasis goes back to what the selection reaches.
+            else if (view.q)
+                go(withoutSearch(view));
+            // Then the Graview: rising is the biggest change of place Escape can
+            // undo, and it should not also drop a selection on the way past.
+            else if (overview)
+                go(withOverview(view, false));
+            else if (selection.length > 0)
+                clear();
+            // A move is an adjustment of where you are, so it comes off before the
+            // things that decide where you are.
+            else if (view.pan !== undefined || Object.keys(view.pins).length > 0) {
+                go(withoutMoves(view));
+            }
+            else if (view.relation)
+                show(null);
+            else if (view.focusId !== home)
+                focus(home);
+        };
+        window.addEventListener("keydown", onKey, true);
+        return () => window.removeEventListener("keydown", onKey, true);
+    }, [view, focus, show, go, selection, clear, home, overview, isJackedIn, exit]);
+    return null;
+}
+/**
+ * The way out to the Graview, and back — one control, two directions.
+ *
+ * The framework's own name for the view of the whole thing, which is the
+ * right name: everything else here is a lens over part of the graph, and this
+ * is the graph. It is a TOGGLE and presents as one: labelled "Graview" from
+ * the ground (the place it takes you) and "Focus" from altitude (the way back
+ * down), with the pressed state saying the same thing to a screen reader.
+ *
+ * THE MARK MORPHS. The scene's own rising is a morph rather than a cut — the
+ * grid dissolves into the iso lattice, the districts grow out of their cards,
+ * all riding one registered number. The control sits beside the scene rather
+ * than inside it, so it carries its OWN copy of that number, transitioned on
+ * the same 640ms curve (`.graview-altitude-control` in the theme): the three
+ * kinds on their ring gather into one node inside one ring as the scene
+ * rises, and open back out as it lands. Where an engine cannot register the
+ * property the scene cuts, and so does the mark — the same mechanism, so they
+ * cannot disagree.
+ */
+/**
+ * Where "Focus" lands from altitude when nothing is focused.
+ *
+ * An app that opens from the city has no in-stack default, and the provider
+ * lands a focusless descent back on the overview — which made the control a
+ * button that did nothing, in every such app. Descending has to go
+ * SOMEWHERE: into the district that is selected, or the first one declared.
+ */
+/**
+ * WHERE "FOCUS" LANDS FROM ALTITUDE: the drive-in that is focused, else the
+ * selected kind's, else the first kind that has a drive-in — a kind with a
+ * picture of its own is a better place to walk up to than the first kind
+ * in the declaration — else the first kind at all.
+ */
+export function descentTarget(view, kinds, driveIns = []) {
+    if (view.focusId)
+        return view.focusId;
+    const selected = (view.selection ?? []).map(kindOfCard).find((kind) => kind !== null);
+    const kind = selected ?? driveIns.find((one) => kinds.includes(one)) ?? kinds[0] ?? null;
+    return kind === null ? null : aggregateId(kind);
+}
+export function OverviewButton() {
+    const { view, go } = useNavigation();
+    const { store, views, hiddenKinds } = useGraview();
+    const overview = view.overview ?? false;
+    const driveIns = views.places().map((place) => place.kind).filter((kind) => !hiddenKinds.has(kind));
+    const target = descentTarget(view, store.schema.kinds, driveIns);
+    const descend = () => {
+        go(withFocus(withOverview(view, false), target));
+    };
+    /*
+     * UP AND DOWN. "Graview" and "Focus" said neither: a person meeting the
+     * control for the first time had to press it to learn what it did. Up is
+     * up; down says where you land — the place whose picture is showing, or
+     * the district the focus names, in its own words.
+     */
+    const landing = (() => {
+        if (!target)
+            return null;
+        const kind = kindsOfAggregate(target)[0];
+        // The showing that is showing, else the kind's first place.
+        const showing = view.within?.["view"];
+        const place = (showing ? views.places().find((one) => one.as === showing) : undefined) ??
+            (kind ? views.places().find((one) => one.kind === kind) : undefined);
+        if (place)
+            return place.title;
+        if (kind)
+            return store.schema.tryDefinition(kind)?.plural ?? kind;
+        return store.graph.getNode(target)?.label ?? null;
+    })();
+    const label = overview ? (landing ? `Down to ${landing}` : "Down") : "Up";
+    return (_jsxs("button", { type: "button", "data-testid": "overview", className: "graview-altitude-control", "aria-pressed": overview, "aria-label": label, title: overview ? `${label} — back down into the view` : "Up — the whole thing, from outside", 
+        // A view state, so it is a URL, the back button works, and the cards
+        // already on screen fly out into the ring rather than being replaced.
+        onClick: () => (overview ? descend() : go(withOverview(view, true))), 
+        /*
+         * SCENE FURNITURE, in the scene's corner — the way a map carries its
+         * own altitude control.
+         *
+         * It has lived in two wrong places: floating over the scene as a
+         * labelled pill ("awkwardly slammed on top", twice), and then in the
+         * command bar, where it spent prime chrome on a control that is about
+         * the CANVAS, not the app. The bar is for what the app is; rising and
+         * descending is something you do to the picture, so the control sits
+         * on the picture — quiet, in the one corner every state leaves empty.
+         */
+        style: {
+            position: "absolute",
+            top: 14,
+            right: 14,
+            zIndex: 5,
+            display: "inline-flex",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 7,
+            height: 38,
+            padding: "0 13px 0 11px",
+            borderRadius: 999,
+            fontSize: "0.875rem",
+            whiteSpace: "nowrap",
+            background: "var(--graview-float)",
+            boxShadow: "var(--graview-lift-low)",
+            // The number the mark rides. Inline, like the ground's own, so the
+            // theme's transition on the class carries it between the two.
+            ["--graview-altitude"]: overview ? 1 : 0,
+            ...(overview
+                ? { borderColor: "var(--graview-accent)", color: "var(--graview-accent)" }
+                : {}),
+        }, children: [_jsxs("svg", { className: "graview-altitude-mark", width: "16", height: "16", viewBox: "0 0 12 12", "aria-hidden": "true", children: [_jsx("ellipse", { className: "graview-altitude-mark-ring", cx: "6", cy: "6.6", rx: "5", ry: "2.6", fill: "none", stroke: "currentColor", strokeWidth: "0.9" }), _jsx("circle", { className: "graview-altitude-mark-apex", cx: "6", cy: "4", r: "1.5", fill: "currentColor" }), _jsx("circle", { className: "graview-altitude-mark-wing", "data-side": "left", cx: "1.6", cy: "7.4", r: "1.2", fill: "currentColor" }), _jsx("circle", { className: "graview-altitude-mark-wing", "data-side": "right", cx: "10.4", cy: "7.4", r: "1.2", fill: "currentColor" })] }), _jsx("span", { className: "graview-altitude-label", children: label })] }));
+}
+//# sourceMappingURL=back-out.js.map