@graview/pages 0.1.0

package/LICENSE

@@ -0,0 +1,96 @@
+Elastic License 2.0
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set
+of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company
+makes such a claim, your patent license ends immediately for work on behalf
+of your company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not
+licensed, and your licenses will automatically terminate. If the licensor
+provides you with a notice of your violation, and you cease all violation of
+this license no later than 30 days after you receive that notice, your
+licenses will be reinstated retroactively. However, if you violate these
+terms after such reinstatement, any additional violation of these terms will
+cause your licenses to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is
+the software the licensor makes available under these terms, including any
+portion of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control
+over, are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of
+an entity, or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your
+licenses.
+
+**trademark** means trademarks, service marks, and similar rights.
+
+---
+
+Copyright 2025-2026 En Dash Consulting

package/README.md

@@ -0,0 +1,47 @@
+# @graview/pages
+
+The traditional face: a routed webapp derived from the same declaration that drives the
+spatial scene. From one `defineApp` — schema, mutations, invariants, permissions, op log —
+this package serves lists, records, forms, problems and history as ordinary linked pages:
+`/` the gallery, `/:plural` per kind, `/:plural/:id` per node, `/places/:as` per picture,
+`/map` the relations, `/problems`.
+
+- **One store, no second path.** Pages read through the same `Store` and write through the
+  same mutations with the same principal; withheld actions render disabled with their
+  refusal. `recordFacts` composes the derivations the scene already uses (labels, readable
+  fields, violations touching, derived affordances) — the parity tests hold a record page
+  and the spatial detail to identical facts.
+- **The page registry mirrors the view registry.** `(kind × page-type) → component`,
+  defaults overridable per cell; the shell, home and problems pages are themselves
+  registrations (`registry.surface(...)`).
+- **Forms are derived.** `formFields` (in `@graview/core`) walks a mutation's zod input into
+  a control tree — scalars, dates, node pickers over real candidates, nested objects,
+  discriminated unions as a type picker plus that arm's fields, arrays as repeatable rows —
+  and `DerivedForm` renders it. Nothing renderable is hand-written; anything unrenderable
+  says so instead of hiding.
+- **Two faces, one application.** Record pages link to their spatial stop
+  (`spatialHref(id)`); the scene links to the pages; the ids are shared. See
+  `apps/todo` for both faces mounted from one declaration (`/` scene, `/pages` routed).
+- **Mobile is an acceptance criterion.** `pnpm pages` runs the phone-width harness
+  (390×844): no sideways scroll, named links, labelled controls, and a derived form that
+  actually applies.
+
+- **It lands on a gallery.** The home opens with the standing as its headline — "2 gardeners,
+  3 plots and 1 planting.", or "Nothing here yet." and which act begins it — then every
+  picture the app has as a large live card, two across at a desk and one on a phone: the
+  lens itself, drawn inert at a scale measured from the card, captioned with its name and how
+  much it is over. Handed the scene's view registry (`views` in the context), every titled
+  lens is a page at `/places/<as>` and a card on the home; a kind with no titled lens is
+  drawn anyway, as a contact sheet of its members, so a new app lands on a gallery on its
+  first afternoon. The kinds follow as one row of counts, the relations as one line that
+  opens `/map`, and Recently stays short at the foot. The shell is one row of navigation
+  that scrolls sideways on a phone; a new address opens at its top.
+- **It reads like the product's own site.** A list opens with the plural and its
+  description, a record with its title and its kind's `describe`, controls receding below
+  the content. Typography rides the brand's display and body faces at a real scale; the
+  brand's mark, name and per-kind accents (`hueFor`, from `@graview/core`) carry through
+  every page. Still derivation: nothing here is a per-app template, and an app overrides a
+  cell the same way it overrides a view.
+
+The host applies `themeCss` from `@graview/primitives` (or supplies its own `--graview-*`
+tokens); the default pages render entirely from those tokens.

package/dist/ask.d.ts

