@ai-stack/payloadcms 3.68.0-beta.1 → 3.68.0-beta.2

package/dist/ui/VoicesFetcher/index.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Button, useForm } from '@payloadcms/ui';
+import { Button, useForm, useFormFields } from '@payloadcms/ui';
 import React, { useCallback, useState } from 'react';
 import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
 /**
@@ -14,6 +14,9 @@ import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
     const fieldPath = path || '';
     const blockPath = fieldPath.split('.').slice(0, -1).join('.');
     const voicesPath = `${blockPath}.voices`;
+    // Get the current voices array to know how many rows to remove
+    const voicesField = useFormFields(([fields])=>fields[voicesPath]);
+    const currentRowCount = voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows) ? voicesField.rows.length : 0;
     const fetchVoices = useCallback(async ()=>{
         setLoading(true);
         try {
@@ -29,19 +32,62 @@ import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
                 throw new Error(error.message || 'Failed to fetch voices');
             }
             const data = await response.json();
-            // Update the voices field with fetched voices
-            dispatchFields({
-                type: 'UPDATE',
-                path: voicesPath,
-                value: data.voices || []
-            });
-            alert(`Successfully fetched ${data.voices?.length || 0} voices!`);
+            const voices = data.voices || [];
+            // Remove existing rows first (in reverse order to maintain indices)
+            for(let i = currentRowCount - 1; i >= 0; i--){
+                dispatchFields({
+                    type: 'REMOVE_ROW',
+                    path: voicesPath,
+                    rowIndex: i
+                });
+            }
+            // Add new rows for each voice using ADD_ROW action
+            for (const voice of voices){
+                dispatchFields({
+                    type: 'ADD_ROW',
+                    path: voicesPath,
+                    subFieldState: {
+                        id: {
+                            initialValue: voice.id,
+                            valid: true,
+                            value: voice.id
+                        },
+                        name: {
+                            initialValue: voice.name,
+                            valid: true,
+                            value: voice.name
+                        },
+                        category: {
+                            initialValue: voice.category || 'premade',
+                            valid: true,
+                            value: voice.category || 'premade'
+                        },
+                        enabled: {
+                            initialValue: voice.enabled !== false,
+                            valid: true,
+                            value: voice.enabled !== false
+                        },
+                        labels: {
+                            initialValue: voice.labels || {},
+                            valid: true,
+                            value: voice.labels || {}
+                        },
+                        preview_url: {
+                            initialValue: voice.preview_url || '',
+                            valid: true,
+                            value: voice.preview_url || ''
+                        }
+                    }
+                });
+            }
+            alert(`Successfully fetched ${voices.length} voices!`);
         } catch (error) {
             alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`);
         } finally{
             setLoading(false);
         }
     }, [
+        currentRowCount,
         dispatchFields,
         voicesPath
     ]);

package/dist/ui/VoicesFetcher/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/ui/VoicesFetcher/index.tsx"],"sourcesContent":["'use client'\n\nimport type { FieldClientComponent } from 'payload'\n\nimport { Button, useForm } from '@payloadcms/ui'\nimport React, { useCallback, useState } from 'react'\n\nimport { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js'\n\n/**\n * VoicesFetcher Component\n * Fetches voices from ElevenLabs API (server-side) and populates the voices array field\n * SECURE: API key is never exposed to the client\n */\nexport const VoicesFetcher: FieldClientComponent = ({ path }) => {\n  const [loading, setLoading] = useState(false)\n  const { dispatchFields } = useForm()\n\n  // Get the parent path (the block path)\n  const fieldPath = (path as string) || ''\n  const blockPath = fieldPath.split('.').slice(0, -1).join('.')\n  const voicesPath = `${blockPath}.voices`\n\n  const fetchVoices = useCallback(async () => {\n    setLoading(true)\n\n    try {\n      // Call server endpoint - it will read the API key from the database\n      const response = await fetch(`/api${PLUGIN_API_ENDPOINT_FETCH_VOICES}`, {\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        method: 'POST',\n      })\n\n      if (!response.ok) {\n        const error = await response.json()\n        throw new Error(error.message || 'Failed to fetch voices')\n      }\n\n      const data = await response.json()\n\n      // Update the voices field with fetched voices\n      dispatchFields({\n        type: 'UPDATE',\n        path: voicesPath,\n        value: data.voices || [],\n      })\n\n      alert(`Successfully fetched ${data.voices?.length || 0} voices!`)\n    } catch (error) {\n      alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`)\n    } finally {\n      setLoading(false)\n    }\n  }, [dispatchFields, voicesPath])\n\n  return (\n    <div style={{ marginBottom: '20px' }}>\n      <Button buttonStyle=\"secondary\" disabled={loading} onClick={fetchVoices} size=\"medium\">\n        {loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'}\n      </Button>\n      <p style={{ color: 'var(--theme-elevation-600)', fontSize: '13px', marginTop: '8px' }}>\n        This will fetch all available voices from your ElevenLabs account. Make sure you have saved\n        your API key in the Setup tab first.\n      </p>\n    </div>\n  )\n}\n"],"names":["Button","useForm","React","useCallback","useState","PLUGIN_API_ENDPOINT_FETCH_VOICES","VoicesFetcher","path","loading","setLoading","dispatchFields","fieldPath","blockPath","split","slice","join","voicesPath","fetchVoices","response","fetch","headers","method","ok","error","json","Error","message","data","type","value","voices","alert","length","div","style","marginBottom","buttonStyle","disabled","onClick","size","p","color","fontSize","marginTop"],"mappings":"AAAA;;AAIA,SAASA,MAAM,EAAEC,OAAO,QAAQ,iBAAgB;AAChD,OAAOC,SAASC,WAAW,EAAEC,QAAQ,QAAQ,QAAO;AAEpD,SAASC,gCAAgC,QAAQ,oBAAmB;AAEpE;;;;CAIC,GACD,OAAO,MAAMC,gBAAsC,CAAC,EAAEC,IAAI,EAAE;IAC1D,MAAM,CAACC,SAASC,WAAW,GAAGL,SAAS;IACvC,MAAM,EAAEM,cAAc,EAAE,GAAGT;IAE3B,uCAAuC;IACvC,MAAMU,YAAY,AAACJ,QAAmB;IACtC,MAAMK,YAAYD,UAAUE,KAAK,CAAC,KAAKC,KAAK,CAAC,GAAG,CAAC,GAAGC,IAAI,CAAC;IACzD,MAAMC,aAAa,CAAC,EAAEJ,UAAU,OAAO,CAAC;IAExC,MAAMK,cAAcd,YAAY;QAC9BM,WAAW;QAEX,IAAI;YACF,oEAAoE;YACpE,MAAMS,WAAW,MAAMC,MAAM,CAAC,IAAI,EAAEd,iCAAiC,CAAC,EAAE;gBACtEe,SAAS;oBACP,gBAAgB;gBAClB;gBACAC,QAAQ;YACV;YAEA,IAAI,CAACH,SAASI,EAAE,EAAE;gBAChB,MAAMC,QAAQ,MAAML,SAASM,IAAI;gBACjC,MAAM,IAAIC,MAAMF,MAAMG,OAAO,IAAI;YACnC;YAEA,MAAMC,OAAO,MAAMT,SAASM,IAAI;YAEhC,8CAA8C;YAC9Cd,eAAe;gBACbkB,MAAM;gBACNrB,MAAMS;gBACNa,OAAOF,KAAKG,MAAM,IAAI,EAAE;YAC1B;YAEAC,MAAM,CAAC,qBAAqB,EAAEJ,KAAKG,MAAM,EAAEE,UAAU,EAAE,QAAQ,CAAC;QAClE,EAAE,OAAOT,OAAO;YACdQ,MAAM,CAAC,OAAO,EAAER,iBAAiBE,QAAQF,MAAMG,OAAO,GAAG,yBAAyB,CAAC;QACrF,SAAU;YACRjB,WAAW;QACb;IACF,GAAG;QAACC;QAAgBM;KAAW;IAE/B,qBACE,MAACiB;QAAIC,OAAO;YAAEC,cAAc;QAAO;;0BACjC,KAACnC;gBAAOoC,aAAY;gBAAYC,UAAU7B;gBAAS8B,SAASrB;gBAAasB,MAAK;0BAC3E/B,UAAU,uBAAuB;;0BAEpC,KAACgC;gBAAEN,OAAO;oBAAEO,OAAO;oBAA8BC,UAAU;oBAAQC,WAAW;gBAAM;0BAAG;;;;AAM7F,EAAC"}
+{"version":3,"sources":["../../../src/ui/VoicesFetcher/index.tsx"],"sourcesContent":["'use client'\n\nimport type { FieldClientComponent } from 'payload'\n\nimport { Button, useForm, useFormFields } from '@payloadcms/ui'\nimport React, { useCallback, useState } from 'react'\n\nimport { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js'\n\ninterface Voice {\n  category?: string\n  enabled?: boolean\n  id: string\n  labels?: Record<string, unknown>\n  name: string\n  preview_url?: string\n}\n\n/**\n * VoicesFetcher Component\n * Fetches voices from ElevenLabs API (server-side) and populates the voices array field\n * SECURE: API key is never exposed to the client\n */\nexport const VoicesFetcher: FieldClientComponent = ({ path }) => {\n  const [loading, setLoading] = useState(false)\n  const { dispatchFields } = useForm()\n\n  // Get the parent path (the block path)\n  const fieldPath = (path as string) || ''\n  const blockPath = fieldPath.split('.').slice(0, -1).join('.')\n  const voicesPath = `${blockPath}.voices`\n\n  // Get the current voices array to know how many rows to remove\n  const voicesField = useFormFields(([fields]) => fields[voicesPath])\n  const currentRowCount =\n    voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows)\n      ? voicesField.rows.length\n      : 0\n\n  const fetchVoices = useCallback(async () => {\n    setLoading(true)\n\n    try {\n      // Call server endpoint - it will read the API key from the database\n      const response = await fetch(`/api${PLUGIN_API_ENDPOINT_FETCH_VOICES}`, {\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        method: 'POST',\n      })\n\n      if (!response.ok) {\n        const error = await response.json()\n        throw new Error(error.message || 'Failed to fetch voices')\n      }\n\n      const data = await response.json()\n      const voices: Voice[] = data.voices || []\n\n      // Remove existing rows first (in reverse order to maintain indices)\n      for (let i = currentRowCount - 1; i >= 0; i--) {\n        dispatchFields({\n          type: 'REMOVE_ROW',\n          path: voicesPath,\n          rowIndex: i,\n        })\n      }\n\n      // Add new rows for each voice using ADD_ROW action\n      for (const voice of voices) {\n        dispatchFields({\n          type: 'ADD_ROW',\n          path: voicesPath,\n          subFieldState: {\n            id: { initialValue: voice.id, valid: true, value: voice.id },\n            name: { initialValue: voice.name, valid: true, value: voice.name },\n            category: { initialValue: voice.category || 'premade', valid: true, value: voice.category || 'premade' },\n            enabled: { initialValue: voice.enabled !== false, valid: true, value: voice.enabled !== false },\n            labels: { initialValue: voice.labels || {}, valid: true, value: voice.labels || {} },\n            preview_url: { initialValue: voice.preview_url || '', valid: true, value: voice.preview_url || '' },\n          },\n        })\n      }\n\n      alert(`Successfully fetched ${voices.length} voices!`)\n    } catch (error) {\n      alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`)\n    } finally {\n      setLoading(false)\n    }\n  }, [currentRowCount, dispatchFields, voicesPath])\n\n  return (\n    <div style={{ marginBottom: '20px' }}>\n      <Button buttonStyle=\"secondary\" disabled={loading} onClick={fetchVoices} size=\"medium\">\n        {loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'}\n      </Button>\n      <p style={{ color: 'var(--theme-elevation-600)', fontSize: '13px', marginTop: '8px' }}>\n        This will fetch all available voices from your ElevenLabs account. Make sure you have saved\n        your API key in the Setup tab first.\n      </p>\n    </div>\n  )\n}\n\n\n\n"],"names":["Button","useForm","useFormFields","React","useCallback","useState","PLUGIN_API_ENDPOINT_FETCH_VOICES","VoicesFetcher","path","loading","setLoading","dispatchFields","fieldPath","blockPath","split","slice","join","voicesPath","voicesField","fields","currentRowCount","Array","isArray","rows","length","fetchVoices","response","fetch","headers","method","ok","error","json","Error","message","data","voices","i","type","rowIndex","voice","subFieldState","id","initialValue","valid","value","name","category","enabled","labels","preview_url","alert","div","style","marginBottom","buttonStyle","disabled","onClick","size","p","color","fontSize","marginTop"],"mappings":"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"}

package/dist/ui/VoicesFetcher/index.jsx

@@ -1,5 +1,5 @@
 'use client';
-import { Button, useForm } from '@payloadcms/ui';
+import { Button, useForm, useFormFields } from '@payloadcms/ui';
 import React, { useCallback, useState } from 'react';
 import { PLUGIN_API_ENDPOINT_FETCH_VOICES } from '../../defaults.js';
 /**
@@ -14,6 +14,11 @@ export const VoicesFetcher = ({ path }) => {
     const fieldPath = path || '';
     const blockPath = fieldPath.split('.').slice(0, -1).join('.');
     const voicesPath = `${blockPath}.voices`;
+    // Get the current voices array to know how many rows to remove
+    const voicesField = useFormFields(([fields]) => fields[voicesPath]);
+    const currentRowCount = voicesField && 'rows' in voicesField && Array.isArray(voicesField.rows)
+        ? voicesField.rows.length
+        : 0;
     const fetchVoices = useCallback(async () => {
         setLoading(true);
         try {
@@ -29,13 +34,31 @@ export const VoicesFetcher = ({ path }) => {
                 throw new Error(error.message || 'Failed to fetch voices');
             }
             const data = await response.json();
-            // Update the voices field with fetched voices
-            dispatchFields({
-                type: 'UPDATE',
-                path: voicesPath,
-                value: data.voices || [],
-            });
-            alert(`Successfully fetched ${data.voices?.length || 0} voices!`);
+            const voices = data.voices || [];
+            // Remove existing rows first (in reverse order to maintain indices)
+            for (let i = currentRowCount - 1; i >= 0; i--) {
+                dispatchFields({
+                    type: 'REMOVE_ROW',
+                    path: voicesPath,
+                    rowIndex: i,
+                });
+            }
+            // Add new rows for each voice using ADD_ROW action
+            for (const voice of voices) {
+                dispatchFields({
+                    type: 'ADD_ROW',
+                    path: voicesPath,
+                    subFieldState: {
+                        id: { initialValue: voice.id, valid: true, value: voice.id },
+                        name: { initialValue: voice.name, valid: true, value: voice.name },
+                        category: { initialValue: voice.category || 'premade', valid: true, value: voice.category || 'premade' },
+                        enabled: { initialValue: voice.enabled !== false, valid: true, value: voice.enabled !== false },
+                        labels: { initialValue: voice.labels || {}, valid: true, value: voice.labels || {} },
+                        preview_url: { initialValue: voice.preview_url || '', valid: true, value: voice.preview_url || '' },
+                    },
+                });
+            }
+            alert(`Successfully fetched ${voices.length} voices!`);
         }
         catch (error) {
             alert(`Error: ${error instanceof Error ? error.message : 'Failed to fetch voices'}`);
@@ -43,7 +66,7 @@ export const VoicesFetcher = ({ path }) => {
         finally {
             setLoading(false);
         }
-    }, [dispatchFields, voicesPath]);
+    }, [currentRowCount, dispatchFields, voicesPath]);
     return (<div style={{ marginBottom: '20px' }}>
       <Button buttonStyle="secondary" disabled={loading} onClick={fetchVoices} size="medium">
         {loading ? 'Fetching Voices...' : 'Fetch Voices from ElevenLabs'}

package/dist/utilities/buildSmartPrompt.d.ts

@@ -0,0 +1,22 @@
+import type { Payload } from 'payload';
+export interface SmartPromptContext {
+    /** The document data for template interpolation */
+    documentData?: Record<string, unknown>;
+    /** The Payload instance to access collection config */
+    payload: Payload;
+    /** The schema path like 'array-test-cases.teamMembers.contact.email' */
+    schemaPath: string;
+}
+/**
+ * Build a smart contextual prompt based on field metadata.
+ * This is used as a fallback when the user hasn't set a custom prompt.
+ *
+ * @param context - The context containing schema path and document data
+ * @returns A contextual prompt string that can be used for AI generation
+ */
+export declare const buildSmartPrompt: (context: SmartPromptContext) => string;
+/**
+ * Check if a prompt template is empty and should be replaced with a smart prompt.
+ * Only triggers when the prompt is completely empty or whitespace-only.
+ */
+export declare const isGenericPrompt: (template: null | string | undefined) => boolean;

