@graview/primitives 0.1.49 → 0.1.51

package/dist/live-prose-editor.js

@@ -0,0 +1,260 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { presenceName } from "@graview/core";
+import { useGraview, useNode } from "@graview/react/provider";
+import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { caretHere, carriedOver, carrySelection, diffText, inputSplice, runToPutBack, runToTakeBack } from "./live-text.js";
+import { TextBody } from "./text-body.js";
+import "./frame.js"; // A door: tied to what the page drew first (TIED DOORS, packages/primitives/src/frame.ts).
+/*
+ * THE LIVE EDITOR (Roadmap f-collab-text, phase 4): a field typed together,
+ * edited where a served store can carry it a keystroke at a time. Fetched
+ * only once somebody opens such a field, with the typing it sends through.
+ *
+ * There is no draft and nothing to save: each keystroke is the field's, at
+ * once, here and — a run at a time — for everybody else. "Done" closes it,
+ * and so does Escape, which puts nothing back: what was typed was already
+ * everybody's. Ctrl or ⌘ Z takes back this person's own last run of typing
+ * into the field, never somebody else's, though they typed after it.
+ *
+ * Somebody else's typing lands in the text area as it arrives, and the
+ * person's selection is carried over it, so they keep typing on the word
+ * they were on. While an input method composes a word nothing is sent, and
+ * what others type waits; the word and theirs meet once it is chosen.
+ *
+ * Everybody else typing here is drawn where their caret stands: a thin line
+ * in their hue, their name on it, laid on a copy of the text that wraps as
+ * the text area does. Nothing else is drawn.
+ */
+export default function LiveProseEditor(props) {
+    const { store } = useGraview();
+    const { live, nodeId, field } = props;
+    /*
+     * Whether the declaration types the field together is read once the
+     * host's typing has arrived, with `@graview/core/typing`: a field written
+     * whole keeps its draft and Save. Until then the text area is read only.
+     */
+    const [typing, setTyping] = useState(null);
+    useEffect(() => {
+        let open = true;
+        void live.typing(nodeId, field).then((one) => open && setTyping(one));
+        return () => {
+            open = false;
+        };
+        // The host's typing, asked once: `live` is new each time somebody else moves.
+    }, [nodeId, field]);
+    if (typing && !store.collaborative(nodeId, field))
+        return _jsx(_Fragment, { children: props.writtenWhole });
+    return _jsx(LiveEditor, { ...props, typing: typing });
+}
+function LiveEditor({ nodeId, field, label, markdown, live, onDone, typing, }) {
+    const { store, principal } = useGraview();
+    const node = useNode(nodeId);
+    const value = textOf(node?.[field]);
+    const [preview, setPreview] = useState(false);
+    const area = useRef(null);
+    /** The field's text as the text area last showed it: what a keystroke is read against. */
+    const shown = useRef(value);
+    const composing = useRef(false);
+    /** The host's typing as it is now: the same channel, a new object each time who is here changes. */
+    const said = useRef(live);
+    said.current = live;
+    const textNow = () => textOf(store.graph.getNode(nodeId)?.[field]);
+    useEffect(() => area.current?.focus(), [preview, typing]);
+    /*
+     * Says where this person's caret stands, while the text area holds the
+     * keyboard: read when it is said, at most every `CARET_MS`, so a run of
+     * keystrokes is one word on the wire, not one each.
+     */
+    const caretSaid = useRef(undefined);
+    const sayCaret = () => {
+        if (caretSaid.current !== undefined)
+            return;
+        caretSaid.current = setTimeout(() => {
+            caretSaid.current = undefined;
+            const element = area.current;
+            if (!element || element.ownerDocument.activeElement !== element)
+                return;
+            const backward = element.selectionDirection === "backward";
+            said.current.sayCaret({ node: nodeId, field, anchor: backward ? element.selectionEnd : element.selectionStart, head: backward ? element.selectionStart : element.selectionEnd, rev: store.log.length });
+        }, CARET_MS);
+    };
+    // Once, as it closes: `live` is new each time somebody else moves, and that is no reason to say the caret has gone.
+    useEffect(() => () => {
+        clearTimeout(caretSaid.current);
+        said.current.sayCaret(null);
+    }, []);
+    /** The text area shows the field as it stands, the person's selection carried over what changed. */
+    const showNow = (now) => {
+        const element = area.current;
+        if (!element)
+            return;
+        if (element.value !== now) {
+            const selection = carrySelection({ start: element.selectionStart, end: element.selectionEnd }, diffText(element.value, now));
+            const direction = element.selectionDirection ?? "none";
+            element.value = now;
+            element.setSelectionRange(selection.start, selection.end, direction);
+        }
+        shown.current = now;
+    };
+    /** A keystroke: what it changed in the text the area showed, carried over whatever landed since, sent. */
+    const typed = () => {
+        const element = area.current;
+        if (!element || !typing || composing.current)
+            return;
+        const before = shown.current;
+        const now = textNow();
+        const mine = inputSplice(before, element.value, element.selectionEnd);
+        if (mine.removed === "" && mine.inserted === "")
+            return showNow(now);
+        const over = before === now ? mine : carriedOver(mine, diffText(before, now));
+        try {
+            typing.splice(over.at, over.removed.length, over.inserted);
+        }
+        catch {
+            // Refused here: the field stands as it was, and so does the area.
+        }
+        const after = textNow();
+        if (element.value !== after) {
+            element.value = after;
+            const caret = Math.min(after.length, over.at + over.inserted.length);
+            element.setSelectionRange(caret, caret);
+        }
+        shown.current = after;
+        sayCaret();
+    };
+    // Somebody else's typing, an undo, a reload: shown at once — unless a word is being composed, when it waits for the word.
+    useLayoutEffect(() => {
+        if (!composing.current)
+            showNow(value);
+    }, [value]);
+    const takeBack = async (again) => {
+        if (!typing)
+            return;
+        typing.flush();
+        // A run still on its way is taken back once the server has it.
+        for (let tries = 0; typing.waiting() > 0 && tries < 100; tries++)
+            await new Promise((resolve) => setTimeout(resolve, 30));
+        const batch = again ? runToPutBack(store, principal, nodeId, field) : runToTakeBack(store, principal, nodeId, field);
+        if (!batch)
+            return;
+        try {
+            if (again)
+                store.redo(batch, { author: principal });
+            else
+                store.undo(batch, { author: principal });
+        }
+        catch {
+            // Refused: nothing changed, and nothing is said over the person's typing.
+        }
+    };
+    const done = (left) => {
+        typing?.flush();
+        live.sayCaret(null);
+        onDone(left);
+    };
+    const others = [...live.who.values()].filter((one) => one.caret?.node === nodeId && one.caret.field === field);
+    return (_jsxs("div", { style: { display: "grid", gap: 8, minWidth: 0 }, "data-graview-live": field, children: [preview ? (_jsx("div", { "data-graview-preview": field, "aria-label": `${label}, as it will read`, role: "region", style: PREVIEW, children: _jsx(TextBody, { text: value, markdown: true }) })) : (_jsxs("div", { style: { position: "relative", minWidth: 0 }, children: [_jsx("textarea", { ref: area, "aria-label": label, "data-graview-field": field, defaultValue: value, readOnly: !typing, rows: 3, onInput: typed, onCompositionStart: () => {
+                            composing.current = true;
+                        }, onCompositionEnd: () => {
+                            composing.current = false;
+                            typed();
+                        }, onSelect: sayCaret, onFocus: sayCaret, onPointerDown: () => typing?.flush(), onKeyDown: (event) => {
+                            const key = event.key;
+                            if (key === "Escape") {
+                                event.preventDefault();
+                                done(false);
+                            }
+                            else if ((event.metaKey || event.ctrlKey) && !event.altKey && key.toLowerCase() === "z") {
+                                // The store's undo, not the text area's: it knows whose typing is whose.
+                                event.preventDefault();
+                                void takeBack(event.shiftKey);
+                            }
+                            else if ((event.metaKey || event.ctrlKey) && key === "Enter") {
+                                event.preventDefault();
+                                done(false);
+                            }
+                            else if (key === "Enter" || CARET_KEYS.has(key)) {
+                                // A new line, or the caret moved: the run so far ends here.
+                                typing?.flush();
+                            }
+                        }, onKeyUp: sayCaret, onBlur: (event) => {
+                            typing?.flush();
+                            live.sayCaret(null);
+                            // Moving to the editor's own buttons is not leaving it.
+                            const next = event.relatedTarget;
+                            if (next instanceof Node && event.currentTarget.closest("[data-graview-live]")?.contains(next))
+                                return;
+                            done(true);
+                        }, style: TEXT_AREA }), others.length > 0 ? _jsx(Carets, { text: value, others: others, area: area, log: store.log.all() }) : null] })), _jsxs("div", { style: { display: "flex", flexWrap: "wrap", alignItems: "center", gap: 8 }, children: [_jsx("button", { type: "button", onClick: () => done(false), style: BUTTON, children: "Done" }), markdown ? (_jsx("button", { type: "button", "aria-pressed": preview, onClick: () => setPreview(!preview), style: BUTTON, children: preview ? "Write" : "Preview" })) : null, _jsx("span", { style: { fontSize: "0.75rem", color: "var(--graview-ink-faint)" }, children: "Saved as you type \u00B7 Ctrl or \u2318 Z takes back your typing" })] })] }));
+}
+/**
+ * OTHERS' CARETS, ON A COPY OF THE TEXT: the same box, font and wrapping as
+ * the text area, its words transparent, laid over it; a caret is a line at
+ * its place in the copy, so it stands where the text area draws that place.
+ */
+function Carets({ text, others, area, log }) {
+    const copy = useRef(null);
+    useLayoutEffect(() => {
+        const element = area.current;
+        const mirror = copy.current;
+        if (!element || !mirror)
+            return;
+        const follow = () => {
+            mirror.scrollTop = element.scrollTop;
+        };
+        follow();
+        element.addEventListener("scroll", follow);
+        return () => element.removeEventListener("scroll", follow);
+    });
+    const placed = others
+        .map((one) => ({ one, at: caretHere(one.caret, one.participant, log, text.length).end }))
+        .sort((a, b) => a.at - b.at);
+    const parts = [];
+    let from = 0;
+    for (const { one, at } of placed) {
+        parts.push(text.slice(from, at));
+        from = at;
+        const name = presenceName(one) || "Somebody";
+        parts.push(_jsx("span", { "data-graview-caret": one.participant, title: `${name} is typing here`, style: { borderLeft: `2px solid hsl(${Math.round(one.hue)} 55% 52%)`, marginLeft: -1, marginRight: -1, pointerEvents: "auto" } }, one.participant));
+    }
+    // A last line that is empty is still a line.
+    parts.push(`${text.slice(from)}​`);
+    return (_jsx("div", { ref: copy, "aria-hidden": "true", style: COPY, children: parts }));
+}
+/** How often a caret moved while typing is said, at most. */
+const CARET_MS = 120;
+const textOf = (value) => (typeof value === "string" ? value : "");
+/** Keys that move the caret without typing: each ends the run before it. */
+const CARET_KEYS = new Set(["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End", "PageUp", "PageDown"]);
+const PREVIEW = { minHeight: "7.5em", padding: "8px 10px", border: "1px dashed var(--graview-edge-bright)", borderRadius: 6, lineHeight: 1.6, minWidth: 0 };
+const BUTTON = { font: "inherit", fontSize: "0.8125rem", minHeight: 28, padding: "2px 12px" };
+const BOX = {
+    font: "inherit",
+    lineHeight: 1.5,
+    width: "100%",
+    boxSizing: "border-box",
+    minHeight: "7.5em",
+    padding: "8px 10px",
+    borderRadius: 6,
+};
+const TEXT_AREA = {
+    ...BOX,
+    resize: "vertical",
+    fieldSizing: "content",
+    color: "var(--graview-ink)",
+    background: "var(--graview-panel, transparent)",
+    border: "1px solid var(--graview-edge-bright)",
+};
+const COPY = {
+    ...BOX,
+    position: "absolute",
+    inset: 0,
+    height: "100%",
+    border: "1px solid transparent",
+    color: "transparent",
+    whiteSpace: "pre-wrap",
+    overflowWrap: "break-word",
+    overflow: "hidden",
+    pointerEvents: "none",
+};
+//# sourceMappingURL=live-prose-editor.js.map

