@delmaredigital/payload-puck 0.6.12 → 0.6.13

package/dist/ai/presets/instructions/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/ai/presets/instructions/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../src/ai/presets/instructions/schemas.ts"],"sourcesContent":["/**\n * Shared JSON Schemas for AI Field Generation\n *\n * Puck Cloud requires JSON schemas for custom fields to know what format to generate.\n * These schemas are used across all component instruction files.\n */\n\n// =============================================================================\n// Basic Types\n// =============================================================================\n\n/** JSON Schema for ColorValue */\nexport const colorSchema = {\n  type: 'object',\n  properties: {\n    hex: { type: 'string', description: 'Hex color code, e.g., \"#3b82f6\"' },\n    opacity: { type: 'number', minimum: 0, maximum: 100, description: 'Opacity 0-100, default 100' },\n  },\n  required: ['hex'],\n}\n\n/** JSON Schema for Alignment (text alignment) */\nexport const alignmentSchema = {\n  type: 'string',\n  enum: ['left', 'center', 'right'],\n  description: \"Text/content alignment: 'left', 'center', or 'right'\",\n}\n\n/** JSON Schema for JustifyContent (flex) */\nexport const justifyContentSchema = {\n  type: 'string',\n  enum: ['flex-start', 'center', 'flex-end', 'space-between', 'space-around'],\n  description: 'Main-axis distribution: flex-start (default), center, flex-end, space-between, space-around',\n}\n\n/** JSON Schema for AlignItems (flex) */\nexport const alignItemsSchema = {\n  type: 'string',\n  enum: ['flex-start', 'center', 'flex-end', 'stretch'],\n  description: 'Cross-axis alignment: flex-start, center, flex-end, stretch',\n}\n\n// =============================================================================\n// Padding/Margin Types\n// =============================================================================\n\n/** JSON Schema for PaddingValue (also used for margin) */\nexport const paddingSchema = {\n  type: 'object',\n  properties: {\n    top: { type: 'number', description: 'Top padding in units' },\n    right: { type: 'number', description: 'Right padding in units' },\n    bottom: { type: 'number', description: 'Bottom padding in units' },\n    left: { type: 'number', description: 'Left padding in units' },\n    unit: { type: 'string', enum: ['px', 'rem', 'em', '%'], description: 'Unit for all values' },\n    linked: { type: 'boolean', description: 'Whether all sides sync together' },\n  },\n  required: ['top', 'right', 'bottom', 'left', 'unit'],\n}\n\n/** JSON Schema for ResponsiveValue<PaddingValue> */\nexport const responsivePaddingSchema = {\n  type: 'object',\n  properties: {\n    xs: { ...paddingSchema, description: 'Base (mobile) value - required' },\n    sm: { ...paddingSchema, description: 'Small screens (640px+) - optional override' },\n    md: { ...paddingSchema, description: 'Medium screens (768px+) - optional override' },\n    lg: { ...paddingSchema, description: 'Large screens (1024px+) - optional override' },\n    xl: { ...paddingSchema, description: 'Extra large screens (1280px+) - optional override' },\n  },\n  required: ['xs'],\n}\n\n// =============================================================================\n// Dimensions Types\n// =============================================================================\n\n/** JSON Schema for DimensionConstraint */\nexport const dimensionConstraintSchema = {\n  type: 'object',\n  properties: {\n    value: { type: 'number', description: 'Numeric value' },\n    unit: { type: 'string', enum: ['px', 'rem', '%', 'vw', 'vh'], description: 'CSS unit' },\n    enabled: { type: 'boolean', description: 'Whether this constraint is active' },\n  },\n  required: ['value', 'unit', 'enabled'],\n}\n\n/** JSON Schema for DimensionsValue */\nexport const dimensionsSchema = {\n  type: 'object',\n  properties: {\n    mode: { type: 'string', enum: ['full', 'contained', 'custom'], description: 'Width mode' },\n    alignment: { type: 'string', enum: ['left', 'center', 'right'], description: 'Content alignment' },\n    maxWidth: { ...dimensionConstraintSchema, description: 'Maximum width constraint' },\n    minWidth: { ...dimensionConstraintSchema, description: 'Minimum width constraint (optional)' },\n    minHeight: { ...dimensionConstraintSchema, description: 'Minimum height constraint (optional)' },\n    maxHeight: { ...dimensionConstraintSchema, description: 'Maximum height constraint (optional)' },\n  },\n  required: ['mode', 'alignment', 'maxWidth'],\n}\n\n/** JSON Schema for ResponsiveValue<DimensionsValue> */\nexport const responsiveDimensionsSchema = {\n  type: 'object',\n  properties: {\n    xs: { ...dimensionsSchema, description: 'Base (mobile) value - required' },\n    sm: { ...dimensionsSchema, description: 'Small screens (640px+) - optional override' },\n    md: { ...dimensionsSchema, description: 'Medium screens (768px+) - optional override' },\n    lg: { ...dimensionsSchema, description: 'Large screens (1024px+) - optional override' },\n    xl: { ...dimensionsSchema, description: 'Extra large screens (1280px+) - optional override' },\n  },\n  required: ['xs'],\n}\n\n// =============================================================================\n// Background Types\n// =============================================================================\n\n/** JSON Schema for GradientStop */\nexport const gradientStopSchema = {\n  type: 'object',\n  properties: {\n    color: colorSchema,\n    position: { type: 'number', minimum: 0, maximum: 100, description: 'Position 0-100%' },\n  },\n  required: ['color', 'position'],\n}\n\n/** JSON Schema for GradientValue */\nexport const gradientSchema = {\n  type: 'object',\n  properties: {\n    type: { type: 'string', enum: ['linear', 'radial'], description: 'Gradient type' },\n    angle: { type: 'number', minimum: 0, maximum: 360, description: 'Angle in degrees (linear)' },\n    stops: { type: 'array', items: gradientStopSchema, description: 'Color stops' },\n    radialShape: { type: 'string', enum: ['circle', 'ellipse'], description: 'Radial shape' },\n    radialPosition: { type: 'string', enum: ['center', 'top', 'bottom', 'left', 'right'] },\n  },\n  required: ['type', 'stops'],\n}\n\n/** JSON Schema for BackgroundValue */\nexport const backgroundSchema = {\n  type: 'object',\n  properties: {\n    type: { type: 'string', enum: ['none', 'solid', 'gradient', 'image'], description: 'Background type' },\n    solid: { ...colorSchema, description: 'Solid color (when type=\"solid\")' },\n    gradient: { ...gradientSchema, description: 'Gradient (when type=\"gradient\")' },\n    // Note: image backgrounds require media selection, AI should use solid/gradient\n  },\n  required: ['type'],\n}\n\n// =============================================================================\n// Border Types\n// =============================================================================\n\n/** JSON Schema for BorderValue */\nexport const borderSchema = {\n  type: 'object',\n  properties: {\n    style: { type: 'string', enum: ['none', 'solid', 'dashed', 'dotted'], description: 'Border style' },\n    width: { type: 'number', description: 'Border width in pixels' },\n    color: { ...colorSchema, description: 'Border color' },\n    radius: { type: 'number', description: 'Border radius in pixels' },\n    sides: {\n      type: 'object',\n      properties: {\n        top: { type: 'boolean' },\n        right: { type: 'boolean' },\n        bottom: { type: 'boolean' },\n        left: { type: 'boolean' },\n      },\n      description: 'Which sides have borders',\n    },\n  },\n  required: ['style', 'width', 'radius', 'sides'],\n}\n\n// =============================================================================\n// Animation Types\n// =============================================================================\n\n/** JSON Schema for AnimationValue (simplified for AI) */\nexport const animationSchema = {\n  type: 'object',\n  properties: {\n    mode: { type: 'string', enum: ['preset', 'custom'], description: 'Animation mode' },\n    entrance: {\n      type: 'string',\n      enum: ['none', 'fade-in', 'fade-up', 'fade-down', 'fade-left', 'fade-right', 'fade-scale',\n             'scale-in', 'scale-up', 'scale-down', 'slide-up', 'slide-down', 'slide-left', 'slide-right'],\n      description: 'Entrance animation preset',\n    },\n    entranceDuration: { type: 'number', description: 'Duration in ms, default 500' },\n    entranceDelay: { type: 'number', description: 'Delay in ms, default 0' },\n    triggerOnScroll: { type: 'boolean', description: 'Trigger when scrolled into view' },\n    triggerOnce: { type: 'boolean', description: 'Only animate once' },\n  },\n}\n\n// =============================================================================\n// Visibility Types\n// =============================================================================\n\n/** JSON Schema for VisibilityValue */\nexport const visibilitySchema = {\n  type: 'object',\n  properties: {\n    xs: { type: 'boolean', description: 'Visible on mobile (default true)' },\n    sm: { type: 'boolean', description: 'Visible on small screens 640px+' },\n    md: { type: 'boolean', description: 'Visible on medium screens 768px+' },\n    lg: { type: 'boolean', description: 'Visible on large screens 1024px+' },\n    xl: { type: 'boolean', description: 'Visible on extra large screens 1280px+' },\n  },\n  required: ['xs'],\n}\n\n// =============================================================================\n// Size Types (for Button, etc.)\n// =============================================================================\n\n/** JSON Schema for SizeValue */\nexport const sizeSchema = {\n  type: 'object',\n  properties: {\n    mode: { type: 'string', enum: ['sm', 'default', 'lg', 'custom'], description: 'Size preset or custom' },\n    height: { type: 'number', description: 'Custom height in units (only when mode=\"custom\")' },\n    paddingX: { type: 'number', description: 'Custom horizontal padding (only when mode=\"custom\")' },\n    paddingY: { type: 'number', description: 'Custom vertical padding (only when mode=\"custom\")' },\n    fontSize: { type: 'number', description: 'Custom font size (only when mode=\"custom\")' },\n    unit: { type: 'string', enum: ['px', 'rem'], description: 'Unit for custom values' },\n  },\n  required: ['mode'],\n}\n\n// =============================================================================\n// Transform Types\n// =============================================================================\n\n/** JSON Schema for TransformValue */\nexport const transformSchema = {\n  type: 'object',\n  properties: {\n    rotate: { type: 'number', minimum: -360, maximum: 360, description: 'Rotation in degrees' },\n    scaleX: { type: 'number', minimum: 0.1, maximum: 3, description: 'Horizontal scale factor' },\n    scaleY: { type: 'number', minimum: 0.1, maximum: 3, description: 'Vertical scale factor' },\n    scaleLocked: { type: 'boolean', description: 'Lock X and Y scale together' },\n    skewX: { type: 'number', minimum: -45, maximum: 45, description: 'Horizontal skew in degrees' },\n    skewY: { type: 'number', minimum: -45, maximum: 45, description: 'Vertical skew in degrees' },\n    translateX: { type: 'number', description: 'Horizontal translation' },\n    translateY: { type: 'number', description: 'Vertical translation' },\n    translateUnit: { type: 'string', enum: ['px', 'rem', '%'], description: 'Unit for translation' },\n    origin: {\n      type: 'string',\n      enum: ['center', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right'],\n      description: 'Transform origin point',\n    },\n    enable3D: { type: 'boolean', description: 'Enable 3D transforms' },\n    perspective: { type: 'number', description: '3D perspective in pixels' },\n    rotateX: { type: 'number', description: '3D rotation around X axis' },\n    rotateY: { type: 'number', description: '3D rotation around Y axis' },\n  },\n}\n"],"names":["colorSchema","type","properties","hex","description","opacity","minimum","maximum","required","alignmentSchema","enum","justifyContentSchema","alignItemsSchema","paddingSchema","top","right","bottom","left","unit","linked","responsivePaddingSchema","xs","sm","md","lg","xl","dimensionConstraintSchema","value","enabled","dimensionsSchema","mode","alignment","maxWidth","minWidth","minHeight","maxHeight","responsiveDimensionsSchema","gradientStopSchema","color","position","gradientSchema","angle","stops","items","radialShape","radialPosition","backgroundSchema","solid","gradient","borderSchema","style","width","radius","sides","animationSchema","entrance","entranceDuration","entranceDelay","triggerOnScroll","triggerOnce","visibilitySchema","sizeSchema","height","paddingX","paddingY","fontSize","transformSchema","rotate","scaleX","scaleY","scaleLocked","skewX","skewY","translateX","translateY","translateUnit","origin","enable3D","perspective","rotateX","rotateY"],"mappings":"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"}

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,18 @@ 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'];
+ */ export const typographyComponents = [
+    'Heading',
+    'Text',
+    'RichText'
+];
+
 //# sourceMappingURL=typography.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"typography.js","sourceRoot":"","sources":["../../../../src/ai/presets/instructions/typography.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE3D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IAC1D,OAAO,EAAE;QACP,EAAE,EAAE;YACF,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;6DAsByC;SACxD;QACD,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,EAAE,EAAE;oBACF,QAAQ,EAAE,IAAI;oBACd,YAAY,EACV,wHAAwH;iBAC3H;aACF;YACD,KAAK,EAAE;gBACL,EAAE,EAAE;oBACF,YAAY,EACV,oHAAoH;iBACvH;aACF;YACD,SAAS,EAAE;gBACT,EAAE,EAAE;oBACF,YAAY,EAAE;0CACkB;oBAChC,MAAM,EAAE,WAAW;iBACpB;aACF;YACD,SAAS,EAAE;gBACT,EAAE,EAAE;oBACF,YAAY,EACV,iHAAiH;oBACnH,MAAM,EAAE,eAAe;iBACxB;aACF;SACF;KACF;IAED,IAAI,EAAE;QACJ,EAAE,EAAE;YACF,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;0CAqBsB;SACrC;QACD,MAAM,EAAE;YACN,OAAO,EAAE;gBACP,EAAE,EAAE;oBACF,QAAQ,EAAE,IAAI;oBACd,YAAY,EACV,iGAAiG;iBACpG;aACF;YACD,IAAI,EAAE;gBACJ,EAAE,EAAE;oBACF,YAAY,EACV,oHAAoH;iBACvH;aACF;YACD,SAAS,EAAE;gBACT,EAAE,EAAE;oBACF,YAAY,EAAE;0CACkB;oBAChC,MAAM,EAAE,WAAW;iBACpB;aACF;YACD,SAAS,EAAE;gBACT,EAAE,EAAE;oBACF,YAAY,EACV,4FAA4F;oBAC9F,MAAM,EAAE,eAAe;iBACxB;aACF;SACF;KACF;IAED,QAAQ,EAAE;QACR,EAAE,EAAE;YACF,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAgD4B;SAC3C;QACD,MAAM,EAAE;YACN,OAAO,EAAE;gBACP,EAAE,EAAE;oBACF,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,YAAY,EAAE;;;;;;;;yCAQiB;iBAChC;aACF;SACF;KACF;CACF,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAU,CAAA"}
