@reblu/site-blocks 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
 import { FaqItem } from './seo.cjs';
-export { FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems } from './seo.cjs';
+export { FaqPageJsonLd, MarkdownToPlainTextOptions, buildFaqPageJsonLd, collectFaqItems, markdownToPlainText } from './seo.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ComponentType, ReactNode, FormEvent } from 'react';
+import { ReactNode, ComponentType, FormEvent } from 'react';
 
 declare function readingTime(content: string | null | undefined): number | null;
 
@@ -240,6 +240,56 @@ interface SafeHtmlProps {
 }
 declare function SafeHtml({ html, className, headingOffset }: SafeHtmlProps): react_jsx_runtime.JSX.Element | null;
 
+/** A heading level a caller can configure — `h1`…`h6`. */
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+
+/**
+ * `CourseDescription` — the drop-in for `AcademyCourseDetail.description`
+ * (`client.academy.bySlug()`), REB-879. The description is rich-text Markdown
+ * written in nexus with the shared editor: headings, GFM tables, images.
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`.
+ *
+ * Semantics:
+ * - The Markdown goes through the same pipeline as {@link MarkdownRenderer}
+ *   (`marked` → hast-util-sanitize → token-driven component map). It is never
+ *   rendered as raw HTML: `<script>`, event handlers, `javascript:` links and
+ *   non-allowlisted iframes are dropped.
+ * - `null`, `undefined`, blank text, or content the sanitiser empties render
+ *   NOTHING — not even the heading. No default copy is ever invented.
+ * - `heading` is the SITE's own section title (its language, its words). When
+ *   given, the block is a `<section>` labelled by it, and the description's own
+ *   headings are demoted under it (`##` → one level below `headingLevel`).
+ */
+interface CourseDescriptionProps {
+    /** `AcademyCourseDetail.description` as served — may be `null` / `undefined`. */
+    description: string | null | undefined;
+    /** Optional section heading, e.g. «Sobre el curso». Omit to render the description alone. */
+    heading?: ReactNode;
+    /** Level of `heading`. Defaults to `2`. */
+    headingLevel?: HeadingLevel;
+    /** `id` of the heading element (the section's `aria-labelledby`). */
+    headingId?: string;
+    /**
+     * Levels added to the description's own headings. Defaults to `headingLevel - 1`
+     * with a `heading` (so its `##` sits one level below it) and `0` without one.
+     */
+    headingOffset?: number;
+    /** Classes for the outer element (added to its `space-y-3` layout). */
+    className?: string;
+    /**
+     * Classes for the heading. When given, they REPLACE the default
+     * `text-xl font-semibold` (REB-997) — pass the full typography you want.
+     */
+    headingClassName?: string;
+    /**
+     * Classes for the rendered Markdown body. When given, they REPLACE the
+     * default `text-muted-foreground` (REB-997).
+     */
+    contentClassName?: string;
+}
+declare function CourseDescription({ description, heading, headingLevel, headingId, headingOffset, className, headingClassName, contentClassName, }: CourseDescriptionProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * `Treatment` — full treatment page organism over a `PageDetail` (a SERVICE-type
  * page). Renders the hero band followed by the ordered content sections.
@@ -384,16 +434,17 @@ interface ProductTrustItemsProps {
     icons?: Partial<Record<ShopProductTrustIcon, TrustIconComponent>>;
     /** List element. Defaults to `ul`. */
     as?: 'ul' | 'ol';
-    /** Classes for the list element. */
+    /** Classes for the list element (added to its `space-y-2.5` layout). */
     className?: string;
-    /** Classes for each `<li>` row. */
+    /**
+     * Classes for each `<li>` row. When given, they REPLACE the default
+     * `text-sm text-muted-foreground` (REB-997); the row's `flex items-center
+     * gap-3` layout is kept.
+     */
     itemClassName?: string;
 }
 declare function ProductTrustItems({ items, icons, as: List, className, itemClassName, }: ProductTrustItemsProps): react_jsx_runtime.JSX.Element | null;
 
-/** A heading level a caller can configure — `h1`…`h6`. */
-type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
-
 /**
  * REB-850 — accessible FAQ list on native `<details>`/`<summary>`.
  *
@@ -422,6 +473,55 @@ interface FaqAccordionProps {
 }
 declare function FaqAccordion({ items, heading, headingLevel, questionHeadingLevel, defaultOpen, className, }: FaqAccordionProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * `TrustBadges` — the tenant's trust badges (partners, insurers, funding,
+ * certifications, awards) configured in nexus and served by
+ * `client.trustBadges.list()` (REB-996). Drop it in a footer or an "about"
+ * section; switching a badge off or letting its validity date pass in nexus
+ * removes it from the SITE on the next revalidation, with no deploy.
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`.
+ *
+ * Semantics — the API is the only source of claims:
+ * - `null`, `undefined`, a non-array or `[]` render NOTHING.
+ * - An entry with an unknown `type` or an empty name is skipped; if nothing
+ *   survives, nothing is rendered.
+ * - 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
+ *   shows its name as text.
+ * - `url` links only when it is http(s), in a new window with
+ *   `rel="noopener noreferrer"` and a visually hidden new-window hint.
+ */
+/** Default group heading per badge type. Override any of them with `headings`. */
+declare const DEFAULT_TRUST_BADGE_HEADINGS: Readonly<Record<TrustBadgeType, string>>;
+/** Default order of the groups. */
+declare const DEFAULT_TRUST_BADGE_TYPE_ORDER: readonly TrustBadgeType[];
+interface TrustBadgesProps {
+    /** `client.trustBadges.list()`'s `data` as served — may be `null` / `undefined`. */
+    badges: readonly TrustBadge[] | null | undefined;
+    /** Per-type heading overrides; `null` renders that group without a heading. */
+    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`. */
+    headingLevel?: HeadingLevel;
+    /** Visually hidden text appended to linked badges. */
+    newWindowLabel?: string;
+    /** Classes for the root element. */
+    className?: string;
+    /** Classes for each group. */
+    groupClassName?: string;
+    /** Classes for each group heading. */
+    headingClassName?: 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;
+
 /**
  * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks
  * (`PageDetail.blocks`, REB-75), so a SITE stops hand-writing its own.
@@ -642,12 +742,18 @@ interface CartLineListProps {
      * `ReactNode` for custom content, or omit/`false` to render nothing.
      */
     notice?: boolean | React.ReactNode;
+    /**
+     * REB-981 — a message rendered under a line (e.g. its cart-validation
+     * error from `useCartValidation().getLineError(...)?.message`). Return
+     * `null`/`undefined` for lines without one.
+     */
+    lineMessage?: (item: CartLineItemView) => React.ReactNode;
     labels?: Partial<CartLineListLabels>;
     currencyCode?: string;
     locale?: string;
     className?: string;
 }
-declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * `CartSummary` — presentational price breakdown (REB-829): subtotal,
@@ -699,6 +805,42 @@ interface CartSummaryProps {
 }
 declare function CartSummary({ subtotal, discount, discountCode, shipping, shippingEnabled, total, notice, labels, currencyCode, locale, className, }: CartSummaryProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `CartAdjustmentsNotice` (REB-981) — tells the visitor what cart validation
+ * changed: lines removed because they can no longer be bought, quantities
+ * clamped to the stock left, and prices that changed since the line was
+ * added. Presentational only: feed it `@reblu/site-next/cart`'s
+ * `useCartValidation()` result (`removed`, `quantityChanges`,
+ * `priceChanges`) — every item shape is a structural subset of those.
+ * Renders nothing when there is nothing to report.
+ */
+interface CartAdjustmentLine {
+    name: string;
+    variantName?: string;
+}
+interface CartAdjustmentsNoticeLabels {
+    /** `names` already include the variant, e.g. `Gel (200 ml)`. */
+    removed: (names: string[]) => string;
+    quantityChanged: (name: string, quantity: number) => string;
+    priceChanged: (name: string, from: string, to: string) => string;
+}
+interface CartAdjustmentsNoticeProps {
+    removed?: CartAdjustmentLine[];
+    quantityChanges?: Array<CartAdjustmentLine & {
+        to: number;
+    }>;
+    /** `from`/`to` in integer cents. */
+    priceChanges?: Array<CartAdjustmentLine & {
+        from: number;
+        to: number;
+    }>;
+    labels?: Partial<CartAdjustmentsNoticeLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartAdjustmentsNotice({ removed, quantityChanges, priceChanges, labels, currencyCode, locale, className, }: CartAdjustmentsNoticeProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * `AddedToCartToast` — add-to-cart feedback toast CONTENT (REB-837). Pure
  * presentational, no hooks.
@@ -1061,4 +1203,4 @@ interface OrderInvoiceLinkProps {
 }
 declare function OrderInvoiceLink({ invoice, labels, className }: OrderInvoiceLinkProps): react_jsx_runtime.JSX.Element | null;
 
-export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_INVOICE_COUNTRIES, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, OrderInvoiceLink, type OrderInvoiceLinkLabels, type OrderInvoiceLinkProps, PageBlocks, type PageBlocksComponents, type PageBlocksProps, PageCardGrid, type PageCardGridProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutInvoiceFields };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartAdjustmentLine, CartAdjustmentsNotice, type CartAdjustmentsNoticeLabels, type CartAdjustmentsNoticeProps, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, CourseDescription, type CourseDescriptionProps, DEFAULT_INVOICE_COUNTRIES, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_BADGE_HEADINGS, DEFAULT_TRUST_BADGE_TYPE_ORDER, DEFAULT_TRUST_ICONS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, OrderInvoiceLink, type OrderInvoiceLinkLabels, type OrderInvoiceLinkProps, PageBlocks, type PageBlocksComponents, type PageBlocksProps, PageCardGrid, type PageCardGridProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, TrustBadges, type TrustBadgesProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutInvoiceFields };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopOrderInvoice } from '@reblu/site-contracts';
 import { FaqItem } from './seo.js';
-export { FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems } from './seo.js';
+export { FaqPageJsonLd, MarkdownToPlainTextOptions, buildFaqPageJsonLd, collectFaqItems, markdownToPlainText } from './seo.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ComponentType, ReactNode, FormEvent } from 'react';
+import { ReactNode, ComponentType, FormEvent } from 'react';
 
 declare function readingTime(content: string | null | undefined): number | null;
 
@@ -240,6 +240,56 @@ interface SafeHtmlProps {
 }
 declare function SafeHtml({ html, className, headingOffset }: SafeHtmlProps): react_jsx_runtime.JSX.Element | null;
 
+/** A heading level a caller can configure — `h1`…`h6`. */
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+
+/**
+ * `CourseDescription` — the drop-in for `AcademyCourseDetail.description`
+ * (`client.academy.bySlug()`), REB-879. The description is rich-text Markdown
+ * written in nexus with the shared editor: headings, GFM tables, images.
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`.
+ *
+ * Semantics:
+ * - The Markdown goes through the same pipeline as {@link MarkdownRenderer}
+ *   (`marked` → hast-util-sanitize → token-driven component map). It is never
+ *   rendered as raw HTML: `<script>`, event handlers, `javascript:` links and
+ *   non-allowlisted iframes are dropped.
+ * - `null`, `undefined`, blank text, or content the sanitiser empties render
+ *   NOTHING — not even the heading. No default copy is ever invented.
+ * - `heading` is the SITE's own section title (its language, its words). When
+ *   given, the block is a `<section>` labelled by it, and the description's own
+ *   headings are demoted under it (`##` → one level below `headingLevel`).
+ */
+interface CourseDescriptionProps {
+    /** `AcademyCourseDetail.description` as served — may be `null` / `undefined`. */
+    description: string | null | undefined;
+    /** Optional section heading, e.g. «Sobre el curso». Omit to render the description alone. */
+    heading?: ReactNode;
+    /** Level of `heading`. Defaults to `2`. */
+    headingLevel?: HeadingLevel;
+    /** `id` of the heading element (the section's `aria-labelledby`). */
+    headingId?: string;
+    /**
+     * Levels added to the description's own headings. Defaults to `headingLevel - 1`
+     * with a `heading` (so its `##` sits one level below it) and `0` without one.
+     */
+    headingOffset?: number;
+    /** Classes for the outer element (added to its `space-y-3` layout). */
+    className?: string;
+    /**
+     * Classes for the heading. When given, they REPLACE the default
+     * `text-xl font-semibold` (REB-997) — pass the full typography you want.
+     */
+    headingClassName?: string;
+    /**
+     * Classes for the rendered Markdown body. When given, they REPLACE the
+     * default `text-muted-foreground` (REB-997).
+     */
+    contentClassName?: string;
+}
+declare function CourseDescription({ description, heading, headingLevel, headingId, headingOffset, className, headingClassName, contentClassName, }: CourseDescriptionProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * `Treatment` — full treatment page organism over a `PageDetail` (a SERVICE-type
  * page). Renders the hero band followed by the ordered content sections.
@@ -384,16 +434,17 @@ interface ProductTrustItemsProps {
     icons?: Partial<Record<ShopProductTrustIcon, TrustIconComponent>>;
     /** List element. Defaults to `ul`. */
     as?: 'ul' | 'ol';
-    /** Classes for the list element. */
+    /** Classes for the list element (added to its `space-y-2.5` layout). */
     className?: string;
-    /** Classes for each `<li>` row. */
+    /**
+     * Classes for each `<li>` row. When given, they REPLACE the default
+     * `text-sm text-muted-foreground` (REB-997); the row's `flex items-center
+     * gap-3` layout is kept.
+     */
     itemClassName?: string;
 }
 declare function ProductTrustItems({ items, icons, as: List, className, itemClassName, }: ProductTrustItemsProps): react_jsx_runtime.JSX.Element | null;
 
-/** A heading level a caller can configure — `h1`…`h6`. */
-type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
-
 /**
  * REB-850 — accessible FAQ list on native `<details>`/`<summary>`.
  *
@@ -422,6 +473,55 @@ interface FaqAccordionProps {
 }
 declare function FaqAccordion({ items, heading, headingLevel, questionHeadingLevel, defaultOpen, className, }: FaqAccordionProps): react_jsx_runtime.JSX.Element | null;
 
+/**
+ * `TrustBadges` — the tenant's trust badges (partners, insurers, funding,
+ * certifications, awards) configured in nexus and served by
+ * `client.trustBadges.list()` (REB-996). Drop it in a footer or an "about"
+ * section; switching a badge off or letting its validity date pass in nexus
+ * removes it from the SITE on the next revalidation, with no deploy.
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`.
+ *
+ * Semantics — the API is the only source of claims:
+ * - `null`, `undefined`, a non-array or `[]` render NOTHING.
+ * - An entry with an unknown `type` or an empty name is skipped; if nothing
+ *   survives, nothing is rendered.
+ * - 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
+ *   shows its name as text.
+ * - `url` links only when it is http(s), in a new window with
+ *   `rel="noopener noreferrer"` and a visually hidden new-window hint.
+ */
+/** Default group heading per badge type. Override any of them with `headings`. */
+declare const DEFAULT_TRUST_BADGE_HEADINGS: Readonly<Record<TrustBadgeType, string>>;
+/** Default order of the groups. */
+declare const DEFAULT_TRUST_BADGE_TYPE_ORDER: readonly TrustBadgeType[];
+interface TrustBadgesProps {
+    /** `client.trustBadges.list()`'s `data` as served — may be `null` / `undefined`. */
+    badges: readonly TrustBadge[] | null | undefined;
+    /** Per-type heading overrides; `null` renders that group without a heading. */
+    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`. */
+    headingLevel?: HeadingLevel;
+    /** Visually hidden text appended to linked badges. */
+    newWindowLabel?: string;
+    /** Classes for the root element. */
+    className?: string;
+    /** Classes for each group. */
+    groupClassName?: string;
+    /** Classes for each group heading. */
+    headingClassName?: 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;
+
 /**
  * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks
  * (`PageDetail.blocks`, REB-75), so a SITE stops hand-writing its own.
@@ -642,12 +742,18 @@ interface CartLineListProps {
      * `ReactNode` for custom content, or omit/`false` to render nothing.
      */
     notice?: boolean | React.ReactNode;
+    /**
+     * REB-981 — a message rendered under a line (e.g. its cart-validation
+     * error from `useCartValidation().getLineError(...)?.message`). Return
+     * `null`/`undefined` for lines without one.
+     */
+    lineMessage?: (item: CartLineItemView) => React.ReactNode;
     labels?: Partial<CartLineListLabels>;
     currencyCode?: string;
     locale?: string;
     className?: string;
 }
-declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * `CartSummary` — presentational price breakdown (REB-829): subtotal,
@@ -699,6 +805,42 @@ interface CartSummaryProps {
 }
 declare function CartSummary({ subtotal, discount, discountCode, shipping, shippingEnabled, total, notice, labels, currencyCode, locale, className, }: CartSummaryProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `CartAdjustmentsNotice` (REB-981) — tells the visitor what cart validation
+ * changed: lines removed because they can no longer be bought, quantities
+ * clamped to the stock left, and prices that changed since the line was
+ * added. Presentational only: feed it `@reblu/site-next/cart`'s
+ * `useCartValidation()` result (`removed`, `quantityChanges`,
+ * `priceChanges`) — every item shape is a structural subset of those.
+ * Renders nothing when there is nothing to report.
+ */
+interface CartAdjustmentLine {
+    name: string;
+    variantName?: string;
+}
+interface CartAdjustmentsNoticeLabels {
+    /** `names` already include the variant, e.g. `Gel (200 ml)`. */
+    removed: (names: string[]) => string;
+    quantityChanged: (name: string, quantity: number) => string;
+    priceChanged: (name: string, from: string, to: string) => string;
+}
+interface CartAdjustmentsNoticeProps {
+    removed?: CartAdjustmentLine[];
+    quantityChanges?: Array<CartAdjustmentLine & {
+        to: number;
+    }>;
+    /** `from`/`to` in integer cents. */
+    priceChanges?: Array<CartAdjustmentLine & {
+        from: number;
+        to: number;
+    }>;
+    labels?: Partial<CartAdjustmentsNoticeLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartAdjustmentsNotice({ removed, quantityChanges, priceChanges, labels, currencyCode, locale, className, }: CartAdjustmentsNoticeProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * `AddedToCartToast` — add-to-cart feedback toast CONTENT (REB-837). Pure
  * presentational, no hooks.
@@ -1061,4 +1203,4 @@ interface OrderInvoiceLinkProps {
 }
 declare function OrderInvoiceLink({ invoice, labels, className }: OrderInvoiceLinkProps): react_jsx_runtime.JSX.Element | null;
 
-export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_INVOICE_COUNTRIES, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, OrderInvoiceLink, type OrderInvoiceLinkLabels, type OrderInvoiceLinkProps, PageBlocks, type PageBlocksComponents, type PageBlocksProps, PageCardGrid, type PageCardGridProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutInvoiceFields };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartAdjustmentLine, CartAdjustmentsNotice, type CartAdjustmentsNoticeLabels, type CartAdjustmentsNoticeProps, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, CourseDescription, type CourseDescriptionProps, DEFAULT_INVOICE_COUNTRIES, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_BADGE_HEADINGS, DEFAULT_TRUST_BADGE_TYPE_ORDER, DEFAULT_TRUST_ICONS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, OrderInvoiceLink, type OrderInvoiceLinkLabels, type OrderInvoiceLinkProps, PageBlocks, type PageBlocksComponents, type PageBlocksProps, PageCardGrid, type PageCardGridProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, TrustBadges, type TrustBadgesProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutInvoiceFields };