@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/editor/PuckEditorCore.client.js

@@ -0,0 +1,306 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useMemo, useRef } from 'react';
+import { useRouter } from 'next/navigation';
+import { Puck } from '@measured/puck';
+import '@measured/puck/puck.css';
+import headingAnalyzer from '@measured/puck-plugin-heading-analyzer';
+import '@measured/puck-plugin-heading-analyzer/dist/index.css';
+import { HeaderActions } from './components/HeaderActions';
+import { IframeWrapper } from './components/IframeWrapper';
+import { PreviewModal } from './components/PreviewModal';
+import { useUnsavedChanges } from './hooks/useUnsavedChanges';
+import { ThemeProvider } from '../theme';
+/**
+ * Default viewports for responsive preview
+ */
+const DEFAULT_VIEWPORTS = [
+    {
+        width: 360,
+        height: 'auto',
+        label: 'Mobile',
+        icon: 'Smartphone',
+    },
+    {
+        width: 768,
+        height: 'auto',
+        label: 'Tablet',
+        icon: 'Tablet',
+    },
+    {
+        width: 1280,
+        height: 'auto',
+        label: 'Desktop',
+        icon: 'Monitor',
+    },
+];
+/**
+ * Full-featured Puck editor implementation
+ *
+ * Provides a complete editing experience with:
+ * - Save draft and publish functionality
+ * - Unsaved changes tracking with beforeunload warning
+ * - Interactive/Edit mode toggle
+ * - Theme-aware preview backgrounds
+ * - Responsive viewport switching
+ * - Custom header actions
+ *
+ * @example
+ * ```tsx
+ * 'use client'
+ *
+ * import { PuckEditorCore } from '@delmaredigital/payload-puck/editor'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export function PageEditor({ page }) {
+ *   return (
+ *     <PuckEditorCore
+ *       pageId={page.id}
+ *       initialData={page.puckData}
+ *       config={editorConfig}
+ *       pageTitle={page.title}
+ *       pageSlug={page.slug}
+ *       backUrl="/admin/pages"
+ *       layoutStyles={{
+ *         default: { background: '#fff', isDark: false },
+ *         dark: { background: '#1a1a1a', isDark: true },
+ *       }}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export function PuckEditorCore({ pageId, initialData, config, pageTitle, pageSlug, apiEndpoint = '/api/puck/pages', backUrl, previewUrl, enableViewports = true, plugins, layouts, layoutStyles, layoutKey = 'pageLayout', headerActionsStart, headerActionsEnd, overrides: customOverrides, onSaveSuccess, onSaveError, onChange: onChangeProp, initialStatus, theme, }) {
+    const router = useRouter();
+    const [isSaving, setIsSaving] = useState(false);
+    const [lastSaved, setLastSaved] = useState(null);
+    const [saveError, setSaveError] = useState(null);
+    const [documentStatus, setDocumentStatus] = useState(initialStatus);
+    // Track if document was ever published (initially or during this session)
+    const [wasPublished, setWasPublished] = useState(initialStatus === 'published');
+    const { hasUnsavedChanges, markClean, markDirty } = useUnsavedChanges();
+    // Preview modal state
+    const [isPreviewOpen, setIsPreviewOpen] = useState(false);
+    // Inject slug into initial data if not present
+    const dataWithSlug = useMemo(() => {
+        const data = initialData;
+        return {
+            ...data,
+            root: {
+                ...data.root,
+                props: {
+                    ...data.root?.props,
+                    slug: data.root?.props?.slug || pageSlug,
+                },
+            },
+        };
+    }, [initialData, pageSlug]);
+    // Use a ref to track latest data without causing re-renders
+    const latestDataRef = useRef(dataWithSlug);
+    // Handle save (as draft)
+    const handleSave = useCallback(async (data) => {
+        setIsSaving(true);
+        const typedData = data;
+        try {
+            const response = await fetch(`${apiEndpoint}/${pageId}`, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    puckData: data,
+                    title: typedData.root?.props?.title || pageTitle,
+                    slug: typedData.root?.props?.slug || pageSlug,
+                    // Page-tree integration: include folder and pageSegment if present
+                    folder: typedData.root?.props?.folder,
+                    pageSegment: typedData.root?.props?.pageSegment,
+                    draft: true, // Save as draft, don't publish
+                }),
+            });
+            if (!response.ok) {
+                const errorData = await response.json();
+                const errorMessage = errorData.error || errorData.message || 'Failed to save page';
+                const err = new Error(errorMessage);
+                err.field = errorData.field;
+                err.details = errorData.details;
+                throw err;
+            }
+            setLastSaved(new Date());
+            setSaveError(null); // Clear any previous error
+            // After saving as draft, update status to draft (shows "Unpublished Changes" if was published)
+            setDocumentStatus('draft');
+            markClean();
+            onSaveSuccess?.(data);
+        }
+        catch (error) {
+            console.error('Error saving page:', error);
+            setSaveError(error instanceof Error ? error.message : 'Unknown error');
+            onSaveError?.(error instanceof Error ? error : new Error('Unknown error'));
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }, [apiEndpoint, pageId, pageTitle, pageSlug, markClean, onSaveSuccess, onSaveError]);
+    // Handle publish
+    const handlePublish = useCallback(async (data) => {
+        setIsSaving(true);
+        const typedData = data;
+        try {
+            const response = await fetch(`${apiEndpoint}/${pageId}`, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    puckData: data,
+                    title: typedData.root?.props?.title || pageTitle,
+                    slug: typedData.root?.props?.slug || pageSlug,
+                    // Page-tree integration: include folder and pageSegment if present
+                    folder: typedData.root?.props?.folder,
+                    pageSegment: typedData.root?.props?.pageSegment,
+                    status: 'published',
+                }),
+            });
+            if (!response.ok) {
+                const errorData = await response.json();
+                const errorMessage = errorData.error || errorData.message || 'Failed to publish page';
+                const err = new Error(errorMessage);
+                err.field = errorData.field;
+                err.details = errorData.details;
+                throw err;
+            }
+            setLastSaved(new Date());
+            setSaveError(null); // Clear any previous error
+            setDocumentStatus('published'); // Update status after successful publish
+            setWasPublished(true); // Mark as having been published
+            markClean();
+            onSaveSuccess?.(data);
+        }
+        catch (error) {
+            console.error('Error publishing page:', error);
+            setSaveError(error instanceof Error ? error.message : 'Unknown error');
+            onSaveError?.(error instanceof Error ? error : new Error('Unknown error'));
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }, [apiEndpoint, pageId, pageTitle, pageSlug, markClean, onSaveSuccess, onSaveError]);
+    // Handle data change
+    const handleChange = useCallback((data) => {
+        latestDataRef.current = data;
+        markDirty();
+        onChangeProp?.(data);
+    }, [markDirty, onChangeProp]);
+    // Handle back navigation
+    const handleBack = useCallback(() => {
+        if (hasUnsavedChanges) {
+            if (!confirm('You have unsaved changes. Are you sure you want to leave?')) {
+                return;
+            }
+        }
+        if (backUrl) {
+            router.push(backUrl);
+        }
+        else {
+            router.back();
+        }
+    }, [hasUnsavedChanges, router, backUrl]);
+    // Handle preview (opens in new tab)
+    const handlePreview = useCallback(() => {
+        const currentSlug = latestDataRef.current?.root?.props?.slug || pageSlug;
+        let url;
+        if (typeof previewUrl === 'function') {
+            url = previewUrl(currentSlug);
+        }
+        else if (previewUrl) {
+            url = previewUrl;
+        }
+        else {
+            url = `/${currentSlug}`;
+        }
+        window.open(url, '_blank');
+    }, [pageSlug, previewUrl]);
+    // Handle opening preview modal
+    const handleOpenPreview = useCallback(() => {
+        setIsPreviewOpen(true);
+    }, []);
+    // Handle save from preview modal (returns Promise for navigation flow)
+    const handleSaveFromPreview = useCallback(async () => {
+        const data = latestDataRef.current;
+        setIsSaving(true);
+        try {
+            const response = await fetch(`${apiEndpoint}/${pageId}`, {
+                method: 'PATCH',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    puckData: data,
+                    title: data?.root?.props?.title || pageTitle,
+                    slug: data?.root?.props?.slug || pageSlug,
+                    // Page-tree integration: include folder and pageSegment if present
+                    folder: data?.root?.props?.folder,
+                    pageSegment: data?.root?.props?.pageSegment,
+                    draft: true,
+                }),
+            });
+            if (!response.ok) {
+                const errorData = await response.json();
+                const errorMessage = errorData.error || errorData.message || 'Failed to save page';
+                throw new Error(errorMessage);
+            }
+            setLastSaved(new Date());
+            setSaveError(null);
+            setDocumentStatus('draft');
+            markClean();
+            onSaveSuccess?.(data);
+        }
+        catch (error) {
+            console.error('Error saving page:', error);
+            setSaveError(error instanceof Error ? error.message : 'Unknown error');
+            onSaveError?.(error instanceof Error ? error : new Error('Unknown error'));
+            throw error; // Re-throw so preview modal knows save failed
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }, [apiEndpoint, pageId, pageTitle, pageSlug, markClean, onSaveSuccess, onSaveError]);
+    // Memoized overrides
+    const overrides = useMemo(() => ({
+        headerActions: ({ children }) => (_jsx(HeaderActions, { onBack: handleBack, onPreview: handlePreview, onSave: handleSave, onPublish: handlePublish, onOpenPreview: handleOpenPreview, isSaving: isSaving, hasUnsavedChanges: hasUnsavedChanges, lastSaved: lastSaved, documentStatus: documentStatus, wasPublished: wasPublished, actionsStart: headerActionsStart, actionsEnd: headerActionsEnd, pageId: pageId, apiEndpoint: apiEndpoint, saveError: saveError, onDismissError: () => setSaveError(null), children: children })),
+        // Always wrap iframe for richtext styles injection and theme-aware background
+        iframe: ({ children, document }) => (_jsx(IframeWrapper, { document: document, layouts: layouts, layoutStyles: layoutStyles, layoutKey: layoutKey, children: children })),
+        // Merge custom overrides
+        ...customOverrides,
+    }), [
+        handleBack,
+        handlePreview,
+        handleSave,
+        handlePublish,
+        handleOpenPreview,
+        isSaving,
+        hasUnsavedChanges,
+        lastSaved,
+        saveError,
+        documentStatus,
+        wasPublished,
+        headerActionsStart,
+        headerActionsEnd,
+        pageId,
+        apiEndpoint,
+        layouts,
+        layoutStyles,
+        layoutKey,
+        customOverrides,
+    ]);
+    // Default plugins - headingAnalyzer is always included unless plugins is explicitly false
+    const defaultPlugins = [headingAnalyzer];
+    const resolvedPlugins = useMemo(() => {
+        if (plugins === false)
+            return undefined;
+        if (!plugins || plugins.length === 0)
+            return defaultPlugins;
+        return [...defaultPlugins, ...plugins];
+    }, [plugins]);
+    const editorContent = (_jsxs(_Fragment, { children: [_jsx("div", { className: "h-screen", children: _jsx(Puck, { config: config, data: dataWithSlug, onChange: handleChange, onPublish: handlePublish, headerTitle: `${pageTitle} /${pageSlug}`, plugins: resolvedPlugins, viewports: enableViewports ? DEFAULT_VIEWPORTS : undefined, overrides: overrides }) }), _jsx(PreviewModal, { isOpen: isPreviewOpen, onClose: () => setIsPreviewOpen(false), data: latestDataRef.current, pageTitle: pageTitle, onOpenInNewTab: handlePreview, layouts: layouts, hasUnsavedChanges: hasUnsavedChanges, onSave: handleSaveFromPreview, isSaving: isSaving })] }));
+    // Wrap with ThemeProvider if theme is provided
+    if (theme) {
+        return _jsx(ThemeProvider, { theme: theme, children: editorContent });
+    }
+    return editorContent;
+}
+//# sourceMappingURL=PuckEditorCore.client.js.map

package/dist/editor/PuckEditorCore.client.js.map

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

package/dist/editor/components/HeaderActions.d.ts

@@ -0,0 +1,109 @@
+import { type ReactNode } from 'react';
+import { type Data } from '@measured/puck';
+export interface HeaderActionsProps {
+    /**
+     * Default Puck header actions (undo/redo, publish button)
+     */
+    children: ReactNode;
+    /**
+     * Handler for back button click
+     */
+    onBack: () => void;
+    /**
+     * Handler for preview button click
+     */
+    onPreview: () => void;
+    /**
+     * Handler for save button click
+     */
+    onSave: (data: Data) => void;
+    /**
+     * Handler for publish button click (optional, uses default Puck publish if not provided)
+     */
+    onPublish?: (data: Data) => void;
+    /**
+     * Whether a save operation is in progress
+     */
+    isSaving: boolean;
+    /**
+     * Whether there are unsaved changes
+     */
+    hasUnsavedChanges: boolean;
+    /**
+     * Last saved timestamp
+     */
+    lastSaved: Date | null;
+    /**
+     * Document status from Payload (_status field)
+     * Shows visual indicator for draft vs published
+     */
+    documentStatus?: 'draft' | 'published';
+    /**
+     * Whether the document has ever been published (initially or during this session)
+     * Used to show "Unpublished Changes" vs "Draft" badge
+     */
+    wasPublished?: boolean;
+    /**
+     * Custom actions to render at the start of the header
+     */
+    actionsStart?: ReactNode;
+    /**
+     * Custom actions to render at the end of the header (before publish)
+     */
+    actionsEnd?: ReactNode;
+    /**
+     * Whether to show the save draft button
+     * @default true
+     */
+    showSaveDraft?: boolean;
+    /**
+     * Whether to show the view page button
+     * @default true
+     */
+    showViewPage?: boolean;
+    /**
+     * Whether to show the interactive mode toggle
+     * @default false
+     * @deprecated Use the Preview button instead
+     */
+    showInteractiveToggle?: boolean;
+    /**
+     * Whether to show the preview button
+     * @default true
+     */
+    showPreviewButton?: boolean;
+    /**
+     * Handler for opening the preview modal
+     */
+    onOpenPreview?: () => void;
+    /**
+     * Whether to show the version history button
+     * @default true
+     */
+    showVersionHistory?: boolean;
+    /**
+     * Page ID for version history (required if showVersionHistory is true)
+     */
+    pageId?: string;
+    /**
+     * API endpoint base path for version history
+     * @default '/api/puck/pages'
+     */
+    apiEndpoint?: string;
+    /**
+     * Error message to display (e.g., validation errors)
+     */
+    saveError?: string | null;
+    /**
+     * Handler to dismiss the error message
+     */
+    onDismissError?: () => void;
+}
+/**
+ * Custom header actions component for the Puck editor
+ *
+ * Provides standard actions: Back, Edit/Interactive toggle, View Page, Save Draft
+ * Also displays save status and last saved time.
+ */
+export declare const HeaderActions: import("react").NamedExoticComponent<HeaderActionsProps>;
+//# sourceMappingURL=HeaderActions.d.ts.map

package/dist/editor/components/HeaderActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeaderActions.d.ts","sourceRoot":"","sources":["../../../src/editor/components/HeaderActions.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAA;AAC7E,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAmBzD,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAChC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAC1B;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;IACtC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAC5B;AAwLD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,0DA0QxB,CAAA"}