@parlor/agent-ui 0.0.0-stage → 0.1.0

package/dist/client/registry.js

@@ -0,0 +1,280 @@
+import { jsonEqual } from "./json-equal.js";
+export const NO_AGENT_WRITES = new Map();
+class Mounted {
+    view;
+    binding;
+    element;
+    key;
+    writes = NO_AGENT_WRITES;
+    writeListeners = new Set();
+    constructor(view, binding) {
+        this.view = view;
+        this.binding = binding;
+    }
+}
+export function createViewRegistry(env) {
+    const singles = new Map();
+    const keyed = new Map();
+    const live = new Set();
+    const byElement = new WeakMap();
+    const visibility = new Map();
+    let observer;
+    let pending = 0;
+    const waiting = [];
+    let listening = false;
+    let entered;
+    let interacted;
+    let quiet = 0;
+    let agentFocus;
+    const settle = () => {
+        if (pending > 0)
+            return;
+        for (const resolve of waiting.splice(0))
+            resolve();
+    };
+    const setVisibility = (mounted, next) => {
+        const previous = visibility.get(mounted);
+        if (previous === "pending")
+            pending--;
+        if (next === "pending")
+            pending++;
+        if (next === undefined)
+            visibility.delete(mounted);
+        else
+            visibility.set(mounted, next);
+        return previous;
+    };
+    const onEntries = (entries) => {
+        for (const entry of entries) {
+            const mounted = byElement.get(entry.target);
+            if (!mounted || !visibility.has(mounted))
+                continue;
+            const previous = setVisibility(mounted, entry.isIntersecting ? "in" : "out");
+            if (entry.isIntersecting && previous === "out" && quiet === 0) {
+                entered = { view: mounted, at: env.now() };
+            }
+        }
+        settle();
+    };
+    const handBack = (event) => {
+        if (event.target === agentFocus)
+            agentFocus = undefined;
+    };
+    const onInteraction = (event) => {
+        if (quiet > 0 && event.type === "focusin")
+            return;
+        if (event.type === "focusin")
+            agentFocus = undefined;
+        else
+            handBack(event);
+        const mounted = owner(event.target);
+        if (mounted)
+            interacted = { view: mounted, at: env.now() };
+    };
+    const listen = () => {
+        if (listening || !env.document)
+            return;
+        listening = true;
+        env.document.addEventListener("pointerdown", onInteraction, true);
+        env.document.addEventListener("focusin", onInteraction, true);
+        env.document.addEventListener("keydown", handBack, true);
+        env.document.addEventListener("input", onInput);
+    };
+    const observe = (mounted) => {
+        if (!mounted.element || !live.has(mounted))
+            return;
+        setVisibility(mounted, "pending");
+        observer ??= env.observeIntersections(onEntries);
+        observer?.observe(mounted.element);
+    };
+    const unobserve = (mounted) => {
+        if (setVisibility(mounted, undefined) === undefined)
+            return;
+        if (mounted.element)
+            observer?.unobserve(mounted.element);
+        settle();
+    };
+    const stackOf = (mounted, create) => {
+        const name = mounted.view.name;
+        if (!mounted.view.keyed) {
+            let stack = singles.get(name);
+            if (!stack && create)
+                singles.set(name, (stack = []));
+            return stack;
+        }
+        let byKey = keyed.get(name);
+        if (!byKey && create)
+            keyed.set(name, (byKey = new Map()));
+        const key = mounted.key ?? "";
+        let stack = byKey?.get(key);
+        if (!stack && byKey && create)
+            byKey.set(key, (stack = []));
+        return stack;
+    };
+    const removeFromStack = (mounted) => {
+        const stack = stackOf(mounted, false);
+        if (!stack)
+            return;
+        stack.splice(stack.indexOf(mounted), 1);
+        if (stack.length > 0)
+            return;
+        const name = mounted.view.name;
+        if (!mounted.view.keyed) {
+            singles.delete(name);
+            return;
+        }
+        const byKey = keyed.get(name);
+        byKey?.delete(mounted.key ?? "");
+        if (byKey?.size === 0)
+            keyed.delete(name);
+    };
+    function owner(node) {
+        for (let current = node; current; current = current.parentNode) {
+            const mounted = byElement.get(current);
+            if (mounted && live.has(mounted))
+                return mounted;
+        }
+        return undefined;
+    }
+    const replaceWrites = (mounted, writes) => {
+        mounted.writes = writes;
+        for (const listener of mounted.writeListeners)
+            listener();
+    };
+    const onInput = (event) => {
+        handBack(event);
+        const target = event.target;
+        const mounted = owner(target);
+        if (!mounted || mounted.writes.size === 0)
+            return;
+        const name = target?.getAttribute?.("name");
+        const remaining = new Map(mounted.writes);
+        if (name)
+            remaining.delete(name);
+        replaceWrites(mounted, remaining.size === 0 ? NO_AGENT_WRITES : remaining);
+    };
+    const current = (moment) => moment && live.has(moment.view) ? moment : undefined;
+    return {
+        track(view, binding) {
+            const mounted = new Mounted(view, binding);
+            return {
+                bind(next) {
+                    mounted.binding = next;
+                },
+                ref(element) {
+                    if (mounted.element === (element ?? undefined))
+                        return;
+                    unobserve(mounted);
+                    if (mounted.element)
+                        byElement.delete(mounted.element);
+                    mounted.element = element ?? undefined;
+                    if (element)
+                        byElement.set(element, mounted);
+                    observe(mounted);
+                },
+                mount(key) {
+                    mounted.key = key;
+                    live.add(mounted);
+                    stackOf(mounted, true).push(mounted);
+                    listen();
+                    observe(mounted);
+                    let mountedNow = true;
+                    return () => {
+                        if (!mountedNow)
+                            return;
+                        mountedNow = false;
+                        unobserve(mounted);
+                        removeFromStack(mounted);
+                        live.delete(mounted);
+                    };
+                },
+                subscribeWrites(listener) {
+                    mounted.writeListeners.add(listener);
+                    return () => mounted.writeListeners.delete(listener);
+                },
+                writes: () => mounted.writes,
+            };
+        },
+        find(ref) {
+            return (ref.key === undefined ? singles.get(ref.view) : keyed.get(ref.view)?.get(ref.key))?.at(-1);
+        },
+        remember(mounted, values) {
+            const target = mounted;
+            const entries = Object.entries(values).filter(([field, value]) => !target.writes.has(field) || !jsonEqual(target.writes.get(field), value));
+            if (entries.length === 0)
+                return;
+            replaceWrites(target, new Map([...target.writes, ...entries]));
+        },
+        async quietly(act) {
+            quiet++;
+            try {
+                return await act();
+            }
+            finally {
+                quiet--;
+            }
+        },
+        placeFocus(element) {
+            if (element.ownerDocument.activeElement === element)
+                return;
+            quiet++;
+            try {
+                element.focus({ preventScroll: true });
+            }
+            finally {
+                quiet--;
+            }
+            agentFocus = element;
+        },
+        restore: (mounted, writes) => replaceWrites(mounted, writes),
+        *singles() {
+            for (const stack of singles.values())
+                yield stack.at(-1);
+        },
+        *onScreenCandidates() {
+            for (const [mounted, state] of visibility) {
+                if (mounted.view.keyed && state !== "out")
+                    yield mounted;
+            }
+        },
+        keyedCount: (viewName) => keyed.get(viewName)?.size ?? 0,
+        isCurrent: (mounted) => stackOf(mounted, false)?.at(-1) === mounted,
+        owner,
+        lastEntered: () => current(entered),
+        lastInteracted: () => current(interacted),
+        agentFocus: () => agentFocus,
+        awaitingObserver: () => pending > 0 && observer !== undefined,
+        observed() {
+            if (pending === 0 || !observer)
+                return Promise.resolve();
+            return new Promise((resolve) => waiting.push(resolve));
+        },
+        resume() {
+            listen();
+            for (const mounted of live)
+                if (!visibility.has(mounted))
+                    observe(mounted);
+        },
+        dispose() {
+            observer?.disconnect();
+            observer = undefined;
+            visibility.clear();
+            agentFocus = undefined;
+            pending = 0;
+            settle();
+            if (listening && env.document) {
+                env.document.removeEventListener("pointerdown", onInteraction, true);
+                env.document.removeEventListener("focusin", onInteraction, true);
+                env.document.removeEventListener("keydown", handBack, true);
+                env.document.removeEventListener("input", onInput);
+            }
+            listening = false;
+        },
+    };
+}
+export function refOf(mounted) {
+    return mounted.key === undefined
+        ? { view: mounted.view.name }
+        : { view: mounted.view.name, key: mounted.key };
+}
+//# sourceMappingURL=registry.js.map

