@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/utils/index.mjs

@@ -1,412 +0,0 @@
-// src/utils/migration.ts
-var blockTypeMap = {
-  heroBlock: "Hero",
-  richTextBlock: "RichText",
-  containerBlock: "Container",
-  flexBlock: "Flex",
-  gridBlock: "Grid",
-  sectionBlock: "Section",
-  spacerBlock: "Spacer",
-  headingBlock: "Heading",
-  textBlock: "Text",
-  imageBlock: "Image",
-  buttonBlock: "Button",
-  cardBlock: "Card",
-  dividerBlock: "Divider",
-  accordionBlock: "Accordion"
-};
-function generatePuckId(legacyId) {
-  if (legacyId) {
-    return legacyId;
-  }
-  return `puck-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
-}
-function transformMediaReference(media) {
-  if (media === null || media === void 0) {
-    return null;
-  }
-  if (typeof media === "number" || typeof media === "string") {
-    return { id: media };
-  }
-  return {
-    id: media.id,
-    url: media.url,
-    alt: media.alt,
-    width: media.width,
-    height: media.height
-  };
-}
-function transformRichText(richText) {
-  if (!richText) {
-    return void 0;
-  }
-  if (typeof richText === "string") {
-    return richText;
-  }
-  if (typeof richText === "object") {
-    try {
-      return JSON.stringify(richText);
-    } catch {
-      console.warn("[payload-puck] Failed to serialize rich text content");
-      return void 0;
-    }
-  }
-  return void 0;
-}
-function transformRelationshipArray(relations) {
-  if (!relations || !Array.isArray(relations)) {
-    return void 0;
-  }
-  return relations.map((rel) => {
-    if (typeof rel === "number" || typeof rel === "string") {
-      return { id: rel, title: "" };
-    }
-    return {
-      id: rel.id,
-      title: rel.title || "",
-      slug: rel.slug
-    };
-  });
-}
-var RICH_TEXT_FIELDS = [
-  "headingRich",
-  "subheadingRich",
-  "textRich",
-  "content",
-  "leftContent",
-  "rightContent",
-  "bodyContent",
-  "description"
-];
-var MEDIA_FIELDS = [
-  "backgroundImage",
-  "image",
-  "rightImage",
-  "leftImage",
-  "profileImage",
-  "media",
-  "thumbnail",
-  "icon"
-];
-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)
-  };
-  for (const [key, value] of Object.entries(restProps)) {
-    if (customTransformers[key]) {
-      props[key] = customTransformers[key](value);
-      continue;
-    }
-    if (richTextFields.includes(key)) {
-      props[key] = transformRichText(value);
-      continue;
-    }
-    if (mediaFields.includes(key)) {
-      props[key] = transformMediaReference(
-        value
-      );
-      continue;
-    }
-    if (Array.isArray(value)) {
-      props[key] = value.map((item) => {
-        if (typeof item === "object" && item !== null) {
-          const { id: itemId, ...itemRest } = item;
-          return {
-            ...itemRest,
-            id: itemId || generatePuckId()
-          };
-        }
-        return item;
-      });
-      continue;
-    }
-    props[key] = value;
-  }
-  return props;
-}
-function migrateLegacyToPuck(page, options = {}) {
-  const {
-    blockTypeMap: customBlockTypeMap,
-    richTextFields,
-    mediaFields,
-    customTransformers,
-    skipUnknownBlocks = true,
-    onUnknownBlock
-  } = options;
-  const effectiveBlockTypeMap = {
-    ...blockTypeMap,
-    ...customBlockTypeMap
-  };
-  const rootProps = {
-    title: page.title,
-    pageLayout: page.pageLayout || "default"
-  };
-  const content = [];
-  if (page.layout && Array.isArray(page.layout)) {
-    for (const block of page.layout) {
-      const legacyBlock = block;
-      const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
-      if (!puckType) {
-        if (onUnknownBlock) {
-          const customItem = onUnknownBlock(legacyBlock);
-          if (customItem) {
-            content.push(customItem);
-          }
-          continue;
-        }
-        if (skipUnknownBlocks) {
-          console.warn(
-            `[payload-puck] Unknown block type "${legacyBlock.blockType}" - skipping during migration`
-          );
-          continue;
-        }
-        throw new Error(
-          `Unknown block type "${legacyBlock.blockType}" encountered during migration`
-        );
-      }
-      const transformedProps = transformBlockProps(legacyBlock, {
-        richTextFields,
-        mediaFields,
-        customTransformers
-      });
-      const contentItem = {
-        type: puckType,
-        props: transformedProps
-      };
-      content.push(contentItem);
-    }
-  }
-  const puckData = {
-    root: {
-      props: rootProps
-    },
-    content,
-    zones: {}
-  };
-  return puckData;
-}
-function getMigrationPreview(page, customBlockTypeMap) {
-  const warnings = [];
-  const blockTypes = [];
-  const unmappedBlockTypes = [];
-  const effectiveBlockTypeMap = {
-    ...blockTypeMap,
-    ...customBlockTypeMap
-  };
-  if (page.layout && Array.isArray(page.layout)) {
-    for (const block of page.layout) {
-      const legacyBlock = block;
-      const puckType = effectiveBlockTypeMap[legacyBlock.blockType];
-      if (puckType) {
-        blockTypes.push(puckType);
-      } else {
-        warnings.push(`Unknown block type: ${legacyBlock.blockType}`);
-        if (!unmappedBlockTypes.includes(legacyBlock.blockType)) {
-          unmappedBlockTypes.push(legacyBlock.blockType);
-        }
-      }
-    }
-  }
-  return {
-    title: page.title,
-    slug: page.slug,
-    blockCount: page.layout?.length || 0,
-    blockTypes,
-    warnings,
-    unmappedBlockTypes
-  };
-}
-
-// src/utils/validation.ts
-function isPuckData(data) {
-  if (!data || typeof data !== "object") {
-    return false;
-  }
-  const obj = data;
-  if (!obj.root || typeof obj.root !== "object") {
-    return false;
-  }
-  const root = obj.root;
-  if (!root.props || typeof root.props !== "object") {
-    return false;
-  }
-  if (!Array.isArray(obj.content)) {
-    return false;
-  }
-  for (const item of obj.content) {
-    if (!item || typeof item !== "object") {
-      return false;
-    }
-    const contentItem = item;
-    if (typeof contentItem.type !== "string") {
-      return false;
-    }
-    if (!contentItem.props || typeof contentItem.props !== "object") {
-      return false;
-    }
-  }
-  if (obj.zones !== void 0 && typeof obj.zones !== "object") {
-    return false;
-  }
-  return true;
-}
-function isPuckRootProps(props) {
-  if (!props || typeof props !== "object") {
-    return false;
-  }
-  return true;
-}
-function validatePuckData(data, options = {}) {
-  const {
-    requireContentIds = true,
-    validateRoot = true,
-    requiredRootProps = ["title"],
-    allowedComponentTypes,
-    strictComponentTypes = false
-  } = options;
-  const errors = [];
-  const warnings = [];
-  if (!data || typeof data !== "object") {
-    errors.push("Data must be a non-null object");
-    return { valid: false, errors, warnings };
-  }
-  const obj = data;
-  if (!obj.root || typeof obj.root !== "object") {
-    errors.push("Missing or invalid root object");
-  } else if (validateRoot) {
-    const root = obj.root;
-    if (!root.props || typeof root.props !== "object") {
-      errors.push("Missing root.props object");
-    } else {
-      const rootProps = root.props;
-      for (const prop of requiredRootProps) {
-        if (rootProps[prop] === void 0 || rootProps[prop] === null) {
-          errors.push(`Missing required root prop: ${prop}`);
-        }
-      }
-      if (rootProps.pageLayout !== void 0) {
-        if (typeof rootProps.pageLayout !== "string") {
-          errors.push("root.props.pageLayout must be a string");
-        }
-      }
-    }
-  }
-  if (!Array.isArray(obj.content)) {
-    errors.push("content must be an array");
-  } else {
-    const seenIds = /* @__PURE__ */ new Set();
-    obj.content.forEach((item, index) => {
-      if (!item || typeof item !== "object") {
-        errors.push(`Content item at index ${index} is not an object`);
-        return;
-      }
-      const contentItem = item;
-      if (!contentItem.type || typeof contentItem.type !== "string") {
-        errors.push(`Content item at index ${index} missing or invalid type`);
-      } else if (allowedComponentTypes) {
-        if (!allowedComponentTypes.includes(contentItem.type)) {
-          const message = `Unknown component type "${contentItem.type}" at index ${index}`;
-          if (strictComponentTypes) {
-            errors.push(message);
-          } else {
-            warnings.push(message);
-          }
-        }
-      }
-      if (!contentItem.props || typeof contentItem.props !== "object") {
-        errors.push(`Content item at index ${index} missing props object`);
-      } 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 {
-          if (seenIds.has(props.id)) {
-            warnings.push(
-              `Duplicate content item ID "${props.id}" at index ${index}`
-            );
-          }
-          seenIds.add(props.id);
-        }
-      }
-    });
-  }
-  if (obj.zones !== void 0) {
-    if (typeof obj.zones !== "object" || obj.zones === null) {
-      errors.push("zones must be an object");
-    } else {
-      const zones = obj.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) => {
-          if (!item || typeof item !== "object") {
-            errors.push(`Zone "${zoneName}" item at index ${index} is not an object`);
-            return;
-          }
-          const contentItem = item;
-          if (!contentItem.type || typeof contentItem.type !== "string") {
-            errors.push(
-              `Zone "${zoneName}" item at index ${index} missing or invalid type`
-            );
-          }
-          if (!contentItem.props || typeof contentItem.props !== "object") {
-            errors.push(
-              `Zone "${zoneName}" item at index ${index} missing props object`
-            );
-          } 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`
-              );
-            }
-          }
-        });
-      }
-    }
-  }
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-function assertPuckData(data, options) {
-  const result = validatePuckData(data, options);
-  if (!result.valid) {
-    throw new Error(
-      `Invalid Puck data: ${result.errors.join("; ")}`
-    );
-  }
-  return data;
-}
-function parsePuckDataJson(json, options) {
-  let parsed;
-  try {
-    parsed = JSON.parse(json);
-  } catch (e) {
-    return {
-      valid: false,
-      errors: [`Invalid JSON: ${e instanceof Error ? e.message : "Parse error"}`],
-      warnings: []
-    };
-  }
-  const result = validatePuckData(parsed, options);
-  if (result.valid) {
-    return {
-      ...result,
-      data: parsed
-    };
-  }
-  return result;
-}
-
-export { assertPuckData, blockTypeMap, generatePuckId, getMigrationPreview, isPuckData, isPuckRootProps, migrateLegacyToPuck, parsePuckDataJson, transformBlockProps, transformMediaReference, transformRelationshipArray, transformRichText, validatePuckData };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/utils-DaRs9t0J.d.mts

