@simmalugnt-se/payload-editor-assistant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simmalugnt AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @simmalugnt-se/payload-editor-assistant
+
+Context-aware AI assistant for Payload Admin. The editor asks for changes in a drawer; the assistant
+proposes form changes the editor reviews and approves, within an allowlist of collections, globals,
+fields and capabilities.
+
+Requires Payload `>=3.87.1 <4`, Next 16, React 19, Node 22 and the AI SDK (`ai` 7) with a provider of
+your choice.
+
+## Setup
+
+```ts
+import { deepSeek } from "@ai-sdk/deepseek";
+import { editorAssistantPlugin } from "@simmalugnt-se/payload-editor-assistant";
+
+plugins: [
+  editorAssistantPlugin({
+    model: deepSeek("deepseek-chat"),
+    collections: {
+      pages: {
+        capabilities: ["content.find", "content.findById", "form.read", "form.propose", "draft.create"],
+      },
+    },
+    globals: {
+      header: { capabilities: ["content.findById", "form.read", "form.propose"] },
+    },
+  }),
+];
+```
+
+Then regenerate the import map (`pnpm payload generate:importmap`). See `EditorAssistantPluginOptions`
+for allowlists, host tools and instructions. Design notes live in `docs/research` and `.wayfinder`.

package/dist/capabilities.d.ts

@@ -0,0 +1,10 @@
+export declare const BUILTIN_CAPABILITIES: readonly ["admin.navigate", "schema.discover", "content.find", "content.findById", "form.read", "form.propose", "draft.create"];
+export type BuiltinCapability = (typeof BUILTIN_CAPABILITIES)[number];
+export type CapabilityRisk = "auto" | "approval" | "forbidden";
+export declare const BUILTIN_RISK: Record<BuiltinCapability, CapabilityRisk>;
+export declare const EMBEDDED_ONLY_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create">;
+export declare const MCP_ELIGIBLE_CAPABILITIES: Set<"admin.navigate" | "schema.discover" | "content.find" | "content.findById" | "form.read" | "form.propose" | "draft.create">;
+export declare const ENTITY_CAPABILITIES: readonly ["content.find", "content.findById", "form.read", "form.propose", "draft.create"];
+export type EntityCapability = (typeof ENTITY_CAPABILITIES)[number];
+export declare function isEntityCapability(value: string): value is EntityCapability;
+export declare function isBuiltinCapability(value: string): value is BuiltinCapability;

package/dist/capabilities.js

@@ -0,0 +1,43 @@
+export const BUILTIN_CAPABILITIES = [
+    "admin.navigate",
+    "schema.discover",
+    "content.find",
+    "content.findById",
+    "form.read",
+    "form.propose",
+    "draft.create",
+];
+export const BUILTIN_RISK = {
+    "admin.navigate": "auto",
+    "schema.discover": "auto",
+    "content.find": "auto",
+    "content.findById": "auto",
+    "form.read": "auto",
+    "form.propose": "approval",
+    "draft.create": "approval",
+};
+export const EMBEDDED_ONLY_CAPABILITIES = new Set([
+    "admin.navigate",
+    "form.read",
+    "form.propose",
+]);
+export const MCP_ELIGIBLE_CAPABILITIES = new Set([
+    "schema.discover",
+    "content.find",
+    "content.findById",
+    "draft.create",
+]);
+export const ENTITY_CAPABILITIES = [
+    "content.find",
+    "content.findById",
+    "form.read",
+    "form.propose",
+    "draft.create",
+];
+const ENTITY_CAPABILITY_SET = new Set(ENTITY_CAPABILITIES);
+export function isEntityCapability(value) {
+    return ENTITY_CAPABILITY_SET.has(value);
+}
+export function isBuiltinCapability(value) {
+    return BUILTIN_CAPABILITIES.includes(value);
+}

package/dist/collections/approvals.d.ts

@@ -0,0 +1,2 @@
+import type { CollectionConfig } from "payload";
+export declare function createApprovalCollection(slug?: string): CollectionConfig;

package/dist/collections/approvals.js

