@delmaredigital/payload-puck 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/LICENSE +73 -0
  2. package/README.md +1580 -0
  3. package/dist/AccordionClient.d.mts +24 -0
  4. package/dist/AccordionClient.d.ts +24 -0
  5. package/dist/AccordionClient.js +786 -0
  6. package/dist/AccordionClient.js.map +1 -0
  7. package/dist/AccordionClient.mjs +784 -0
  8. package/dist/AccordionClient.mjs.map +1 -0
  9. package/dist/AnimatedWrapper.d.mts +30 -0
  10. package/dist/AnimatedWrapper.d.ts +30 -0
  11. package/dist/AnimatedWrapper.js +379 -0
  12. package/dist/AnimatedWrapper.js.map +1 -0
  13. package/dist/AnimatedWrapper.mjs +377 -0
  14. package/dist/AnimatedWrapper.mjs.map +1 -0
  15. package/dist/admin/client.d.mts +108 -0
  16. package/dist/admin/client.d.ts +108 -0
  17. package/dist/admin/client.js +177 -0
  18. package/dist/admin/client.js.map +1 -0
  19. package/dist/admin/client.mjs +173 -0
  20. package/dist/admin/client.mjs.map +1 -0
  21. package/dist/admin/index.d.mts +157 -0
  22. package/dist/admin/index.d.ts +157 -0
  23. package/dist/admin/index.js +31 -0
  24. package/dist/admin/index.js.map +1 -0
  25. package/dist/admin/index.mjs +29 -0
  26. package/dist/admin/index.mjs.map +1 -0
  27. package/dist/api/index.d.mts +460 -0
  28. package/dist/api/index.d.ts +460 -0
  29. package/dist/api/index.js +588 -0
  30. package/dist/api/index.js.map +1 -0
  31. package/dist/api/index.mjs +578 -0
  32. package/dist/api/index.mjs.map +1 -0
  33. package/dist/components/index.css +339 -0
  34. package/dist/components/index.css.map +1 -0
  35. package/dist/components/index.d.mts +222 -0
  36. package/dist/components/index.d.ts +222 -0
  37. package/dist/components/index.js +9177 -0
  38. package/dist/components/index.js.map +1 -0
  39. package/dist/components/index.mjs +9130 -0
  40. package/dist/components/index.mjs.map +1 -0
  41. package/dist/config/config.editor.css +339 -0
  42. package/dist/config/config.editor.css.map +1 -0
  43. package/dist/config/config.editor.d.mts +153 -0
  44. package/dist/config/config.editor.d.ts +153 -0
  45. package/dist/config/config.editor.js +9400 -0
  46. package/dist/config/config.editor.js.map +1 -0
  47. package/dist/config/config.editor.mjs +9368 -0
  48. package/dist/config/config.editor.mjs.map +1 -0
  49. package/dist/config/index.d.mts +68 -0
  50. package/dist/config/index.d.ts +68 -0
  51. package/dist/config/index.js +2017 -0
  52. package/dist/config/index.js.map +1 -0
  53. package/dist/config/index.mjs +1991 -0
  54. package/dist/config/index.mjs.map +1 -0
  55. package/dist/editor/index.d.mts +784 -0
  56. package/dist/editor/index.d.ts +784 -0
  57. package/dist/editor/index.js +4517 -0
  58. package/dist/editor/index.js.map +1 -0
  59. package/dist/editor/index.mjs +4483 -0
  60. package/dist/editor/index.mjs.map +1 -0
  61. package/dist/fields/index.css +339 -0
  62. package/dist/fields/index.css.map +1 -0
  63. package/dist/fields/index.d.mts +600 -0
  64. package/dist/fields/index.d.ts +600 -0
  65. package/dist/fields/index.js +7739 -0
  66. package/dist/fields/index.js.map +1 -0
  67. package/dist/fields/index.mjs +7590 -0
  68. package/dist/fields/index.mjs.map +1 -0
  69. package/dist/index-CQu6SzDg.d.mts +327 -0
  70. package/dist/index-CoUQnyC3.d.ts +327 -0
  71. package/dist/index.d.mts +6 -0
  72. package/dist/index.d.ts +6 -0
  73. package/dist/index.js +569 -0
  74. package/dist/index.js.map +1 -0
  75. package/dist/index.mjs +555 -0
  76. package/dist/index.mjs.map +1 -0
  77. package/dist/layouts/index.d.mts +96 -0
  78. package/dist/layouts/index.d.ts +96 -0
  79. package/dist/layouts/index.js +394 -0
  80. package/dist/layouts/index.js.map +1 -0
  81. package/dist/layouts/index.mjs +378 -0
  82. package/dist/layouts/index.mjs.map +1 -0
  83. package/dist/plugin/index.d.mts +289 -0
  84. package/dist/plugin/index.d.ts +289 -0
  85. package/dist/plugin/index.js +569 -0
  86. package/dist/plugin/index.js.map +1 -0
  87. package/dist/plugin/index.mjs +555 -0
  88. package/dist/plugin/index.mjs.map +1 -0
  89. package/dist/render/index.d.mts +109 -0
  90. package/dist/render/index.d.ts +109 -0
  91. package/dist/render/index.js +2146 -0
  92. package/dist/render/index.js.map +1 -0
  93. package/dist/render/index.mjs +2123 -0
  94. package/dist/render/index.mjs.map +1 -0
  95. package/dist/shared-DMAF1AcH.d.mts +545 -0
  96. package/dist/shared-DMAF1AcH.d.ts +545 -0
  97. package/dist/theme/index.d.mts +155 -0
  98. package/dist/theme/index.d.ts +155 -0
  99. package/dist/theme/index.js +201 -0
  100. package/dist/theme/index.js.map +1 -0
  101. package/dist/theme/index.mjs +186 -0
  102. package/dist/theme/index.mjs.map +1 -0
  103. package/dist/types-D7D3rZ1J.d.mts +116 -0
  104. package/dist/types-D7D3rZ1J.d.ts +116 -0
  105. package/dist/types-_6MvjyKv.d.mts +104 -0
  106. package/dist/types-_6MvjyKv.d.ts +104 -0
  107. package/dist/utils/index.d.mts +267 -0
  108. package/dist/utils/index.d.ts +267 -0
  109. package/dist/utils/index.js +426 -0
  110. package/dist/utils/index.js.map +1 -0
  111. package/dist/utils/index.mjs +412 -0
  112. package/dist/utils/index.mjs.map +1 -0
  113. package/dist/utils-DaRs9t0J.d.mts +85 -0
  114. package/dist/utils-gAvt0Vhw.d.ts +85 -0
  115. package/examples/README.md +240 -0
  116. package/examples/api/puck/pages/[id]/route.ts +64 -0
  117. package/examples/api/puck/pages/[id]/versions/route.ts +47 -0
  118. package/examples/api/puck/pages/route.ts +45 -0
  119. package/examples/app/(frontend)/page.tsx +94 -0
  120. package/examples/app/[...slug]/page.tsx +101 -0
  121. package/examples/app/pages/[id]/edit/page.tsx +148 -0
  122. package/examples/components/CustomBanner.tsx +368 -0
  123. package/examples/config/custom-config.ts +223 -0
  124. package/examples/config/payload.config.example.ts +64 -0
  125. package/examples/lib/puck-layouts.ts +258 -0
  126. package/examples/lib/puck-theme.ts +94 -0
  127. package/examples/styles/puck-theme.css +171 -0
  128. package/package.json +157 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/migration.ts","../../src/utils/validation.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Migration Utility for Converting Legacy Payload CMS Pages to Puck Format\n *\n * This utility converts legacy Payload CMS page block structures to the\n * Puck visual editor format, enabling seamless migration of existing content.\n */\n\nimport type { PuckPageData, PuckRootProps, MediaObject } from '../types'\n\n// =============================================================================\n// Type Definitions\n// =============================================================================\n\n/**\n * Legacy block from Payload CMS pages.\n * Each block has a blockType discriminator and various props.\n */\nexport interface LegacyBlock {\n blockType: string\n id?: string | null\n blockName?: string | null\n [key: string]: unknown\n}\n\n/**\n * Subset of Page type used for migration.\n * Only includes fields relevant to content migration.\n */\nexport interface LegacyPage {\n title: string\n slug: string\n pageLayout?: string\n layout?: LegacyBlock[] | null\n [key: string]: unknown\n}\n\n/**\n * Media reference in Puck format\n */\nexport interface MediaReference {\n id: string | number\n url?: string\n alt?: string\n width?: number\n height?: number\n}\n\n/**\n * Puck content item structure\n */\nexport interface PuckContentItem {\n type: string\n props: { id: string; [key: string]: unknown }\n}\n\n// =============================================================================\n// Block Type Mapping\n// =============================================================================\n\n/**\n * Maps legacy Payload block types (camelCase) to Puck component types (PascalCase).\n * Extend this map to support additional custom block types.\n */\nexport const blockTypeMap: Record<string, string> = {\n heroBlock: 'Hero',\n richTextBlock: 'RichText',\n containerBlock: 'Container',\n flexBlock: 'Flex',\n gridBlock: 'Grid',\n sectionBlock: 'Section',\n spacerBlock: 'Spacer',\n headingBlock: 'Heading',\n textBlock: 'Text',\n imageBlock: 'Image',\n buttonBlock: 'Button',\n cardBlock: 'Card',\n dividerBlock: 'Divider',\n accordionBlock: 'Accordion',\n}\n\n// =============================================================================\n// ID Generation\n// =============================================================================\n\n/**\n * Generates a unique ID for Puck content items.\n * Uses a format compatible with Puck's internal ID scheme.\n */\nexport function generatePuckId(legacyId?: string | null): string {\n if (legacyId) {\n return legacyId\n }\n // Generate a random ID similar to Puck's format\n return `puck-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`\n}\n\n// =============================================================================\n// Prop Transformation Utilities\n// =============================================================================\n\n/**\n * Transforms a Payload media reference (ID or Media object) to Puck MediaReference format.\n * Handles both ID-only references and full Media objects.\n */\nexport function transformMediaReference(\n media:\n | string\n | number\n | { id: string | number; url?: string; alt?: string; width?: number; height?: number }\n | MediaObject\n | null\n | undefined\n): MediaReference | null {\n if (media === null || media === undefined) {\n return null\n }\n\n if (typeof media === 'number' || typeof media === 'string') {\n // Just an ID reference - Puck will need to fetch the full media\n return { id: media }\n }\n\n // Full media object\n return {\n id: media.id,\n url: media.url,\n alt: media.alt,\n width: media.width,\n height: media.height,\n }\n}\n\n/**\n * Transforms Lexical rich text content to a serialized string format.\n * Puck stores rich text as JSON strings for the custom editors.\n */\nexport function transformRichText(richText: unknown): string | undefined {\n if (!richText) {\n return undefined\n }\n\n // If it's already a string, return as-is\n if (typeof richText === 'string') {\n return richText\n }\n\n // If it's an object (Lexical format), serialize it\n if (typeof richText === 'object') {\n try {\n return JSON.stringify(richText)\n } catch {\n console.warn('[payload-puck] Failed to serialize rich text content')\n return undefined\n }\n }\n\n return undefined\n}\n\n/**\n * Transforms an array of relationships to Puck format.\n */\nexport function transformRelationshipArray<\n T extends { id: string | number; title?: string; slug?: string },\n>(\n relations: (string | number | T)[] | null | undefined\n): Array<{ id: string | number; title: string; slug?: string }> | undefined {\n if (!relations || !Array.isArray(relations)) {\n return undefined\n }\n\n return relations.map((rel) => {\n if (typeof rel === 'number' || typeof rel === 'string') {\n return { id: rel, title: '' } // Title will need to be fetched\n }\n return {\n id: rel.id,\n title: rel.title || '',\n slug: rel.slug,\n }\n })\n}\n\n// =============================================================================\n// Block Prop Transformation\n// =============================================================================\n\n/**\n * Known rich text field names in legacy blocks\n */\nconst RICH_TEXT_FIELDS = [\n 'headingRich',\n 'subheadingRich',\n 'textRich',\n 'content',\n 'leftContent',\n 'rightContent',\n 'bodyContent',\n 'description',\n]\n\n/**\n * Known media field names in legacy blocks\n */\nconst MEDIA_FIELDS = [\n 'backgroundImage',\n 'image',\n 'rightImage',\n 'leftImage',\n 'profileImage',\n 'media',\n 'thumbnail',\n 'icon',\n]\n\n/**\n * Transform props for a specific block type.\n * Handles any block-specific transformations needed.\n */\nexport function transformBlockProps(\n block: LegacyBlock,\n options?: {\n richTextFields?: string[]\n mediaFields?: string[]\n customTransformers?: Record<string, (value: unknown) => unknown>\n }\n): Record<string, unknown> {\n const { blockType, id, blockName, ...restProps } = block\n const richTextFields = options?.richTextFields || RICH_TEXT_FIELDS\n const mediaFields = options?.mediaFields || MEDIA_FIELDS\n const customTransformers = options?.customTransformers || {}\n\n const props: Record<string, unknown> = {\n id: generatePuckId(id),\n }\n\n // Process each prop based on known patterns\n for (const [key, value] of Object.entries(restProps)) {\n // Check for custom transformer first\n if (customTransformers[key]) {\n props[key] = customTransformers[key](value)\n continue\n }\n\n // Rich text fields - serialize Lexical content\n if (richTextFields.includes(key)) {\n props[key] = transformRichText(value)\n continue\n }\n\n // Media fields - transform to MediaReference\n if (mediaFields.includes(key)) {\n props[key] = transformMediaReference(\n value as\n | string\n | number\n | { id: string | number; url?: string; alt?: string }\n | null\n )\n continue\n }\n\n // Array fields that need ID generation for items\n if (Array.isArray(value)) {\n props[key] = value.map((item) => {\n if (typeof item === 'object' && item !== null) {\n const { id: itemId, ...itemRest } = item as {\n id?: string\n [k: string]: unknown\n }\n return {\n ...itemRest,\n id: itemId || generatePuckId(),\n }\n }\n return item\n })\n continue\n }\n\n // Default: pass through as-is\n props[key] = value\n }\n\n return props\n}\n\n// =============================================================================\n// Main Migration Function\n// =============================================================================\n\n/**\n * Options for the migration function\n */\nexport interface MigrateLegacyOptions {\n /**\n * Custom block type mapping to extend or override defaults\n */\n blockTypeMap?: Record<string, string>\n\n /**\n * Additional rich text field names to transform\n */\n richTextFields?: string[]\n\n /**\n * Additional media field names to transform\n */\n mediaFields?: string[]\n\n /**\n * Custom prop transformers for specific field names\n */\n customTransformers?: Record<string, (value: unknown) => unknown>\n\n /**\n * Whether to skip unknown block types (default: true)\n * If false, unknown blocks will throw an error\n */\n skipUnknownBlocks?: boolean\n\n /**\n * Callback for handling unknown block types\n */\n onUnknownBlock?: (block: LegacyBlock) => PuckContentItem | null\n}\n\n/**\n * Migrates a legacy Payload CMS page to Puck format.\n *\n * This function:\n * 1. Extracts root props (title, pageLayout, etc.)\n * 2. Converts each block in the layout array to a Puck content item\n * 3. Maps block types from camelCase to PascalCase using blockTypeMap\n * 4. Transforms block props appropriately\n *\n * @param page - The legacy Page object from Payload CMS\n * @param options - Migration options\n * @returns PuckPageData ready for use with the Puck editor\n *\n * @example\n * ```ts\n * const legacyPage = await payload.findByID({ collection: 'pages', id: pageId })\n * const puckData = migrateLegacyToPuck(legacyPage)\n * await payload.update({\n * collection: 'pages',\n * id: pageId,\n * data: { puckData },\n * })\n * ```\n */\nexport function migrateLegacyToPuck(\n page: LegacyPage,\n options: MigrateLegacyOptions = {}\n): PuckPageData {\n const {\n blockTypeMap: customBlockTypeMap,\n richTextFields,\n mediaFields,\n customTransformers,\n skipUnknownBlocks = true,\n onUnknownBlock,\n } = options\n\n // Merge custom block type map with defaults\n const effectiveBlockTypeMap = {\n ...blockTypeMap,\n ...customBlockTypeMap,\n }\n\n // Build root props\n const rootProps: PuckRootProps = {\n title: page.title,\n pageLayout: page.pageLayout || 'default',\n }\n\n // Convert layout blocks to Puck content items\n const content: PuckContentItem[] = []\n\n if (page.layout && Array.isArray(page.layout)) {\n for (const block of page.layout) {\n const legacyBlock = block as LegacyBlock\n\n // Get the Puck component type from the legacy block type\n const puckType = effectiveBlockTypeMap[legacyBlock.blockType]\n\n if (!puckType) {\n // Handle unknown block type\n if (onUnknownBlock) {\n const customItem = onUnknownBlock(legacyBlock)\n if (customItem) {\n content.push(customItem)\n }\n continue\n }\n\n if (skipUnknownBlocks) {\n console.warn(\n `[payload-puck] Unknown block type \"${legacyBlock.blockType}\" - skipping during migration`\n )\n continue\n }\n\n throw new Error(\n `Unknown block type \"${legacyBlock.blockType}\" encountered during migration`\n )\n }\n\n // Transform the block props\n const transformedProps = transformBlockProps(legacyBlock, {\n richTextFields,\n mediaFields,\n customTransformers,\n })\n\n // Create the Puck content item\n const contentItem: PuckContentItem = {\n type: puckType,\n props: transformedProps as { id: string; [key: string]: unknown },\n }\n\n content.push(contentItem)\n }\n }\n\n // Build the complete Puck data structure\n const puckData: PuckPageData = {\n root: {\n props: rootProps,\n },\n content,\n zones: {},\n }\n\n return puckData\n}\n\n// =============================================================================\n// Migration Preview\n// =============================================================================\n\n/**\n * Migration preview result\n */\nexport interface MigrationPreview {\n title: string\n slug: string\n blockCount: number\n blockTypes: string[]\n warnings: string[]\n unmappedBlockTypes: string[]\n}\n\n/**\n * Gets a summary of a legacy page for migration preview.\n * Useful for showing users what will be migrated before committing.\n *\n * @param page - The legacy page to preview\n * @param customBlockTypeMap - Optional custom block type mapping\n * @returns Preview information about the migration\n */\nexport function getMigrationPreview(\n page: LegacyPage,\n customBlockTypeMap?: Record<string, string>\n): MigrationPreview {\n const warnings: string[] = []\n const blockTypes: string[] = []\n const unmappedBlockTypes: string[] = []\n\n const effectiveBlockTypeMap = {\n ...blockTypeMap,\n ...customBlockTypeMap,\n }\n\n if (page.layout && Array.isArray(page.layout)) {\n for (const block of page.layout) {\n const legacyBlock = block as LegacyBlock\n const puckType = effectiveBlockTypeMap[legacyBlock.blockType]\n\n if (puckType) {\n blockTypes.push(puckType)\n } else {\n warnings.push(`Unknown block type: ${legacyBlock.blockType}`)\n if (!unmappedBlockTypes.includes(legacyBlock.blockType)) {\n unmappedBlockTypes.push(legacyBlock.blockType)\n }\n }\n }\n }\n\n return {\n title: page.title,\n slug: page.slug,\n blockCount: page.layout?.length || 0,\n blockTypes,\n warnings,\n unmappedBlockTypes,\n }\n}\n","/**\n * Puck Data Validation Utilities\n *\n * Provides validation functions for ensuring Puck data structures are well-formed.\n */\n\nimport type { PuckPageData, PuckRootProps } from '../types'\n\n// =============================================================================\n// Validation Result Types\n// =============================================================================\n\n/**\n * Result of a validation operation\n */\nexport interface ValidationResult {\n valid: boolean\n errors: string[]\n warnings: string[]\n}\n\n/**\n * Options for validation\n */\nexport interface ValidationOptions {\n /**\n * Whether to validate that all content items have IDs\n * @default true\n */\n requireContentIds?: boolean\n\n /**\n * Whether to validate root props\n * @default true\n */\n validateRoot?: boolean\n\n /**\n * Required root prop fields\n * @default ['title']\n */\n requiredRootProps?: string[]\n\n /**\n * Allowed component types (if specified, unknown types will be flagged)\n */\n allowedComponentTypes?: string[]\n\n /**\n * Whether to treat unknown component types as errors (vs warnings)\n * @default false\n */\n strictComponentTypes?: boolean\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if a value is a valid PuckPageData structure.\n * Performs basic structural validation.\n */\nexport function isPuckData(data: unknown): data is PuckPageData {\n if (!data || typeof data !== 'object') {\n return false\n }\n\n const obj = data as Record<string, unknown>\n\n // Check root structure\n if (!obj.root || typeof obj.root !== 'object') {\n return false\n }\n\n const root = obj.root as Record<string, unknown>\n if (!root.props || typeof root.props !== 'object') {\n return false\n }\n\n // Check content array\n if (!Array.isArray(obj.content)) {\n return false\n }\n\n // Validate each content item has required fields\n for (const item of obj.content) {\n if (!item || typeof item !== 'object') {\n return false\n }\n const contentItem = item as Record<string, unknown>\n if (typeof contentItem.type !== 'string') {\n return false\n }\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n return false\n }\n }\n\n // Check zones (optional but must be object if present)\n if (obj.zones !== undefined && typeof obj.zones !== 'object') {\n return false\n }\n\n return true\n}\n\n/**\n * Type guard for PuckRootProps\n */\nexport function isPuckRootProps(props: unknown): props is PuckRootProps {\n if (!props || typeof props !== 'object') {\n return false\n }\n return true\n}\n\n// =============================================================================\n// Validation Functions\n// =============================================================================\n\n/**\n * Validates that a PuckPageData structure is well-formed.\n * Useful for testing and debugging migration issues.\n *\n * @param data - The data to validate\n * @param options - Validation options\n * @returns Validation result with errors and warnings\n *\n * @example\n * ```ts\n * const result = validatePuckData(puckData)\n * if (!result.valid) {\n * console.error('Validation errors:', result.errors)\n * }\n * ```\n */\nexport function validatePuckData(\n data: unknown,\n options: ValidationOptions = {}\n): ValidationResult {\n const {\n requireContentIds = true,\n validateRoot = true,\n requiredRootProps = ['title'],\n allowedComponentTypes,\n strictComponentTypes = false,\n } = options\n\n const errors: string[] = []\n const warnings: string[] = []\n\n // Basic type check\n if (!data || typeof data !== 'object') {\n errors.push('Data must be a non-null object')\n return { valid: false, errors, warnings }\n }\n\n const obj = data as Record<string, unknown>\n\n // ==========================================================================\n // Validate root structure\n // ==========================================================================\n\n if (!obj.root || typeof obj.root !== 'object') {\n errors.push('Missing or invalid root object')\n } else if (validateRoot) {\n const root = obj.root as Record<string, unknown>\n\n if (!root.props || typeof root.props !== 'object') {\n errors.push('Missing root.props object')\n } else {\n const rootProps = root.props as Record<string, unknown>\n\n // Check required root props\n for (const prop of requiredRootProps) {\n if (rootProps[prop] === undefined || rootProps[prop] === null) {\n errors.push(`Missing required root prop: ${prop}`)\n }\n }\n\n // Validate pageLayout if present\n if (rootProps.pageLayout !== undefined) {\n if (typeof rootProps.pageLayout !== 'string') {\n errors.push('root.props.pageLayout must be a string')\n }\n }\n }\n }\n\n // ==========================================================================\n // Validate content array\n // ==========================================================================\n\n if (!Array.isArray(obj.content)) {\n errors.push('content must be an array')\n } else {\n const seenIds = new Set<string>()\n\n obj.content.forEach((item, index) => {\n if (!item || typeof item !== 'object') {\n errors.push(`Content item at index ${index} is not an object`)\n return\n }\n\n const contentItem = item as Record<string, unknown>\n\n // Validate type\n if (!contentItem.type || typeof contentItem.type !== 'string') {\n errors.push(`Content item at index ${index} missing or invalid type`)\n } else if (allowedComponentTypes) {\n if (!allowedComponentTypes.includes(contentItem.type)) {\n const message = `Unknown component type \"${contentItem.type}\" at index ${index}`\n if (strictComponentTypes) {\n errors.push(message)\n } else {\n warnings.push(message)\n }\n }\n }\n\n // Validate props\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n errors.push(`Content item at index ${index} missing props object`)\n } else if (requireContentIds) {\n const props = contentItem.props as Record<string, unknown>\n\n if (!props.id || typeof props.id !== 'string') {\n errors.push(`Content item at index ${index} missing or invalid props.id`)\n } else {\n // Check for duplicate IDs\n if (seenIds.has(props.id)) {\n warnings.push(\n `Duplicate content item ID \"${props.id}\" at index ${index}`\n )\n }\n seenIds.add(props.id)\n }\n }\n })\n }\n\n // ==========================================================================\n // Validate zones\n // ==========================================================================\n\n if (obj.zones !== undefined) {\n if (typeof obj.zones !== 'object' || obj.zones === null) {\n errors.push('zones must be an object')\n } else {\n const zones = obj.zones as Record<string, unknown>\n\n for (const [zoneName, zoneContent] of Object.entries(zones)) {\n if (!Array.isArray(zoneContent)) {\n errors.push(`Zone \"${zoneName}\" content must be an array`)\n continue\n }\n\n zoneContent.forEach((item, index) => {\n if (!item || typeof item !== 'object') {\n errors.push(`Zone \"${zoneName}\" item at index ${index} is not an object`)\n return\n }\n\n const contentItem = item as Record<string, unknown>\n\n if (!contentItem.type || typeof contentItem.type !== 'string') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing or invalid type`\n )\n }\n\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing props object`\n )\n } else if (requireContentIds) {\n const props = contentItem.props as Record<string, unknown>\n if (!props.id || typeof props.id !== 'string') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing or invalid props.id`\n )\n }\n }\n })\n }\n }\n }\n\n return {\n valid: errors.length === 0,\n errors,\n warnings,\n }\n}\n\n/**\n * Validates and returns typed PuckPageData, throwing if invalid.\n *\n * @param data - The data to validate\n * @param options - Validation options\n * @returns The validated PuckPageData\n * @throws Error if validation fails\n */\nexport function assertPuckData(\n data: unknown,\n options?: ValidationOptions\n): PuckPageData {\n const result = validatePuckData(data, options)\n\n if (!result.valid) {\n throw new Error(\n `Invalid Puck data: ${result.errors.join('; ')}`\n )\n }\n\n return data as PuckPageData\n}\n\n/**\n * Safely parses JSON and validates as PuckPageData.\n *\n * @param json - JSON string to parse\n * @param options - Validation options\n * @returns Validation result with parsed data if valid\n */\nexport function parsePuckDataJson(\n json: string,\n options?: ValidationOptions\n): ValidationResult & { data?: PuckPageData } {\n let parsed: unknown\n\n try {\n parsed = JSON.parse(json)\n } catch (e) {\n return {\n valid: false,\n errors: [`Invalid JSON: ${e instanceof Error ? e.message : 'Parse error'}`],\n warnings: [],\n }\n }\n\n const result = validatePuckData(parsed, options)\n\n if (result.valid) {\n return {\n ...result,\n data: parsed as PuckPageData,\n }\n }\n\n return result\n}\n"]}