package/dist/utilities/buildSmartPrompt.js

@@ -0,0 +1,143 @@
+'use strict';
+import { getFieldBySchemaPath } from './getFieldBySchemaPath.js';
+/**
+ * Extract field information from a schema path
+ */ const getFieldInfo = (schemaPath, payload)=>{
+    const parts = schemaPath.split('.');
+    const collectionSlug = parts[0];
+    const fieldPath = parts.slice(1);
+    const fieldName = fieldPath[fieldPath.length - 1] || '';
+    // Get parent context (e.g., 'teamMembers' for 'teamMembers.name')
+    let parentContext = null;
+    if (fieldPath.length > 1) {
+        parentContext = fieldPath[fieldPath.length - 2];
+    }
+    // Try to get the actual field configuration from the collection
+    let field = null;
+    const collection = payload.config.collections.find((c)=>c.slug === collectionSlug);
+    if (collection) {
+        field = getFieldBySchemaPath(collection, schemaPath);
+    }
+    return {
+        name: fieldName,
+        type: field?.type || 'text',
+        field,
+        label: field?.label || fieldName,
+        parentContext
+    };
+};
+/**
+ * Humanize a camelCase or snake_case field name
+ * e.g., 'teamMembers' -> 'team members', 'first_name' -> 'first name'
+ */ const humanize = (str)=>{
+    return str.replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase to spaces
+    .replace(/[_-]/g, ' ') // underscores/dashes to spaces
+    .toLowerCase().trim();
+};
+/**
+ * Get a description snippet from field admin config
+ */ const getFieldDescription = (field)=>{
+    if (!field) {
+        return null;
+    }
+    const admin = field.admin;
+    if (admin?.description && typeof admin.description === 'string') {
+        return admin.description;
+    }
+    return null;
+};
+/**
+ * Build type-specific prompt guidance
+ */ const getTypeGuidance = (type, fieldName)=>{
+    const nameHint = humanize(fieldName);
+    switch(type){
+        case 'code':
+            return `Generate code for ${nameHint}`;
+        case 'date':
+            return `Generate an appropriate date for ${nameHint}`;
+        case 'email':
+            return `Generate a valid professional email address`;
+        case 'json':
+            return `Generate valid JSON data for ${nameHint}`;
+        case 'number':
+            return `Generate an appropriate numeric value for ${nameHint}`;
+        case 'select':
+            return `Select an appropriate option for ${nameHint}`;
+        case 'text':
+            return `Generate appropriate text for ${nameHint}`;
+        case 'textarea':
+            return `Write detailed content for ${nameHint}`;
+        case 'upload':
+            // Explicit image generation instruction for multimodal models
+            return `Generate an image of ${nameHint}`;
+        default:
+            return `Generate content for ${nameHint}`;
+    }
+};
+/**
+ * Build context from parent field name using generic humanization.
+ * Works universally for any collection structure.
+ */ const getParentContextPhrase = (parentContext)=>{
+    if (!parentContext) {
+        return '';
+    }
+    const humanized = humanize(parentContext);
+    // Use singular form if the name ends with 's' (common for arrays)
+    // e.g., "teamMembers" → "team member", "products" → "product"
+    if (humanized.endsWith('s') && humanized.length > 2) {
+        return `for a ${humanized.slice(0, -1)} entry`;
+    }
+    return `for ${humanized}`;
+};
+/**
+ * Build a smart contextual prompt based on field metadata.
+ * This is used as a fallback when the user hasn't set a custom prompt.
+ * 
+ * @param context - The context containing schema path and document data
+ * @returns A contextual prompt string that can be used for AI generation
+ */ export const buildSmartPrompt = (context)=>{
+    const { documentData, payload, schemaPath } = context;
+    const fieldInfo = getFieldInfo(schemaPath, payload);
+    const { name, type, field, label, parentContext } = fieldInfo;
+    // Start with the field's own description if available
+    const description = getFieldDescription(field);
+    // Build the prompt components
+    const parts = [];
+    // Use description as primary guidance if available
+    if (description) {
+        parts.push(description);
+    } else {
+        // Fall back to type-based guidance, prefer label over name for better context
+        parts.push(getTypeGuidance(type, label || name));
+    }
+    // Add parent context if nested
+    const parentPhrase = getParentContextPhrase(parentContext);
+    if (parentPhrase) {
+        parts.push(parentPhrase);
+    }
+    // Add document title context if available
+    const title = documentData?.title;
+    if (title && typeof title === 'string') {
+        parts.push(`in the context of "${title}"`);
+    }
+    // Build the final prompt
+    let prompt = parts.join(' ');
+    // Ensure first letter is capitalized
+    prompt = prompt.charAt(0).toUpperCase() + prompt.slice(1);
+    // Add instruction suffix for clarity
+    if (!prompt.endsWith('.')) {
+        prompt += '.';
+    }
+    return prompt;
+};
+/**
+ * Check if a prompt template is empty and should be replaced with a smart prompt.
+ * Only triggers when the prompt is completely empty or whitespace-only.
+ */ export const isGenericPrompt = (template)=>{
+    if (!template) {
+        return true;
+    }
+    return template.trim() === '';
+};
+
+//# sourceMappingURL=buildSmartPrompt.js.map

