@delmaredigital/payload-puck 0.4.0 → 0.6.1

package/dist/editor/plugins/VersionHistoryPanel.js

@@ -0,0 +1,303 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useEffect, memo } from 'react';
+import { createUsePuck } from '@puckeditor/core';
+import { Loader2, Check, RotateCcw, AlertCircle } from 'lucide-react';
+// Create usePuck hook for accessing editor state and dispatch
+const usePuck = createUsePuck();
+// Panel styles using Puck's CSS variables
+const styles = {
+    container: {
+        display: 'flex',
+        flexDirection: 'column',
+        height: '100%',
+        backgroundColor: 'var(--puck-color-white)',
+    },
+    header: {
+        padding: '16px',
+        borderBottom: '1px solid var(--puck-color-grey-09)',
+        flexShrink: 0,
+    },
+    headerTitle: {
+        fontSize: '14px',
+        fontWeight: 600,
+        color: 'var(--puck-color-grey-02)',
+        margin: 0,
+    },
+    headerSubtitle: {
+        fontSize: '12px',
+        color: 'var(--puck-color-grey-05)',
+        marginTop: '4px',
+    },
+    content: {
+        flex: 1,
+        overflowY: 'auto',
+        padding: '8px',
+    },
+    loadingContainer: {
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: '48px 16px',
+        gap: '12px',
+    },
+    loadingIcon: {
+        width: '24px',
+        height: '24px',
+        color: 'var(--puck-color-grey-05)',
+        animation: 'spin 1s linear infinite',
+    },
+    loadingText: {
+        fontSize: '14px',
+        color: 'var(--puck-color-grey-05)',
+    },
+    errorContainer: {
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        padding: '32px 16px',
+        gap: '8px',
+    },
+    errorIcon: {
+        width: '32px',
+        height: '32px',
+        color: 'var(--puck-color-red-06)',
+    },
+    errorText: {
+        fontSize: '14px',
+        color: 'var(--puck-color-red-06)',
+        textAlign: 'center',
+    },
+    emptyContainer: {
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        padding: '48px 16px',
+        gap: '8px',
+    },
+    emptyText: {
+        fontSize: '14px',
+        color: 'var(--puck-color-grey-05)',
+        textAlign: 'center',
+    },
+    versionItem: {
+        borderRadius: '8px',
+        transition: 'background-color 0.15s',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        padding: '12px',
+        gap: '12px',
+        marginBottom: '4px',
+    },
+    versionInfo: {
+        flex: 1,
+        minWidth: 0,
+    },
+    versionHeader: {
+        display: 'flex',
+        alignItems: 'center',
+        gap: '8px',
+        flexWrap: 'wrap',
+    },
+    versionDate: {
+        fontSize: '14px',
+        fontWeight: 500,
+        color: 'var(--puck-color-grey-02)',
+    },
+    badge: {
+        fontSize: '11px',
+        fontWeight: 500,
+        borderRadius: '4px',
+        padding: '2px 6px',
+    },
+    badgeCurrent: {
+        backgroundColor: 'var(--puck-color-azure-11)',
+        color: 'var(--puck-color-azure-04)',
+    },
+    badgePublished: {
+        backgroundColor: 'var(--puck-color-green-11)',
+        color: 'var(--puck-color-green-04)',
+    },
+    autosaveText: {
+        fontSize: '11px',
+        color: 'var(--puck-color-grey-06)',
+        fontStyle: 'italic',
+    },
+    versionDetails: {
+        fontSize: '12px',
+        color: 'var(--puck-color-grey-05)',
+        marginTop: '4px',
+        overflow: 'hidden',
+        textOverflow: 'ellipsis',
+        whiteSpace: 'nowrap',
+    },
+    restoreButton: {
+        fontSize: '12px',
+        fontWeight: 500,
+        color: 'var(--puck-color-grey-04)',
+        transition: 'all 0.15s',
+        display: 'flex',
+        alignItems: 'center',
+        gap: '4px',
+        padding: '6px 10px',
+        flexShrink: 0,
+        background: 'none',
+        border: '1px solid var(--puck-color-grey-08)',
+        borderRadius: '6px',
+        cursor: 'pointer',
+    },
+    restoreButtonDisabled: {
+        opacity: 0.5,
+        cursor: 'not-allowed',
+    },
+    checkIcon: {
+        width: '16px',
+        height: '16px',
+        color: 'var(--puck-color-azure-05)',
+        flexShrink: 0,
+    },
+    successMessage: {
+        display: 'flex',
+        alignItems: 'center',
+        gap: '8px',
+        padding: '12px 16px',
+        backgroundColor: 'var(--puck-color-green-11)',
+        borderRadius: '8px',
+        marginBottom: '8px',
+    },
+    successText: {
+        fontSize: '13px',
+        color: 'var(--puck-color-green-03)',
+        fontWeight: 500,
+    },
+};
+/**
+ * Version history panel for the Puck plugin rail
+ *
+ * Displays a list of previous versions with the ability to restore them.
+ * Uses Puck's dispatch to update editor state without page reload.
+ */
+export const VersionHistoryPanel = memo(function VersionHistoryPanel({ pageId, apiEndpoint = '/api/puck/pages', onRestoreSuccess, }) {
+    const dispatch = usePuck((s) => s.dispatch);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isRestoring, setIsRestoring] = useState(false);
+    const [versions, setVersions] = useState([]);
+    const [error, setError] = useState(null);
+    const [hoveredIndex, setHoveredIndex] = useState(null);
+    const [successMessage, setSuccessMessage] = useState(null);
+    // Fetch versions on mount
+    const fetchVersions = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const url = `${apiEndpoint}/${pageId}/versions?limit=20`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    setError('Version history is not available for this page.');
+                }
+                else {
+                    throw new Error('Failed to fetch versions');
+                }
+                return;
+            }
+            const data = await response.json();
+            // Handle both 'docs' (our API) and 'versions' (Payload direct) response formats
+            setVersions(data.docs || data.versions || []);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to load versions');
+            console.error('Error fetching versions:', err);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiEndpoint, pageId]);
+    useEffect(() => {
+        fetchVersions();
+    }, [fetchVersions]);
+    // Handle version restore
+    const handleRestore = useCallback(async (version) => {
+        if (!confirm(`Restore this version from ${formatDate(version.updatedAt)}? This will replace your current content.`)) {
+            return;
+        }
+        setIsRestoring(true);
+        setError(null);
+        setSuccessMessage(null);
+        try {
+            // Call restore endpoint
+            const response = await fetch(`${apiEndpoint}/${pageId}/versions`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ versionId: version.id }),
+            });
+            if (!response.ok) {
+                throw new Error('Failed to restore version');
+            }
+            const result = await response.json();
+            const restoredDoc = result.doc;
+            // Update Puck editor state with restored data
+            if (restoredDoc?.puckData) {
+                dispatch({
+                    type: 'setData',
+                    data: restoredDoc.puckData,
+                });
+            }
+            // Show success message
+            setSuccessMessage(`Restored version from ${formatDate(version.updatedAt)}`);
+            setTimeout(() => setSuccessMessage(null), 3000);
+            // Notify parent to mark as clean
+            onRestoreSuccess?.();
+            // Refresh version list
+            fetchVersions();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : 'Failed to restore version');
+            console.error('Error restoring version:', err);
+        }
+        finally {
+            setIsRestoring(false);
+        }
+    }, [apiEndpoint, pageId, dispatch, onRestoreSuccess, fetchVersions]);
+    // Format date for display
+    function formatDate(dateStr) {
+        const date = new Date(dateStr);
+        const now = new Date();
+        const diffMs = now.getTime() - date.getTime();
+        const diffMins = Math.floor(diffMs / 60000);
+        const diffHours = Math.floor(diffMs / 3600000);
+        const diffDays = Math.floor(diffMs / 86400000);
+        if (diffMins < 1)
+            return 'Just now';
+        if (diffMins < 60)
+            return `${diffMins}m ago`;
+        if (diffHours < 24)
+            return `${diffHours}h ago`;
+        if (diffDays < 7)
+            return `${diffDays}d ago`;
+        return date.toLocaleDateString();
+    }
+    // Format time for display
+    function formatTime(dateStr) {
+        const date = new Date(dateStr);
+        return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+    }
+    return (_jsxs("div", { style: styles.container, children: [_jsxs("div", { style: styles.header, children: [_jsx("h3", { style: styles.headerTitle, children: "Version History" }), !isLoading && !error && versions.length > 0 && (_jsxs("div", { style: styles.headerSubtitle, children: [versions.length, " version", versions.length !== 1 ? 's' : '', " available"] }))] }), _jsxs("div", { style: styles.content, children: [successMessage && (_jsxs("div", { style: styles.successMessage, children: [_jsx(Check, { style: { width: '16px', height: '16px', color: 'var(--puck-color-green-04)' } }), _jsx("span", { style: styles.successText, children: successMessage })] })), isLoading ? (_jsxs("div", { style: styles.loadingContainer, children: [_jsx(Loader2, { style: styles.loadingIcon }), _jsx("span", { style: styles.loadingText, children: "Loading versions..." })] })) : error ? (_jsxs("div", { style: styles.errorContainer, children: [_jsx(AlertCircle, { style: styles.errorIcon }), _jsx("div", { style: styles.errorText, children: error })] })) : versions.length === 0 ? (_jsx("div", { style: styles.emptyContainer, children: _jsxs("div", { style: styles.emptyText, children: ["No version history available yet.", _jsx("br", {}), "Versions are created when you save or publish."] }) })) : (versions.map((version, index) => (_jsxs("div", { style: {
+                            ...styles.versionItem,
+                            backgroundColor: hoveredIndex === index ? 'var(--puck-color-grey-11)' : 'transparent',
+                        }, onMouseEnter: () => setHoveredIndex(index), onMouseLeave: () => setHoveredIndex(null), children: [_jsxs("div", { style: styles.versionInfo, children: [_jsxs("div", { style: styles.versionHeader, children: [_jsx("span", { style: styles.versionDate, children: formatDate(version.updatedAt) }), index === 0 && (_jsx("span", { style: { ...styles.badge, ...styles.badgeCurrent }, children: "Current" })), version.version._status === 'published' && (_jsx("span", { style: { ...styles.badge, ...styles.badgePublished }, children: "Published" })), version.autosave && (_jsx("span", { style: styles.autosaveText, children: "auto" }))] }), _jsxs("div", { style: styles.versionDetails, children: [formatTime(version.updatedAt), version.version.title && (_jsxs("span", { children: [" \u00B7 ", version.version.title] }))] })] }), index > 0 && (_jsxs("button", { type: "button", onClick: () => handleRestore(version), disabled: isRestoring, style: {
+                                    ...styles.restoreButton,
+                                    ...(isRestoring ? styles.restoreButtonDisabled : {}),
+                                }, onMouseEnter: (e) => {
+                                    if (!isRestoring) {
+                                        e.currentTarget.style.backgroundColor = 'var(--puck-color-grey-10)';
+                                        e.currentTarget.style.borderColor = 'var(--puck-color-grey-07)';
+                                    }
+                                }, onMouseLeave: (e) => {
+                                    e.currentTarget.style.backgroundColor = 'transparent';
+                                    e.currentTarget.style.borderColor = 'var(--puck-color-grey-08)';
+                                }, children: [isRestoring ? (_jsx(Loader2, { style: { width: '14px', height: '14px', animation: 'spin 1s linear infinite' } })) : (_jsx(RotateCcw, { style: { width: '14px', height: '14px' } })), "Restore"] })), index === 0 && (_jsx(Check, { style: styles.checkIcon }))] }, version.id))))] })] }));
+});
+//# sourceMappingURL=VersionHistoryPanel.js.map

