@delmaredigital/payload-puck 0.3.1 → 0.6.0

package/dist/ai/presets/instructions/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/ai/presets/instructions/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,iCAAiC;AACjC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CAOvB,CAAA;AAED,iDAAiD;AACjD,eAAO,MAAM,eAAe;;;;CAI3B,CAAA;AAED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAA;AAMD,0DAA0D;AAC1D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWzB,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUnC,CAAA;AAMD,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;CAQrC,CAAA;AAED,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAW5B,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUtC,CAAA;AAMD,mCAAmC;AACnC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAO9B,CAAA;AAED,oCAAoC;AACpC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAU1B,CAAA;AAED,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS5B,CAAA;AAMD,kCAAkC;AAClC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBxB,CAAA;AAMD,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAe3B,CAAA;AAMD,sCAAsC;AACtC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;CAU5B,CAAA;AAMD,gCAAgC;AAChC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWtB,CAAA;AAMD,qCAAqC;AACrC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB3B,CAAA"}

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

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

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

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

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

@@ -0,0 +1,16 @@
+import type { ComponentAiOverrides } from '../../types.js';
+/**
+ * Comprehensive AI instructions for typography components
+ *
+ * These instructions teach the AI:
+ * - What each component is for
+ * - Correct field names and values
+ * - When to use each component
+ * - How to compose them with other components
+ */
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../../../src/ai/presets/instructions/typography.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAG1D;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBAwLpC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,0CAA2C,CAAA"}

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