package/dist/client/registry.js.map

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

package/dist/client/screen.d.ts

@@ -0,0 +1,20 @@
+import type { QuerySnapshot, RouteSnapshot, ScreenSnapshot } from "../protocol.js";
+import type { BrowserEnvironment } from "./environment.js";
+import { type RegistryReader } from "./registry.js";
+export interface ScreenLimits {
+    readonly totalBytes: number;
+    readonly valueBytes: number;
+    readonly itemsPerView: number;
+    readonly selectionChars: number;
+}
+export declare const DEFAULT_SCREEN_LIMITS: ScreenLimits;
+export interface PageSources {
+    route(): RouteSnapshot | null;
+    queries(): readonly QuerySnapshot[];
+}
+export declare function measure(element: Element, env: BrowserEnvironment): {
+    shown: number;
+    score: number;
+};
+export declare function captureScreen(registry: RegistryReader, page: PageSources, env: BrowserEnvironment, limits: ScreenLimits): ScreenSnapshot;
+//# sourceMappingURL=screen.d.ts.map

package/dist/client/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/client/screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,aAAa,EAEb,aAAa,EACb,cAAc,EAKf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAY,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,aAAa,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,SAAS,aAAa,EAAE,CAAC;CACrC;AAWD,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,kBAAkB,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAclC;AA0ED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,YAAY,GACnB,cAAc,CAmEhB"}