+{"version":3,"sources":["../../../../src/ai/presets/instructions/typography.ts"],"sourcesContent":["import type { ComponentAiOverrides } from '../../types.js'\nimport { colorSchema, alignmentSchema } from './schemas.js'\n\n/**\n * Comprehensive AI instructions for typography components\n *\n * These instructions teach the AI:\n * - What each component is for\n * - Correct field names and values\n * - When to use each component\n * - How to compose them with other components\n */\nexport const typographyInstructions: ComponentAiOverrides = {\n  Heading: {\n    ai: {\n      instructions: `Heading component for titles and section headings.\n\nPURPOSE:\n- Page titles, section headings, and subsection titles\n- Establishes content hierarchy and structure\n- Improves accessibility and SEO\n\nUSAGE GUIDELINES:\n- Use h1 ONLY ONCE per page for the main page title (in the hero section)\n- Use h2 for major section headings (Features, Testimonials, FAQ, etc.)\n- Use h3 for subsection headings or card titles within sections\n- Use h4-h6 rarely, only for deeply nested content\n\nCOMMON PATTERNS:\n- Hero headline: h1 level, centered alignment\n- Section title: h2 level, often centered\n- Card/feature title: h3 level, left or center aligned\n- Sidebar heading: h4 level\n\nCOMPOSITION:\n- Place inside Section > Container for centered section headings\n- Place inside Flex (column) for grouped text content\n- Pair with Text component for headline + description combos`,\n    },\n    fields: {\n      text: {\n        ai: {\n          required: true,\n          instructions:\n            'The heading text content. Keep headlines concise and impactful - typically 3-8 words for h1/h2, can be longer for h3+.',\n        },\n      },\n      level: {\n        ai: {\n          instructions:\n            'Heading level (h1-h6). Follow hierarchy: h1 once for page title, h2 for sections, h3 for subsections. Default: h2.',\n        },\n      },\n      textColor: {\n        ai: {\n          instructions: `Optional text color. Use for emphasis or brand colors.\nExample: { hex: '#3b82f6', opacity: 100 }`,\n          schema: colorSchema,\n        },\n      },\n      alignment: {\n        ai: {\n          instructions:\n            \"Text alignment: 'left', 'center', or 'right'. Use 'center' for hero/section headings, 'left' for content areas.\",\n          schema: alignmentSchema,\n        },\n      },\n    },\n  },\n\n  Text: {\n    ai: {\n      instructions: `Text component for paragraphs and body content.\n\nPURPOSE:\n- Body text, descriptions, and supporting content\n- Single paragraphs or short text blocks\n- Subtitles and secondary text under headings\n\nUSAGE GUIDELINES:\n- Use for 1-3 paragraphs of plain text\n- For longer formatted content with lists/links, use RichText instead\n- Size options: xs, sm, base (default), lg, xl\n\nCOMMON PATTERNS:\n- Hero subtitle: lg or xl size, centered, below h1\n- Section description: base size, centered, below h2\n- Card description: sm or base size, left-aligned\n- Feature text: base size, often paired with heading\n\nCOMPOSITION:\n- Usually follows a Heading component\n- Place inside Flex (column) with Heading for text blocks\n- Place inside Card for card descriptions`,\n    },\n    fields: {\n      content: {\n        ai: {\n          required: true,\n          instructions:\n            'The text content. Write clear, concise copy. Use line breaks for multiple paragraphs if needed.',\n        },\n      },\n      size: {\n        ai: {\n          instructions:\n            \"Text size: 'xs', 'sm', 'base' (default), 'lg', 'xl'. Use 'lg' or 'xl' for hero subtitles, 'sm' for secondary text.\",\n        },\n      },\n      textColor: {\n        ai: {\n          instructions: `Optional text color. Use for emphasis or brand colors.\nExample: { hex: '#64748b', opacity: 100 }`,\n          schema: colorSchema,\n        },\n      },\n      alignment: {\n        ai: {\n          instructions:\n            \"Text alignment: 'left', 'center', or 'right'. Match the alignment of the heading above it.\",\n          schema: alignmentSchema,\n        },\n      },\n    },\n  },\n\n  RichText: {\n    ai: {\n      instructions: `RichText component - TipTap-powered rich text with advanced formatting.\n\nPURPOSE:\n- Long-form content with sophisticated formatting\n- Content needing font sizes, colors, highlights\n- Blog posts, about pages, formatted descriptions\n- Any content needing more than plain text\n\nUSAGE GUIDELINES:\n- Use RichText over Text when you need ANY formatting\n- Supports font sizes from xs to 5xl\n- Supports text colors with opacity\n- Supports highlights/background colors\n- Content is HTML with data attributes for styling\n\nTIPTAP FEATURES AVAILABLE:\n- Font sizes: text-xs, text-sm, text-base, text-lg, text-xl, text-2xl, text-3xl, text-4xl, text-5xl\n- Text colors: Any hex color with opacity (via data attributes)\n- Highlights: Background color highlights on text\n- Formatting: bold, italic, underline, strikethrough\n- Special: superscript, subscript\n- Blocks: blockquotes, code blocks\n- Lists: bullet lists, numbered lists\n- Links: clickable hyperlinks\n\nCOMMON PATTERNS:\n- Hero subtitle with large colorful text\n- Feature descriptions with highlights\n- Blog content with mixed formatting\n- FAQ answers with styled callouts\n- About page with branded text colors\n\nHTML STRUCTURE:\n- <p>Paragraph text</p>\n- <p><span style=\"font-size:...\">Sized text</span></p>\n- <p><span style=\"color:...\">Colored text</span></p>\n- <p><mark>Highlighted text</mark></p>\n- <ul><li>Bullet item</li></ul>\n- <ol><li>Numbered item</li></ol>\n- <blockquote>Quote text</blockquote>\n- <pre><code>Code block</code></pre>\n- <a href=\"url\">Link text</a>\n- <strong>Bold</strong>, <em>Italic</em>, <u>Underline</u>, <s>Strikethrough</s>\n- <sup>Superscript</sup>, <sub>Subscript</sub>\n\nCOMPOSITION:\n- Place inside Container for constrained width\n- Use in Accordion items for formatted FAQ answers\n- Combine with Section backgrounds for contrast`,\n    },\n    fields: {\n      content: {\n        ai: {\n          required: true,\n          schema: { type: 'string' },\n          instructions: `HTML content for the TipTap rich text editor. Structure with proper HTML tags:\n- <p>Paragraph text</p>\n- <p><span style=\"font-size: 1.5rem\">Large text</span></p>\n- <p><span style=\"color: #3b82f6\">Colored text</span></p>\n- <ul><li>Bullet item</li></ul>\n- <ol><li>Numbered item</li></ol>\n- <blockquote>Quote</blockquote>\n- <a href=\"url\">Link text</a>\n- <strong>Bold</strong>, <em>Italic</em>`,\n        },\n      },\n    },\n  },\n}\n\n/**\n * Typography component names for reference\n */\nexport const typographyComponents = ['Heading', 'Text', 'RichText'] as const\n"],"names":["colorSchema","alignmentSchema","typographyInstructions","Heading","ai","instructions","fields","text","required","level","textColor","schema","alignment","Text","content","size","RichText","type","typographyComponents"],"mappings":"AACA,SAASA,WAAW,EAAEC,eAAe,QAAQ,eAAc;AAE3D;;;;;;;;CAQC,GACD,OAAO,MAAMC,yBAA+C;IAC1DC,SAAS;QACPC,IAAI;YACFC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;4DAsBuC,CAAC;QACzD;QACAC,QAAQ;YACNC,MAAM;gBACJH,IAAI;oBACFI,UAAU;oBACVH,cACE;gBACJ;YACF;YACAI,OAAO;gBACLL,IAAI;oBACFC,cACE;gBACJ;YACF;YACAK,WAAW;gBACTN,IAAI;oBACFC,cAAc,CAAC;yCACgB,CAAC;oBAChCM,QAAQX;gBACV;YACF;YACAY,WAAW;gBACTR,IAAI;oBACFC,cACE;oBACFM,QAAQV;gBACV;YACF;QACF;IACF;IAEAY,MAAM;QACJT,IAAI;YACFC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;yCAqBoB,CAAC;QACtC;QACAC,QAAQ;YACNQ,SAAS;gBACPV,IAAI;oBACFI,UAAU;oBACVH,cACE;gBACJ;YACF;YACAU,MAAM;gBACJX,IAAI;oBACFC,cACE;gBACJ;YACF;YACAK,WAAW;gBACTN,IAAI;oBACFC,cAAc,CAAC;yCACgB,CAAC;oBAChCM,QAAQX;gBACV;YACF;YACAY,WAAW;gBACTR,IAAI;oBACFC,cACE;oBACFM,QAAQV;gBACV;YACF;QACF;IACF;IAEAe,UAAU;QACRZ,IAAI;YACFC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAgD0B,CAAC;QAC5C;QACAC,QAAQ;YACNQ,SAAS;gBACPV,IAAI;oBACFI,UAAU;oBACVG,QAAQ;wBAAEM,MAAM;oBAAS;oBACzBZ,cAAc,CAAC;;;;;;;;wCAQe,CAAC;gBACjC;YACF;QACF;IACF;AACF,EAAC;AAED;;CAEC,GACD,OAAO,MAAMa,uBAAuB;IAAC;IAAW;IAAQ;CAAW,CAAS"}

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,8 @@ export function createPayloadTools(config) {
  *   },
  * })
  * ```
- */
-export function createTool(tool) {
+ */ export function createTool(tool) {
     return tool;
 }
+
 //# sourceMappingURL=index.js.map

package/dist/ai/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../src/ai/tools/index.ts"],"sourcesContent":["/**\n * Pre-built AI tools for Payload CMS integration\n *\n * These tools allow the AI to query your Payload database during page generation,\n * enabling it to use real content instead of placeholder text.\n *\n * @example\n * ```typescript\n * import { createPayloadTools } from '@delmaredigital/payload-puck/ai'\n *\n * createPuckPlugin({\n *   ai: {\n *     enabled: true,\n *     tools: createPayloadTools({\n *       collections: ['products', 'team-members', 'testimonials'],\n *       media: true,\n *       pages: 'pages',\n *     }),\n *   },\n * })\n * ```\n */\n\nimport { z } from 'zod'\nimport type { AiTool, AiToolContext } from '../types.js'\n\n// Input types for the tools\ninterface CollectionQueryInput {\n  limit?: number\n  where?: Record<string, unknown>\n  search?: string\n}\n\ninterface MediaQueryInput {\n  search?: string\n  mimeType?: string\n  limit?: number\n}\n\ninterface PagesQueryInput {\n  search?: string\n  limit?: number\n}\n\n/**\n * Configuration for createPayloadTools\n */\nexport interface PayloadToolsConfig {\n  /**\n   * Collections the AI can query.\n   * Pass an array of collection slugs, or an object mapping slugs to descriptions.\n   *\n   * @example\n   * ```typescript\n   * // Simple - just collection names\n   * collections: ['products', 'team-members']\n   *\n   * // With descriptions - helps AI understand when to use each\n   * collections: {\n   *   products: 'Product catalog with name, price, description, and image',\n   *   'team-members': 'Staff profiles with name, role, bio, and headshot',\n   * }\n   * ```\n   */\n  collections?: string[] | Record<string, string>\n\n  /**\n   * Enable media library tool.\n   * When true, AI can search for images by filename or alt text.\n   * @default false\n   */\n  media?: boolean | string // true uses 'media', string specifies collection slug\n\n  /**\n   * Pages collection slug for internal linking.\n   * When set, AI can look up page URLs for navigation/links.\n   */\n  pages?: string\n\n  /**\n   * Globals the AI can read.\n   * Useful for site settings, contact info, etc.\n   *\n   * @example\n   * ```typescript\n   * globals: ['site-settings', 'contact-info']\n   * ```\n   */\n  globals?: string[]\n}\n\n/**\n * Creates a set of AI tools for querying Payload CMS\n *\n * IMPORTANT: These tools need the `payload` instance at runtime.\n * The plugin automatically injects `payload` into the tool execution context.\n *\n * @example\n * ```typescript\n * import { createPayloadTools } from '@delmaredigital/payload-puck/ai'\n *\n * createPuckPlugin({\n *   ai: {\n *     enabled: true,\n *     context: 'You are building pages for Acme Corp...',\n *     tools: createPayloadTools({\n *       collections: {\n *         products: 'Products with name, price, description, and image',\n *         testimonials: 'Customer testimonials with quote, author, and company',\n *       },\n *       media: true,\n *       pages: 'pages',\n *       globals: ['site-settings'],\n *     }),\n *   },\n * })\n * ```\n */\nexport function createPayloadTools(config: PayloadToolsConfig): Record<string, AiTool<any, any>> {\n  const tools: Record<string, AiTool<any, any>> = {}\n\n  // Collection query tools\n  if (config.collections) {\n    const collections = Array.isArray(config.collections)\n      ? Object.fromEntries(config.collections.map((c) => [c, `Items from the ${c} collection`]))\n      : config.collections\n\n    for (const [slug, description] of Object.entries(collections)) {\n      const toolName = `get${slug.charAt(0).toUpperCase()}${slug.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase())}`\n\n      tools[toolName] = {\n        description: `Query ${slug} collection. ${description}`,\n        inputSchema: z.object({\n          limit: z.number().optional().describe('Maximum number of items to return (default: 10)'),\n          where: z\n            .record(z.string(), z.unknown())\n            .optional()\n            .describe('Payload where query for filtering results'),\n          search: z.string().optional().describe('Search term to filter by title/name fields'),\n        }),\n        execute: async (input: CollectionQueryInput, context?: AiToolContext) => {\n          if (!context?.payload) {\n            throw new Error('Payload instance not available in tool context')\n          }\n          const { payload } = context\n\n          const query: {\n            collection: string\n            limit: number\n            where?: Record<string, unknown>\n          } = {\n            collection: slug,\n            limit: input.limit || 10,\n          }\n\n          if (input.where) {\n            query.where = input.where\n          }\n\n          // If search is provided, try common text fields\n          if (input.search) {\n            query.where = {\n              or: [\n                { title: { contains: input.search } },\n                { name: { contains: input.search } },\n                { label: { contains: input.search } },\n              ],\n            }\n          }\n\n          const result = await payload.find(query as any)\n          return result.docs\n        },\n      }\n    }\n  }\n\n  // Media library tool\n  if (config.media) {\n    const mediaCollection = typeof config.media === 'string' ? config.media : 'media'\n\n    tools.getMedia = {\n      description:\n        'Search the media library for images. Returns URLs and metadata for matching images.',\n      inputSchema: z.object({\n        search: z.string().optional().describe('Search by filename or alt text'),\n        mimeType: z.string().optional().describe('Filter by MIME type (e.g., \"image/jpeg\")'),\n        limit: z.number().optional().describe('Maximum number of results (default: 10)'),\n      }),\n      execute: async (input: MediaQueryInput, context?: AiToolContext) => {\n        if (!context?.payload) {\n          throw new Error('Payload instance not available in tool context')\n        }\n        const { payload } = context\n\n        const query: {\n          collection: string\n          limit: number\n          where?: Record<string, unknown>\n        } = {\n          collection: mediaCollection,\n          limit: input.limit || 10,\n        }\n\n        const conditions: Record<string, unknown>[] = []\n\n        if (input.search) {\n          conditions.push(\n            { filename: { contains: input.search } },\n            { alt: { contains: input.search } }\n          )\n        }\n\n        if (input.mimeType) {\n          conditions.push({ mimeType: { equals: input.mimeType } })\n        }\n\n        if (conditions.length > 0) {\n          query.where = input.search ? { or: conditions } : { and: conditions }\n        }\n\n        const result = await payload.find(query as any)\n        return result.docs.map((doc: any) => ({\n          id: doc.id,\n          url: doc.url,\n          filename: doc.filename,\n          alt: doc.alt,\n          width: doc.width,\n          height: doc.height,\n          mimeType: doc.mimeType,\n        }))\n      },\n    }\n  }\n\n  // Pages tool for internal linking\n  if (config.pages) {\n    tools.getPages = {\n      description:\n        'Look up existing pages for internal linking. Returns page titles, slugs, and URLs.',\n      inputSchema: z.object({\n        search: z.string().optional().describe('Search by page title'),\n        limit: z.number().optional().describe('Maximum number of results (default: 10)'),\n      }),\n      execute: async (input: PagesQueryInput, context?: AiToolContext) => {\n        if (!context?.payload) {\n          throw new Error('Payload instance not available in tool context')\n        }\n        const { payload } = context\n\n        const query: {\n          collection: string\n          limit: number\n          where?: Record<string, unknown>\n        } = {\n          collection: config.pages!,\n          limit: input.limit || 10,\n        }\n\n        if (input.search) {\n          query.where = {\n            or: [{ title: { contains: input.search } }, { slug: { contains: input.search } }],\n          }\n        }\n\n        const result = await payload.find(query as any)\n        return result.docs.map((doc: any) => ({\n          id: doc.id,\n          title: doc.title,\n          slug: doc.slug,\n          url: `/${doc.slug}`,\n        }))\n      },\n    }\n  }\n\n  // Globals tools\n  if (config.globals && config.globals.length > 0) {\n    for (const globalSlug of config.globals) {\n      const toolName = `get${globalSlug.charAt(0).toUpperCase()}${globalSlug.slice(1).replace(/-([a-z])/g, (_, c) => c.toUpperCase())}`\n\n      tools[toolName] = {\n        description: `Get ${globalSlug} global data (site-wide settings/configuration)`,\n        inputSchema: z.object({}),\n        execute: async (_input: Record<string, never>, context?: AiToolContext) => {\n          if (!context?.payload) {\n            throw new Error('Payload instance not available in tool context')\n          }\n          const { payload } = context\n\n          return await payload.findGlobal({ slug: globalSlug })\n        },\n      }\n    }\n  }\n\n  return tools\n}\n\n/**\n * Create a custom AI tool with proper typing\n *\n * @example\n * ```typescript\n * import { createTool } from '@delmaredigital/payload-puck/ai'\n * import { z } from 'zod'\n *\n * const getWeather = createTool({\n *   description: 'Get current weather for a location',\n *   inputSchema: z.object({\n *     city: z.string().describe('City name'),\n *   }),\n *   execute: async ({ city }, context) => {\n *     const response = await fetch(`https://api.weather.com/...`)\n *     return response.json()\n *   },\n * })\n * ```\n */\nexport function createTool<TInput, TOutput>(tool: AiTool<TInput, TOutput>): AiTool<TInput, TOutput> {\n  return tool\n}\n"],"names":["z","createPayloadTools","config","tools","collections","Array","isArray","Object","fromEntries","map","c","slug","description","entries","toolName","charAt","toUpperCase","slice","replace","_","inputSchema","object","limit","number","optional","describe","where","record","string","unknown","search","execute","input","context","payload","Error","query","collection","or","title","contains","name","label","result","find","docs","media","mediaCollection","getMedia","mimeType","conditions","push","filename","alt","equals","length","and","doc","id","url","width","height","pages","getPages","globals","globalSlug","_input","findGlobal","createTool","tool"],"mappings":"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"}