package/dist/utilities/buildSmartPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildSmartPrompt.ts"],"sourcesContent":["'use strict'\n\nimport type { Field, Payload } from 'payload'\n\nimport { getFieldBySchemaPath } from './getFieldBySchemaPath.js'\n\nexport interface SmartPromptContext {\n  /** The document data for template interpolation */\n  documentData?: Record<string, unknown>\n  /** The Payload instance to access collection config */\n  payload: Payload\n  /** The schema path like 'array-test-cases.teamMembers.contact.email' */\n  schemaPath: string\n}\n\ninterface FieldInfo {\n  /** The field configuration */\n  field: Field | null\n  /** Human-readable field label */\n  label: string\n  /** Field name from the path */\n  name: string\n  /** Parent field name if nested (e.g., 'teamMembers' for 'teamMembers.name') */\n  parentContext: null | string\n  /** The field type */\n  type: string\n}\n\n/**\n * Extract field information from a schema path\n */\nconst getFieldInfo = (schemaPath: string, payload: Payload): FieldInfo => {\n  const parts = schemaPath.split('.')\n  const collectionSlug = parts[0]\n  const fieldPath = parts.slice(1)\n  const fieldName = fieldPath[fieldPath.length - 1] || ''\n  \n  // Get parent context (e.g., 'teamMembers' for 'teamMembers.name')\n  let parentContext: null | string = null\n  if (fieldPath.length > 1) {\n    parentContext = fieldPath[fieldPath.length - 2]\n  }\n  \n  // Try to get the actual field configuration from the collection\n  let field: Field | null = null\n  const collection = payload.config.collections.find(c => c.slug === collectionSlug)\n  if (collection) {\n    field = getFieldBySchemaPath(collection, schemaPath)\n  }\n  \n  return {\n    name: fieldName,\n    type: field?.type || 'text',\n    field,\n    label: (field as { label?: string })?.label || fieldName,\n    parentContext,\n  }\n}\n\n/**\n * Humanize a camelCase or snake_case field name\n * e.g., 'teamMembers' -> 'team members', 'first_name' -> 'first name'\n */\nconst humanize = (str: string): string => {\n  return str\n    .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase to spaces\n    .replace(/[_-]/g, ' ') // underscores/dashes to spaces\n    .toLowerCase()\n    .trim()\n}\n\n/**\n * Get a description snippet from field admin config\n */\nconst getFieldDescription = (field: Field | null): null | string => {\n  if (!field) {return null}\n  const admin = (field as { admin?: { description?: string } }).admin\n  if (admin?.description && typeof admin.description === 'string') {\n    return admin.description\n  }\n  return null\n}\n\n/**\n * Build type-specific prompt guidance\n */\nconst getTypeGuidance = (type: string, fieldName: string): string => {\n  const nameHint = humanize(fieldName)\n  \n  switch (type) {\n    case 'code':\n      return `Generate code for ${nameHint}`\n    case 'date':\n      return `Generate an appropriate date for ${nameHint}`\n    case 'email':\n      return `Generate a valid professional email address`\n    case 'json':\n      return `Generate valid JSON data for ${nameHint}`\n    case 'number':\n      return `Generate an appropriate numeric value for ${nameHint}`\n    case 'select':\n      return `Select an appropriate option for ${nameHint}`\n    case 'text':\n      return `Generate appropriate text for ${nameHint}`\n    case 'textarea':\n      return `Write detailed content for ${nameHint}`\n    case 'upload':\n      // Explicit image generation instruction for multimodal models\n      return `Generate an image of ${nameHint}`\n    default:\n      return `Generate content for ${nameHint}`\n  }\n}\n\n/**\n * Build context from parent field name using generic humanization.\n * Works universally for any collection structure.\n */\nconst getParentContextPhrase = (parentContext: null | string): string => {\n  if (!parentContext) {\n    return ''\n  }\n  \n  const humanized = humanize(parentContext)\n  \n  // Use singular form if the name ends with 's' (common for arrays)\n  // e.g., \"teamMembers\" → \"team member\", \"products\" → \"product\"\n  if (humanized.endsWith('s') && humanized.length > 2) {\n    return `for a ${humanized.slice(0, -1)} entry`\n  }\n  \n  return `for ${humanized}`\n}\n\n/**\n * Build a smart contextual prompt based on field metadata.\n * This is used as a fallback when the user hasn't set a custom prompt.\n * \n * @param context - The context containing schema path and document data\n * @returns A contextual prompt string that can be used for AI generation\n */\nexport const buildSmartPrompt = (context: SmartPromptContext): string => {\n  const { documentData, payload, schemaPath } = context\n  \n  const fieldInfo = getFieldInfo(schemaPath, payload)\n  const { name, type, field, label, parentContext } = fieldInfo\n  \n  // Start with the field's own description if available\n  const description = getFieldDescription(field)\n  \n  // Build the prompt components\n  const parts: string[] = []\n  \n  // Use description as primary guidance if available\n  if (description) {\n    parts.push(description)\n  } else {\n    // Fall back to type-based guidance, prefer label over name for better context\n    parts.push(getTypeGuidance(type, label || name))\n  }\n  \n  // Add parent context if nested\n  const parentPhrase = getParentContextPhrase(parentContext)\n  if (parentPhrase) {\n    parts.push(parentPhrase)\n  }\n  \n  // Add document title context if available\n  const title = documentData?.title\n  if (title && typeof title === 'string') {\n    parts.push(`in the context of \"${title}\"`)\n  }\n  \n  // Build the final prompt\n  let prompt = parts.join(' ')\n  \n  // Ensure first letter is capitalized\n  prompt = prompt.charAt(0).toUpperCase() + prompt.slice(1)\n  \n  // Add instruction suffix for clarity\n  if (!prompt.endsWith('.')) {\n    prompt += '.'\n  }\n  \n  return prompt\n}\n\n/**\n * Check if a prompt template is empty and should be replaced with a smart prompt.\n * Only triggers when the prompt is completely empty or whitespace-only.\n */\nexport const isGenericPrompt = (template: null | string | undefined): boolean => {\n  if (!template) {\n    return true\n  }\n  return template.trim() === ''\n}\n"],"names":["getFieldBySchemaPath","getFieldInfo","schemaPath","payload","parts","split","collectionSlug","fieldPath","slice","fieldName","length","parentContext","field","collection","config","collections","find","c","slug","name","type","label","humanize","str","replace","toLowerCase","trim","getFieldDescription","admin","description","getTypeGuidance","nameHint","getParentContextPhrase","humanized","endsWith","buildSmartPrompt","context","documentData","fieldInfo","push","parentPhrase","title","prompt","join","charAt","toUpperCase","isGenericPrompt","template"],"mappings":"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"}

package/dist/utilities/resolveImageReferences.d.ts

@@ -17,12 +17,14 @@ interface ResolveImageReferencesResult {
  *
  * Supports two formats:
  * - @fieldName - for single upload fields
+ * - @collection.fieldName - schema path format (collection prefix is stripped)
  * - @fieldName:filename.jpg - for specific images in hasMany fields
  *
  * @param prompt - The prompt text containing @field references
  * @param contextData - The document data to resolve field values from
  * @param req - Payload request object for fetching media
+ * @param collectionSlug - Optional collection slug to strip from schema path references
  * @returns Processed prompt with references removed and array of resolved images
  */
-export declare function resolveImageReferences(prompt: string, contextData: Record<string, unknown>, req: PayloadRequest): Promise<ResolveImageReferencesResult>;
+export declare function resolveImageReferences(prompt: string, contextData: Record<string, unknown>, req: PayloadRequest, collectionSlug?: string): Promise<ResolveImageReferencesResult>;
 export {};

package/dist/utilities/resolveImageReferences.js

@@ -1,15 +1,28 @@
+/**
+ * Retrieves a nested value from an object using dot-notation path.
+ * For example, getNestedValue(obj, 'a.b.c') returns obj.a.b.c
+ */ function getNestedValue(obj, path) {
+    return path.split('.').reduce((current, key)=>{
+        if (current && typeof current === 'object' && key in current) {
+            return current[key];
+        }
+        return undefined;
+    }, obj);
+}
 /**
  * Parses and resolves image references in prompts.
  * 
  * Supports two formats:
  * - @fieldName - for single upload fields
+ * - @collection.fieldName - schema path format (collection prefix is stripped)
  * - @fieldName:filename.jpg - for specific images in hasMany fields
  * 
  * @param prompt - The prompt text containing @field references
  * @param contextData - The document data to resolve field values from
  * @param req - Payload request object for fetching media
+ * @param collectionSlug - Optional collection slug to strip from schema path references
  * @returns Processed prompt with references removed and array of resolved images
- */ export async function resolveImageReferences(prompt, contextData, req) {
+ */ export async function resolveImageReferences(prompt, contextData, req, collectionSlug) {
     // Pattern matches: @fieldName or @fieldName:filename.ext (filename can have spaces)
     // The filename part matches everything up to and including an image extension
     const pattern = /@([\w.]+)(?::(.+?\.(?:png|jpe?g|webp|gif)))?/gi;
@@ -34,7 +47,13 @@
     // Resolve each reference
     for (const ref of references){
         try {
-            const fieldValue = contextData[ref.fieldName];
+            // Strip collection prefix from schema path if it matches the current collection
+            // e.g., "characters.ortho3d.frame" becomes "ortho3d.frame" when collectionSlug is "characters"
+            let fieldPath = ref.fieldName;
+            if (collectionSlug && fieldPath.startsWith(`${collectionSlug}.`)) {
+                fieldPath = fieldPath.slice(collectionSlug.length + 1);
+            }
+            const fieldValue = getNestedValue(contextData, fieldPath);
             if (!fieldValue) {
                 req.payload.logger.warn(`Image reference @${ref.fieldName} not found in document context`);
                 continue;

package/dist/utilities/resolveImageReferences.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/resolveImageReferences.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\ninterface ImageReference {\n  fieldName: string\n  filename?: string\n  fullMatch: string\n}\n\nexport interface ResolvedImage {\n  image: {\n    mimeType?: string\n    name: string\n    thumbnailURL?: string\n    type: string\n    url: string\n  }\n}\n\ninterface ResolveImageReferencesResult {\n  images: ResolvedImage[]\n  processedPrompt: string\n}\n\n/**\n * Parses and resolves image references in prompts.\n * \n * Supports two formats:\n * - @fieldName - for single upload fields\n * - @fieldName:filename.jpg - for specific images in hasMany fields\n * \n * @param prompt - The prompt text containing @field references\n * @param contextData - The document data to resolve field values from\n * @param req - Payload request object for fetching media\n * @returns Processed prompt with references removed and array of resolved images\n */\nexport async function resolveImageReferences(\n  prompt: string,\n  contextData: Record<string, unknown>,\n  req: PayloadRequest,\n): Promise<ResolveImageReferencesResult> {\n  // Pattern matches: @fieldName or @fieldName:filename.ext (filename can have spaces)\n  // The filename part matches everything up to and including an image extension\n  const pattern = /@([\\w.]+)(?::(.+?\\.(?:png|jpe?g|webp|gif)))?/gi\n  const references: ImageReference[] = []\n  let match: null | RegExpExecArray\n\n  // Extract all image references\n  while ((match = pattern.exec(prompt)) !== null) {\n    references.push({\n      fieldName: match[1],\n      filename: match[2],\n      fullMatch: match[0],\n    })\n  }\n\n  if (references.length === 0) {\n    return { images: [], processedPrompt: prompt }\n  }\n\n  const resolvedImages: ResolvedImage[] = []\n  let processedPrompt = prompt\n\n  // Resolve each reference\n  for (const ref of references) {\n    try {\n      const fieldValue = contextData[ref.fieldName]\n\n      if (!fieldValue) {\n        req.payload.logger.warn(\n          `Image reference @${ref.fieldName} not found in document context`,\n        )\n        continue\n      }\n\n      // Handle single upload field (value is an ID or object)\n      if (!ref.filename) {\n        const mediaDoc = await resolveMediaDocument(fieldValue, req)\n        if (mediaDoc) {\n          resolvedImages.push(formatImageData(mediaDoc))\n        }\n      }\n      // Handle hasMany field with filename\n      else {\n        const mediaDoc = await resolveMediaFromArray(fieldValue, ref.filename, req)\n        if (mediaDoc) {\n          resolvedImages.push(formatImageData(mediaDoc))\n        }\n      }\n\n      // Remove the reference from the prompt\n      processedPrompt = processedPrompt.replace(ref.fullMatch, '')\n    } catch (error) {\n      req.payload.logger.error(\n        error,\n        `Error resolving image reference: ${ref.fullMatch}`,\n      )\n    }\n  }\n\n  // Clean up extra whitespace from removed references\n  processedPrompt = processedPrompt.replace(/\\s+/g, ' ').trim()\n\n  return {\n    images: resolvedImages,\n    processedPrompt,\n  }\n}\n\n/**\n * Resolves a single media document from an ID or populated object\n */\nasync function resolveMediaDocument(\n  value: unknown,\n  req: PayloadRequest,\n): Promise<null | Record<string, unknown>> {\n  // If it's already a populated object with required fields\n  if (typeof value === 'object' && value !== null && 'url' in value) {\n    return value as Record<string, unknown>\n  }\n\n  // If it's an ID string, fetch the media document\n  if (typeof value === 'string' || typeof value === 'number') {\n    try {\n      // Try to find which collection this media belongs to\n      // First, check the common 'media' collection\n      const collections = ['media', 'uploads']\n\n      for (const collectionSlug of collections) {\n        try {\n          const mediaDoc = await req.payload.findByID({\n            id: value,\n            collection: collectionSlug,\n            req,\n          })\n          if (mediaDoc) {\n            return mediaDoc as Record<string, unknown>\n          }\n        } catch (_ignore) {\n          // Continue to next collection\n          continue\n        }\n      }\n    } catch (error) {\n      req.payload.logger.error(error, 'Error fetching media document')\n    }\n  }\n\n  return null\n}\n\n/**\n * Resolves a specific media document from an array by matching filename\n */\nasync function resolveMediaFromArray(\n  arrayValue: unknown,\n  filename: string,\n  req: PayloadRequest,\n): Promise<null | Record<string, unknown>> {\n  if (!Array.isArray(arrayValue)) {\n    return null\n  }\n\n  // Search through array for matching filename\n  for (const item of arrayValue) {\n    const mediaDoc = await resolveMediaDocument(item, req)\n\n    if (mediaDoc && matchesFilename(mediaDoc, filename)) {\n      return mediaDoc\n    }\n  }\n\n  return null\n}\n\n/**\n * Checks if a media document matches the given filename\n */\nfunction matchesFilename(mediaDoc: Record<string, unknown>, filename: string): boolean {\n  const docFilename = mediaDoc.filename || mediaDoc.name\n\n  if (!docFilename) {\n    return false\n  }\n\n  // Case-insensitive match\n  return (docFilename as string).toLowerCase() === filename.toLowerCase()\n}\n\n/**\n * Formats media document into the expected image data structure\n */\nfunction formatImageData(mediaDoc: Record<string, unknown>): ResolvedImage {\n  return {\n    image: {\n      name: (mediaDoc.filename || mediaDoc.name || 'unknown') as string,\n      type: extractFileExtension((mediaDoc.filename || mediaDoc.name || '') as string),\n      mimeType: (mediaDoc.mimeType || mediaDoc.mimetype) as string | undefined,\n      thumbnailURL: mediaDoc.thumbnailURL as string | undefined,\n      url: mediaDoc.url as string,\n    },\n  }\n}\n\n/**\n * Extracts file extension from filename\n */\nfunction extractFileExtension(filename: string): string {\n  const match = filename.match(/\\.([^.]+)$/)\n  return match ? match[1].toLowerCase() : 'unknown'\n}\n"],"names":["resolveImageReferences","prompt","contextData","req","pattern","references","match","exec","push","fieldName","filename","fullMatch","length","images","processedPrompt","resolvedImages","ref","fieldValue","payload","logger","warn","mediaDoc","resolveMediaDocument","formatImageData","resolveMediaFromArray","replace","error","trim","value","collections","collectionSlug","findByID","id","collection","_ignore","arrayValue","Array","isArray","item","matchesFilename","docFilename","name","toLowerCase","image","type","extractFileExtension","mimeType","mimetype","thumbnailURL","url"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/resolveImageReferences.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\ninterface ImageReference {\n  fieldName: string\n  filename?: string\n  fullMatch: string\n}\n\nexport interface ResolvedImage {\n  image: {\n    mimeType?: string\n    name: string\n    thumbnailURL?: string\n    type: string\n    url: string\n  }\n}\n\ninterface ResolveImageReferencesResult {\n  images: ResolvedImage[]\n  processedPrompt: string\n}\n\n/**\n * Retrieves a nested value from an object using dot-notation path.\n * For example, getNestedValue(obj, 'a.b.c') returns obj.a.b.c\n */\nfunction getNestedValue(obj: Record<string, unknown>, path: string): unknown {\n  return path.split('.').reduce((current, key) => {\n    if (current && typeof current === 'object' && key in current) {\n      return (current as Record<string, unknown>)[key]\n    }\n    return undefined\n  }, obj as unknown)\n}\n\n/**\n * Parses and resolves image references in prompts.\n * \n * Supports two formats:\n * - @fieldName - for single upload fields\n * - @collection.fieldName - schema path format (collection prefix is stripped)\n * - @fieldName:filename.jpg - for specific images in hasMany fields\n * \n * @param prompt - The prompt text containing @field references\n * @param contextData - The document data to resolve field values from\n * @param req - Payload request object for fetching media\n * @param collectionSlug - Optional collection slug to strip from schema path references\n * @returns Processed prompt with references removed and array of resolved images\n */\nexport async function resolveImageReferences(\n  prompt: string,\n  contextData: Record<string, unknown>,\n  req: PayloadRequest,\n  collectionSlug?: string,\n): Promise<ResolveImageReferencesResult> {\n  // Pattern matches: @fieldName or @fieldName:filename.ext (filename can have spaces)\n  // The filename part matches everything up to and including an image extension\n  const pattern = /@([\\w.]+)(?::(.+?\\.(?:png|jpe?g|webp|gif)))?/gi\n  const references: ImageReference[] = []\n  let match: null | RegExpExecArray\n\n  // Extract all image references\n  while ((match = pattern.exec(prompt)) !== null) {\n    references.push({\n      fieldName: match[1],\n      filename: match[2],\n      fullMatch: match[0],\n    })\n  }\n\n  if (references.length === 0) {\n    return { images: [], processedPrompt: prompt }\n  }\n\n  const resolvedImages: ResolvedImage[] = []\n  let processedPrompt = prompt\n\n  // Resolve each reference\n  for (const ref of references) {\n    try {\n      // Strip collection prefix from schema path if it matches the current collection\n      // e.g., \"characters.ortho3d.frame\" becomes \"ortho3d.frame\" when collectionSlug is \"characters\"\n      let fieldPath = ref.fieldName\n      if (collectionSlug && fieldPath.startsWith(`${collectionSlug}.`)) {\n        fieldPath = fieldPath.slice(collectionSlug.length + 1)\n      }\n\n      const fieldValue = getNestedValue(contextData, fieldPath)\n\n      if (!fieldValue) {\n        req.payload.logger.warn(\n          `Image reference @${ref.fieldName} not found in document context`,\n        )\n        continue\n      }\n\n      // Handle single upload field (value is an ID or object)\n      if (!ref.filename) {\n        const mediaDoc = await resolveMediaDocument(fieldValue, req)\n        if (mediaDoc) {\n          resolvedImages.push(formatImageData(mediaDoc))\n        }\n      }\n      // Handle hasMany field with filename\n      else {\n        const mediaDoc = await resolveMediaFromArray(fieldValue, ref.filename, req)\n        if (mediaDoc) {\n          resolvedImages.push(formatImageData(mediaDoc))\n        }\n      }\n\n      // Remove the reference from the prompt\n      processedPrompt = processedPrompt.replace(ref.fullMatch, '')\n    } catch (error) {\n      req.payload.logger.error(\n        error,\n        `Error resolving image reference: ${ref.fullMatch}`,\n      )\n    }\n  }\n\n  // Clean up extra whitespace from removed references\n  processedPrompt = processedPrompt.replace(/\\s+/g, ' ').trim()\n\n  return {\n    images: resolvedImages,\n    processedPrompt,\n  }\n}\n\n/**\n * Resolves a single media document from an ID or populated object\n */\nasync function resolveMediaDocument(\n  value: unknown,\n  req: PayloadRequest,\n): Promise<null | Record<string, unknown>> {\n  // If it's already a populated object with required fields\n  if (typeof value === 'object' && value !== null && 'url' in value) {\n    return value as Record<string, unknown>\n  }\n\n  // If it's an ID string, fetch the media document\n  if (typeof value === 'string' || typeof value === 'number') {\n    try {\n      // Try to find which collection this media belongs to\n      // First, check the common 'media' collection\n      const collections = ['media', 'uploads']\n\n      for (const collectionSlug of collections) {\n        try {\n          const mediaDoc = await req.payload.findByID({\n            id: value,\n            collection: collectionSlug,\n            req,\n          })\n          if (mediaDoc) {\n            return mediaDoc as Record<string, unknown>\n          }\n        } catch (_ignore) {\n          // Continue to next collection\n          continue\n        }\n      }\n    } catch (error) {\n      req.payload.logger.error(error, 'Error fetching media document')\n    }\n  }\n\n  return null\n}\n\n/**\n * Resolves a specific media document from an array by matching filename\n */\nasync function resolveMediaFromArray(\n  arrayValue: unknown,\n  filename: string,\n  req: PayloadRequest,\n): Promise<null | Record<string, unknown>> {\n  if (!Array.isArray(arrayValue)) {\n    return null\n  }\n\n  // Search through array for matching filename\n  for (const item of arrayValue) {\n    const mediaDoc = await resolveMediaDocument(item, req)\n\n    if (mediaDoc && matchesFilename(mediaDoc, filename)) {\n      return mediaDoc\n    }\n  }\n\n  return null\n}\n\n/**\n * Checks if a media document matches the given filename\n */\nfunction matchesFilename(mediaDoc: Record<string, unknown>, filename: string): boolean {\n  const docFilename = mediaDoc.filename || mediaDoc.name\n\n  if (!docFilename) {\n    return false\n  }\n\n  // Case-insensitive match\n  return (docFilename as string).toLowerCase() === filename.toLowerCase()\n}\n\n/**\n * Formats media document into the expected image data structure\n */\nfunction formatImageData(mediaDoc: Record<string, unknown>): ResolvedImage {\n  return {\n    image: {\n      name: (mediaDoc.filename || mediaDoc.name || 'unknown') as string,\n      type: extractFileExtension((mediaDoc.filename || mediaDoc.name || '') as string),\n      mimeType: (mediaDoc.mimeType || mediaDoc.mimetype) as string | undefined,\n      thumbnailURL: mediaDoc.thumbnailURL as string | undefined,\n      url: mediaDoc.url as string,\n    },\n  }\n}\n\n/**\n * Extracts file extension from filename\n */\nfunction extractFileExtension(filename: string): string {\n  const match = filename.match(/\\.([^.]+)$/)\n  return match ? match[1].toLowerCase() : 'unknown'\n}\n"],"names":["getNestedValue","obj","path","split","reduce","current","key","undefined","resolveImageReferences","prompt","contextData","req","collectionSlug","pattern","references","match","exec","push","fieldName","filename","fullMatch","length","images","processedPrompt","resolvedImages","ref","fieldPath","startsWith","slice","fieldValue","payload","logger","warn","mediaDoc","resolveMediaDocument","formatImageData","resolveMediaFromArray","replace","error","trim","value","collections","findByID","id","collection","_ignore","arrayValue","Array","isArray","item","matchesFilename","docFilename","name","toLowerCase","image","type","extractFileExtension","mimeType","mimetype","thumbnailURL","url"],"mappings":"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"}

package/dist/utilities/updateFieldsConfig.js

@@ -11,6 +11,7 @@ export const updateFieldsConfig = (collectionConfig)=>{
         // This is done due to save extra API call to get instructions when Field components are loaded in admin
         // Doing is will only call instructions data when user clicks on settings
         if ([
+            'array',
             'richText',
             'text',
             'textarea',
@@ -26,7 +27,9 @@ export const updateFieldsConfig = (collectionConfig)=>{
             };
         }
         // Inject AI actions, richText is not included here as it has to be explicitly defined by user
+        // Array fields also get AI injection for bulk generation
         if ([
+            'array',
             'text',
             'textarea',
             'upload'
@@ -39,6 +42,9 @@ export const updateFieldsConfig = (collectionConfig)=>{
                 // by overriding Description. If you need both, consider composing your own wrapper.
                 customField = {};
             }
+            // Array fields use ArrayComposeField (always visible) since they don't have focus events
+            // Other fields use ComposeField with focus-dependent visibility
+            const componentPath = field.type === 'array' ? '@ai-stack/payloadcms/fields#ArrayComposeField' : '@ai-stack/payloadcms/fields#ComposeField';
             return {
                 ...field,
                 admin: {
@@ -49,7 +55,7 @@ export const updateFieldsConfig = (collectionConfig)=>{
                             clientProps: {
                                 schemaPath: currentSchemaPath
                             },
-                            path: '@ai-stack/payloadcms/fields#ComposeField'
+                            path: componentPath
                         },
                         ...customField
                     }

package/dist/utilities/updateFieldsConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/updateFieldsConfig.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig } from 'payload'\n\ninterface UpdateFieldsConfig {\n  schemaPathMap: Record<string, string>\n  updatedCollectionConfig: CollectionConfig | GlobalConfig\n}\n\nexport const updateFieldsConfig = (collectionConfig: CollectionConfig | GlobalConfig): UpdateFieldsConfig => {\n  let schemaPathMap = {}\n\n  function updateField(field: any, parentPath = ''): any {\n    const currentPath = parentPath ? `${parentPath}.${field.name}` : field.name\n    const currentSchemaPath = `${collectionConfig.slug}.${currentPath}`\n\n    // Disabled fields/ field types\n    if (\n      field.admin?.disabled ||\n      field.admin?.readOnly ||\n      field.admin?.hidden ||\n      field.type === 'row'\n    ) {\n      return field\n    }\n\n    // Map field path for global fieldInstructionsMap to load related instructions\n    // This is done due to save extra API call to get instructions when Field components are loaded in admin\n    // Doing is will only call instructions data when user clicks on settings\n    if (['richText', 'text', 'textarea', 'upload'].includes(field.type)) {\n      schemaPathMap = {\n        ...schemaPathMap,\n        [currentSchemaPath]: {\n          type: field.type,\n          label: field.label || field.name,\n          relationTo: field.relationTo,\n        },\n      }\n    }\n\n    // Inject AI actions, richText is not included here as it has to be explicitly defined by user\n    if (['text', 'textarea', 'upload'].includes(field.type)) {\n      let customField = {}\n\n      // Custom fields don't fully adhere to the Payload schema, making it difficult to\n      // determine which components support injecting ComposeField as a Description.\n      if (field.admin?.components?.Field || field.admin?.components?.Description) {\n        // TODO: If a field already provides its own Description, we still inject our ComposeField\n        // by overriding Description. If you need both, consider composing your own wrapper.\n        customField = {}\n      }\n\n      return {\n        ...field,\n        admin: {\n          ...field.admin,\n          components: {\n            ...(field.admin?.components || {}),\n            Description: {\n              clientProps: {\n                schemaPath: currentSchemaPath,\n              },\n              path: '@ai-stack/payloadcms/fields#ComposeField',\n            },\n            ...customField,\n          },\n        },\n      }\n    }\n\n    if (field.fields) {\n      return {\n        ...field,\n        fields: field.fields.map((subField: any) => updateField(subField, currentPath)),\n      }\n    }\n\n    if (field.tabs) {\n      return {\n        ...field,\n        tabs: field.tabs.map((tab: any) => {\n          return {\n            ...tab,\n            // Tabs are a UI construct and should not add to the schema path\n            fields: (tab.fields || []).map((subField: any) => updateField(subField, parentPath)),\n          }\n        }),\n      }\n    }\n\n    if (field.blocks) {\n      return {\n        ...field,\n        blocks: field.blocks.map((block: any) => ({\n          ...block,\n          fields: block.fields.map((subField: any) =>\n            updateField(subField, `${currentPath}.${block.slug}`),\n          ),\n        })),\n      }\n    }\n\n    return field\n  }\n\n  const updatedCollectionConfig = {\n    ...collectionConfig,\n    fields: collectionConfig.fields.map((field) => updateField(field)),\n  }\n\n  return {\n    schemaPathMap,\n    updatedCollectionConfig,\n  }\n}\n"],"names":["updateFieldsConfig","collectionConfig","schemaPathMap","updateField","field","parentPath","currentPath","name","currentSchemaPath","slug","admin","disabled","readOnly","hidden","type","includes","label","relationTo","customField","components","Field","Description","clientProps","schemaPath","path","fields","map","subField","tabs","tab","blocks","block","updatedCollectionConfig"],"mappings":"AAOA,OAAO,MAAMA,qBAAqB,CAACC;IACjC,IAAIC,gBAAgB,CAAC;IAErB,SAASC,YAAYC,KAAU,EAAEC,aAAa,EAAE;QAC9C,MAAMC,cAAcD,aAAa,CAAC,EAAEA,WAAW,CAAC,EAAED,MAAMG,IAAI,CAAC,CAAC,GAAGH,MAAMG,IAAI;QAC3E,MAAMC,oBAAoB,CAAC,EAAEP,iBAAiBQ,IAAI,CAAC,CAAC,EAAEH,YAAY,CAAC;QAEnE,+BAA+B;QAC/B,IACEF,MAAMM,KAAK,EAAEC,YACbP,MAAMM,KAAK,EAAEE,YACbR,MAAMM,KAAK,EAAEG,UACbT,MAAMU,IAAI,KAAK,OACf;YACA,OAAOV;QACT;QAEA,8EAA8E;QAC9E,wGAAwG;QACxG,yEAAyE;QACzE,IAAI;YAAC;YAAY;YAAQ;YAAY;SAAS,CAACW,QAAQ,CAACX,MAAMU,IAAI,GAAG;YACnEZ,gBAAgB;gBACd,GAAGA,aAAa;gBAChB,CAACM,kBAAkB,EAAE;oBACnBM,MAAMV,MAAMU,IAAI;oBAChBE,OAAOZ,MAAMY,KAAK,IAAIZ,MAAMG,IAAI;oBAChCU,YAAYb,MAAMa,UAAU;gBAC9B;YACF;QACF;QAEA,8FAA8F;QAC9F,IAAI;YAAC;YAAQ;YAAY;SAAS,CAACF,QAAQ,CAACX,MAAMU,IAAI,GAAG;YACvD,IAAII,cAAc,CAAC;YAEnB,iFAAiF;YACjF,8EAA8E;YAC9E,IAAId,MAAMM,KAAK,EAAES,YAAYC,SAAShB,MAAMM,KAAK,EAAES,YAAYE,aAAa;gBAC1E,0FAA0F;gBAC1F,oFAAoF;gBACpFH,cAAc,CAAC;YACjB;YAEA,OAAO;gBACL,GAAGd,KAAK;gBACRM,OAAO;oBACL,GAAGN,MAAMM,KAAK;oBACdS,YAAY;wBACV,GAAIf,MAAMM,KAAK,EAAES,cAAc,CAAC,CAAC;wBACjCE,aAAa;4BACXC,aAAa;gCACXC,YAAYf;4BACd;4BACAgB,MAAM;wBACR;wBACA,GAAGN,WAAW;oBAChB;gBACF;YACF;QACF;QAEA,IAAId,MAAMqB,MAAM,EAAE;YAChB,OAAO;gBACL,GAAGrB,KAAK;gBACRqB,QAAQrB,MAAMqB,MAAM,CAACC,GAAG,CAAC,CAACC,WAAkBxB,YAAYwB,UAAUrB;YACpE;QACF;QAEA,IAAIF,MAAMwB,IAAI,EAAE;YACd,OAAO;gBACL,GAAGxB,KAAK;gBACRwB,MAAMxB,MAAMwB,IAAI,CAACF,GAAG,CAAC,CAACG;oBACpB,OAAO;wBACL,GAAGA,GAAG;wBACN,gEAAgE;wBAChEJ,QAAQ,AAACI,CAAAA,IAAIJ,MAAM,IAAI,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,WAAkBxB,YAAYwB,UAAUtB;oBAC1E;gBACF;YACF;QACF;QAEA,IAAID,MAAM0B,MAAM,EAAE;YAChB,OAAO;gBACL,GAAG1B,KAAK;gBACR0B,QAAQ1B,MAAM0B,MAAM,CAACJ,GAAG,CAAC,CAACK,QAAgB,CAAA;wBACxC,GAAGA,KAAK;wBACRN,QAAQM,MAAMN,MAAM,CAACC,GAAG,CAAC,CAACC,WACxBxB,YAAYwB,UAAU,CAAC,EAAErB,YAAY,CAAC,EAAEyB,MAAMtB,IAAI,CAAC,CAAC;oBAExD,CAAA;YACF;QACF;QAEA,OAAOL;IACT;IAEA,MAAM4B,0BAA0B;QAC9B,GAAG/B,gBAAgB;QACnBwB,QAAQxB,iBAAiBwB,MAAM,CAACC,GAAG,CAAC,CAACtB,QAAUD,YAAYC;IAC7D;IAEA,OAAO;QACLF;QACA8B;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../src/utilities/updateFieldsConfig.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig } from 'payload'\n\ninterface UpdateFieldsConfig {\n  schemaPathMap: Record<string, string>\n  updatedCollectionConfig: CollectionConfig | GlobalConfig\n}\n\nexport const updateFieldsConfig = (collectionConfig: CollectionConfig | GlobalConfig): UpdateFieldsConfig => {\n  let schemaPathMap = {}\n\n  function updateField(field: any, parentPath = ''): any {\n    const currentPath = parentPath ? `${parentPath}.${field.name}` : field.name\n    const currentSchemaPath = `${collectionConfig.slug}.${currentPath}`\n\n    // Disabled fields/ field types\n    if (\n      field.admin?.disabled ||\n      field.admin?.readOnly ||\n      field.admin?.hidden ||\n      field.type === 'row'\n    ) {\n      return field\n    }\n\n    // Map field path for global fieldInstructionsMap to load related instructions\n    // This is done due to save extra API call to get instructions when Field components are loaded in admin\n    // Doing is will only call instructions data when user clicks on settings\n    if (['array', 'richText', 'text', 'textarea', 'upload'].includes(field.type)) {\n      schemaPathMap = {\n        ...schemaPathMap,\n        [currentSchemaPath]: {\n          type: field.type,\n          label: field.label || field.name,\n          relationTo: field.relationTo,\n        },\n      }\n    }\n\n    // Inject AI actions, richText is not included here as it has to be explicitly defined by user\n    // Array fields also get AI injection for bulk generation\n    if (['array', 'text', 'textarea', 'upload'].includes(field.type)) {\n      let customField = {}\n\n      // Custom fields don't fully adhere to the Payload schema, making it difficult to\n      // determine which components support injecting ComposeField as a Description.\n      if (field.admin?.components?.Field || field.admin?.components?.Description) {\n        // TODO: If a field already provides its own Description, we still inject our ComposeField\n        // by overriding Description. If you need both, consider composing your own wrapper.\n        customField = {}\n      }\n\n      // Array fields use ArrayComposeField (always visible) since they don't have focus events\n      // Other fields use ComposeField with focus-dependent visibility\n      const componentPath = field.type === 'array'\n        ? '@ai-stack/payloadcms/fields#ArrayComposeField'\n        : '@ai-stack/payloadcms/fields#ComposeField'\n\n      return {\n        ...field,\n        admin: {\n          ...field.admin,\n          components: {\n            ...(field.admin?.components || {}),\n            Description: {\n              clientProps: {\n                schemaPath: currentSchemaPath,\n              },\n              path: componentPath,\n            },\n            ...customField,\n          },\n        },\n      }\n    }\n\n    if (field.fields) {\n      return {\n        ...field,\n        fields: field.fields.map((subField: any) => updateField(subField, currentPath)),\n      }\n    }\n\n    if (field.tabs) {\n      return {\n        ...field,\n        tabs: field.tabs.map((tab: any) => {\n          return {\n            ...tab,\n            // Tabs are a UI construct and should not add to the schema path\n            fields: (tab.fields || []).map((subField: any) => updateField(subField, parentPath)),\n          }\n        }),\n      }\n    }\n\n    if (field.blocks) {\n      return {\n        ...field,\n        blocks: field.blocks.map((block: any) => ({\n          ...block,\n          fields: block.fields.map((subField: any) =>\n            updateField(subField, `${currentPath}.${block.slug}`),\n          ),\n        })),\n      }\n    }\n\n    return field\n  }\n\n  const updatedCollectionConfig = {\n    ...collectionConfig,\n    fields: collectionConfig.fields.map((field) => updateField(field)),\n  }\n\n  return {\n    schemaPathMap,\n    updatedCollectionConfig,\n  }\n}\n"],"names":["updateFieldsConfig","collectionConfig","schemaPathMap","updateField","field","parentPath","currentPath","name","currentSchemaPath","slug","admin","disabled","readOnly","hidden","type","includes","label","relationTo","customField","components","Field","Description","componentPath","clientProps","schemaPath","path","fields","map","subField","tabs","tab","blocks","block","updatedCollectionConfig"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-stack/payloadcms",
-  "version": "3.68.0-beta.1",
+  "version": "3.68.0-beta.2",
   "private": false,
   "bugs": "https://github.com/ashbuilds/payload-ai/issues",
   "repository": "https://github.com/ashbuilds/payload-ai",
@@ -70,10 +70,10 @@
   "scripts": {
     "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
     "build:dev": "pnpm build --watch",
-    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths --ignore '**/*.d.ts'",
     "build:types": "tsc --outDir dist --rootDir ./src",
     "clean": "rimraf {dist,*.tsbuildinfo}",
-    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json,d.ts}\" dist/",
     "dev": "next dev dev --turbo",
     "dev:generate-importmap": "pnpm dev:payload generate:importmap",
     "dev:generate-types": "pnpm dev:payload generate:types",

package/dist/endpoints/chat.d.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=chat.d.js.map

package/dist/endpoints/chat.d.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/endpoints/chat.d.ts"],"sourcesContent":["import type { Endpoint } from 'payload';\n\nimport type { PluginConfig } from '../types.js';\nexport declare const Chat: (pluginConfig: PluginConfig) => Endpoint;\n"],"names":[],"mappings":"AAGA,WAAoE"}

package/dist/payload-ai.d.js

@@ -1,3 +0,0 @@
-export { };
-
-//# sourceMappingURL=payload-ai.d.js.map

package/dist/payload-ai.d.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/payload-ai.d.ts"],"sourcesContent":["import type { GenerateObjectResult } from 'ai'\n// Type definitions for payload.ai API\nimport type { Payload } from 'payload'\n\nimport type {\n  MediaResult,\n  PayloadGenerateMediaArgs,\n  PayloadGenerateObjectArgs,\n  PayloadGenerateTextArgs,\n} from './ai/core/types.js'\n\ndeclare module 'payload' {\n  interface BasePayload {\n    ai: {\n      /**\n       * @deprecated Use generateObject or generateText instead\n       * Legacy generate method for backward compatibility\n       */\n      generate: (args: unknown) => Promise<unknown>\n\n      /**\n       * Generate media (images or videos)\n       * @param args - Generation arguments including provider, model, prompt, and media options\n       * @returns Promise resolving to either a file or async job info\n       */\n      generateMedia: (args: Omit<PayloadGenerateMediaArgs, 'payload'>) => Promise<MediaResult>\n\n      /**\n       * Generate structured output with schema validation\n       * @param args - Generation arguments including provider, model, prompt, and schema\n       * @returns Promise resolving to the generated object\n       */\n      generateObject: <T = unknown>(args: Omit<PayloadGenerateObjectArgs, 'payload'>) => Promise<GenerateObjectResult<T>>\n\n      /**\n       * Generate simple text output\n       * @param args - Generation arguments including provider, model, and prompt\n       * @returns Promise resolving to the generated text\n       */\n      generateText: (args: Omit<PayloadGenerateTextArgs, 'payload'>) => Promise<string>\n\n      /**\n       * Get a specific model instance\n       * @param provider - Provider name (e.g., 'openai', 'anthropic')\n       * @param modelId - Model ID (e.g., 'gpt-4', 'claude-3')\n       * @param type - Model type ('text', 'image', or 'tts')\n       * @returns Promise resolving to the model instance\n       */\n      getModel: (provider: string, modelId: string, type?: 'image' | 'text' | 'tts') => Promise<unknown>\n\n      /**\n       * Get the provider registry\n       * @returns Promise resolving to the provider registry\n       */\n      getRegistry: () => Promise<Record<string, unknown>>\n\n      /**\n       * Stream structured output with schema validation\n       * @param args - Generation arguments including provider, model, prompt, and schema\n       * @returns Response stream\n       */\n      streamObject: <T = unknown>(\n        args: Omit<PayloadGenerateObjectArgs, 'payload'>,\n      ) => Promise<Response>\n\n      /**\n       * Stream text output\n       * @param args - Generation arguments including provider, model, and prompt\n       * @returns Response stream\n       */\n      streamText: (args: Omit<PayloadGenerateTextArgs, 'payload'>) => Promise<Response>\n    }\n  }\n}"],"names":[],"mappings":"AAIA,WAK2B"}

package/dist/styles.d.js

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=styles.d.js.map

package/dist/styles.d.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/styles.d.ts"],"names":[],"mappings":""}

package/dist/types/handlebars-async-helpers.d.js

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=handlebars-async-helpers.d.js.map

package/dist/types/handlebars-async-helpers.d.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/handlebars-async-helpers.d.ts"],"names":[],"mappings":""}