@opensite/ui 3.5.7 → 3.5.9

package/dist/navbar-animated-preview.cjs

@@ -1132,16 +1132,22 @@ var FeaturedCardsGridDropdown = ({
   optixFlowConfig
 }) => {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(
+    featuredLinks && featuredLinks?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(
       FeaturedLink,
       {
         link,
         optixFlowConfig
       },
       `desktop-featured-link-${index}`
-    )) }),
-    /* @__PURE__ */ jsxRuntime.jsx(Separator, {}),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-4 pt-8", children: links?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(NavLink, { link }, `default-nav-link-${index}`)) })
+    )) }) : null,
+    featuredLinks && featuredLinks?.length > 0 && links && links?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(Separator, {}) : null,
+    links && links?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: `grid grid-cols-4 pt-${featuredLinks && featuredLinks?.length > 0 ? 8 : 0} gap-4`,
+        children: links?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(NavLink, { link }, `default-nav-link-${index}`))
+      }
+    ) : null
   ] });
 };
 var GroupedLinksImageDropdown = ({

package/dist/navbar-animated-preview.d.cts

@@ -39,16 +39,16 @@ interface IMenuLink {
  */
 interface NavbarAnimatedPreviewProps {
     /**
-       * Logo configuration
-       */
+     * Logo configuration
+     */
     logo?: LogoConfig;
     /**
-       * Navigation menu links with optional dropdown groups
-       */
+     * Navigation menu links with optional dropdown groups
+     */
     menuLinks?: IMenuLink[];
     /**
-       * Action configurations (e.g., Sign In, Get Started buttons)
-       */
+     * Action configurations (e.g., Sign In, Get Started buttons)
+     */
     actions?: ActionConfig[];
 }
 interface NavbarAnimatedPreviewRuntimeProps {

package/dist/navbar-animated-preview.d.ts

@@ -39,16 +39,16 @@ interface IMenuLink {
  */
 interface NavbarAnimatedPreviewProps {
     /**
-       * Logo configuration
-       */
+     * Logo configuration
+     */
     logo?: LogoConfig;
     /**
-       * Navigation menu links with optional dropdown groups
-       */
+     * Navigation menu links with optional dropdown groups
+     */
     menuLinks?: IMenuLink[];
     /**
-       * Action configurations (e.g., Sign In, Get Started buttons)
-       */
+     * Action configurations (e.g., Sign In, Get Started buttons)
+     */
     actions?: ActionConfig[];
 }
 interface NavbarAnimatedPreviewRuntimeProps {

package/dist/navbar-animated-preview.js

@@ -1107,16 +1107,22 @@ var FeaturedCardsGridDropdown = ({
   optixFlowConfig
 }) => {
   return /* @__PURE__ */ jsxs("div", { children: [
-    /* @__PURE__ */ jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsx(
+    featuredLinks && featuredLinks?.length > 0 ? /* @__PURE__ */ jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsx(
       FeaturedLink,
       {
         link,
         optixFlowConfig
       },
       `desktop-featured-link-${index}`
-    )) }),
-    /* @__PURE__ */ jsx(Separator, {}),
-    /* @__PURE__ */ jsx("div", { className: "grid grid-cols-4 pt-8", children: links?.map((link, index) => /* @__PURE__ */ jsx(NavLink, { link }, `default-nav-link-${index}`)) })
+    )) }) : null,
+    featuredLinks && featuredLinks?.length > 0 && links && links?.length > 0 ? /* @__PURE__ */ jsx(Separator, {}) : null,
+    links && links?.length > 0 ? /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `grid grid-cols-4 pt-${featuredLinks && featuredLinks?.length > 0 ? 8 : 0} gap-4`,
+        children: links?.map((link, index) => /* @__PURE__ */ jsx(NavLink, { link }, `default-nav-link-${index}`))
+      }
+    ) : null
   ] });
 };
 var GroupedLinksImageDropdown = ({

package/dist/registry.cjs

@@ -66975,16 +66975,22 @@ var FeaturedCardsGridDropdown = ({
   optixFlowConfig
 }) => {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(
+    featuredLinks && featuredLinks?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(
       FeaturedLink,
       {
         link,
         optixFlowConfig
       },
       `desktop-featured-link-${index}`
-    )) }),
-    /* @__PURE__ */ jsxRuntime.jsx(Separator, {}),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "grid grid-cols-4 pt-8", children: links?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(NavLink, { link }, `default-nav-link-${index}`)) })
+    )) }) : null,
+    featuredLinks && featuredLinks?.length > 0 && links && links?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(Separator, {}) : null,
+    links && links?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: `grid grid-cols-4 pt-${featuredLinks && featuredLinks?.length > 0 ? 8 : 0} gap-4`,
+        children: links?.map((link, index) => /* @__PURE__ */ jsxRuntime.jsx(NavLink, { link }, `default-nav-link-${index}`))
+      }
+    ) : null
   ] });
 };
 var GroupedLinksImageDropdown = ({
@@ -112065,17 +112071,27 @@ var BLOCK_REGISTRY = {
   heading="Compassionate care for your mental wellbeing"
   description="Our team of experienced mental health professionals is dedicated to providing compassionate care and support to individuals in need."
   smallImages={[
-    { src: "/images/team-1.jpg", alt: "Dr. Smith" },
-    { src: "/images/team-2.jpg", alt: "Dr. Johnson" },
+    {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Dr. Smith",
+    },
+    {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Dr. Johnson",
+    },
   ]}
   testimonial={{
     quote:
       "The support I received changed my life. I'm so grateful for the compassionate care.",
     author: "Sarah M.",
     role: "Client",
-    avatarSrc: "/images/avatar.jpg",
+    avatarSrc:
+      "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+  }}
+  featureImage={{
+    src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+    alt: "Mental health support",
   }}
-  featureImage={{ src: "/images/feature.jpg", alt: "Mental health support" }}
   actions={[
     { label: "Get Started", href: "#", variant: "default" },
     { label: "Talk to Sales", href: "#", variant: "outline" },
@@ -112083,7 +112099,7 @@ var BLOCK_REGISTRY = {
   background="gray"
 />
     `.trim(),
-    importantUsageNotes: "Only use if you have a valid testimonial - DO NOT MAKE UP A TESTIMONIAL/REVIEW. Supply exactly 2 images to the 'smallImages' prop and ensure you supply a 'featureImage' prop object. Do not exceed 40 characters for the 'heading' prop. Do not exceed 130 characters for the 'description' prop. If you supply multiple 'actions', ensure to use a variant of 'default' for the first action, and 'outline' for the second action to ensure proper visual distinction between the two CTAs. Follow the example props closely for this block.",
+    importantUsageNotes: "Only use if you have a valid testimonial - DO NOT MAKE UP A TESTIMONIAL/REVIEW. Supply exactly 2 images to the 'smallImages' prop and ensure you supply a 'featureImage' prop object. Do not exceed 40 characters for the 'heading' prop. Do not exceed 130 characters for the 'description' prop. If you supply multiple 'actions', ensure to use a variant of 'default' for the first action, and 'outline' for the second action to ensure proper visual distinction between the two CTAs. All media src values must be absolute URLs to real CDN assets \u2014 never relative paths (e.g. '/images/...') or placeholder strings. Follow the example props closely for this block.",
     usageRequirements: {
       requiredProps: ["heading", "smallImages", "featureImage", "testimonial"],
       propConstraints: {
@@ -112131,20 +112147,29 @@ var BLOCK_REGISTRY = {
       },
       requiresSiteCapabilities: ["reviews_or_testimonials", "media_library"]
     },
-    defaultProps: {
+    exampleProps: {
       heading: "Compassionate care for your mental wellbeing",
       description: "Our team of experienced mental health professionals is dedicated to providing compassionate care and support to individuals in need.",
       smallImages: [
-        { src: "/images/team-1.jpg", alt: "Dr. Smith" },
-        { src: "/images/team-2.jpg", alt: "Dr. Johnson" }
+        {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Dr. Smith"
+        },
+        {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Dr. Johnson"
+        }
       ],
       testimonial: {
         quote: "The support I received changed my life. I'm so grateful for the compassionate care.",
         author: "Sarah M.",
         role: "Client",
-        avatarSrc: "/images/avatar.jpg"
+        avatarSrc: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp"
+      },
+      featureImage: {
+        src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+        alt: "Mental health support"
       },
-      featureImage: { src: "/images/feature.jpg", alt: "Mental health support" },
       actions: [
         { label: "Get Started", href: "#", variant: "default" },
         { label: "Talk to Sales", href: "#", variant: "outline" }
@@ -112169,7 +112194,101 @@ var BLOCK_REGISTRY = {
     category: "hero",
     component: HeroMentorshipVideoSplit,
     props: "HeroMentorshipVideoSplitProps",
-    exampleUsage: `<HeroMentorshipVideoSplit />`.trim()
+    exampleUsage: `
+<HeroMentorshipVideoSplit
+  heading="Reclaim Your Peace. Scale Sustainably."
+  description="Somatic mindset coaching for high-achieving entrepreneurs ready to lead from strength \u2014 not survival mode."
+  action={{ label: "Book Your Discovery Call", href: "/contact", variant: "default", size: "lg" }}
+  videoLabel="Watch the Overview"
+  videoTitle="Coaching Overview"
+  modalVideo={{
+    image: {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Coaching overview poster",
+    },
+    video: {
+      src: "https://toastability-production.s3.amazonaws.com/4kox2ux0ye1wlqkdwg03s08a67i1",
+    },
+  }}
+  image={{
+    src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+    alt: "Coach portrait",
+  }}
+  background="dark"
+/>
+    `.trim(),
+    importantUsageNotes: "The 'image' prop is the main hero image and MUST be an image asset (poster/photo). The 'modalVideo' prop's nested 'video.src' MUST be a video asset (HLS playlist or MP4) and 'modalVideo.image.src' MUST be an image asset (video poster). NEVER swap these: do not put a video URL into the 'image' prop and do not put an image URL into 'modalVideo.video.src'. All media src values must be absolute URLs to real CDN assets \u2014 never relative paths or placeholder strings. Keep 'heading' concise (under 60 characters) for visual balance.",
+    usageRequirements: {
+      requiredProps: ["heading", "image"],
+      propConstraints: {
+        heading: { required: true, maxLength: 60 },
+        description: { maxLength: 220 },
+        image: {
+          required: true,
+          note: "Main hero image. Must be an image asset (jpg/png/webp), NOT a video URL."
+        },
+        "modalVideo.video.src": {
+          note: "Must be a video asset URL (HLS .m3u8 master playlist or .mp4). Must NOT be an image URL."
+        },
+        "modalVideo.image.src": {
+          note: "Video poster image. Must be an image asset, NOT a video URL."
+        }
+      },
+      mediaSlots: {
+        image: {
+          path: "image",
+          roles: ["hero", "feature", "profile"],
+          disallowedRoles: ["logo", "favicon", "video-thumbnail"],
+          minPixelClass: "large",
+          required: true,
+          note: "Main hero image slot. IMAGE MEDIA ONLY. Do not assign a video URL here."
+        },
+        "modalVideo.video.src": {
+          path: "modalVideo.video.src",
+          roles: [],
+          disallowedRoles: ["logo", "favicon", "hero", "feature", "profile"],
+          note: "VIDEO MEDIA ONLY (HLS master playlist or MP4). Do not assign an image URL here."
+        },
+        "modalVideo.image.src": {
+          path: "modalVideo.image.src",
+          roles: ["video-thumbnail", "hero", "feature"],
+          disallowedRoles: ["logo", "favicon"],
+          minPixelClass: "medium",
+          note: "Poster image shown before the video plays. IMAGE MEDIA ONLY."
+        }
+      },
+      requiresSiteCapabilities: ["media_library"],
+      notes: [
+        "Image and video media must never be swapped between the 'image' prop and the 'modalVideo' prop.",
+        "All media src values must be absolute URLs to real assets; relative paths are not allowed."
+      ]
+    },
+    exampleProps: {
+      heading: "Reclaim Your Peace. Scale Sustainably.",
+      description: "Somatic mindset coaching for high-achieving entrepreneurs ready to lead from strength \u2014 not survival mode.",
+      action: {
+        label: "Book Your Discovery Call",
+        href: "/contact",
+        variant: "default",
+        size: "lg"
+      },
+      videoLabel: "Watch the Overview",
+      videoTitle: "Coaching Overview",
+      modalVideo: {
+        image: {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Coaching overview poster"
+        },
+        video: {
+          src: "https://toastability-production.s3.amazonaws.com/4kox2ux0ye1wlqkdwg03s08a67i1"
+        }
+      },
+      image: {
+        src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+        alt: "Coach portrait"
+      },
+      background: "dark"
+    }
   },
   "hero-business-operations-mosaic": {
     id: "hero-business-operations-mosaic",
@@ -120450,7 +120569,7 @@ function normalizeBlock(block, source) {
     },
     examples: {
       exampleUsage: block.exampleUsage || null,
-      defaultData: block.defaultProps ? JSON.parse(JSON.stringify(block.defaultProps)) : null
+      exampleProps: block.exampleProps ? JSON.parse(JSON.stringify(block.exampleProps)) : null
     },
     source: source ?? null,
     importantUsageNotes: block.importantUsageNotes ?? null,

package/dist/registry.d.cts

@@ -108,11 +108,18 @@ interface BlockContractFields {
     /** Structured, machine-readable usage requirements. */
     usageRequirements?: BlockUsageRequirements;
     /**
-     * Canonical default / example payload for the block, matching the prop
-     * shape. Optional. When supplied, consumers should prefer this over
-     * parsing `exampleUsage` JSX.
+     * Canonical example payload for the block, matching the prop shape.
+     * Optional. When supplied, consumers should prefer this over parsing
+     * `exampleUsage` JSX.
+     *
+     * IMPORTANT: These are reference examples for AI prompting / preview
+     * tooling only. They are NOT runtime defaults — consumers MUST NOT
+     * substitute these values as fallback content on a real client site.
+     * The previous name (`defaultProps`) was renamed to make this explicit:
+     * AI agents had begun treating "default" values as safe runtime
+     * fallbacks for missing client data, which is incorrect.
      */
-    defaultProps?: Record<string, unknown>;
+    exampleProps?: Record<string, unknown>;
 }
 /**
  * Metadata-only block registry entry (no component import)
@@ -164,12 +171,16 @@ interface BuilderContractPropsContract {
 interface BuilderContractExamples {
     exampleUsage: string | null;
     /**
-     * Canonical default / example props payload. Populated from
-     * BlockRegistryEntry.defaultProps when declared, otherwise null.
-     * Older consumers that expected this to always be null should treat
-     * an object value as advisory example data, not as a schema.
+     * Canonical example props payload. Populated from
+     * BlockRegistryEntry.exampleProps when declared, otherwise null.
+     *
+     * IMPORTANT: This is reference example data only, not a runtime
+     * fallback. Consumers MUST NOT substitute these values for missing
+     * client content. The previous name (`defaultData`) was renamed
+     * because downstream AI agents were treating it as safe runtime
+     * default content.
      */
-    defaultData: Record<string, unknown> | null;
+    exampleProps: Record<string, unknown> | null;
 }
 interface BuilderContractBlock {
     componentId: string;

package/dist/registry.d.ts

@@ -108,11 +108,18 @@ interface BlockContractFields {
     /** Structured, machine-readable usage requirements. */
     usageRequirements?: BlockUsageRequirements;
     /**
-     * Canonical default / example payload for the block, matching the prop
-     * shape. Optional. When supplied, consumers should prefer this over
-     * parsing `exampleUsage` JSX.
+     * Canonical example payload for the block, matching the prop shape.
+     * Optional. When supplied, consumers should prefer this over parsing
+     * `exampleUsage` JSX.
+     *
+     * IMPORTANT: These are reference examples for AI prompting / preview
+     * tooling only. They are NOT runtime defaults — consumers MUST NOT
+     * substitute these values as fallback content on a real client site.
+     * The previous name (`defaultProps`) was renamed to make this explicit:
+     * AI agents had begun treating "default" values as safe runtime
+     * fallbacks for missing client data, which is incorrect.
      */
-    defaultProps?: Record<string, unknown>;
+    exampleProps?: Record<string, unknown>;
 }
 /**
  * Metadata-only block registry entry (no component import)
@@ -164,12 +171,16 @@ interface BuilderContractPropsContract {
 interface BuilderContractExamples {
     exampleUsage: string | null;
     /**
-     * Canonical default / example props payload. Populated from
-     * BlockRegistryEntry.defaultProps when declared, otherwise null.
-     * Older consumers that expected this to always be null should treat
-     * an object value as advisory example data, not as a schema.
+     * Canonical example props payload. Populated from
+     * BlockRegistryEntry.exampleProps when declared, otherwise null.
+     *
+     * IMPORTANT: This is reference example data only, not a runtime
+     * fallback. Consumers MUST NOT substitute these values for missing
+     * client content. The previous name (`defaultData`) was renamed
+     * because downstream AI agents were treating it as safe runtime
+     * default content.
      */
-    defaultData: Record<string, unknown> | null;
+    exampleProps: Record<string, unknown> | null;
 }
 interface BuilderContractBlock {
     componentId: string;

package/dist/registry.js

@@ -66935,16 +66935,22 @@ var FeaturedCardsGridDropdown = ({
   optixFlowConfig
 }) => {
   return /* @__PURE__ */ jsxs("div", { children: [
-    /* @__PURE__ */ jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsx(
+    featuredLinks && featuredLinks?.length > 0 ? /* @__PURE__ */ jsx("div", { className: "flex gap-4 pb-8", children: featuredLinks?.map((link, index) => /* @__PURE__ */ jsx(
       FeaturedLink,
       {
         link,
         optixFlowConfig
       },
       `desktop-featured-link-${index}`
-    )) }),
-    /* @__PURE__ */ jsx(Separator, {}),
-    /* @__PURE__ */ jsx("div", { className: "grid grid-cols-4 pt-8", children: links?.map((link, index) => /* @__PURE__ */ jsx(NavLink, { link }, `default-nav-link-${index}`)) })
+    )) }) : null,
+    featuredLinks && featuredLinks?.length > 0 && links && links?.length > 0 ? /* @__PURE__ */ jsx(Separator, {}) : null,
+    links && links?.length > 0 ? /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `grid grid-cols-4 pt-${featuredLinks && featuredLinks?.length > 0 ? 8 : 0} gap-4`,
+        children: links?.map((link, index) => /* @__PURE__ */ jsx(NavLink, { link }, `default-nav-link-${index}`))
+      }
+    ) : null
   ] });
 };
 var GroupedLinksImageDropdown = ({
@@ -112025,17 +112031,27 @@ var BLOCK_REGISTRY = {
   heading="Compassionate care for your mental wellbeing"
   description="Our team of experienced mental health professionals is dedicated to providing compassionate care and support to individuals in need."
   smallImages={[
-    { src: "/images/team-1.jpg", alt: "Dr. Smith" },
-    { src: "/images/team-2.jpg", alt: "Dr. Johnson" },
+    {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Dr. Smith",
+    },
+    {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Dr. Johnson",
+    },
   ]}
   testimonial={{
     quote:
       "The support I received changed my life. I'm so grateful for the compassionate care.",
     author: "Sarah M.",
     role: "Client",
-    avatarSrc: "/images/avatar.jpg",
+    avatarSrc:
+      "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+  }}
+  featureImage={{
+    src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+    alt: "Mental health support",
   }}
-  featureImage={{ src: "/images/feature.jpg", alt: "Mental health support" }}
   actions={[
     { label: "Get Started", href: "#", variant: "default" },
     { label: "Talk to Sales", href: "#", variant: "outline" },
@@ -112043,7 +112059,7 @@ var BLOCK_REGISTRY = {
   background="gray"
 />
     `.trim(),
-    importantUsageNotes: "Only use if you have a valid testimonial - DO NOT MAKE UP A TESTIMONIAL/REVIEW. Supply exactly 2 images to the 'smallImages' prop and ensure you supply a 'featureImage' prop object. Do not exceed 40 characters for the 'heading' prop. Do not exceed 130 characters for the 'description' prop. If you supply multiple 'actions', ensure to use a variant of 'default' for the first action, and 'outline' for the second action to ensure proper visual distinction between the two CTAs. Follow the example props closely for this block.",
+    importantUsageNotes: "Only use if you have a valid testimonial - DO NOT MAKE UP A TESTIMONIAL/REVIEW. Supply exactly 2 images to the 'smallImages' prop and ensure you supply a 'featureImage' prop object. Do not exceed 40 characters for the 'heading' prop. Do not exceed 130 characters for the 'description' prop. If you supply multiple 'actions', ensure to use a variant of 'default' for the first action, and 'outline' for the second action to ensure proper visual distinction between the two CTAs. All media src values must be absolute URLs to real CDN assets \u2014 never relative paths (e.g. '/images/...') or placeholder strings. Follow the example props closely for this block.",
     usageRequirements: {
       requiredProps: ["heading", "smallImages", "featureImage", "testimonial"],
       propConstraints: {
@@ -112091,20 +112107,29 @@ var BLOCK_REGISTRY = {
       },
       requiresSiteCapabilities: ["reviews_or_testimonials", "media_library"]
     },
-    defaultProps: {
+    exampleProps: {
       heading: "Compassionate care for your mental wellbeing",
       description: "Our team of experienced mental health professionals is dedicated to providing compassionate care and support to individuals in need.",
       smallImages: [
-        { src: "/images/team-1.jpg", alt: "Dr. Smith" },
-        { src: "/images/team-2.jpg", alt: "Dr. Johnson" }
+        {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Dr. Smith"
+        },
+        {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Dr. Johnson"
+        }
       ],
       testimonial: {
         quote: "The support I received changed my life. I'm so grateful for the compassionate care.",
         author: "Sarah M.",
         role: "Client",
-        avatarSrc: "/images/avatar.jpg"
+        avatarSrc: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp"
+      },
+      featureImage: {
+        src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+        alt: "Mental health support"
       },
-      featureImage: { src: "/images/feature.jpg", alt: "Mental health support" },
       actions: [
         { label: "Get Started", href: "#", variant: "default" },
         { label: "Talk to Sales", href: "#", variant: "outline" }
@@ -112129,7 +112154,101 @@ var BLOCK_REGISTRY = {
     category: "hero",
     component: HeroMentorshipVideoSplit,
     props: "HeroMentorshipVideoSplitProps",
-    exampleUsage: `<HeroMentorshipVideoSplit />`.trim()
+    exampleUsage: `
+<HeroMentorshipVideoSplit
+  heading="Reclaim Your Peace. Scale Sustainably."
+  description="Somatic mindset coaching for high-achieving entrepreneurs ready to lead from strength \u2014 not survival mode."
+  action={{ label: "Book Your Discovery Call", href: "/contact", variant: "default", size: "lg" }}
+  videoLabel="Watch the Overview"
+  videoTitle="Coaching Overview"
+  modalVideo={{
+    image: {
+      src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+      alt: "Coaching overview poster",
+    },
+    video: {
+      src: "https://toastability-production.s3.amazonaws.com/4kox2ux0ye1wlqkdwg03s08a67i1",
+    },
+  }}
+  image={{
+    src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+    alt: "Coach portrait",
+  }}
+  background="dark"
+/>
+    `.trim(),
+    importantUsageNotes: "The 'image' prop is the main hero image and MUST be an image asset (poster/photo). The 'modalVideo' prop's nested 'video.src' MUST be a video asset (HLS playlist or MP4) and 'modalVideo.image.src' MUST be an image asset (video poster). NEVER swap these: do not put a video URL into the 'image' prop and do not put an image URL into 'modalVideo.video.src'. All media src values must be absolute URLs to real CDN assets \u2014 never relative paths or placeholder strings. Keep 'heading' concise (under 60 characters) for visual balance.",
+    usageRequirements: {
+      requiredProps: ["heading", "image"],
+      propConstraints: {
+        heading: { required: true, maxLength: 60 },
+        description: { maxLength: 220 },
+        image: {
+          required: true,
+          note: "Main hero image. Must be an image asset (jpg/png/webp), NOT a video URL."
+        },
+        "modalVideo.video.src": {
+          note: "Must be a video asset URL (HLS .m3u8 master playlist or .mp4). Must NOT be an image URL."
+        },
+        "modalVideo.image.src": {
+          note: "Video poster image. Must be an image asset, NOT a video URL."
+        }
+      },
+      mediaSlots: {
+        image: {
+          path: "image",
+          roles: ["hero", "feature", "profile"],
+          disallowedRoles: ["logo", "favicon", "video-thumbnail"],
+          minPixelClass: "large",
+          required: true,
+          note: "Main hero image slot. IMAGE MEDIA ONLY. Do not assign a video URL here."
+        },
+        "modalVideo.video.src": {
+          path: "modalVideo.video.src",
+          roles: [],
+          disallowedRoles: ["logo", "favicon", "hero", "feature", "profile"],
+          note: "VIDEO MEDIA ONLY (HLS master playlist or MP4). Do not assign an image URL here."
+        },
+        "modalVideo.image.src": {
+          path: "modalVideo.image.src",
+          roles: ["video-thumbnail", "hero", "feature"],
+          disallowedRoles: ["logo", "favicon"],
+          minPixelClass: "medium",
+          note: "Poster image shown before the video plays. IMAGE MEDIA ONLY."
+        }
+      },
+      requiresSiteCapabilities: ["media_library"],
+      notes: [
+        "Image and video media must never be swapped between the 'image' prop and the 'modalVideo' prop.",
+        "All media src values must be absolute URLs to real assets; relative paths are not allowed."
+      ]
+    },
+    exampleProps: {
+      heading: "Reclaim Your Peace. Scale Sustainably.",
+      description: "Somatic mindset coaching for high-achieving entrepreneurs ready to lead from strength \u2014 not survival mode.",
+      action: {
+        label: "Book Your Discovery Call",
+        href: "/contact",
+        variant: "default",
+        size: "lg"
+      },
+      videoLabel: "Watch the Overview",
+      videoTitle: "Coaching Overview",
+      modalVideo: {
+        image: {
+          src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+          alt: "Coaching overview poster"
+        },
+        video: {
+          src: "https://toastability-production.s3.amazonaws.com/4kox2ux0ye1wlqkdwg03s08a67i1"
+        }
+      },
+      image: {
+        src: "https://cdn.ing/assets/i/r/308196/g6bbn73f7gxal82uu49m9prfd0u8/workplace-in-cafe.webp",
+        alt: "Coach portrait"
+      },
+      background: "dark"
+    }
   },
   "hero-business-operations-mosaic": {
     id: "hero-business-operations-mosaic",
@@ -120410,7 +120529,7 @@ function normalizeBlock(block, source) {
     },
     examples: {
       exampleUsage: block.exampleUsage || null,
-      defaultData: block.defaultProps ? JSON.parse(JSON.stringify(block.defaultProps)) : null
+      exampleProps: block.exampleProps ? JSON.parse(JSON.stringify(block.exampleProps)) : null
     },
     source: source ?? null,
     importantUsageNotes: block.importantUsageNotes ?? null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensite/ui",
-  "version": "3.5.7",
+  "version": "3.5.9",
   "description": "Foundational UI component library for OpenSite Semantic Site Builder with tree-shakable exports and abstract styling",
   "keywords": [
     "react",