package/dist/editor/plugins/VersionHistoryPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionHistoryPanel.js","sourceRoot":"","sources":["../../../src/editor/plugins/VersionHistoryPanel.tsx"],"names":[],"mappings":"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"}

package/dist/editor/plugins/index.d.ts

@@ -3,10 +3,13 @@
  *
  * @example
  * ```tsx
- * import { PuckEditor, headingAnalyzer } from '@delmaredigital/payload-puck/editor'
+ * import { PuckEditor, headingAnalyzer, createVersionHistoryPlugin } from '@delmaredigital/payload-puck/editor'
  *
- * <PuckEditor plugins={[headingAnalyzer]} />
+ * const versionPlugin = createVersionHistoryPlugin({ pageId: 'page-123' })
+ * <PuckEditor plugins={[headingAnalyzer, versionPlugin]} />
  * ```
  */
-export { default as headingAnalyzer } from '@measured/puck-plugin-heading-analyzer';
+export { default as headingAnalyzer } from '@puckeditor/plugin-heading-analyzer';
+export { createVersionHistoryPlugin, type VersionHistoryPluginOptions, } from './versionHistoryPlugin.js';
+export { VersionHistoryPanel, type VersionHistoryPanelProps, type PageVersion, } from './VersionHistoryPanel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/editor/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAGhF,OAAO,EACL,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,GACjB,MAAM,0BAA0B,CAAA"}

