@simmalugnt-se/payload-editor-assistant 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.9.0
+
+- Translation: on a document with localized text that is empty in the open language but filled in
+  the default one, the panel offers "Translate from English" ("Översätt från engelska"). The
+  assistant fills every such field in one proposal, rich text with its formatting and links, and
+  leaves translated fields alone unless asked to translate them again. The model is told which
+  fields to fill and which are translated already, instead of an 80-character preview of each
+  source, and replies in the editor's language rather than the one it translates into.
+- New endpoint `GET /api/editor-assistant/translation` says whether the open document has fields
+  to translate, and from which language.
+- Other language versions are read without fallback, as Admin reads them, and a language with no
+  text of its own is left out of the model's context.
+
+- Replies show their Markdown as formatting instead of asterisks: paragraphs, bullet and numbered
+  lists, bold, italic and code. Headings show as bold lines, and links as their text, with a web
+  address written out after it; the panel makes no link the model wrote clickable.
+- A reply keeps its line breaks. Before, filtering the model's reply joined it into one line, so a
+  list ran together.
+
+## 0.8.0
+
+- Rich text keeps its formatting. The model reads Lexical as Markdown blocks, one per paragraph,
+  heading or list, and changes single blocks (`set` on `content.2`, `array.insert`,
+  `array.remove`); every other block stays exactly as stored, alignment and styles included.
+  Headings, lists, bold, italic and links come back through Payload's own converters with the
+  field's editor config. Internal links read and write as `[text](doc:pages/12)` and are checked
+  against the field's `LinkFeature` collections and the editor's access. Parts Markdown cannot
+  express (embedded uploads, relationships, custom blocks) are kept, and may be moved or removed but
+  not changed. Before, any change to rich text turned it into plain paragraphs.
+- New optional peer dependency `@payloadcms/richtext-lexical`; without it, rich text works as before.
+- The change list shows which parts of a rich text field changed.
+- A list that is not rich text blocks is refused for a rich text field instead of reaching the form.
+- `validateProposal` receives the data as it will be stored, rich text as Lexical, instead of the
+  compiled operations' raw values.
+
 ## 0.7.0
 
 - Picks images for upload fields, such as a share image. `content.find` on an upload collection

package/README.md

@@ -117,6 +117,27 @@ The suggested change names the image ("Image: empty → office-2024.jpg"), and t
 Preview show it. Images with alt texts are easier to find. Fields with several images (`hasMany`)
 are not picked yet.
 
+## Rich text
+
+With `@payloadcms/richtext-lexical` installed, the assistant reads Lexical rich text as Markdown,
+one block per paragraph, heading or list, and changes only the blocks it is asked to: headings,
+lists, bold, italic and links survive, and every other block stays exactly as stored. It writes only
+what the field's editor allows. Internal links keep pointing at their documents, and new ones must
+point at a collection the field's `LinkFeature` allows and that the editor can read. Parts Markdown
+cannot express, such as an embedded image, are kept as they are. Without the package, rich text is
+written as plain paragraphs as before.
+
+## Translation
+
+In a localized project, the assistant translates a document from the default language into the one
+open in Admin. On a document with localized text that is empty here but filled in the default
+language, the panel offers a button ("Translate from English"). The editor can also ask in the
+chat, or start from content health's work list. It fills every empty localized field in one
+proposal, rich text as Markdown blocks with headings, lists, bold, italic and links kept, and leaves
+fields that already have text alone unless asked to translate them again. Fields shared between the
+languages (blocks, images, slugs) never change. The button asks `GET /api/editor-assistant/translation`
+whether there is anything to translate, with the editor's access.
+
 ## Keep or undo
 
 A proposed form change goes straight into the open form, so the fields and Live Preview show it

package/dist/components/EditorAssistantAside.js

@@ -7,9 +7,11 @@ import { resolveChatLanguage } from "../runtime/language.js";
 import { parseAdminView } from "../view.js";
 import { assistantRequest, assistantStream } from "./assistant-api.js";
 import { useAssistantState, } from "./assistant-context.js";
-import { COPY, uiLanguage } from "./copy.js";
+import { COPY, translateAction, uiLanguage } from "./copy.js";
 import { isFormProposal, proposalSteps, refineProposal, replaceLatestStep, } from "./proposal-chain.js";
+import { ReplyText } from "./ReplyText.js";
 import { KEEP_SELECTION_ATTR } from "./selection-dom.js";