@@ -1,85 +0,0 @@
-import { L as LayoutDefinition, a as LayoutConfig, b as LayoutOption } from './types-D7D3rZ1J.mjs';
-
-/**
- * Default Layout Definitions
- *
- * These provide sensible defaults for common page layout patterns.
- * Users can override or extend these in their own configuration.
- */
-
-/**
- * Default layout - standard content width with padding
- */
-declare const defaultLayout: LayoutDefinition;
-/**
- * Landing layout - optimized for marketing/landing pages
- */
-declare const landingLayout: LayoutDefinition;
-/**
- * Full width layout - edge-to-edge content
- */
-declare const fullWidthLayout: LayoutDefinition;
-/**
- * Narrow layout - ideal for blog posts and articles
- */
-declare const narrowLayout: LayoutDefinition;
-/**
- * Wide layout - extra wide content area
- */
-declare const wideLayout: LayoutDefinition;
-/**
- * Default layouts included with the plugin
- */
-declare const DEFAULT_LAYOUTS: LayoutDefinition[];
-/**
- * Extended layouts for users who want more options
- */
-declare const EXTENDED_LAYOUTS: LayoutDefinition[];
-/**
- * Default layout configuration
- */
-declare const DEFAULT_LAYOUT_CONFIG: LayoutConfig;
-
-/**
- * Layout Utilities
- *
- * Functions for working with layout configurations.
- */
-
-/**
- * Resolves a layout config, merging with defaults if needed
- */
-declare function resolveLayoutConfig(config?: Partial<LayoutConfig>): LayoutConfig;
-/**
- * Gets a layout definition by value
- */
-declare function getLayout(layouts: LayoutDefinition[], value: string, fallback?: string): LayoutDefinition | undefined;
-/**
- * Converts layout definitions to Puck select options
- */
-declare function layoutsToOptions(layouts: LayoutDefinition[]): LayoutOption[];
-/**
- * Converts layout definitions to Payload select options
- */
-declare function layoutsToPayloadOptions(layouts: LayoutDefinition[]): Array<{
-    label: string;
-    value: string;
-}>;
-/**
- * Creates a custom layout definition
- */
-declare function createLayout(config: Omit<LayoutDefinition, 'value' | 'label'> & {
-    value: string;
-    label: string;
-}): LayoutDefinition;
-/**
- * Merges layout configurations
- */
-declare function mergeLayouts(base: LayoutDefinition[], custom: LayoutDefinition[], options?: {
-    /** Replace base layouts instead of merging */
-    replace?: boolean;
-    /** Exclude these layout values from base */
-    exclude?: string[];
-}): LayoutDefinition[];
-
-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 };