@@ -0,0 +1,36 @@
+import { DEFAULT_APPROVAL_SLUG } from "../package-name.js";
+export function createApprovalCollection(slug = DEFAULT_APPROVAL_SLUG) {
+    return {
+        slug,
+        admin: {
+            hidden: true,
+        },
+        access: {
+            create: ({ req }) => Boolean(req.user),
+            delete: () => false,
+            read: ({ req }) => (req.user ? { actor: { equals: req.user.id } } : false),
+            update: ({ req }) => (req.user ? { actor: { equals: req.user.id } } : false),
+        },
+        fields: [
+            { name: "actor", type: "text", required: true, index: true },
+            { name: "capability", type: "text", required: true },
+            { name: "targetCollection", type: "text" },
+            { name: "targetGlobal", type: "text" },
+            { name: "documentId", type: "text" },
+            { name: "locale", type: "text", required: true },
+            { name: "canonicalHash", type: "text", required: true },
+            { name: "formRevision", type: "text" },
+            { name: "nonce", type: "text", required: true, unique: true },
+            { name: "expiresAt", type: "date", required: true, index: true },
+            {
+                name: "status",
+                type: "select",
+                required: true,
+                defaultValue: "proposed",
+                options: ["proposed", "approved", "rejected", "executed", "failed", "expired"],
+            },
+            { name: "operations", type: "json", required: true },
+        ],
+        timestamps: true,
+    };
+}

package/dist/collections/audit.d.ts

@@ -0,0 +1,2 @@
+import type { CollectionConfig } from "payload";
+export declare function createAuditCollection(slug?: string): CollectionConfig;

package/dist/collections/audit.js

@@ -0,0 +1,40 @@
+import { DEFAULT_AUDIT_SLUG } from "../package-name.js";
+export function createAuditCollection(slug = DEFAULT_AUDIT_SLUG) {
+    return {
+        slug,
+        admin: {
+            hidden: true,
+            useAsTitle: "capability",
+        },
+        access: {
+            create: ({ req }) => Boolean(req.user),
+            delete: () => false,
+            read: ({ req }) => (req.user ? { actor: { equals: req.user.id } } : false),
+            update: () => false,
+        },
+        fields: [
+            { name: "actor", type: "text", required: true, index: true },
+            { name: "sessionId", type: "text" },
+            { name: "requestId", type: "text" },
+            { name: "capability", type: "text", required: true },
+            { name: "risk", type: "text", required: true },
+            { name: "targetCollection", type: "text" },
+            { name: "targetGlobal", type: "text" },
+            { name: "documentId", type: "text" },
+            { name: "locale", type: "text" },
+            { name: "fieldPaths", type: "json" },
+            { name: "approvalId", type: "text" },
+            { name: "nonceId", type: "text" },
+            { name: "canonicalHash", type: "text" },
+            { name: "baseRevision", type: "text" },
+            {
+                name: "outcome",
+                type: "select",
+                required: true,
+                options: ["proposed", "approved", "rejected", "executed", "failed", "denied", "expired"],
+            },
+            { name: "errorClass", type: "text" },
+        ],
+        timestamps: true,
+    };
+}

package/dist/components/EditorAssistantAction.d.ts

@@ -0,0 +1 @@
+export declare function EditorAssistantAction(): import("react").JSX.Element | null;

package/dist/components/EditorAssistantAction.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, useAuth } from "@payloadcms/ui";
+import { useAssistantState } from "./assistant-context.js";
+export function EditorAssistantAction() {
+    const { user } = useAuth();
+    const { collapsed, setCollapsed, setOpen } = useAssistantState();
+    if (!user) {
+        return null;
+    }
+    return (_jsx(Button, { buttonStyle: "pill", className: "ea-trigger", onClick: (event) => {
+            event.preventDefault();
+            event.stopPropagation();
+            setOpen(true);
+            setCollapsed(false);
+        }, size: "medium", type: "button", children: collapsed ? "Open assistant" : "Assistant" }));
+}

package/dist/components/EditorAssistantAside.d.ts

@@ -0,0 +1 @@
+export declare function EditorAssistantAside(): import("react").JSX.Element;

package/dist/components/EditorAssistantAside.js