package/dist/editor/plugins/index.js

@@ -3,10 +3,14 @@
  *
  * @example
  * ```tsx
- * import { PuckEditor, headingAnalyzer } from '@delmaredigital/payload-puck/editor'
+ * import { PuckEditor, headingAnalyzer, createVersionHistoryPlugin } from '@delmaredigital/payload-puck/editor'
  *
- * <PuckEditor plugins={[headingAnalyzer]} />
+ * const versionPlugin = createVersionHistoryPlugin({ pageId: 'page-123' })
+ * <PuckEditor plugins={[headingAnalyzer, versionPlugin]} />
  * ```
  */
-export { default as headingAnalyzer } from '@measured/puck-plugin-heading-analyzer';
+export { default as headingAnalyzer } from '@puckeditor/plugin-heading-analyzer';
+// Version History plugin for plugin rail
+export { createVersionHistoryPlugin, } from './versionHistoryPlugin.js';
+export { VersionHistoryPanel, } from './VersionHistoryPanel.js';
 //# sourceMappingURL=index.js.map

package/dist/editor/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAEhF,yCAAyC;AACzC,OAAO,EACL,0BAA0B,GAE3B,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAA"}

package/dist/editor/plugins/versionHistoryPlugin.d.ts

@@ -0,0 +1,37 @@
+import type { Plugin } from '@puckeditor/core';
+export interface VersionHistoryPluginOptions {
+    /**
+     * Page ID to fetch versions for
+     */
+    pageId: string;
+    /**
+     * API endpoint base path
+     * @default '/api/puck/pages'
+     */
+    apiEndpoint?: string;
+    /**
+     * Callback after successful restore (e.g., to mark editor as clean)
+     */
+    onRestoreSuccess?: () => void;
+}
+/**
+ * Creates a Puck plugin for version history
+ *
+ * Adds a "History" button to the plugin rail that opens a panel
+ * showing version history with the ability to restore previous versions.
+ *
+ * @example
+ * ```tsx
+ * import { createVersionHistoryPlugin } from '@delmaredigital/payload-puck/editor'
+ *
+ * const versionPlugin = createVersionHistoryPlugin({
+ *   pageId: 'page-123',
+ *   apiEndpoint: '/api/puck/pages',
+ *   onRestoreSuccess: () => markEditorClean(),
+ * })
+ *
+ * <Puck plugins={[versionPlugin]} />
+ * ```
+ */
+export declare function createVersionHistoryPlugin(options: VersionHistoryPluginOptions): Plugin;
+//# sourceMappingURL=versionHistoryPlugin.d.ts.map