package/dist/live-prose-editor.js.map

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

package/dist/live-text.d.ts

@@ -0,0 +1,48 @@
+import { type AnySchema, type Operation, type PresenceCaret, type Principal, type Store, type TextSplice } from "@graview/core";
+/**
+ * THE KEYSTROKE AN INPUT MADE: `before` turned into `after`, the caret left
+ * at `caret` in `after`. What the two share at either end is left alone, as
+ * `diffSplice` does, but the end kept is never left of the caret — so a
+ * letter typed into a run of the same letter ("aa" → "aaa") is put where
+ * the caret says it was typed, not at the end of the run, and lands where
+ * the person typed it among what others type.
+ */
+export declare function inputSplice(before: string, after: string, caret: number): TextSplice;
+/** The one splice that turns `before` into `after`: `diffSplice`'s answer, the shared start kept first, never half of a pair. */
+export declare function diffText(before: string, after: string): TextSplice;
+/**
+ * THE PERSON'S KEYSTROKE, CARRIED OVER SOMEBODY ELSE'S TEXT that landed
+ * while it was typed (`transformSplices`' rule, theirs the earlier): apart,
+ * it moves by what theirs changed; touching, it takes out what both took
+ * out and puts in both, theirs first where they meet.
+ */
+export declare function carriedOver(mine: TextSplice, theirs: TextSplice): TextSplice;
+/** A selection in a text, as a text area holds it. */
+export interface Selection {
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * WHERE A PERSON'S OWN SELECTION GOES WHEN SOMEBODY ELSE'S TEXT LANDS: each
+ * end carried over the splice, and a caret that text was inserted at stays
+ * before it — the person keeps typing where they were, and the other's
+ * words appear after their caret, not under it.
+ */
+export declare function carrySelection(selection: Selection, splice: TextSplice): Selection;
+/**
+ * WHERE ANOTHER PERSON'S CARET STANDS IN THIS PAGE'S TEXT: said against
+ * their log at `rev`, carried over every splice into the field this page's
+ * log took since that they did not make (what they made, their caret had
+ * already moved with), and kept inside the text.
+ */
+export declare function caretHere(caret: PresenceCaret, participant: string, log: readonly Operation[], length: number): Selection;
+/**
+ * THE RUN OF TYPING ⌘Z TAKES BACK: this person's latest run into this field
+ * that is not taken back already and that the log lets go of on its own —
+ * never somebody else's, though they typed after it. Ctrl or ⌘ Z again
+ * takes the one before it.
+ */
+export declare function runToTakeBack(store: Store<AnySchema>, principal: Principal | undefined, node: string, field: string): string | undefined;
+/** The take-back ⌘⇧Z puts back: this person's latest change to this field, when it was taking a run back. */
+export declare function runToPutBack(store: Store<AnySchema>, principal: Principal | undefined, node: string, field: string): string | undefined;
+//# sourceMappingURL=live-text.d.ts.map

package/dist/live-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-text.d.ts","sourceRoot":"","sources":["../src/live-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAc,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AA0BvJ;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAWpF;AAED,iIAAiI;AACjI,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CASlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAU5E;AAED,sDAAsD;AACtD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAIlF;AASD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAazH;AAoBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQxI;AAED,6GAA6G;AAC7G,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvI"}

package/dist/live-text.js

@@ -0,0 +1,164 @@
+import { TYPE_TEXT } from "@graview/core";
+/*
+ * THE LIVE EDITOR'S ARITHMETIC (Roadmap f-collab-text, phase 4), apart from
+ * its drawing so each rule can be held by a test: what a keystroke was, where
+ * a caret goes when somebody else's text lands, where another person's caret
+ * stands in this page's text, and which run of typing is this person's to
+ * take back. Fetched with the live editor, never in a first load.
+ */
+/*
+ * Read here, not from `@graview/core`: whatever a chunk fetched later takes
+ * from the main entry, the first load carries.
+ */
+/** Where a caret goes over a splice (`transformCaret`'s rule): before it stays, past it moves, on it keeps the side `before` says. */
+function caretOver(caret, splice, before = false) {
+    if (caret < splice.at || (caret === splice.at && before))
+        return caret;
+    const end = splice.at + splice.removed.length;
+    if (caret >= end)
+        return caret + splice.inserted.length - splice.removed.length;
+    return before ? splice.at : splice.at + splice.inserted.length;
+}
+const high = (code) => code >= 0xd800 && code <= 0xdbff;
+const low = (code) => code >= 0xdc00 && code <= 0xdfff;
+/**
+ * THE KEYSTROKE AN INPUT MADE: `before` turned into `after`, the caret left
+ * at `caret` in `after`. What the two share at either end is left alone, as
+ * `diffSplice` does, but the end kept is never left of the caret — so a
+ * letter typed into a run of the same letter ("aa" → "aaa") is put where
+ * the caret says it was typed, not at the end of the run, and lands where
+ * the person typed it among what others type.
+ */
+export function inputSplice(before, after, caret) {
+    const most = Math.min(before.length, after.length);
+    let tail = 0;
+    const tailMost = Math.max(0, Math.min(most, after.length - caret));
+    while (tail < tailMost && before.charCodeAt(before.length - 1 - tail) === after.charCodeAt(after.length - 1 - tail))
+        tail++;
+    let head = 0;
+    while (head < most - tail && before.charCodeAt(head) === after.charCodeAt(head))
+        head++;
+    // Never half of a pair: an emoji is typed or taken out whole.
+    if (head > 0 && high(before.charCodeAt(head - 1)))
+        head--;
+    if (tail > 0 && low(before.charCodeAt(before.length - tail)))
+        tail--;
+    return { at: head, removed: before.slice(head, before.length - tail), inserted: after.slice(head, after.length - tail) };
+}
+/** The one splice that turns `before` into `after`: `diffSplice`'s answer, the shared start kept first, never half of a pair. */
+export function diffText(before, after) {
+    const most = Math.min(before.length, after.length);
+    let head = 0;
+    while (head < most && before.charCodeAt(head) === after.charCodeAt(head))
+        head++;
+    if (head > 0 && high(before.charCodeAt(head - 1)))
+        head--;
+    let tail = 0;
+    while (tail < most - head && before.charCodeAt(before.length - 1 - tail) === after.charCodeAt(after.length - 1 - tail))
+        tail++;
+    if (tail > 0 && low(before.charCodeAt(before.length - tail)))
+        tail--;
+    return { at: head, removed: before.slice(head, before.length - tail), inserted: after.slice(head, after.length - tail) };
+}
+/**
+ * THE PERSON'S KEYSTROKE, CARRIED OVER SOMEBODY ELSE'S TEXT that landed
+ * while it was typed (`transformSplices`' rule, theirs the earlier): apart,
+ * it moves by what theirs changed; touching, it takes out what both took
+ * out and puts in both, theirs first where they meet.
+ */
+export function carriedOver(mine, theirs) {
+    const end = (one) => one.at + one.removed.length;
+    if (end(mine) < theirs.at)
+        return mine;
+    if (mine.at > end(theirs))
+        return { ...mine, at: mine.at + theirs.inserted.length - theirs.removed.length };
+    const from = Math.min(mine.at, theirs.at);
+    const past = end(mine) - end(theirs);
+    const removed = mine.removed.slice(0, theirs.at - from) + theirs.inserted + (past > 0 ? mine.removed.slice(mine.removed.length - past) : "");
+    const inserted = theirs.at <= mine.at ? theirs.inserted + mine.inserted : mine.inserted + theirs.inserted;
+    const said = diffText(removed, inserted);
+    return { ...said, at: from + said.at };
+}
+/**
+ * WHERE A PERSON'S OWN SELECTION GOES WHEN SOMEBODY ELSE'S TEXT LANDS: each
+ * end carried over the splice, and a caret that text was inserted at stays
+ * before it — the person keeps typing where they were, and the other's
+ * words appear after their caret, not under it.
+ */
+export function carrySelection(selection, splice) {
+    const start = caretOver(selection.start, splice, true);
+    const end = selection.end === selection.start ? start : caretOver(selection.end, splice);
+    return { start, end: Math.max(start, end) };
+}
+/** Whether an op was made by the participant a presence names (`kind:id:session`): their kind and id, and their tab when the op says one. */
+function madeBy(op, participant) {
+    const { kind, id, session } = op.author;
+    const own = `${kind}:${id ?? ""}:`;
+    return participant.startsWith(own) && (!session || participant.slice(own.length) === session);
+}
+/**
+ * WHERE ANOTHER PERSON'S CARET STANDS IN THIS PAGE'S TEXT: said against
+ * their log at `rev`, carried over every splice into the field this page's
+ * log took since that they did not make (what they made, their caret had
+ * already moved with), and kept inside the text.
+ */
+export function caretHere(caret, participant, log, length) {
+    let anchor = caret.anchor;
+    let head = caret.head;
+    for (const op of log) {
+        if (op.seq < caret.rev || madeBy(op, participant))
+            continue;
+        for (const one of op.primitives) {
+            if (one.op !== "splice-text" || one.id !== caret.node || one.field !== caret.field)
+                continue;
+            anchor = caretOver(anchor, one);
+            head = caretOver(head, one);
+        }
+    }
+    const kept = (at) => Math.max(0, Math.min(length, at));
+    return { start: kept(anchor), end: kept(head) };
+}
+/** Whether a batch is a run of typing into this one field. */
+const typedInto = (batch, node, field) => batch.ops.length > 0 &&
+    batch.ops.every((op) => {
+        const args = op.mutation?.args;
+        return op.mutation?.name === TYPE_TEXT && args?.node === node && args.field === field;
+    });
+/** Whether a batch takes back runs of typing into this one field. */
+const takesTypingBack = (store, batch, node, field) => batch.ops.length > 0 &&
+    batch.ops.every((op) => op.undoes !== undefined) &&
+    store.batches().some((one) => batch.ops.some((op) => op.undoes === one.id || op.undoes === one.ops[0]?.id) && typedInto(one, node, field));
+/** A batch this person made: a human author who is this principal (the rule the way back and Activity use for "you"). */
+const isMine = (batch, principal) => batch.author.kind === "human" && (principal?.id === undefined || batch.author.id === undefined || batch.author.id === principal.id);
+/**
+ * THE RUN OF TYPING ⌘Z TAKES BACK: this person's latest run into this field
+ * that is not taken back already and that the log lets go of on its own —
+ * never somebody else's, though they typed after it. Ctrl or ⌘ Z again
+ * takes the one before it.
+ */
+export function runToTakeBack(store, principal, node, field) {
+    const batches = store.batches();
+    for (let at = batches.length - 1; at >= 0; at--) {
+        const batch = batches[at];
+        if (!isMine(batch, principal) || batch.undone || !typedInto(batch, node, field))
+            continue;
+        if (store.canUndo(batch.id).ok)
+            return batch.id;
+    }
+    return undefined;
+}
+/** The take-back ⌘⇧Z puts back: this person's latest change to this field, when it was taking a run back. */
+export function runToPutBack(store, principal, node, field) {
+    const batches = store.batches();
+    for (let at = batches.length - 1; at >= 0; at--) {
+        const batch = batches[at];
+        if (!isMine(batch, principal))
+            continue;
+        if (typedInto(batch, node, field))
+            return undefined;
+        if (takesTypingBack(store, batch, node, field))
+            return batch.undone ? undefined : batch.id;
+    }
+    return undefined;
+}
+//# sourceMappingURL=live-text.js.map

package/dist/live-text.js.map

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

package/dist/prose-editor.d.ts

@@ -1,5 +1,7 @@
 import "./frame.js";
-export default function ProseEditor({ field, label, value, markdown, onSave, onCancel, }: {
+interface ProseEditorProps {
+    /** The record, where the field may be typed together (Roadmap f-collab-text). */
+    readonly nodeId?: string;
     readonly field: string;
     readonly label: string;
     readonly value: string;
@@ -8,5 +10,9 @@ export default function ProseEditor({ field, label, value, markdown, onSave, onC
     /** `left`: the person moved the keyboard elsewhere, and it stays there. */
     readonly onSave: (draft: string, left: boolean) => void;
     readonly onCancel: () => void;
-}): import("react").JSX.Element;
+    /** The live editor closed: `left`, the keyboard went elsewhere. Without it, `onCancel`. */
+    readonly onDone?: (left: boolean) => void;
+}
+export default function ProseEditor(props: ProseEditorProps): import("react").JSX.Element;
+export {};
 //# sourceMappingURL=prose-editor.d.ts.map

package/dist/prose-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prose-editor.d.ts","sourceRoot":"","sources":["../src/prose-editor.tsx"],"names":[],"mappings":"AAEA,OAAO,YAAY,CAAC;AAcpB,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAClC,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B,+BAuEA"}
+{"version":3,"file":"prose-editor.d.ts","sourceRoot":"","sources":["../src/prose-editor.tsx"],"names":[],"mappings":"AAGA,OAAO,YAAY,CAAC;AAcpB,UAAU,gBAAgB;IACxB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C;AASD,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAgB1D"}

package/dist/prose-editor.js

@@ -1,20 +1,25 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { TypingContext } from "@graview/react/provider";
+import { lazy, useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
 import { TextBody } from "./text-body.js";
 import "./frame.js"; // A door: tied to what the page drew first (TIED DOORS, packages/primitives/src/frame.ts).
 /*
- * THE TEXT AREA PROSE IS CHANGED IN (FR-147), fetched the first time a
- * person opens one: every record draws prose, few are edited, and a page's
- * first load carries the drawing, not the editor.
- *
- * As tall as what it holds (`field-sizing: content`, measured where an
- * engine lacks it). Enter is a new line; Ctrl or ⌘ with Enter saves, as
- * does leaving it; Escape puts it back. Named for the field.
- *
- * Markdown (FR-180) is written as Markdown, and "Preview" shows it as the
- * record will draw it — "Write" goes back to the words, where they were.
+ * TYPED TOGETHER, LIVE (Roadmap f-collab-text, phase 4): under a host that
+ * can carry typing (a served store), the live editor is fetched as prose is
+ * opened, with `@graview/core/typing`, which says whether the declaration
+ * types the field together; it is edited live when it does. Anywhere else,
+ * and for a field written whole, the draft and its Save, as before.
  */
-export default function ProseEditor({ field, label, value, markdown, onSave, onCancel, }) {
+export default function ProseEditor(props) {
+    const live = useContext(TypingContext);
+    const draft = _jsx(DraftProseEditor, { ...props });
+    if (!live || props.nodeId === undefined)
+        return draft;
+    // Whether the field is typed together is read with `@graview/core/typing`, which comes with the live editor.
+    return (_jsx(LiveProseEditor, { nodeId: props.nodeId, field: props.field, label: props.label, ...(props.markdown ? { markdown: true } : {}), live: live, onDone: (left) => (props.onDone ? props.onDone(left) : props.onCancel()), writtenWhole: draft }));
+}
+const LiveProseEditor = lazy(() => import("./live-prose-editor.js"));
+function DraftProseEditor({ field, label, value, markdown, onSave, onCancel }) {
     const [draft, setDraft] = useState(value);
     const [preview, setPreview] = useState(false);
     const area = useRef(null);

package/dist/prose-editor.js.map

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

package/dist/suggested.d.ts

@@ -1,13 +1,23 @@
 import "./frame.js";
+/**
+ * WHAT THE APP'S OWN ACTOR LEFT WHILE A PERSON WAS AWAY, in a line: "3
+ * suggestions waiting · tidied 12 things while you were away", or undefined
+ * when there is nothing to say.
+ */
+export declare function awayWords(waiting: number, tidied: number): string | undefined;
 /**
  * THE SUGGESTED TRAY: what the app's own actor proposed and did not make
  * (`suggest`, `@graview/core/tidying`), waiting for a person — quietly, on the bar beside
  * Activity, never in the way of anything. Each says what it would do, who
  * suggested it, what it was based on and how sure, and the records it
- * names; Accept makes it as the person, carrying its lineage, and Decline
- * keeps the decline in the log, so it is never suggested again. Fetched
- * when the log holds a suggestion (`BarSuggested`), so a page with none
- * carries none of it; drawn while one still waits for this seat.
+ * names; Accept makes it as the person, carrying its lineage, Decline
+ * keeps the decline in the log, so it is never suggested again, and Not now
+ * puts it out of this person's sight until tomorrow — kept where the host
+ * keeps their own state (`dismissals`), so nobody else is told and the
+ * actor is held to nothing. Fetched when the log holds a suggestion, or
+ * the host said what was done while the person was away (`BarSuggested`),
+ * so a page with neither carries none of it; drawn while one still waits
+ * for this person, or there is something to say of their time away.
  */
 export declare function SuggestedTray(): import("react").JSX.Element | null;
 //# sourceMappingURL=suggested.d.ts.map