package/dist/client/screen.js

@@ -0,0 +1,196 @@
+import { refOf } from "./registry.js";
+export const DEFAULT_SCREEN_LIMITS = {
+    totalBytes: 64 * 1024,
+    valueBytes: 8 * 1024,
+    itemsPerView: 50,
+    selectionChars: 2000,
+};
+const encoder = new TextEncoder();
+const bytesOf = (json) => encoder.encode(json).byteLength;
+export function measure(element, env) {
+    const rect = env.rect(element);
+    const { width, height } = env.viewport();
+    const area = rect.width * rect.height;
+    if (area <= 0)
+        return { shown: 0, score: 0 };
+    const top = Math.max(rect.top, 0);
+    const bottom = Math.min(rect.bottom, height);
+    const visibleHeight = Math.max(0, bottom - top);
+    const visibleWidth = Math.max(0, Math.min(rect.right, width) - Math.max(rect.left, 0));
+    const shown = Math.round(((visibleHeight * visibleWidth) / area) * 100) / 100;
+    if (shown <= 0)
+        return { shown: 0, score: 0 };
+    const half = height / 2;
+    const distance = Math.abs((top + bottom) / 2 - half);
+    return { shown, score: shown * Math.max(0, 1 - distance / half) };
+}
+function valueOf(mounted, limit) {
+    const value = mounted.binding.get();
+    const bytes = bytesOf(JSON.stringify(value));
+    return bytes > limit ? { truncated: true, bytes } : value;
+}
+function documentOrder(a, b) {
+    const x = a.mounted.element;
+    const y = b.mounted.element;
+    if (!x || !y || x === y)
+        return 0;
+    return x.compareDocumentPosition(y) & 4 ? -1 : 1;
+}
+function labelOf(element) {
+    const aria = element.getAttribute("aria-label");
+    if (aria)
+        return aria;
+    const labels = element.labels;
+    const text = (labels?.[0] ?? element.closest("label"))?.textContent?.trim();
+    return text || undefined;
+}
+function focusOf(registry, env) {
+    const active = env.document?.activeElement;
+    if (!active ||
+        active === env.document?.body ||
+        active === env.document?.documentElement) {
+        return null;
+    }
+    const owner = registry.owner(active);
+    const field = active.getAttribute("name") ?? undefined;
+    const label = labelOf(active);
+    return {
+        ...(owner ? refOf(owner) : {}),
+        ...(field ? { field } : {}),
+        ...(label ? { label } : {}),
+    };
+}
+function selectionOf(registry, env, limit) {
+    const selection = env.document?.getSelection();
+    if (!selection || selection.isCollapsed || selection.rangeCount === 0)
+        return null;
+    const owners = new Set(Array.from({ length: selection.rangeCount }, (_, index) => registry.owner(selection.getRangeAt(index).commonAncestorContainer)));
+    const [owner] = owners;
+    if (owners.size !== 1 || !owner)
+        return null;
+    const text = selection.toString();
+    if (!text)
+        return null;
+    return {
+        text: text.slice(0, limit),
+        within: refOf(owner),
+        truncated: text.length > limit,
+    };
+}
+function recent(moment, env) {
+    return moment
+        ? { ...refOf(moment.view), agoMs: Math.max(0, env.now() - moment.at) }
+        : null;
+}
+export function captureScreen(registry, page, env, limits) {
+    const views = {};
+    const singleShown = new Map();
+    let focal;
+    const consider = (candidate) => {
+        if (candidate.score > 0 && (!focal || candidate.score > focal.score))
+            focal = candidate;
+    };
+    for (const mounted of registry.singles()) {
+        const snapshot = { value: valueOf(mounted, limits.valueBytes) };
+        if (mounted.element) {
+            const measured = { mounted, ...measure(mounted.element, env) };
+            consider(measured);
+            singleShown.set(mounted.view.name, measured.shown);
+            views[mounted.view.name] = { ...snapshot, shown: measured.shown };
+        }
+        else {
+            views[mounted.view.name] = snapshot;
+        }
+    }
+    const onScreen = new Map();
+    for (const mounted of registry.onScreenCandidates()) {
+        if (!mounted.element || !registry.isCurrent(mounted))
+            continue;
+        const measured = { mounted, ...measure(mounted.element, env) };
+        if (measured.shown <= 0)
+            continue;
+        const list = onScreen.get(mounted.view.name) ?? [];
+        list.push(measured);
+        onScreen.set(mounted.view.name, list);
+    }
+    const keyed = new Map();
+    for (const [name, measured] of onScreen) {
+        measured.sort(documentOrder);
+        const listed = measured.slice(0, limits.itemsPerView);
+        for (const item of measured)
+            consider(item);
+        keyed.set(name, listed.map((item) => ({
+            key: item.mounted.key ?? "",
+            value: valueOf(item.mounted, limits.valueBytes),
+            shown: item.shown,
+        })));
+    }
+    const keyedView = (name, items) => ({
+        items,
+        offscreen: registry.keyedCount(name) - items.length,
+    });
+    for (const [name, items] of keyed)
+        views[name] = keyedView(name, items);
+    const attention = {
+        focus: focusOf(registry, env),
+        selection: selectionOf(registry, env, limits.selectionChars),
+        lastInteracted: recent(registry.lastInteracted(), env),
+        lastEntered: recent(registry.lastEntered(), env),
+        focal: focal ? refOf(focal.mounted) : null,
+    };
+    const snapshot = {
+        route: page.route(),
+        queries: page.queries(),
+        views,
+        attention,
+        truncated: false,
+    };
+    return fitBudget(snapshot, keyed, singleShown, keyedView, limits.totalBytes);
+}
+function fitBudget(snapshot, keyed, singleShown, keyedView, totalBytes) {
+    let size = bytesOf(JSON.stringify(snapshot));
+    if (size <= totalBytes)
+        return snapshot;
+    const views = { ...snapshot.views };
+    const byShown = [...keyed].flatMap(([name, items]) => items.map((item) => ({ name, item })));
+    byShown.sort((a, b) => a.item.shown - b.item.shown);
+    const dropped = new Set();
+    let next = 0;
+    while (size > totalBytes && next < byShown.length) {
+        const { item } = byShown[next++];
+        dropped.add(item);
+        size -= bytesOf(JSON.stringify(item)) + 1;
+    }
+    const withoutDropped = () => {
+        for (const [name, items] of keyed) {
+            views[name] = keyedView(name, items.filter((item) => !dropped.has(item)));
+        }
+        return { ...snapshot, views, truncated: true };
+    };
+    let fitted = withoutDropped();
+    const fits = () => bytesOf(JSON.stringify(fitted)) <= totalBytes;
+    while (!fits() && next < byShown.length) {
+        dropped.add(byShown[next++].item);
+        fitted = withoutDropped();
+    }
+    if (fits())
+        return fitted;
+    fitted = { ...fitted, queries: [] };
+    if (fits())
+        return fitted;
+    for (const name of [...singleShown.keys()].sort((a, b) => singleShown.get(a) - singleShown.get(b))) {
+        delete views[name];
+        if (fits())
+            return fitted;
+    }
+    for (const name of Object.keys(views))
+        delete views[name];
+    if (fits())
+        return fitted;
+    return {
+        ...fitted,
+        route: fitted.route?.notFound === false ? { ...fitted.route, search: {} } : fitted.route,
+        attention: { ...fitted.attention, selection: null },
+    };
+}
+//# sourceMappingURL=screen.js.map