@@ -0,0 +1,21 @@
+import { type AnySchema } from "@graview/core";
+import type { PageContext } from "./pages.js";
+/**
+ * THE ASSISTANT ON EVERY PAGE — the same panel, not a second one.
+ *
+ * The scene keeps the seat in a rail on the left: a subject, its acts, its
+ * relations, the conversation. A routed face that grew its own chat box
+ * would be two assistants with two habits over one graph, so this is the
+ * companion, in a drawer beside the reading column (a sheet on a phone),
+ * opened by one control in the shell.
+ *
+ * WHAT "THIS" MEANS HERE IS THE ROUTE. On a record it is that record; on a
+ * kind's page, that kind; on a picture, the kind it is a picture of. The
+ * provider's selection is set from the address, so the same question means
+ * the same thing on both faces — and the companion's own subject rule (the
+ * selection first) does the rest.
+ */
+export declare function PageAsk<S extends AnySchema>({ context }: {
+    readonly context: PageContext<S>;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=ask.d.ts.map

package/dist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAOxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,sCAqE7F"}

package/dist/ask.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { labelOf } from "@graview/core";
+import { aggregateId, kindCardId } from "@graview/layout";
+import { Companion } from "@graview/primitives";
+import { useGraviewIfAny } from "@graview/react";
+import { useEffect, useRef, useState } from "react";
+import { useLocation, useNavigate } from "react-router-dom";
+import { kindOfSlug, recordPath } from "./registry.js";
+/**
+ * THE ASSISTANT ON EVERY PAGE — the same panel, not a second one.
+ *
+ * The scene keeps the seat in a rail on the left: a subject, its acts, its
+ * relations, the conversation. A routed face that grew its own chat box
+ * would be two assistants with two habits over one graph, so this is the
+ * companion, in a drawer beside the reading column (a sheet on a phone),
+ * opened by one control in the shell.
+ *
+ * WHAT "THIS" MEANS HERE IS THE ROUTE. On a record it is that record; on a
+ * kind's page, that kind; on a picture, the kind it is a picture of. The
+ * provider's selection is set from the address, so the same question means
+ * the same thing on both faces — and the companion's own subject rule (the
+ * selection first) does the rest.
+ */
+export function PageAsk({ context }) {
+    const [open, setOpen] = useState(false);
+    const navigate = useNavigate();
+    const here = useGraviewIfAny();
+    if (!here)
+        return null;
+    return (_jsxs(_Fragment, { children: [_jsx(RouteSubject, { context: context }), _jsxs("button", { type: "button", "data-testid": "page-ask", "aria-expanded": open, onClick: () => setOpen((current) => !current), title: "Talk to the seat about this page", style: {
+                    position: "fixed",
+                    left: 16,
+                    bottom: 16,
+                    zIndex: 30,
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: 6,
+                    minHeight: 40,
+                    padding: "0 14px",
+                    borderRadius: 999,
+                    border: "1px solid var(--graview-edge)",
+                    background: "var(--graview-float)",
+                    color: "var(--graview-ink)",
+                    font: "inherit",
+                    fontSize: "0.9375rem",
+                    boxShadow: "var(--graview-lift-low)",
+                    cursor: "pointer",
+                }, children: [_jsx("span", { "aria-hidden": "true", children: "\u25C6" }), open ? "Close" : "Ask"] }), open ? (_jsx("div", { "data-testid": "page-ask-drawer", 
+                /*
+                 * The scene's companion positions itself inside the scene's box;
+                 * here that box is this drawer, pinned beside the reading column
+                 * on a desk and along the bottom on a phone.
+                 */
+                style: {
+                    position: "fixed",
+                    left: 0,
+                    top: 0,
+                    bottom: 0,
+                    width: "min(320px, 100vw)",
+                    zIndex: 29,
+                    pointerEvents: "none",
+                }, children: _jsx("div", { style: { position: "absolute", inset: "12px 12px 64px 12px", pointerEvents: "auto", display: "grid" }, children: _jsx(Companion, { framed: true, onPick: (id) => {
+                            const node = context.store.graph.getNode(id);
+                            if (node)
+                                navigate(recordPath(context.store.schema, node.kind, id));
+                        } }) }) })) : null] }));
+}
+/** The page's own subject, put where every surface reads it: the selection. */
+function RouteSubject({ context }) {
+    const { store } = context;
+    const here = useGraviewIfAny();
+    const { pathname } = useLocation();
+    /*
+     * HELD IN A REF, because the setter is not stable: it closes over the
+     * current view, so a new one arrives on every render — and an effect
+     * that depended on it set the selection, re-rendered the provider, got a
+     * new setter and set the selection again, nine hundred times a second.
+     * The address is the only thing that decides the subject.
+     */
+    const set = useRef(here?.setSelection);
+    set.current = here?.setSelection;
+    /*
+     * THE ADDRESS, ONCE PER ADDRESS. `useParams()` hands back a fresh object
+     * every render, so putting it in the dependencies made this run on every
+     * render, set the selection, and render again — a loop that took the
+     * whole page down with it the moment the drawer opened. The path is the
+     * only thing that decides the subject, so the path is the dependency.
+     */
+    useEffect(() => {
+        const setSelection = set.current;
+        if (!setSelection)
+            return;
+        const [, slug, id] = pathname.split("/");
+        const chosen = (() => {
+            if (slug === "places") {
+                const place = context.views?.places().find((one) => one.as === decodeURIComponent(id ?? ""));
+                return place ? [aggregateId(place.kind)] : [];
+            }
+            const kind = slug ? kindOfSlug(store.schema, slug) : undefined;
+            if (kind && id)
+                return [decodeURIComponent(id)];
+            return kind ? [kindCardId(kind)] : [];
+        })();
+        setSelection((current) => current.length === chosen.length && current.every((one, at) => one === chosen[at]) ? current : chosen);
+    }, [pathname]);
+    void labelOf;
+    return null;
+}
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/face-controls.d.ts

@@ -0,0 +1,68 @@
+import type { AnySchema, Principal, Store } from "@graview/core";
+import { type ReactNode, type RefObject } from "react";
+import type { PageContext } from "./page-context.js";
+import { type PageRegistry } from "./registry.js";
+/**
+ * WHAT THE ROUTED FACE OFFERS WHICHEVER SHELL DRAWS IT.
+ *
+ * Finding a record by part of its name and taking the last change back are
+ * core jobs, not chrome a design may happen to remember. The Find box lived
+ * in the derived shell only, so an app that replaced the shell — every
+ * example does — had Find exactly when its author thought to put
+ * `<PageFind>` in, and rota had none. Undo lived nowhere on this face at
+ * all: the scene's Activity rail takes a turn back, and on the pages a
+ * person who renamed the wrong record could not.
+ *
+ * So the face's root owns both. A shell that places `<PageFind>` or
+ * `<PageUndo>` itself says where they go, and the root sees them placed and
+ * draws nothing more; a shell that places neither still gets them — Find in
+ * a bar above it, the way back in a dock at the corner. Only a registry that
+ * says so (`surface("shell", Shell, { without: ["find"] })`) goes without.
+ */
+export type { FaceControl } from "./face-placed.js";
+export interface LastChange {
+    readonly batch: string;
+    /** What it did, in the store's own words — the line the Activity rail shows. */
+    readonly intent: string;
+}
+/**
+ * The change this person can take back: their own latest turn that is not
+ * already taken back, is not itself a take-back, that the log lets go of on
+ * its own, and that the policy lets them take back — undo is judged like a
+ * change ("what you may undo is what you may have done"), so a turn the
+ * store would refuse is never offered.
+ *
+ * "Their own" is the rule the Activity rail uses for "you": a human author
+ * who is this principal, or either side has no id to tell them apart. On a
+ * served store two seats share one log, and one person's corner should not
+ * offer to take back another's work.
+ */
+export declare function lastChangeOf<S extends AnySchema>(store: Store<S>, principal?: Principal): LastChange | undefined;
+/** "Take back “Rename to …”" — the words on the control and in the announcement. */
+export declare const takeBackWords: (change: LastChange) => string;
+/**
+ * THE WAY BACK, on the routed face: one control that says what it takes
+ * back — "Take back “Rename to …”" — and takes it back as the person at the
+ * keyboard, judged by the policy like any change.
+ *
+ * Exported for a shell that wants it somewhere of its own; a shell that
+ * does not place it gets it anyway, docked at the corner of the face.
+ */
+export declare function PageUndo<S extends AnySchema>({ context, docked, }: {
+    readonly context: PageContext<S>;
+    /** Held at the corner of the face rather than in a shell's own row. Set by the face's root. */
+    readonly docked?: boolean;
+}): import("react").JSX.Element;
+/**
+ * The face's root: it knows which of the face's controls a shell placed,
+ * and draws the rest — Find in a bar above the shell, the way back docked
+ * at the corner — before the shell in the document, so the keyboard reaches
+ * them first.
+ */
+export declare function FaceControlsRoot<S extends AnySchema>({ context, registry, root, children, }: {
+    readonly context: PageContext<S>;
+    readonly registry: PageRegistry<S, unknown> | undefined;
+    readonly root: RefObject<HTMLElement | null>;
+    readonly children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=face-controls.d.ts.map

package/dist/face-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-controls.d.ts","sourceRoot":"","sources":["../src/face-controls.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAA8D,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAI9D;;;;;;;;;;;;;;;;GAgBG;AACH,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAgBhH;AAED,oFAAoF;AACpF,eAAO,MAAM,aAAa,GAAI,QAAQ,UAAU,WAAmC,CAAC;AAwCpF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,EAC5C,OAAO,EACP,MAAc,GACf,EAAE;IACD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B,+BAGA;AAmID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,EACpD,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,+BAUA"}

package/dist/face-controls.js

@@ -0,0 +1,231 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useState } from "react";
+import { useLocation } from "react-router-dom";
+import { useStoreTick } from "./page-context.js";
+import { kindOfSlug } from "./registry.js";
+import { PageFind } from "./page-shell.js";
+import { createPlaced, FaceControls, usePlaced, usePlacedOnTheFace } from "./face-placed.js";
+/**
+ * The change this person can take back: their own latest turn that is not
+ * already taken back, is not itself a take-back, that the log lets go of on
+ * its own, and that the policy lets them take back — undo is judged like a
+ * change ("what you may undo is what you may have done"), so a turn the
+ * store would refuse is never offered.
+ *
+ * "Their own" is the rule the Activity rail uses for "you": a human author
+ * who is this principal, or either side has no id to tell them apart. On a
+ * served store two seats share one log, and one person's corner should not
+ * offer to take back another's work.
+ */
+export function lastChangeOf(store, principal) {
+    const batches = store.batches();
+    for (let at = batches.length - 1; at >= 0; at--) {
+        const batch = batches[at];
+        if (batch.undone || batch.ops.length === 0)
+            continue;
+        if (batch.ops.every((op) => op.undoes !== undefined))
+            continue;
+        const author = batch.author;
+        const mine = author.kind === "human" && (principal?.id === undefined || author.id === undefined || author.id === principal.id);
+        if (!mine)
+            continue;
+        const check = store.canUndo(batch.id);
+        if (!check.ok)
+            continue;
+        const permitted = check.ops.every((op) => !op.mutation || store.permits(op.mutation, principal).ok);
+        if (!permitted)
+            continue;
+        return { batch: batch.id, intent: batch.intent };
+    }
+    return undefined;
+}
+/** "Take back “Rename to …”" — the words on the control and in the announcement. */
+export const takeBackWords = (change) => `Take back “${change.intent}”`;
+const editable = (target) => target instanceof HTMLElement &&
+    (target.isContentEditable || target.matches("input, textarea, select, [contenteditable]:not([contenteditable='false'])"));
+/** Where the keyboard goes when the control it pressed is gone: the page's heading, where the change shows. */
+function landOnThePage(face) {
+    const active = document.activeElement;
+    if (active !== null && active !== document.body && active !== document.documentElement && active.isConnected)
+        return;
+    const root = face ?? document;
+    const main = root.querySelector("main") ?? root.querySelector("[data-graview-page]") ?? null;
+    const target = main?.querySelector("h1") ?? root.querySelector("h1") ?? main;
+    if (!(target instanceof HTMLElement))
+        return;
+    if (!target.hasAttribute("tabindex"))
+        target.setAttribute("tabindex", "-1");
+    target.focus({ preventScroll: true });
+}
+function useTakeBack(context) {
+    const { store, principal } = context;
+    const tick = useStoreTick(store);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const change = useMemo(() => lastChangeOf(store, principal), [store, principal, tick]);
+    const [refused, setRefused] = useState(null);
+    const [said, setSaid] = useState("");
+    const takeBack = useCallback(() => {
+        const now = lastChangeOf(store, principal);
+        if (!now)
+            return false;
+        setRefused(null);
+        try {
+            store.undo(now.batch, principal ? { author: principal } : {});
+            setSaid(`Took back “${now.intent}”`);
+        }
+        catch (error) {
+            setRefused(error instanceof Error ? error.message : String(error));
+        }
+        return true;
+    }, [store, principal]);
+    return { change, takeBack, refused, said };
+}
+/**
+ * THE WAY BACK, on the routed face: one control that says what it takes
+ * back — "Take back “Rename to …”" — and takes it back as the person at the
+ * keyboard, judged by the policy like any change.
+ *
+ * Exported for a shell that wants it somewhere of its own; a shell that
+ * does not place it gets it anyway, docked at the corner of the face.
+ */
+export function PageUndo({ context, docked = false, }) {
+    usePlacedOnTheFace("undo");
+    return _jsx(TakeBack, { context: context, docked: docked });
+}
+function TakeBack({ context, docked }) {
+    const { change, takeBack, refused, said } = useTakeBack(context);
+    const corner = docked
+        ? context.embedded
+            ? { position: "sticky", bottom: 12, marginLeft: "auto", marginRight: 12, width: "fit-content" }
+            : { position: "fixed", right: 16, bottom: 16, zIndex: 30 }
+        : {};
+    return (_jsxs("div", { "data-testid": docked ? "face-undo-dock" : "page-undo-place", style: {
+            ...corner,
+            display: "grid",
+            justifyItems: "end",
+            gap: 4,
+            // Clear of the Ask control at the other corner on a phone.
+            maxWidth: docked ? "min(30rem, calc(100vw - 140px))" : "100%",
+            minWidth: 0,
+        }, children: [_jsx("span", { role: "status", style: visuallyHidden, children: said }), change ? (_jsxs("button", { type: "button", "data-testid": "page-undo", title: `${takeBackWords(change)} — ⌘Z or Ctrl+Z`, "aria-keyshortcuts": "Meta+Z Control+Z", onClick: (event) => {
+                    const face = event.currentTarget.closest("[data-graview-face]");
+                    takeBack();
+                    // After the face has drawn the change gone: if this control went with it, the keyboard lands on the page.
+                    requestAnimationFrame(() => landOnThePage(face));
+                }, style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: 6,
+                    minHeight: 36,
+                    maxWidth: "100%",
+                    minWidth: 0,
+                    padding: "0 14px",
+                    borderRadius: 999,
+                    border: "1px solid var(--graview-edge)",
+                    background: "var(--graview-float)",
+                    color: "var(--graview-ink)",
+                    font: "inherit",
+                    fontSize: "0.875rem",
+                    boxShadow: docked ? "var(--graview-lift-low)" : undefined,
+                    cursor: "pointer",
+                }, children: [_jsx("span", { "aria-hidden": "true", children: "\u21B6" }), _jsx("span", { style: { minWidth: 0, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }, children: takeBackWords(change) })] })) : null, refused ? (_jsx("span", { "data-testid": "page-undo-refused", role: "alert", style: {
+                    fontSize: "0.8125rem",
+                    lineHeight: 1.4,
+                    color: "var(--graview-warn)",
+                    background: docked ? "var(--graview-float)" : undefined,
+                    padding: docked ? "4px 8px" : undefined,
+                    borderRadius: 6,
+                }, children: refused })) : null] }));
+}
+const visuallyHidden = {
+    position: "absolute",
+    width: 1,
+    height: 1,
+    margin: -1,
+    padding: 0,
+    overflow: "hidden",
+    clip: "rect(0 0 0 0)",
+    whiteSpace: "nowrap",
+    border: 0,
+};
+/* ------------------------------------------------------------------ */
+/* The root                                                            */
+/* ------------------------------------------------------------------ */
+/**
+ * ⌘Z AND CTRL+Z, on the face — not in a text field, where they are the
+ * field's own undo and a person typing a name expects the letters back, not
+ * the last change. Heard on the document while the keyboard is in the face,
+ * or on nothing at all when the face owns the document; never while it is
+ * on the host page around an embed.
+ */
+function useTakeBackKeys(context, root, on) {
+    const { store, principal, embedded } = context;
+    useEffect(() => {
+        if (!on)
+            return;
+        const key = (event) => {
+            if (event.defaultPrevented || event.altKey || event.shiftKey)
+                return;
+            if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "z")
+                return;
+            if (editable(event.target))
+                return;
+            const target = event.target;
+            const inFace = target instanceof Node && root.current?.contains(target);
+            const onNothing = target === document.body || target === document.documentElement || target === document;
+            if (!inFace && !(onNothing && !embedded))
+                return;
+            const change = lastChangeOf(store, principal);
+            if (!change)
+                return;
+            event.preventDefault();
+            try {
+                store.undo(change.batch, principal ? { author: principal } : {});
+            }
+            catch {
+                // The control says a refusal where it was asked; a key has nowhere to say it.
+            }
+        };
+        document.addEventListener("keydown", key);
+        return () => document.removeEventListener("keydown", key);
+    }, [store, principal, embedded, root, on]);
+}
+/**
+ * The face's root: it knows which of the face's controls a shell placed,
+ * and draws the rest — Find in a bar above the shell, the way back docked
+ * at the corner — before the shell in the document, so the keyboard reaches
+ * them first.
+ */
+export function FaceControlsRoot({ context, registry, root, children, }) {
+    const placed = useMemo(createPlaced, []);
+    const without = registry?.without() ?? new Set();
+    useTakeBackKeys(context, root, !without.has("undo"));
+    return (_jsxs(FaceControls.Provider, { value: placed, children: [_jsx(Fallbacks, { context: context, registry: registry, placed: placed, without: without }), children] }));
+}
+function Fallbacks({ context, registry, placed, without, }) {
+    // Drawn once the shell has had its say: its controls are placed in the same commit, before paint.
+    const [ready, setReady] = useState(false);
+    useLayoutEffect(() => setReady(true), []);
+    const findPlaced = usePlaced(placed, "find");
+    const undoPlaced = usePlaced(placed, "undo");
+    const location = useLocation();
+    if (!ready)
+        return null;
+    const segments = location.pathname.split("/").filter(Boolean);
+    const listKind = segments.length === 1 ? kindOfSlug(context.store.schema, segments[0]) : undefined;
+    // `?q=` narrows a list the face derived; a list of the app's own has its own words for that.
+    const narrows = listKind !== undefined && registry?.lookup(listKind, "list") === undefined;
+    return (_jsxs(_Fragment, { children: [!findPlaced && !without.has("find") ? (_jsx("div", { "data-testid": "face-find-bar", style: {
+                    display: "flex",
+                    alignItems: "center",
+                    padding: "8px 16px",
+                    borderBottom: "1px solid var(--graview-edge)",
+                    background: "var(--graview-bar)",
+                    minWidth: 0,
+                }, children: _jsx(FindInBar, { context: context, narrowsLists: narrows }) })) : null, !undoPlaced && !without.has("undo") ? _jsx(TakeBack, { context: context, docked: true }) : null] }));
+}
+/** The bar's Find box: `PageFind` without counting as one the shell placed. */
+function FindInBar({ context, narrowsLists }) {
+    return (_jsx(FaceControls.Provider, { value: null, children: _jsx(PageFind, { context: context, narrowsLists: narrowsLists }) }));
+}
+//# sourceMappingURL=face-controls.js.map

package/dist/face-controls.js.map

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

package/dist/face-placed.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Which of the face's own controls a shell placed itself — so the face's
+ * root (face-controls.tsx) draws only the ones it did not.
+ */
+export type FaceControl = "find" | "undo";
+export interface Placed {
+    readonly count: (control: FaceControl) => number;
+    readonly place: (control: FaceControl) => () => void;
+    readonly subscribe: (listener: () => void) => () => void;
+}
+export declare const FaceControls: import("react").Context<Placed | null>;
+export declare function createPlaced(): Placed;
+/** A control a shell drew itself: the face's root then draws no second one. */
+export declare function usePlacedOnTheFace(control: FaceControl): void;
+export declare function usePlaced(placed: Placed, control: FaceControl): boolean;
+//# sourceMappingURL=face-placed.d.ts.map

package/dist/face-placed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-placed.d.ts","sourceRoot":"","sources":["../src/face-placed.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,IAAI,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC1D;AAED,eAAO,MAAM,YAAY,wCAAqC,CAAC;AAE/D,wBAAgB,YAAY,IAAI,MAAM,CAqBrC;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAG7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAMvE"}