@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/plugin/index.mjs

@@ -1,555 +0,0 @@
-// src/layouts/defaults.ts
-var defaultLayout = {
-  value: "default",
-  label: "Default",
-  description: "Standard page layout with contained content width",
-  classes: {
-    wrapper: "",
-    container: "mx-auto px-4 sm:px-6 lg:px-8",
-    content: ""
-  },
-  maxWidth: "1200px",
-  fullWidth: false
-};
-var landingLayout = {
-  value: "landing",
-  label: "Landing",
-  description: "Full-width sections with no global container constraints",
-  classes: {
-    wrapper: "",
-    container: "",
-    content: ""
-  },
-  fullWidth: true
-};
-var fullWidthLayout = {
-  value: "full-width",
-  label: "Full Width",
-  description: "Content spans the full viewport width",
-  classes: {
-    wrapper: "w-full",
-    container: "w-full",
-    content: ""
-  },
-  maxWidth: "100%",
-  fullWidth: true
-};
-var DEFAULT_LAYOUTS = [
-  defaultLayout,
-  landingLayout,
-  fullWidthLayout
-];
-
-// src/layouts/utils.ts
-function layoutsToPayloadOptions(layouts) {
-  return layouts.map(({ value, label }) => ({
-    label,
-    value
-  }));
-}
-
-// src/plugin/fields/index.ts
-var puckDataField = {
-  name: "puckData",
-  type: "json",
-  admin: {
-    hidden: true,
-    description: "Puck editor data - managed via visual editor"
-  }
-};
-function createEditorVersionField(defaultValue = "puck", sidebar = true, legacyBlocksFieldName = "layout") {
-  return {
-    name: "editorVersion",
-    type: "select",
-    // NO defaultValue here - we use the hook to intelligently detect the value
-    // This prevents migrations from blindly setting 'puck' on legacy pages
-    options: [
-      { label: "Legacy (Payload Blocks)", value: "legacy" },
-      { label: "Puck Visual Editor", value: "puck" }
-    ],
-    admin: {
-      position: sidebar ? "sidebar" : void 0,
-      description: "Which editor was used to create this page"
-    },
-    hooks: {
-      beforeValidate: [
-        ({ value, data, operation }) => {
-          if (value) return value;
-          const legacyBlocks = data?.[legacyBlocksFieldName];
-          const hasLegacyBlocks = Array.isArray(legacyBlocks) && legacyBlocks.length > 0;
-          const puckData = data?.puckData;
-          const hasPuckData = puckData?.content && Array.isArray(puckData.content) && puckData.content.length > 0;
-          if (hasLegacyBlocks && !hasPuckData) {
-            return "legacy";
-          }
-          if (hasPuckData) {
-            return "puck";
-          }
-          return defaultValue;
-        }
-      ]
-    }
-  };
-}
-var editorVersionField = createEditorVersionField("puck", true);
-function createPageLayoutField(layouts = DEFAULT_LAYOUTS, sidebar = true) {
-  return {
-    name: "pageLayout",
-    type: "select",
-    required: true,
-    defaultValue: "default",
-    options: layoutsToPayloadOptions(layouts),
-    admin: {
-      position: sidebar ? "sidebar" : void 0,
-      description: "Overall page structure and layout style"
-    }
-  };
-}
-var pageLayoutField = createPageLayoutField();
-var isHomepageField = {
-  name: "isHomepage",
-  type: "checkbox",
-  defaultValue: false,
-  admin: {
-    position: "sidebar",
-    description: "Mark this page as the homepage"
-  }
-};
-var seoFieldGroup = {
-  name: "meta",
-  type: "group",
-  label: "SEO",
-  admin: {
-    position: "sidebar"
-  },
-  fields: [
-    {
-      name: "title",
-      type: "text",
-      label: "Meta Title",
-      admin: {
-        description: "Override the page title for search engines"
-      }
-    },
-    {
-      name: "description",
-      type: "textarea",
-      label: "Meta Description",
-      admin: {
-        description: "Description shown in search engine results"
-      }
-    },
-    {
-      name: "image",
-      type: "upload",
-      relationTo: "media",
-      label: "Open Graph Image",
-      admin: {
-        description: "Image shown when sharing on social media"
-      }
-    },
-    {
-      name: "noindex",
-      type: "checkbox",
-      label: "No Index",
-      defaultValue: false,
-      admin: {
-        description: "Prevent search engines from indexing this page"
-      }
-    },
-    {
-      name: "nofollow",
-      type: "checkbox",
-      label: "No Follow",
-      defaultValue: false,
-      admin: {
-        description: "Prevent search engines from following links on this page"
-      }
-    },
-    {
-      name: "excludeFromSitemap",
-      type: "checkbox",
-      label: "Exclude from Sitemap",
-      defaultValue: false,
-      admin: {
-        description: "Exclude this page from the XML sitemap"
-      }
-    }
-  ]
-};
-var DEFAULT_CONVERSION_TYPES = [
-  { label: "Lead", value: "lead" },
-  { label: "Registration", value: "registration" },
-  { label: "Purchase", value: "purchase" },
-  { label: "Donation", value: "donation" },
-  { label: "Newsletter Signup", value: "newsletter" },
-  { label: "Contact Form", value: "contact" },
-  { label: "Custom", value: "custom" }
-];
-function createConversionFieldGroup(conversionTypes = DEFAULT_CONVERSION_TYPES, sidebar = true) {
-  return {
-    name: "conversionTracking",
-    type: "group",
-    label: "Conversion Tracking",
-    admin: {
-      position: sidebar ? "sidebar" : void 0,
-      description: "Configure conversion tracking for analytics"
-    },
-    fields: [
-      {
-        name: "isConversionPage",
-        type: "checkbox",
-        label: "Is Conversion Page",
-        defaultValue: false,
-        admin: {
-          description: "Check this if this page represents a completed conversion (e.g., thank you page)"
-        }
-      },
-      {
-        name: "conversionType",
-        type: "select",
-        label: "Conversion Type",
-        options: conversionTypes,
-        admin: {
-          description: "Type of conversion this page represents",
-          condition: (data, siblingData) => siblingData?.isConversionPage === true
-        }
-      },
-      {
-        name: "conversionValue",
-        type: "number",
-        label: "Conversion Value",
-        defaultValue: 0,
-        admin: {
-          description: "Monetary value of this conversion (0 for non-monetary conversions)",
-          condition: (data, siblingData) => siblingData?.isConversionPage === true
-        }
-      }
-    ]
-  };
-}
-var conversionFieldGroup = createConversionFieldGroup();
-function getPuckFields(options = {}) {
-  const {
-    includeSEO = true,
-    includeConversion = false,
-    includeEditorVersion = true,
-    includePageLayout = true,
-    includeIsHomepage = false,
-    layouts = DEFAULT_LAYOUTS,
-    defaultEditorVersion = "puck",
-    legacyBlocksFieldName = "layout",
-    sidebarPosition = true,
-    conversionTypeOptions
-  } = options;
-  const fields = [];
-  fields.push(puckDataField);
-  if (includeEditorVersion) {
-    fields.push(createEditorVersionField(defaultEditorVersion, sidebarPosition, legacyBlocksFieldName));
-  }
-  if (includePageLayout) {
-    fields.push(createPageLayoutField(layouts, sidebarPosition));
-  }
-  if (includeIsHomepage) {
-    fields.push(isHomepageField);
-  }
-  if (includeSEO) {
-    fields.push(seoFieldGroup);
-  }
-  if (includeConversion) {
-    fields.push(createConversionFieldGroup(conversionTypeOptions, sidebarPosition));
-  }
-  return fields;
-}
-
-// src/plugin/collections/Pages.ts
-var defaultAccess = () => true;
-function generatePagesCollection(slug, options) {
-  const {
-    collectionOverrides = {},
-    access = {},
-    layouts = DEFAULT_LAYOUTS,
-    additionalFields = []
-  } = options;
-  const baseFields = [
-    // Core Fields (title and slug with duplication hooks - unique to collection generation)
-    {
-      name: "title",
-      type: "text",
-      required: true,
-      hooks: {
-        beforeDuplicate: [
-          ({ value }) => {
-            if (!value) return value;
-            const copyMatch = value.match(/^(.+) \(Copy(?: (\d+))?\)$/);
-            if (copyMatch) {
-              const baseName = copyMatch[1];
-              const copyNum = copyMatch[2] ? parseInt(copyMatch[2], 10) + 1 : 2;
-              return `${baseName} (Copy ${copyNum})`;
-            }
-            return `${value} (Copy)`;
-          }
-        ]
-      }
-    },
-    {
-      name: "slug",
-      type: "text",
-      required: true,
-      unique: true,
-      index: true,
-      admin: {
-        position: "sidebar",
-        description: "URL path for this page (auto-generated from title)"
-      },
-      hooks: {
-        beforeValidate: [
-          ({ data, value }) => {
-            if (data && !value && data.title) {
-              return data.title.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").trim();
-            }
-            return value;
-          }
-        ],
-        beforeDuplicate: [
-          ({ value }) => {
-            if (!value) return value;
-            const copyMatch = value.match(/^(.+)-copy(?:-(\d+))?$/);
-            if (copyMatch) {
-              const baseName = copyMatch[1];
-              const copyNum = copyMatch[2] ? parseInt(copyMatch[2], 10) + 1 : 2;
-              return `${baseName}-copy-${copyNum}`;
-            }
-            return `${value}-copy`;
-          }
-        ]
-      }
-    },
-    // Page Layout
-    createPageLayoutField(layouts, true),
-    // Editor Version
-    createEditorVersionField("puck", true),
-    // Homepage Flag
-    isHomepageField,
-    // Puck Data (hidden - managed via visual editor)
-    puckDataField,
-    // SEO Fields
-    seoFieldGroup,
-    // Conversion Tracking Fields
-    conversionFieldGroup,
-    // Additional fields from options
-    ...additionalFields
-  ];
-  return {
-    slug,
-    admin: {
-      useAsTitle: "title",
-      group: "Content",
-      defaultColumns: ["title", "slug", "_status", "updatedAt"],
-      ...collectionOverrides.admin ?? {}
-    },
-    access: {
-      read: access.read ?? defaultAccess,
-      create: access.create ?? defaultAccess,
-      update: access.update ?? defaultAccess,
-      delete: access.delete ?? defaultAccess,
-      ...collectionOverrides.access ?? {}
-    },
-    versions: typeof collectionOverrides.versions === "object" ? { drafts: true, ...collectionOverrides.versions } : { drafts: true },
-    fields: baseFields,
-    ...collectionOverrides,
-    // Ensure fields aren't overwritten by collectionOverrides
-    ...collectionOverrides.fields && {
-      fields: [...baseFields, ...collectionOverrides.fields]
-    }
-  };
-}
-
-// src/collections/Templates.ts
-var TemplatesCollection = {
-  slug: "puck-templates",
-  admin: {
-    useAsTitle: "name",
-    group: "Puck",
-    defaultColumns: ["name", "category", "updatedAt"],
-    description: "Reusable component templates for the visual editor"
-  },
-  access: {
-    read: () => true,
-    create: ({ req }) => !!req.user,
-    update: ({ req }) => !!req.user,
-    delete: ({ req }) => !!req.user
-  },
-  fields: [
-    {
-      name: "name",
-      type: "text",
-      required: true,
-      admin: {
-        description: "A descriptive name for this template"
-      }
-    },
-    {
-      name: "description",
-      type: "textarea",
-      admin: {
-        description: "Optional description of what this template contains"
-      }
-    },
-    {
-      name: "category",
-      type: "text",
-      admin: {
-        description: 'Category for organizing templates (e.g., "Hero", "Footer", "CTA")'
-      }
-    },
-    {
-      name: "content",
-      type: "json",
-      required: true,
-      admin: {
-        description: "Serialized Puck component data"
-      }
-    },
-    {
-      name: "thumbnail",
-      type: "text",
-      admin: {
-        description: "Optional thumbnail URL for template preview"
-      }
-    }
-  ],
-  timestamps: true
-};
-
-// src/plugin/index.ts
-function getExistingFieldNames(fields) {
-  const names = /* @__PURE__ */ new Set();
-  function addFieldNames(fieldsToCheck) {
-    for (const field of fieldsToCheck) {
-      if ("name" in field && field.name) {
-        names.add(field.name);
-      }
-      if ("fields" in field && Array.isArray(field.fields)) {
-        addFieldNames(field.fields);
-      }
-      if (field.type === "tabs" && "tabs" in field && Array.isArray(field.tabs)) {
-        for (const tab of field.tabs) {
-          if ("fields" in tab && Array.isArray(tab.fields)) {
-            addFieldNames(tab.fields);
-          }
-        }
-      }
-    }
-  }
-  addFieldNames(fields);
-  return names;
-}
-function filterExistingFields(fieldsToAdd, existingNames) {
-  return fieldsToAdd.filter((field) => {
-    if ("name" in field && field.name) {
-      return !existingNames.has(field.name);
-    }
-    return true;
-  });
-}
-function generatePuckEditField(collectionSlug, adminConfig = {}) {
-  const {
-    editorPathPattern = "/pages/{id}/edit",
-    buttonLabel = "Edit with Puck",
-    buttonPosition
-    // undefined = main area (default), 'sidebar' = sidebar
-  } = adminConfig;
-  return {
-    name: "puckEdit",
-    type: "ui",
-    admin: {
-      // Only set position if explicitly specified (sidebar)
-      // undefined means main form area in Payload
-      ...buttonPosition && { position: buttonPosition },
-      components: {
-        Field: "@delmaredigital/payload-puck/admin/client#EditWithPuckButton",
-        Cell: "@delmaredigital/payload-puck/admin/client#EditWithPuckCell"
-      },
-      custom: {
-        collectionSlug,
-        editorPathPattern,
-        label: buttonLabel
-      }
-    }
-  };
-}
-function createPuckPlugin(options = {}) {
-  const {
-    pagesCollection = "pages",
-    autoGenerateCollection = true,
-    admin: adminConfig = {}
-  } = options;
-  const { addEditButton = true } = adminConfig;
-  return (incomingConfig) => {
-    let collections = incomingConfig.collections || [];
-    const templatesCollectionExists = collections.some(
-      (c) => c.slug === "puck-templates"
-    );
-    if (!templatesCollectionExists) {
-      collections = [...collections, TemplatesCollection];
-    }
-    if (autoGenerateCollection) {
-      const existingCollectionIndex = collections.findIndex(
-        (c) => c.slug === pagesCollection
-      );
-      const editButtonField = addEditButton ? [generatePuckEditField(pagesCollection, adminConfig)] : [];
-      if (existingCollectionIndex >= 0) {
-        const existingCollection = collections[existingCollectionIndex];
-        const existingFields = existingCollection.fields || [];
-        const existingFieldNames = getExistingFieldNames(existingFields);
-        const puckFields = getPuckFields({
-          includeSEO: !existingFieldNames.has("meta"),
-          includeConversion: !existingFieldNames.has("conversionTracking"),
-          includeEditorVersion: !existingFieldNames.has("editorVersion"),
-          includePageLayout: !existingFieldNames.has("pageLayout"),
-          includeIsHomepage: !existingFieldNames.has("isHomepage"),
-          layouts: options.layouts
-        });
-        const fieldsToAdd = filterExistingFields(puckFields, existingFieldNames);
-        const editFieldsToAdd = existingFieldNames.has("puckEdit") ? [] : editButtonField;
-        collections = [
-          ...collections.slice(0, existingCollectionIndex),
-          {
-            ...existingCollection,
-            // Ensure drafts are enabled for Puck
-            versions: typeof existingCollection.versions === "object" ? { drafts: true, ...existingCollection.versions } : existingCollection.versions ?? { drafts: true },
-            fields: [
-              ...existingFields,
-              ...fieldsToAdd,
-              ...editFieldsToAdd
-            ]
-          },
-          ...collections.slice(existingCollectionIndex + 1)
-        ];
-      } else {
-        const generatedCollection = generatePagesCollection(pagesCollection, options);
-        collections = [
-          ...collections,
-          {
-            ...generatedCollection,
-            fields: [...generatedCollection.fields, ...editButtonField]
-          }
-        ];
-      }
-    }
-    return {
-      ...incomingConfig,
-      collections,
-      onInit: async (payload) => {
-        if (incomingConfig.onInit) {
-          await incomingConfig.onInit(payload);
-        }
-      }
-    };
-  };
-}
-
-export { TemplatesCollection, conversionFieldGroup, createEditorVersionField, createPageLayoutField, createPuckPlugin, editorVersionField, generatePagesCollection, generatePuckEditField, getPuckFields, isHomepageField, pageLayoutField, puckDataField, seoFieldGroup };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/render/index.d.mts

