@delmaredigital/payload-puck 0.6.12 → 0.6.14

package/dist/utils/migration.js

@@ -3,15 +3,13 @@
  *
  * This utility converts legacy Payload CMS page block structures to the
  * Puck visual editor format, enabling seamless migration of existing content.
- */
-// =============================================================================
+ */ // =============================================================================
 // Block Type Mapping
 // =============================================================================
 /**
  * Maps legacy Payload block types (camelCase) to Puck component types (PascalCase).
  * Extend this map to support additional custom block types.
- */
-export const blockTypeMap = {
+ */ export const blockTypeMap = {
     heroBlock: 'Hero',
     richTextBlock: 'RichText',
     containerBlock: 'Container',
@@ -25,7 +23,7 @@ export const blockTypeMap = {
     buttonBlock: 'Button',
     cardBlock: 'Card',
     dividerBlock: 'Divider',
-    accordionBlock: 'Accordion',
+    accordionBlock: 'Accordion'
 };
 // =============================================================================
 // ID Generation
@@ -33,8 +31,7 @@ export const blockTypeMap = {
 /**
  * Generates a unique ID for Puck content items.
  * Uses a format compatible with Puck's internal ID scheme.
- */
-export function generatePuckId(legacyId) {
+ */ export function generatePuckId(legacyId) {
     if (legacyId) {
         return legacyId;
     }
@@ -47,14 +44,15 @@ export function generatePuckId(legacyId) {
 /**
  * Transforms a Payload media reference (ID or Media object) to Puck MediaReference format.
  * Handles both ID-only references and full Media objects.
- */
-export function transformMediaReference(media) {
+ */ export function transformMediaReference(media) {
     if (media === null || media === undefined) {
         return null;
     }
     if (typeof media === 'number' || typeof media === 'string') {
         // Just an ID reference - Puck will need to fetch the full media
-        return { id: media };
+        return {
+            id: media
+        };
     }
     // Full media object
     return {
@@ -62,14 +60,13 @@ export function transformMediaReference(media) {
         url: media.url,
         alt: media.alt,
         width: media.width,
-        height: media.height,
+        height: media.height
     };
 }
 /**
  * Transforms Lexical rich text content to a serialized string format.
  * Puck stores rich text as JSON strings for the custom editors.
- */
-export function transformRichText(richText) {
+ */ export function transformRichText(richText) {
     if (!richText) {
         return undefined;
     }
@@ -81,8 +78,7 @@ export function transformRichText(richText) {
     if (typeof richText === 'object') {
         try {
             return JSON.stringify(richText);
-        }
-        catch {
+        } catch  {
             console.warn('[payload-puck] Failed to serialize rich text content');
             return undefined;
         }
@@ -91,19 +87,22 @@ export function transformRichText(richText) {
 }
 /**
  * Transforms an array of relationships to Puck format.
- */
-export function transformRelationshipArray(relations) {
+ */ export function transformRelationshipArray(relations) {
     if (!relations || !Array.isArray(relations)) {
         return undefined;
     }
-    return relations.map((rel) => {
+    return relations.map((rel)=>{
         if (typeof rel === 'number' || typeof rel === 'string') {
-            return { id: rel, title: '' }; // Title will need to be fetched
+            return {
+                id: rel,
+                title: ''
+            } // Title will need to be fetched
+            ;
         }
         return {
             id: rel.id,
             title: rel.title || '',
-            slug: rel.slug,
+            slug: rel.slug
         };
     });
 }
@@ -112,8 +111,7 @@ export function transformRelationshipArray(relations) {
 // =============================================================================
 /**
  * Known rich text field names in legacy blocks
- */
-const RICH_TEXT_FIELDS = [
+ */ const RICH_TEXT_FIELDS = [
     'headingRich',
     'subheadingRich',
     'textRich',
@@ -121,12 +119,11 @@ const RICH_TEXT_FIELDS = [
     'leftContent',
     'rightContent',
     'bodyContent',
-    'description',
+    'description'
 ];
 /**
  * Known media field names in legacy blocks
- */
-const MEDIA_FIELDS = [
+ */ const MEDIA_FIELDS = [
     'backgroundImage',
     'image',
     'rightImage',
@@ -134,22 +131,21 @@ const MEDIA_FIELDS = [
     'profileImage',
     'media',
     'thumbnail',
-    'icon',
+    'icon'
 ];
 /**
  * Transform props for a specific block type.
  * Handles any block-specific transformations needed.
- */
-export function transformBlockProps(block, options) {
+ */ export function transformBlockProps(block, options) {
     const { blockType, id, blockName, ...restProps } = block;
     const richTextFields = options?.richTextFields || RICH_TEXT_FIELDS;
     const mediaFields = options?.mediaFields || MEDIA_FIELDS;
     const customTransformers = options?.customTransformers || {};
     const props = {
-        id: generatePuckId(id),
+        id: generatePuckId(id)
     };
     // Process each prop based on known patterns
-    for (const [key, value] of Object.entries(restProps)) {
+    for (const [key, value] of Object.entries(restProps)){
         // Check for custom transformer first
         if (customTransformers[key]) {
             props[key] = customTransformers[key](value);
@@ -167,12 +163,12 @@ export function transformBlockProps(block, options) {
         }
         // Array fields that need ID generation for items
         if (Array.isArray(value)) {
-            props[key] = value.map((item) => {
+            props[key] = value.map((item)=>{
                 if (typeof item === 'object' && item !== null) {
                     const { id: itemId, ...itemRest } = item;
                     return {
                         ...itemRest,
-                        id: itemId || generatePuckId(),
+                        id: itemId || generatePuckId()
                     };
                 }
                 return item;
@@ -207,23 +203,22 @@ export function transformBlockProps(block, options) {
  *   data: { puckData },
  * })
  * ```
- */
-export function migrateLegacyToPuck(page, options = {}) {
-    const { blockTypeMap: customBlockTypeMap, richTextFields, mediaFields, customTransformers, skipUnknownBlocks = true, onUnknownBlock, } = options;
+ */ export function migrateLegacyToPuck(page, options = {}) {
+    const { blockTypeMap: customBlockTypeMap, richTextFields, mediaFields, customTransformers, skipUnknownBlocks = true, onUnknownBlock } = options;
     // Merge custom block type map with defaults
     const effectiveBlockTypeMap = {
         ...blockTypeMap,
-        ...customBlockTypeMap,
+        ...customBlockTypeMap
     };
     // Build root props
     const rootProps = {
         title: page.title,
-        pageLayout: page.pageLayout || 'default',
+        pageLayout: page.pageLayout || 'default'
     };
     // Convert layout blocks to Puck content items
     const content = [];
     if (page.layout && Array.isArray(page.layout)) {
-        for (const block of page.layout) {
+        for (const block of page.layout){
             const legacyBlock = block;
             // Get the Puck component type from the legacy block type
             const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
@@ -246,12 +241,12 @@ export function migrateLegacyToPuck(page, options = {}) {
             const transformedProps = transformBlockProps(legacyBlock, {
                 richTextFields,
                 mediaFields,
-                customTransformers,
+                customTransformers
             });
             // Create the Puck content item
             const contentItem = {
                 type: puckType,
-                props: transformedProps,
+                props: transformedProps
             };
             content.push(contentItem);
         }
@@ -259,10 +254,10 @@ export function migrateLegacyToPuck(page, options = {}) {
     // Build the complete Puck data structure
     const puckData = {
         root: {
-            props: rootProps,
+            props: rootProps
         },
         content,
-        zones: {},
+        zones: {}
     };
     return puckData;
 }
@@ -273,23 +268,21 @@ export function migrateLegacyToPuck(page, options = {}) {
  * @param page - The legacy page to preview
  * @param customBlockTypeMap - Optional custom block type mapping
  * @returns Preview information about the migration
- */
-export function getMigrationPreview(page, customBlockTypeMap) {
+ */ export function getMigrationPreview(page, customBlockTypeMap) {
     const warnings = [];
     const blockTypes = [];
     const unmappedBlockTypes = [];
     const effectiveBlockTypeMap = {
         ...blockTypeMap,
-        ...customBlockTypeMap,
+        ...customBlockTypeMap
     };
     if (page.layout && Array.isArray(page.layout)) {
-        for (const block of page.layout) {
+        for (const block of page.layout){
             const legacyBlock = block;
             const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
             if (puckType) {
                 blockTypes.push(puckType);
-            }
-            else {
+            } else {
                 warnings.push(`Unknown block type: ${legacyBlock.blockType}`);
                 if (!unmappedBlockTypes.includes(legacyBlock.blockType)) {
                     unmappedBlockTypes.push(legacyBlock.blockType);
@@ -303,7 +296,6 @@ export function getMigrationPreview(page, customBlockTypeMap) {
         blockCount: page.layout?.length || 0,
         blockTypes,
         warnings,
-        unmappedBlockTypes,
+        unmappedBlockTypes
     };
 }
-//# sourceMappingURL=migration.js.map

package/dist/utils/validation.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides validation functions for ensuring Puck data structures are well-formed.
  */
-import type { PuckPageData, PuckRootProps } from '../types';
+import type { PuckPageData, PuckRootProps } from '../types/index.js';
 /**
  * Result of a validation operation
  */
@@ -86,4 +86,3 @@ export declare function assertPuckData(data: unknown, options?: ValidationOption
 export declare function parsePuckDataJson(json: string, options?: ValidationOptions): ValidationResult & {
     data?: PuckPageData;
 };
-//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.js

@@ -2,15 +2,13 @@
  * Puck Data Validation Utilities
  *
  * Provides validation functions for ensuring Puck data structures are well-formed.
- */
-// =============================================================================
+ */ // =============================================================================
 // Type Guards
 // =============================================================================
 /**
  * Type guard to check if a value is a valid PuckPageData structure.
  * Performs basic structural validation.
- */
-export function isPuckData(data) {
+ */ export function isPuckData(data) {
     if (!data || typeof data !== 'object') {
         return false;
     }
@@ -28,7 +26,7 @@ export function isPuckData(data) {
         return false;
     }
     // Validate each content item has required fields
-    for (const item of obj.content) {
+    for (const item of obj.content){
         if (!item || typeof item !== 'object') {
             return false;
         }
@@ -48,8 +46,7 @@ export function isPuckData(data) {
 }
 /**
  * Type guard for PuckRootProps
- */
-export function isPuckRootProps(props) {
+ */ export function isPuckRootProps(props) {
     if (!props || typeof props !== 'object') {
         return false;
     }
@@ -73,15 +70,20 @@ export function isPuckRootProps(props) {
  *   console.error('Validation errors:', result.errors)
  * }
  * ```
- */
-export function validatePuckData(data, options = {}) {
-    const { requireContentIds = true, validateRoot = true, requiredRootProps = ['title'], allowedComponentTypes, strictComponentTypes = false, } = options;
+ */ export function validatePuckData(data, options = {}) {
+    const { requireContentIds = true, validateRoot = true, requiredRootProps = [
+        'title'
+    ], allowedComponentTypes, strictComponentTypes = false } = options;
     const errors = [];
     const warnings = [];
     // Basic type check
     if (!data || typeof data !== 'object') {
         errors.push('Data must be a non-null object');
-        return { valid: false, errors, warnings };
+        return {
+            valid: false,
+            errors,
+            warnings
+        };
     }
     const obj = data;
     // ==========================================================================
@@ -89,16 +91,14 @@ export function validatePuckData(data, options = {}) {
     // ==========================================================================
     if (!obj.root || typeof obj.root !== 'object') {
         errors.push('Missing or invalid root object');
-    }
-    else if (validateRoot) {
+    } else if (validateRoot) {
         const root = obj.root;
         if (!root.props || typeof root.props !== 'object') {
             errors.push('Missing root.props object');
-        }
-        else {
+        } else {
             const rootProps = root.props;
             // Check required root props
-            for (const prop of requiredRootProps) {
+            for (const prop of requiredRootProps){
                 if (rootProps[prop] === undefined || rootProps[prop] === null) {
                     errors.push(`Missing required root prop: ${prop}`);
                 }
@@ -116,10 +116,9 @@ export function validatePuckData(data, options = {}) {
     // ==========================================================================
     if (!Array.isArray(obj.content)) {
         errors.push('content must be an array');
-    }
-    else {
+    } else {
         const seenIds = new Set();
-        obj.content.forEach((item, index) => {
+        obj.content.forEach((item, index)=>{
             if (!item || typeof item !== 'object') {
                 errors.push(`Content item at index ${index} is not an object`);
                 return;
@@ -128,14 +127,12 @@ export function validatePuckData(data, options = {}) {
             // Validate type
             if (!contentItem.type || typeof contentItem.type !== 'string') {
                 errors.push(`Content item at index ${index} missing or invalid type`);
-            }
-            else if (allowedComponentTypes) {
+            } else if (allowedComponentTypes) {
                 if (!allowedComponentTypes.includes(contentItem.type)) {
                     const message = `Unknown component type "${contentItem.type}" at index ${index}`;
                     if (strictComponentTypes) {
                         errors.push(message);
-                    }
-                    else {
+                    } else {
                         warnings.push(message);
                     }
                 }
@@ -143,13 +140,11 @@ export function validatePuckData(data, options = {}) {
             // Validate props
             if (!contentItem.props || typeof contentItem.props !== 'object') {
                 errors.push(`Content item at index ${index} missing props object`);
-            }
-            else if (requireContentIds) {
+            } else if (requireContentIds) {
                 const props = contentItem.props;
                 if (!props.id || typeof props.id !== 'string') {
                     errors.push(`Content item at index ${index} missing or invalid props.id`);
-                }
-                else {
+                } else {
                     // Check for duplicate IDs
                     if (seenIds.has(props.id)) {
                         warnings.push(`Duplicate content item ID "${props.id}" at index ${index}`);
@@ -165,15 +160,14 @@ export function validatePuckData(data, options = {}) {
     if (obj.zones !== undefined) {
         if (typeof obj.zones !== 'object' || obj.zones === null) {
             errors.push('zones must be an object');
-        }
-        else {
+        } else {
             const zones = obj.zones;
-            for (const [zoneName, zoneContent] of Object.entries(zones)) {
+            for (const [zoneName, zoneContent] of Object.entries(zones)){
                 if (!Array.isArray(zoneContent)) {
                     errors.push(`Zone "${zoneName}" content must be an array`);
                     continue;
                 }
-                zoneContent.forEach((item, index) => {
+                zoneContent.forEach((item, index)=>{
                     if (!item || typeof item !== 'object') {
                         errors.push(`Zone "${zoneName}" item at index ${index} is not an object`);
                         return;
@@ -184,8 +178,7 @@ export function validatePuckData(data, options = {}) {
                     }
                     if (!contentItem.props || typeof contentItem.props !== 'object') {
                         errors.push(`Zone "${zoneName}" item at index ${index} missing props object`);
-                    }
-                    else if (requireContentIds) {
+                    } else if (requireContentIds) {
                         const props = contentItem.props;
                         if (!props.id || typeof props.id !== 'string') {
                             errors.push(`Zone "${zoneName}" item at index ${index} missing or invalid props.id`);
@@ -198,7 +191,7 @@ export function validatePuckData(data, options = {}) {
     return {
         valid: errors.length === 0,
         errors,
-        warnings,
+        warnings
     };
 }
 /**
@@ -208,8 +201,7 @@ export function validatePuckData(data, options = {}) {
  * @param options - Validation options
  * @returns The validated PuckPageData
  * @throws Error if validation fails
- */
-export function assertPuckData(data, options) {
+ */ export function assertPuckData(data, options) {
     const result = validatePuckData(data, options);
     if (!result.valid) {
         throw new Error(`Invalid Puck data: ${result.errors.join('; ')}`);
@@ -222,26 +214,25 @@ export function assertPuckData(data, options) {
  * @param json - JSON string to parse
  * @param options - Validation options
  * @returns Validation result with parsed data if valid
- */
-export function parsePuckDataJson(json, options) {
+ */ export function parsePuckDataJson(json, options) {
     let parsed;
     try {
         parsed = JSON.parse(json);
-    }
-    catch (e) {
+    } catch (e) {
         return {
             valid: false,
-            errors: [`Invalid JSON: ${e instanceof Error ? e.message : 'Parse error'}`],
-            warnings: [],
+            errors: [
+                `Invalid JSON: ${e instanceof Error ? e.message : 'Parse error'}`
+            ],
+            warnings: []
         };
     }
     const result = validatePuckData(parsed, options);
     if (result.valid) {
         return {
             ...result,
-            data: parsed,
+            data: parsed
         };
     }
     return result;
 }
-//# sourceMappingURL=validation.js.map

package/dist/version.d.ts

@@ -1,2 +1 @@
-export declare const VERSION = "0.6.12";
-//# sourceMappingURL=version.d.ts.map
+export declare const VERSION = "0.6.14";

package/dist/version.js

@@ -1,3 +1,2 @@
 // Auto-generated by scripts/generate-version.js - do not edit manually
-export const VERSION = '0.6.12';
-//# sourceMappingURL=version.js.map
+export const VERSION = '0.6.14';

package/dist/views/PuckConfigContext.d.ts

@@ -146,7 +146,7 @@ export interface PuckConfigProviderProps {
 /**
  * Provider component that makes Puck configuration available to the editor
  */
-export declare function PuckConfigProvider({ config, layouts, theme, plugins, editorStylesheets, editorCss, children, }: PuckConfigProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function PuckConfigProvider({ config, layouts, theme, plugins, editorStylesheets, editorCss, children, }: PuckConfigProviderProps): import("react").JSX.Element;
 /**
  * Hook to access the Puck configuration
  *
@@ -154,4 +154,3 @@ export declare function PuckConfigProvider({ config, layouts, theme, plugins, ed
  */
 export declare function usePuckConfig(): PuckConfigContextValue;
 export default PuckConfigContext;
-//# sourceMappingURL=PuckConfigContext.d.ts.map

package/dist/views/PuckConfigContext.js

@@ -21,28 +21,41 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *   )
  * }
  * ```
- */
-import { createContext, useContext, useMemo } from 'react';
-const PuckConfigContext = createContext({
-    config: null,
+ */ import { createContext, useContext, useMemo } from 'react';
+const PuckConfigContext = /*#__PURE__*/ createContext({
+    config: null
 });
 /**
  * Provider component that makes Puck configuration available to the editor
- */
-export function PuckConfigProvider({ config, layouts, theme, plugins, editorStylesheets, editorCss, children, }) {
+ */ export function PuckConfigProvider({ config, layouts, theme, plugins, editorStylesheets, editorCss, children }) {
     // Memoize context value to prevent unnecessary re-renders of consumers
     // when the provider re-renders but the values haven't changed
-    const contextValue = useMemo(() => ({ config, layouts, theme, plugins, editorStylesheets, editorCss }), [config, layouts, theme, plugins, editorStylesheets, editorCss]);
-    return (_jsx(PuckConfigContext.Provider, { value: contextValue, children: children }));
+    const contextValue = useMemo(()=>({
+            config,
+            layouts,
+            theme,
+            plugins,
+            editorStylesheets,
+            editorCss
+        }), [
+        config,
+        layouts,
+        theme,
+        plugins,
+        editorStylesheets,
+        editorCss
+    ]);
+    return /*#__PURE__*/ _jsx(PuckConfigContext.Provider, {
+        value: contextValue,
+        children: children
+    });
 }
 /**
  * Hook to access the Puck configuration
  *
  * @throws If used outside of a PuckConfigProvider
- */
-export function usePuckConfig() {
+ */ export function usePuckConfig() {
     const context = useContext(PuckConfigContext);
     return context;
 }
 export default PuckConfigContext;
-//# sourceMappingURL=PuckConfigContext.js.map

package/dist/views/PuckEditorView.d.ts

@@ -14,6 +14,5 @@ export interface PuckEditorViewProps extends AdminViewProps {
  *
  * URL pattern: /admin/puck-editor/:collection/:id
  */
-export declare function PuckEditorView({ initPageResult, params, searchParams, }: PuckEditorViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export declare function PuckEditorView({ initPageResult, params, searchParams, }: PuckEditorViewProps): Promise<import("react").JSX.Element>;
 export default PuckEditorView;
-//# sourceMappingURL=PuckEditorView.d.ts.map