@opensite/ui 3.6.5 → 3.6.6

package/dist/registry.js

@@ -52987,8 +52987,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__ */ jsx(Fragment, { children: logoSlot2 });
+  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 });
+};
 function HeroDashedBorderFeatures({
   sectionId = "hero-dashed-border-features",
+  logo,
+  logoSlot: logoSlot2,
+  logoClassName,
   badgeText,
   announcementText,
   announcementHref,
@@ -53000,7 +53044,7 @@ function HeroDashedBorderFeatures({
   features,
   featuresSlot,
   background,
-  spacing = "xl",
+  spacing = "hero",
   pattern,
   patternOpacity,
   className,
@@ -53073,14 +53117,18 @@ function HeroDashedBorderFeatures({
       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__ */ 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__ */ jsx(DynamicIcon, { name: feature.iconName || "lucide/check", size: 20 }) : null }),
-          feature.title
+          feature.icon || feature.iconName ? /* @__PURE__ */ 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__ */ jsx(DynamicIcon, { name: feature.icon || feature.iconName, size: 20 }) }) : null,
+          feature.title || feature.description ? /* @__PURE__ */ jsxs("div", { className: "text-left flex flex-col gap-1", children: [
+            feature.title ? /* @__PURE__ */ 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__ */ jsx("div", { className: "text-sm md:text-base opacity-70 text-balance line-clamp-1", children: feature.description }) : feature.description : null
+          ] }) : null
         ]
       },
       index
@@ -53097,6 +53145,7 @@ function HeroDashedBorderFeatures({
       className: cn("relative flex items-center justify-center", className),
       containerClassName,
       children: /* @__PURE__ */ jsxs("div", { className: "relative", children: [
+        (logo || logoSlot2) && /* @__PURE__ */ jsx("div", { className: cn("mb-6", logoClassName), children: /* @__PURE__ */ jsx(BrandLogo, { logo, logoSlot: logoSlot2, size: "lg" }) }),
         /* @__PURE__ */ jsx(
           "div",
           {
@@ -53110,12 +53159,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__ */ jsx("div", { className: headingClassName, children: heading })),
+              ) : heading),
               description && (typeof description === "string" ? /* @__PURE__ */ jsx(
                 "p",
                 {
@@ -53125,7 +53174,7 @@ function HeroDashedBorderFeatures({
                   ),
                   children: description
                 }
-              ) : /* @__PURE__ */ jsx("div", { className: descriptionClassName, children: description })),
+              ) : description),
               renderActions
             ] })
           }
@@ -53191,13 +53240,17 @@ function HeroDesignCarouselPortfolio({
   const renderLogo = 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__ */ jsx(
-      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
       }
     );
@@ -55841,6 +55894,9 @@ function HeroDesignShowcaseLogos({
 }
 function HeroVideoOverlayStars({
   sectionId = "hero-video-overlay-stars",
+  logo,
+  logoSlot: logoSlot2,
+  logoClassName,
   heading,
   actions,
   actionsSlot,
@@ -55904,6 +55960,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 || logoSlot2) && /* @__PURE__ */ jsx("div", { className: cn("mb-2 flex justify-center", logoClassName), children: /* @__PURE__ */ jsx(BrandLogo, { logo, logoSlot: logoSlot2, size: "lg" }) }),
           /* @__PURE__ */ jsxs("div", { className: cn("flex w-full flex-col gap-8", contentClassName), children: [
             heading && (typeof heading === "string" ? /* @__PURE__ */ jsx(
               "h1",
@@ -117149,13 +117206,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" },
@@ -117163,25 +117223,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" },
@@ -117195,12 +117262,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" },
@@ -117214,7 +117282,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: {
@@ -117222,21 +117290,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: [
@@ -118023,6 +118093,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: "#" }]}
@@ -118035,21 +118106,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 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensite/ui",
-  "version": "3.6.5",
+  "version": "3.6.6",
   "description": "Foundational UI component library for OpenSite Semantic Site Builder with tree-shakable exports and abstract styling",
   "keywords": [
     "react",
@@ -3006,6 +3006,11 @@
       "import": "./dist/brand-attribution.js",
       "require": "./dist/brand-attribution.cjs"
     },
+    "./components/brand-logo": {
+      "types": "./dist/brand-logo.d.ts",
+      "import": "./dist/brand-logo.js",
+      "require": "./dist/brand-logo.cjs"
+    },
     "./components/breadcrumb": {
       "types": "./dist/breadcrumb.d.ts",
       "import": "./dist/breadcrumb.js",