@delmaredigital/payload-puck 0.6.12 → 0.6.14

package/dist/ai/presets/instructions/typography.d.ts

@@ -13,4 +13,3 @@ export declare const typographyInstructions: ComponentAiOverrides;
  * Typography component names for reference
  */
 export declare const typographyComponents: readonly ["Heading", "Text", "RichText"];
-//# sourceMappingURL=typography.d.ts.map

package/dist/ai/presets/instructions/typography.js

@@ -7,8 +7,7 @@ import { colorSchema, alignmentSchema } from './schemas.js';
  * - Correct field names and values
  * - When to use each component
  * - How to compose them with other components
- */
-export const typographyInstructions = {
+ */ export const typographyInstructions = {
     Heading: {
         ai: {
             instructions: `Heading component for titles and section headings.
@@ -33,34 +32,34 @@ COMMON PATTERNS:
 COMPOSITION:
 - Place inside Section > Container for centered section headings
 - Place inside Flex (column) for grouped text content
-- Pair with Text component for headline + description combos`,
+- Pair with Text component for headline + description combos`
         },
         fields: {
             text: {
                 ai: {
                     required: true,
-                    instructions: 'The heading text content. Keep headlines concise and impactful - typically 3-8 words for h1/h2, can be longer for h3+.',
-                },
+                    instructions: 'The heading text content. Keep headlines concise and impactful - typically 3-8 words for h1/h2, can be longer for h3+.'
+                }
             },
             level: {
                 ai: {
-                    instructions: 'Heading level (h1-h6). Follow hierarchy: h1 once for page title, h2 for sections, h3 for subsections. Default: h2.',
-                },
+                    instructions: 'Heading level (h1-h6). Follow hierarchy: h1 once for page title, h2 for sections, h3 for subsections. Default: h2.'
+                }
             },
             textColor: {
                 ai: {
                     instructions: `Optional text color. Use for emphasis or brand colors.
 Example: { hex: '#3b82f6', opacity: 100 }`,
-                    schema: colorSchema,
-                },
+                    schema: colorSchema
+                }
             },
             alignment: {
                 ai: {
                     instructions: "Text alignment: 'left', 'center', or 'right'. Use 'center' for hero/section headings, 'left' for content areas.",
-                    schema: alignmentSchema,
-                },
-            },
-        },
+                    schema: alignmentSchema
+                }
+            }
+        }
     },
     Text: {
         ai: {
@@ -85,34 +84,34 @@ COMMON PATTERNS:
 COMPOSITION:
 - Usually follows a Heading component
 - Place inside Flex (column) with Heading for text blocks
-- Place inside Card for card descriptions`,
+- Place inside Card for card descriptions`
         },
         fields: {
             content: {
                 ai: {
                     required: true,
-                    instructions: 'The text content. Write clear, concise copy. Use line breaks for multiple paragraphs if needed.',
-                },
+                    instructions: 'The text content. Write clear, concise copy. Use line breaks for multiple paragraphs if needed.'
+                }
             },
             size: {
                 ai: {
-                    instructions: "Text size: 'xs', 'sm', 'base' (default), 'lg', 'xl'. Use 'lg' or 'xl' for hero subtitles, 'sm' for secondary text.",
-                },
+                    instructions: "Text size: 'xs', 'sm', 'base' (default), 'lg', 'xl'. Use 'lg' or 'xl' for hero subtitles, 'sm' for secondary text."
+                }
             },
             textColor: {
                 ai: {
                     instructions: `Optional text color. Use for emphasis or brand colors.
 Example: { hex: '#64748b', opacity: 100 }`,
-                    schema: colorSchema,
-                },
+                    schema: colorSchema
+                }
             },
             alignment: {
                 ai: {
                     instructions: "Text alignment: 'left', 'center', or 'right'. Match the alignment of the heading above it.",
-                    schema: alignmentSchema,
-                },
-            },
-        },
+                    schema: alignmentSchema
+                }
+            }
+        }
     },
     RichText: {
         ai: {
@@ -164,13 +163,15 @@ HTML STRUCTURE:
 COMPOSITION:
 - Place inside Container for constrained width
 - Use in Accordion items for formatted FAQ answers
-- Combine with Section backgrounds for contrast`,
+- Combine with Section backgrounds for contrast`
         },
         fields: {
             content: {
                 ai: {
                     required: true,
-                    schema: { type: 'string' },
+                    schema: {
+                        type: 'string'
+                    },
                     instructions: `HTML content for the TipTap rich text editor. Structure with proper HTML tags:
 - <p>Paragraph text</p>
 - <p><span style="font-size: 1.5rem">Large text</span></p>
@@ -179,14 +180,16 @@ COMPOSITION:
 - <ol><li>Numbered item</li></ol>
 - <blockquote>Quote</blockquote>
 - <a href="url">Link text</a>
-- <strong>Bold</strong>, <em>Italic</em>`,
-                },
-            },
-        },
-    },
+- <strong>Bold</strong>, <em>Italic</em>`
+                }
+            }
+        }
+    }
 };
 /**
  * Typography component names for reference
- */
-export const typographyComponents = ['Heading', 'Text', 'RichText'];
-//# sourceMappingURL=typography.js.map
+ */ export const typographyComponents = [
+    'Heading',
+    'Text',
+    'RichText'
+];

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