package/dist/editor/plugins/versionHistoryPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionHistoryPlugin.d.ts","sourceRoot":"","sources":["../../../src/editor/plugins/versionHistoryPlugin.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAYvF"}

package/dist/editor/plugins/versionHistoryPlugin.js

@@ -0,0 +1,36 @@
+'use client';
+import { createElement } from 'react';
+import { History } from 'lucide-react';
+import { VersionHistoryPanel } from './VersionHistoryPanel';
+/**
+ * Creates a Puck plugin for version history
+ *
+ * Adds a "History" button to the plugin rail that opens a panel
+ * showing version history with the ability to restore previous versions.
+ *
+ * @example
+ * ```tsx
+ * import { createVersionHistoryPlugin } from '@delmaredigital/payload-puck/editor'
+ *
+ * const versionPlugin = createVersionHistoryPlugin({
+ *   pageId: 'page-123',
+ *   apiEndpoint: '/api/puck/pages',
+ *   onRestoreSuccess: () => markEditorClean(),
+ * })
+ *
+ * <Puck plugins={[versionPlugin]} />
+ * ```
+ */
+export function createVersionHistoryPlugin(options) {
+    return {
+        name: 'version-history',
+        label: 'History',
+        icon: createElement(History, { size: 20 }),
+        render: () => createElement(VersionHistoryPanel, {
+            pageId: options.pageId,
+            apiEndpoint: options.apiEndpoint,
+            onRestoreSuccess: options.onRestoreSuccess,
+        }),
+    };
+}
+//# sourceMappingURL=versionHistoryPlugin.js.map

package/dist/editor/plugins/versionHistoryPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionHistoryPlugin.js","sourceRoot":"","sources":["../../../src/editor/plugins/versionHistoryPlugin.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAkB3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,EAAE,CACX,aAAa,CAAC,mBAAmB,EAAE;YACjC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC;KACL,CAAA;AACH,CAAC"}

package/dist/editor/utils/detectPageTree.d.ts

