@mvriu5/payload-ai 0.5.0

package/dist/components/AIInput.module.css

@@ -0,0 +1,237 @@
+.chat {
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: 8px;
+  margin-bottom: 24px;
+  max-width: 920px;
+  padding: 20px;
+}
+
+.chatHeader {
+  align-items: flex-start;
+  display: flex;
+  justify-content: space-between;
+  margin-bottom: 16px;
+}
+
+.chatTitle {
+  font-size: 18px;
+  line-height: 1.3;
+  margin: 0;
+}
+
+.chatDescription {
+  color: var(--theme-elevation-600);
+  font-size: 13px;
+  line-height: 1.4;
+  margin: 4px 0 0;
+}
+
+.settings {
+  align-items: flex-end;
+  display: flex;
+  gap: 10px;
+}
+
+.setting {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.settingLabel {
+  color: var(--theme-elevation-600);
+  font-size: 11px;
+  line-height: 1.2;
+}
+
+.select {
+  background: var(--theme-input-bg);
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: 4px;
+  color: var(--theme-text);
+  font: inherit;
+  min-height: 34px;
+  min-width: 160px;
+  padding: 0 28px 0 10px;
+}
+
+.select:focus {
+  border-color: var(--theme-success-500);
+  outline: none;
+}
+
+.chatInputRow {
+  position: relative;
+  width: 100%;
+}
+
+.chatActionsRow {
+  align-items: flex-end;
+  display: flex;
+  gap: 12px;
+  justify-content: space-between;
+  margin-top: 12px;
+}
+
+.chatInput {
+  background: transparent;
+  border: 0;
+  color: var(--theme-text);
+  font: inherit;
+  min-height: 84px;
+  padding: 0;
+  white-space: pre-wrap;
+  width: 100%;
+}
+
+.chatInput:focus {
+  outline: none;
+}
+
+.chatInput:empty::before {
+  color: var(--theme-elevation-400);
+  content: attr(data-placeholder);
+}
+
+.chatInputSurface {
+  background: var(--theme-input-bg);
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: 4px;
+  padding: 12px;
+  width: 100%;
+}
+
+.chatInputSurface:focus-within {
+  border-color: var(--theme-success-500);
+}
+
+.inlineBadge {
+  margin: 0 2px;
+  vertical-align: middle;
+}
+
+.badge {
+  align-items: center;
+  background: var(--theme-elevation-100);
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: 999px;
+  color: var(--theme-text);
+  display: inline-flex;
+  font-size: 11px;
+  gap: 3px;
+  line-height: 1;
+  min-height: 20px;
+  padding: 0 8px;
+  position: relative;
+  top: -2px;
+  white-space: nowrap;
+}
+
+.prefix {
+  color: var(--theme-elevation-500);
+}
+
+.name {
+  color: var(--theme-text);
+}
+
+.collection {
+  background: color-mix(in srgb, #2f7d68 12%, var(--theme-bg));
+  border-color: color-mix(in srgb, #2f7d68 28%, var(--theme-elevation-150));
+}
+
+.global {
+  background: color-mix(in srgb, #8b6f24 12%, var(--theme-bg));
+  border-color: color-mix(in srgb, #8b6f24 28%, var(--theme-elevation-150));
+}
+
+.block {
+  background: color-mix(in srgb, #5a6fa8 12%, var(--theme-bg));
+  border-color: color-mix(in srgb, #5a6fa8 28%, var(--theme-elevation-150));
+}
+
+.doc {
+  background: color-mix(in srgb, #7a5c9e 12%, var(--theme-bg));
+  border-color: color-mix(in srgb, #7a5c9e 28%, var(--theme-elevation-150));
+}
+
+.chatButton {
+  background: var(--theme-text);
+  border: 0;
+  border-radius: 4px;
+  color: var(--theme-bg);
+  cursor: pointer;
+  font: inherit;
+  min-height: 40px;
+  padding: 0 18px;
+}
+
+.chatButton:disabled {
+  cursor: not-allowed;
+  opacity: 0.45;
+}
+
+.chatError {
+  color: var(--theme-error-500);
+  font-size: 13px;
+  line-height: 1.4;
+  margin-top: 12px;
+}
+
+.debugInfo {
+  background: var(--theme-elevation-50);
+  border: 1px solid var(--theme-elevation-150);
+  border-radius: 4px;
+  color: var(--theme-elevation-800);
+  font-size: 12px;
+  line-height: 1.5;
+  margin: 12px 0 0;
+  max-height: 260px;
+  overflow: auto;
+  padding: 12px;
+  white-space: pre-wrap;
+}
+
+.chatResponse {
+  background: var(--theme-elevation-50);
+  border: 1px solid var(--theme-elevation-100);
+  border-radius: 4px;
+  line-height: 1.5;
+  margin-top: 16px;
+  padding: 12px;
+  white-space: pre-wrap;
+}
+
+@media (max-width: 768px) {
+  .chatHeader {
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .chatInputRow {
+    width: 100%;
+  }
+
+  .chatActionsRow {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .settings {
+    align-items: stretch;
+    width: 100%;
+  }
+
+  .setting {
+    flex: 1;
+  }
+
+  .select {
+    min-width: 0;
+    width: 100%;
+  }
+
+  .chatButton {
+    align-self: stretch;
+  }
+}

package/dist/components/CollectionMentionPopover.d.ts

@@ -0,0 +1,16 @@
+import type { RefObject } from "react";
+export type CollectionMentionOption = {
+    collection?: string;
+    id?: string;
+    label: string;
+    parent?: string;
+    slug: string;
+    type: "block" | "collection" | "doc" | "global";
+};
+type CollectionMentionPopoverProps = {
+    containerRef?: RefObject<HTMLDivElement | null>;
+    suggestions: CollectionMentionOption[];
+    onSelect: (suggestion: CollectionMentionOption) => void;
+};
+export declare const CollectionMentionPopover: ({ containerRef, onSelect, suggestions }: CollectionMentionPopoverProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/CollectionMentionPopover.js

@@ -0,0 +1,77 @@
+import styles from "./CollectionMentionPopover.module.css";
+const suggestionGroups = [
+    {
+        label: "Collections",
+        type: "collection"
+    },
+    {
+        label: "Collection items",
+        type: "doc"
+    },
+    {
+        label: "Globals",
+        type: "global"
+    },
+    {
+        label: "Blocks",
+        type: "block"
+    }
+];
+const getSuggestionTitle = (suggestion)=>{
+    if (suggestion.type === "collection") return `@${suggestion.slug}`;
+    if (suggestion.type === "global") return `@${suggestion.slug}`;
+    if (suggestion.type === "block") return `@${suggestion.slug}`;
+    return suggestion.label;
+};
+const getSuggestionLabel = (suggestion)=>{
+    if (suggestion.type === "collection") return suggestion.label;
+    if (suggestion.type === "global") return "global";
+    if (suggestion.type === "block") return `${suggestion.parent} block`;
+    return `${suggestion.collection} item`;
+};
+export const CollectionMentionPopover = ({ containerRef, onSelect, suggestions })=>{
+    if (suggestions.length === 0) return null;
+    const onKeyDown = (event, suggestion)=>{
+        if (event.key === "Enter" || event.key === " ") {
+            event.preventDefault();
+            onSelect(suggestion);
+            return;
+        }
+        if (event.key !== "ArrowDown" && event.key !== "ArrowUp") return;
+        const popover = event.currentTarget.closest(`.${styles.popover}`);
+        if (!popover) return;
+        const buttons = Array.from(popover.querySelectorAll("button"));
+        const currentIndex = buttons.indexOf(event.currentTarget);
+        if (currentIndex === -1) return;
+        event.preventDefault();
+        const nextIndex = event.key === "ArrowDown" ? Math.min(currentIndex + 1, buttons.length - 1) : Math.max(currentIndex - 1, 0);
+        buttons[nextIndex]?.focus();
+    };
+    const onMouseDown = (event, suggestion)=>{
+        event.preventDefault();
+        onSelect(suggestion);
+    };
+    return /*#__PURE__*/ React.createElement("div", {
+        className: styles.popover,
+        ref: containerRef
+    }, suggestionGroups.map((group)=>{
+        const groupSuggestions = suggestions.filter((s)=>s.type === group.type);
+        if (groupSuggestions.length === 0) return null;
+        return /*#__PURE__*/ React.createElement("div", {
+            className: styles.group,
+            key: group.type
+        }, /*#__PURE__*/ React.createElement("div", {
+            className: styles.groupLabel
+        }, group.label), groupSuggestions.map((suggestion)=>/*#__PURE__*/ React.createElement("button", {
+                className: styles.option,
+                key: `${suggestion.type}-${suggestion.slug}-${suggestion.parent || ""}-${suggestion.collection || ""}-${suggestion.id || ""}`,
+                onMouseDown: (e)=>onMouseDown(e, suggestion),
+                onKeyDown: (e)=>onKeyDown(e, suggestion),
+                type: "button"
+            }, /*#__PURE__*/ React.createElement("span", {
+                className: styles.slug
+            }, getSuggestionTitle(suggestion)), /*#__PURE__*/ React.createElement("span", {
+                className: styles.label
+            }, getSuggestionLabel(suggestion)))));
+    }));
+};

package/dist/components/CollectionMentionPopover.module.css

@@ -0,0 +1,67 @@
+.popover {
+    background: var(--theme-bg);
+    border: 1px solid var(--theme-elevation-150);
+    border-radius: 6px;
+    box-shadow: 0 8px 24px rgb(0 0 0 / 12%);
+    left: 0;
+    max-height: 220px;
+    max-width: calc(100% - 96px);
+    min-width: 260px;
+    overflow: auto;
+    padding: 6px;
+    position: absolute;
+    top: calc(100% + 6px);
+    z-index: 10;
+}
+
+.group + .group {
+    margin-top: 6px;
+}
+
+.groupLabel {
+    color: var(--theme-elevation-500);
+    font-size: 10px;
+    font-weight: 600;
+    line-height: 1.2;
+    padding: 6px 10px 4px;
+    text-transform: uppercase;
+}
+
+.option {
+    align-items: center;
+    background: transparent;
+    border: 0;
+    border-radius: 4px;
+    color: var(--theme-text);
+    cursor: pointer;
+    display: flex;
+    font: inherit;
+    gap: 10px;
+    justify-content: flex-start;
+    padding: 8px 10px;
+    text-align: left;
+    width: 100%;
+}
+
+.option:hover,
+.option:focus {
+    background: var(--theme-elevation-50);
+    outline: none;
+}
+
+.slug {
+    font-weight: 600;
+}
+
+.label {
+    color: var(--theme-elevation-600);
+    font-size: 12px;
+}
+
+@media (max-width: 768px) {
+    .popover {
+        max-width: 100%;
+        min-width: 0;
+        width: 100%;
+    }
+}

package/dist/components/hooks/useAISettings.d.ts

@@ -0,0 +1,10 @@
+import { type AIProvider } from "../../ai/providerOptions.js";
+export declare const useAISettings: ({ adminUserSlug, apiRoute, defaultModels, }: {
+    adminUserSlug?: string;
+    apiRoute: string;
+    defaultModels: Record<AIProvider, string>;
+}) => {
+    selectedModel: string;
+    setSelectedModel: import("react").Dispatch<import("react").SetStateAction<string>>;
+    settingsProvider: "claude" | "google" | "groq" | "mistral" | "openai" | null;
+};

package/dist/components/hooks/useAISettings.js

@@ -0,0 +1,56 @@
+"use client";
+import { formatAdminURL } from "payload/shared";
+import { useEffect, useState } from "react";
+import { isAIProvider } from "../../ai/providerOptions.js";
+import { isAbortError } from "./utils.js";
+export const useAISettings = ({ adminUserSlug, apiRoute, defaultModels })=>{
+    const [settingsProvider, setSettingsProvider] = useState(null);
+    const [selectedModel, setSelectedModel] = useState("");
+    useEffect(()=>{
+        if (!adminUserSlug) {
+            setSettingsProvider(null);
+            setSelectedModel("");
+            return;
+        }
+        const abortController = new AbortController();
+        const fetchCurrentUser = async ()=>{
+            try {
+                const res = await fetch(formatAdminURL({
+                    apiRoute,
+                    path: `/${adminUserSlug}/me`
+                }), {
+                    signal: abortController.signal
+                });
+                if (!res.ok) {
+                    setSettingsProvider(null);
+                    setSelectedModel("");
+                    return;
+                }
+                const result = await res.json();
+                const provider = result.user?.aiProvider;
+                if (!provider || !isAIProvider(provider)) {
+                    setSettingsProvider(null);
+                    setSelectedModel("");
+                    return;
+                }
+                setSettingsProvider(provider);
+                setSelectedModel(defaultModels[provider]);
+            } catch (err) {
+                if (isAbortError(err)) return;
+                setSettingsProvider(null);
+                setSelectedModel("");
+            }
+        };
+        void fetchCurrentUser();
+        return ()=>abortController.abort();
+    }, [
+        adminUserSlug,
+        apiRoute,
+        defaultModels
+    ]);
+    return {
+        selectedModel,
+        setSelectedModel,
+        settingsProvider
+    };
+};

package/dist/components/hooks/useDocumentMentionSuggestions.d.ts

@@ -0,0 +1,16 @@
+import type { CollectionMentionOption } from "../CollectionMentionPopover.js";
+type MentionRange = {
+    end: number;
+    start: number;
+};
+interface DocumentMentionSuggestions {
+    apiRoute: string;
+    documentSuggestionCollection?: null | string;
+    mentionQuery: string;
+    mentionRange: MentionRange | null;
+}
+export declare const useDocumentMentionSuggestions: ({ apiRoute, documentSuggestionCollection, mentionQuery, mentionRange, }: DocumentMentionSuggestions) => {
+    documentSuggestions: CollectionMentionOption[];
+    resetDocumentSuggestions: () => void;
+};
+export {};

package/dist/components/hooks/useDocumentMentionSuggestions.js

@@ -0,0 +1,53 @@
+"use client";
+import { formatAdminURL } from "payload/shared";
+import { useEffect, useState } from "react";
+import { isAbortError } from "./utils.js";
+export const useDocumentMentionSuggestions = ({ apiRoute, documentSuggestionCollection, mentionQuery, mentionRange })=>{
+    const [documentSuggestions, setDocumentSuggestions] = useState([]);
+    useEffect(()=>{
+        const trimmedQuery = mentionQuery.trim();
+        if (!mentionRange || !trimmedQuery && !documentSuggestionCollection) {
+            setDocumentSuggestions([]);
+            return;
+        }
+        const abortController = new AbortController();
+        const fetchDocumentSuggestions = async ()=>{
+            try {
+                const res = await fetch(formatAdminURL({
+                    apiRoute,
+                    path: "/ai-mention-suggestions"
+                }), {
+                    body: JSON.stringify({
+                        collectionSlug: documentSuggestionCollection,
+                        query: documentSuggestionCollection ? "" : trimmedQuery
+                    }),
+                    headers: {
+                        "Content-Type": "application/json"
+                    },
+                    method: "POST",
+                    signal: abortController.signal
+                });
+                if (!res.ok) {
+                    setDocumentSuggestions([]);
+                    return;
+                }
+                const result = await res.json();
+                setDocumentSuggestions(result.suggestions || []);
+            } catch (err) {
+                if (isAbortError(err)) return;
+                setDocumentSuggestions([]);
+            }
+        };
+        void fetchDocumentSuggestions();
+        return ()=>abortController.abort();
+    }, [
+        apiRoute,
+        documentSuggestionCollection,
+        mentionQuery,
+        mentionRange
+    ]);
+    return {
+        documentSuggestions,
+        resetDocumentSuggestions: ()=>setDocumentSuggestions([])
+    };
+};

package/dist/components/hooks/utils.d.ts

@@ -0,0 +1 @@
+export declare const isAbortError: (err: unknown) => boolean;

package/dist/components/hooks/utils.js

@@ -0,0 +1,3 @@
+export const isAbortError = (err)=>{
+    return err instanceof DOMException && err.name === "AbortError";
+};

package/dist/endpoints/aiApplyActionEndpointHandler.d.ts

@@ -0,0 +1,6 @@
+import type { PayloadHandler } from "payload";
+type AIApplyActionEndpointOptions = {
+    collections?: string[];
+};
+export declare const createAIApplyActionEndpointHandler: (options?: AIApplyActionEndpointOptions) => PayloadHandler;
+export {};