package/dist/utils-gAvt0Vhw.d.ts

@@ -1,85 +0,0 @@
-import { L as LayoutDefinition, a as LayoutConfig, b as LayoutOption } from './types-D7D3rZ1J.js';
-
-/**
- * Default Layout Definitions
- *
- * These provide sensible defaults for common page layout patterns.
- * Users can override or extend these in their own configuration.
- */
-
-/**
- * Default layout - standard content width with padding
- */
-declare const defaultLayout: LayoutDefinition;
-/**
- * Landing layout - optimized for marketing/landing pages
- */
-declare const landingLayout: LayoutDefinition;
-/**
- * Full width layout - edge-to-edge content
- */
-declare const fullWidthLayout: LayoutDefinition;
-/**
- * Narrow layout - ideal for blog posts and articles
- */
-declare const narrowLayout: LayoutDefinition;
-/**
- * Wide layout - extra wide content area
- */
-declare const wideLayout: LayoutDefinition;
-/**
- * Default layouts included with the plugin
- */
-declare const DEFAULT_LAYOUTS: LayoutDefinition[];
-/**
- * Extended layouts for users who want more options
- */
-declare const EXTENDED_LAYOUTS: LayoutDefinition[];
-/**
- * Default layout configuration
- */
-declare const DEFAULT_LAYOUT_CONFIG: LayoutConfig;
-
-/**
- * Layout Utilities
- *
- * Functions for working with layout configurations.
- */
-
-/**
- * Resolves a layout config, merging with defaults if needed
- */
-declare function resolveLayoutConfig(config?: Partial<LayoutConfig>): LayoutConfig;
-/**
- * Gets a layout definition by value
- */
-declare function getLayout(layouts: LayoutDefinition[], value: string, fallback?: string): LayoutDefinition | undefined;
-/**
- * Converts layout definitions to Puck select options
- */
-declare function layoutsToOptions(layouts: LayoutDefinition[]): LayoutOption[];
-/**
- * Converts layout definitions to Payload select options
- */
-declare function layoutsToPayloadOptions(layouts: LayoutDefinition[]): Array<{
-    label: string;
-    value: string;
-}>;
-/**
- * Creates a custom layout definition
- */
-declare function createLayout(config: Omit<LayoutDefinition, 'value' | 'label'> & {
-    value: string;
-    label: string;
-}): LayoutDefinition;
-/**
- * Merges layout configurations
- */
-declare function mergeLayouts(base: LayoutDefinition[], custom: LayoutDefinition[], options?: {
-    /** Replace base layouts instead of merging */
-    replace?: boolean;
-    /** Exclude these layout values from base */
-    exclude?: string[];
-}): LayoutDefinition[];
-
-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 };