@delmaredigital/payload-puck 0.3.1 → 0.6.0

package/dist/ai/createAiPlugin.js

@@ -0,0 +1,61 @@
+'use client';
+/**
+ * Creates a Puck AI plugin for the editor
+ *
+ * Wraps @puckeditor/plugin-ai with sensible defaults for payload-puck.
+ * This factory allows for runtime-configurable prompts (from database, API, etc.).
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { createAiPlugin } from '@delmaredigital/payload-puck/ai'
+ *
+ * const aiPlugin = createAiPlugin({
+ *   host: '/api/puck',
+ *   examplePrompts: [
+ *     { label: 'Landing page', prompt: 'Create a landing page about our product' },
+ *   ],
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ *
+ * @example With runtime prompts from database
+ * ```tsx
+ * // Fetch prompts from Payload
+ * const prompts = await payload.find({ collection: 'puck-ai-prompts' })
+ *
+ * const aiPlugin = createAiPlugin({
+ *   examplePrompts: prompts.docs.map(p => ({
+ *     label: p.label,
+ *     prompt: p.prompt,
+ *   })),
+ * })
+ *
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ */
+export function createAiPlugin(options = {}) {
+    const { host = '/api/puck', examplePrompts, onSubmit } = options;
+    // Dynamic import to avoid build errors if plugin-ai not installed
+    // Also allows for tree-shaking when AI is not used
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createAiPlugin: createPuckAiPlugin } = require('@puckeditor/plugin-ai');
+        return createPuckAiPlugin({
+            host,
+            chat: {
+                examplePrompts,
+                onSubmit,
+            },
+        });
+    }
+    catch (e) {
+        // Return a placeholder plugin if @puckeditor/plugin-ai is not installed
+        console.warn('[payload-puck] AI plugin requested but @puckeditor/plugin-ai not installed. ' +
+            'Install it with: pnpm add @puckeditor/plugin-ai');
+        return {
+            name: 'ai-placeholder',
+        };
+    }
+}
+//# sourceMappingURL=createAiPlugin.js.map

package/dist/ai/createAiPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAiPlugin.js","sourceRoot":"","sources":["../../src/ai/createAiPlugin.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAKZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE;IAC1D,MAAM,EAAE,IAAI,GAAG,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IAEhE,kEAAkE;IAClE,mDAAmD;IACnD,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;QAE/E,OAAO,kBAAkB,CAAC;YACxB,IAAI;YACJ,IAAI,EAAE;gBACJ,cAAc;gBACd,QAAQ;aACT;SACF,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,wEAAwE;QACxE,OAAO,CAAC,IAAI,CACV,8EAA8E;YAC5E,iDAAiD,CACpD,CAAA;QAED,OAAO;YACL,IAAI,EAAE,gBAAgB;SACvB,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/ai/hooks/useAiContext.d.ts

@@ -0,0 +1,63 @@
+import type { AiContext } from '../types.js';
+/** Event name for context updates */
+export declare const AI_CONTEXT_UPDATED_EVENT = "puck:ai-context-updated";
+/**
+ * Dispatches an event to notify that AI context has been updated
+ * Call this after creating, editing, or deleting a context entry
+ */
+export declare function dispatchContextUpdated(): void;
+export interface UseAiContextOptions {
+    /**
+     * API endpoint to fetch context from
+     * @default '/api/puck/ai-context'
+     */
+    apiEndpoint?: string;
+    /**
+     * Whether to enable fetching
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Whether to include disabled entries
+     * @default false
+     */
+    includeDisabled?: boolean;
+}
+export interface UseAiContextReturn {
+    /** Array of context entries */
+    context: AiContext[];
+    /** Loading state */
+    loading: boolean;
+    /** Error message if any */
+    error: string | null;
+    /** Refetch context entries */
+    refetch: () => Promise<void>;
+    /** Create a new context entry */
+    create: (data: Omit<AiContext, 'id' | 'createdAt' | 'updatedAt'>) => Promise<AiContext | null>;
+    /** Update an existing context entry */
+    update: (id: string, data: Partial<AiContext>) => Promise<AiContext | null>;
+    /** Delete a context entry */
+    remove: (id: string) => Promise<boolean>;
+}
+/**
+ * Hook to fetch and manage AI context entries client-side
+ *
+ * When context is updated via the context editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @example
+ * ```tsx
+ * const { context, loading, create, update, remove } = useAiContext()
+ *
+ * // Create a new context entry
+ * await create({ name: 'Brand Guidelines', content: '...', enabled: true })
+ *
+ * // Update an entry
+ * await update(context[0].id, { content: 'Updated content' })
+ *
+ * // Delete an entry
+ * await remove(context[0].id)
+ * ```
+ */
+export declare function useAiContext(options?: UseAiContextOptions): UseAiContextReturn;
+//# sourceMappingURL=useAiContext.d.ts.map

