@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/config/presets.js

@@ -0,0 +1,247 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+// Import component configs
+import { ContainerConfig, FlexConfig, GridConfig, SectionConfig, SpacerConfig, TemplateConfig, HeadingConfig, TextConfig, RichTextEditorConfig, ImageConfig, ButtonConfig, CardConfig, DividerConfig, AccordionConfig, } from '../components/exports.js';
+// Import field factories for root config
+import { createBackgroundField } from '../fields/BackgroundField.js';
+import { lockedSlugField, lockedHomepageField } from '../fields/LockedField.js';
+import { createFolderPickerField } from '../fields/FolderPickerField.js';
+import { createPageSegmentField } from '../fields/PageSegmentField.js';
+import { createSlugPreviewField } from '../fields/SlugPreviewField.js';
+/**
+ * Default root configuration used by presets
+ */
+export const defaultRoot = {
+    fields: {
+        // Page identity (locked fields)
+        slug: lockedSlugField,
+        isHomepage: lockedHomepageField,
+        // Page settings
+        title: {
+            type: 'text',
+            label: 'Page Title',
+        },
+        pageLayout: {
+            type: 'select',
+            label: 'Page Layout',
+            options: [
+                { label: 'Default', value: 'default' },
+                { label: 'Landing', value: 'landing' },
+                { label: 'Full Width', value: 'full-width' },
+            ],
+        },
+        // Page-level overrides
+        showHeader: {
+            type: 'radio',
+            label: 'Show Header',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Show', value: 'show' },
+                { label: 'Hide', value: 'hide' },
+            ],
+        },
+        showFooter: {
+            type: 'radio',
+            label: 'Show Footer',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Show', value: 'show' },
+                { label: 'Hide', value: 'hide' },
+            ],
+        },
+        pageBackground: createBackgroundField({
+            label: 'Page Background',
+        }),
+        pageMaxWidth: {
+            type: 'select',
+            label: 'Page Width',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Narrow (720px)', value: '720px' },
+                { label: 'Standard (1000px)', value: '1000px' },
+                { label: 'Wide (1200px)', value: '1200px' },
+                { label: 'Extra Wide (1400px)', value: '1400px' },
+                { label: 'Full Width', value: '100%' },
+            ],
+        },
+    },
+    defaultProps: {
+        slug: '',
+        isHomepage: false,
+        title: 'New Page',
+        pageLayout: 'default',
+        showHeader: 'default',
+        showFooter: 'default',
+        pageBackground: null,
+        pageMaxWidth: 'default',
+    },
+    render: ({ children }) => _jsx(_Fragment, { children: children }),
+};
+/**
+ * Root configuration for use with @delmaredigital/payload-page-tree
+ *
+ * Replaces the standard locked slug field with:
+ * - Folder picker (select which folder the page belongs to)
+ * - Page segment (editable URL segment for this page)
+ * - Slug preview (read-only computed URL)
+ *
+ * @example
+ * ```tsx
+ * import { pageTreeRoot, fullConfig, extendConfig } from '@delmaredigital/payload-puck/config'
+ *
+ * export const puckConfig = extendConfig({
+ *   base: fullConfig,
+ *   root: pageTreeRoot,
+ * })
+ * ```
+ */
+export const pageTreeRoot = {
+    fields: {
+        // Page identity
+        title: {
+            type: 'text',
+            label: 'Page Title',
+        },
+        // Page-tree specific fields
+        folder: createFolderPickerField({ label: 'Folder' }),
+        pageSegment: createPageSegmentField({ label: 'Page Segment' }),
+        slug: createSlugPreviewField({
+            label: 'URL Slug',
+            hint: 'Auto-generated from folder + page segment',
+        }),
+        isHomepage: lockedHomepageField,
+        // Page settings
+        pageLayout: {
+            type: 'select',
+            label: 'Page Layout',
+            options: [
+                { label: 'Default', value: 'default' },
+                { label: 'Landing', value: 'landing' },
+                { label: 'Full Width', value: 'full-width' },
+            ],
+        },
+        // Page-level overrides
+        showHeader: {
+            type: 'radio',
+            label: 'Show Header',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Show', value: 'show' },
+                { label: 'Hide', value: 'hide' },
+            ],
+        },
+        showFooter: {
+            type: 'radio',
+            label: 'Show Footer',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Show', value: 'show' },
+                { label: 'Hide', value: 'hide' },
+            ],
+        },
+        pageBackground: createBackgroundField({
+            label: 'Page Background',
+        }),
+        pageMaxWidth: {
+            type: 'select',
+            label: 'Page Width',
+            options: [
+                { label: 'Use Layout Default', value: 'default' },
+                { label: 'Narrow (720px)', value: '720px' },
+                { label: 'Standard (1000px)', value: '1000px' },
+                { label: 'Wide (1200px)', value: '1200px' },
+                { label: 'Extra Wide (1400px)', value: '1400px' },
+                { label: 'Full Width', value: '100%' },
+            ],
+        },
+    },
+    defaultProps: {
+        title: 'New Page',
+        folder: null,
+        pageSegment: '',
+        slug: '',
+        isHomepage: false,
+        pageLayout: 'default',
+        showHeader: 'default',
+        showFooter: 'default',
+        pageBackground: null,
+        pageMaxWidth: 'default',
+    },
+    render: ({ children }) => _jsx(_Fragment, { children: children }),
+};
+/**
+ * Full configuration with all built-in components
+ *
+ * Use this as a base and extend with custom components via `extendConfig()`.
+ */
+export const fullConfig = {
+    root: defaultRoot,
+    categories: {
+        layout: {
+            title: 'Layout',
+            components: ['Container', 'Flex', 'Grid', 'Section', 'Spacer', 'Template'],
+            defaultExpanded: true,
+        },
+        typography: {
+            title: 'Typography',
+            components: ['Heading', 'Text', 'RichText'],
+        },
+        media: {
+            title: 'Media',
+            components: ['Image'],
+        },
+        interactive: {
+            title: 'Interactive',
+            components: ['Button', 'Card', 'Divider', 'Accordion'],
+        },
+    },
+    components: {
+        // Layout
+        Container: ContainerConfig,
+        Flex: FlexConfig,
+        Grid: GridConfig,
+        Section: SectionConfig,
+        Spacer: SpacerConfig,
+        Template: TemplateConfig,
+        // Typography
+        Heading: HeadingConfig,
+        Text: TextConfig,
+        RichText: RichTextEditorConfig,
+        // Media
+        Image: ImageConfig,
+        // Interactive
+        Button: ButtonConfig,
+        Card: CardConfig,
+        Divider: DividerConfig,
+        Accordion: AccordionConfig,
+    },
+};
+/**
+ * Minimal configuration with essential components only
+ *
+ * Good for simple landing pages or when you want a cleaner editor sidebar.
+ */
+export const minimalConfig = {
+    root: defaultRoot,
+    categories: {
+        layout: {
+            title: 'Layout',
+            components: ['Section'],
+            defaultExpanded: true,
+        },
+        content: {
+            title: 'Content',
+            components: ['Heading', 'Text', 'Image', 'Button'],
+        },
+    },
+    components: {
+        Section: SectionConfig,
+        Heading: HeadingConfig,
+        Text: TextConfig,
+        Image: ImageConfig,
+        Button: ButtonConfig,
+    },
+};
+// Re-export mergeConfigs as extendConfig for convenience
+export { mergeConfigs, mergeConfigs as extendConfig } from './merge.js';
+//# sourceMappingURL=presets.js.map