@@ -1,4 +1,4 @@
-import type { Config as PuckConfig } from '@measured/puck';
+import type { Config as PuckConfig } from '@puckeditor/core';
 /**
  * Detects whether page-tree integration should be enabled.
  *

package/dist/editor/utils/detectPageTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detectPageTree.d.ts","sourceRoot":"","sources":["../../../src/editor/utils/detectPageTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAclF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAG7D"}
+{"version":3,"file":"detectPageTree.d.ts","sourceRoot":"","sources":["../../../src/editor/utils/detectPageTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAclF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAG7D"}

package/dist/editor/utils/injectPageTreeFields.d.ts

@@ -1,4 +1,4 @@
-import type { Config as PuckConfig } from '@measured/puck';
+import type { Config as PuckConfig } from '@puckeditor/core';
 /**
  * Injects page-tree fields (folder, pageSegment, slug) into a Puck config's root fields.
  * Replaces any existing slug field with the page-tree slug preview.

package/dist/editor/utils/injectPageTreeFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injectPageTreeFields.d.ts","sourceRoot":"","sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAK1D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAyBnE"}
+{"version":3,"file":"injectPageTreeFields.d.ts","sourceRoot":"","sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAK5D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAyBnE"}

package/dist/editor/utils/injectPageTreeFields.js

@@ -1,5 +1,5 @@
 import { createFolderPickerField } from '../../fields/FolderPickerField.js';
-import { createPageSegmentField } from '../../fields/PageSegmentField.js';
+import { createLockedPageSegmentField } from '../../fields/PageSegmentField.js';
 import { createSlugPreviewField } from '../../fields/SlugPreviewField.js';
 /**
  * Injects page-tree fields (folder, pageSegment, slug) into a Puck config's root fields.
@@ -12,7 +12,7 @@ export function injectPageTreeFields(config) {
     // Create page-tree specific fields
     const pageTreeFields = {
         folder: createFolderPickerField({ label: 'Folder' }),
-        pageSegment: createPageSegmentField({ label: 'Page Segment' }),
+        pageSegment: createLockedPageSegmentField({ label: 'Page Segment' }),
         slug: createSlugPreviewField({
             label: 'URL Slug',
             hint: 'Auto-generated from folder + page segment',

package/dist/editor/utils/injectPageTreeFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectPageTreeFields.js","sourceRoot":"","sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,mCAAmC;IACnC,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACpD,WAAW,EAAE,sBAAsB,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAC9D,IAAI,EAAE,sBAAsB,CAAC;YAC3B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,2CAA2C;SAClD,CAAC;KACH,CAAA;IAED,yEAAyE;IACzE,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAA;IACpD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,kBAA6C,CAAA;IAE7F,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,MAAM,CAAC,IAAI;YACd,MAAM,EAAE;gBACN,GAAG,WAAW;gBACd,GAAG,cAAc;aAClB;SACF;KACY,CAAA;AACjB,CAAC"}
+{"version":3,"file":"injectPageTreeFields.js","sourceRoot":"","sources":["../../../src/editor/utils/injectPageTreeFields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,mCAAmC;IACnC,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACpD,WAAW,EAAE,4BAA4B,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QACpE,IAAI,EAAE,sBAAsB,CAAC;YAC3B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,2CAA2C;SAClD,CAAC;KACH,CAAA;IAED,yEAAyE;IACzE,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAA;IACpD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,kBAA6C,CAAA;IAE7F,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,MAAM,CAAC,IAAI;YACd,MAAM,EAAE;gBACN,GAAG,WAAW;gBACd,GAAG,cAAc;aAClB;SACF;KACY,CAAA;AACjB,CAAC"}

package/dist/endpoints/ai.d.ts

@@ -0,0 +1,36 @@
+import type { PayloadHandler } from 'payload';
+import type { AiTool, AiToolContext } from '../ai/types.js';
+export type { AiTool, AiToolContext };
+/**
+ * Options for the AI endpoint handler
+ */
+export interface AiEndpointOptions {
+    /**
+     * Business context for AI generation
+     * Helps the AI understand your brand, tone, and requirements
+     */
+    context?: string;
+    /**
+     * Custom tools for AI to use during generation
+     * These allow AI to perform actions like database lookups, API calls, etc.
+     */
+    tools?: Record<string, AiTool>;
+}
+/**
+ * Creates a Payload endpoint handler for Puck AI
+ *
+ * This handler wraps @puckeditor/cloud-client's puckHandler with
+ * Payload authentication. It's auto-registered by createPuckPlugin
+ * when `ai.enabled: true`.
+ *
+ * @example
+ * // Automatically registered at /api/puck/ai when:
+ * createPuckPlugin({
+ *   ai: {
+ *     enabled: true,
+ *     context: 'You build pages for Acme Corp...',
+ *   },
+ * })
+ */
+export declare function createAiEndpointHandler(options?: AiEndpointOptions): PayloadHandler;
+//# sourceMappingURL=ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAA;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAa,MAAM,gBAAgB,CAAA;AAItE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;AAiDrC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAgSvF"}