@opensite/ui 3.6.5 → 3.6.6

package/dist/hero-video-overlay-stars.cjs

@@ -8,6 +8,7 @@ var video = require('@page-speed/video');
 var icon = require('@page-speed/icon');
 var jsxRuntime = require('react/jsx-runtime');
 var pressable = require('@page-speed/pressable');
+var img = require('@page-speed/img');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -46,6 +47,47 @@ var DynamicIcon = React__namespace.memo(function DynamicIcon2({
   return /* @__PURE__ */ jsxRuntime.jsx(icon.Icon, { ...props, name, apiKey: apiKey ?? DEFAULT_ICON_API_KEY });
 });
 DynamicIcon.displayName = "DynamicIcon";
+var SIZE_CLASSES = {
+  sm: "max-h-6 sm:max-h-7",
+  md: "max-h-8 sm:max-h-9 lg:max-h-10",
+  lg: "max-h-10 sm:max-h-12 lg:max-h-14",
+  xl: "max-h-12 sm:max-h-14 lg:max-h-16"
+};
+var BrandLogo = ({
+  logo,
+  logoSlot,
+  logoClassName,
+  size = "md",
+  optixFlowConfig
+}) => {
+  if (logoSlot) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: logoSlot });
+  if (!logo || !logo.src) return null;
+  const imgElement = /* @__PURE__ */ jsxRuntime.jsx(
+    img.Img,
+    {
+      src: logo.src,
+      className: cn(
+        "w-auto object-contain",
+        SIZE_CLASSES[size],
+        logo.className
+      ),
+      alt: logo.alt || "Logo",
+      optixFlowConfig,
+      loading: "eager"
+    }
+  );
+  if (logo.url) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      pressable.Pressable,
+      {
+        href: logo.url,
+        className: cn("flex items-center", logoClassName),
+        children: imgElement
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("flex items-center", logoClassName), children: imgElement });
+};
 var maxWidthStyles = {
   sm: "max-w-screen-sm",
   md: "max-w-screen-md",
@@ -502,6 +544,9 @@ function ActionComponent({ action }) {
 }
 function HeroVideoOverlayStars({
   sectionId = "hero-video-overlay-stars",
+  logo,
+  logoSlot,
+  logoClassName,
   heading,
   actions,
   actionsSlot,
@@ -565,6 +610,7 @@ function HeroVideoOverlayStars({
       containerClassName,
       children: [
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative z-10 flex size-full", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "m-auto flex max-w-100 flex-col items-center gap-9 sm:max-w-125 md:max-w-200 text-center", children: [
+          (logo || logoSlot) && /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("mb-2 flex justify-center", logoClassName), children: /* @__PURE__ */ jsxRuntime.jsx(BrandLogo, { logo, logoSlot, size: "lg" }) }),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cn("flex w-full flex-col gap-8", contentClassName), children: [
             heading && (typeof heading === "string" ? /* @__PURE__ */ jsxRuntime.jsx(
               "h1",

package/dist/hero-video-overlay-stars.d.cts

@@ -1,7 +1,10 @@
 import * as React from 'react';
 import { S as SectionBackground, s as SectionSpacing, t as PatternName } from './community-initiatives-Cgd-IXlI.cjs';
+import { L as LogoConfig } from './types-mWZcgKth.cjs';
 import { A as ActionConfig, M as MediaItem } from './blocks-DyouPohq.cjs';
 import 'react/jsx-runtime';
+import './dynamic-icon.cjs';
+import '@page-speed/icon';
 import 'class-variance-authority';
 import '@page-speed/pressable';
 import '@opensite/hooks/usePlatformFromUrl';
@@ -20,6 +23,19 @@ interface TrustConfig {
     message?: string;
 }
 interface HeroVideoOverlayStarsProps {
+    /**
+     * Brand logo configuration — renders centered above the heading.
+     * LOGO MEDIA ONLY. Do not use photos, hero images, or video assets.
+     */
+    logo?: LogoConfig;
+    /**
+     * Custom slot for logo (overrides logo prop)
+     */
+    logoSlot?: React.ReactNode;
+    /**
+     * Additional CSS classes for the logo container
+     */
+    logoClassName?: string;
     /**
      * Main heading text
      */
@@ -103,6 +119,6 @@ interface HeroVideoOverlayStarsProps {
  * HeroVideoOverlayStars - A full-screen hero with video background, gradient text heading,
  * prominent CTA button, and star rating trust indicator. Ideal for product launches.
  */
-declare function HeroVideoOverlayStars({ sectionId, heading, actions, actionsSlot, actionsClassName, description, descriptionClassName, trust, trustSlot, background, spacing, pattern, patternOpacity, containerClassName, contentClassName, className, headingClassName, backgroundVideo, videoSrc, videoSlot, }: HeroVideoOverlayStarsProps): React.JSX.Element;
+declare function HeroVideoOverlayStars({ sectionId, logo, logoSlot, logoClassName, heading, actions, actionsSlot, actionsClassName, description, descriptionClassName, trust, trustSlot, background, spacing, pattern, patternOpacity, containerClassName, contentClassName, className, headingClassName, backgroundVideo, videoSrc, videoSlot, }: HeroVideoOverlayStarsProps): React.JSX.Element;
 
 export { HeroVideoOverlayStars, type HeroVideoOverlayStarsProps };

package/dist/hero-video-overlay-stars.d.ts

@@ -1,7 +1,10 @@
 import * as React from 'react';
 import { S as SectionBackground, s as SectionSpacing, t as PatternName } from './community-initiatives-Dud0DKXB.js';
+import { L as LogoConfig } from './types-hJ2R0GoH.js';
 import { A as ActionConfig, M as MediaItem } from './blocks-DyouPohq.js';
 import 'react/jsx-runtime';
+import './dynamic-icon.js';
+import '@page-speed/icon';
 import 'class-variance-authority';
 import '@page-speed/pressable';
 import '@opensite/hooks/usePlatformFromUrl';
@@ -20,6 +23,19 @@ interface TrustConfig {
     message?: string;
 }
 interface HeroVideoOverlayStarsProps {
+    /**
+     * Brand logo configuration — renders centered above the heading.
+     * LOGO MEDIA ONLY. Do not use photos, hero images, or video assets.
+     */
+    logo?: LogoConfig;
+    /**
+     * Custom slot for logo (overrides logo prop)
+     */
+    logoSlot?: React.ReactNode;
+    /**
+     * Additional CSS classes for the logo container
+     */
+    logoClassName?: string;
     /**
      * Main heading text
      */
@@ -103,6 +119,6 @@ interface HeroVideoOverlayStarsProps {
  * HeroVideoOverlayStars - A full-screen hero with video background, gradient text heading,
  * prominent CTA button, and star rating trust indicator. Ideal for product launches.
  */
-declare function HeroVideoOverlayStars({ sectionId, heading, actions, actionsSlot, actionsClassName, description, descriptionClassName, trust, trustSlot, background, spacing, pattern, patternOpacity, containerClassName, contentClassName, className, headingClassName, backgroundVideo, videoSrc, videoSlot, }: HeroVideoOverlayStarsProps): React.JSX.Element;
+declare function HeroVideoOverlayStars({ sectionId, logo, logoSlot, logoClassName, heading, actions, actionsSlot, actionsClassName, description, descriptionClassName, trust, trustSlot, background, spacing, pattern, patternOpacity, containerClassName, contentClassName, className, headingClassName, backgroundVideo, videoSrc, videoSlot, }: HeroVideoOverlayStarsProps): React.JSX.Element;
 
 export { HeroVideoOverlayStars, type HeroVideoOverlayStarsProps };

package/dist/hero-video-overlay-stars.js

@@ -7,6 +7,7 @@ import { Video } from '@page-speed/video';
 import { Icon } from '@page-speed/icon';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { Pressable, buttonVariants } from '@page-speed/pressable';
+import { Img } from '@page-speed/img';
 
 // components/blocks/hero/hero-video-overlay-stars.tsx
 function cn(...inputs) {
@@ -25,6 +26,47 @@ var DynamicIcon = React.memo(function DynamicIcon2({
   return /* @__PURE__ */ jsx(Icon, { ...props, name, apiKey: apiKey ?? DEFAULT_ICON_API_KEY });
 });
 DynamicIcon.displayName = "DynamicIcon";
+var SIZE_CLASSES = {
+  sm: "max-h-6 sm:max-h-7",
+  md: "max-h-8 sm:max-h-9 lg:max-h-10",
+  lg: "max-h-10 sm:max-h-12 lg:max-h-14",
+  xl: "max-h-12 sm:max-h-14 lg:max-h-16"
+};
+var BrandLogo = ({
+  logo,
+  logoSlot,
+  logoClassName,
+  size = "md",
+  optixFlowConfig
+}) => {
+  if (logoSlot) return /* @__PURE__ */ jsx(Fragment, { children: logoSlot });
+  if (!logo || !logo.src) return null;
+  const imgElement = /* @__PURE__ */ jsx(
+    Img,
+    {
+      src: logo.src,
+      className: cn(
+        "w-auto object-contain",
+        SIZE_CLASSES[size],
+        logo.className
+      ),
+      alt: logo.alt || "Logo",
+      optixFlowConfig,
+      loading: "eager"
+    }
+  );
+  if (logo.url) {
+    return /* @__PURE__ */ jsx(
+      Pressable,
+      {
+        href: logo.url,
+        className: cn("flex items-center", logoClassName),
+        children: imgElement
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx("div", { className: cn("flex items-center", logoClassName), children: imgElement });
+};
 var maxWidthStyles = {
   sm: "max-w-screen-sm",
   md: "max-w-screen-md",
@@ -481,6 +523,9 @@ function ActionComponent({ action }) {
 }
 function HeroVideoOverlayStars({
   sectionId = "hero-video-overlay-stars",
+  logo,
+  logoSlot,
+  logoClassName,
   heading,
   actions,
   actionsSlot,
@@ -544,6 +589,7 @@ function HeroVideoOverlayStars({
       containerClassName,
       children: [
         /* @__PURE__ */ jsx("div", { className: "relative z-10 flex size-full", children: /* @__PURE__ */ jsxs("div", { className: "m-auto flex max-w-100 flex-col items-center gap-9 sm:max-w-125 md:max-w-200 text-center", children: [
+          (logo || logoSlot) && /* @__PURE__ */ jsx("div", { className: cn("mb-2 flex justify-center", logoClassName), children: /* @__PURE__ */ jsx(BrandLogo, { logo, logoSlot, size: "lg" }) }),
           /* @__PURE__ */ jsxs("div", { className: cn("flex w-full flex-col gap-8", contentClassName), children: [
             heading && (typeof heading === "string" ? /* @__PURE__ */ jsx(
               "h1",

package/dist/registry.cjs

@@ -53027,8 +53027,52 @@ function HeroGridPatternEfficiency({
     }
   );
 }
+var SIZE_CLASSES = {
+  sm: "max-h-6 sm:max-h-7",
+  md: "max-h-8 sm:max-h-9 lg:max-h-10",
+  lg: "max-h-10 sm:max-h-12 lg:max-h-14",
+  xl: "max-h-12 sm:max-h-14 lg:max-h-16"
+};
+var BrandLogo = ({
+  logo,
+  logoSlot: logoSlot2,
+  logoClassName,
+  size = "md",
+  optixFlowConfig
+}) => {
+  if (logoSlot2) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: logoSlot2 });
+  if (!logo || !logo.src) return null;
+  const imgElement = /* @__PURE__ */ jsxRuntime.jsx(
+    img$1.Img,
+    {
+      src: logo.src,
+      className: cn(
+        "w-auto object-contain",
+        SIZE_CLASSES[size],
+        logo.className
+      ),
+      alt: logo.alt || "Logo",
+      optixFlowConfig,
+      loading: "eager"
+    }
+  );
+  if (logo.url) {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      pressable.Pressable,
+      {
+        href: logo.url,
+        className: cn("flex items-center", logoClassName),
+        children: imgElement
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("flex items-center", logoClassName), children: imgElement });
+};
 function HeroDashedBorderFeatures({
   sectionId = "hero-dashed-border-features",
+  logo,
+  logoSlot: logoSlot2,
+  logoClassName,
   badgeText,
   announcementText,
   announcementHref,
@@ -53040,7 +53084,7 @@ function HeroDashedBorderFeatures({
   features,
   featuresSlot,
   background,
-  spacing = "xl",
+  spacing = "hero",
   pattern,
   patternOpacity,
   className,
@@ -53113,14 +53157,18 @@ function HeroDashedBorderFeatures({
       pressable.Pressable,
       {
         className: cn(
-          "flex items-center gap-6 border-t border-dashed p-4 font-medium md:justify-center lg:p-10 lg:text-lg",
+          "flex items-center gap-6 border-t border-dashed p-4 md:justify-center lg:p-10 ",
+          feature.href ? "cursor-pointer bg-transparent transition-colors duration-300 hover:bg-card hover:text-card-foreground" : "",
           index === 1 && "md:border-x",
           index === 2 ? "border-b" : "md:border-b"
         ),
         href: feature.href,
         children: [
-          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex size-10 shrink-0 items-center justify-center rounded-md text-sm lg:size-12 lg:text-base bg-card text-card-foreground", children: feature.icon ? feature.icon : feature.iconName ? /* @__PURE__ */ jsxRuntime.jsx(DynamicIcon, { name: feature.iconName || "lucide/check", size: 20 }) : null }),
-          feature.title
+          feature.icon || feature.iconName ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex size-10 shrink-0 items-center justify-center rounded-md text-sm lg:size-12 lg:text-base bg-card text-card-foreground", children: /* @__PURE__ */ jsxRuntime.jsx(DynamicIcon, { name: feature.icon || feature.iconName, size: 20 }) }) : null,
+          feature.title || feature.description ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "text-left flex flex-col gap-1", children: [
+            feature.title ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "font-medium text-base md:text-lg line-clamp-2", children: feature.title }) : null,
+            feature.description ? typeof feature.description === "string" && feature.description?.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm md:text-base opacity-70 text-balance line-clamp-1", children: feature.description }) : feature.description : null
+          ] }) : null
         ]
       },
       index
@@ -53137,6 +53185,7 @@ function HeroDashedBorderFeatures({
       className: cn("relative flex items-center justify-center", className),
       containerClassName,
       children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative", children: [
+        (logo || logoSlot2) && /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("mb-6", logoClassName), children: /* @__PURE__ */ jsxRuntime.jsx(BrandLogo, { logo, logoSlot: logoSlot2, size: "lg" }) }),
         /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
@@ -53150,12 +53199,12 @@ function HeroDashedBorderFeatures({
                 "h1",
                 {
                   className: cn(
-                    "my-4 mb-6 text-center text-3xl font-semibold lg:text-8xl",
+                    "my-4 mb-6 text-center text-3xl font-semibold lg:text-8xl leading-tight",
                     headingClassName
                   ),
                   children: heading
                 }
-              ) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: headingClassName, children: heading })),
+              ) : heading),
               description && (typeof description === "string" ? /* @__PURE__ */ jsxRuntime.jsx(
                 "p",
                 {
@@ -53165,7 +53214,7 @@ function HeroDashedBorderFeatures({
                   ),
                   children: description
                 }
-              ) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: descriptionClassName, children: description })),
+              ) : description),
               renderActions
             ] })
           }
@@ -53231,13 +53280,17 @@ function HeroDesignCarouselPortfolio({
   const renderLogo = React30.useMemo(() => {
     if (logoSlot2) return logoSlot2;
     if (!logo) return null;
-    const logoSrc = typeof logo.src === "string" ? logo.src : logo.src.light;
+    const logoConfig = {
+      src: typeof logo.src === "string" ? logo.src : logo.src.light,
+      alt: logo.alt,
+      className: logo.className,
+      url: logo.href
+    };
     return /* @__PURE__ */ jsxRuntime.jsx(
-      img$1.Img,
+      BrandLogo,
       {
-        src: logoSrc,
-        className: cn("object-contain w-auto h-12 lg:h-16", logo.className),
-        alt: logo.alt,
+        logo: logoConfig,
+        size: "xl",
         optixFlowConfig
       }
     );
@@ -55881,6 +55934,9 @@ function HeroDesignShowcaseLogos({
 }
 function HeroVideoOverlayStars({
   sectionId = "hero-video-overlay-stars",
+  logo,
+  logoSlot: logoSlot2,
+  logoClassName,
   heading,
   actions,
   actionsSlot,
@@ -55944,6 +56000,7 @@ function HeroVideoOverlayStars({
       containerClassName,
       children: [
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative z-10 flex size-full", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "m-auto flex max-w-100 flex-col items-center gap-9 sm:max-w-125 md:max-w-200 text-center", children: [
+          (logo || logoSlot2) && /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("mb-2 flex justify-center", logoClassName), children: /* @__PURE__ */ jsxRuntime.jsx(BrandLogo, { logo, logoSlot: logoSlot2, size: "lg" }) }),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cn("flex w-full flex-col gap-8", contentClassName), children: [
             heading && (typeof heading === "string" ? /* @__PURE__ */ jsxRuntime.jsx(
               "h1",
@@ -117189,13 +117246,16 @@ var HERO_BLOCK_CONTRACTS = {
   "hero-dashed-border-features": {
     exampleUsage: `
 <HeroDashedBorderFeatures
+  logo={{ src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" }}
   heading="Features that make a difference"
   description="Discover the powerful capabilities that set us apart."
   badgeText="New Features"
+  announcementText="Latest innovations"
+  announcementHref="#"
   features={[
-    { icon: null, title: "Lightning Fast", description: "Optimized for speed", href: "#" },
-    { icon: null, title: "Secure by Default", description: "Enterprise-grade security", href: "#" },
-    { icon: null, title: "AI-Powered", description: "Smart automation", href: "#" },
+    { iconName: "lucide/zap", title: "Lightning Fast", description: "Optimized for speed", href: "#" },
+    { iconName: "lucide/shield", title: "Secure by Default", description: "Enterprise-grade security", href: "#" },
+    { iconName: "lucide/sparkles", title: "AI-Powered", description: "Smart automation", href: "#" },
   ]}
   actions={[
     { label: "Explore Features", href: "#", variant: "default" },
@@ -117203,25 +117263,32 @@ var HERO_BLOCK_CONTRACTS = {
   ]}
 />
     `.trim(),
-    importantUsageNotes: "Supply exactly 3 'features' objects. Do not exceed 50 characters for 'heading'. Do not exceed 130 characters for 'description'. If you supply multiple 'actions', use 'default' for the first and 'outline' for the second. This is a text/icon hero \u2014 no images required.",
+    importantUsageNotes: "The optional 'logo' prop accepts a LogoConfig object and renders via the BrandLogo component \u2014 it must be a brand logo image, NEVER a photo or hero image. Supply exactly 3 'features' objects. Do not exceed 50 characters for 'heading'. Do not exceed 130 characters for 'description'. If you supply multiple 'actions', use 'default' for the first and 'outline' for the second.",
     usageRequirements: {
       requiredProps: ["heading", "features"],
       propConstraints: {
         heading: { required: true, maxLength: 50 },
         description: { maxLength: 130 },
         features: { required: true, count: 3, minItems: 2, maxItems: 4 },
-        actions: { maxItems: 2, pinnedValues: { "0.variant": "default", "1.variant": "outline" } }
+        actions: { maxItems: 2, pinnedValues: { "0.variant": "default", "1.variant": "outline" } },
+        "logo.src": { note: "LOGO MEDIA ONLY. Must be a brand logo image (SVG, PNG, WebP). Never use a photo, hero image, or video asset." }
       },
-      mediaSlots: {}
+      mediaSlots: {
+        "logo.src": logoSlot("logo.src", "Brand logo rendered via BrandLogo component above the dashed border content.", false)
+      },
+      notes: ["The logo prop is optional. When provided, the BrandLogo component renders it above the announcement badge with responsive sizing."]
     },
     exampleProps: {
+      logo: { src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" },
       heading: "Features that make a difference",
       description: "Discover the powerful capabilities that set us apart.",
       badgeText: "New Features",
+      announcementText: "Latest innovations",
+      announcementHref: "#",
       features: [
-        { title: "Lightning Fast", description: "Optimized for speed", href: "#" },
-        { title: "Secure by Default", description: "Enterprise-grade security", href: "#" },
-        { title: "AI-Powered", description: "Smart automation", href: "#" }
+        { iconName: "lucide/zap", title: "Lightning Fast", description: "Optimized for speed", href: "#" },
+        { iconName: "lucide/shield", title: "Secure by Default", description: "Enterprise-grade security", href: "#" },
+        { iconName: "lucide/sparkles", title: "AI-Powered", description: "Smart automation", href: "#" }
       ],
       actions: [
         { label: "Explore Features", href: "#", variant: "default" },
@@ -117235,12 +117302,13 @@ var HERO_BLOCK_CONTRACTS = {
   "hero-design-carousel-portfolio": {
     exampleUsage: `
 <HeroDesignCarouselPortfolio
+  logo={{ src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" }}
   heading="Design portfolio that speaks volumes"
   description="Showcase your best work with beautiful, interactive carousels."
   features={[
-    { title: "Strategic Focus", description: "Aligning work with your goals." },
-    { title: "Rapid Execution", description: "Agile methodology for fast delivery." },
-    { title: "Human-Centered", description: "Design for people first." },
+    { iconName: "lucide/target", title: "Strategic Focus", description: "Aligning work with your goals." },
+    { iconName: "lucide/zap", title: "Rapid Execution", description: "Agile methodology for fast delivery." },
+    { iconName: "lucide/heart", title: "Human-Centered", description: "Design for people first." },
   ]}
   carouselImages={[
     { src: "${HERO_EXAMPLE_IMAGE_URL}", alt: "Design 1" },
@@ -117254,7 +117322,7 @@ var HERO_BLOCK_CONTRACTS = {
   ]}
 />
     `.trim(),
-    importantUsageNotes: `Supply exactly 4 carousel images. Supply exactly 3 'features' objects. Do not exceed 50 characters for 'heading'. Do not exceed 130 characters for 'description'. If you supply multiple 'actions', use 'default' for the first and 'outline' for the second.  ${HERO_MEDIA_NOTE}`,
+    importantUsageNotes: `The 'logo' prop renders via BrandLogo and must be a brand logo image (SVG, PNG, WebP) \u2014 NEVER a photo or hero image. The AI Agent must use a real brand logo asset here, not an image placeholder. Supply exactly 4 carousel images for the portfolio. Supply exactly 3 'features'. ${HERO_MEDIA_NOTE}`,
     usageRequirements: {
       requiredProps: ["heading", "carouselImages", "features"],
       propConstraints: {
@@ -117262,21 +117330,23 @@ var HERO_BLOCK_CONTRACTS = {
         description: { maxLength: 130 },
         carouselImages: { required: true, count: 4, minItems: 3, maxItems: 5 },
         features: { required: true, count: 3, minItems: 3, maxItems: 3 },
-        actions: { maxItems: 2, pinnedValues: { "0.variant": "default", "1.variant": "outline" } }
+        actions: { maxItems: 2, pinnedValues: { "0.variant": "default", "1.variant": "outline" } },
+        "logo.src": { note: "LOGO MEDIA ONLY. Must be a brand logo image. Never use a photo, hero image, or video asset." }
       },
       mediaSlots: {
         "carouselImages[]": imageSlot("carouselImages[]", "Portfolio showcase images for the carousel.", ["feature", "hero"], "medium", true),
-        "logo.src": logoSlot("logo.src", "Optional brand or client logo.")
+        "logo.src": logoSlot("logo.src", "Brand logo rendered via BrandLogo component above the features and heading.", false)
       },
       requiresSiteCapabilities: heroCapabilities("media_library")
     },
     exampleProps: {
+      logo: { src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" },
       heading: "Design portfolio that speaks volumes",
       description: "Showcase your best work with beautiful, interactive carousels.",
       features: [
-        { title: "Strategic Focus", description: "Aligning work with your goals." },
-        { title: "Rapid Execution", description: "Agile methodology for fast delivery." },
-        { title: "Human-Centered", description: "Design for people first." }
+        { iconName: "lucide/target", title: "Strategic Focus", description: "Aligning work with your goals." },
+        { iconName: "lucide/zap", title: "Rapid Execution", description: "Agile methodology for fast delivery." },
+        { iconName: "lucide/heart", title: "Human-Centered", description: "Design for people first." }
       ],
       carouselImages: Array(4).fill({ src: HERO_EXAMPLE_IMAGE_URL, alt: "Design" }),
       actions: [
@@ -118063,6 +118133,7 @@ var HERO_BLOCK_CONTRACTS = {
   "hero-video-overlay-stars": {
     exampleUsage: `
 <HeroVideoOverlayStars
+  logo={{ src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" }}
   heading="Trusted by thousands"
   description="Our solution is designed to streamline your business operations."
   actions={[{ label: "Try It Free", href: "#" }]}
@@ -118075,21 +118146,24 @@ var HERO_BLOCK_CONTRACTS = {
   trust={{ starCount: 5, message: "Trusted by 2,500+ customers" }}
 />
     `.trim(),
-    importantUsageNotes: `Only use when you have a real video asset. The 'backgroundVideo.video' prop requires masterPlaylistUrl and fallbackSrc. Only supply real 'trust.message' \u2014 do not fabricate review counts. Do not exceed 40 characters for 'heading'.  ${HERO_MEDIA_NOTE}`,
+    importantUsageNotes: `The optional 'logo' prop renders via BrandLogo centered above the heading \u2014 it must be a brand logo image, NEVER a photo. Only use when you have a real video asset. The 'backgroundVideo.video' prop requires masterPlaylistUrl and fallbackSrc. Only supply real 'trust.message' \u2014 do not fabricate review counts. ${HERO_MEDIA_NOTE}`,
     usageRequirements: {
       requiredProps: ["heading", "backgroundVideo"],
       propConstraints: {
         heading: { required: true, maxLength: 40 },
         description: { maxLength: 130 },
         backgroundVideo: { required: true, note: "Must contain a valid video with masterPlaylistUrl and fallbackSrc." },
-        "trust.message": { note: "Must be real trust/review data. Do not fabricate." }
+        "trust.message": { note: "Must be real trust/review data. Do not fabricate." },
+        "logo.src": { note: "LOGO MEDIA ONLY. Must be a brand logo image. Never use a photo, hero image, or video asset." }
       },
       mediaSlots: {
-        "backgroundVideo.video": videoMediaSlot("backgroundVideo.video")
+        "backgroundVideo.video": videoMediaSlot("backgroundVideo.video"),
+        "logo.src": logoSlot("logo.src", "Brand logo rendered via BrandLogo centered above the heading on the video overlay.", false)
       },
       requiresSiteCapabilities: heroCapabilities("media_library", "reviews_or_testimonials")
     },
     exampleProps: {
+      logo: { src: "https://cdn.ing/assets/i/r/287634/e4cmvu8nbwoqy2qer90t4gpap0ed/logo-light.png", alt: "Brand Logo" },
       heading: "Trusted by thousands",
       description: "Our solution is designed to streamline your business operations.",
       backgroundVideo: { video: EXAMPLE_VIDEO_1 },