package/dist/config/presets.js.map

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

package/dist/editor/PuckEditor.client.d.ts

@@ -0,0 +1,131 @@
+import type { Config as PuckConfig, Data, Plugin as PuckPlugin, Overrides as PuckOverrides } from '@measured/puck';
+import type { ReactNode } from 'react';
+import type { LayoutStyle } from './components/IframeWrapper';
+import type { ThemeConfig } from '../theme';
+import type { LayoutDefinition } from '../layouts';
+export interface PuckEditorProps {
+    /**
+     * Page ID for save operations
+     */
+    pageId: string;
+    /**
+     * Initial Puck data to load
+     */
+    initialData: Data;
+    /**
+     * Puck configuration with components and settings
+     */
+    config: PuckConfig;
+    /**
+     * Page title for display
+     */
+    pageTitle: string;
+    /**
+     * Page slug for preview URL
+     */
+    pageSlug: string;
+    /**
+     * API endpoint for save operations
+     * @default '/api/puck/pages'
+     */
+    apiEndpoint?: string;
+    /**
+     * URL to navigate to when back button is clicked
+     */
+    backUrl?: string;
+    /**
+     * Preview URL or function to generate preview URL from slug
+     */
+    previewUrl?: string | ((slug: string) => string);
+    /**
+     * Whether to enable viewport switching
+     * @default true
+     */
+    enableViewports?: boolean;
+    /**
+     * Additional Puck plugins to use.
+     * The headingAnalyzer plugin is included by default.
+     * Set to `false` to disable all default plugins.
+     */
+    plugins?: PuckPlugin[] | false;
+    /**
+     * Layout definitions for the editor preview.
+     * The editor reads header, footer, editorBackground, and editorDarkMode
+     * from the layout definition matching the selected pageLayout.
+     */
+    layouts?: LayoutDefinition[];
+    /**
+     * Layout style configurations for theme-aware preview
+     * @deprecated Use `layouts` prop instead. layoutStyles will be removed in a future version.
+     */
+    layoutStyles?: Record<string, LayoutStyle>;
+    /**
+     * Key in root.props to read layout value from
+     * @default 'pageLayout'
+     */
+    layoutKey?: string;
+    /**
+     * Custom actions to render at the start of the header
+     */
+    headerActionsStart?: ReactNode;
+    /**
+     * Custom actions to render at the end of the header
+     */
+    headerActionsEnd?: ReactNode;
+    /**
+     * Puck overrides to merge with defaults
+     */
+    overrides?: Partial<PuckOverrides>;
+    /**
+     * Callback on successful save
+     */
+    onSaveSuccess?: (data: Data) => void;
+    /**
+     * Callback on save error
+     */
+    onSaveError?: (error: Error) => void;
+    /**
+     * Callback when data changes
+     */
+    onChange?: (data: Data) => void;
+    /**
+     * Initial document status from Payload (_status field)
+     * Automatically populated when using PuckEditorView
+     */
+    initialStatus?: 'draft' | 'published';
+    /**
+     * Theme configuration for customizing component styles
+     * When provided, components will use themed styles
+     */
+    theme?: ThemeConfig;
+}
+/**
+ * Puck Editor wrapper with dynamic import
+ *
+ * This component wraps PuckEditorCore with next/dynamic to prevent
+ * hydration mismatches caused by Puck's random ID generation for
+ * drag-and-drop functionality.
+ *
+ * @example
+ * ```tsx
+ * 'use client'
+ *
+ * import { PuckEditor } from '@delmaredigital/payload-puck/editor'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export function PageEditor({ page }) {
+ *   return (
+ *     <PuckEditor
+ *       pageId={page.id}
+ *       initialData={page.puckData}
+ *       config={editorConfig}
+ *       pageTitle={page.title}
+ *       pageSlug={page.slug}
+ *       backUrl="/admin/pages"
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export declare function PuckEditor({ pageId, initialData, config, pageTitle, pageSlug, apiEndpoint, backUrl, previewUrl, enableViewports, plugins, layouts, layoutStyles, layoutKey, headerActionsStart, headerActionsEnd, overrides, onSaveSuccess, onSaveError, onChange, initialStatus, theme, }: PuckEditorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PuckEditor.client.d.ts.map

package/dist/editor/PuckEditor.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckEditor.client.d.ts","sourceRoot":"","sources":["../../src/editor/PuckEditor.client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,UAAU,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAClH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAalD,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,WAAW,EAAE,IAAI,CAAA;IACjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAA;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,SAAS,CAAA;IAC9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;IAErC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,eAAe,EACf,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,KAAK,GACN,EAAE,eAAe,2CA0BjB"}

package/dist/editor/PuckEditor.client.js

@@ -0,0 +1,42 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import dynamic from 'next/dynamic';
+import { LoadingState } from './components/LoadingState';
+// Dynamic import with ssr: false to prevent hydration mismatch
+// Puck generates random IDs for drag-and-drop that differ between server/client
+const PuckEditorCore = dynamic(() => import('./PuckEditorCore.client').then((mod) => mod.PuckEditorCore), {
+    ssr: false,
+    loading: () => _jsx(LoadingState, {}),
+});
+/**
+ * Puck Editor wrapper with dynamic import
+ *
+ * This component wraps PuckEditorCore with next/dynamic to prevent
+ * hydration mismatches caused by Puck's random ID generation for
+ * drag-and-drop functionality.
+ *
+ * @example
+ * ```tsx
+ * 'use client'
+ *
+ * import { PuckEditor } from '@delmaredigital/payload-puck/editor'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export function PageEditor({ page }) {
+ *   return (
+ *     <PuckEditor
+ *       pageId={page.id}
+ *       initialData={page.puckData}
+ *       config={editorConfig}
+ *       pageTitle={page.title}
+ *       pageSlug={page.slug}
+ *       backUrl="/admin/pages"
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export function PuckEditor({ pageId, initialData, config, pageTitle, pageSlug, apiEndpoint, backUrl, previewUrl, enableViewports, plugins, layouts, layoutStyles, layoutKey, headerActionsStart, headerActionsEnd, overrides, onSaveSuccess, onSaveError, onChange, initialStatus, theme, }) {
+    return (_jsx(PuckEditorCore, { pageId: pageId, initialData: initialData, config: config, pageTitle: pageTitle, pageSlug: pageSlug, apiEndpoint: apiEndpoint, backUrl: backUrl, previewUrl: previewUrl, enableViewports: enableViewports, plugins: plugins, layouts: layouts, layoutStyles: layoutStyles, layoutKey: layoutKey, headerActionsStart: headerActionsStart, headerActionsEnd: headerActionsEnd, overrides: overrides, onSaveSuccess: onSaveSuccess, onSaveError: onSaveError, onChange: onChange, initialStatus: initialStatus, theme: theme }));
+}
+//# sourceMappingURL=PuckEditor.client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PuckEditor.client.js","sourceRoot":"","sources":["../../src/editor/PuckEditor.client.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,OAAO,MAAM,cAAc,CAAA;AAMlC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,+DAA+D;AAC/D,gFAAgF;AAChF,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,EACzE;IACE,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,GAAG,EAAE,CAAC,KAAC,YAAY,KAAG;CAChC,CACF,CAAA;AAoGD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,EACV,eAAe,EACf,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,KAAK,GACW;IAChB,OAAO,CACL,KAAC,cAAc,IACb,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,KAAK,GACZ,CACH,CAAA;AACH,CAAC"}

package/dist/editor/PuckEditorCore.client.d.ts

@@ -0,0 +1,141 @@
+import { type ReactNode } from 'react';
+import { type Config as PuckConfig, type Data, type Plugin as PuckPlugin, type Overrides as PuckOverrides } from '@measured/puck';
+import '@measured/puck/puck.css';
+import '@measured/puck-plugin-heading-analyzer/dist/index.css';
+import { type LayoutStyle } from './components/IframeWrapper';
+import { type ThemeConfig } from '../theme';
+import type { LayoutDefinition } from '../layouts';
+export interface PuckEditorCoreProps {
+    /**
+     * Page ID for save operations
+     */
+    pageId: string;
+    /**
+     * Initial Puck data to load
+     */
+    initialData: Data;
+    /**
+     * Puck configuration with components and settings
+     */
+    config: PuckConfig;
+    /**
+     * Page title for display
+     */
+    pageTitle: string;
+    /**
+     * Page slug for preview URL
+     */
+    pageSlug: string;
+    /**
+     * API endpoint for save operations
+     * @default '/api/puck/pages'
+     */
+    apiEndpoint?: string;
+    /**
+     * URL to navigate to when back button is clicked
+     */
+    backUrl?: string;
+    /**
+     * Preview URL or function to generate preview URL from slug
+     */
+    previewUrl?: string | ((slug: string) => string);
+    /**
+     * Whether to enable viewport switching
+     * @default true
+     */
+    enableViewports?: boolean;
+    /**
+     * Additional Puck plugins to use.
+     * The headingAnalyzer plugin is included by default.
+     * Set to `false` to disable all default plugins.
+     */
+    plugins?: PuckPlugin[] | false;
+    /**
+     * Layout definitions for the editor preview.
+     * The editor reads header, footer, editorBackground, and editorDarkMode
+     * from the layout definition matching the selected pageLayout.
+     */
+    layouts?: LayoutDefinition[];
+    /**
+     * Layout style configurations for theme-aware preview
+     * @deprecated Use `layouts` prop instead. layoutStyles will be removed in a future version.
+     */
+    layoutStyles?: Record<string, LayoutStyle>;
+    /**
+     * Key in root.props to read layout value from
+     * @default 'pageLayout'
+     */
+    layoutKey?: string;
+    /**
+     * Custom actions to render at the start of the header
+     */
+    headerActionsStart?: ReactNode;
+    /**
+     * Custom actions to render at the end of the header
+     */
+    headerActionsEnd?: ReactNode;
+    /**
+     * Puck overrides to merge with defaults
+     */
+    overrides?: Partial<PuckOverrides>;
+    /**
+     * Callback on successful save
+     */
+    onSaveSuccess?: (data: Data) => void;
+    /**
+     * Callback on save error
+     */
+    onSaveError?: (error: Error) => void;
+    /**
+     * Callback when data changes
+     */
+    onChange?: (data: Data) => void;
+    /**
+     * Initial document status from Payload (_status field)
+     * Used to show draft/published badge in the header
+     */
+    initialStatus?: 'draft' | 'published';
+    /**
+     * Theme configuration for customizing component styles
+     * When provided, components will use themed styles
+     */
+    theme?: ThemeConfig;
+}
+/**
+ * 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 declare function PuckEditorCore({ pageId, initialData, config, pageTitle, pageSlug, apiEndpoint, backUrl, previewUrl, enableViewports, plugins, layouts, layoutStyles, layoutKey, headerActionsStart, headerActionsEnd, overrides: customOverrides, onSaveSuccess, onSaveError, onChange: onChangeProp, initialStatus, theme, }: PuckEditorCoreProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PuckEditorCore.client.d.ts.map

package/dist/editor/PuckEditorCore.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckEditorCore.client.d.ts","sourceRoot":"","sources":["../../src/editor/PuckEditorCore.client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE9E,OAAO,EAAQ,KAAK,MAAM,IAAI,UAAU,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,KAAK,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACvI,OAAO,yBAAyB,CAAA;AAEhC,OAAO,uDAAuD,CAAA;AAG9D,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAG5E,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AA2ClD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,WAAW,EAAE,IAAI,CAAA;IACjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAA;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAA;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,SAAS,CAAA;IAC9B;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;IAErC;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,EACR,WAA+B,EAC/B,OAAO,EACP,UAAU,EACV,eAAsB,EACtB,OAAO,EACP,OAAO,EACP,YAAY,EACZ,SAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EAAE,eAAe,EAC1B,aAAa,EACb,WAAW,EACX,QAAQ,EAAE,YAAY,EACtB,aAAa,EACb,KAAK,GACN,EAAE,mBAAmB,2CAiTrB"}