package/dist/client/screen.js.map

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

package/dist/client/write.d.ts

@@ -0,0 +1,13 @@
+import type { UiError, UiOpInput, UiOpResults } from "../protocol.js";
+import type { BrowserEnvironment } from "./environment.js";
+import { jsonEqual } from "./json-equal.js";
+import type { AgentWrites, MountedView, ViewRegistryRuntime } from "./registry.js";
+export { jsonEqual };
+export declare function notMounted(input: {
+    view: string;
+    key?: string | undefined;
+}): UiError;
+export declare function userEditing(registry: Pick<ViewRegistryRuntime, "owner" | "agentFocus">, target: MountedView, changed: readonly string[], env: Pick<BrowserEnvironment, "document">): readonly string[];
+export declare function agentFieldsOf(writes: AgentWrites, current: Readonly<Record<string, unknown>>): ReadonlySet<string>;
+export declare function setView(registry: ViewRegistryRuntime, input: UiOpInput<"set">, env: Pick<BrowserEnvironment, "document">): Promise<UiOpResults["set"] | UiError>;
+//# sourceMappingURL=write.d.ts.map

package/dist/client/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/client/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAMrF;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,YAAY,CAAC,EAC3D,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GACxC,SAAS,MAAM,EAAE,CASnB;AAID,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACzC,WAAW,CAAC,MAAM,CAAC,CAKrB;AA+BD,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EACvB,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GACxC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAqDvC"}