@@ -0,0 +1,335 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useConfig, useLocale, useTranslation } from "@payloadcms/ui";
+import { usePathname, useRouter } from "next/navigation";
+import { useLayoutEffect, useRef, useState, } from "react";
+import { parseAdminView } from "../view.js";
+import { assistantRequest } from "./assistant-api.js";
+import { useAssistantState, } from "./assistant-context.js";
+const STATUS_LABEL = {
+    idle: "",
+    unavailable: "unavailable",
+    unauthorized: "unauthorized",
+    rate_limited: "rate_limited",
+    timeout: "timeout",
+    provider_error: "provider_error",
+    tool_denied: "tool_denied",
+    stale_context: "stale_context",
+    aborted: "aborted",
+    streaming: "Working…",
+};
+/** Messages the panel adds to the chat itself; they follow the editor's chat language. */
+const CHAT_COPY = {
+    en: {
+        requestFailed: "I could not complete that request.",
+        done: "Done.",
+        proposalFailed: "The proposal could not be applied.",
+        rejectedForm: "Rejected. The form was not changed.",
+        rejectedDraft: "Rejected. No draft was created.",
+        applied: "Applied to the unsaved form. Save in Payload when you are ready.",
+        applyFailed: "The form could not be updated. It was left unchanged.",
+        draftCreated: "The draft is created and open.",
+    },
+    sv: {
+        requestFailed: "Jag kunde inte slutföra det.",
+        done: "Klart.",
+        proposalFailed: "Förslaget kunde inte genomföras.",
+        rejectedForm: "Avvisat. Formuläret ändrades inte.",
+        rejectedDraft: "Avvisat. Inget utkast skapades.",
+        applied: "Ändringen är införd i formuläret men inte sparad. Spara i Payload när du är redo.",
+        applyFailed: "Formuläret kunde inte uppdateras och lämnades orört.",
+        draftCreated: "Utkastet är skapat och öppnat.",
+    },
+};
+export function EditorAssistantAside() {
+    const { collapsed, setCollapsed, status, messages, shortcuts, collections, bridge, formAdapter, pendingApproval, resetConversation, setStatus, setMessages, setPendingApproval, stop, setAbortController, } = useAssistantState();
+    const { config } = useConfig();
+    const router = useRouter();
+    const locale = useLocale();
+    const { i18n } = useTranslation();
+    const [chatLanguage, setChatLanguage] = useState(i18n.language?.startsWith("sv") ? "sv" : "en");
+    const copy = CHAT_COPY[chatLanguage];
+    const pathname = usePathname();
+    const view = parseAdminView(pathname ?? "", config.routes.admin);
+    const visibleShortcuts = shortcuts.filter((shortcut) => shortcutMatches(shortcut, view));
+    const [draft, setDraft] = useState("");
+    const threadRef = useRef(null);
+    const stickToBottomRef = useRef(true);
+    const apiBase = config.routes.api;
+    // 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(() => {
+        const node = threadRef.current;
+        if (!node || !stickToBottomRef.current) {
+            return;
+        }
+        node.scrollTop = node.scrollHeight;
+    }, [messages, status, pendingApproval]);
+    const onThreadScroll = (event) => {
+        const node = event.currentTarget;
+        const remaining = node.scrollHeight - node.scrollTop - node.clientHeight;
+        stickToBottomRef.current = remaining < 48;
+    };
+    const send = async (text) => {
+        const trimmed = text.trim();
+        if (!trimmed || status === "streaming") {
+            return;
+        }
+        stickToBottomRef.current = true;
+        setDraft("");
+        const userMessage = { id: crypto.randomUUID(), role: "user", text: trimmed };
+        setMessages((current) => [...current, userMessage]);
+        const controller = new AbortController();
+        setAbortController(controller);
+        setStatus("streaming");
+        try {
+            const history = [...messages, userMessage].map((message) => ({
+                role: message.role,
+                text: message.text,
+            }));
+            const result = await assistantRequest(apiBase, "/chat", {
+                message: trimmed,
+                messages: history,
+                bridge,
+                view,
+                locale: locale.code,
+                uiLanguage: i18n.language,
+                formData: formAdapter?.getData(),
+            }, controller.signal);
+            if (controller.signal.aborted) {
+                setStatus("aborted");
+                return;
+            }
+            if (!result.ok) {
+                const error = (result.error ?? statusFromHttp(result.status));
+                setStatus(error);
+                setMessages((current) => [
+                    ...current,
+                    {
+                        id: crypto.randomUUID(),
+                        role: "assistant",
+                        text: result.message ?? copy.requestFailed,
+                    },
+                ]);
+                return;
+            }
+            setStatus("idle");
+            if (result.data.language === "sv" || result.data.language === "en") {
+                setChatLanguage(result.data.language);
+            }
+            if (result.data.pendingApproval) {
+                setPendingApproval(result.data.pendingApproval);
+            }
+            const navigate = result.data.navigate;
+            setMessages((current) => [
+                ...current,
+                {
+                    id: crypto.randomUUID(),
+                    role: "assistant",
+                    text: result.data.text ?? copy.done,
+                    candidates: navigate && "candidates" in navigate ? navigate.candidates : undefined,
+                },
+            ]);
+            if (navigate && "href" in navigate) {
+                router.push(navigate.href);
+            }
+        }
+        catch {
+            setStatus(controller.signal.aborted ? "aborted" : "provider_error");
+        }
+        finally {
+            setAbortController(null);
+        }
+    };
+    const decide = async (action) => {
+        if (!pendingApproval || status === "streaming") {
+            return;
+        }
+        stickToBottomRef.current = true;
+        if (action === "approve" && pendingApproval.capability === "form.propose") {
+            if (!formAdapter || !bridge || !canApplyForm(bridge)) {
+                setStatus("stale_context");
+                return;
+            }
+        }
+        const controller = new AbortController();
+        setAbortController(controller);
+        setStatus("streaming");
+        try {
+            const result = await assistantRequest(apiBase, "/decide", {
+                action,
+                approvalId: pendingApproval.approvalId,
+                nonce: pendingApproval.nonce,
+                collection: bridge?.collectionSlug,
+                global: bridge?.globalSlug,
+                documentId: bridge?.documentId,
+                locale: bridge?.locale ?? "en",
+                formData: formAdapter?.getData(),
+            }, controller.signal);
+            if (!result.ok) {
+                const error = (result.error ?? statusFromHttp(result.status));
+                setStatus(error);
+                setPendingApproval(null);
+                setMessages((current) => [
+                    ...current,
+                    {
+                        id: crypto.randomUUID(),
+                        role: "assistant",
+                        text: result.message ?? copy.proposalFailed,
+                    },
+                ]);
+                return;
+            }
+            setPendingApproval(null);
+            setStatus("idle");
+            if (result.data.rejected) {
+                setMessages((current) => [
+                    ...current,
+                    {
+                        id: crypto.randomUUID(),
+                        role: "assistant",
+                        text: pendingApproval.capability === "draft.create"
+                            ? copy.rejectedDraft
+                            : copy.rejectedForm,
+                    },
+                ]);
+                return;
+            }
+            if (result.data.capability === "form.propose" && result.data.patchedData && formAdapter) {
+                try {
+                    await formAdapter.reset(result.data.patchedData);
+                    formAdapter.setModified(true);
+                    setMessages((current) => [
+                        ...current,
+                        {
+                            id: crypto.randomUUID(),
+                            role: "assistant",
+                            text: copy.applied,
+                        },
+                    ]);
+                }
+                catch {
+                    setStatus("stale_context");
+                    setMessages((current) => [
+                        ...current,
+                        {
+                            id: crypto.randomUUID(),
+                            role: "assistant",
+                            text: copy.applyFailed,
+                        },
+                    ]);
+                }
+                return;
+            }
+            if (result.data.capability === "draft.create" &&
+                result.data.collection &&
+                result.data.documentId) {
+                const href = `${config.routes.admin}/collections/${result.data.collection}/${result.data.documentId}`;
+                setMessages((current) => [
+                    ...current,
+                    {
+                        id: crypto.randomUUID(),
+                        role: "assistant",
+                        text: copy.draftCreated,
+                    },
+                ]);
+                router.push(href);
+            }
+        }
+        catch {
+            setStatus(controller.signal.aborted ? "aborted" : "provider_error");
+        }
+        finally {
+            setAbortController(null);
+        }
+    };
+    const onSubmit = (event) => {
+        event.preventDefault();
+        void send(draft);
+    };
+    const onKeyDown = (event) => {
+        if (event.key === "Enter" && !event.shiftKey) {
+            event.preventDefault();
+            void send(draft);
+        }
+    };
+    if (collapsed) {
+        return (_jsx("aside", { className: "ea-aside ea-aside--collapsed", "aria-label": "Assistant", children: _jsx("button", { className: "ea-aside__rail", type: "button", onClick: () => setCollapsed(false), children: "Open assistant" }) }));
+    }
+    return (_jsxs("aside", { className: "ea-aside", "aria-label": "Assistant", children: [_jsxs("div", { className: "ea-aside__head", children: [_jsx("h2", { children: "Assistant" }), _jsx("button", { className: "ea-btn ea-btn--ghost", type: "button", onClick: () => resetConversation(), children: "Reset" }), _jsx("button", { className: "ea-btn ea-btn--ghost", type: "button", onClick: () => setCollapsed(true), children: "Collapse" })] }), _jsxs("div", { className: "ea-aside__body", children: [bridge ? (_jsxs("div", { className: "ea-context", children: [_jsx("span", { children: bridge.collectionSlug ?? bridge.globalSlug }), _jsx("span", { children: bridge.title ?? "document" }), _jsx("span", { children: bridge.locale }), _jsx("span", { className: bridge.modified ? "ea-context__warn" : "ea-context__ok", children: bridge.modified ? "unsaved" : "saved" })] })) : null, _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) })) : 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", { className: "ea-btn", type: "button", onClick: () => {
+                                                router.push(candidate.href);
+                                            }, children: candidate.label }, candidate.href))) })) : null] }, message.id))), status === "streaming" ? (_jsxs("div", { className: "ea-msg ea-msg--working", children: [_jsx("span", { children: STATUS_LABEL.streaming }), _jsx("button", { className: "ea-btn ea-btn--stop", type: "button", onClick: () => stop(), children: "Stop" })] })) : null] }), pendingApproval ? (_jsxs("div", { className: "ea-approval", children: [_jsx("h3", { children: pendingApproval.title }), _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))) }), _jsxs("div", { className: "ea-actions", children: [_jsx("button", { className: "ea-btn ea-btn--primary", type: "button", onClick: () => void decide("approve"), children: "Approve" }), _jsx("button", { className: "ea-btn", type: "button", onClick: () => void decide("reject"), children: "Reject" })] })] })) : null, status !== "idle" && status !== "streaming" ? (_jsx("div", { className: `ea-status ea-status--${status}`, children: STATUS_LABEL[status] })) : null, _jsxs("form", { className: "ea-composer", onSubmit: onSubmit, children: [visibleShortcuts.length > 0 ? (_jsx("div", { className: "ea-shortcuts", children: visibleShortcuts.map((shortcut) => (_jsx("button", { className: "ea-btn ea-btn--chip", disabled: status === "streaming", type: "button", onClick: () => {
+                                        void send(shortcut.prompt);
+                                    }, children: shortcut.label }, shortcut.id))) })) : null, _jsxs("div", { className: "ea-composer__box", children: [_jsx("textarea", { disabled: status === "streaming", placeholder: "Message the assistant", rows: 2, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: onKeyDown }), _jsx("div", { className: "ea-composer__bar", children: _jsx("button", { className: "ea-btn ea-btn--primary", disabled: status === "streaming" || draft.trim() === "", type: "submit", children: "Send" }) })] })] })] })] }));
+}
+function introText(view, bridge, collections, config) {
+    switch (view.kind) {
+        case "document":
+        case "global": {
+            if (!bridge) {
+                return "I can help you find content, open a page, or start a new draft. What do you need?";
+            }
+            const name = bridge.title ? `"${bridge.title}"` : "this document";
+            return `I can explain the fields on ${name}, suggest edits, or fill in empty fields. What do you need?`;
+        }
+        case "list": {
+            if (!collections.includes(view.collection)) {
+                return "I can't work with this list, but I can help you find content, open a page, or start a new draft.";
+            }
+            const collection = config.collections?.find((entry) => entry.slug === view.collection);
+            const plural = textLabel(collection?.labels?.plural) ?? view.collection;
+            const singular = textLabel(collection?.labels?.singular)?.toLowerCase() ?? "document";
+            return `You are in ${plural}. I can find and open a ${singular}, or start a new draft for you. What do you need?`;
+        }
+        default:
+            return "I can help you find content, open a page, or start a new draft. What do you need?";
+    }
+}
+function textLabel(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function shortcutMatches(shortcut, view) {
+    if (shortcut.when && !shortcut.when.includes(view.kind)) {
+        return false;
+    }
+    if (!shortcut.entities) {
+        return true;
+    }
+    const entity = view.kind === "list" || view.kind === "document"
+        ? view.collection
+        : view.kind === "global"
+            ? view.global
+            : undefined;
+    return entity === undefined || shortcut.entities.includes(entity);
+}
+function canApplyForm(bridge) {
+    if (bridge.disabled || bridge.locked) {
+        return false;
+    }
+    if (bridge.hasSavePermission === false) {
+        return false;
+    }
+    if (bridge.uploadStatus && bridge.uploadStatus !== "idle") {
+        return false;
+    }
+    return true;
+}
+function statusFromHttp(status) {
+    if (status === 401 || status === 403) {
+        return "unauthorized";
+    }
+    if (status === 429) {
+        return "rate_limited";
+    }
+    if (status === 504) {
+        return "timeout";
+    }
+    if (status === 503) {
+        return "provider_error";
+    }
+    return "provider_error";
+}

package/dist/components/EditorAssistantDocumentBridge.d.ts

@@ -0,0 +1 @@
+export declare function EditorAssistantDocumentBridge(): null;

package/dist/components/EditorAssistantDocumentBridge.js

@@ -0,0 +1,48 @@
+"use client";
+import { useDocumentForm, useDocumentInfo, useFormModified, useLocale } from "@payloadcms/ui";
+import { useEffect, useRef } from "react";
+import { useAssistantState } from "./assistant-context.js";
+export function EditorAssistantDocumentBridge() {
+    const { setBridge, setFormAdapter } = useAssistantState();
+    const documentInfo = useDocumentInfo();
+    const locale = useLocale();
+    const modified = useFormModified();
+    const form = useDocumentForm();
+    const formRef = useRef(form);
+    useEffect(() => {
+        formRef.current = form;
+    });
+    useEffect(() => {
+        setFormAdapter({
+            getData: () => formRef.current.getData(),
+            reset: (data) => formRef.current.reset(data),
+            setModified: (value) => formRef.current.setModified(value),
+        });
+        return () => {
+            setFormAdapter(null);
+        };
+    }, [setFormAdapter]);
+    useEffect(() => {
+        const titleValue = documentInfo.data && "title" in documentInfo.data ? documentInfo.data.title : undefined;
+        const locked = Boolean(documentInfo.documentIsLocked) ||
+            Boolean(documentInfo.isLocked);
+        const hasSavePermission = documentInfo.hasSavePermission;
+        const uploadStatus = documentInfo.uploadStatus;
+        setBridge({
+            collectionSlug: documentInfo.collectionSlug,
+            globalSlug: documentInfo.globalSlug,
+            documentId: documentInfo.id,
+            locale: locale.code,
+            title: typeof titleValue === "string" ? titleValue : undefined,
+            modified: Boolean(modified),
+            locked,
+            hasSavePermission,
+            uploadStatus,
+            disabled: Boolean(form.disabled),
+        });
+        return () => {
+            setBridge(null);
+        };
+    }, [documentInfo, locale.code, modified, form.disabled, setBridge]);
+    return null;
+}

package/dist/components/EditorAssistantProvider.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import "../styles/assistant.css";
+import type { AssistantShortcut } from "../types.ts";
+export declare function EditorAssistantProvider({ children, shortcuts, collections, }: {
+    children: ReactNode;
+    shortcuts?: AssistantShortcut[];
+    collections?: string[];
+}): import("react").JSX.Element;

package/dist/components/EditorAssistantProvider.js

@@ -0,0 +1,14 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useAuth } from "@payloadcms/ui";
+import "../styles/assistant.css";
+import { AssistantStateProvider, useAssistantState } from "./assistant-context.js";
+import { EditorAssistantAside } from "./EditorAssistantAside.js";
+export function EditorAssistantProvider({ children, shortcuts = [], collections = [], }) {
+    const { user } = useAuth();
+    return (_jsx(AssistantStateProvider, { shortcuts: shortcuts, collections: collections, children: user ? _jsx(EditorAssistantShell, { children: children }) : children }));
+}
+function EditorAssistantShell({ children }) {
+    const { collapsed } = useAssistantState();
+    return (_jsxs("div", { className: collapsed ? "ea-root ea-root--collapsed" : "ea-root", children: [_jsx("div", { className: "ea-main", children: children }), _jsx(EditorAssistantAside, {})] }));
+}

package/dist/components/assistant-api.d.ts

@@ -0,0 +1,9 @@
+export declare function assistantRequest<T>(apiBase: string, path: string, body: unknown, signal?: AbortSignal): Promise<{
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+    message?: string;
+    status: number;
+}>;