@@ -0,0 +1,412 @@
1
+ // src/utils/migration.ts
2
+ var blockTypeMap = {
3
+ heroBlock: "Hero",
4
+ richTextBlock: "RichText",
5
+ containerBlock: "Container",
6
+ flexBlock: "Flex",
7
+ gridBlock: "Grid",
8
+ sectionBlock: "Section",
9
+ spacerBlock: "Spacer",
10
+ headingBlock: "Heading",
11
+ textBlock: "Text",
12
+ imageBlock: "Image",
13
+ buttonBlock: "Button",
14
+ cardBlock: "Card",
15
+ dividerBlock: "Divider",
16
+ accordionBlock: "Accordion"
17
+ };
18
+ function generatePuckId(legacyId) {
19
+ if (legacyId) {
20
+ return legacyId;
21
+ }
22
+ return `puck-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
23
+ }
24
+ function transformMediaReference(media) {
25
+ if (media === null || media === void 0) {
26
+ return null;
27
+ }
28
+ if (typeof media === "number" || typeof media === "string") {
29
+ return { id: media };
30
+ }
31
+ return {
32
+ id: media.id,
33
+ url: media.url,
34
+ alt: media.alt,
35
+ width: media.width,
36
+ height: media.height
37
+ };
38
+ }
39
+ function transformRichText(richText) {
40
+ if (!richText) {
41
+ return void 0;
42
+ }
43
+ if (typeof richText === "string") {
44
+ return richText;
45
+ }
46
+ if (typeof richText === "object") {
47
+ try {
48
+ return JSON.stringify(richText);
49
+ } catch {
50
+ console.warn("[payload-puck] Failed to serialize rich text content");
51
+ return void 0;
52
+ }
53
+ }
54
+ return void 0;
55
+ }
56
+ function transformRelationshipArray(relations) {
57
+ if (!relations || !Array.isArray(relations)) {
58
+ return void 0;
59
+ }
60
+ return relations.map((rel) => {
61
+ if (typeof rel === "number" || typeof rel === "string") {
62
+ return { id: rel, title: "" };
63
+ }
64
+ return {
65
+ id: rel.id,
66
+ title: rel.title || "",
67
+ slug: rel.slug
68
+ };
69
+ });
70
+ }
71
+ var RICH_TEXT_FIELDS = [
72
+ "headingRich",
73
+ "subheadingRich",
74
+ "textRich",
75
+ "content",
76
+ "leftContent",
77
+ "rightContent",
78
+ "bodyContent",
79
+ "description"
80
+ ];
81
+ var MEDIA_FIELDS = [
82
+ "backgroundImage",
83
+ "image",
84
+ "rightImage",
85
+ "leftImage",
86
+ "profileImage",
87
+ "media",
88
+ "thumbnail",
89
+ "icon"
90
+ ];
91
+ function transformBlockProps(block, options) {
92
+ const { blockType, id, blockName, ...restProps } = block;
93
+ const richTextFields = options?.richTextFields || RICH_TEXT_FIELDS;
94
+ const mediaFields = options?.mediaFields || MEDIA_FIELDS;
95
+ const customTransformers = options?.customTransformers || {};
96
+ const props = {
97
+ id: generatePuckId(id)
98
+ };
99
+ for (const [key, value] of Object.entries(restProps)) {
100
+ if (customTransformers[key]) {
101
+ props[key] = customTransformers[key](value);
102
+ continue;
103
+ }
104
+ if (richTextFields.includes(key)) {
105
+ props[key] = transformRichText(value);
106
+ continue;
107
+ }
108
+ if (mediaFields.includes(key)) {
109
+ props[key] = transformMediaReference(
110
+ value
111
+ );
112
+ continue;
113
+ }
114
+ if (Array.isArray(value)) {
115
+ props[key] = value.map((item) => {
116
+ if (typeof item === "object" && item !== null) {
117
+ const { id: itemId, ...itemRest } = item;
118
+ return {
119
+ ...itemRest,
120
+ id: itemId || generatePuckId()
121
+ };
122
+ }
123
+ return item;
124
+ });
125
+ continue;
126
+ }
127
+ props[key] = value;
128
+ }
129
+ return props;
130
+ }
131
+ function migrateLegacyToPuck(page, options = {}) {
132
+ const {
133
+ blockTypeMap: customBlockTypeMap,
134
+ richTextFields,
135
+ mediaFields,
136
+ customTransformers,
137
+ skipUnknownBlocks = true,
138
+ onUnknownBlock
139
+ } = options;
140
+ const effectiveBlockTypeMap = {
141
+ ...blockTypeMap,
142
+ ...customBlockTypeMap
143
+ };
144
+ const rootProps = {
145
+ title: page.title,
146
+ pageLayout: page.pageLayout || "default"
147
+ };
148
+ const content = [];
149
+ if (page.layout && Array.isArray(page.layout)) {
150
+ for (const block of page.layout) {
151
+ const legacyBlock = block;
152
+ const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
153
+ if (!puckType) {
154
+ if (onUnknownBlock) {
155
+ const customItem = onUnknownBlock(legacyBlock);
156
+ if (customItem) {
157
+ content.push(customItem);
158
+ }
159
+ continue;
160
+ }
161
+ if (skipUnknownBlocks) {
162
+ console.warn(
163
+ `[payload-puck] Unknown block type "${legacyBlock.blockType}" - skipping during migration`
164
+ );
165
+ continue;
166
+ }
167
+ throw new Error(
168
+ `Unknown block type "${legacyBlock.blockType}" encountered during migration`
169
+ );
170
+ }
171
+ const transformedProps = transformBlockProps(legacyBlock, {
172
+ richTextFields,
173
+ mediaFields,
174
+ customTransformers
175
+ });
176
+ const contentItem = {
177
+ type: puckType,
178
+ props: transformedProps
179
+ };
180
+ content.push(contentItem);
181
+ }
182
+ }
183
+ const puckData = {
184
+ root: {
185
+ props: rootProps
186
+ },
187
+ content,
188
+ zones: {}
189
+ };
190
+ return puckData;
191
+ }
192
+ function getMigrationPreview(page, customBlockTypeMap) {
193
+ const warnings = [];
194
+ const blockTypes = [];
195
+ const unmappedBlockTypes = [];
196
+ const effectiveBlockTypeMap = {
197
+ ...blockTypeMap,
198
+ ...customBlockTypeMap
199
+ };
200
+ if (page.layout && Array.isArray(page.layout)) {
201
+ for (const block of page.layout) {
202
+ const legacyBlock = block;
203
+ const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
204
+ if (puckType) {
205
+ blockTypes.push(puckType);
206
+ } else {
207
+ warnings.push(`Unknown block type: ${legacyBlock.blockType}`);
208
+ if (!unmappedBlockTypes.includes(legacyBlock.blockType)) {
209
+ unmappedBlockTypes.push(legacyBlock.blockType);
210
+ }
211
+ }
212
+ }
213
+ }
214
+ return {
215
+ title: page.title,
216
+ slug: page.slug,
217
+ blockCount: page.layout?.length || 0,
218
+ blockTypes,
219
+ warnings,
220
+ unmappedBlockTypes
221
+ };
222
+ }
223
+
224
+ // src/utils/validation.ts
225
+ function isPuckData(data) {
226
+ if (!data || typeof data !== "object") {
227
+ return false;
228
+ }
229
+ const obj = data;
230
+ if (!obj.root || typeof obj.root !== "object") {
231
+ return false;
232
+ }
233
+ const root = obj.root;
234
+ if (!root.props || typeof root.props !== "object") {
235
+ return false;
236
+ }
237
+ if (!Array.isArray(obj.content)) {
238
+ return false;
239
+ }
240
+ for (const item of obj.content) {
241
+ if (!item || typeof item !== "object") {
242
+ return false;
243
+ }
244
+ const contentItem = item;
245
+ if (typeof contentItem.type !== "string") {
246
+ return false;
247
+ }
248
+ if (!contentItem.props || typeof contentItem.props !== "object") {
249
+ return false;
250
+ }
251
+ }
252
+ if (obj.zones !== void 0 && typeof obj.zones !== "object") {
253
+ return false;
254
+ }
255
+ return true;
256
+ }
257
+ function isPuckRootProps(props) {
258
+ if (!props || typeof props !== "object") {
259
+ return false;
260
+ }
261
+ return true;
262
+ }
263
+ function validatePuckData(data, options = {}) {
264
+ const {
265
+ requireContentIds = true,
266
+ validateRoot = true,
267
+ requiredRootProps = ["title"],
268
+ allowedComponentTypes,
269
+ strictComponentTypes = false
270
+ } = options;
271
+ const errors = [];
272
+ const warnings = [];
273
+ if (!data || typeof data !== "object") {
274
+ errors.push("Data must be a non-null object");
275
+ return { valid: false, errors, warnings };
276
+ }
277
+ const obj = data;
278
+ if (!obj.root || typeof obj.root !== "object") {
279
+ errors.push("Missing or invalid root object");
280
+ } else if (validateRoot) {
281
+ const root = obj.root;
282
+ if (!root.props || typeof root.props !== "object") {
283
+ errors.push("Missing root.props object");
284
+ } else {
285
+ const rootProps = root.props;
286
+ for (const prop of requiredRootProps) {
287
+ if (rootProps[prop] === void 0 || rootProps[prop] === null) {
288
+ errors.push(`Missing required root prop: ${prop}`);
289
+ }
290
+ }
291
+ if (rootProps.pageLayout !== void 0) {
292
+ if (typeof rootProps.pageLayout !== "string") {
293
+ errors.push("root.props.pageLayout must be a string");
294
+ }
295
+ }
296
+ }
297
+ }
298
+ if (!Array.isArray(obj.content)) {
299
+ errors.push("content must be an array");
300
+ } else {
301
+ const seenIds = /* @__PURE__ */ new Set();
302
+ obj.content.forEach((item, index) => {
303
+ if (!item || typeof item !== "object") {
304
+ errors.push(`Content item at index ${index} is not an object`);
305
+ return;
306
+ }
307
+ const contentItem = item;
308
+ if (!contentItem.type || typeof contentItem.type !== "string") {
309
+ errors.push(`Content item at index ${index} missing or invalid type`);
310
+ } else if (allowedComponentTypes) {
311
+ if (!allowedComponentTypes.includes(contentItem.type)) {
312
+ const message = `Unknown component type "${contentItem.type}" at index ${index}`;
313
+ if (strictComponentTypes) {
314
+ errors.push(message);
315
+ } else {
316
+ warnings.push(message);
317
+ }
318
+ }
319
+ }
320
+ if (!contentItem.props || typeof contentItem.props !== "object") {
321
+ errors.push(`Content item at index ${index} missing props object`);
322
+ } else if (requireContentIds) {
323
+ const props = contentItem.props;
324
+ if (!props.id || typeof props.id !== "string") {
325
+ errors.push(`Content item at index ${index} missing or invalid props.id`);
326
+ } else {
327
+ if (seenIds.has(props.id)) {
328
+ warnings.push(
329
+ `Duplicate content item ID "${props.id}" at index ${index}`
330
+ );
331
+ }
332
+ seenIds.add(props.id);
333
+ }
334
+ }
335
+ });
336
+ }
337
+ if (obj.zones !== void 0) {
338
+ if (typeof obj.zones !== "object" || obj.zones === null) {
339
+ errors.push("zones must be an object");
340
+ } else {
341
+ const zones = obj.zones;
342
+ for (const [zoneName, zoneContent] of Object.entries(zones)) {
343
+ if (!Array.isArray(zoneContent)) {
344
+ errors.push(`Zone "${zoneName}" content must be an array`);
345
+ continue;
346
+ }
347
+ zoneContent.forEach((item, index) => {
348
+ if (!item || typeof item !== "object") {
349
+ errors.push(`Zone "${zoneName}" item at index ${index} is not an object`);
350
+ return;
351
+ }
352
+ const contentItem = item;
353
+ if (!contentItem.type || typeof contentItem.type !== "string") {
354
+ errors.push(
355
+ `Zone "${zoneName}" item at index ${index} missing or invalid type`
356
+ );
357
+ }
358
+ if (!contentItem.props || typeof contentItem.props !== "object") {
359
+ errors.push(
360
+ `Zone "${zoneName}" item at index ${index} missing props object`
361
+ );
362
+ } else if (requireContentIds) {
363
+ const props = contentItem.props;
364
+ if (!props.id || typeof props.id !== "string") {
365
+ errors.push(
366
+ `Zone "${zoneName}" item at index ${index} missing or invalid props.id`
367
+ );
368
+ }
369
+ }
370
+ });
371
+ }
372
+ }
373
+ }
374
+ return {
375
+ valid: errors.length === 0,
376
+ errors,
377
+ warnings
378
+ };
379
+ }
380
+ function assertPuckData(data, options) {
381
+ const result = validatePuckData(data, options);
382
+ if (!result.valid) {
383
+ throw new Error(
384
+ `Invalid Puck data: ${result.errors.join("; ")}`
385
+ );
386
+ }
387
+ return data;
388
+ }
389
+ function parsePuckDataJson(json, options) {
390
+ let parsed;
391
+ try {
392
+ parsed = JSON.parse(json);
393
+ } catch (e) {
394
+ return {
395
+ valid: false,
396
+ errors: [`Invalid JSON: ${e instanceof Error ? e.message : "Parse error"}`],
397
+ warnings: []
398
+ };
399
+ }
400
+ const result = validatePuckData(parsed, options);
401
+ if (result.valid) {
402
+ return {
403
+ ...result,
404
+ data: parsed
405
+ };
406
+ }
407
+ return result;
408
+ }
409
+
410
+ export { assertPuckData, blockTypeMap, generatePuckId, getMigrationPreview, isPuckData, isPuckRootProps, migrateLegacyToPuck, parsePuckDataJson, transformBlockProps, transformMediaReference, transformRelationshipArray, transformRichText, validatePuckData };
411
+ //# sourceMappingURL=index.mjs.map
412
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/utils/migration.ts","../../src/utils/validation.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Migration Utility for Converting Legacy Payload CMS Pages to Puck Format\n *\n * This utility converts legacy Payload CMS page block structures to the\n * Puck visual editor format, enabling seamless migration of existing content.\n */\n\nimport type { PuckPageData, PuckRootProps, MediaObject } from '../types'\n\n// =============================================================================\n// Type Definitions\n// =============================================================================\n\n/**\n * Legacy block from Payload CMS pages.\n * Each block has a blockType discriminator and various props.\n */\nexport interface LegacyBlock {\n blockType: string\n id?: string | null\n blockName?: string | null\n [key: string]: unknown\n}\n\n/**\n * Subset of Page type used for migration.\n * Only includes fields relevant to content migration.\n */\nexport interface LegacyPage {\n title: string\n slug: string\n pageLayout?: string\n layout?: LegacyBlock[] | null\n [key: string]: unknown\n}\n\n/**\n * Media reference in Puck format\n */\nexport interface MediaReference {\n id: string | number\n url?: string\n alt?: string\n width?: number\n height?: number\n}\n\n/**\n * Puck content item structure\n */\nexport interface PuckContentItem {\n type: string\n props: { id: string; [key: string]: unknown }\n}\n\n// =============================================================================\n// Block Type Mapping\n// =============================================================================\n\n/**\n * Maps legacy Payload block types (camelCase) to Puck component types (PascalCase).\n * Extend this map to support additional custom block types.\n */\nexport const blockTypeMap: Record<string, string> = {\n heroBlock: 'Hero',\n richTextBlock: 'RichText',\n containerBlock: 'Container',\n flexBlock: 'Flex',\n gridBlock: 'Grid',\n sectionBlock: 'Section',\n spacerBlock: 'Spacer',\n headingBlock: 'Heading',\n textBlock: 'Text',\n imageBlock: 'Image',\n buttonBlock: 'Button',\n cardBlock: 'Card',\n dividerBlock: 'Divider',\n accordionBlock: 'Accordion',\n}\n\n// =============================================================================\n// ID Generation\n// =============================================================================\n\n/**\n * Generates a unique ID for Puck content items.\n * Uses a format compatible with Puck's internal ID scheme.\n */\nexport function generatePuckId(legacyId?: string | null): string {\n if (legacyId) {\n return legacyId\n }\n // Generate a random ID similar to Puck's format\n return `puck-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`\n}\n\n// =============================================================================\n// Prop Transformation Utilities\n// =============================================================================\n\n/**\n * Transforms a Payload media reference (ID or Media object) to Puck MediaReference format.\n * Handles both ID-only references and full Media objects.\n */\nexport function transformMediaReference(\n media:\n | string\n | number\n | { id: string | number; url?: string; alt?: string; width?: number; height?: number }\n | MediaObject\n | null\n | undefined\n): MediaReference | null {\n if (media === null || media === undefined) {\n return null\n }\n\n if (typeof media === 'number' || typeof media === 'string') {\n // Just an ID reference - Puck will need to fetch the full media\n return { id: media }\n }\n\n // Full media object\n return {\n id: media.id,\n url: media.url,\n alt: media.alt,\n width: media.width,\n height: media.height,\n }\n}\n\n/**\n * Transforms Lexical rich text content to a serialized string format.\n * Puck stores rich text as JSON strings for the custom editors.\n */\nexport function transformRichText(richText: unknown): string | undefined {\n if (!richText) {\n return undefined\n }\n\n // If it's already a string, return as-is\n if (typeof richText === 'string') {\n return richText\n }\n\n // If it's an object (Lexical format), serialize it\n if (typeof richText === 'object') {\n try {\n return JSON.stringify(richText)\n } catch {\n console.warn('[payload-puck] Failed to serialize rich text content')\n return undefined\n }\n }\n\n return undefined\n}\n\n/**\n * Transforms an array of relationships to Puck format.\n */\nexport function transformRelationshipArray<\n T extends { id: string | number; title?: string; slug?: string },\n>(\n relations: (string | number | T)[] | null | undefined\n): Array<{ id: string | number; title: string; slug?: string }> | undefined {\n if (!relations || !Array.isArray(relations)) {\n return undefined\n }\n\n return relations.map((rel) => {\n if (typeof rel === 'number' || typeof rel === 'string') {\n return { id: rel, title: '' } // Title will need to be fetched\n }\n return {\n id: rel.id,\n title: rel.title || '',\n slug: rel.slug,\n }\n })\n}\n\n// =============================================================================\n// Block Prop Transformation\n// =============================================================================\n\n/**\n * Known rich text field names in legacy blocks\n */\nconst RICH_TEXT_FIELDS = [\n 'headingRich',\n 'subheadingRich',\n 'textRich',\n 'content',\n 'leftContent',\n 'rightContent',\n 'bodyContent',\n 'description',\n]\n\n/**\n * Known media field names in legacy blocks\n */\nconst MEDIA_FIELDS = [\n 'backgroundImage',\n 'image',\n 'rightImage',\n 'leftImage',\n 'profileImage',\n 'media',\n 'thumbnail',\n 'icon',\n]\n\n/**\n * Transform props for a specific block type.\n * Handles any block-specific transformations needed.\n */\nexport function transformBlockProps(\n block: LegacyBlock,\n options?: {\n richTextFields?: string[]\n mediaFields?: string[]\n customTransformers?: Record<string, (value: unknown) => unknown>\n }\n): Record<string, unknown> {\n const { blockType, id, blockName, ...restProps } = block\n const richTextFields = options?.richTextFields || RICH_TEXT_FIELDS\n const mediaFields = options?.mediaFields || MEDIA_FIELDS\n const customTransformers = options?.customTransformers || {}\n\n const props: Record<string, unknown> = {\n id: generatePuckId(id),\n }\n\n // Process each prop based on known patterns\n for (const [key, value] of Object.entries(restProps)) {\n // Check for custom transformer first\n if (customTransformers[key]) {\n props[key] = customTransformers[key](value)\n continue\n }\n\n // Rich text fields - serialize Lexical content\n if (richTextFields.includes(key)) {\n props[key] = transformRichText(value)\n continue\n }\n\n // Media fields - transform to MediaReference\n if (mediaFields.includes(key)) {\n props[key] = transformMediaReference(\n value as\n | string\n | number\n | { id: string | number; url?: string; alt?: string }\n | null\n )\n continue\n }\n\n // Array fields that need ID generation for items\n if (Array.isArray(value)) {\n props[key] = value.map((item) => {\n if (typeof item === 'object' && item !== null) {\n const { id: itemId, ...itemRest } = item as {\n id?: string\n [k: string]: unknown\n }\n return {\n ...itemRest,\n id: itemId || generatePuckId(),\n }\n }\n return item\n })\n continue\n }\n\n // Default: pass through as-is\n props[key] = value\n }\n\n return props\n}\n\n// =============================================================================\n// Main Migration Function\n// =============================================================================\n\n/**\n * Options for the migration function\n */\nexport interface MigrateLegacyOptions {\n /**\n * Custom block type mapping to extend or override defaults\n */\n blockTypeMap?: Record<string, string>\n\n /**\n * Additional rich text field names to transform\n */\n richTextFields?: string[]\n\n /**\n * Additional media field names to transform\n */\n mediaFields?: string[]\n\n /**\n * Custom prop transformers for specific field names\n */\n customTransformers?: Record<string, (value: unknown) => unknown>\n\n /**\n * Whether to skip unknown block types (default: true)\n * If false, unknown blocks will throw an error\n */\n skipUnknownBlocks?: boolean\n\n /**\n * Callback for handling unknown block types\n */\n onUnknownBlock?: (block: LegacyBlock) => PuckContentItem | null\n}\n\n/**\n * Migrates a legacy Payload CMS page to Puck format.\n *\n * This function:\n * 1. Extracts root props (title, pageLayout, etc.)\n * 2. Converts each block in the layout array to a Puck content item\n * 3. Maps block types from camelCase to PascalCase using blockTypeMap\n * 4. Transforms block props appropriately\n *\n * @param page - The legacy Page object from Payload CMS\n * @param options - Migration options\n * @returns PuckPageData ready for use with the Puck editor\n *\n * @example\n * ```ts\n * const legacyPage = await payload.findByID({ collection: 'pages', id: pageId })\n * const puckData = migrateLegacyToPuck(legacyPage)\n * await payload.update({\n * collection: 'pages',\n * id: pageId,\n * data: { puckData },\n * })\n * ```\n */\nexport function migrateLegacyToPuck(\n page: LegacyPage,\n options: MigrateLegacyOptions = {}\n): PuckPageData {\n const {\n blockTypeMap: customBlockTypeMap,\n richTextFields,\n mediaFields,\n customTransformers,\n skipUnknownBlocks = true,\n onUnknownBlock,\n } = options\n\n // Merge custom block type map with defaults\n const effectiveBlockTypeMap = {\n ...blockTypeMap,\n ...customBlockTypeMap,\n }\n\n // Build root props\n const rootProps: PuckRootProps = {\n title: page.title,\n pageLayout: page.pageLayout || 'default',\n }\n\n // Convert layout blocks to Puck content items\n const content: PuckContentItem[] = []\n\n if (page.layout && Array.isArray(page.layout)) {\n for (const block of page.layout) {\n const legacyBlock = block as LegacyBlock\n\n // Get the Puck component type from the legacy block type\n const puckType = effectiveBlockTypeMap[legacyBlock.blockType]\n\n if (!puckType) {\n // Handle unknown block type\n if (onUnknownBlock) {\n const customItem = onUnknownBlock(legacyBlock)\n if (customItem) {\n content.push(customItem)\n }\n continue\n }\n\n if (skipUnknownBlocks) {\n console.warn(\n `[payload-puck] Unknown block type \"${legacyBlock.blockType}\" - skipping during migration`\n )\n continue\n }\n\n throw new Error(\n `Unknown block type \"${legacyBlock.blockType}\" encountered during migration`\n )\n }\n\n // Transform the block props\n const transformedProps = transformBlockProps(legacyBlock, {\n richTextFields,\n mediaFields,\n customTransformers,\n })\n\n // Create the Puck content item\n const contentItem: PuckContentItem = {\n type: puckType,\n props: transformedProps as { id: string; [key: string]: unknown },\n }\n\n content.push(contentItem)\n }\n }\n\n // Build the complete Puck data structure\n const puckData: PuckPageData = {\n root: {\n props: rootProps,\n },\n content,\n zones: {},\n }\n\n return puckData\n}\n\n// =============================================================================\n// Migration Preview\n// =============================================================================\n\n/**\n * Migration preview result\n */\nexport interface MigrationPreview {\n title: string\n slug: string\n blockCount: number\n blockTypes: string[]\n warnings: string[]\n unmappedBlockTypes: string[]\n}\n\n/**\n * Gets a summary of a legacy page for migration preview.\n * Useful for showing users what will be migrated before committing.\n *\n * @param page - The legacy page to preview\n * @param customBlockTypeMap - Optional custom block type mapping\n * @returns Preview information about the migration\n */\nexport function getMigrationPreview(\n page: LegacyPage,\n customBlockTypeMap?: Record<string, string>\n): MigrationPreview {\n const warnings: string[] = []\n const blockTypes: string[] = []\n const unmappedBlockTypes: string[] = []\n\n const effectiveBlockTypeMap = {\n ...blockTypeMap,\n ...customBlockTypeMap,\n }\n\n if (page.layout && Array.isArray(page.layout)) {\n for (const block of page.layout) {\n const legacyBlock = block as LegacyBlock\n const puckType = effectiveBlockTypeMap[legacyBlock.blockType]\n\n if (puckType) {\n blockTypes.push(puckType)\n } else {\n warnings.push(`Unknown block type: ${legacyBlock.blockType}`)\n if (!unmappedBlockTypes.includes(legacyBlock.blockType)) {\n unmappedBlockTypes.push(legacyBlock.blockType)\n }\n }\n }\n }\n\n return {\n title: page.title,\n slug: page.slug,\n blockCount: page.layout?.length || 0,\n blockTypes,\n warnings,\n unmappedBlockTypes,\n }\n}\n","/**\n * Puck Data Validation Utilities\n *\n * Provides validation functions for ensuring Puck data structures are well-formed.\n */\n\nimport type { PuckPageData, PuckRootProps } from '../types'\n\n// =============================================================================\n// Validation Result Types\n// =============================================================================\n\n/**\n * Result of a validation operation\n */\nexport interface ValidationResult {\n valid: boolean\n errors: string[]\n warnings: string[]\n}\n\n/**\n * Options for validation\n */\nexport interface ValidationOptions {\n /**\n * Whether to validate that all content items have IDs\n * @default true\n */\n requireContentIds?: boolean\n\n /**\n * Whether to validate root props\n * @default true\n */\n validateRoot?: boolean\n\n /**\n * Required root prop fields\n * @default ['title']\n */\n requiredRootProps?: string[]\n\n /**\n * Allowed component types (if specified, unknown types will be flagged)\n */\n allowedComponentTypes?: string[]\n\n /**\n * Whether to treat unknown component types as errors (vs warnings)\n * @default false\n */\n strictComponentTypes?: boolean\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if a value is a valid PuckPageData structure.\n * Performs basic structural validation.\n */\nexport function isPuckData(data: unknown): data is PuckPageData {\n if (!data || typeof data !== 'object') {\n return false\n }\n\n const obj = data as Record<string, unknown>\n\n // Check root structure\n if (!obj.root || typeof obj.root !== 'object') {\n return false\n }\n\n const root = obj.root as Record<string, unknown>\n if (!root.props || typeof root.props !== 'object') {\n return false\n }\n\n // Check content array\n if (!Array.isArray(obj.content)) {\n return false\n }\n\n // Validate each content item has required fields\n for (const item of obj.content) {\n if (!item || typeof item !== 'object') {\n return false\n }\n const contentItem = item as Record<string, unknown>\n if (typeof contentItem.type !== 'string') {\n return false\n }\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n return false\n }\n }\n\n // Check zones (optional but must be object if present)\n if (obj.zones !== undefined && typeof obj.zones !== 'object') {\n return false\n }\n\n return true\n}\n\n/**\n * Type guard for PuckRootProps\n */\nexport function isPuckRootProps(props: unknown): props is PuckRootProps {\n if (!props || typeof props !== 'object') {\n return false\n }\n return true\n}\n\n// =============================================================================\n// Validation Functions\n// =============================================================================\n\n/**\n * Validates that a PuckPageData structure is well-formed.\n * Useful for testing and debugging migration issues.\n *\n * @param data - The data to validate\n * @param options - Validation options\n * @returns Validation result with errors and warnings\n *\n * @example\n * ```ts\n * const result = validatePuckData(puckData)\n * if (!result.valid) {\n * console.error('Validation errors:', result.errors)\n * }\n * ```\n */\nexport function validatePuckData(\n data: unknown,\n options: ValidationOptions = {}\n): ValidationResult {\n const {\n requireContentIds = true,\n validateRoot = true,\n requiredRootProps = ['title'],\n allowedComponentTypes,\n strictComponentTypes = false,\n } = options\n\n const errors: string[] = []\n const warnings: string[] = []\n\n // Basic type check\n if (!data || typeof data !== 'object') {\n errors.push('Data must be a non-null object')\n return { valid: false, errors, warnings }\n }\n\n const obj = data as Record<string, unknown>\n\n // ==========================================================================\n // Validate root structure\n // ==========================================================================\n\n if (!obj.root || typeof obj.root !== 'object') {\n errors.push('Missing or invalid root object')\n } else if (validateRoot) {\n const root = obj.root as Record<string, unknown>\n\n if (!root.props || typeof root.props !== 'object') {\n errors.push('Missing root.props object')\n } else {\n const rootProps = root.props as Record<string, unknown>\n\n // Check required root props\n for (const prop of requiredRootProps) {\n if (rootProps[prop] === undefined || rootProps[prop] === null) {\n errors.push(`Missing required root prop: ${prop}`)\n }\n }\n\n // Validate pageLayout if present\n if (rootProps.pageLayout !== undefined) {\n if (typeof rootProps.pageLayout !== 'string') {\n errors.push('root.props.pageLayout must be a string')\n }\n }\n }\n }\n\n // ==========================================================================\n // Validate content array\n // ==========================================================================\n\n if (!Array.isArray(obj.content)) {\n errors.push('content must be an array')\n } else {\n const seenIds = new Set<string>()\n\n obj.content.forEach((item, index) => {\n if (!item || typeof item !== 'object') {\n errors.push(`Content item at index ${index} is not an object`)\n return\n }\n\n const contentItem = item as Record<string, unknown>\n\n // Validate type\n if (!contentItem.type || typeof contentItem.type !== 'string') {\n errors.push(`Content item at index ${index} missing or invalid type`)\n } else if (allowedComponentTypes) {\n if (!allowedComponentTypes.includes(contentItem.type)) {\n const message = `Unknown component type \"${contentItem.type}\" at index ${index}`\n if (strictComponentTypes) {\n errors.push(message)\n } else {\n warnings.push(message)\n }\n }\n }\n\n // Validate props\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n errors.push(`Content item at index ${index} missing props object`)\n } else if (requireContentIds) {\n const props = contentItem.props as Record<string, unknown>\n\n if (!props.id || typeof props.id !== 'string') {\n errors.push(`Content item at index ${index} missing or invalid props.id`)\n } else {\n // Check for duplicate IDs\n if (seenIds.has(props.id)) {\n warnings.push(\n `Duplicate content item ID \"${props.id}\" at index ${index}`\n )\n }\n seenIds.add(props.id)\n }\n }\n })\n }\n\n // ==========================================================================\n // Validate zones\n // ==========================================================================\n\n if (obj.zones !== undefined) {\n if (typeof obj.zones !== 'object' || obj.zones === null) {\n errors.push('zones must be an object')\n } else {\n const zones = obj.zones as Record<string, unknown>\n\n for (const [zoneName, zoneContent] of Object.entries(zones)) {\n if (!Array.isArray(zoneContent)) {\n errors.push(`Zone \"${zoneName}\" content must be an array`)\n continue\n }\n\n zoneContent.forEach((item, index) => {\n if (!item || typeof item !== 'object') {\n errors.push(`Zone \"${zoneName}\" item at index ${index} is not an object`)\n return\n }\n\n const contentItem = item as Record<string, unknown>\n\n if (!contentItem.type || typeof contentItem.type !== 'string') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing or invalid type`\n )\n }\n\n if (!contentItem.props || typeof contentItem.props !== 'object') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing props object`\n )\n } else if (requireContentIds) {\n const props = contentItem.props as Record<string, unknown>\n if (!props.id || typeof props.id !== 'string') {\n errors.push(\n `Zone \"${zoneName}\" item at index ${index} missing or invalid props.id`\n )\n }\n }\n })\n }\n }\n }\n\n return {\n valid: errors.length === 0,\n errors,\n warnings,\n }\n}\n\n/**\n * Validates and returns typed PuckPageData, throwing if invalid.\n *\n * @param data - The data to validate\n * @param options - Validation options\n * @returns The validated PuckPageData\n * @throws Error if validation fails\n */\nexport function assertPuckData(\n data: unknown,\n options?: ValidationOptions\n): PuckPageData {\n const result = validatePuckData(data, options)\n\n if (!result.valid) {\n throw new Error(\n `Invalid Puck data: ${result.errors.join('; ')}`\n )\n }\n\n return data as PuckPageData\n}\n\n/**\n * Safely parses JSON and validates as PuckPageData.\n *\n * @param json - JSON string to parse\n * @param options - Validation options\n * @returns Validation result with parsed data if valid\n */\nexport function parsePuckDataJson(\n json: string,\n options?: ValidationOptions\n): ValidationResult & { data?: PuckPageData } {\n let parsed: unknown\n\n try {\n parsed = JSON.parse(json)\n } catch (e) {\n return {\n valid: false,\n errors: [`Invalid JSON: ${e instanceof Error ? e.message : 'Parse error'}`],\n warnings: [],\n }\n }\n\n const result = validatePuckData(parsed, options)\n\n if (result.valid) {\n return {\n ...result,\n data: parsed as PuckPageData,\n }\n }\n\n return result\n}\n"]}
@@ -0,0 +1,85 @@
1
+ import { L as LayoutDefinition, a as LayoutConfig, b as LayoutOption } from './types-D7D3rZ1J.mjs';
2
+
3
+ /**
4
+ * Default Layout Definitions
5
+ *
6
+ * These provide sensible defaults for common page layout patterns.
7
+ * Users can override or extend these in their own configuration.
8
+ */
9
+
10
+ /**
11
+ * Default layout - standard content width with padding
12
+ */
13
+ declare const defaultLayout: LayoutDefinition;
14
+ /**
15
+ * Landing layout - optimized for marketing/landing pages
16
+ */
17
+ declare const landingLayout: LayoutDefinition;
18
+ /**
19
+ * Full width layout - edge-to-edge content
20
+ */
21
+ declare const fullWidthLayout: LayoutDefinition;
22
+ /**
23
+ * Narrow layout - ideal for blog posts and articles
24
+ */
25
+ declare const narrowLayout: LayoutDefinition;
26
+ /**
27
+ * Wide layout - extra wide content area
28
+ */
29
+ declare const wideLayout: LayoutDefinition;
30
+ /**
31
+ * Default layouts included with the plugin
32
+ */
33
+ declare const DEFAULT_LAYOUTS: LayoutDefinition[];
34
+ /**
35
+ * Extended layouts for users who want more options
36
+ */
37
+ declare const EXTENDED_LAYOUTS: LayoutDefinition[];
38
+ /**
39
+ * Default layout configuration
40
+ */
41
+ declare const DEFAULT_LAYOUT_CONFIG: LayoutConfig;
42
+
43
+ /**
44
+ * Layout Utilities
45
+ *
46
+ * Functions for working with layout configurations.
47
+ */
48
+
49
+ /**
50
+ * Resolves a layout config, merging with defaults if needed
51
+ */
52
+ declare function resolveLayoutConfig(config?: Partial<LayoutConfig>): LayoutConfig;
53
+ /**
54
+ * Gets a layout definition by value
55
+ */
56
+ declare function getLayout(layouts: LayoutDefinition[], value: string, fallback?: string): LayoutDefinition | undefined;
57
+ /**
58
+ * Converts layout definitions to Puck select options
59
+ */
60
+ declare function layoutsToOptions(layouts: LayoutDefinition[]): LayoutOption[];
61
+ /**
62
+ * Converts layout definitions to Payload select options
63
+ */
64
+ declare function layoutsToPayloadOptions(layouts: LayoutDefinition[]): Array<{
65
+ label: string;
66
+ value: string;
67
+ }>;
68
+ /**
69
+ * Creates a custom layout definition
70
+ */
71
+ declare function createLayout(config: Omit<LayoutDefinition, 'value' | 'label'> & {
72
+ value: string;
73
+ label: string;
74
+ }): LayoutDefinition;
75
+ /**
76
+ * Merges layout configurations
77
+ */
78
+ declare function mergeLayouts(base: LayoutDefinition[], custom: LayoutDefinition[], options?: {
79
+ /** Replace base layouts instead of merging */
80
+ replace?: boolean;
81
+ /** Exclude these layout values from base */
82
+ exclude?: string[];
83
+ }): LayoutDefinition[];
84
+
85
+ export { DEFAULT_LAYOUTS as D, EXTENDED_LAYOUTS as E, DEFAULT_LAYOUT_CONFIG as a, layoutsToOptions as b, createLayout as c, defaultLayout as d, layoutsToPayloadOptions as e, fullWidthLayout as f, getLayout as g, landingLayout as l, mergeLayouts as m, narrowLayout as n, resolveLayoutConfig as r, wideLayout as w };