package/dist/client/write.js

@@ -0,0 +1,101 @@
+import { jsonEqual } from "./json-equal.js";
+export { jsonEqual };
+export function notMounted(input) {
+    const target = input.key === undefined ? input.view : `${input.view} ${input.key}`;
+    return {
+        code: "not_mounted",
+        message: `${target} is not on screen. Call ui_screen to see what is.`,
+    };
+}
+export function userEditing(registry, target, changed, env) {
+    const document = env.document;
+    if (!document?.hasFocus())
+        return [];
+    const active = document.activeElement;
+    if (!active || active === registry.agentFocus() || registry.owner(active) !== target) {
+        return [];
+    }
+    const name = active.getAttribute("name");
+    return name !== null && changed.includes(name) ? [name] : [];
+}
+const NO_FIELDS = new Set();
+export function agentFieldsOf(writes, current) {
+    if (writes.size === 0)
+        return NO_FIELDS;
+    return new Set([...writes.keys()].filter((field) => jsonEqual(current[field], writes.get(field))));
+}
+function refused(view, fields, detail) {
+    return {
+        code: "not_writable",
+        message: `${view.name}: ${detail}`,
+        issues: fields.map((path) => ({ path, message: "Not writable" })),
+    };
+}
+function unlistedFields(view, changed) {
+    const { writable } = view;
+    if (writable === true)
+        return [];
+    return changed.filter((field) => writable === false || !writable.includes(field));
+}
+function writableDetail(view) {
+    const { writable } = view;
+    return writable === false || writable === true || writable.length === 0
+        ? "this view is read-only."
+        : `only ${writable.join(", ")} can be written.`;
+}
+const pick = (source, fields) => Object.fromEntries(fields.filter((f) => Object.hasOwn(source, f)).map((f) => [f, source[f]]));
+const segmentOf = (segment) => String(typeof segment === "object" ? segment.key : segment);
+export async function setView(registry, input, env) {
+    const target = registry.find(input);
+    if (!target)
+        return notMounted(input);
+    const { view, binding } = target;
+    const changed = Object.keys(input.value);
+    const unlisted = unlistedFields(view, changed);
+    if (unlisted.length > 0 || !binding.set) {
+        return refused(view, unlisted.length > 0 ? unlisted : changed, writableDetail(view));
+    }
+    const editing = userEditing(registry, target, changed, env);
+    if (editing.length > 0) {
+        return {
+            code: "user_editing",
+            message: `The user is typing in ${editing.join(", ")}. Wait, or ask them.`,
+            issues: editing.map((path) => ({ path, message: "The user is typing here." })),
+        };
+    }
+    const checked = await view.schema["~standard"].validate({
+        ...binding.get(),
+        ...input.value,
+    });
+    if (checked.issues) {
+        return {
+            code: "invalid_value",
+            message: `${view.name} would be invalid with this value.`,
+            issues: checked.issues.map(({ path, message }) => ({
+                path: path?.map(segmentOf).join(".") ?? "",
+                message,
+            })),
+        };
+    }
+    const parsed = checked.value;
+    const dropped = changed.filter((field) => !Object.hasOwn(parsed, field));
+    if (dropped.length > 0) {
+        return refused(view, dropped, `${dropped.join(", ")} is not a field of this view.`);
+    }
+    const accepted = pick(parsed, changed);
+    const previous = target.writes;
+    registry.remember(target, accepted);
+    try {
+        await binding.set(parsed, changed);
+    }
+    catch (error) {
+        registry.restore(target, previous);
+        throw error;
+    }
+    const value = registry.find(input)?.binding.get() ?? parsed;
+    const normalised = changed.filter((field) => !jsonEqual(value[field], accepted[field]));
+    if (normalised.length > 0)
+        registry.remember(target, pick(value, normalised));
+    return { value, agentFields: [...agentFieldsOf(target.writes, value)] };
+}
+//# sourceMappingURL=write.js.map