package/dist/ai/types.js

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

package/dist/ai/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":""}
+{"version":3,"sources":["../../src/ai/types.ts"],"sourcesContent":["import type { NextRequest } from 'next/server'\nimport type { Config as PuckConfig, Data as PuckData } from '@puckeditor/core'\nimport type { SanitizedConfig } from 'payload'\nimport type { PuckApiAuthHooks, AuthenticatedUser } from '../api/types.js'\n\n// =============================================================================\n// AI Tool Types\n// =============================================================================\n\n/**\n * Tool definition for AI agent\n *\n * Tools enable the AI to query your system for information,\n * executing functions directly on your server.\n *\n * @example\n * ```typescript\n * import { z } from 'zod'\n *\n * const getProducts: AiTool = {\n *   description: 'Get a list of products',\n *   inputSchema: z.object({\n *     category: z.enum(['consumer', 'business']),\n *   }),\n *   execute: async ({ category }) => {\n *     return await payload.find({ collection: 'products', where: { category } })\n *   },\n * }\n * ```\n */\n/**\n * Context passed to tool execution\n * Contains the Payload instance for database operations\n */\nexport interface AiToolContext {\n  /**\n   * Payload CMS instance for database operations\n   */\n  payload: import('payload').Payload\n  /**\n   * The authenticated user making the request\n   */\n  user?: import('payload').User\n}\n\nexport interface AiTool<TInput = unknown, TOutput = unknown> {\n  /**\n   * A description that the agent will use to understand how to use this tool\n   */\n  description: string\n  /**\n   * The shape of the parameters provided to the execute function.\n   * Must be a Zod object schema.\n   */\n  inputSchema: import('zod').ZodObject<any>\n  /**\n   * The execution function for the tool.\n   * Will receive parameters provided by the agent that match the inputSchema.\n   * The second parameter is optional execution context containing the Payload instance\n   * (available when using createPuckPlugin with auto-registered endpoints).\n   */\n  execute: (params: TInput, context?: AiToolContext) => Promise<TOutput> | TOutput\n  /**\n   * Optional name for the tool\n   */\n  name?: string\n}\n\n// =============================================================================\n// AI Configuration Types\n// =============================================================================\n\n/**\n * AI-specific configuration options for the server-side handler\n */\nexport interface AiOptions {\n  /**\n   * System context and instructions for the AI agent.\n   * Guides the AI's behavior and output.\n   *\n   * @example\n   * ```typescript\n   * context: `## Overview\n   * We are Google. You help us build Google landing pages.\n   *\n   * ## Brand Guidelines\n   * Our brand colors are:\n   * - #4285F4 (primary)\n   * - #DB4437\n   *\n   * ## Tone of Voice\n   * - American English\n   * - Professional but friendly`\n   * ```\n   */\n  context?: string\n  /**\n   * Custom tools that enable the AI to execute server-side functions.\n   * Tools allow the agent to query your database, fetch external data, etc.\n   */\n  tools?: Record<string, AiTool>\n  /**\n   * Custom Puck Cloud API key.\n   * Defaults to PUCK_API_KEY environment variable.\n   */\n  apiKey?: string\n  /**\n   * Custom Puck Cloud host URL\n   */\n  host?: string\n}\n\n// =============================================================================\n// AI Field Configuration\n// =============================================================================\n\n/**\n * AI configuration for a Puck field\n *\n * Add to any field's configuration to control how the AI generates content for it.\n *\n * @example\n * ```typescript\n * fields: {\n *   title: {\n *     type: 'text',\n *     ai: {\n *       instructions: 'Always use sentence case',\n *       required: true,\n *     },\n *   },\n * }\n * ```\n */\nexport interface AiFieldConfig {\n  /**\n   * Instructions for the AI when generating this field's value\n   */\n  instructions?: string\n  /**\n   * Whether this field is required for AI generation\n   * (even if not present in defaultProps)\n   */\n  required?: boolean\n  /**\n   * Exclude this field from AI generation.\n   * Useful for fields like media library references that AI can't populate.\n   */\n  exclude?: boolean\n  /**\n   * Custom JSON schema for the field.\n   * Required for 'custom', 'external', or user-defined fields\n   * where Puck AI cannot automatically infer the schema.\n   */\n  schema?: {\n    type: string\n    [key: string]: unknown\n  }\n}\n\n/**\n * AI configuration for a Puck component\n *\n * @example\n * ```typescript\n * const HeadingConfig = {\n *   ai: {\n *     instructions: 'Always place this at the top of sections',\n *   },\n *   fields: { ... },\n *   render: ({ title }) => <h1>{title}</h1>,\n * }\n * ```\n */\nexport interface AiComponentConfig {\n  /**\n   * Instructions for the AI when using this component\n   */\n  instructions?: string\n  /**\n   * Custom JSON schema for the entire component.\n   * For when Puck can't infer from fields.\n   */\n  schema?: {\n    type: 'object'\n    parameters: Record<string, { type: string; [key: string]: unknown }>\n    required?: string[]\n  }\n}\n\n// =============================================================================\n// API Routes Configuration\n// =============================================================================\n\n/**\n * Configuration for Puck AI API routes\n *\n * @example\n * ```typescript\n * // app/api/puck/[...all]/route.ts\n * import { createPuckAiApiRoutes } from '@delmaredigital/payload-puck/ai'\n *\n * export const POST = createPuckAiApiRoutes({\n *   payloadConfig: config,\n *   auth: {\n *     authenticate: async (request) => {\n *       // Your auth implementation\n *     },\n *   },\n *   ai: {\n *     context: 'We are Acme Corp. You build our landing pages.',\n *   },\n * })\n * ```\n */\nexport interface PuckAiRoutesConfig {\n  /**\n   * Payload configuration - import from @payload-config\n   */\n  payloadConfig: Promise<SanitizedConfig>\n  /**\n   * Authentication hooks (reuses existing pattern from API routes)\n   */\n  auth: PuckApiAuthHooks\n  /**\n   * AI-specific options\n   */\n  ai?: AiOptions\n  /**\n   * Custom error handler for logging/monitoring\n   */\n  onError?: (error: unknown, context: { operation: string; request: NextRequest }) => void\n}\n\n/**\n * Route handlers returned by createPuckAiApiRoutes\n */\nexport interface PuckAiRouteHandlers {\n  POST: (request: NextRequest) => Promise<Response>\n}\n\n// =============================================================================\n// Headless Generation Configuration\n// =============================================================================\n\n/**\n * Configuration for headless AI page generation\n *\n * @example\n * ```typescript\n * const generatePage = createAiGenerate({\n *   payloadConfig: config,\n *   auth: { authenticate: async (req) => ... },\n *   ai: { context: 'We are Acme Corp...' },\n * })\n *\n * const pageData = await generatePage({\n *   prompt: 'Create a landing page for our new product',\n *   puckConfig: editorConfig,\n * })\n * ```\n */\nexport interface AiGenerateConfig {\n  /**\n   * Payload configuration - import from @payload-config\n   */\n  payloadConfig: Promise<SanitizedConfig>\n  /**\n   * Authentication hooks\n   */\n  auth: PuckApiAuthHooks\n  /**\n   * AI-specific options\n   */\n  ai?: AiOptions\n}\n\n/**\n * Options for a single generation request\n */\nexport interface AiGenerateOptions {\n  /**\n   * Natural language prompt for generation\n   */\n  prompt: string\n  /**\n   * The Puck configuration with component definitions\n   */\n  puckConfig: PuckConfig\n  /**\n   * Optional authenticated user for the generation\n   */\n  user?: AuthenticatedUser\n  /**\n   * Existing Puck data to consider when actioning the prompt.\n   * Use this to update an existing page rather than create from scratch.\n   */\n  pageData?: PuckData\n}\n\n/**\n * Function returned by createAiGenerate\n */\nexport type AiGenerateFunction = (options: AiGenerateOptions) => Promise<PuckData>\n\n// =============================================================================\n// Client Plugin Configuration\n// =============================================================================\n\n/**\n * Example prompt for the AI chat interface\n */\nexport interface AiExamplePrompt {\n  /**\n   * Display label for the prompt\n   */\n  label: string\n  /**\n   * The actual prompt text\n   */\n  prompt: string\n}\n\n/**\n * Configuration options for the AI plugin\n *\n * @example\n * ```typescript\n * const aiPlugin = createAiPlugin({\n *   host: '/api/puck',\n *   examplePrompts: [\n *     { label: 'Landing page', prompt: 'Create a landing page about dogs' },\n *   ],\n * })\n * ```\n */\nexport interface AiPluginOptions {\n  /**\n   * API host for AI requests.\n   * @default '/api/puck'\n   */\n  host?: string\n  /**\n   * Example prompts to show in the chat interface.\n   * Users can click these to quickly send common prompts.\n   */\n  examplePrompts?: AiExamplePrompt[]\n  /**\n   * Callback when user submits a prompt\n   */\n  onSubmit?: (prompt: string) => void\n}\n\n// =============================================================================\n// Config Injection Types\n// =============================================================================\n\n/**\n * AI configuration overrides for components\n *\n * Used with injectAiConfig to add AI metadata to existing component configs.\n *\n * @example\n * ```typescript\n * const overrides: ComponentAiOverrides = {\n *   Heading: {\n *     ai: {\n *       instructions: 'Use for section titles',\n *     },\n *     fields: {\n *       text: {\n *         ai: { required: true },\n *       },\n *     },\n *   },\n * }\n * ```\n */\nexport interface ComponentAiOverrides {\n  [componentName: string]: {\n    ai?: AiComponentConfig\n    fields?: {\n      [fieldName: string]: {\n        ai?: AiFieldConfig\n      }\n    }\n  }\n}\n\n// =============================================================================\n// Prompt Editor Plugin Types\n// =============================================================================\n\n/**\n * A stored AI prompt from the database\n */\nexport interface AiPrompt {\n  id: string\n  label: string\n  prompt: string\n  category?: string\n  order?: number\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * A stored AI context entry from the database\n */\nexport interface AiContext {\n  id: string\n  name: string\n  content: string\n  category?: 'brand' | 'tone' | 'product' | 'industry' | 'technical' | 'patterns' | 'other'\n  enabled: boolean\n  order?: number\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * Configuration for the prompt editor plugin\n */\nexport interface PromptEditorPluginOptions {\n  /**\n   * API endpoint for prompt CRUD operations\n   * @default '/api/puck/ai-prompts'\n   */\n  apiEndpoint?: string\n  /**\n   * Whether users can edit prompts in the panel\n   * @default true\n   */\n  canEdit?: boolean\n  /**\n   * Whether to show the create button\n   * @default true\n   */\n  canCreate?: boolean\n  /**\n   * Whether to show delete buttons\n   * @default true\n   */\n  canDelete?: boolean\n}\n\n/**\n * Configuration for the context editor plugin\n */\nexport interface ContextEditorPluginOptions {\n  /**\n   * API endpoint for context CRUD operations\n   * @default '/api/puck/ai-context'\n   */\n  apiEndpoint?: string\n  /**\n   * Whether users can edit context in the panel\n   * @default true\n   */\n  canEdit?: boolean\n  /**\n   * Whether to show the create button\n   * @default true\n   */\n  canCreate?: boolean\n  /**\n   * Whether to show delete buttons\n   * @default true\n   */\n  canDelete?: boolean\n}\n\n// =============================================================================\n// Plugin System Integration Types\n// =============================================================================\n\n/**\n * AI configuration for createPuckPlugin\n */\nexport interface PuckPluginAiConfig {\n  /**\n   * Enable AI features\n   * @default false\n   */\n  enabled?: boolean\n  /**\n   * System context for the AI agent\n   */\n  context?: string\n  /**\n   * Custom tools that enable the AI to execute server-side functions.\n   * Tools allow the agent to query your database, fetch external data, etc.\n   *\n   * @example\n   * ```typescript\n   * import { z } from 'zod'\n   *\n   * createPuckPlugin({\n   *   ai: {\n   *     enabled: true,\n   *     tools: {\n   *       getProducts: {\n   *         description: 'Get products from the database',\n   *         inputSchema: z.object({ category: z.string() }),\n   *         execute: async ({ category }) => {\n   *           return await payload.find({ collection: 'products', where: { category } })\n   *         },\n   *       },\n   *     },\n   *   },\n   * })\n   * ```\n   */\n  tools?: Record<string, AiTool>\n  /**\n   * Example prompts for the chat interface\n   */\n  examplePrompts?: AiExamplePrompt[]\n  /**\n   * Auto-create puck-ai-prompts collection for storing prompts\n   * @default false\n   */\n  promptsCollection?: boolean\n  /**\n   * Auto-create puck-ai-context collection for dynamic business context.\n   * When enabled, context entries can be managed via Payload admin and\n   * the Context Editor panel in the Puck editor.\n   * @default false\n   */\n  contextCollection?: boolean\n  /**\n   * Custom component AI instructions to override or extend defaults.\n   * When AI is enabled, built-in component instructions are auto-applied.\n   * Use this to customize instructions for your brand/use case.\n   *\n   * @example\n   * ```typescript\n   * createPuckPlugin({\n   *   ai: {\n   *     enabled: true,\n   *     componentInstructions: {\n   *       Heading: {\n   *         ai: { instructions: 'Use our brand voice: professional but approachable' },\n   *         fields: {\n   *           text: { ai: { instructions: 'Keep under 8 words' } },\n   *         },\n   *       },\n   *     },\n   *   },\n   * })\n   * ```\n   */\n  componentInstructions?: ComponentAiOverrides\n}\n"],"names":[],"mappings":"AAwdA,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF;;CAEC,GACD,WA0EC"}