@@ -1,109 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Data, Config } from '@measured/puck';
-import { L as LayoutDefinition } from '../types-D7D3rZ1J.mjs';
-import { ReactNode } from 'react';
-
-interface PageRendererProps {
-    /**
-     * Puck data to render
-     */
-    data: Data;
-    /**
-     * Puck configuration to use
-     * @default baseConfig
-     */
-    config?: Config;
-    /**
-     * Optional wrapper component (takes precedence over layout)
-     */
-    wrapper?: React.ComponentType<{
-        children: React.ReactNode;
-    }>;
-    /**
-     * Optional className for the wrapper
-     */
-    className?: string;
-    /**
-     * Available layouts for this page
-     * @default DEFAULT_LAYOUTS
-     */
-    layouts?: LayoutDefinition[];
-}
-/**
- * Renders a Puck page using the provided data and configuration
- *
- * @example
- * ```tsx
- * import { PageRenderer } from '@delmaredigital/payload-puck/render'
- * import { baseConfig } from '@delmaredigital/payload-puck/config'
- * import { ThemeProvider } from '@delmaredigital/payload-puck/theme'
- *
- * export default async function Page({ params }) {
- *   const page = await getPage(params.slug)
- *
- *   // Wrap with ThemeProvider if using theming
- *   return (
- *     <ThemeProvider theme={myTheme}>
- *       <PageRenderer data={page.puckData} config={baseConfig} />
- *     </ThemeProvider>
- *   )
- * }
- * ```
- */
-declare function PageRenderer({ data, config, wrapper: Wrapper, className, layouts, }: PageRendererProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Page data shape for hybrid rendering
- */
-interface HybridPageData {
-    /**
-     * Which editor was used to create the page
-     * - 'puck': Page was created/edited with Puck visual editor
-     * - 'legacy': Page uses traditional Payload block fields
-     */
-    editorVersion?: 'legacy' | 'puck';
-    /**
-     * Puck editor data (for pages with editorVersion: 'puck')
-     */
-    puckData?: Data | null;
-    /**
-     * Legacy blocks array (for pages with editorVersion: 'legacy')
-     * The field name varies by project (e.g., 'layout', 'blocks', 'content')
-     */
-    [key: string]: unknown;
-}
-interface HybridPageRendererProps extends Omit<PageRendererProps, 'data'> {
-    /**
-     * Page document containing editorVersion, puckData, and optionally legacy blocks
-     */
-    page: HybridPageData;
-    /**
-     * Render function for legacy Payload blocks.
-     * Called when editorVersion is 'legacy' or when puckData is not available.
-     *
-     * @param blocks - The legacy blocks array from the page
-     * @returns React node to render
-     */
-    legacyRenderer: (blocks: unknown[]) => ReactNode;
-    /**
-     * Name of the field containing legacy blocks
-     * @default 'layout'
-     */
-    legacyBlocksField?: string;
-    /**
-     * Fallback content when no content is available
-     * @default <div>No content available</div>
-     */
-    fallback?: ReactNode;
-}
-/**
- * Renders a page using either Puck or legacy Payload blocks
- *
- * Decision logic:
- * 1. If editorVersion is 'puck' AND puckData has content → render with PageRenderer
- * 2. If legacy blocks exist → render with legacyRenderer
- * 3. Otherwise → render fallback
- */
-declare function HybridPageRenderer({ page, legacyRenderer, legacyBlocksField, fallback, config, layouts, wrapper, className, }: HybridPageRendererProps): react_jsx_runtime.JSX.Element;
-
-export { type HybridPageData, HybridPageRenderer, type HybridPageRendererProps, PageRenderer, type PageRendererProps };