package/dist/ai/hooks/useAiContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiContext.d.ts","sourceRoot":"","sources":["../../../src/ai/hooks/useAiContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,qCAAqC;AACrC,eAAO,MAAM,wBAAwB,4BAA4B,CAAA;AAEjE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,iCAAiC;IACjC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC9F,uCAAuC;IACvC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3E,6BAA6B;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA4IlF"}

package/dist/ai/hooks/useAiContext.js

@@ -0,0 +1,146 @@
+'use client';
+import { useState, useEffect, useCallback } from 'react';
+/** Event name for context updates */
+export const AI_CONTEXT_UPDATED_EVENT = 'puck:ai-context-updated';
+/**
+ * Dispatches an event to notify that AI context has been updated
+ * Call this after creating, editing, or deleting a context entry
+ */
+export function dispatchContextUpdated() {
+    if (typeof window !== 'undefined') {
+        window.dispatchEvent(new CustomEvent(AI_CONTEXT_UPDATED_EVENT));
+    }
+}
+/**
+ * Hook to fetch and manage AI context entries client-side
+ *
+ * When context is updated via the context editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @example
+ * ```tsx
+ * const { context, loading, create, update, remove } = useAiContext()
+ *
+ * // Create a new context entry
+ * await create({ name: 'Brand Guidelines', content: '...', enabled: true })
+ *
+ * // Update an entry
+ * await update(context[0].id, { content: 'Updated content' })
+ *
+ * // Delete an entry
+ * await remove(context[0].id)
+ * ```
+ */
+export function useAiContext(options = {}) {
+    const { apiEndpoint = '/api/puck/ai-context', enabled = true, includeDisabled = false, } = options;
+    const [context, setContext] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetchContext = useCallback(async () => {
+        if (!enabled) {
+            setLoading(false);
+            return;
+        }
+        try {
+            setLoading(true);
+            setError(null);
+            const url = includeDisabled ? `${apiEndpoint}?all=true` : apiEndpoint;
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error('Failed to fetch context');
+            }
+            const data = await response.json();
+            setContext(data.docs || []);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to load context');
+            setContext([]);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [apiEndpoint, enabled, includeDisabled]);
+    // Create a new context entry
+    const create = useCallback(async (data) => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                throw new Error('Failed to create context entry');
+            }
+            const newEntry = await response.json();
+            dispatchContextUpdated();
+            return newEntry;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to create context entry');
+            return null;
+        }
+    }, [apiEndpoint]);
+    // Update an existing context entry
+    const update = useCallback(async (id, data) => {
+        try {
+            const response = await fetch(`${apiEndpoint}/${id}`, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(data),
+            });
+            if (!response.ok) {
+                throw new Error('Failed to update context entry');
+            }
+            const updatedEntry = await response.json();
+            dispatchContextUpdated();
+            return updatedEntry;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to update context entry');
+            return null;
+        }
+    }, [apiEndpoint]);
+    // Delete a context entry
+    const remove = useCallback(async (id) => {
+        try {
+            const response = await fetch(`${apiEndpoint}/${id}`, {
+                method: 'DELETE',
+            });
+            if (!response.ok) {
+                throw new Error('Failed to delete context entry');
+            }
+            dispatchContextUpdated();
+            return true;
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to delete context entry');
+            return false;
+        }
+    }, [apiEndpoint]);
+    // Initial fetch
+    useEffect(() => {
+        fetchContext();
+    }, [fetchContext]);
+    // Listen for context updates
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const handleUpdate = () => {
+            fetchContext();
+        };
+        window.addEventListener(AI_CONTEXT_UPDATED_EVENT, handleUpdate);
+        return () => {
+            window.removeEventListener(AI_CONTEXT_UPDATED_EVENT, handleUpdate);
+        };
+    }, [enabled, fetchContext]);
+    return {
+        context,
+        loading,
+        error,
+        refetch: fetchContext,
+        create,
+        update,
+        remove,
+    };
+}
+//# sourceMappingURL=useAiContext.js.map

package/dist/ai/hooks/useAiContext.js.map

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