@@ -0,0 +1,192 @@
+import { colorSchema, alignmentSchema } from './schemas.js';
+/**
+ * Comprehensive AI instructions for typography components
+ *
+ * These instructions teach the AI:
+ * - What each component is for
+ * - Correct field names and values
+ * - When to use each component
+ * - How to compose them with other components
+ */
+export const typographyInstructions = {
+    Heading: {
+        ai: {
+            instructions: `Heading component for titles and section headings.
+
+PURPOSE:
+- Page titles, section headings, and subsection titles
+- Establishes content hierarchy and structure
+- Improves accessibility and SEO
+
+USAGE GUIDELINES:
+- Use h1 ONLY ONCE per page for the main page title (in the hero section)
+- Use h2 for major section headings (Features, Testimonials, FAQ, etc.)
+- Use h3 for subsection headings or card titles within sections
+- Use h4-h6 rarely, only for deeply nested content
+
+COMMON PATTERNS:
+- Hero headline: h1 level, centered alignment
+- Section title: h2 level, often centered
+- Card/feature title: h3 level, left or center aligned
+- Sidebar heading: h4 level
+
+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`,
+        },
+        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+.',
+                },
+            },
+            level: {
+                ai: {
+                    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,
+                },
+            },
+            alignment: {
+                ai: {
+                    instructions: "Text alignment: 'left', 'center', or 'right'. Use 'center' for hero/section headings, 'left' for content areas.",
+                    schema: alignmentSchema,
+                },
+            },
+        },
+    },
+    Text: {
+        ai: {
+            instructions: `Text component for paragraphs and body content.
+
+PURPOSE:
+- Body text, descriptions, and supporting content
+- Single paragraphs or short text blocks
+- Subtitles and secondary text under headings
+
+USAGE GUIDELINES:
+- Use for 1-3 paragraphs of plain text
+- For longer formatted content with lists/links, use RichText instead
+- Size options: xs, sm, base (default), lg, xl
+
+COMMON PATTERNS:
+- Hero subtitle: lg or xl size, centered, below h1
+- Section description: base size, centered, below h2
+- Card description: sm or base size, left-aligned
+- Feature text: base size, often paired with heading
+
+COMPOSITION:
+- Usually follows a Heading component
+- Place inside Flex (column) with Heading for text blocks
+- 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.',
+                },
+            },
+            size: {
+                ai: {
+                    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,
+                },
+            },
+            alignment: {
+                ai: {
+                    instructions: "Text alignment: 'left', 'center', or 'right'. Match the alignment of the heading above it.",
+                    schema: alignmentSchema,
+                },
+            },
+        },
+    },
+    RichText: {
+        ai: {
+            instructions: `RichText component - TipTap-powered rich text with advanced formatting.
+
+PURPOSE:
+- Long-form content with sophisticated formatting
+- Content needing font sizes, colors, highlights
+- Blog posts, about pages, formatted descriptions
+- Any content needing more than plain text
+
+USAGE GUIDELINES:
+- Use RichText over Text when you need ANY formatting
+- Supports font sizes from xs to 5xl
+- Supports text colors with opacity
+- Supports highlights/background colors
+- Content is HTML with data attributes for styling
+
+TIPTAP FEATURES AVAILABLE:
+- Font sizes: text-xs, text-sm, text-base, text-lg, text-xl, text-2xl, text-3xl, text-4xl, text-5xl
+- Text colors: Any hex color with opacity (via data attributes)
+- Highlights: Background color highlights on text
+- Formatting: bold, italic, underline, strikethrough
+- Special: superscript, subscript
+- Blocks: blockquotes, code blocks
+- Lists: bullet lists, numbered lists
+- Links: clickable hyperlinks
+
+COMMON PATTERNS:
+- Hero subtitle with large colorful text
+- Feature descriptions with highlights
+- Blog content with mixed formatting
+- FAQ answers with styled callouts
+- About page with branded text colors
+
+HTML STRUCTURE:
+- <p>Paragraph text</p>
+- <p><span style="font-size:...">Sized text</span></p>
+- <p><span style="color:...">Colored text</span></p>
+- <p><mark>Highlighted text</mark></p>
+- <ul><li>Bullet item</li></ul>
+- <ol><li>Numbered item</li></ol>
+- <blockquote>Quote text</blockquote>
+- <pre><code>Code block</code></pre>
+- <a href="url">Link text</a>
+- <strong>Bold</strong>, <em>Italic</em>, <u>Underline</u>, <s>Strikethrough</s>
+- <sup>Superscript</sup>, <sub>Subscript</sub>
+
+COMPOSITION:
+- Place inside Container for constrained width
+- Use in Accordion items for formatted FAQ answers
+- Combine with Section backgrounds for contrast`,
+        },
+        fields: {
+            content: {
+                ai: {
+                    required: true,
+                    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>
+- <p><span style="color: #3b82f6">Colored text</span></p>
+- <ul><li>Bullet item</li></ul>
+- <ol><li>Numbered item</li></ol>
+- <blockquote>Quote</blockquote>
+- <a href="url">Link text</a>
+- <strong>Bold</strong>, <em>Italic</em>`,
+                },
+            },
+        },
+    },
+};
+/**
+ * Typography component names for reference
+ */
+export const typographyComponents = ['Heading', 'Text', 'RichText'];
+//# sourceMappingURL=typography.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,116 @@
+/**
+ * Pre-built AI tools for Payload CMS integration
+ *
+ * These tools allow the AI to query your Payload database during page generation,
+ * enabling it to use real content instead of placeholder text.
+ *
+ * @example
+ * ```typescript
+ * import { createPayloadTools } from '@delmaredigital/payload-puck/ai'
+ *
+ * createPuckPlugin({
+ *   ai: {
+ *     enabled: true,
+ *     tools: createPayloadTools({
+ *       collections: ['products', 'team-members', 'testimonials'],
+ *       media: true,
+ *       pages: 'pages',
+ *     }),
+ *   },
+ * })
+ * ```
+ */
+import type { AiTool } from '../types.js';
+/**
+ * Configuration for createPayloadTools
+ */
+export interface PayloadToolsConfig {
+    /**
+     * Collections the AI can query.
+     * Pass an array of collection slugs, or an object mapping slugs to descriptions.
+     *
+     * @example
+     * ```typescript
+     * // Simple - just collection names
+     * collections: ['products', 'team-members']
+     *
+     * // With descriptions - helps AI understand when to use each
+     * collections: {
+     *   products: 'Product catalog with name, price, description, and image',
+     *   'team-members': 'Staff profiles with name, role, bio, and headshot',
+     * }
+     * ```
+     */
+    collections?: string[] | Record<string, string>;
+    /**
+     * Enable media library tool.
+     * When true, AI can search for images by filename or alt text.
+     * @default false
+     */
+    media?: boolean | string;
+    /**
+     * Pages collection slug for internal linking.
+     * When set, AI can look up page URLs for navigation/links.
+     */
+    pages?: string;
+    /**
+     * Globals the AI can read.
+     * Useful for site settings, contact info, etc.
+     *
+     * @example
+     * ```typescript
+     * globals: ['site-settings', 'contact-info']
+     * ```
+     */
+    globals?: string[];
+}
+/**
+ * Creates a set of AI tools for querying Payload CMS
+ *
+ * IMPORTANT: These tools need the `payload` instance at runtime.
+ * The plugin automatically injects `payload` into the tool execution context.
+ *
+ * @example
+ * ```typescript
+ * import { createPayloadTools } from '@delmaredigital/payload-puck/ai'
+ *
+ * createPuckPlugin({
+ *   ai: {
+ *     enabled: true,
+ *     context: 'You are building pages for Acme Corp...',
+ *     tools: createPayloadTools({
+ *       collections: {
+ *         products: 'Products with name, price, description, and image',
+ *         testimonials: 'Customer testimonials with quote, author, and company',
+ *       },
+ *       media: true,
+ *       pages: 'pages',
+ *       globals: ['site-settings'],
+ *     }),
+ *   },
+ * })
+ * ```
+ */
+export declare function createPayloadTools(config: PayloadToolsConfig): Record<string, AiTool<any, any>>;
+/**
+ * Create a custom AI tool with proper typing
+ *
+ * @example
+ * ```typescript
+ * import { createTool } from '@delmaredigital/payload-puck/ai'
+ * import { z } from 'zod'
+ *
+ * const getWeather = createTool({
+ *   description: 'Get current weather for a location',
+ *   inputSchema: z.object({
+ *     city: z.string().describe('City name'),
+ *   }),
+ *   execute: async ({ city }, context) => {
+ *     const response = await fetch(`https://api.weather.com/...`)
+ *     return response.json()
+ *   },
+ * })
+ * ```
+ */
+export declare function createTool<TInput, TOutput>(tool: AiTool<TInput, TOutput>): AiTool<TInput, TOutput>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAA;AAoBxD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE/C;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAExB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAmL/F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElG"}