@reblu/site-blocks 0.28.0 → 0.30.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ShopErrorCode, AcademyCourseDetail, AcademyLessonPreview, PageDetail, PageListItem, ProfessionalField, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, AcademyInstructorPublic, AcademyCategoryPublic, AcademyCatalogFiltersPublic, ShopStaffAutoDiscount, ShopOrder, ShopBillingInput, ShopCheckoutInput, Config, ShopOrderInvoice } from '@reblu/site-contracts';
+import { ShopErrorCode, AcademyCourseDetail, AcademyLessonPreview, PageDetail, PageListItem, ProfessionalField, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, AcademyInstructorPublic, AcademyCategoryPublic, AcademyCatalogFiltersPublic, ShopBundleComponent, ShopStaffAutoDiscount, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopCheckoutDeliveryConfig, ShopCheckoutCopy, ShopFulfillmentInput, ShopQuote, Config, 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';
@@ -1069,7 +1069,34 @@ interface CartLineListLabels {
     unitPriceSuffix: string;
     /** REB-837 — default copy for `notice={true}`. */
     cancelledNotice: string;
+    /** REB-1208 — the summary of the per-line `lineIncludes` disclosure. */
+    includesSummary: string;
 }
+/** REB-1208 — one row of a line's «Qué incluye» detail. */
+interface CartLineIncludesEntry {
+    label: React.ReactNode;
+    value: React.ReactNode;
+}
+interface CartLineIncludesProps {
+    entries: CartLineIncludesEntry[];
+    /** An optional full-width note under the entries (e.g. a condition of use). */
+    note?: React.ReactNode;
+    className?: string;
+}
+/**
+ * `CartLineIncludes` — drop-in body for `CartLineList`'s `lineIncludes`
+ * (REB-1208): a term/description list of what a line includes, built by the
+ * SITE from the product's own data (its custom-field values, or
+ * `bundleComponentsToIncludes(product.bundleComponents)`). Renders nothing
+ * when there are no entries and no note.
+ */
+declare function CartLineIncludes({ entries, note, className }: CartLineIncludesProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * REB-1208 — maps `ShopProductDetail.bundleComponents` (already on the
+ * contract) to `CartLineIncludes` entries: each component's name and its
+ * quantity, in the `x{quantity}` form `OrderConfirmation` uses.
+ */
+declare function bundleComponentsToIncludes(components: readonly ShopBundleComponent[]): CartLineIncludesEntry[];
 interface CartLineListProps {
     items: CartLineItemView[];
     onQuantityChange?: (productId: string, variantId: string | null | undefined, quantity: number) => void;
@@ -1093,12 +1120,19 @@ interface CartLineListProps {
      * `null`/`undefined` for lines without one.
      */
     lineMessage?: (item: CartLineItemView) => React.ReactNode;
+    /**
+     * REB-1208 — what a line includes, shown under it in a collapsed
+     * «Qué incluye» disclosure (`labels.includesSummary`). Return the content
+     * (usually `<CartLineIncludes entries={…} />`), or `null`/`undefined` for
+     * lines with nothing to show. Omit the prop to render no disclosure.
+     */
+    lineIncludes?: (item: CartLineItemView) => React.ReactNode;
     labels?: Partial<CartLineListLabels>;
     currencyCode?: string;
     locale?: string;
     className?: string;
 }
-declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, lineIncludes, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * `CartSummary` — presentational price breakdown (REB-829): subtotal,
@@ -1547,6 +1581,198 @@ interface FullInvoiceFieldsProps {
 }
 declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
 
+/** The shipping address fields the buyer types (country defaults server-side). */
+interface CheckoutAddressValue {
+    firstName: string;
+    lastName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    region: string;
+}
+type CheckoutAddressErrors = Partial<Record<keyof CheckoutAddressValue, string>>;
+declare const EMPTY_CHECKOUT_ADDRESS: CheckoutAddressValue;
+/** SDK texts of {@link CheckoutDeliveryChoice}; the option names come from the tenant. */
+interface CheckoutDeliveryChoiceLabels {
+    legend: string;
+    free: string;
+    pickupPointsLegend: string;
+    addressLegend: string;
+    firstName: string;
+    lastName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    region: string;
+}
+declare const DEFAULT_CHECKOUT_DELIVERY_CHOICE_LABELS: CheckoutDeliveryChoiceLabels;
+interface CheckoutDeliveryChoiceProps {
+    /** `ShopConfig.delivery`. */
+    delivery: ShopCheckoutDeliveryConfig;
+    /** `ShopConfig.checkout` — the tenant's option names. */
+    copy: Pick<ShopCheckoutCopy, 'shippingOptionLabel' | 'pickupOptionLabel'>;
+    /** The current choice; start from {@link defaultCheckoutFulfillment}. */
+    value: ShopFulfillmentInput | null;
+    onChange: (value: ShopFulfillmentInput) => void;
+    address: CheckoutAddressValue;
+    onAddressChange: (value: CheckoutAddressValue) => void;
+    addressErrors?: CheckoutAddressErrors;
+    /** A delivery error from checkout or the quote (e.g. `PICKUP_LOCATION_INVALID`). */
+    error?: string | null;
+    /** The last quote: its home delivery cost wins over the flat cost (free over the threshold). */
+    quote?: Pick<ShopQuote, 'fulfillment' | 'shipping'> | null;
+    /** `false` for a cart with nothing to ship (see {@link quoteRequiresDelivery}): renders nothing. */
+    requiresDelivery?: boolean;
+    labels?: Partial<CheckoutDeliveryChoiceLabels>;
+    currencyCode?: string;
+    locale?: string;
+    /** Prefix of the element ids and radio names (one choice per page). @default 'checkout-delivery' */
+    id?: string;
+    className?: string;
+}
+/**
+ * `CheckoutDeliveryChoice` (REB-1197) — how the order reaches the buyer,
+ * chosen before paying: home delivery (with the shipping address, stored on
+ * the order) or free pickup at one of the tenant's pickup points. Only the
+ * methods the tenant offers (`ShopConfig.delivery.methods`) are shown, with
+ * the tenant's names; home delivery shows its cost and the estimated delivery
+ * term; each pickup point its address, opening hours and ready-in text, all
+ * edited in nexus. Fully controlled, no hooks (RSC-safe root entry); send {@link toCheckoutFulfillmentFields}
+ * with the quote and the checkout body. Place it inside the checkout `<form>`
+ * (the address fields are `required`).
+ */
+declare function CheckoutDeliveryChoice({ delivery, copy, value, onChange, address, onAddressChange, addressErrors, error, quote, requiresDelivery, labels, currencyCode, locale, id: uid, className, }: CheckoutDeliveryChoiceProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * The starting choice: home delivery when offered, else pickup (with the
+ * point preselected when there is only one). `null` when the tenant offers
+ * neither, or against an API that predates the delivery config.
+ */
+declare function defaultCheckoutFulfillment(delivery: ShopCheckoutDeliveryConfig | null | undefined): ShopFulfillmentInput | null;
+/** Whether the cart has something to deliver; `true` until a quote says otherwise. */
+declare function quoteRequiresDelivery(quote: Pick<ShopQuote, 'lines'> | null | undefined): boolean;
+/**
+ * The quote and checkout body fields for the delivery choice. Home delivery
+ * carries the address (blank optional fields left out); pickup the point. With
+ * no choice (a cart with nothing to ship) it still sends home delivery: the
+ * server records no delivery for such a cart, and the request stays on the
+ * current contract (REB-1227).
+ *
+ * Pass `requiresDelivery` (`quoteRequiresDelivery(quote)`): when the cart
+ * ships nothing the choice block is hidden and the address stays blank, so no
+ * address and no pickup point are sent — a blank address is refused by the
+ * server (400 INVALID_INPUT) and pickup of nothing is refused too.
+ */
+declare function toCheckoutFulfillmentFields(value: ShopFulfillmentInput | null, address: CheckoutAddressValue, requiresDelivery?: boolean): Pick<ShopCheckoutInput, 'fulfillment' | 'shippingAddress'>;
+
+/** SDK texts of {@link CheckoutQuoteSummary}; the tenant's own ones come in the quote. */
+interface CheckoutQuoteSummaryLabels {
+    subtotal: string;
+    /** The discount row: its tenant label when automatic, else the code. */
+    discount: (codeOrLabel: string, isAutomatic: boolean) => string;
+    free: string;
+    /** Fallback delivery row name when the quote carries no label. */
+    delivery: string;
+    remainingForFree: (formattedAmount: string) => string;
+    /** A tax row when prices include it («De los cuales IGIC 7 %»). */
+    taxIncluded: (taxLabel: string) => string;
+    total: string;
+    /** Under the total when prices include tax. */
+    taxesIncludedNote: string;
+    quantityTimesUnit: (quantity: number, formattedUnitPrice: string) => string;
+}
+declare const DEFAULT_CHECKOUT_QUOTE_SUMMARY_LABELS: CheckoutQuoteSummaryLabels;
+interface CheckoutQuoteSummaryProps {
+    /** `useShopQuote().quote` / `client.shop.quote()` — the total Stripe charges. */
+    quote: ShopQuote;
+    heading?: ReactNode;
+    headingLevel?: HeadingLevel;
+    labels?: Partial<CheckoutQuoteSummaryLabels>;
+    /** @default 'EUR' */
+    currencyCode?: string;
+    /** @default 'es-ES' */
+    locale?: string;
+    className?: string;
+}
+/**
+ * `CheckoutQuoteSummary` (REB-1197) — the pre-payment summary of the
+ * single-step checkout, rendered from `ShopQuote`: every line with its kind,
+ * quantity and unit price; subtotal; discount; the delivery row (home
+ * delivery cost or «Gratis», or the pickup point); the tax rows the tenant
+ * shows; the total; the estimated delivery term. The amount is exactly what
+ * Stripe charges (the API prices quote and checkout with one function).
+ * Announces why a typed code was not applied (`role=status`) and why the
+ * order cannot be paid (`role=alert`, e.g. over the max weight).
+ *
+ * Presentational and RSC-safe. Tenant texts (delivery labels, tax labels,
+ * line kinds, the estimate) come from the API; `labels` replaces the rest.
+ */
+declare function CheckoutQuoteSummary({ quote, heading, headingLevel, labels, currencyCode, locale, className, }: CheckoutQuoteSummaryProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CheckoutTermsAcceptance` (REB-1198) — the mandatory, unticked box «He leído
+ * y acepto las {terms} de {tenant}» of the single-step checkout. Every text is
+ * the tenant's (`ShopConfig.checkout`, edited in nexus › Configuración ›
+ * Legal): `{terms}` becomes the link to the full document (text
+ * `termsLinkText`, target `termsLinkUrl` or the SITE's own `termsHref`, a new
+ * tab when `isTermsLinkNewTab`), `{tenant}` the site name. A label without
+ * `{terms}` gets the link appended.
+ *
+ * Renders nothing while the tenant has published no terms
+ * (`termsVersion: null`): there is nothing to accept and checkout does not
+ * ask. Send {@link toCheckoutTermsFields} with the checkout body; the server
+ * refuses without it (`TERMS_NOT_ACCEPTED`) or with an old version
+ * (`TERMS_VERSION_CHANGED`: reload the config and ask again).
+ */
+type CheckoutTermsCopy = Pick<ShopCheckoutCopy, 'tenantName' | 'termsCheckboxLabel' | 'termsLinkText' | 'termsLinkUrl' | 'isTermsLinkNewTab' | 'termsVersion'>;
+interface CheckoutTermsAcceptanceProps {
+    copy: CheckoutTermsCopy;
+    /** The SITE's route to its terms page, used when the tenant set no `termsLinkUrl`. */
+    termsHref: string;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    /** E.g. «Debes aceptar las condiciones para continuar.» (the SITE's or the API's text). */
+    error?: string | null;
+    /** Appended inside the link when it opens a new tab (screen readers). @default '(se abre en una pestaña nueva)' */
+    newTabHint?: string;
+    /** The checkbox id (one box per page). @default 'checkout-terms' */
+    id?: string;
+    className?: string;
+}
+declare function CheckoutTermsAcceptance({ copy, termsHref, checked, onCheckedChange, error, newTabHint, id, className, }: CheckoutTermsAcceptanceProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * The checkout body fields for the terms box: `acceptsTerms` and the version
+ * shown (`termsVersionId`), or nothing when the tenant published no terms.
+ */
+declare function toCheckoutTermsFields(copy: Pick<ShopCheckoutCopy, 'termsVersion'> | null | undefined, accepted: boolean): Pick<ShopCheckoutInput, 'acceptsTerms' | 'termsVersionId'>;
+
+/**
+ * `CheckoutPayAction` (REB-1198) — the last control of the single-step
+ * checkout: the submit button (`ShopCheckoutCopy.continueToPaymentLabel`,
+ * «Continuar al pago») and, right under it and readable (lawyer, 3-Nov: no
+ * tiny text), the notice with the amount (`ShopQuote.payNotice`, «En el
+ * siguiente paso pagarás {total} en la pasarela segura de Stripe…», already
+ * filled). The button is described by the notice, so a screen reader hears
+ * both. Place it inside the checkout `<form>`.
+ */
+interface CheckoutPayActionProps {
+    /** The tenant's button text: `ShopCheckoutCopy.continueToPaymentLabel`. */
+    label: string;
+    /** The tenant's small print: `ShopQuote.payNotice`. Omit while there is no quote. */
+    notice?: string | null;
+    submitting?: boolean;
+    /** Shown on the button while `submitting`. @default 'Procesando…' */
+    submittingLabel?: string;
+    disabled?: boolean;
+    /** Prefix of the element ids (one action per page). @default 'checkout-pay' */
+    id?: string;
+    className?: string;
+    /** Classes for the button; REPLACE the default look. */
+    buttonClassName?: string;
+    /** Classes for the notice; REPLACE the default `text-sm text-muted-foreground`. */
+    noticeClassName?: string;
+}
+declare function CheckoutPayAction({ label, notice, submitting, submittingLabel, disabled, id, className, buttonClassName, noticeClassName, }: CheckoutPayActionProps): react_jsx_runtime.JSX.Element;
+
 /**
  * `ContactInterestField` — the contact form's tenant-configurable interest
  * question, drop-in (REB-759). Fully controlled (`value`/`onChange`), no hooks,
@@ -1596,4 +1822,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, ArbitrationBadge, type ArbitrationBadgeProps, 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, type ContactInterest, ContactInterestField, type ContactInterestFieldProps, CourseCatalogFilters, type CourseCatalogFiltersActive, type CourseCatalogFiltersHrefs, type CourseCatalogFiltersLabels, type CourseCatalogFiltersProps, type CourseCatalogPriceBand, CourseDescription, type CourseDescriptionProps, CoursePurchaseTerms, type CoursePurchaseTermsLabels, type CoursePurchaseTermsProps, DEFAULT_COURSE_CATALOG_FILTERS_LABELS, DEFAULT_COURSE_PRICE_BANDS, DEFAULT_COURSE_PURCHASE_TERMS_LABELS, DEFAULT_INVOICE_COUNTRIES, DEFAULT_LESSON_PREVIEW_LABELS, 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, HeadingLevel, LegalDocument, type LegalDocumentProps, LessonPreview, type LessonPreviewLabels, type LessonPreviewProps, type MarkdownImageOptions, 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, ProfessionalFields, type ProfessionalFieldsProps, 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 };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, ArbitrationBadge, type ArbitrationBadgeProps, type BlockRendererProps, type CanonicalBlockType, type CartAdjustmentLine, CartAdjustmentsNotice, type CartAdjustmentsNoticeLabels, type CartAdjustmentsNoticeProps, CartLineIncludes, type CartLineIncludesEntry, type CartLineIncludesProps, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAddressErrors, type CheckoutAddressValue, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutDeliveryChoice, type CheckoutDeliveryChoiceLabels, type CheckoutDeliveryChoiceProps, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, CheckoutPayAction, type CheckoutPayActionProps, CheckoutQuoteSummary, type CheckoutQuoteSummaryLabels, type CheckoutQuoteSummaryProps, CheckoutTermsAcceptance, type CheckoutTermsAcceptanceProps, type CheckoutTermsCopy, type ContactInterest, ContactInterestField, type ContactInterestFieldProps, CourseCatalogFilters, type CourseCatalogFiltersActive, type CourseCatalogFiltersHrefs, type CourseCatalogFiltersLabels, type CourseCatalogFiltersProps, type CourseCatalogPriceBand, CourseDescription, type CourseDescriptionProps, CoursePurchaseTerms, type CoursePurchaseTermsLabels, type CoursePurchaseTermsProps, DEFAULT_CHECKOUT_DELIVERY_CHOICE_LABELS, DEFAULT_CHECKOUT_QUOTE_SUMMARY_LABELS, DEFAULT_COURSE_CATALOG_FILTERS_LABELS, DEFAULT_COURSE_PRICE_BANDS, DEFAULT_COURSE_PURCHASE_TERMS_LABELS, DEFAULT_INVOICE_COUNTRIES, DEFAULT_LESSON_PREVIEW_LABELS, 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_CHECKOUT_ADDRESS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, HeadingLevel, LegalDocument, type LegalDocumentProps, LessonPreview, type LessonPreviewLabels, type LessonPreviewProps, type MarkdownImageOptions, 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, ProfessionalFields, type ProfessionalFieldsProps, 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, bundleComponentsToIncludes, defaultCheckoutFulfillment, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, quoteRequiresDelivery, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutFulfillmentFields, toCheckoutInvoiceFields, toCheckoutTermsFields };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ShopErrorCode, AcademyCourseDetail, AcademyLessonPreview, PageDetail, PageListItem, ProfessionalField, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, AcademyInstructorPublic, AcademyCategoryPublic, AcademyCatalogFiltersPublic, ShopStaffAutoDiscount, ShopOrder, ShopBillingInput, ShopCheckoutInput, Config, ShopOrderInvoice } from '@reblu/site-contracts';
+import { ShopErrorCode, AcademyCourseDetail, AcademyLessonPreview, PageDetail, PageListItem, ProfessionalField, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, TrustBadgeType, TrustBadge, BlockType, PageBlock, ResolvedEmbed, ShopFacets, AcademyInstructorPublic, AcademyCategoryPublic, AcademyCatalogFiltersPublic, ShopBundleComponent, ShopStaffAutoDiscount, ShopOrder, ShopBillingInput, ShopCheckoutInput, ShopCheckoutDeliveryConfig, ShopCheckoutCopy, ShopFulfillmentInput, ShopQuote, Config, 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';
@@ -1069,7 +1069,34 @@ interface CartLineListLabels {
     unitPriceSuffix: string;
     /** REB-837 — default copy for `notice={true}`. */
     cancelledNotice: string;
+    /** REB-1208 — the summary of the per-line `lineIncludes` disclosure. */
+    includesSummary: string;
 }
+/** REB-1208 — one row of a line's «Qué incluye» detail. */
+interface CartLineIncludesEntry {
+    label: React.ReactNode;
+    value: React.ReactNode;
+}
+interface CartLineIncludesProps {
+    entries: CartLineIncludesEntry[];
+    /** An optional full-width note under the entries (e.g. a condition of use). */
+    note?: React.ReactNode;
+    className?: string;
+}
+/**
+ * `CartLineIncludes` — drop-in body for `CartLineList`'s `lineIncludes`
+ * (REB-1208): a term/description list of what a line includes, built by the
+ * SITE from the product's own data (its custom-field values, or
+ * `bundleComponentsToIncludes(product.bundleComponents)`). Renders nothing
+ * when there are no entries and no note.
+ */
+declare function CartLineIncludes({ entries, note, className }: CartLineIncludesProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * REB-1208 — maps `ShopProductDetail.bundleComponents` (already on the
+ * contract) to `CartLineIncludes` entries: each component's name and its
+ * quantity, in the `x{quantity}` form `OrderConfirmation` uses.
+ */
+declare function bundleComponentsToIncludes(components: readonly ShopBundleComponent[]): CartLineIncludesEntry[];
 interface CartLineListProps {
     items: CartLineItemView[];
     onQuantityChange?: (productId: string, variantId: string | null | undefined, quantity: number) => void;
@@ -1093,12 +1120,19 @@ interface CartLineListProps {
      * `null`/`undefined` for lines without one.
      */
     lineMessage?: (item: CartLineItemView) => React.ReactNode;
+    /**
+     * REB-1208 — what a line includes, shown under it in a collapsed
+     * «Qué incluye» disclosure (`labels.includesSummary`). Return the content
+     * (usually `<CartLineIncludes entries={…} />`), or `null`/`undefined` for
+     * lines with nothing to show. Omit the prop to render no disclosure.
+     */
+    lineIncludes?: (item: CartLineItemView) => React.ReactNode;
     labels?: Partial<CartLineListLabels>;
     currencyCode?: string;
     locale?: string;
     className?: string;
 }
-declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, notice, lineMessage, lineIncludes, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * `CartSummary` — presentational price breakdown (REB-829): subtotal,
@@ -1547,6 +1581,198 @@ interface FullInvoiceFieldsProps {
 }
 declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
 
+/** The shipping address fields the buyer types (country defaults server-side). */
+interface CheckoutAddressValue {
+    firstName: string;
+    lastName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    region: string;
+}
+type CheckoutAddressErrors = Partial<Record<keyof CheckoutAddressValue, string>>;
+declare const EMPTY_CHECKOUT_ADDRESS: CheckoutAddressValue;
+/** SDK texts of {@link CheckoutDeliveryChoice}; the option names come from the tenant. */
+interface CheckoutDeliveryChoiceLabels {
+    legend: string;
+    free: string;
+    pickupPointsLegend: string;
+    addressLegend: string;
+    firstName: string;
+    lastName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    region: string;
+}
+declare const DEFAULT_CHECKOUT_DELIVERY_CHOICE_LABELS: CheckoutDeliveryChoiceLabels;
+interface CheckoutDeliveryChoiceProps {
+    /** `ShopConfig.delivery`. */
+    delivery: ShopCheckoutDeliveryConfig;
+    /** `ShopConfig.checkout` — the tenant's option names. */
+    copy: Pick<ShopCheckoutCopy, 'shippingOptionLabel' | 'pickupOptionLabel'>;
+    /** The current choice; start from {@link defaultCheckoutFulfillment}. */
+    value: ShopFulfillmentInput | null;
+    onChange: (value: ShopFulfillmentInput) => void;
+    address: CheckoutAddressValue;
+    onAddressChange: (value: CheckoutAddressValue) => void;
+    addressErrors?: CheckoutAddressErrors;
+    /** A delivery error from checkout or the quote (e.g. `PICKUP_LOCATION_INVALID`). */
+    error?: string | null;
+    /** The last quote: its home delivery cost wins over the flat cost (free over the threshold). */
+    quote?: Pick<ShopQuote, 'fulfillment' | 'shipping'> | null;
+    /** `false` for a cart with nothing to ship (see {@link quoteRequiresDelivery}): renders nothing. */
+    requiresDelivery?: boolean;
+    labels?: Partial<CheckoutDeliveryChoiceLabels>;
+    currencyCode?: string;
+    locale?: string;
+    /** Prefix of the element ids and radio names (one choice per page). @default 'checkout-delivery' */
+    id?: string;
+    className?: string;
+}
+/**
+ * `CheckoutDeliveryChoice` (REB-1197) — how the order reaches the buyer,
+ * chosen before paying: home delivery (with the shipping address, stored on
+ * the order) or free pickup at one of the tenant's pickup points. Only the
+ * methods the tenant offers (`ShopConfig.delivery.methods`) are shown, with
+ * the tenant's names; home delivery shows its cost and the estimated delivery
+ * term; each pickup point its address, opening hours and ready-in text, all
+ * edited in nexus. Fully controlled, no hooks (RSC-safe root entry); send {@link toCheckoutFulfillmentFields}
+ * with the quote and the checkout body. Place it inside the checkout `<form>`
+ * (the address fields are `required`).
+ */
+declare function CheckoutDeliveryChoice({ delivery, copy, value, onChange, address, onAddressChange, addressErrors, error, quote, requiresDelivery, labels, currencyCode, locale, id: uid, className, }: CheckoutDeliveryChoiceProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * The starting choice: home delivery when offered, else pickup (with the
+ * point preselected when there is only one). `null` when the tenant offers
+ * neither, or against an API that predates the delivery config.
+ */
+declare function defaultCheckoutFulfillment(delivery: ShopCheckoutDeliveryConfig | null | undefined): ShopFulfillmentInput | null;
+/** Whether the cart has something to deliver; `true` until a quote says otherwise. */
+declare function quoteRequiresDelivery(quote: Pick<ShopQuote, 'lines'> | null | undefined): boolean;
+/**
+ * The quote and checkout body fields for the delivery choice. Home delivery
+ * carries the address (blank optional fields left out); pickup the point. With
+ * no choice (a cart with nothing to ship) it still sends home delivery: the
+ * server records no delivery for such a cart, and the request stays on the
+ * current contract (REB-1227).
+ *
+ * Pass `requiresDelivery` (`quoteRequiresDelivery(quote)`): when the cart
+ * ships nothing the choice block is hidden and the address stays blank, so no
+ * address and no pickup point are sent — a blank address is refused by the
+ * server (400 INVALID_INPUT) and pickup of nothing is refused too.
+ */
+declare function toCheckoutFulfillmentFields(value: ShopFulfillmentInput | null, address: CheckoutAddressValue, requiresDelivery?: boolean): Pick<ShopCheckoutInput, 'fulfillment' | 'shippingAddress'>;
+
+/** SDK texts of {@link CheckoutQuoteSummary}; the tenant's own ones come in the quote. */
+interface CheckoutQuoteSummaryLabels {
+    subtotal: string;
+    /** The discount row: its tenant label when automatic, else the code. */
+    discount: (codeOrLabel: string, isAutomatic: boolean) => string;
+    free: string;
+    /** Fallback delivery row name when the quote carries no label. */
+    delivery: string;
+    remainingForFree: (formattedAmount: string) => string;
+    /** A tax row when prices include it («De los cuales IGIC 7 %»). */
+    taxIncluded: (taxLabel: string) => string;
+    total: string;
+    /** Under the total when prices include tax. */
+    taxesIncludedNote: string;
+    quantityTimesUnit: (quantity: number, formattedUnitPrice: string) => string;
+}
+declare const DEFAULT_CHECKOUT_QUOTE_SUMMARY_LABELS: CheckoutQuoteSummaryLabels;
+interface CheckoutQuoteSummaryProps {
+    /** `useShopQuote().quote` / `client.shop.quote()` — the total Stripe charges. */
+    quote: ShopQuote;
+    heading?: ReactNode;
+    headingLevel?: HeadingLevel;
+    labels?: Partial<CheckoutQuoteSummaryLabels>;
+    /** @default 'EUR' */
+    currencyCode?: string;
+    /** @default 'es-ES' */
+    locale?: string;
+    className?: string;
+}
+/**
+ * `CheckoutQuoteSummary` (REB-1197) — the pre-payment summary of the
+ * single-step checkout, rendered from `ShopQuote`: every line with its kind,
+ * quantity and unit price; subtotal; discount; the delivery row (home
+ * delivery cost or «Gratis», or the pickup point); the tax rows the tenant
+ * shows; the total; the estimated delivery term. The amount is exactly what
+ * Stripe charges (the API prices quote and checkout with one function).
+ * Announces why a typed code was not applied (`role=status`) and why the
+ * order cannot be paid (`role=alert`, e.g. over the max weight).
+ *
+ * Presentational and RSC-safe. Tenant texts (delivery labels, tax labels,
+ * line kinds, the estimate) come from the API; `labels` replaces the rest.
+ */
+declare function CheckoutQuoteSummary({ quote, heading, headingLevel, labels, currencyCode, locale, className, }: CheckoutQuoteSummaryProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CheckoutTermsAcceptance` (REB-1198) — the mandatory, unticked box «He leído
+ * y acepto las {terms} de {tenant}» of the single-step checkout. Every text is
+ * the tenant's (`ShopConfig.checkout`, edited in nexus › Configuración ›
+ * Legal): `{terms}` becomes the link to the full document (text
+ * `termsLinkText`, target `termsLinkUrl` or the SITE's own `termsHref`, a new
+ * tab when `isTermsLinkNewTab`), `{tenant}` the site name. A label without
+ * `{terms}` gets the link appended.
+ *
+ * Renders nothing while the tenant has published no terms
+ * (`termsVersion: null`): there is nothing to accept and checkout does not
+ * ask. Send {@link toCheckoutTermsFields} with the checkout body; the server
+ * refuses without it (`TERMS_NOT_ACCEPTED`) or with an old version
+ * (`TERMS_VERSION_CHANGED`: reload the config and ask again).
+ */
+type CheckoutTermsCopy = Pick<ShopCheckoutCopy, 'tenantName' | 'termsCheckboxLabel' | 'termsLinkText' | 'termsLinkUrl' | 'isTermsLinkNewTab' | 'termsVersion'>;
+interface CheckoutTermsAcceptanceProps {
+    copy: CheckoutTermsCopy;
+    /** The SITE's route to its terms page, used when the tenant set no `termsLinkUrl`. */
+    termsHref: string;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    /** E.g. «Debes aceptar las condiciones para continuar.» (the SITE's or the API's text). */
+    error?: string | null;
+    /** Appended inside the link when it opens a new tab (screen readers). @default '(se abre en una pestaña nueva)' */
+    newTabHint?: string;
+    /** The checkbox id (one box per page). @default 'checkout-terms' */
+    id?: string;
+    className?: string;
+}
+declare function CheckoutTermsAcceptance({ copy, termsHref, checked, onCheckedChange, error, newTabHint, id, className, }: CheckoutTermsAcceptanceProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * The checkout body fields for the terms box: `acceptsTerms` and the version
+ * shown (`termsVersionId`), or nothing when the tenant published no terms.
+ */
+declare function toCheckoutTermsFields(copy: Pick<ShopCheckoutCopy, 'termsVersion'> | null | undefined, accepted: boolean): Pick<ShopCheckoutInput, 'acceptsTerms' | 'termsVersionId'>;
+
+/**
+ * `CheckoutPayAction` (REB-1198) — the last control of the single-step
+ * checkout: the submit button (`ShopCheckoutCopy.continueToPaymentLabel`,
+ * «Continuar al pago») and, right under it and readable (lawyer, 3-Nov: no
+ * tiny text), the notice with the amount (`ShopQuote.payNotice`, «En el
+ * siguiente paso pagarás {total} en la pasarela segura de Stripe…», already
+ * filled). The button is described by the notice, so a screen reader hears
+ * both. Place it inside the checkout `<form>`.
+ */
+interface CheckoutPayActionProps {
+    /** The tenant's button text: `ShopCheckoutCopy.continueToPaymentLabel`. */
+    label: string;
+    /** The tenant's small print: `ShopQuote.payNotice`. Omit while there is no quote. */
+    notice?: string | null;
+    submitting?: boolean;
+    /** Shown on the button while `submitting`. @default 'Procesando…' */
+    submittingLabel?: string;
+    disabled?: boolean;
+    /** Prefix of the element ids (one action per page). @default 'checkout-pay' */
+    id?: string;
+    className?: string;
+    /** Classes for the button; REPLACE the default look. */
+    buttonClassName?: string;
+    /** Classes for the notice; REPLACE the default `text-sm text-muted-foreground`. */
+    noticeClassName?: string;
+}
+declare function CheckoutPayAction({ label, notice, submitting, submittingLabel, disabled, id, className, buttonClassName, noticeClassName, }: CheckoutPayActionProps): react_jsx_runtime.JSX.Element;
+
 /**
  * `ContactInterestField` — the contact form's tenant-configurable interest
  * question, drop-in (REB-759). Fully controlled (`value`/`onChange`), no hooks,
@@ -1596,4 +1822,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, ArbitrationBadge, type ArbitrationBadgeProps, 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, type ContactInterest, ContactInterestField, type ContactInterestFieldProps, CourseCatalogFilters, type CourseCatalogFiltersActive, type CourseCatalogFiltersHrefs, type CourseCatalogFiltersLabels, type CourseCatalogFiltersProps, type CourseCatalogPriceBand, CourseDescription, type CourseDescriptionProps, CoursePurchaseTerms, type CoursePurchaseTermsLabels, type CoursePurchaseTermsProps, DEFAULT_COURSE_CATALOG_FILTERS_LABELS, DEFAULT_COURSE_PRICE_BANDS, DEFAULT_COURSE_PURCHASE_TERMS_LABELS, DEFAULT_INVOICE_COUNTRIES, DEFAULT_LESSON_PREVIEW_LABELS, 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, HeadingLevel, LegalDocument, type LegalDocumentProps, LessonPreview, type LessonPreviewLabels, type LessonPreviewProps, type MarkdownImageOptions, 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, ProfessionalFields, type ProfessionalFieldsProps, 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 };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, ArbitrationBadge, type ArbitrationBadgeProps, type BlockRendererProps, type CanonicalBlockType, type CartAdjustmentLine, CartAdjustmentsNotice, type CartAdjustmentsNoticeLabels, type CartAdjustmentsNoticeProps, CartLineIncludes, type CartLineIncludesEntry, type CartLineIncludesProps, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAddressErrors, type CheckoutAddressValue, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutDeliveryChoice, type CheckoutDeliveryChoiceLabels, type CheckoutDeliveryChoiceProps, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, CheckoutPayAction, type CheckoutPayActionProps, CheckoutQuoteSummary, type CheckoutQuoteSummaryLabels, type CheckoutQuoteSummaryProps, CheckoutTermsAcceptance, type CheckoutTermsAcceptanceProps, type CheckoutTermsCopy, type ContactInterest, ContactInterestField, type ContactInterestFieldProps, CourseCatalogFilters, type CourseCatalogFiltersActive, type CourseCatalogFiltersHrefs, type CourseCatalogFiltersLabels, type CourseCatalogFiltersProps, type CourseCatalogPriceBand, CourseDescription, type CourseDescriptionProps, CoursePurchaseTerms, type CoursePurchaseTermsLabels, type CoursePurchaseTermsProps, DEFAULT_CHECKOUT_DELIVERY_CHOICE_LABELS, DEFAULT_CHECKOUT_QUOTE_SUMMARY_LABELS, DEFAULT_COURSE_CATALOG_FILTERS_LABELS, DEFAULT_COURSE_PRICE_BANDS, DEFAULT_COURSE_PURCHASE_TERMS_LABELS, DEFAULT_INVOICE_COUNTRIES, DEFAULT_LESSON_PREVIEW_LABELS, 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_CHECKOUT_ADDRESS, EMPTY_FULL_INVOICE_VALUE, FaqAccordion, type FaqAccordionProps, FaqItem, type FullInvoiceErrors, FullInvoiceFields, type FullInvoiceFieldsLabels, type FullInvoiceFieldsProps, type FullInvoiceIdType, type FullInvoiceValue, HeadingLevel, LegalDocument, type LegalDocumentProps, LessonPreview, type LessonPreviewLabels, type LessonPreviewProps, type MarkdownImageOptions, 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, ProfessionalFields, type ProfessionalFieldsProps, 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, bundleComponentsToIncludes, defaultCheckoutFulfillment, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, isOverSimplifiedInvoiceCap, markdownToSafeHtml, quoteRequiresDelivery, readingTime, sanitizeHtml, shopIssuesInvoices, shouldRenderShopFilters, toCheckoutFulfillmentFields, toCheckoutInvoiceFields, toCheckoutTermsFields };