@reblu/site-blocks 0.15.0 → 0.16.0

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
+export { DATA_REQUEST_TYPES } from '@reblu/site-contracts';
 import { FaqItem } from './seo.cjs';
 export { FaqPageJsonLd, MarkdownToPlainTextOptions, buildFaqPageJsonLd, collectFaqItems, markdownToPlainText } from './seo.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -489,8 +490,14 @@ declare function FaqAccordion({ items, heading, headingLevel, questionHeadingLev
  * - Badges are grouped by type (in {@link DEFAULT_TRUST_BADGE_TYPE_ORDER}, or
  *   the `types` prop), each group under an overridable heading, and ordered by
  *   `sortOrder` inside it.
- * - A logo is an `<img>` whose `alt` is the badge name; a badge without a logo
+ * - A logo is an `<img>` whose `alt` is the badge name, rendered only when its
+ *   URL is http(s) or root-relative (REB-1002); a badge without a usable logo
  *   shows its name as text.
+ * - `heading` (optional) wraps everything in a `<section>` labelled by it
+ *   (`headingId`), with the group headings one level below — so a SITE keeps
+ *   its `<section aria-labelledby>` landmark (REB-1002).
+ * - Consumer classNames follow the REB-997 slot rule: `headingClassName` and
+ *   `sectionHeadingClassName` REPLACE that heading's default typography.
  * - `url` links only when it is http(s), in a new window with
  *   `rel="noopener noreferrer"` and a visually hidden new-window hint.
  */