package/dist/ai/hooks/useAiPrompts.d.ts

@@ -0,0 +1,25 @@
+import type { AiExamplePrompt } from '../types.js';
+/** Event name for prompt updates */
+export declare const AI_PROMPTS_UPDATED_EVENT = "puck:ai-prompts-updated";
+/**
+ * Dispatches an event to notify that AI prompts have been updated
+ * Call this after creating, editing, or deleting a prompt
+ */
+export declare function dispatchPromptsUpdated(): void;
+/**
+ * Hook to fetch AI prompts client-side with auto-refresh support
+ *
+ * When prompts are updated via the prompt editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @param apiEndpoint - API endpoint to fetch prompts from
+ * @param enabled - Whether to enable fetching (default: true)
+ * @returns Object with prompts array and loading state
+ */
+export declare function useAiPrompts(apiEndpoint?: string, enabled?: boolean): {
+    prompts: AiExamplePrompt[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useAiPrompts.d.ts.map

package/dist/ai/hooks/useAiPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiPrompts.d.ts","sourceRoot":"","sources":["../../../src/ai/hooks/useAiPrompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,oCAAoC;AACpC,eAAO,MAAM,wBAAwB,4BAA4B,CAAA;AAEjE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,WAAW,GAAE,MAA+B,EAC5C,OAAO,GAAE,OAAc,GACtB;IACD,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CA0DA"}

package/dist/ai/hooks/useAiPrompts.js

@@ -0,0 +1,74 @@
+'use client';
+import { useState, useEffect, useCallback } from 'react';
+/** Event name for prompt updates */
+export const AI_PROMPTS_UPDATED_EVENT = 'puck:ai-prompts-updated';
+/**
+ * Dispatches an event to notify that AI prompts have been updated
+ * Call this after creating, editing, or deleting a prompt
+ */
+export function dispatchPromptsUpdated() {
+    if (typeof window !== 'undefined') {
+        window.dispatchEvent(new CustomEvent(AI_PROMPTS_UPDATED_EVENT));
+    }
+}
+/**
+ * Hook to fetch AI prompts client-side with auto-refresh support
+ *
+ * When prompts are updated via the prompt editor panel, this hook will
+ * automatically refetch to stay in sync.
+ *
+ * @param apiEndpoint - API endpoint to fetch prompts from
+ * @param enabled - Whether to enable fetching (default: true)
+ * @returns Object with prompts array and loading state
+ */
+export function useAiPrompts(apiEndpoint = '/api/puck/ai-prompts', enabled = true) {
+    const [prompts, setPrompts] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetchPrompts = useCallback(async () => {
+        if (!enabled) {
+            setLoading(false);
+            return;
+        }
+        try {
+            setLoading(true);
+            setError(null);
+            const response = await fetch(apiEndpoint);
+            if (!response.ok) {
+                throw new Error('Failed to fetch prompts');
+            }
+            const data = await response.json();
+            // Transform API response to AiExamplePrompt format
+            const fetchedPrompts = (data.docs || []).map((doc) => ({
+                label: doc.label,
+                prompt: doc.prompt,
+            }));
+            setPrompts(fetchedPrompts);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to load prompts');
+            setPrompts([]);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [apiEndpoint, enabled]);
+    // Initial fetch
+    useEffect(() => {
+        fetchPrompts();
+    }, [fetchPrompts]);
+    // Listen for prompt updates
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const handleUpdate = () => {
+            fetchPrompts();
+        };
+        window.addEventListener(AI_PROMPTS_UPDATED_EVENT, handleUpdate);
+        return () => {
+            window.removeEventListener(AI_PROMPTS_UPDATED_EVENT, handleUpdate);
+        };
+    }, [enabled, fetchPrompts]);
+    return { prompts, loading, error, refetch: fetchPrompts };
+}
+//# sourceMappingURL=useAiPrompts.js.map

package/dist/ai/hooks/useAiPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiPrompts.js","sourceRoot":"","sources":["../../../src/ai/hooks/useAiPrompts.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAGxD,oCAAoC;AACpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAyB,CAAA;AAEjE;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,cAAsB,sBAAsB,EAC5C,UAAmB,IAAI;IAOvB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAoB,EAAE,CAAC,CAAA;IAC7D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAEvD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAA;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAA;YAEd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,CAAA;YAEzC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;YAC5C,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAClC,mDAAmD;YACnD,MAAM,cAAc,GAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAC7D,CAAC,GAAsC,EAAE,EAAE,CAAC,CAAC;gBAC3C,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CACH,CAAA;YACD,UAAU,CAAC,cAAc,CAAC,CAAA;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAA;YACvE,UAAU,CAAC,EAAE,CAAC,CAAA;QAChB,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAA;IAE1B,gBAAgB;IAChB,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,EAAE,CAAA;IAChB,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,4BAA4B;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,YAAY,EAAE,CAAA;QAChB,CAAC,CAAA;QAED,MAAM,CAAC,gBAAgB,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAA;QAC/D,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAA;QACpE,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAA;IAE3B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AAC3D,CAAC"}

package/dist/ai/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @delmaredigital/payload-puck/ai
+ *
+ * AI integration for the Puck visual editor.
+ *
+ * This module provides:
+ * - Server-side API route handlers for Puck AI chat
+ * - Headless page generation for programmatic workflows
+ * - Client-side AI plugin factory
+ * - Prompt editor plugin for managing prompts in the editor
+ * - Utilities for adding AI metadata to component configs
+ *
+ * @example Quick Start
+ * ```typescript
+ * // 1. Create API route for AI chat
+ * // app/api/puck/[...all]/route.ts
+ * import { createPuckAiApiRoutes } from '@delmaredigital/payload-puck/ai'
+ *
+ * export const POST = createPuckAiApiRoutes({
+ *   payloadConfig: config,
+ *   auth: { authenticate: async (req) => ... },
+ *   ai: { context: 'We are Acme Corp...' },
+ * })
+ *
+ * // 2. Enable AI in the editor
+ * <PuckEditor enableAi={true} />
+ *
+ * // Or use the factory for custom prompts
+ * import { createAiPlugin } from '@delmaredigital/payload-puck/ai'
+ * const aiPlugin = createAiPlugin({ examplePrompts: [...] })
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createPuckAiApiRoutes } from './createAiApiRoutes.js';
+export { createAiGenerate } from './createAiGenerate.js';
+export { createPromptApiRoutes, createPromptApiRoutesWithId, type PromptApiRoutesConfig, } from './plugins/promptApiRoutes.js';
+export { createAiPlugin } from './createAiPlugin.js';
+export { createPromptEditorPlugin } from './plugins/promptEditorPlugin.js';
+export { PromptEditorPanel } from './plugins/PromptEditorPanel.js';
+export { createContextEditorPlugin } from './plugins/contextEditorPlugin.js';
+export { ContextEditorPanel } from './plugins/ContextEditorPanel.js';
+export { useAiPrompts, dispatchPromptsUpdated, AI_PROMPTS_UPDATED_EVENT, } from './hooks/useAiPrompts.js';
+export { useAiContext, dispatchContextUpdated, AI_CONTEXT_UPDATED_EVENT, type UseAiContextOptions, type UseAiContextReturn, } from './hooks/useAiContext.js';
+export { createPayloadTools, createTool, type PayloadToolsConfig, } from './tools/index.js';
+export { injectAiConfig, hasAiConfig } from './utils/injectAiConfig.js';
+export { defaultComponentAiConfig, minimalComponentAiConfig, } from './presets/componentAiDefaults.js';
+export { comprehensiveComponentAiConfig, pagePatternSystemContext, pagePatternContext, componentFieldReference, allComponents, componentNames, typographyInstructions, layoutInstructions, interactiveInstructions, mediaInstructions, } from './presets/index.js';
+export type { AiTool, AiToolContext, AiOptions, AiFieldConfig, AiComponentConfig, PuckAiRoutesConfig, PuckAiRouteHandlers, AiGenerateConfig, AiGenerateOptions, AiGenerateFunction, AiPluginOptions, AiExamplePrompt, PromptEditorPluginOptions, ComponentAiOverrides, AiPrompt, AiContext, ContextEditorPluginOptions, PuckPluginAiConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAA;AAMrC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAMpE,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAA;AAMhC,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAGvE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EAEd,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAM3B,YAAY,EAEV,MAAM,EACN,aAAa,EAEb,SAAS,EACT,aAAa,EACb,iBAAiB,EAEjB,kBAAkB,EAClB,mBAAmB,EAEnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAElB,eAAe,EACf,eAAe,EACf,yBAAyB,EAEzB,oBAAoB,EAEpB,QAAQ,EAER,SAAS,EACT,0BAA0B,EAE1B,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/ai/index.js

@@ -0,0 +1,69 @@
+/**
+ * @delmaredigital/payload-puck/ai
+ *
+ * AI integration for the Puck visual editor.
+ *
+ * This module provides:
+ * - Server-side API route handlers for Puck AI chat
+ * - Headless page generation for programmatic workflows
+ * - Client-side AI plugin factory
+ * - Prompt editor plugin for managing prompts in the editor
+ * - Utilities for adding AI metadata to component configs
+ *
+ * @example Quick Start
+ * ```typescript
+ * // 1. Create API route for AI chat
+ * // app/api/puck/[...all]/route.ts
+ * import { createPuckAiApiRoutes } from '@delmaredigital/payload-puck/ai'
+ *
+ * export const POST = createPuckAiApiRoutes({
+ *   payloadConfig: config,
+ *   auth: { authenticate: async (req) => ... },
+ *   ai: { context: 'We are Acme Corp...' },
+ * })
+ *
+ * // 2. Enable AI in the editor
+ * <PuckEditor enableAi={true} />
+ *
+ * // Or use the factory for custom prompts
+ * import { createAiPlugin } from '@delmaredigital/payload-puck/ai'
+ * const aiPlugin = createAiPlugin({ examplePrompts: [...] })
+ * <PuckEditor plugins={[aiPlugin]} />
+ * ```
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Server-side exports (API route factories)
+// =============================================================================
+export { createPuckAiApiRoutes } from './createAiApiRoutes.js';
+export { createAiGenerate } from './createAiGenerate.js';
+export { createPromptApiRoutes, createPromptApiRoutesWithId, } from './plugins/promptApiRoutes.js';
+// =============================================================================
+// Client-side exports (plugins)
+// =============================================================================
+export { createAiPlugin } from './createAiPlugin.js';
+export { createPromptEditorPlugin } from './plugins/promptEditorPlugin.js';
+export { PromptEditorPanel } from './plugins/PromptEditorPanel.js';
+export { createContextEditorPlugin } from './plugins/contextEditorPlugin.js';
+export { ContextEditorPanel } from './plugins/ContextEditorPanel.js';
+// =============================================================================
+// Client-side exports (hooks)
+// =============================================================================
+export { useAiPrompts, dispatchPromptsUpdated, AI_PROMPTS_UPDATED_EVENT, } from './hooks/useAiPrompts.js';
+export { useAiContext, dispatchContextUpdated, AI_CONTEXT_UPDATED_EVENT, } from './hooks/useAiContext.js';
+// =============================================================================
+// AI Tools
+// =============================================================================
+export { createPayloadTools, createTool, } from './tools/index.js';
+// =============================================================================
+// Configuration utilities
+// =============================================================================
+export { injectAiConfig, hasAiConfig } from './utils/injectAiConfig.js';
+// Legacy exports for backward compatibility
+export { defaultComponentAiConfig, minimalComponentAiConfig, } from './presets/componentAiDefaults.js';
+// New comprehensive AI config exports
+export { comprehensiveComponentAiConfig, pagePatternSystemContext, pagePatternContext, componentFieldReference, allComponents, componentNames, 
+// Individual instruction modules for advanced usage
+typographyInstructions, layoutInstructions, interactiveInstructions, mediaInstructions, } from './presets/index.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,8BAA8B,CAAA;AAErC,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEpE,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,GAGzB,MAAM,yBAAyB,CAAA;AAEhC,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,OAAO,EACL,kBAAkB,EAClB,UAAU,GAEX,MAAM,kBAAkB,CAAA;AAEzB,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvE,4CAA4C;AAC5C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AAEzC,sCAAsC;AACtC,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc;AACd,oDAAoD;AACpD,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA"}

package/dist/ai/plugins/ContextEditorPanel.d.ts

@@ -0,0 +1,9 @@
+import type { ContextEditorPluginOptions } from '../types.js';
+interface ContextEditorPanelProps extends ContextEditorPluginOptions {
+}
+/**
+ * Panel component for managing AI context in the Puck editor sidebar
+ */
+export declare function ContextEditorPanel({ apiEndpoint, canEdit, canCreate, canDelete, }: ContextEditorPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ContextEditorPanel.d.ts.map

package/dist/ai/plugins/ContextEditorPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextEditorPanel.d.ts","sourceRoot":"","sources":["../../../src/ai/plugins/ContextEditorPanel.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAGxE,UAAU,uBAAwB,SAAQ,0BAA0B;CAAG;AAYvE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,WAAoC,EACpC,OAAc,EACd,SAAgB,EAChB,SAAgB,GACjB,EAAE,uBAAuB,2CA0kBzB"}