+import { useTranslationOffer } from "./translation-offer.js";
 export function EditorAssistantAside() {
     const { open, setOpen, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, selection, setSelection, prefill, setPrefill, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, } = useAssistantState();
     const { config, getEntityConfig } = useConfig();
@@ -39,6 +41,12 @@ export function EditorAssistantAside() {
     const [step, setStep] = useState(null);
     const stickToBottomRef = useRef(true);
     const apiBase = config.routes.api;
+    // The offer compares saved versions, so it waits while the form has unsaved changes and asks
+    // again once they are saved or after a message: a kept translation takes the button away.
+    const offer = useTranslationOffer(apiBase, bridge ?? undefined, `${messages.length}:${bridge?.modified ? 1 : 0}`);
+    const translate = offer?.source && offer.empty > 0 && !pendingApproval && !bridge?.modified
+        ? translateAction(uiLanguage(i18n.language), offer.source)
+        : undefined;
     // Scroll when the thread grows. The values are triggers, not reads.
     // biome-ignore lint/correctness/useExhaustiveDependencies: pin to bottom after new messages, working state, or approval cards
     useLayoutEffect(() => {
@@ -434,15 +442,17 @@ export function EditorAssistantAside() {
     if (!open) {
         return null;
     }
-    return (_jsxs("aside", { className: "ea-aside", "aria-label": copy.assistant, [KEEP_SELECTION_ATTR]: "", children: [_jsxs("div", { className: "ea-aside__head", children: [_jsxs("div", { className: "ea-aside__title", children: [_jsx("h2", { children: copy.assistant }), bridge ? _jsx("p", { className: "ea-aside__context", children: contextLine(bridge, config) }) : null] }), (messages.length > 0 || pendingApproval) && !pendingApproval?.applied ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => resetConversation(), size: "medium", children: copy.newChat })) : null, _jsx(Button, { "aria-label": copy.collapseLabel, buttonStyle: "icon-label", className: "ea-aside__collapse", icon: _jsx(ChevronIcon, { direction: "right" }), margin: false, onClick: () => setOpen(false), tooltip: copy.collapse })] }), _jsxs("div", { className: "ea-aside__body", children: [_jsxs("div", { className: "ea-messages", ref: threadRef, onScroll: onThreadScroll, children: [messages.length === 0 ? (_jsx("div", { className: "ea-msg ea-msg--assistant", children: introText(view, bridge, collections, config, copy) })) : null, messages.map((message) => (_jsxs("div", { className: `ea-msg ea-msg--${message.role}`, children: [message.text, message.candidates?.length ? (_jsx("div", { className: "ea-actions", children: message.candidates.map((candidate) => (_jsx(Button, { buttonStyle: "pill", margin: false, onClick: () => {
+    return (_jsxs("aside", { className: "ea-aside", "aria-label": copy.assistant, [KEEP_SELECTION_ATTR]: "", children: [_jsxs("div", { className: "ea-aside__head", children: [_jsxs("div", { className: "ea-aside__title", children: [_jsx("h2", { children: copy.assistant }), bridge ? _jsx("p", { className: "ea-aside__context", children: contextLine(bridge, config) }) : null] }), (messages.length > 0 || pendingApproval) && !pendingApproval?.applied ? (_jsx(Button, { buttonStyle: "subtle", margin: false, onClick: () => resetConversation(), size: "medium", children: copy.newChat })) : null, _jsx(Button, { "aria-label": copy.collapseLabel, buttonStyle: "icon-label", className: "ea-aside__collapse", icon: _jsx(ChevronIcon, { direction: "right" }), margin: false, onClick: () => setOpen(false), tooltip: copy.collapse })] }), _jsxs("div", { className: "ea-aside__body", children: [_jsxs("div", { className: "ea-messages", ref: threadRef, onScroll: onThreadScroll, children: [messages.length === 0 ? (_jsx("div", { className: "ea-msg ea-msg--assistant", children: introText(view, bridge, collections, config, copy) })) : null, messages.map((message) => (_jsxs("div", { className: `ea-msg ea-msg--${message.role}`, children: [message.role === "assistant" ? _jsx(ReplyText, { text: message.text }) : message.text, message.candidates?.length ? (_jsx("div", { className: "ea-actions", children: message.candidates.map((candidate) => (_jsx(Button, { buttonStyle: "pill", margin: false, onClick: () => {
                                                 router.push(candidate.href);
                                             }, size: "small", children: candidate.label }, candidate.href))) })) : null] }, message.id))), status === "streaming" ? (_jsxs("div", { className: "ea-msg ea-msg--working", children: [_jsxs("span", { className: "ea-dots", "aria-hidden": "true", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }), _jsx("span", { children: step ? talk.steps[step] : talk.working })] })) : null] }), pendingApproval ? (_jsxs("div", { className: "ea-approval", children: [_jsx("h3", { children: pendingApproval.title }), pendingApproval.applied ? (_jsxs("p", { className: "ea-approval__hint", children: [autosave ? copy.previewHintAutosave : copy.previewHint, pendingApproval.earlier?.length ? ` ${copy.refinedHint}` : ""] })) : null, _jsx("ul", { className: "ea-approval__diff", children: pendingApproval.summary.split("\n").map((line, index) => line.startsWith("  ") ? (
                                 // biome-ignore lint/suspicious/noArrayIndexKey: lines are static for one approval
                                 _jsx("li", { className: "ea-approval__sub", children: line.trim() }, index)) : (
                                 // biome-ignore lint/suspicious/noArrayIndexKey: lines are static for one approval
-                                _jsx("li", { children: line }, index))) }), confirmUndo ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "ea-approval__warn", children: copy.undoLosesEdits }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", margin: false, onClick: () => void undoPreview(pendingApproval, true), size: "medium", children: copy.undoAnyway }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => setConfirmUndo(false), size: "medium", children: copy.cancel })] })] })) : (_jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", disabled: status === "streaming", margin: false, onClick: () => void decide("approve"), size: "medium", children: pendingApproval.applied ? copy.keep : copy.approve }), _jsx(Button, { buttonStyle: "secondary", disabled: status === "streaming", margin: false, onClick: () => void decide("reject"), size: "medium", children: pendingApproval.applied ? copy.undo : copy.reject })] }))] })) : null, status !== "idle" && status !== "streaming" ? (_jsx("div", { className: `ea-status ea-status--${status}`, children: statusText(status, talk) })) : null, _jsxs("form", { className: "ea-composer", onSubmit: onSubmit, children: [visibleShortcuts.length > 0 ? (_jsx("div", { className: "ea-shortcuts", children: visibleShortcuts.map((shortcut) => (_jsx(Button, { buttonStyle: "pill", disabled: status === "streaming", margin: false, onClick: () => {
-                                        void send(shortcut.prompt);
-                                    }, size: "small", children: shortcut.label }, shortcut.id))) })) : null, selection && bridge ? (_jsxs("div", { className: "ea-selection", children: [_jsxs("span", { className: "ea-selection__label", children: [copy.selected, ": ", _jsx("strong", { children: selection.label })] }), _jsx("button", { "aria-label": copy.clearSelection, className: "ea-selection__clear", type: "button", onClick: () => setSelection(null), children: _jsx(XIcon, {}) })] })) : null, _jsxs("div", { className: "ea-composer__box", children: [_jsx("textarea", { disabled: status === "streaming", placeholder: copy.placeholder, rows: 2, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: onKeyDown }), _jsx("div", { className: "ea-composer__bar", children: status === "streaming" ? (
+                                _jsx("li", { children: line }, index))) }), confirmUndo ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "ea-approval__warn", children: copy.undoLosesEdits }), _jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", margin: false, onClick: () => void undoPreview(pendingApproval, true), size: "medium", children: copy.undoAnyway }), _jsx(Button, { buttonStyle: "secondary", margin: false, onClick: () => setConfirmUndo(false), size: "medium", children: copy.cancel })] })] })) : (_jsxs("div", { className: "ea-actions", children: [_jsx(Button, { buttonStyle: "primary", disabled: status === "streaming", margin: false, onClick: () => void decide("approve"), size: "medium", children: pendingApproval.applied ? copy.keep : copy.approve }), _jsx(Button, { buttonStyle: "secondary", disabled: status === "streaming", margin: false, onClick: () => void decide("reject"), size: "medium", children: pendingApproval.applied ? copy.undo : copy.reject })] }))] })) : null, status !== "idle" && status !== "streaming" ? (_jsx("div", { className: `ea-status ea-status--${status}`, children: statusText(status, talk) })) : null, _jsxs("form", { className: "ea-composer", onSubmit: onSubmit, children: [visibleShortcuts.length > 0 || translate ? (_jsxs("div", { className: "ea-shortcuts", children: [translate ? (_jsx(Button, { buttonStyle: "pill", disabled: status === "streaming", margin: false, onClick: () => {
+                                            void send(translate.prompt);
+                                        }, size: "small", children: translate.label })) : null, visibleShortcuts.map((shortcut) => (_jsx(Button, { buttonStyle: "pill", disabled: status === "streaming", margin: false, onClick: () => {
+                                            void send(shortcut.prompt);
+                                        }, size: "small", children: shortcut.label }, shortcut.id)))] })) : null, selection && bridge ? (_jsxs("div", { className: "ea-selection", children: [_jsxs("span", { className: "ea-selection__label", children: [copy.selected, ": ", _jsx("strong", { children: selection.label })] }), _jsx("button", { "aria-label": copy.clearSelection, className: "ea-selection__clear", type: "button", onClick: () => setSelection(null), children: _jsx(XIcon, {}) })] })) : null, _jsxs("div", { className: "ea-composer__box", children: [_jsx("textarea", { disabled: status === "streaming", placeholder: copy.placeholder, rows: 2, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: onKeyDown }), _jsx("div", { className: "ea-composer__bar", children: status === "streaming" ? (
                                         // While the assistant works, Send becomes Stop, where the editor's eye already is.
                                         _jsx(Button, { "aria-label": copy.stop, buttonStyle: "secondary", className: "ea-composer__stop", icon: _jsx("span", { className: "ea-stop-icon", "aria-hidden": "true" }), iconPosition: "left", margin: false, onClick: () => stop(), size: "medium", type: "button", children: copy.stop })) : (_jsx(Button, { buttonStyle: "primary", disabled: draft.trim() === "", margin: false, size: "medium", type: "submit", children: copy.send })) })] })] })] })] }));
 }

package/dist/components/ReplyText.d.ts

@@ -0,0 +1,4 @@
+/** An assistant reply with the model's Markdown shown as formatting instead of asterisks. */
+export declare function ReplyText({ text }: {
+    text: string;
+}): import("react").JSX.Element[];

package/dist/components/ReplyText.js

@@ -0,0 +1,26 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { parseReply } from "./reply-markdown.js";
+/** An assistant reply with the model's Markdown shown as formatting instead of asterisks. */
+export function ReplyText({ text }) {
+    return parseReply(text).map((block, index) => {
+        const key = `${block.type}-${index}`;
+        if (block.type === "paragraph") {
+            return (_jsx("p", { className: "ea-reply__p", children: spans(block.spans) }, key));
+        }
+        const items = block.items.map((item, itemIndex) => _jsx("li", { children: spans(item) }, itemIndex));
+        return block.ordered ? (_jsx("ol", { className: "ea-reply__list", start: block.start, children: items }, key)) : (_jsx("ul", { className: "ea-reply__list", children: items }, key));
+    });
+}
+function spans(list) {
+    return list.map((span, index) => {
+        let node = span.text;
+        if (span.code)
+            node = _jsx("code", { children: node });
+        if (span.italic)
+            node = _jsx("em", { children: node });
+        if (span.bold)
+            node = _jsx("strong", { children: node });
+        return _jsx("span", { children: node }, index);
+    });
+}

package/dist/components/copy.d.ts

@@ -133,3 +133,11 @@ export declare const COPY: {
     };
 };
 export type Copy = (typeof COPY)[UiLanguage];
+/**
+ * The button the panel offers on a document with fields not translated yet. Its prompt is the one
+ * content health's work list sends for a missing translation.
+ */
+export declare function translateAction(language: UiLanguage, source: string): {
+    label: string;
+    prompt: string;
+};

package/dist/components/copy.js

@@ -133,3 +133,21 @@ export const COPY = {
         },
     },
 };
+/**
+ * The button the panel offers on a document with fields not translated yet. Its prompt is the one
+ * content health's work list sends for a missing translation.
+ */
+export function translateAction(language, source) {
+    const name = languageName(language, source);
+    return language === "sv"
+        ? { label: `Översätt från ${name}`, prompt: `Översätt de tomma fälten från ${name}.` }
+        : { label: `Translate from ${name}`, prompt: `Translate the empty fields from ${name}.` };
+}
+function languageName(language, code) {
+    try {
+        return new Intl.DisplayNames([language], { type: "language" }).of(code) ?? code;
+    }
+    catch {
+        return code;
+    }
+}

package/dist/components/reply-markdown.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The Markdown the model writes in its replies, read into a small tree the panel renders as React
+ * elements: paragraphs, lists, bold, italic and code. Headings show as bold paragraphs. Links show as
+ * their text, and a web address stays visible after it, so the panel never renders a link the model
+ * wrote. A marker that does not close stays as text, so a half-streamed reply reads the same.
+ */
+export type ReplySpan = {
+    text: string;
+    bold?: true;
+    italic?: true;
+    code?: true;
+};
+export type ReplyBlock = {
+    type: "paragraph";
+    spans: ReplySpan[];
+} | {
+    type: "list";
+    ordered: false;
+    items: ReplySpan[][];
+} | {
+    type: "list";
+    ordered: true;
+    start: number;
+    items: ReplySpan[][];
+};
+export declare function parseReply(text: string): ReplyBlock[];

package/dist/components/reply-markdown.js

@@ -0,0 +1,142 @@
+/**
+ * The Markdown the model writes in its replies, read into a small tree the panel renders as React
+ * elements: paragraphs, lists, bold, italic and code. Headings show as bold paragraphs. Links show as
+ * their text, and a web address stays visible after it, so the panel never renders a link the model
+ * wrote. A marker that does not close stays as text, so a half-streamed reply reads the same.
+ */
+const BULLET = /^\s*[-*+]\s+(.*)$/;
+const NUMBERED = /^\s*(\d{1,9})[.)]\s+(.*)$/;
+const HEADING = /^\s*#{1,6}\s+(.*?)\s*#*\s*$/;
+const WORD = /[\p{L}\p{N}]/u;
+export function parseReply(text) {
+    const blocks = [];
+    let paragraph = [];
+    let list;
+    const flush = () => {
+        if (paragraph.length) {
+            blocks.push({ type: "paragraph", spans: parseInline(paragraph.join("\n")) });
+        }
+        if (list) {
+            const items = list.items.map((item) => parseInline(item));
+            blocks.push(list.ordered
+                ? { type: "list", ordered: true, start: list.start, items }
+                : { type: "list", ordered: false, items });
+        }
+        paragraph = [];
+        list = undefined;
+    };
+    for (const line of text.split(/\r?\n/)) {
+        const numbered = NUMBERED.exec(line);
+        const bullet = numbered ? undefined : BULLET.exec(line);
+        if (numbered || bullet) {
+            const ordered = Boolean(numbered);
+            if (paragraph.length || (list && list.ordered !== ordered))
+                flush();
+            list ??= { ordered, start: numbered ? Number(numbered[1]) : 1, items: [] };
+            list.items.push((numbered ? numbered[2] : bullet?.[1]) ?? "");
+            continue;
+        }
+        if (list)
+            flush();
+        const heading = HEADING.exec(line);
+        if (heading) {
+            flush();
+            blocks.push({ type: "paragraph", spans: parseInline(heading[1] ?? "", { bold: true }) });
+        }
+        else if (line.trim() === "") {
+            flush();
+        }
+        else {
+            paragraph.push(line);
+        }
+    }
+    flush();
+    return blocks;
+}
+function parseInline(text, format = {}) {
+    const spans = [];
+    const push = (value, spanFormat) => {
+        if (!value)
+            return;
+        const last = spans.at(-1);
+        if (last && sameFormat(last, spanFormat))
+            last.text += value;
+        else
+            spans.push({ text: value, ...spanFormat });
+    };
+    const pushAll = (inner) => {
+        for (const { text: value, ...spanFormat } of inner)
+            push(value, spanFormat);
+    };
+    let i = 0;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === "`") {
+            const end = text.indexOf("`", i + 1);
+            if (end > i + 1) {
+                push(text.slice(i + 1, end), { ...format, code: true });
+                i = end + 1;
+                continue;
+            }
+        }
+        else if (ch === "[") {
+            const link = /^\[([^\]]+)\]\(([^)\s]+)\)/.exec(text.slice(i));
+            if (link) {
+                pushAll(parseInline(link[1] ?? "", format));
+                const href = link[2] ?? "";
+                if (/^https?:\/\//i.test(href))
+                    push(` (${href})`, format);
+                i += link[0].length;
+                continue;
+            }
+        }
+        else if (ch === "*" || ch === "_") {
+            const double = text[i + 1] === ch;
+            const size = double ? 2 : 1;
+            const end = opens(text, i, ch, size) ? closing(text, i + size, ch, size) : -1;
+            if (end > -1) {
+                const inner = double
+                    ? { ...format, bold: true }
+                    : { ...format, italic: true };
+                pushAll(parseInline(text.slice(i + size, end), inner));
+                i = end + size;
+                continue;
+            }
+            // A marker that does not open or close is text, and so is the whole run of it.
+            push(text.slice(i, i + size), format);
+            i += size;
+            continue;
+        }
+        push(ch ?? "", format);
+        i += 1;
+    }
+    return spans;
+}
+function opens(text, at, ch, size) {
+    const next = text[at + size];
+    if (!next || /\s/.test(next) || (size === 1 && next === ch))
+        return false;
+    return ch !== "_" || !WORD.test(text[at - 1] ?? "");
+}
+/** Where the marker that closes one opened before `from` starts, or -1. */
+function closing(text, from, ch, size) {
+    for (let i = from + 1; i < text.length; i += 1) {
+        if (text[i] !== ch)
+            continue;
+        const before = text[i - 1] ?? "";
+        const after = text[i + size] ?? "";
+        if (/\s/.test(before) || after === ch)
+            continue;
+        if (size === 2 && text[i + 1] !== ch)
+            continue;
+        if (size === 1 && before === ch)
+            continue;
+        if (ch === "_" && WORD.test(after))
+            continue;
+        return i;
+    }
+    return -1;
+}
+function sameFormat(a, b) {
+    return a.bold === b.bold && a.italic === b.italic && a.code === b.code;
+}

package/dist/components/translation-offer.d.ts

@@ -0,0 +1,16 @@
+export type TranslationOffer = {
+    source?: string;
+    empty: number;
+};
+type Target = {
+    collectionSlug?: string;
+    globalSlug?: string;
+    documentId?: string | number;
+    locale: string;
+};
+/**
+ * Whether the open document has fields to translate from the default language, asked again when
+ * `refresh` changes (a new message, a kept or undone proposal). Undefined until known or on error.
+ */
+export declare function useTranslationOffer(apiBase: string, target: Target | undefined, refresh: unknown): TranslationOffer | undefined;
+export {};

package/dist/components/translation-offer.js

@@ -0,0 +1,38 @@
+"use client";
+import { useEffect, useState } from "react";
+import { ENDPOINT_PREFIX } from "../package-name.js";
+/**
+ * Whether the open document has fields to translate from the default language, asked again when
+ * `refresh` changes (a new message, a kept or undone proposal). Undefined until known or on error.
+ */
+export function useTranslationOffer(apiBase, target, refresh) {
+    const [offer, setOffer] = useState();
+    const collection = target?.collectionSlug;
+    const global = target?.globalSlug;
+    const id = target?.documentId;
+    const locale = target?.locale;
+    // biome-ignore lint/correctness/useExhaustiveDependencies: `refresh` only asks again.
+    useEffect(() => {
+        setOffer(undefined);
+        if (!locale || (!global && (!collection || id === undefined))) {
+            return;
+        }
+        const params = new URLSearchParams({ locale });
+        if (collection)
+            params.set("collection", collection);
+        if (global)
+            params.set("global", global);
+        if (id !== undefined)
+            params.set("id", String(id));
+        const controller = new AbortController();
+        fetch(`${apiBase}${ENDPOINT_PREFIX}/translation?${params}`, {
+            credentials: "include",
+            signal: controller.signal,
+        })
+            .then((response) => response.ok ? response.json() : undefined)
+            .then((result) => setOffer(result))
+            .catch(() => undefined);
+        return () => controller.abort();
+    }, [apiBase, collection, global, id, locale, refresh]);
+    return offer;
+}

package/dist/domain/content.js

@@ -85,6 +85,8 @@ export async function findContentById(req, options, input) {
                 slug: input.global,
                 depth: 0,
                 locale: input.locale,
+                // As Admin reads it: a field nobody filled in this language is empty, not another's text.
+                fallbackLocale: false,
                 draft: true,
                 req,
                 user: req.user,
@@ -105,6 +107,7 @@ export async function findContentById(req, options, input) {
             id: input.documentId,
             depth: 0,
             locale: input.locale,
+            fallbackLocale: false,
             draft: true,
             req,
             user: req.user,

package/dist/domain/decide.js

@@ -1,7 +1,8 @@
 import { compileOperations } from "../form/compile.js";
 import { hashFormRevision } from "../form/hash.js";
 import { isFormOperation } from "../form/operations.js";
-import { finalizeCompiled } from "../form/shape.js";
+import { loadRichText } from "../form/rich-text.js";
+import { finalizeCompiled, openRichText } from "../form/shape.js";
 import { DEFAULT_APPROVAL_SLUG } from "../package-name.js";
 import { entityFields } from "../schema/discover.js";
 import { hasCapability, resolveAllowlist } from "./allowlist.js";
@@ -9,6 +10,7 @@ import { writeAudit } from "./audit.js";
 import { localApi } from "./local-api.js";
 import { verifyDocumentRelations } from "./relations.js";
 export async function decideChange(req, options, input) {
+    await loadRichText();
     const actor = String(req.user?.id);
     const found = await localApi(req).findByID({
         collection: DEFAULT_APPROVAL_SLUG,
@@ -67,7 +69,11 @@ export async function decideChange(req, options, input) {
             return { ok: false, error: "stale_context", message: "The form changed before approval." };
         }
     }
-    const compiled = compileOperations(current, operations, {
+    const fields = entityFields(req, options, {
+        collection: record.targetCollection ?? undefined,
+        global: record.targetGlobal ?? undefined,
+    });
+    const compiled = compileOperations(openRichText(current, fields), operations, {
         allowlist: resolved.allowlist.fields,
         denyFields: options.denyFields,
     });
@@ -80,16 +86,12 @@ export async function decideChange(req, options, input) {
         await consume(req, record.id, "failed");
         return { ok: false, error: "tool_denied", message: "Proposal hash mismatch." };
     }
-    const fields = entityFields(req, options, {
-        collection: record.targetCollection ?? undefined,
-        global: record.targetGlobal ?? undefined,
-    });
-    const finalized = finalizeCompiled(compiled.data, fields);
+    const finalized = finalizeCompiled(compiled.data, fields, current);
     if (!finalized.ok) {
         await consume(req, record.id, "failed");
         return { ok: false, error: "tool_denied", message: finalized.error };
     }
-    const relations = await verifyDocumentRelations(req, fields, finalized.data);
+    const relations = await verifyDocumentRelations(req, fields, finalized.data, finalized.links);
     if (!relations.ok) {
         await consume(req, record.id, "failed");
         return { ok: false, error: "tool_denied", message: relations.message };

package/dist/domain/propose.js

@@ -1,12 +1,14 @@
 import { changedPaths } from "../form/changed-paths.js";
 import { compileOperations } from "../form/compile.js";
-import { humanDiff } from "../form/diff.js";
+import { humanDiff, richTextLines } from "../form/diff.js";
 import { hashFormRevision } from "../form/hash.js";
 import { isFormOperation, normalizeOperations } from "../form/operations.js";
 import { getAtPath, parseFieldPath } from "../form/path.js";
-import { finalizeCompiled } from "../form/shape.js";
+import { loadRichText, toBlocks } from "../form/rich-text.js";
+import { finalizeCompiled, openRichText } from "../form/shape.js";
 import { DEFAULT_APPROVAL_SLUG } from "../package-name.js";
 import { entityFields, findCollectionConfig, hasDrafts } from "../schema/discover.js";
+import { fieldAtPath } from "../schema/fields.js";
 import { hasCapability, resolveAllowlist } from "./allowlist.js";
 import { writeAudit } from "./audit.js";
 import { findContentById } from "./content.js";
@@ -15,6 +17,7 @@ import { labelRelations, verifyDocumentRelations } from "./relations.js";
 /** Long enough to look at a change in the preview before keeping it. */
 const TTL_MS = 30 * 60_000;
 export async function proposeChange(req, options, input) {
+    await loadRichText();
     const resolved = resolveAllowlist(options, input);
     if (!resolved || !hasCapability(resolved.allowlist, input.capability)) {
         return { ok: false, error: "tool_denied", message: "Capability is not allowlisted." };
@@ -25,37 +28,43 @@ export async function proposeChange(req, options, input) {
     }
     const typedOperations = operations;
     const current = await resolveCurrentForm(req, options, input);
-    const compiled = compileOperations(current, typedOperations, {
+    const fields = entityFields(req, options, {
+        collection: input.collection,
+        global: input.global,
+    });
+    // Rich text opens into blocks, so operations can reach one block and leave the rest as stored.
+    const compiled = compileOperations(openRichText(current, fields), typedOperations, {
         allowlist: resolved.allowlist.fields,
         denyFields: options.denyFields,
     });
     if (!compiled.ok) {
         return { ok: false, error: "tool_denied", message: compiled.error };
     }
-    if (options.validateProposal) {
-        const extra = await options.validateProposal({
-            operations: typedOperations,
-            data: compiled.data,
-        });
-        if (!extra.ok) {
-            return { ok: false, error: "tool_denied", message: extra.errors.join(" ") };
-        }
-    }
     if (input.capability === "draft.create") {
         const blocked = draftCreateDenied(req, input.collection);
         if (blocked) {
             return { ok: false, error: "tool_denied", message: blocked };
         }
     }
-    const fields = entityFields(req, options, {
-        collection: input.collection,
-        global: input.global,
-    });
-    const finalized = finalizeCompiled(compiled.data, fields);
+    const richTextBefore = richTextPaths(typedOperations, fields, current).map((path) => ({
+        path,
+        blocks: storedBlocks(fields, path, current),
+        after: getAtPath(compiled.data, parseFieldPath(path)),
+    }));
+    const finalized = finalizeCompiled(compiled.data, fields, current);
     if (!finalized.ok) {
         return { ok: false, error: "tool_denied", message: finalized.error };
     }
-    const relations = await verifyDocumentRelations(req, fields, finalized.data);
+    if (options.validateProposal) {
+        const extra = await options.validateProposal({
+            operations: typedOperations,
+            data: finalized.data,
+        });
+        if (!extra.ok) {
+            return { ok: false, error: "tool_denied", message: extra.errors.join(" ") };
+        }
+    }
+    const relations = await verifyDocumentRelations(req, fields, finalized.data, finalized.links);
     if (!relations.ok) {
         return { ok: false, error: "tool_denied", message: relations.message };
     }
@@ -72,7 +81,12 @@ export async function proposeChange(req, options, input) {
     const labels = setIds.size
         ? await labelRelations(req, fields, [finalized.data, current], setIds)
         : undefined;
-    const diff = humanDiff(current, typedOperations, input.language, labels);
+    const inRichText = (operation) => "path" in operation &&
+        richTextBefore.some(({ path }) => operation.path === path || operation.path.startsWith(`${path}.`));
+    const diff = [
+        ...humanDiff(current, typedOperations.filter((operation) => !inRichText(operation)), input.language, labels),
+        ...richTextBefore.flatMap(({ path, blocks, after }) => richTextLines(path, blocks, Array.isArray(after) ? after : [after], input.language)),
+    ];
     let created;
     try {
         created = await localApi(req).create({
@@ -163,3 +177,26 @@ function draftCreateDenied(req, collection) {
     }
     return null;
 }
+/** Rich text fields the operations reach, whole or by block, as form paths. */
+function richTextPaths(operations, fields, current) {
+    const paths = new Set();
+    for (const operation of operations) {
+        if (!("path" in operation))
+            continue;
+        const segments = operation.path.split(".");
+        for (let end = 1; end <= segments.length; end++) {
+            const prefix = segments.slice(0, end).join(".");
+            if (fieldAtPath(fields, prefix, current)?.type === "richText") {
+                paths.add(prefix);
+                break;
+            }
+        }
+    }
+    return [...paths];
+}
+/** The stored rich text at `path` as the model read it: Markdown blocks and `{ keep, type }`. */
+function storedBlocks(fields, path, current) {
+    const field = fieldAtPath(fields, path, current);
+    const blocks = toBlocks(getAtPath(current, parseFieldPath(path)), field?.editor);
+    return Array.isArray(blocks) ? blocks : [];
+}

package/dist/domain/relations.d.ts

@@ -4,7 +4,11 @@ export type RelationRef = {
     collection: string;
     id: string;
 };
-export declare function verifyDocumentRelations(req: PayloadRequest, fields: FieldNode[], data: Record<string, unknown>): Promise<{
+/**
+ * Every relation and upload in `data`, and `extra` refs such as internal links in rewritten rich
+ * text, must exist and be readable by the editor.
+ */
+export declare function verifyDocumentRelations(req: PayloadRequest, fields: FieldNode[], data: Record<string, unknown>, extra?: RelationRef[]): Promise<{
     ok: true;
 } | {
     ok: false;

package/dist/domain/relations.js

@@ -1,7 +1,11 @@
 import { findCollectionConfig } from "../schema/discover.js";
 import { localApi } from "./local-api.js";
-export async function verifyDocumentRelations(req, fields, data) {
-    const refs = collectRefs(fields, data);
+/**
+ * Every relation and upload in `data`, and `extra` refs such as internal links in rewritten rich
+ * text, must exist and be readable by the editor.
+ */
+export async function verifyDocumentRelations(req, fields, data, extra = []) {
+    const refs = [...collectRefs(fields, data), ...extra];
     for (const ref of refs) {
         try {
             await localApi(req).findByID({