@@ -113,4 +113,3 @@ export declare function createPayloadTools(config: PayloadToolsConfig): Record<s
  * ```
  */
 export declare function createTool<TInput, TOutput>(tool: AiTool<TInput, TOutput>): AiTool<TInput, TOutput>;
-//# sourceMappingURL=index.d.ts.map

package/dist/ai/tools/index.js

@@ -19,8 +19,7 @@
  *   },
  * })
  * ```
- */
-import { z } from 'zod';
+ */ import { z } from 'zod';
 /**
  * Creates a set of AI tools for querying Payload CMS
  *
@@ -47,34 +46,31 @@ import { z } from 'zod';
  *   },
  * })
  * ```
- */
-export function createPayloadTools(config) {
+ */ export function createPayloadTools(config) {
     const tools = {};
     // Collection query tools
     if (config.collections) {
-        const collections = Array.isArray(config.collections)
-            ? Object.fromEntries(config.collections.map((c) => [c, `Items from the ${c} collection`]))
-            : config.collections;
-        for (const [slug, description] of Object.entries(collections)) {
-            const toolName = `get${slug.charAt(0).toUpperCase()}${slug.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase())}`;
+        const collections = Array.isArray(config.collections) ? Object.fromEntries(config.collections.map((c)=>[
+                c,
+                `Items from the ${c} collection`
+            ])) : config.collections;
+        for (const [slug, description] of Object.entries(collections)){
+            const toolName = `get${slug.charAt(0).toUpperCase()}${slug.slice(1).replace(/-([a-z])/g, (_, c)=>c.toUpperCase())}`;
             tools[toolName] = {
                 description: `Query ${slug} collection. ${description}`,
                 inputSchema: z.object({
                     limit: z.number().optional().describe('Maximum number of items to return (default: 10)'),
-                    where: z
-                        .record(z.string(), z.unknown())
-                        .optional()
-                        .describe('Payload where query for filtering results'),
-                    search: z.string().optional().describe('Search term to filter by title/name fields'),
+                    where: z.record(z.string(), z.unknown()).optional().describe('Payload where query for filtering results'),
+                    search: z.string().optional().describe('Search term to filter by title/name fields')
                 }),
-                execute: async (input, context) => {
+                execute: async (input, context)=>{
                     if (!context?.payload) {
                         throw new Error('Payload instance not available in tool context');
                     }
                     const { payload } = context;
                     const query = {
                         collection: slug,
-                        limit: input.limit || 10,
+                        limit: input.limit || 10
                     };
                     if (input.where) {
                         query.where = input.where;
@@ -83,15 +79,27 @@ export function createPayloadTools(config) {
                     if (input.search) {
                         query.where = {
                             or: [
-                                { title: { contains: input.search } },
-                                { name: { contains: input.search } },
-                                { label: { contains: input.search } },
-                            ],
+                                {
+                                    title: {
+                                        contains: input.search
+                                    }
+                                },
+                                {
+                                    name: {
+                                        contains: input.search
+                                    }
+                                },
+                                {
+                                    label: {
+                                        contains: input.search
+                                    }
+                                }
+                            ]
                         };
                     }
                     const result = await payload.find(query);
                     return result.docs;
-                },
+                }
             };
         }
     }
@@ -103,38 +111,54 @@ export function createPayloadTools(config) {
             inputSchema: z.object({
                 search: z.string().optional().describe('Search by filename or alt text'),
                 mimeType: z.string().optional().describe('Filter by MIME type (e.g., "image/jpeg")'),
-                limit: z.number().optional().describe('Maximum number of results (default: 10)'),
+                limit: z.number().optional().describe('Maximum number of results (default: 10)')
             }),
-            execute: async (input, context) => {
+            execute: async (input, context)=>{
                 if (!context?.payload) {
                     throw new Error('Payload instance not available in tool context');
                 }
                 const { payload } = context;
                 const query = {
                     collection: mediaCollection,
-                    limit: input.limit || 10,
+                    limit: input.limit || 10
                 };
                 const conditions = [];
                 if (input.search) {
-                    conditions.push({ filename: { contains: input.search } }, { alt: { contains: input.search } });
+                    conditions.push({
+                        filename: {
+                            contains: input.search
+                        }
+                    }, {
+                        alt: {
+                            contains: input.search
+                        }
+                    });
                 }
                 if (input.mimeType) {
-                    conditions.push({ mimeType: { equals: input.mimeType } });
+                    conditions.push({
+                        mimeType: {
+                            equals: input.mimeType
+                        }
+                    });
                 }
                 if (conditions.length > 0) {
-                    query.where = input.search ? { or: conditions } : { and: conditions };
+                    query.where = input.search ? {
+                        or: conditions
+                    } : {
+                        and: conditions
+                    };
                 }
                 const result = await payload.find(query);
-                return result.docs.map((doc) => ({
-                    id: doc.id,
-                    url: doc.url,
-                    filename: doc.filename,
-                    alt: doc.alt,
-                    width: doc.width,
-                    height: doc.height,
-                    mimeType: doc.mimeType,
-                }));
-            },
+                return result.docs.map((doc)=>({
+                        id: doc.id,
+                        url: doc.url,
+                        filename: doc.filename,
+                        alt: doc.alt,
+                        width: doc.width,
+                        height: doc.height,
+                        mimeType: doc.mimeType
+                    }));
+            }
         };
     }
     // Pages tool for internal linking
@@ -143,46 +167,59 @@ export function createPayloadTools(config) {
             description: 'Look up existing pages for internal linking. Returns page titles, slugs, and URLs.',
             inputSchema: z.object({
                 search: z.string().optional().describe('Search by page title'),
-                limit: z.number().optional().describe('Maximum number of results (default: 10)'),
+                limit: z.number().optional().describe('Maximum number of results (default: 10)')
             }),
-            execute: async (input, context) => {
+            execute: async (input, context)=>{
                 if (!context?.payload) {
                     throw new Error('Payload instance not available in tool context');
                 }
                 const { payload } = context;
                 const query = {
                     collection: config.pages,
-                    limit: input.limit || 10,
+                    limit: input.limit || 10
                 };
                 if (input.search) {
                     query.where = {
-                        or: [{ title: { contains: input.search } }, { slug: { contains: input.search } }],
+                        or: [
+                            {
+                                title: {
+                                    contains: input.search
+                                }
+                            },
+                            {
+                                slug: {
+                                    contains: input.search
+                                }
+                            }
+                        ]
                     };
                 }
                 const result = await payload.find(query);
-                return result.docs.map((doc) => ({
-                    id: doc.id,
-                    title: doc.title,
-                    slug: doc.slug,
-                    url: `/${doc.slug}`,
-                }));
-            },
+                return result.docs.map((doc)=>({
+                        id: doc.id,
+                        title: doc.title,
+                        slug: doc.slug,
+                        url: `/${doc.slug}`
+                    }));
+            }
         };
     }
     // Globals tools
     if (config.globals && config.globals.length > 0) {
-        for (const globalSlug of config.globals) {
-            const toolName = `get${globalSlug.charAt(0).toUpperCase()}${globalSlug.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase())}`;
+        for (const globalSlug of config.globals){
+            const toolName = `get${globalSlug.charAt(0).toUpperCase()}${globalSlug.slice(1).replace(/-([a-z])/g, (_, c)=>c.toUpperCase())}`;
             tools[toolName] = {
                 description: `Get ${globalSlug} global data (site-wide settings/configuration)`,
                 inputSchema: z.object({}),
-                execute: async (_input, context) => {
+                execute: async (_input, context)=>{
                     if (!context?.payload) {
                         throw new Error('Payload instance not available in tool context');
                     }
                     const { payload } = context;
-                    return await payload.findGlobal({ slug: globalSlug });
-                },
+                    return await payload.findGlobal({
+                        slug: globalSlug
+                    });
+                }
             };
         }
     }
@@ -207,8 +244,6 @@ export function createPayloadTools(config) {
  *   },
  * })
  * ```
- */
-export function createTool(tool) {
+ */ export function createTool(tool) {
     return tool;
 }
-//# sourceMappingURL=index.js.map

package/dist/ai/types.d.ts

@@ -504,4 +504,3 @@ export interface PuckPluginAiConfig {
      */
     componentInstructions?: ComponentAiOverrides;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.js

@@ -1,2 +1,6 @@
-export {};
-//# sourceMappingURL=types.js.map
+// =============================================================================
+// Plugin System Integration Types
+// =============================================================================
+/**
+ * AI configuration for createPuckPlugin
+ */ export { };

package/dist/ai/utils/injectAiConfig.d.ts

@@ -64,4 +64,3 @@ export declare function injectAiConfig(config: PuckConfig, overrides: ComponentA
  * @returns True if any component has AI configuration
  */
 export declare function hasAiConfig(config: PuckConfig): boolean;
-//# sourceMappingURL=injectAiConfig.d.ts.map

package/dist/ai/utils/injectAiConfig.js

@@ -53,16 +53,17 @@
  * @param config - The base Puck configuration to enhance
  * @param overrides - AI configuration overrides for each component
  * @returns A new Puck config with AI metadata injected
- */
-export function injectAiConfig(config, overrides) {
+ */ export function injectAiConfig(config, overrides) {
     // Deep clone the config to avoid mutating the original
     // Use type assertion to work with AI-extended types
     const newConfig = {
         ...config,
-        components: { ...config.components },
+        components: {
+            ...config.components
+        }
     };
     // First pass: Apply user-provided overrides
-    for (const [componentName, componentOverride] of Object.entries(overrides)) {
+    for (const [componentName, componentOverride] of Object.entries(overrides)){
         const existingComponent = newConfig.components[componentName];
         // Skip if component doesn't exist in config
         if (!existingComponent) {
@@ -70,19 +71,21 @@ export function injectAiConfig(config, overrides) {
         }
         // Create a new component config with AI metadata
         const newComponent = {
-            ...existingComponent,
+            ...existingComponent
         };
         // Add component-level AI config
         if (componentOverride.ai) {
             newComponent.ai = {
                 ...existingComponent.ai,
-                ...componentOverride.ai,
+                ...componentOverride.ai
             };
         }
         // Process field-level AI configs from overrides
         if (componentOverride.fields && existingComponent.fields) {
-            const newFields = { ...existingComponent.fields };
-            for (const [fieldName, fieldOverride] of Object.entries(componentOverride.fields)) {
+            const newFields = {
+                ...existingComponent.fields
+            };
+            for (const [fieldName, fieldOverride] of Object.entries(componentOverride.fields)){
                 const existingField = existingComponent.fields[fieldName];
                 // Skip if field doesn't exist
                 if (!existingField) {
@@ -93,8 +96,8 @@ export function injectAiConfig(config, overrides) {
                     ...existingField,
                     ai: {
                         ...existingField.ai,
-                        ...fieldOverride.ai,
-                    },
+                        ...fieldOverride.ai
+                    }
                 };
             }
             newComponent.fields = newFields;
@@ -105,12 +108,11 @@ export function injectAiConfig(config, overrides) {
     // Custom fields (type: 'custom') are typically interactive UI elements,
     // BUT some styling fields (background, padding, etc.) ARE custom fields
     // that we want AI to use. Only auto-exclude if NO AI instructions provided.
-    for (const [componentName, component] of Object.entries(newConfig.components)) {
-        if (!component.fields)
-            continue;
+    for (const [componentName, component] of Object.entries(newConfig.components)){
+        if (!component.fields) continue;
         const updatedFields = {};
         let hasChanges = false;
-        for (const [fieldName, field] of Object.entries(component.fields)) {
+        for (const [fieldName, field] of Object.entries(component.fields)){
             const existingAi = field.ai;
             // Check if this is a custom field type
             if (field.type === 'custom') {
@@ -118,24 +120,19 @@ export function injectAiConfig(config, overrides) {
                 // The presence of instructions indicates we want AI to use this field
                 if (existingAi?.instructions) {
                     updatedFields[fieldName] = field;
-                }
-                // Otherwise, auto-exclude custom fields from AI generation
-                // (unless already excluded)
-                else if (!existingAi?.exclude) {
+                } else if (!existingAi?.exclude) {
                     updatedFields[fieldName] = {
                         ...field,
                         ai: {
                             ...existingAi,
-                            exclude: true,
-                        },
+                            exclude: true
+                        }
                     };
                     hasChanges = true;
-                }
-                else {
+                } else {
                     updatedFields[fieldName] = field;
                 }
-            }
-            else {
+            } else {
                 updatedFields[fieldName] = field;
             }
         }
@@ -143,7 +140,7 @@ export function injectAiConfig(config, overrides) {
         if (hasChanges) {
             newConfig.components[componentName] = {
                 ...component,
-                fields: updatedFields,
+                fields: updatedFields
             };
         }
     }
@@ -153,30 +150,26 @@ export function injectAiConfig(config, overrides) {
         const rootFields = config.root.fields;
         const updatedRootFields = {};
         let hasRootChanges = false;
-        for (const [fieldName, field] of Object.entries(rootFields)) {
+        for (const [fieldName, field] of Object.entries(rootFields)){
             const existingAi = field.ai;
             // Check if this is a custom field type
             if (field.type === 'custom') {
                 // If the field has AI instructions, DON'T auto-exclude it
                 if (existingAi?.instructions) {
                     updatedRootFields[fieldName] = field;
-                }
-                // Otherwise, auto-exclude custom fields from AI generation
-                else if (!existingAi?.exclude) {
+                } else if (!existingAi?.exclude) {
                     updatedRootFields[fieldName] = {
                         ...field,
                         ai: {
                             ...existingAi,
-                            exclude: true,
-                        },
+                            exclude: true
+                        }
                     };
                     hasRootChanges = true;
-                }
-                else {
+                } else {
                     updatedRootFields[fieldName] = field;
                 }
-            }
-            else {
+            } else {
                 updatedRootFields[fieldName] = field;
             }
         }
@@ -185,7 +178,7 @@ export function injectAiConfig(config, overrides) {
             ;
             newConfig.root = {
                 ...newConfig.root,
-                fields: updatedRootFields,
+                fields: updatedRootFields
             };
         }
     }
@@ -197,14 +190,13 @@ export function injectAiConfig(config, overrides) {
  *
  * @param config - The Puck configuration to check
  * @returns True if any component has AI configuration
- */
-export function hasAiConfig(config) {
-    for (const component of Object.values(config.components)) {
+ */ export function hasAiConfig(config) {
+    for (const component of Object.values(config.components)){
         if (component.ai) {
             return true;
         }
         if (component.fields) {
-            for (const field of Object.values(component.fields)) {
+            for (const field of Object.values(component.fields)){
                 if (field.ai) {
                     return true;
                 }
@@ -213,4 +205,3 @@ export function hasAiConfig(config) {
     }
     return false;
 }
-//# sourceMappingURL=injectAiConfig.js.map

package/dist/api/createPuckApiRoutes.d.ts

@@ -1,4 +1,4 @@
-import type { PuckApiRoutesConfig, PuckApiRouteHandlers } from './types';
+import type { PuckApiRoutesConfig, PuckApiRouteHandlers } from './types.js';
 /**
  * Create API route handlers for /api/puck/pages
  *
@@ -28,4 +28,3 @@ import type { PuckApiRoutesConfig, PuckApiRouteHandlers } from './types';
  * ```
  */
 export declare function createPuckApiRoutes(routeConfig: PuckApiRoutesConfig): PuckApiRouteHandlers;
-//# sourceMappingURL=createPuckApiRoutes.d.ts.map