@orion-studios/payload-studio 0.6.0-beta.184 → 0.6.0-beta.186

package/dist/studio-pages/index.js

@@ -20,9 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/studio-pages/index.ts
 var studio_pages_exports = {};
 __export(studio_pages_exports, {
+  DEFAULT_LEGACY_HERO_BACKGROUND_COLORS: () => DEFAULT_LEGACY_HERO_BACKGROUND_COLORS,
   createDefaultStudioDocument: () => createDefaultStudioDocument,
+  createStudioPageFields: () => createStudioPageFields,
   createStudioPageService: () => createStudioPageService,
+  createStudioPagesCollection: () => createStudioPagesCollection,
   defaultBuilderThemeTokens: () => defaultBuilderThemeTokens,
+  defaultRelationshipHydrationMap: () => defaultRelationshipHydrationMap,
   getStudioDocumentFromPage: () => getStudioDocumentFromPage,
   layoutToStudioDocument: () => layoutToStudioDocument,
   pageInspectorPanels: () => pageInspectorPanels,
@@ -54,6 +58,148 @@ var sectionStyleDefaults = {
   sectionPaddingY: "md",
   sectionWidth: "content"
 };
+var hideFromCMS = (field) => ({
+  ...field,
+  admin: {
+    ...field.admin || {},
+    hidden: true
+  }
+});
+var sectionStyleFields = () => {
+  const fields = [
+    {
+      name: "sectionWidth",
+      type: "select",
+      defaultValue: sectionStyleDefaults.sectionWidth,
+      options: [
+        { label: "Content", value: "content" },
+        { label: "Wide", value: "wide" },
+        { label: "Full", value: "full" }
+      ]
+    },
+    {
+      name: "contentWidth",
+      type: "select",
+      defaultValue: sectionStyleDefaults.contentWidth,
+      options: [
+        { label: "Inherit", value: "inherit" },
+        { label: "Narrow", value: "narrow" },
+        { label: "Content", value: "content" },
+        { label: "Wide", value: "wide" },
+        { label: "Full", value: "full" }
+      ]
+    },
+    {
+      name: "sectionPaddingY",
+      type: "select",
+      defaultValue: sectionStyleDefaults.sectionPaddingY,
+      options: [
+        { label: "None", value: "none" },
+        { label: "Small", value: "sm" },
+        { label: "Medium", value: "md" },
+        { label: "Large", value: "lg" }
+      ]
+    },
+    {
+      name: "sectionPaddingX",
+      type: "select",
+      defaultValue: sectionStyleDefaults.sectionPaddingX,
+      options: [
+        { label: "Inherit", value: "inherit" },
+        { label: "None", value: "none" },
+        { label: "Small", value: "sm" },
+        { label: "Medium", value: "md" },
+        { label: "Large", value: "lg" }
+      ]
+    },
+    {
+      name: "sectionBackgroundMode",
+      type: "select",
+      defaultValue: sectionStyleDefaults.sectionBackgroundMode,
+      options: [
+        { label: "None", value: "none" },
+        { label: "Color", value: "color" },
+        { label: "Gradient", value: "gradient" }
+      ]
+    },
+    {
+      name: "sectionBackgroundColor",
+      type: "text",
+      defaultValue: sectionStyleDefaults.sectionBackgroundColor
+    },
+    {
+      name: "sectionGradientPreset",
+      type: "select",
+      defaultValue: sectionStyleDefaults.sectionGradientPreset,
+      options: [
+        { label: "None", value: "none" },
+        { label: "Brand", value: "brand" },
+        { label: "Forest", value: "forest" },
+        { label: "Moss", value: "moss" },
+        { label: "Cream", value: "cream" },
+        { label: "Slate", value: "slate" }
+      ]
+    },
+    {
+      name: "sectionGradientFrom",
+      type: "text",
+      defaultValue: sectionStyleDefaults.sectionGradientFrom
+    },
+    {
+      name: "sectionGradientTo",
+      type: "text",
+      defaultValue: sectionStyleDefaults.sectionGradientTo
+    },
+    {
+      name: "sectionGradientAngle",
+      type: "text",
+      defaultValue: sectionStyleDefaults.sectionGradientAngle
+    },
+    {
+      name: "contentBackgroundMode",
+      type: "select",
+      defaultValue: sectionStyleDefaults.contentBackgroundMode,
+      options: [
+        { label: "None", value: "none" },
+        { label: "Color", value: "color" },
+        { label: "Gradient", value: "gradient" }
+      ]
+    },
+    {
+      name: "contentBackgroundColor",
+      type: "text",
+      defaultValue: sectionStyleDefaults.contentBackgroundColor
+    },
+    {
+      name: "contentGradientPreset",
+      type: "select",
+      defaultValue: sectionStyleDefaults.contentGradientPreset,
+      options: [
+        { label: "None", value: "none" },
+        { label: "Cloud", value: "cloud" },
+        { label: "Sand", value: "sand" },
+        { label: "Mint", value: "mint" },
+        { label: "Night", value: "night" }
+      ]
+    },
+    {
+      name: "contentGradientFrom",
+      type: "text",
+      defaultValue: sectionStyleDefaults.contentGradientFrom
+    },
+    {
+      name: "contentGradientTo",
+      type: "text",
+      defaultValue: sectionStyleDefaults.contentGradientTo
+    },
+    {
+      name: "contentGradientAngle",
+      type: "text",
+      defaultValue: sectionStyleDefaults.contentGradientAngle
+    }
+  ];
+  return fields.map(hideFromCMS);
+};
 
 // src/studio-pages/builder/settings-v2/types.ts
 var defaultBuilderBlockSettingsV2 = {
@@ -956,6 +1102,13 @@ function compileStudioDocument(document, modules) {
 }
 
 // src/studio-pages/pageService.ts
+var defaultRelationshipHydrationMap = {
+  beforeAfter: { arrays: { items: ["media", "beforeMedia", "afterMedia"] } },
+  featureGrid: { arrays: { items: ["media", "beforeMedia", "afterMedia"] } },
+  hero: { fields: ["media"] },
+  logoWall: { arrays: { items: ["media", "beforeMedia", "afterMedia"] } },
+  media: { fields: ["image"] }
+};
 var isRecord4 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 var toRecordArray = (value) => Array.isArray(value) ? value.filter((item) => isRecord4(item)) : [];
 var getRelationID = (value) => {
@@ -983,7 +1136,7 @@ var hydrateRelationship = (valueFromStudio, valueFromLayout) => {
   }
   return valueFromLayout;
 };
-var hydrateDocumentWithLayoutRelations = (document, layout) => {
+var hydrateDocumentWithLayoutRelations = (document, layout, hydrationMap = defaultRelationshipHydrationMap) => {
   const nextNodes = document.nodes.map((node, index) => {
     const layoutBlock = layout[index];
     if (!isRecord4(layoutBlock)) {
@@ -992,17 +1145,18 @@ var hydrateDocumentWithLayoutRelations = (document, layout) => {
     if (typeof layoutBlock.blockType !== "string" || layoutBlock.blockType !== node.type) {
       return node;
     }
-    const nextData = { ...node.data };
-    if (node.type === "hero") {
-      nextData.media = hydrateRelationship(nextData.media, layoutBlock.media);
+    const rule = hydrationMap[node.type];
+    if (!rule) {
+      return node;
     }
-    if (node.type === "media") {
-      nextData.image = hydrateRelationship(nextData.image, layoutBlock.image);
+    const nextData = { ...node.data };
+    for (const fieldName of rule.fields || []) {
+      nextData[fieldName] = hydrateRelationship(nextData[fieldName], layoutBlock[fieldName]);
     }
-    if (node.type === "featureGrid" || node.type === "logoWall" || node.type === "beforeAfter") {
-      const studioItems = Array.isArray(nextData.items) ? nextData.items : [];
-      const layoutItems = Array.isArray(layoutBlock.items) ? layoutBlock.items : [];
-      nextData.items = studioItems.map((rawStudioItem, itemIndex) => {
+    for (const [arrayField, itemFields] of Object.entries(rule.arrays || {})) {
+      const studioItems = Array.isArray(nextData[arrayField]) ? nextData[arrayField] : [];
+      const layoutItems = Array.isArray(layoutBlock[arrayField]) ? layoutBlock[arrayField] : [];
+      nextData[arrayField] = studioItems.map((rawStudioItem, itemIndex) => {
         if (!isRecord4(rawStudioItem)) {
           return rawStudioItem;
         }
@@ -1011,9 +1165,9 @@ var hydrateDocumentWithLayoutRelations = (document, layout) => {
           return rawStudioItem;
         }
         const nextItem = { ...rawStudioItem };
-        nextItem.media = hydrateRelationship(nextItem.media, layoutItem.media);
-        nextItem.beforeMedia = hydrateRelationship(nextItem.beforeMedia, layoutItem.beforeMedia);
-        nextItem.afterMedia = hydrateRelationship(nextItem.afterMedia, layoutItem.afterMedia);
+        for (const itemField of itemFields) {
+          nextItem[itemField] = hydrateRelationship(nextItem[itemField], layoutItem[itemField]);
+        }
         return nextItem;
       });
     }
@@ -1032,7 +1186,12 @@ var normalizeDocument = (document) => ({
   schemaVersion: 1,
   updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 });
-var normalizeLegacyHeroDefaults = (document) => {
+var DEFAULT_LEGACY_HERO_BACKGROUND_COLORS = ["#124a37"];
+var normalizeLegacyHeroDefaults = (document, legacyColors = DEFAULT_LEGACY_HERO_BACKGROUND_COLORS) => {
+  if (legacyColors.length === 0) {
+    return document;
+  }
+  const normalizedLegacyColors = legacyColors.map((color) => color.trim().toLowerCase());
   const nodes = document.nodes.map((node) => {
     if (node.type !== "hero" || !isRecord4(node.data)) {
       return node;
@@ -1042,7 +1201,7 @@ var normalizeLegacyHeroDefaults = (document) => {
     const sectionBackgroundMode = typeof nextData.sectionBackgroundMode === "string" ? nextData.sectionBackgroundMode : "none";
     const hasBackgroundImageURL = typeof nextData.backgroundImageURL === "string" && nextData.backgroundImageURL.trim().length > 0;
     const mediaRelation = getRelationID(nextData.media);
-    if (heroBackgroundColor === "#124a37" && sectionBackgroundMode === "none" && !hasBackgroundImageURL && mediaRelation === null) {
+    if (normalizedLegacyColors.includes(heroBackgroundColor) && sectionBackgroundMode === "none" && !hasBackgroundImageURL && mediaRelation === null) {
       nextData.backgroundColor = "";
     }
     return {
@@ -1061,13 +1220,13 @@ var assertCanPublish = (issues) => {
     throw new Error(`Cannot publish page: ${publishErrors[0].message}`);
   }
 };
-var getStudioDocumentFromPage = (doc) => {
+var getStudioDocumentFromPage = (doc, relationshipHydration = defaultRelationshipHydrationMap) => {
   const title = typeof doc.title === "string" ? doc.title : void 0;
   const layout = asLayoutArray(doc.layout);
   try {
     const studioDocument = assertStudioDocumentV1(doc.studioDocument);
     if (layout.length > 0) {
-      return hydrateDocumentWithLayoutRelations(studioDocument, layout);
+      return hydrateDocumentWithLayoutRelations(studioDocument, layout, relationshipHydration);
     }
     return studioDocument;
   } catch {
@@ -1079,8 +1238,10 @@ var getStudioDocumentFromPage = (doc) => {
 };
 var createStudioPageService = ({
   collectionSlug = "pages",
+  legacyHeroBackgroundColors = DEFAULT_LEGACY_HERO_BACKGROUND_COLORS,
   modules,
   payload,
+  relationshipHydration = defaultRelationshipHydrationMap,
   user
 }) => ({
   getPageForStudio: async (pageID) => {
@@ -1092,7 +1253,7 @@ var createStudioPageService = ({
       overrideAccess: false,
       user
     });
-    const studioDocument = getStudioDocumentFromPage(page);
+    const studioDocument = getStudioDocumentFromPage(page, relationshipHydration);
     return {
       id: String(page.id),
       slug: typeof page.slug === "string" ? page.slug : "",
@@ -1102,7 +1263,10 @@ var createStudioPageService = ({
   },
   validateStudioDocument: (document) => validateStudioDocument(document, modules),
   saveDraft: async (pageID, document, _metadata) => {
-    const normalizedDocument = normalizeLegacyHeroDefaults(normalizeDocument(document));
+    const normalizedDocument = normalizeLegacyHeroDefaults(
+      normalizeDocument(document),
+      legacyHeroBackgroundColors
+    );
     const compileResult = compileStudioDocument(normalizedDocument, modules);
     await payload.update({
       collection: collectionSlug,
@@ -1123,7 +1287,10 @@ var createStudioPageService = ({
     };
   },
   publish: async (pageID, document, _metadata) => {
-    const normalizedDocument = normalizeLegacyHeroDefaults(normalizeDocument(document));
+    const normalizedDocument = normalizeLegacyHeroDefaults(
+      normalizeDocument(document),
+      legacyHeroBackgroundColors
+    );
     const compileResult = compileStudioDocument(normalizedDocument, modules);
     assertCanPublish(compileResult.issues);
     await payload.update({
@@ -1152,6 +1319,1617 @@ var toEditorInitialDoc = (payloadPage) => ({
   title: payloadPage.title
 });
 
+// src/blocks/blocks/adminComponents.ts
+var builderBlockLabelComponent = {
+  exportName: "BuilderBlockLabel",
+  path: "@orion-studios/payload-studio/blocks"
+};
+
+// src/blocks/blocks/BeforeAfter.ts
+var BeforeAfterBlock = {
+  slug: "beforeAfter",
+  imageURL: "/images/project-before-2.svg",
+  imageAltText: "Before and after section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Before / After",
+    plural: "Before / After"
+  },
+  fields: [
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "subtitle",
+      type: "textarea"
+    },
+    {
+      name: "itemsPerRow",
+      type: "number",
+      defaultValue: 2,
+      min: 1,
+      max: 4,
+      admin: {
+        description: "How many project cards to show per row on desktop.",
+        step: 1
+      }
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 30,
+      fields: [
+        {
+          name: "label",
+          type: "text",
+          required: true
+        },
+        {
+          name: "beforeMedia",
+          type: "upload",
+          relationTo: "media",
+          required: false
+        },
+        {
+          name: "beforeImageURL",
+          type: "text",
+          admin: {
+            description: "Optional direct URL for the before image when using an external asset."
+          }
+        },
+        {
+          name: "afterMedia",
+          type: "upload",
+          relationTo: "media",
+          required: false
+        },
+        {
+          name: "afterImageURL",
+          type: "text",
+          admin: {
+            description: "Optional direct URL for the after image when using an external asset."
+          }
+        },
+        {
+          name: "imageHeight",
+          type: "number",
+          defaultValue: 160,
+          min: 60,
+          max: 600,
+          admin: {
+            description: "Overrides the before/after image height (in pixels).",
+            step: 10
+          }
+        },
+        {
+          name: "imageFit",
+          type: "select",
+          defaultValue: "cover",
+          options: [
+            { label: "Cover", value: "cover" },
+            { label: "Contain", value: "contain" }
+          ]
+        },
+        {
+          name: "imageCornerStyle",
+          type: "select",
+          defaultValue: "rounded",
+          options: [
+            { label: "Rounded", value: "rounded" },
+            { label: "Square", value: "square" }
+          ]
+        },
+        {
+          name: "imagePosition",
+          type: "select",
+          defaultValue: "center",
+          options: [
+            { label: "Center", value: "center" },
+            { label: "Top", value: "top" },
+            { label: "Bottom", value: "bottom" },
+            { label: "Left", value: "left" },
+            { label: "Right", value: "right" }
+          ]
+        },
+        {
+          name: "imagePositionX",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom horizontal focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "imagePositionY",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom vertical focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "description",
+          type: "textarea"
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/BookingEmbed.ts
+var BookingEmbedBlock = {
+  slug: "bookingEmbed",
+  imageURL: "/images/service-removal.svg",
+  imageAltText: "Booking embed section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Booking Embed",
+    plural: "Booking Embeds"
+  },
+  fields: [
+    {
+      name: "title",
+      type: "text"
+    },
+    {
+      name: "description",
+      type: "textarea"
+    },
+    {
+      name: "buttonLabel",
+      type: "text",
+      defaultValue: "Book Consultation"
+    },
+    {
+      name: "buttonHref",
+      type: "text",
+      defaultValue: "/contact"
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Cta.ts
+var CtaBlock = {
+  slug: "cta",
+  imageURL: "/images/logo-mark.svg",
+  imageAltText: "Call to action section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "CTA",
+    plural: "CTAs"
+  },
+  fields: [
+    {
+      name: "headline",
+      type: "text",
+      required: true
+    },
+    {
+      name: "description",
+      type: "textarea"
+    },
+    {
+      name: "eyebrow",
+      type: "text"
+    },
+    {
+      name: "buttonLabel",
+      type: "text"
+    },
+    {
+      name: "buttonHref",
+      type: "text",
+      admin: {
+        description: "Use internal links like /contact."
+      }
+    },
+    {
+      name: "style",
+      type: "select",
+      defaultValue: "light",
+      options: [
+        {
+          label: "Light",
+          value: "light"
+        },
+        {
+          label: "Dark",
+          value: "dark"
+        }
+      ]
+    },
+    {
+      name: "backgroundColor",
+      type: "text",
+      admin: {
+        description: "Optional background color override for the CTA strip (example: #334b63)."
+      }
+    },
+    {
+      name: "media",
+      type: "upload",
+      relationTo: "media",
+      required: false
+    },
+    {
+      name: "imageURL",
+      type: "text",
+      admin: {
+        description: "Optional direct image URL when this CTA should use an external image."
+      }
+    },
+    {
+      name: "bullets",
+      type: "array",
+      fields: [
+        {
+          name: "label",
+          type: "text",
+          required: true
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Faq.ts
+var FaqBlock = {
+  slug: "faq",
+  imageURL: "/images/project-before-2.svg",
+  imageAltText: "FAQ section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "FAQ",
+    plural: "FAQs"
+  },
+  fields: [
+    {
+      name: "eyebrow",
+      type: "text"
+    },
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 12,
+      fields: [
+        {
+          name: "question",
+          type: "text",
+          required: true
+        },
+        {
+          name: "answer",
+          type: "textarea",
+          required: true
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/FeatureGrid.ts
+var FeatureGridBlock = {
+  slug: "featureGrid",
+  imageURL: "/images/service-trimming.svg",
+  imageAltText: "Feature grid section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Feature Grid",
+    plural: "Feature Grids"
+  },
+  fields: [
+    {
+      name: "eyebrow",
+      type: "text"
+    },
+    {
+      name: "title",
+      type: "text"
+    },
+    {
+      name: "subtitle",
+      type: "textarea"
+    },
+    {
+      name: "itemsPerRow",
+      type: "number",
+      defaultValue: 3,
+      min: 1,
+      max: 6,
+      admin: {
+        description: "How many items to show per row on desktop.",
+        step: 1
+      }
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 6,
+      fields: [
+        {
+          name: "title",
+          type: "text",
+          required: true
+        },
+        {
+          name: "description",
+          type: "textarea"
+        },
+        {
+          name: "tone",
+          type: "select",
+          defaultValue: "warm",
+          options: [
+            { label: "Warm", value: "warm" },
+            { label: "Cool", value: "cool" },
+            { label: "Neutral", value: "neutral" }
+          ]
+        },
+        {
+          name: "iconType",
+          type: "select",
+          defaultValue: "badge",
+          options: [
+            { label: "Badge Text", value: "badge" },
+            { label: "Icon", value: "lucide" }
+          ],
+          admin: {
+            description: "Choose whether this item uses a short badge label or an icon."
+          }
+        },
+        {
+          name: "icon",
+          type: "text",
+          admin: {
+            description: 'Optional short icon label (e.g. "01", "Leaf", "Star").',
+            condition: (_, siblingData) => siblingData?.iconType !== "lucide"
+          }
+        },
+        {
+          name: "iconLucide",
+          type: "select",
+          options: [
+            { label: "Shield Check", value: "ShieldCheck" },
+            { label: "Clock", value: "Clock" },
+            { label: "Leaf", value: "Leaf" },
+            { label: "Dollar Sign", value: "DollarSign" },
+            { label: "Hard Hat", value: "HardHat" },
+            { label: "Sparkles", value: "Sparkles" },
+            { label: "Tree Pine", value: "TreePine" },
+            { label: "Badge Check", value: "BadgeCheck" },
+            { label: "Calendar Clock", value: "CalendarClock" }
+          ],
+          admin: {
+            description: "Select an icon for this item.",
+            condition: (_, siblingData) => siblingData?.iconType === "lucide"
+          }
+        },
+        {
+          name: "media",
+          type: "upload",
+          relationTo: "media",
+          required: false
+        },
+        {
+          name: "imageURL",
+          type: "text",
+          admin: {
+            description: "Optional direct image URL when this item should use an external image."
+          }
+        },
+        {
+          name: "embedURL",
+          type: "text",
+          admin: {
+            description: "Optional iframe/embed URL for items like maps or other embedded content."
+          }
+        },
+        {
+          name: "buttonLabel",
+          type: "text"
+        },
+        {
+          name: "buttonHref",
+          type: "text"
+        },
+        {
+          name: "bullets",
+          type: "array",
+          fields: [
+            {
+              name: "label",
+              type: "text",
+              required: true
+            }
+          ]
+        },
+        {
+          name: "imageHeight",
+          type: "number",
+          defaultValue: 160,
+          min: 40,
+          max: 600,
+          admin: {
+            description: "Overrides the image height in the builder/section (in pixels).",
+            step: 10
+          }
+        },
+        {
+          name: "imageFit",
+          type: "select",
+          defaultValue: "cover",
+          options: [
+            { label: "Cover", value: "cover" },
+            { label: "Contain", value: "contain" }
+          ]
+        },
+        {
+          name: "imageCornerStyle",
+          type: "select",
+          defaultValue: "rounded",
+          options: [
+            { label: "Rounded", value: "rounded" },
+            { label: "Square", value: "square" }
+          ]
+        },
+        {
+          name: "imagePosition",
+          type: "select",
+          defaultValue: "center",
+          options: [
+            { label: "Center", value: "center" },
+            { label: "Top", value: "top" },
+            { label: "Bottom", value: "bottom" },
+            { label: "Left", value: "left" },
+            { label: "Right", value: "right" }
+          ]
+        },
+        {
+          name: "imagePositionX",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom horizontal focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "imagePositionY",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom vertical focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "variant",
+      type: "select",
+      defaultValue: "cards",
+      options: [
+        {
+          label: "Cards",
+          value: "cards"
+        },
+        {
+          label: "Highlight",
+          value: "highlight"
+        },
+        {
+          label: "Split List",
+          value: "splitList"
+        },
+        {
+          label: "Panels",
+          value: "panels"
+        },
+        {
+          label: "Catalog",
+          value: "catalog"
+        },
+        {
+          label: "Contact Split",
+          value: "contact"
+        }
+      ]
+    },
+    {
+      name: "backgroundColor",
+      type: "text",
+      admin: {
+        description: "Optional background color override when using the Highlight variant (example: #334b63)."
+      }
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/FormEmbed.ts
+var FormEmbedBlock = {
+  slug: "formEmbed",
+  imageURL: "/images/map-placeholder.svg",
+  imageAltText: "Form embed section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Form Embed",
+    plural: "Form Embeds"
+  },
+  fields: [
+    {
+      name: "eyebrow",
+      type: "text"
+    },
+    {
+      name: "title",
+      type: "text"
+    },
+    {
+      name: "description",
+      type: "textarea"
+    },
+    {
+      name: "submitLabel",
+      type: "text"
+    },
+    {
+      name: "formType",
+      type: "select",
+      defaultValue: "quote",
+      options: [
+        {
+          label: "Quote Form",
+          value: "quote"
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Hero.ts
+var HeroBlock = {
+  slug: "hero",
+  imageURL: "/images/hero-tree.svg",
+  imageAltText: "Hero section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Hero",
+    plural: "Hero Sections"
+  },
+  fields: [
+    {
+      name: "kicker",
+      type: "text",
+      admin: {
+        description: "Optional short label above the headline."
+      }
+    },
+    {
+      name: "headline",
+      type: "text",
+      required: true
+    },
+    {
+      name: "subheadline",
+      type: "textarea"
+    },
+    {
+      name: "primaryLabel",
+      type: "text"
+    },
+    {
+      name: "primaryHref",
+      type: "text",
+      admin: {
+        description: "Use internal links like /contact."
+      }
+    },
+    {
+      name: "secondaryLabel",
+      type: "text"
+    },
+    {
+      name: "secondaryHref",
+      type: "text",
+      admin: {
+        description: "Use internal links like /services."
+      }
+    },
+    {
+      name: "media",
+      type: "upload",
+      relationTo: "media"
+    },
+    {
+      name: "backgroundImageURL",
+      type: "text",
+      admin: {
+        description: "Optional direct image URL when the hero should use an external image source."
+      }
+    },
+    {
+      name: "backgroundImageFit",
+      type: "select",
+      defaultValue: "cover",
+      options: [
+        { label: "Cover", value: "cover" },
+        { label: "Cover (Square)", value: "cover-square" },
+        { label: "Contain", value: "contain" },
+        { label: "Contain (Square)", value: "contain-square" }
+      ],
+      admin: {
+        description: "How the hero image should be sized within the section."
+      }
+    },
+    {
+      name: "backgroundImageCornerStyle",
+      type: "select",
+      defaultValue: "rounded",
+      options: [
+        { label: "Rounded", value: "rounded" },
+        { label: "Square", value: "square" }
+      ],
+      admin: {
+        description: "How the hero image corners should appear."
+      }
+    },
+    {
+      name: "backgroundImagePosition",
+      type: "select",
+      defaultValue: "center",
+      options: [
+        { label: "Center", value: "center" },
+        { label: "Top", value: "top" },
+        { label: "Bottom", value: "bottom" },
+        { label: "Left", value: "left" },
+        { label: "Right", value: "right" }
+      ],
+      admin: {
+        description: "Where the hero image should anchor inside the section."
+      }
+    },
+    {
+      name: "backgroundColor",
+      type: "text",
+      admin: {
+        description: "Optional background color override (example: #334b63)."
+      }
+    },
+    {
+      name: "backgroundOverlayMode",
+      type: "select",
+      defaultValue: "none",
+      options: [
+        { label: "None", value: "none" },
+        { label: "Solid", value: "solid" },
+        { label: "Gradient", value: "gradient" }
+      ],
+      admin: {
+        description: "Optional overlay on top of the hero image (applies when an image is present)."
+      }
+    },
+    {
+      name: "backgroundOverlayOpacity",
+      type: "number",
+      defaultValue: 45,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "Overlay opacity (0-100).",
+        step: 1
+      }
+    },
+    {
+      name: "backgroundOverlayColor",
+      type: "text",
+      admin: {
+        description: "Overlay solid color (example: #000000). Used when Overlay Mode is Solid."
+      }
+    },
+    {
+      name: "backgroundOverlayGradientFrom",
+      type: "text",
+      admin: {
+        description: "Gradient overlay start color (example: #334b63). Used when Overlay Mode is Gradient."
+      }
+    },
+    {
+      name: "backgroundOverlayGradientTo",
+      type: "text",
+      admin: {
+        description: "Gradient overlay end color (example: #496582). Used when Overlay Mode is Gradient."
+      }
+    },
+    {
+      name: "backgroundOverlayGradientAngle",
+      type: "text",
+      admin: {
+        description: "Gradient overlay angle in degrees (0-360). Used when Overlay Mode is Gradient."
+      }
+    },
+    {
+      name: "backgroundOverlayGradientFromStrength",
+      type: "number",
+      defaultValue: 100,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "Gradient start strength (0-100). Set to 0 for transparent.",
+        step: 1
+      }
+    },
+    {
+      name: "backgroundOverlayGradientToStrength",
+      type: "number",
+      defaultValue: 100,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "Gradient end strength (0-100). Set to 0 for transparent.",
+        step: 1
+      }
+    },
+    {
+      name: "backgroundOverlayGradientStart",
+      type: "number",
+      defaultValue: 0,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "Where the gradient starts (0-100).",
+        step: 1
+      }
+    },
+    {
+      name: "backgroundOverlayGradientEnd",
+      type: "number",
+      defaultValue: 100,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "Where the gradient ends (0-100).",
+        step: 1
+      }
+    },
+    {
+      name: "backgroundOverlayGradientFeather",
+      type: "number",
+      defaultValue: 100,
+      min: 0,
+      max: 100,
+      admin: {
+        description: "How soft the transition is (0 = hard edge, 100 = smooth).",
+        step: 1
+      }
+    },
+    {
+      name: "variant",
+      type: "select",
+      defaultValue: "default",
+      options: [
+        {
+          label: "Default",
+          value: "default"
+        },
+        {
+          label: "Centered",
+          value: "centered"
+        }
+      ]
+    },
+    {
+      name: "heroHeight",
+      type: "select",
+      defaultValue: "sm",
+      options: [
+        {
+          label: "Small",
+          value: "sm"
+        },
+        {
+          label: "Medium (Half Screen)",
+          value: "md"
+        },
+        {
+          label: "Full Screen",
+          value: "full"
+        }
+      ],
+      admin: {
+        description: "Controls the vertical height of the hero section."
+      }
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/LogoWall.ts
+var LogoWallBlock = {
+  slug: "logoWall",
+  imageURL: "/images/logo-mark.svg",
+  imageAltText: "Logo wall section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Logo Wall",
+    plural: "Logo Walls"
+  },
+  fields: [
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "subtitle",
+      type: "textarea"
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 12,
+      fields: [
+        {
+          name: "name",
+          type: "text",
+          required: true
+        },
+        {
+          name: "media",
+          type: "upload",
+          relationTo: "media",
+          required: false
+        },
+        {
+          name: "imageURL",
+          type: "text",
+          admin: {
+            description: "Optional direct image URL for this logo when using an external asset."
+          }
+        },
+        {
+          name: "imageHeight",
+          type: "number",
+          defaultValue: 64,
+          min: 24,
+          max: 200,
+          admin: {
+            description: "Overrides the logo image height (in pixels).",
+            step: 4
+          }
+        },
+        {
+          name: "imageFit",
+          type: "select",
+          defaultValue: "contain",
+          options: [
+            { label: "Cover", value: "cover" },
+            { label: "Contain", value: "contain" }
+          ]
+        },
+        {
+          name: "imageCornerStyle",
+          type: "select",
+          defaultValue: "rounded",
+          options: [
+            { label: "Rounded", value: "rounded" },
+            { label: "Square", value: "square" }
+          ]
+        },
+        {
+          name: "imagePosition",
+          type: "select",
+          defaultValue: "center",
+          options: [
+            { label: "Center", value: "center" },
+            { label: "Top", value: "top" },
+            { label: "Bottom", value: "bottom" },
+            { label: "Left", value: "left" },
+            { label: "Right", value: "right" }
+          ]
+        },
+        {
+          name: "imagePositionX",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom horizontal focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "imagePositionY",
+          type: "number",
+          min: 0,
+          max: 100,
+          admin: {
+            description: "Optional custom vertical focus (0-100). Overrides Image Position when set.",
+            step: 1
+          }
+        },
+        {
+          name: "href",
+          type: "text"
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Media.ts
+var MediaBlock = {
+  slug: "media",
+  imageURL: "/images/project-after-1.svg",
+  imageAltText: "Media section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Media",
+    plural: "Media Sections"
+  },
+  fields: [
+    {
+      name: "image",
+      type: "upload",
+      relationTo: "media",
+      required: false
+    },
+    {
+      name: "imageURL",
+      type: "text",
+      admin: {
+        description: "Optional direct image URL when this section should use an external image."
+      }
+    },
+    {
+      name: "caption",
+      type: "text"
+    },
+    {
+      name: "size",
+      type: "select",
+      defaultValue: "default",
+      options: [
+        {
+          label: "Default",
+          value: "default"
+        },
+        {
+          label: "Wide",
+          value: "wide"
+        }
+      ]
+    },
+    {
+      name: "imageFit",
+      type: "select",
+      defaultValue: "cover",
+      options: [
+        { label: "Cover", value: "cover" },
+        { label: "Contain", value: "contain" }
+      ]
+    },
+    {
+      name: "imageCornerStyle",
+      type: "select",
+      defaultValue: "rounded",
+      options: [
+        { label: "Rounded", value: "rounded" },
+        { label: "Square", value: "square" }
+      ]
+    },
+    {
+      name: "imagePosition",
+      type: "select",
+      defaultValue: "center",
+      options: [
+        { label: "Center", value: "center" },
+        { label: "Top", value: "top" },
+        { label: "Bottom", value: "bottom" },
+        { label: "Left", value: "left" },
+        { label: "Right", value: "right" }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/RichText.ts
+var RichTextBlock = {
+  slug: "richText",
+  imageURL: "/window.svg",
+  imageAltText: "Rich text section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Rich Text",
+    plural: "Rich Text Sections"
+  },
+  fields: [
+    {
+      name: "variant",
+      type: "select",
+      defaultValue: "default",
+      options: [
+        {
+          label: "Default",
+          value: "default"
+        },
+        {
+          label: "Quote Banner",
+          value: "quoteBanner"
+        }
+      ]
+    },
+    {
+      name: "title",
+      type: "text"
+    },
+    {
+      name: "content",
+      type: "richText",
+      required: true
+    },
+    {
+      name: "statsItems",
+      type: "array",
+      fields: [
+        {
+          name: "value",
+          type: "text",
+          required: true
+        },
+        {
+          name: "label",
+          type: "text",
+          required: true
+        }
+      ]
+    },
+    {
+      name: "cards",
+      type: "array",
+      fields: [
+        {
+          name: "eyebrow",
+          type: "text"
+        },
+        {
+          name: "title",
+          type: "text",
+          required: true
+        },
+        {
+          name: "description",
+          type: "textarea"
+        },
+        {
+          name: "media",
+          type: "upload",
+          relationTo: "media",
+          required: false
+        },
+        {
+          name: "imageURL",
+          type: "text",
+          admin: {
+            description: "Optional direct image URL when this card should use an external image."
+          }
+        }
+      ]
+    },
+    {
+      name: "width",
+      type: "select",
+      defaultValue: "normal",
+      options: [
+        {
+          label: "Normal",
+          value: "normal"
+        },
+        {
+          label: "Narrow",
+          value: "narrow"
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Stats.ts
+var StatsBlock = {
+  slug: "stats",
+  imageURL: "/images/service-removal.svg",
+  imageAltText: "Stats section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Stats",
+    plural: "Stats"
+  },
+  fields: [
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "subtitle",
+      type: "textarea"
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 6,
+      fields: [
+        {
+          name: "value",
+          type: "text",
+          required: true
+        },
+        {
+          name: "label",
+          type: "text",
+          required: true
+        },
+        {
+          name: "description",
+          type: "text"
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/blocks/Testimonials.ts
+var TestimonialsBlock = {
+  slug: "testimonials",
+  imageURL: "/images/project-after-2.svg",
+  imageAltText: "Testimonials section preview",
+  admin: {
+    components: {
+      Label: builderBlockLabelComponent
+    }
+  },
+  labels: {
+    singular: "Testimonials",
+    plural: "Testimonials"
+  },
+  fields: [
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "visibleCount",
+      type: "number",
+      defaultValue: 3,
+      min: 1,
+      max: 6,
+      admin: {
+        description: "How many testimonials to show at once.",
+        step: 1
+      }
+    },
+    {
+      name: "autoRotate",
+      type: "checkbox",
+      defaultValue: true,
+      admin: {
+        description: "Automatically rotates through all testimonials."
+      }
+    },
+    {
+      name: "rotateIntervalSeconds",
+      type: "number",
+      defaultValue: 7,
+      min: 2,
+      max: 30,
+      admin: {
+        description: "How often to rotate (in seconds).",
+        step: 1
+      }
+    },
+    {
+      name: "items",
+      type: "array",
+      minRows: 1,
+      maxRows: 30,
+      fields: [
+        {
+          name: "quote",
+          type: "textarea",
+          required: true
+        },
+        {
+          name: "name",
+          type: "text",
+          required: true
+        },
+        {
+          name: "location",
+          type: "text"
+        },
+        {
+          name: "rating",
+          type: "number",
+          defaultValue: 5,
+          min: 1,
+          max: 5,
+          admin: {
+            description: "Star rating (1-5).",
+            step: 1
+          }
+        },
+        {
+          name: "settings",
+          type: "json",
+          admin: {
+            hidden: true
+          }
+        }
+      ]
+    },
+    {
+      name: "settings",
+      type: "json",
+      admin: {
+        description: "Internal builder settings schema v2.",
+        hidden: true
+      }
+    },
+    ...sectionStyleFields()
+  ]
+};
+
+// src/blocks/index.ts
+var defaultPageLayoutBlocks = [
+  HeroBlock,
+  RichTextBlock,
+  FeatureGridBlock,
+  StatsBlock,
+  LogoWallBlock,
+  BeforeAfterBlock,
+  MediaBlock,
+  TestimonialsBlock,
+  FaqBlock,
+  FormEmbedBlock,
+  BookingEmbedBlock,
+  CtaBlock
+];
+
+// src/studio-pages/pageFields.ts
+var formatSlugValue = (value) => {
+  if (typeof value !== "string") return void 0;
+  return value.trim().toLowerCase().replace(/[^a-z0-9/]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+};
+function createStudioPageFields(options = {}) {
+  const {
+    blocks = defaultPageLayoutBlocks,
+    mediaCollectionSlug = "media",
+    additionalFields = []
+  } = options;
+  return [
+    {
+      name: "title",
+      type: "text",
+      required: true
+    },
+    {
+      name: "slug",
+      type: "text",
+      admin: {
+        description: "URL identifier for this page. `home` is served at `/`.",
+        position: "sidebar"
+      },
+      hooks: {
+        beforeValidate: [({ value }) => formatSlugValue(value) ?? value]
+      },
+      index: true,
+      required: true,
+      unique: true
+    },
+    {
+      name: "path",
+      type: "text",
+      admin: {
+        description: "Full public path. Derived from the slug when left empty.",
+        position: "sidebar"
+      },
+      hooks: {
+        beforeValidate: [
+          ({ value, data }) => {
+            if (typeof value === "string" && value.trim().length > 0) {
+              return value.trim();
+            }
+            const slug = formatSlugValue(data?.slug);
+            if (!slug) return value;
+            return slug === "home" ? "/" : `/${slug}`;
+          }
+        ]
+      },
+      index: true,
+      unique: true
+    },
+    {
+      name: "studioDocument",
+      type: "json",
+      admin: {
+        description: "Canonical Studio editor state. Managed by the page builder.",
+        hidden: true
+      }
+    },
+    {
+      name: "studioValidationIssues",
+      type: "json",
+      admin: {
+        description: "Validation issues from the last Studio compile. Managed by the page builder.",
+        hidden: true
+      }
+    },
+    {
+      name: "layout",
+      type: "blocks",
+      admin: {
+        description: "Compiled output only \u2014 edit pages through the Studio builder."
+      },
+      blocks
+    },
+    {
+      name: "seo",
+      type: "group",
+      fields: [
+        { name: "metaTitle", type: "text" },
+        { name: "metaDescription", type: "textarea" },
+        { name: "canonicalUrl", type: "text" },
+        {
+          name: "ogImage",
+          type: "upload",
+          relationTo: mediaCollectionSlug
+        }
+      ]
+    },
+    {
+      name: "noIndex",
+      type: "checkbox",
+      admin: { position: "sidebar" },
+      defaultValue: false
+    },
+    {
+      name: "noFollow",
+      type: "checkbox",
+      admin: { position: "sidebar" },
+      defaultValue: false
+    },
+    ...additionalFields
+  ];
+}
+function createStudioPagesCollection(options = {}) {
+  const { slug = "pages", access, overrides, ...fieldOptions } = options;
+  const base = {
+    slug,
+    access: access || {
+      create: ({ req }) => Boolean(req.user),
+      delete: ({ req }) => Boolean(req.user),
+      read: ({ req }) => {
+        if (req.user) return true;
+        return { _status: { equals: "published" } };
+      },
+      update: ({ req }) => Boolean(req.user)
+    },
+    admin: {
+      defaultColumns: ["title", "slug", "_status", "updatedAt"],
+      useAsTitle: "title"
+    },
+    fields: createStudioPageFields(fieldOptions),
+    versions: {
+      drafts: {
+        autosave: false
+      },
+      maxPerDoc: 50
+    }
+  };
+  if (!overrides) return base;
+  return {
+    ...base,
+    ...overrides,
+    admin: { ...base.admin, ...overrides.admin },
+    fields: overrides.fields || base.fields
+  };
+}
+
 // src/studio-pages/migrations.ts
 var isRecord5 = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 var assertPageStudioDocumentV1 = (value) => {
@@ -1506,9 +3284,13 @@ var pageStudioModuleManifest = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_LEGACY_HERO_BACKGROUND_COLORS,
   createDefaultStudioDocument,
+  createStudioPageFields,
   createStudioPageService,
+  createStudioPagesCollection,
   defaultBuilderThemeTokens,
+  defaultRelationshipHydrationMap,
   getStudioDocumentFromPage,
   layoutToStudioDocument,
   pageInspectorPanels,