@@ -505,7 +512,18 @@ interface TrustBadgesProps {
     headings?: Partial<Record<TrustBadgeType, string | null>>;
     /** Which groups to render, in this order. Defaults to every type. */
     types?: readonly TrustBadgeType[];
-    /** Heading level of each group title. Defaults to `2`. */
+    /**
+     * Optional section title, e.g. «Nos avalan». When given, the root is a
+     * `<section aria-labelledby={headingId}>` and the group headings render one
+     * level below `headingLevel`.
+     */
+    heading?: ReactNode;
+    /** `id` of the section heading (the section's `aria-labelledby`). @default 'trust-badges-heading' */
+    headingId?: string;
+    /**
+     * Heading level of the section title when `heading` is given, otherwise of
+     * each group title. Defaults to `2`.
+     */
     headingLevel?: HeadingLevel;
     /** Visually hidden text appended to linked badges. */
     newWindowLabel?: string;
@@ -513,14 +531,22 @@ interface TrustBadgesProps {
     className?: string;
     /** Classes for each group. */
     groupClassName?: string;
-    /** Classes for each group heading. */
+    /**
+     * Classes for each group heading. When given, they REPLACE the default
+     * `text-sm font-semibold uppercase tracking-widest` (REB-997).
+     */
     headingClassName?: string;
+    /**
+     * Classes for the section heading (only with `heading`). When given, they
+     * REPLACE the default `text-xl font-semibold` (REB-997).
+     */
+    sectionHeadingClassName?: string;
     /** Classes for each group's `<ul>`. */
     listClassName?: string;
     /** Classes for each logo `<img>`. */
     logoClassName?: string;
 }
-declare function TrustBadges({ badges, headings, types, headingLevel, newWindowLabel, className, groupClassName, headingClassName, listClassName, logoClassName, }: TrustBadgesProps): react_jsx_runtime.JSX.Element | null;
+declare function TrustBadges({ badges, headings, types, heading, headingId, headingLevel, newWindowLabel, className, groupClassName, headingClassName, sectionHeadingClassName, listClassName, logoClassName, }: TrustBadgesProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
+export { DATA_REQUEST_TYPES } from '@reblu/site-contracts';
 import { FaqItem } from './seo.js';
 export { FaqPageJsonLd, MarkdownToPlainTextOptions, buildFaqPageJsonLd, collectFaqItems, markdownToPlainText } from './seo.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -489,8 +490,14 @@ declare function FaqAccordion({ items, heading, headingLevel, questionHeadingLev
  * - Badges are grouped by type (in {@link DEFAULT_TRUST_BADGE_TYPE_ORDER}, or
  *   the `types` prop), each group under an overridable heading, and ordered by
  *   `sortOrder` inside it.
- * - A logo is an `<img>` whose `alt` is the badge name; a badge without a logo
+ * - A logo is an `<img>` whose `alt` is the badge name, rendered only when its
+ *   URL is http(s) or root-relative (REB-1002); a badge without a usable logo
  *   shows its name as text.
+ * - `heading` (optional) wraps everything in a `<section>` labelled by it
+ *   (`headingId`), with the group headings one level below — so a SITE keeps
+ *   its `<section aria-labelledby>` landmark (REB-1002).
+ * - Consumer classNames follow the REB-997 slot rule: `headingClassName` and
+ *   `sectionHeadingClassName` REPLACE that heading's default typography.
  * - `url` links only when it is http(s), in a new window with
  *   `rel="noopener noreferrer"` and a visually hidden new-window hint.
  */
@@ -505,7 +512,18 @@ interface TrustBadgesProps {
     headings?: Partial<Record<TrustBadgeType, string | null>>;
     /** Which groups to render, in this order. Defaults to every type. */
     types?: readonly TrustBadgeType[];
-    /** Heading level of each group title. Defaults to `2`. */
+    /**
+     * Optional section title, e.g. «Nos avalan». When given, the root is a
+     * `<section aria-labelledby={headingId}>` and the group headings render one
+     * level below `headingLevel`.
+     */
+    heading?: ReactNode;
+    /** `id` of the section heading (the section's `aria-labelledby`). @default 'trust-badges-heading' */
+    headingId?: string;
+    /**
+     * Heading level of the section title when `heading` is given, otherwise of
+     * each group title. Defaults to `2`.
+     */
     headingLevel?: HeadingLevel;
     /** Visually hidden text appended to linked badges. */
     newWindowLabel?: string;
@@ -513,14 +531,22 @@ interface TrustBadgesProps {
     className?: string;
     /** Classes for each group. */
     groupClassName?: string;
-    /** Classes for each group heading. */
+    /**
+     * Classes for each group heading. When given, they REPLACE the default
+     * `text-sm font-semibold uppercase tracking-widest` (REB-997).
+     */
     headingClassName?: string;
+    /**
+     * Classes for the section heading (only with `heading`). When given, they
+     * REPLACE the default `text-xl font-semibold` (REB-997).
+     */
+    sectionHeadingClassName?: string;
     /** Classes for each group's `<ul>`. */
     listClassName?: string;
     /** Classes for each logo `<img>`. */
     logoClassName?: string;
 }
-declare function TrustBadges({ badges, headings, types, headingLevel, newWindowLabel, className, groupClassName, headingClassName, listClassName, logoClassName, }: TrustBadgesProps): react_jsx_runtime.JSX.Element | null;
+declare function TrustBadges({ badges, headings, types, heading, headingId, headingLevel, newWindowLabel, className, groupClassName, headingClassName, sectionHeadingClassName, listClassName, logoClassName, }: TrustBadgesProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks

package/dist/index.js

@@ -13925,14 +13925,20 @@ function safeHref(url) {
     return null;
   }
 }
+function safeLogoSrc(url) {
+  if (typeof url !== "string" || url === "") return null;
+  if (url.startsWith("/")) return url.startsWith("//") || url.startsWith("/\\") ? null : url;
+  return safeHref(url);
+}
 function BadgeContent({ badge, logoClassName }) {
-  if (badge.logoUrl) {
+  const src = safeLogoSrc(badge.logoUrl);
+  if (src) {
     return (
       // eslint-disable-next-line @next/next/no-img-element -- framework-agnostic SDK; the SITE owns image optimisation
       /* @__PURE__ */ jsx12(
         "img",
         {
-          src: badge.logoUrl,
+          src,
           alt: badge.name,
           loading: "lazy",
           className: cn9("h-12 w-auto object-contain", logoClassName)
@@ -13946,11 +13952,14 @@ function TrustBadges({
   badges,
   headings,
   types = DEFAULT_TRUST_BADGE_TYPE_ORDER,
+  heading,
+  headingId = "trust-badges-heading",
   headingLevel = 2,
   newWindowLabel = "(se abre en una ventana nueva)",
   className,
   groupClassName,
   headingClassName,
+  sectionHeadingClassName,
   listClassName,
   logoClassName
 }) {
@@ -13959,46 +13968,66 @@ function TrustBadges({
   const groups = types.flatMap((type) => {
     const items = usable.filter((b2) => b2.type === type).map((b2, index) => ({ b: b2, index })).sort((x2, y2) => (x2.b.sortOrder ?? 0) - (y2.b.sortOrder ?? 0) || x2.index - y2.index).map(({ b: b2 }) => b2);
     if (items.length === 0) return [];
-    const heading = headings && Object.prototype.hasOwnProperty.call(headings, type) ? headings[type] : DEFAULT_TRUST_BADGE_HEADINGS[type];
-    return [{ type, heading, items }];
+    const groupHeading = headings && Object.prototype.hasOwnProperty.call(headings, type) ? headings[type] : DEFAULT_TRUST_BADGE_HEADINGS[type];
+    return [{ type, groupHeading, items }];
   });
   if (groups.length === 0) return null;
-  return /* @__PURE__ */ jsx12("div", { "data-slot": "trust-badges", className: cn9("space-y-6", className), children: groups.map(({ type, heading, items }) => /* @__PURE__ */ jsxs10(
+  const hasHeading = heading !== void 0 && heading !== null && heading !== "";
+  const groupHeadingLevel = hasHeading ? nextHeadingLevel(headingLevel) : headingLevel;
+  const content = groups.map(({ type, groupHeading, items }) => /* @__PURE__ */ jsxs10(
     "div",
     {
       "data-slot": "trust-badge-group",
       "data-type": type,
       className: cn9("space-y-3", groupClassName),
       children: [
-        heading ? /* @__PURE__ */ jsx12(
+        groupHeading ? /* @__PURE__ */ jsx12(
           Heading,
           {
-            level: headingLevel,
-            className: cn9("text-sm font-semibold uppercase tracking-widest", headingClassName),
-            children: heading
+            level: groupHeadingLevel,
+            className: slotClassName(
+              "",
+              "text-sm font-semibold uppercase tracking-widest",
+              headingClassName
+            ),
+            children: groupHeading
           }
         ) : null,
         /* @__PURE__ */ jsx12("ul", { className: cn9("flex flex-wrap items-center gap-6", listClassName), children: items.map((badge) => {
           const href = safeHref(badge.url);
-          return /* @__PURE__ */ jsx12("li", { children: href ? /* @__PURE__ */ jsxs10(
-            "a",
-            {
-              href,
-              target: "_blank",
-              rel: "noopener noreferrer",
-              className: "inline-flex",
-              children: [
-                /* @__PURE__ */ jsx12(BadgeContent, { badge, logoClassName }),
-                " ",
-                /* @__PURE__ */ jsx12("span", { className: "sr-only", children: newWindowLabel })
-              ]
-            }
-          ) : /* @__PURE__ */ jsx12(BadgeContent, { badge, logoClassName }) }, badge.id);
+          return /* @__PURE__ */ jsx12("li", { children: href ? /* @__PURE__ */ jsxs10("a", { href, target: "_blank", rel: "noopener noreferrer", className: "inline-flex", children: [
+            /* @__PURE__ */ jsx12(BadgeContent, { badge, logoClassName }),
+            " ",
+            /* @__PURE__ */ jsx12("span", { className: "sr-only", children: newWindowLabel })
+          ] }) : /* @__PURE__ */ jsx12(BadgeContent, { badge, logoClassName }) }, badge.id);
         }) })
       ]
     },
     type
-  )) });
+  ));
+  if (!hasHeading) {
+    return /* @__PURE__ */ jsx12("div", { "data-slot": "trust-badges", className: cn9("space-y-6", className), children: content });
+  }
+  const Tag = `h${headingLevel}`;
+  return /* @__PURE__ */ jsxs10(
+    "section",
+    {
+      "data-slot": "trust-badges",
+      "aria-labelledby": headingId,
+      className: cn9("space-y-6", className),
+      children: [
+        /* @__PURE__ */ jsx12(
+          Tag,
+          {
+            id: headingId,
+            className: slotClassName("", "text-xl font-semibold", sectionHeadingClassName),
+            children: heading
+          }
+        ),
+        content
+      ]
+    }
+  );
 }
 
 // src/components/page-blocks.tsx
@@ -15427,6 +15456,9 @@ function FullInvoiceFields({
     ] })
   ] });
 }
+
+// src/index.ts
+import { DATA_REQUEST_TYPES } from "@reblu/site-contracts";
 export {
   ALLOWED_YOUTUBE_HOSTS,
   AddedToCartToast,
@@ -15436,6 +15468,7 @@ export {
   CheckoutForm,
   CheckoutLoginPrompt,
   CourseDescription,
+  DATA_REQUEST_TYPES,
   DEFAULT_INVOICE_COUNTRIES,
   DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE,
   DEFAULT_SHOP_ERROR_MESSAGES,