@graview/primitives 0.1.65 → 0.1.67

package/dist/section-better.js

@@ -1,17 +1,18 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { layer } from "@graview/core";
-import { compareViewRevision } from "@graview/core/revisions";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { labelOf, layer } from "@graview/core";
+import { compareViewRevision, sectionsOfDrawing } from "@graview/core/revisions";
 import { useGraview } from "@graview/react/provider";
 import { sectionUnderNow, viewPlaceOf } from "@graview/react/drawing";
-import { reviseSection } from "@graview/tools/section";
+import { CONTROL_WORDS, describeChange, drawnFindings, lookOf, lostUnlessReworded, runDesignAgent } from "@graview/tools/section";
 import { interactionId } from "@graview/tools/inline-ai";
 import { retryingImport } from "@graview/core/retry";
 import { lazyModule } from "@graview/react/provider";
 import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
 import { boxOf, SectionOutline } from "./section-outline.js";
+import { headingsOf, readDrawn, recordLabelsOf, Redesigning } from "./better-bar.js";
+import { BetterPanel } from "./better-panel.js";
 export { SectionOutline };
-import { nameParts, partLines, placeOfSection } from "./section-words.js";
-import { VISUALLY_HIDDEN } from "./primitives/measure.js";
+import { aboutOf, nameParts, partLines, placeOfSection } from "./section-words.js";
 /*
  * WHAT WAS TOLD (Roadmap f-menu-learns): each revision offered is kept as a
  * telling — the words, the view's section it was said on, the slot that
@@ -23,10 +24,15 @@ const toldCard = /* @__PURE__ */ lazyModule(retryingImport(() => import("./told-
 const Rate = /* @__PURE__ */ toldCard.part((module, props) => _jsx(module.RateTelling, { ...props }), { quiet: true });
 import "./frame.js"; // A door: tied to what the page drew first (TIED DOORS, packages/primitives/src/frame.ts).
 export function SectionDrawn({ ask, open, close }) {
-    if (ask)
+    if (ask?.part)
+        return _jsx(PageCard, { ask: ask, close: close }, ask.at);
+    if (ask?.section)
         return _jsx(SectionCard, { ask: ask, close: close }, ask.at);
     return open ? _jsx(SectionOutline, { elements: open }) : null;
 }
+/* A built-in page's card (Roadmap f-make-any-page-better), fetched the first time it is asked for. */
+const pageCard = /* @__PURE__ */ lazyModule(retryingImport(() => import("./page-better.js")));
+const PageCard = /* @__PURE__ */ pageCard.part((module, props) => _jsx(module.PageCard, { ...props }), { what: "Make this better" });
 const WIDTH = 360;
 const GAP = 12;
 /** The card's place: beside the box where the window has room, else under it, else over it. */
@@ -97,36 +103,59 @@ function partsIn(root, rect, point) {
     }
     return outermost;
 }
-/** The words of a revision's findings that keep it from being offered, and the notes said with it. */
-function judged(handle, before, live, liveRefused, draft, source) {
-    const after = draft.drawing();
-    const revision = compareViewRevision({ source: before, css: live.css, ...(live.root ? { drawing: live.root } : {}), ...(live.height !== undefined ? { height: live.height } : {}) }, { source, css: after.css, ...(after.root ? { drawing: after.root } : {}), ...(after.height !== undefined ? { height: after.height } : {}) });
+/**
+ * WHAT A REVISION OF A VIEW BROKE IN ITS DRAWING: a class still drawn that
+ * lost every rule styling it, and a part drawn before and not now. A part
+ * is found by where it stands, not by its words (Roadmap
+ * f-better-ui-draws-first-time): one whose heading was reworded in place
+ * is the same part, and is the person's to reword where they asked it of
+ * the part being changed (`mayReword`, its headings).
+ */
+export function drawingFindings(before, after, options = {}) {
+    const side = (one) => ({ source: one.source, css: one.css, ...(one.root ? { drawing: one.root } : {}), ...(one.height !== undefined ? { height: one.height } : {}) });
+    const revision = compareViewRevision(side(before), side(after));
     const findings = [];
     for (const one of revision.unstyled)
         findings.push(`The class “${one.class}” is still drawn and no rule styles it now.`);
-    for (const one of revision.sectionsMissing)
-        findings.push(`“${one.name}” is not drawn any more.`);
+    const names = (one) => (one.root ? sectionsOfDrawing(one.root).map((section) => section.name) : []);
+    const missing = before.root && after.root ? lostUnlessReworded(revision.sectionsMissing.map((one) => one.name), names(before), names(after), options) : revision.sectionsMissing.map((one) => one.name);
+    for (const name of missing)
+        findings.push(`“${name}” is not drawn any more.`);
+    return findings;
+}
+/** The words of a revision's findings that keep it from being offered. */
+function judged(before, live, liveRefused, draft, source, options) {
+    const after = draft.drawing();
+    const findings = drawingFindings({ source: before, css: live.css, root: live.root, height: live.height }, { source, css: after.css, root: after.root, height: after.height }, options);
     for (const refused of draft.refused())
         if (!liveRefused.includes(refused))
             findings.push(refused);
-    const notes = [];
-    const height = revision.height;
-    if (height && Math.abs(height.ratio) >= 0.1)
-        notes.push(`The view is ${Math.abs(Math.round(height.change))} px ${height.change > 0 ? "taller" : "shorter"} (${Math.round(height.before)} → ${Math.round(height.after)}).`);
-    void handle;
-    return { findings, notes };
+    return findings;
 }
 export function SectionCard({ ask, close }) {
-    const { ai, aiDesk, principal, keptViews } = useGraview();
+    const { ai, aiDesk, aiHere, session, principal, keptViews, store } = useGraview();
     const [section, setSection] = useState(ask.section);
     const place = placeOfSection(ask.section);
     const handle = useRef(viewPlaceOf(place));
     const draft = useRef(null);
-    const card = useRef(null);
-    const field = useRef(null);
-    const [phase, setPhase] = useState(ask.mode === "highlight" ? { at: "highlighting" } : ask.mode === "describe" ? { at: "asking" } : { at: "working" });
-    const [words, setWords] = useState("");
+    const [phase, setPhase] = useState(ask.mode === "highlight" ? { at: "highlighting" } : { at: "open" });
+    /* The view's code before any step, the page as it was read, the drafts that passed, the conversation and this turn's steps. */
     const original = useRef(undefined);
+    const before = useRef(null);
+    /* The headings of the part being changed, read where it stood before any step: the ones a person may ask to reword. */
+    const partHeadings = useRef(null);
+    const steps = useRef([]);
+    const talk = useRef([]);
+    const events = useRef([]);
+    const since = useRef(Date.now());
+    const stopping = useRef(null);
+    const pointedAt = useRef(null);
+    /** What the conversation is about, where the person pointed at a part of the section. */
+    const aboutNow = useRef(null);
+    const [covering, setCovering] = useState(false);
+    const [comparing, setComparing] = useState(false);
+    const [, setTick] = useState(0);
+    const redraw = useCallback(() => setTick((one) => one + 1), []);
     /* The telling of the revision on offer, kept with the host's door (`ai.told`), and how it ended. */
     const [telling, setTelling] = useState(null);
     const tellingNow = useRef(null);
@@ -135,23 +164,32 @@ export function SectionCard({ ask, close }) {
         if (now && ai.told)
             void toldCard.load().then((module) => module.changeTelling(ai.told, now.id, { outcome }), () => undefined);
     }, [ai.told]);
-    /** Keeps what was said and decided as a telling: offered as a draft ("previewed"), or refused. */
+    /** Keeps what was said and decided as a telling: offered as a draft ("previewed"), or not. */
     const tell = useCallback((words, on, refused, stages, ms, interaction) => {
         const keeps = ai.told;
         if (!keeps)
             return;
-        const slot = stages.at(-1)?.stage === "thinking" ? "full" : stages.length > 0 ? "light" : undefined;
         void toldCard.load().then((module) => {
-            const kept = module.keepTelling(keeps, { words, target: { on: "place", place: on.view }, decided: refused ? { type: "refusal" } : { type: "view", section: on.name }, ...(slot ? { slot } : {}), stages: stages.map((one) => ({ stage: one.stage === "thinking" ? "full" : "light", ms: one.ms, model: one.model })), ms, outcome: refused ? "abandoned" : "previewed", interaction }, principal);
+            const kept = module.keepTelling(keeps, { words, target: { on: "place", place: on.view }, decided: refused ? { type: "refusal" } : { type: "view", section: on.name }, slot: "full", stages: stages.map((one) => ({ stage: one.stage === "thinking" ? "full" : "light", ms: one.ms, model: one.model })), ms, outcome: refused ? "abandoned" : "previewed", interaction }, principal);
             tellingNow.current = kept ?? null;
             setTelling(kept ?? null);
         }, () => undefined);
     }, [ai.told, principal]);
     /* Put away: a draft not kept goes with the card, and the view stands as it was. */
     useEffect(() => () => {
+        stopping.current?.abort();
         draft.current?.dispose();
         draft.current = null;
     }, []);
+    /* GRAVIEW IS HERE WHILE IT WORKS, as it is beside the quick ask. */
+    const working = phase.at === "working";
+    useEffect(() => {
+        if (!working)
+            return;
+        aiHere({ participant: `agent:graview-for-${principal.id ?? "anyone"}:${session}`, kind: "agent", name: "Graview", ...(principal.id ? { onBehalfOf: principal.id } : {}), over: null, robot: { at: null, mode: "thinking" } });
+        return () => aiHere(null);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [working]);
     const entryOf = useCallback((said, outcome, stages, extra = {}) => ({
         id: interactionId(),
         at: new Date().toISOString(),
@@ -165,95 +203,221 @@ export function SectionCard({ ask, close }) {
         usage: stages.flatMap((one) => (one.usage ? [{ tier: one.stage === "light" ? "fast" : "thinking", model: one.model, inputTokens: one.usage.inputTokens, outputTokens: one.usage.outputTokens }] : [])),
         ...extra,
     }), [principal, section.view]);
-    /** Revise the section: asked, composed whole, judged as a draft in the view's place, offered or refused. */
-    const revise = useCallback(async (mode, said, pointed, on = section) => {
+    /** The draft drawn in the view's place: the code given, drawn again. */
+    const drawDraft = useCallback(async (source) => {
+        draft.current?.dispose();
         const view = handle.current;
-        const asked = mode === "just" ? `Make “${on.name}” better` : `Make “${on.name}” better: ${said}`;
-        if (!view)
-            return setPhase({ at: "refused", said: "This view is not drawn here any more." });
-        setPhase({ at: "working", ...(pointed ? { pointed } : {}) });
-        const before = await view.source();
-        if (before === undefined)
-            return setPhase({ at: "refused", said: "This view is a whole worker script, and only a plain script's section can be revised here." });
-        original.current ??= before;
-        const started = Date.now();
-        const live = view.drawing();
+        const drawn = view.draft(source);
+        draft.current = drawn;
+        await drawn.drawn;
+        return drawn;
+    }, []);
+    /** The view as the person last saw it: the newest draft that passed, or the view as it was. */
+    const showLatest = useCallback(async () => {
+        const latest = steps.current.at(-1);
+        setComparing(false);
+        if (latest)
+            await drawDraft(latest.source);
+        else {
+            draft.current?.dispose();
+            draft.current = null;
+        }
+    }, [drawDraft]);
+    const say = useCallback((who, words) => {
+        talk.current.push({ who, said: words });
+        redraw();
+    }, [redraw]);
+    const askedWords = () => talk.current.filter((one) => one.who === "person").map((one) => one.said).join(" ");
+    /** One turn of the agent on the section: it looks, drafts the whole script with the section changed, is told what the checks found, and drafts again. */
+    const askFor = useCallback(async (words) => {
+        const view = handle.current;
+        if (!view || phase.at === "working")
+            return;
+        const pointed = pointedAt.current;
+        pointedAt.current = null;
+        // The person's words as they typed them: what they are about is said beside them, never glued on.
+        if (pointed)
+            aboutNow.current = pointed;
+        say("person", words);
+        events.current = [];
+        since.current = Date.now();
+        setPhase({ at: "working" });
+        const live = await view.source();
+        if (live === undefined) {
+            say("graview", "This view can't be changed here.");
+            return setPhase({ at: "open" });
+        }
+        original.current ??= live;
+        const liveDrawing = view.drawing();
         const liveRefused = view.refused();
-        const theme = await view.theme().catch(() => ({}));
-        const result = await reviseSection({
+        // Each record by the name its kind gives it, or its link's own words: never a card's words run together.
+        const named = (id) => {
+            const node = store.graph.getNode(id);
+            return node ? labelOf(store.schema.tryDefinition(node.kind), node) : undefined;
+        };
+        before.current ??= readDrawn(liveDrawing.root?.parentElement ?? liveDrawing.root ?? place, recordLabelsOf(liveDrawing.root, named));
+        partHeadings.current ??= headingsOf(section.elements);
+        const was = before.current;
+        const mayReword = partHeadings.current;
+        const stop = new AbortController();
+        stopping.current = stop;
+        const started = Date.now();
+        const turnBegan = steps.current.length;
+        const result = await runDesignAgent({
             ai,
-            source: before,
-            section: on.name,
-            mode,
-            ...(said ? { words: said } : {}),
-            ...(pointed ? { highlighted: [pointed.name, ...pointed.lines] } : {}),
-            theme,
-            shows: shownBy(on.elements),
-            judge: async (source) => {
-                draft.current?.dispose();
-                draft.current = null;
-                const refused = await view.check(source);
-                if (refused.length > 0)
-                    return refused;
-                const drawn = view.draft(source);
-                draft.current = drawn;
-                const { failed } = await drawn.drawn;
-                if (failed)
-                    return [`The view did not draw: ${failed}`];
-                await new Promise((settled) => requestAnimationFrame(() => requestAnimationFrame(settled)));
-                return judged(view, before, live, liveRefused, drawn, source).findings;
+            part: { name: section.name, slot: "place" },
+            manifest: { name: view.name, attach: "view", cardinality: "many" },
+            talk: talk.current,
+            keep: { title: "", headings: was.headings, records: was.records.map((one) => one.label), says: Object.fromEntries(was.records.flatMap((one) => (one.facts?.length || one.under ? [[one.label, { ...(one.facts?.length ? { shows: one.facts } : {}), ...(one.under ? { under: one.under } : {}) }]] : []))) },
+            current: steps.current.at(-1)?.source ?? live,
+            section: section.name,
+            rewordable: mayReword,
+            noun: "records",
+            ...(aboutNow.current ? { about: aboutNow.current } : {}),
+            host: {
+                look: () => lookOf(readDrawn(view.drawing().root?.parentElement ?? place, was.records.map((one) => one.label))),
+                read: () => ({ shows: shownBy(section.elements) }),
+                draft: async (source) => {
+                    setCovering(true);
+                    try {
+                        const refused = await view.check(source);
+                        if (refused.length > 0) {
+                            await showLatest();
+                            return { findings: refused, drew: undefined };
+                        }
+                        const drawn = await drawDraft(source);
+                        const { failed } = await drawn.drawn;
+                        if (failed) {
+                            await showLatest();
+                            return { findings: [`The view did not draw: ${failed}`], drew: undefined };
+                        }
+                        await new Promise((settled) => requestAnimationFrame(() => requestAnimationFrame(settled)));
+                        const root = drawn.drawing().root;
+                        const now = readDrawn(root?.parentElement ?? root, was.records.map((one) => one.label));
+                        // And every control it draws pressed, headless and nothing applied: one that does nothing, throws or is refused goes back to the agent.
+                        const pressed = view.presses ? await view.presses(source).catch(() => undefined) : undefined;
+                        const asked = { asked: askedWords(), mayReword };
+                        const findings = [...judged(original.current, liveDrawing, liveRefused, drawn, source, asked), ...drawnFindings(was, now, asked), ...(pressed?.problems ?? []).slice(0, 5).map((one) => `${one.control}: ${one.says}`)];
+                        if (findings.length > 0)
+                            await showLatest();
+                        else {
+                            steps.current.push({ source, said: describeChange(section.name, was, now) ?? `“${section.name}” has changed. Compare Before and After.`, entry: entryOf(`Make “${section.name}” better: ${askedWords()}`, "offered", []) });
+                            setComparing(false);
+                        }
+                        return { findings, drew: lookOf(now) };
+                    }
+                    finally {
+                        setCovering(false);
+                    }
+                },
+            },
+            onEvent: (event) => {
+                // The words as the model writes them stand in for the step it is on, and give way to the step once it is said.
+                if (events.current.at(-1)?.kind === "streaming")
+                    events.current.pop();
+                events.current.push(event);
+                redraw();
             },
+            signal: stop.signal,
         });
-        if (!result.ok) {
-            draft.current?.dispose();
-            draft.current = null;
-            const failed = entryOf(asked, "failed", result.stages, { failed: result.refused });
-            aiDesk.record(failed);
-            tell(said || asked, on, true, result.stages, Date.now() - started, failed.id);
-            return setPhase({ at: "refused", said: result.refused });
-        }
-        const notes = draft.current ? judged(view, before, live, liveRefused, draft.current, result.source).notes : [];
-        const entry = entryOf(asked, "offered", result.stages);
-        tell(said || asked, on, false, result.stages, Date.now() - started, entry.id);
-        setPhase({ at: "draft", source: result.source, said: result.said, notes: result.repaired ? ["Repaired once after the first try broke the view.", ...notes] : notes, entry });
-    }, [ai, aiDesk, entryOf, section, tell]);
-    /* Just do it: at once. */
+        if (stopping.current !== stop)
+            return;
+        stopping.current = null;
+        if (events.current.at(-1)?.kind === "streaming")
+            events.current.pop();
+        const offered = steps.current.length > turnBegan;
+        const entry = entryOf(`Make “${section.name}” better: ${askedWords()}`, offered ? "offered" : "failed", result.stages, offered ? {} : { failed: result.last?.findings.join(" ") ?? result.said });
+        aiDesk.record(entry);
+        tell(askedWords(), section, !offered, result.stages, Date.now() - started, entry.id);
+        // What a control does is the press check's to say, never the model's.
+        say("graview", result.passed && CONTROL_WORDS.test(result.said) ? "Here it is on the page." : result.said);
+        // Two drafts failed the same way: the person chooses — keep the last one anyway, where it drew, or stop.
+        if (result.ended === "stuck" && !offered)
+            return setPhase({ at: "stuck", ...(result.keepable && result.last ? { source: result.last.source } : {}) });
+        setPhase(steps.current.length > 0 ? { at: "draft" } : { at: "open" });
+    }, [ai, aiDesk, drawDraft, entryOf, phase.at, place, redraw, say, section, showLatest, store, tell]);
+    /** Stop: at once — the turn's drafts gone, the view as it was before it began. */
+    const stopTurn = useCallback(() => {
+        if (phase.at !== "working")
+            return;
+        const stop = stopping.current;
+        stopping.current = null;
+        stop?.abort();
+        setCovering(false);
+        const began = new Date(since.current).toISOString();
+        steps.current = steps.current.filter((one) => one.entry.at < began);
+        void showLatest();
+        say("graview", "Stopped. The view is as it was.");
+        setPhase(steps.current.length > 0 ? { at: "draft" } : { at: "open" });
+    }, [phase.at, say, showLatest]);
+    /* Words that came with the ask — typed in the menu, or a suggestion taken — are asked at once. */
     const began = useRef(false);
     useEffect(() => {
-        if (ask.mode !== "just" || began.current)
+        if (began.current || !(ask.mode === "just" || (ask.mode === "describe" && ask.words)))
             return;
         began.current = true;
-        void revise("just", "");
-    }, [ask.mode, revise]);
-    const keep = useCallback(async () => {
-        if (phase.at !== "draft" || !keptViews?.revise || !handle.current)
+        void askFor(ask.mode === "just" ? "Make it easier to read at a glance" : ask.words);
+    }, [ask.mode, ask.words, askFor]);
+    const current = steps.current.at(-1);
+    const compare = useCallback(async (originalShown) => {
+        if (!current || originalShown === comparing)
+            return;
+        setComparing(originalShown);
+        if (originalShown) {
+            draft.current?.dispose();
+            draft.current = null;
+        }
+        else
+            await drawDraft(current.source);
+    }, [current, comparing, drawDraft]);
+    const keep = useCallback(async (anyway) => {
+        // Kept anyway: the last draft of a turn that failed the same way twice, as the person chose.
+        if (anyway !== undefined && phase.at === "stuck")
+            steps.current.push({ source: anyway, said: `“${section.name}” kept as it was last drafted.`, entry: entryOf(`Make “${section.name}” better: ${askedWords()}`, "offered", []) });
+        const latest = steps.current.at(-1);
+        if ((phase.at !== "draft" && !(anyway !== undefined && phase.at === "stuck")) || !latest || !keptViews?.revise || !handle.current)
             return;
         const view = handle.current;
-        const before = (await view.source()) ?? "";
-        setPhase({ at: "keeping", source: phase.source, entry: phase.entry });
+        const was = (await view.source()) ?? "";
+        setPhase({ at: "keeping" });
         try {
-            const answer = await keptViews.revise({ name: view.name, title: view.title, source: phase.source, before, section: section.name, said: phase.said });
+            const answer = await keptViews.revise({ name: view.name, title: view.title, source: latest.source, before: was, section: section.name, said: latest.said });
             draft.current?.dispose();
             draft.current = null;
-            view.draw(phase.source);
-            const entry = { ...phase.entry, outcome: "accepted" };
-            aiDesk.record(entry);
+            view.draw(latest.source);
+            aiDesk.record({ ...latest.entry, outcome: "accepted" });
             ended("accepted");
-            setPhase({ at: "kept", source: before, ...(answer && answer.note ? { note: answer.note } : {}), answer, entry });
+            steps.current = [];
+            setPhase({ at: "kept", source: was, ...(answer && answer.note ? { note: answer.note } : {}), answer, entry: latest.entry });
         }
-        catch (error) {
-            setPhase({ at: "refused", said: error instanceof Error ? error.message : "The host did not keep it." });
+        catch {
+            say("graview", "It couldn't be kept.");
+            if (anyway !== undefined) {
+                steps.current.pop();
+                return setPhase(steps.current.length > 0 ? { at: "draft" } : { at: "open" });
+            }
+            setPhase({ at: "draft" });
         }
-    }, [phase, keptViews, aiDesk, section.name, ended]);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [phase, keptViews, aiDesk, section.name, ended, say, entryOf]);
+    /** Stop, where two drafts failed the same way: nothing kept, the view as it was. */
+    const stopStuck = useCallback(() => {
+        say("graview", "Stopped. The view is as it was.");
+        setPhase(steps.current.length > 0 ? { at: "draft" } : { at: "open" });
+    }, [say]);
     const discard = useCallback(() => {
         draft.current?.dispose();
         draft.current = null;
-        if (phase.at === "draft") {
-            aiDesk.record({ ...phase.entry, outcome: "dismissed" });
+        const latest = steps.current.at(-1);
+        if (latest) {
+            aiDesk.record({ ...latest.entry, outcome: "dismissed" });
             ended("declined");
         }
-        close();
-    }, [phase, aiDesk, close, ended]);
+        steps.current = [];
+        setComparing(false);
+        say("graview", "Put back as it was.");
+        setPhase({ at: "open" });
+    }, [aiDesk, ended, say]);
     const undo = useCallback(async () => {
         if (phase.at !== "kept" || !handle.current)
             return;
@@ -268,61 +432,44 @@ export function SectionCard({ ask, close }) {
             aiDesk.record({ ...phase.entry, outcome: "dismissed" });
             // A quiet sign, never a 👎.
             ended("undone");
+            say("graview", "Undone. The view is as it was.");
             setPhase({ at: "undone" });
         }
-        catch (error) {
-            setPhase({ at: "refused", said: error instanceof Error ? error.message : "The host did not put it back." });
+        catch {
+            say("graview", "It couldn't be put back.");
         }
-    }, [phase, keptViews, aiDesk, section.name, ended]);
-    /* Placed beside the section, kept there as the page moves. */
-    useLayoutEffect(() => {
-        let frame = 0;
-        const follow = () => {
-            if (card.current) {
-                const drafted = place?.querySelector("[data-graview-section-draft]");
-                placeBeside(card.current, drafted ? boxOf([drafted]) : boxOf(section.elements) ?? (place ? boxOf([place]) : null));
-            }
-            frame = requestAnimationFrame(follow);
-        };
-        follow();
-        return () => cancelAnimationFrame(frame);
-    }, [section, place]);
-    /* The keyboard: in the field when it asks, else on the card's first button. */
-    useEffect(() => {
-        if (phase.at === "asking")
-            field.current?.focus();
-        else if (phase.at !== "highlighting")
-            card.current?.querySelector("button[data-first]")?.focus();
-    }, [phase.at]);
-    /* Escape puts it away: a draft is discarded, the keyboard goes back where it was. */
+    }, [phase, keptViews, aiDesk, section.name, ended, say]);
+    /* Escape: Stop while it works, else put it away. */
     useEffect(() => {
         const key = (event) => {
-            if (event.key !== "Escape")
+            if (event.key !== "Escape" || phase.at === "highlighting")
                 return;
             event.preventDefault();
-            discard();
+            if (phase.at === "working")
+                return stopTurn();
+            if (steps.current.length > 0)
+                ended("declined");
+            close();
             ask.returnTo?.focus?.();
         };
         document.addEventListener("keydown", key);
         return () => document.removeEventListener("keydown", key);
-    }, [discard, ask.returnTo]);
-    const pointed = phase.at === "asking" || phase.at === "working" ? phase.pointed : undefined;
+    }, [phase.at, stopTurn, close, ended, ask.returnTo]);
     if (phase.at === "highlighting") {
-        return (_jsx(Highlighter, { place: place, section: section, cancel: close, chose: (elements) => {
+        return (_jsx(Highlighter, { box: place, root: place?.querySelector("[data-worker-view]")?.shadowRoot?.querySelector("[data-graview-view-root]") ?? undefined, whole: section.elements, cancel: () => setPhase({ at: "open" }), chose: (elements) => {
                 const first = elements[0];
                 const under = first ? sectionUnderNow(first) : undefined;
-                const on = under ?? section;
-                setSection(on);
-                setPhase({ at: "asking", pointed: { name: nameParts(elements.map(readPart)), lines: partLines(elements.map(readPart)) } });
+                setSection(under ?? section);
+                pointedAt.current = { name: aboutOf(elements) ?? nameParts(elements.map(readPart)), lines: partLines(elements.map(readPart)) };
+                setPhase({ at: "open" });
             } }));
     }
-    const drafted = phase.at === "draft" || phase.at === "keeping";
-    const outlined = drafted ? [...(place?.querySelectorAll("[data-graview-section-draft]") ?? [])] : phase.at === "kept" || phase.at === "undone" ? [] : section.elements;
-    return (_jsxs(_Fragment, { children: [outlined.length > 0 ? _jsx(SectionOutline, { elements: outlined, label: drafted ? "Draft" : undefined }) : null, _jsxs("div", { ref: card, role: "dialog", "aria-label": `Make “${section.name}” better`, "data-testid": "section-card", "data-section-phase": phase.at, "data-graview-popover": "", style: CARD, children: [_jsxs("p", { style: HEAD, children: ["Make ", _jsxs("strong", { children: ["\u201C", section.name, "\u201D"] }), " better"] }), pointed ? (_jsxs("p", { "data-testid": "section-pointed", style: MUTED, children: ["You pointed at ", pointed.name, "."] })) : null, phase.at === "asking" ? (_jsxs("form", { onSubmit: (event) => {
-                            event.preventDefault();
-                            if (words.trim())
-                                void revise(ask.mode, words.trim(), phase.pointed);
-                        }, style: { display: "grid", gap: 8 }, children: [_jsx("label", { style: VISUALLY_HIDDEN, htmlFor: "graview-section-words", children: phase.pointed ? "What should change here?" : "What should change?" }), _jsx("input", { id: "graview-section-words", ref: field, "data-testid": "section-words", value: words, onChange: (event) => setWords(event.target.value), placeholder: phase.pointed ? "What should change here?" : "What should change?", style: FIELD }), _jsxs("div", { style: ROW, children: [_jsx("button", { type: "submit", "data-first": "", disabled: !words.trim(), style: PRIMARY, children: "Revise" }), _jsx("button", { type: "button", onClick: close, style: QUIET, children: "Cancel" })] })] })) : null, _jsx("p", { role: "status", "aria-live": "polite", "data-testid": "section-status", style: phase.at === "working" || phase.at === "keeping" ? THINKING : MUTED, children: phase.at === "working" ? `Revising “${section.name}”…` : phase.at === "keeping" ? "Keeping it…" : phase.at === "draft" ? phase.said : phase.at === "kept" ? `Kept.${phase.note ? ` ${phase.note}` : ""}` : phase.at === "undone" ? "Put back as it was." : phase.at === "refused" ? phase.said : "" }), phase.at === "draft" ? (_jsxs(_Fragment, { children: [_jsx("p", { "data-testid": "section-draft-line", style: MUTED, children: "Draft \u2014 shown in place, not kept." }), phase.notes.map((note) => (_jsx("p", { "data-testid": "section-note", style: MUTED, children: note }, note))), _jsxs("div", { style: ROW, children: [_jsx("button", { type: "button", "data-first": "", "data-testid": "section-keep", onClick: () => void keep(), style: PRIMARY, children: "Keep" }), _jsx("button", { type: "button", "data-testid": "section-discard", onClick: discard, style: QUIET, children: "Discard" })] })] })) : null, phase.at === "kept" ? (_jsxs("div", { style: ROW, children: [_jsx("button", { type: "button", "data-first": "", "data-testid": "section-undo", onClick: () => void undo(), style: QUIET, children: "Undo" }), _jsx("button", { type: "button", onClick: close, style: QUIET, children: "Close" })] })) : null, phase.at === "refused" || phase.at === "undone" ? (_jsx("div", { style: ROW, children: _jsx("button", { type: "button", "data-first": "", onClick: close, style: QUIET, children: "Close" }) })) : null, telling && ai.told && phase.at !== "working" && phase.at !== "asking" ? _jsx(Rate, { told: ai.told, telling: telling }) : null] })] }));
+    return (_jsxs(_Fragment, { children: [section.elements.length > 0 && phase.at === "open" && talk.current.length === 0 ? _jsx(SectionOutline, { elements: section.elements }) : null, covering ? _jsx(Redesigning, { over: place, name: section.name, said: `Graview is drafting “${section.name}”…` }) : null, _jsx(BetterPanel, { name: section.name, scope: `This changes how “${section.name}” looks for everyone in this app.`, phase: phase.at, talk: talk.current, steps: events.current, since: since.current, working: phase.at === "working" || phase.at === "keeping", ...(current && phase.at === "draft" ? { draft: { said: current.said, before: comparing } } : {}), ...(phase.at === "kept" ? { kept: { ...(phase.note ? { note: phase.note } : {}), undo: () => void undo() } } : {}), ...(phase.at === "stuck" ? { stuck: { ...(phase.source !== undefined ? { keepAnyway: () => void keep(phase.source) } : {}), stop: stopStuck } } : {}), about: (pointedAt.current ?? aboutNow.current)?.name ?? section.name, ask: (words) => void askFor(words), just: () => void askFor("Make it easier to read at a glance"), point: () => setPhase({ at: "highlighting" }), stop: stopTurn, compare: (originalShown) => void compare(originalShown), keep: () => void keep(), discard: discard, close: () => {
+                    stopping.current?.abort();
+                    if (steps.current.length > 0)
+                        ended("declined");
+                    close();
+                }, children: telling && ai.told && phase.at !== "working" ? _jsx(Rate, { told: ai.told, telling: telling }) : null })] }));
 }
 /**
  * HIGHLIGHT AREA: an overlay over the view. A drag draws a rectangle and
@@ -330,10 +477,9 @@ export function SectionCard({ ask, close }) {
  * or "Cancel", puts it away; "The whole section" takes the section itself
  * for a keyboard.
  */
-function Highlighter({ place, section, cancel, chose }) {
+export function Highlighter({ box: place, root, whole, wholeSaid = "The whole section", cancel, chose }) {
     const cover = useRef(null);
     const [drag, setDrag] = useState(null);
-    const root = place?.querySelector("[data-worker-view]")?.shadowRoot?.querySelector("[data-graview-view-root]") ?? undefined;
     useLayoutEffect(() => {
         let frame = 0;
         const follow = () => {
@@ -377,8 +523,9 @@ function Highlighter({ place, section, cancel, chose }) {
             event.preventDefault();
             event.currentTarget.setPointerCapture?.(event.pointerId);
             setDrag({ x0: event.clientX, y0: event.clientY, x1: event.clientX, y1: event.clientY });
-        }, onPointerMove: (event) => setDrag((was) => (was ? { ...was, x1: event.clientX, y1: event.clientY } : was)), onPointerUp: end, onPointerCancel: () => setDrag(null), style: COVER, children: [_jsxs("p", { style: COVER_HINT, children: ["Drag over the part to change, or click one \u00B7", " ", _jsx("button", { type: "button", onPointerDown: (event) => event.stopPropagation(), onClick: () => chose(section.elements), style: LINK, children: "The whole section" }), " ", "\u00B7", " ", _jsx("button", { type: "button", onPointerDown: (event) => event.stopPropagation(), onClick: cancel, style: LINK, children: "Cancel" })] }), box ? _jsx("div", { "data-testid": "section-drag", style: { ...DRAG, left: box.left - (cover.current?.getBoundingClientRect().left ?? 0), top: box.top - (cover.current?.getBoundingClientRect().top ?? 0), width: box.width, height: box.height } }) : null] }));
+        }, onPointerMove: (event) => setDrag((was) => (was ? { ...was, x1: event.clientX, y1: event.clientY } : was)), onPointerUp: end, onPointerCancel: () => setDrag(null), style: COVER, children: [_jsxs("p", { style: COVER_HINT, children: ["Drag over the part to change, or click one \u00B7", " ", _jsx("button", { type: "button", onPointerDown: (event) => event.stopPropagation(), onClick: () => chose(whole), style: LINK, children: wholeSaid }), " ", "\u00B7", " ", _jsx("button", { type: "button", onPointerDown: (event) => event.stopPropagation(), onClick: cancel, style: LINK, children: "Cancel" })] }), box ? _jsx("div", { "data-testid": "section-drag", style: { ...DRAG, left: box.left - (cover.current?.getBoundingClientRect().left ?? 0), top: box.top - (cover.current?.getBoundingClientRect().top ?? 0), width: box.width, height: box.height } }) : null] }));
 }
+export { readPart, placeBeside };
 const CARD = {
     position: "fixed",
     zIndex: layer("popover"),
@@ -408,4 +555,6 @@ const PAD = 12;
 const COVER = { userSelect: "none", WebkitUserSelect: "none", position: "fixed", zIndex: layer("popover"), boxSizing: "border-box", cursor: "crosshair", touchAction: "none", outline: "2px dashed var(--graview-accent)", background: "color-mix(in srgb, var(--graview-accent) 6%, transparent)" };
 const COVER_HINT = { position: "absolute", left: 8, top: 8, margin: 0, padding: "4px 10px", borderRadius: 999, fontSize: "0.8125rem", color: "var(--graview-ink)", background: "var(--graview-float, var(--graview-panel))", border: "1px solid var(--graview-edge)", boxShadow: "var(--graview-lift-low)", cursor: "default" };
 const DRAG = { position: "absolute", border: "2px solid var(--graview-accent)", background: "color-mix(in srgb, var(--graview-accent) 14%, transparent)", borderRadius: 4, pointerEvents: "none" };
+/** The card's look, shared with a built-in page's card. */
+export const LOOK = { CARD, HEAD, MUTED, THINKING, ROW, FIELD, PRIMARY, QUIET };
 //# sourceMappingURL=section-better.js.map