@reblu/site-blocks 0.12.1 → 0.14.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, 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,50 @@ 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. */
+    className?: string;
+    /** Classes for the heading. */
+    headingClassName?: string;
+    /** Classes for the rendered Markdown body. */
+    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.
@@ -391,9 +435,6 @@ interface ProductTrustItemsProps {
 }
 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>`.
  *
@@ -642,12 +683,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 +746,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.
@@ -922,6 +1005,10 @@ interface OrderConfirmationLabels {
     errorDescription: string;
     /** REB-837 review fix — label for the neutral order-number-only reference shown on refunded/pending_timeout. */
     orderReferenceLabel: string;
+    /** REB-73 — the invoice link text; `{number}` is replaced by the invoice number. */
+    invoiceLinkLabel: string;
+    /** REB-73 — the line under the invoice link. */
+    invoiceSignInHint: string;
 }
 interface OrderConfirmationProps {
     status: OrderConfirmationStatus;
@@ -939,4 +1026,122 @@ interface OrderConfirmationProps {
 }
 declare function OrderConfirmation({ status, order, sessionId, cartHref, onRecheck, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
 
-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_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, 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, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+/**
+ * `FullInvoiceFields` — the shop checkout's full-invoice request, drop-in
+ * (REB-73). Fully controlled (`value`/`onChange`), no hooks, no fetch: the
+ * SITE owns the state and sends `toCheckoutInvoiceFields(value, overCap)`
+ * with its checkout body.
+ *
+ * The rule it presents (owner decision 15-Oct-2026): «Si quieren factura
+ * completa, si o si deben aportar el NIF, si no lo aportan se emite factura
+ * simplificada». The identifier is a Spanish NIF/NIE/CIF or, for a foreign
+ * buyer, an EU VAT id, a passport or an ID document of their country — with
+ * the country that issued it. Over the shop's simplified-invoice cap
+ * (`ShopConfig.simplifiedInvoiceCapCents`, see `isOverSimplifiedInvoiceCap`)
+ * a full invoice is the only legal one: pass `overCap` and the fields become
+ * required, without a toggle. The server validates the identifier and
+ * refuses with `BILLING_DATA_REQUIRED` what this form cannot prevent.
+ *
+ * A shop that issues no invoices (`ShopConfig.simplifiedInvoiceCapCents` is
+ * `null`, see `shopIssuesInvoices`) offers no opt-in: pass
+ * `issuesInvoices={false}` and the block renders nothing — the server would
+ * refuse `wantsFullInvoice: true` with `FULL_INVOICE_UNAVAILABLE`.
+ */
+type FullInvoiceIdType = NonNullable<ShopBillingInput['billingIdType']>;
+interface FullInvoiceValue {
+    wantsFullInvoice: boolean;
+    billingIdType: FullInvoiceIdType;
+    /** ISO 3166-1 alpha-2 country that issued a foreign document. */
+    billingIdCountry: string;
+    billingNif: string;
+    billingName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    /** ISO 3166-1 alpha-2 country of the billing address. */
+    country: string;
+}
+declare const EMPTY_FULL_INVOICE_VALUE: FullInvoiceValue;
+type FullInvoiceErrors = Partial<Record<'billingIdType' | 'billingIdCountry' | 'billingNif' | 'billingName' | 'address', string>>;
+interface FullInvoiceFieldsLabels {
+    toggle: string;
+    underCapNotice: string;
+    overCapNotice: string;
+    idType: string;
+    idCountry: string;
+    chooseCountry: string;
+    spanishNif: string;
+    documentNumber: string;
+    name: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    country: string;
+    idTypeOptions: Record<FullInvoiceIdType, string>;
+}
+/** ISO 3166-1 alpha-2 countries offered by default: Spain, the EU and frequent others. */
+declare const DEFAULT_INVOICE_COUNTRIES: ReadonlyArray<{
+    code: string;
+    name: string;
+}>;
+/**
+ * Whether the shop issues invoices at all, read from the field the contract
+ * defines for it: `ShopConfig.simplifiedInvoiceCapCents` is the effective cap
+ * while invoicing is on and `null` otherwise (absent on an older base-api,
+ * which accepts no opt-in either).
+ */
+declare function shopIssuesInvoices(config: {
+    simplifiedInvoiceCapCents?: number | null;
+}): boolean;
+/** Whether a cart total (cents) is over the shop's simplified-invoice cap; `null` cap = no gate. */
+declare function isOverSimplifiedInvoiceCap(totalCents: number, capCents: number | null): boolean;
+/**
+ * The checkout body fields for the request: `wantsFullInvoice` and the
+ * `billing` block (identifier, its type and country, name and address). Empty
+ * when the buyer asks for no full invoice within the cap, and always empty
+ * when the shop issues no invoices (`issuesInvoices` false).
+ */
+declare function toCheckoutInvoiceFields(value: FullInvoiceValue, overCap: boolean, issuesInvoices?: boolean): Pick<ShopCheckoutInput, 'wantsFullInvoice' | 'billing'>;
+interface FullInvoiceFieldsProps {
+    value: FullInvoiceValue;
+    onChange: (next: FullInvoiceValue) => void;
+    /** The cart total is over `ShopConfig.simplifiedInvoiceCapCents`. */
+    overCap: boolean;
+    /**
+     * `false` when the shop issues no invoices (`shopIssuesInvoices(config)`):
+     * the block renders nothing. Defaults to `true`.
+     */
+    issuesInvoices?: boolean;
+    errors?: FullInvoiceErrors;
+    countries?: ReadonlyArray<{
+        code: string;
+        name: string;
+    }>;
+    labels?: Partial<FullInvoiceFieldsLabels>;
+    className?: string;
+}
+declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * `OrderInvoiceLink` — the sale invoice of an order, drop-in (REB-73). Pure
+ * data in, RSC-safe (no hooks). Pass `order.invoice` from the order lookup
+ * (`client.shop.order(sessionId)` / `useShopOrderStatus`): once the invoice
+ * is issued it carries `{ number, url }`, where `url` is the tenant's
+ * AUTHENTICATED portal route — the buyer signs in to open it, so the link
+ * never expires and is safe to show. Renders nothing while there is none.
+ * `OrderConfirmation` already renders it for a confirmed order.
+ */
+interface OrderInvoiceLinkLabels {
+    /** The link text; `{number}` is replaced by the invoice number. */
+    linkLabel: string;
+    /** The line under the link. */
+    signInHint: string;
+}
+interface OrderInvoiceLinkProps {
+    invoice: ShopOrderInvoice | null | undefined;
+    labels?: Partial<OrderInvoiceLinkLabels>;
+    className?: string;
+}
+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 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_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 };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, 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,50 @@ 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. */
+    className?: string;
+    /** Classes for the heading. */
+    headingClassName?: string;
+    /** Classes for the rendered Markdown body. */
+    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.
@@ -391,9 +435,6 @@ interface ProductTrustItemsProps {
 }
 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>`.
  *
@@ -642,12 +683,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 +746,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.
@@ -922,6 +1005,10 @@ interface OrderConfirmationLabels {
     errorDescription: string;
     /** REB-837 review fix — label for the neutral order-number-only reference shown on refunded/pending_timeout. */
     orderReferenceLabel: string;
+    /** REB-73 — the invoice link text; `{number}` is replaced by the invoice number. */
+    invoiceLinkLabel: string;
+    /** REB-73 — the line under the invoice link. */
+    invoiceSignInHint: string;
 }
 interface OrderConfirmationProps {
     status: OrderConfirmationStatus;
@@ -939,4 +1026,122 @@ interface OrderConfirmationProps {
 }
 declare function OrderConfirmation({ status, order, sessionId, cartHref, onRecheck, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
 
-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_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, 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, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+/**
+ * `FullInvoiceFields` — the shop checkout's full-invoice request, drop-in
+ * (REB-73). Fully controlled (`value`/`onChange`), no hooks, no fetch: the
+ * SITE owns the state and sends `toCheckoutInvoiceFields(value, overCap)`
+ * with its checkout body.
+ *
+ * The rule it presents (owner decision 15-Oct-2026): «Si quieren factura
+ * completa, si o si deben aportar el NIF, si no lo aportan se emite factura
+ * simplificada». The identifier is a Spanish NIF/NIE/CIF or, for a foreign
+ * buyer, an EU VAT id, a passport or an ID document of their country — with
+ * the country that issued it. Over the shop's simplified-invoice cap
+ * (`ShopConfig.simplifiedInvoiceCapCents`, see `isOverSimplifiedInvoiceCap`)
+ * a full invoice is the only legal one: pass `overCap` and the fields become
+ * required, without a toggle. The server validates the identifier and
+ * refuses with `BILLING_DATA_REQUIRED` what this form cannot prevent.
+ *
+ * A shop that issues no invoices (`ShopConfig.simplifiedInvoiceCapCents` is
+ * `null`, see `shopIssuesInvoices`) offers no opt-in: pass
+ * `issuesInvoices={false}` and the block renders nothing — the server would
+ * refuse `wantsFullInvoice: true` with `FULL_INVOICE_UNAVAILABLE`.
+ */
+type FullInvoiceIdType = NonNullable<ShopBillingInput['billingIdType']>;
+interface FullInvoiceValue {
+    wantsFullInvoice: boolean;
+    billingIdType: FullInvoiceIdType;
+    /** ISO 3166-1 alpha-2 country that issued a foreign document. */
+    billingIdCountry: string;
+    billingNif: string;
+    billingName: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    /** ISO 3166-1 alpha-2 country of the billing address. */
+    country: string;
+}
+declare const EMPTY_FULL_INVOICE_VALUE: FullInvoiceValue;
+type FullInvoiceErrors = Partial<Record<'billingIdType' | 'billingIdCountry' | 'billingNif' | 'billingName' | 'address', string>>;
+interface FullInvoiceFieldsLabels {
+    toggle: string;
+    underCapNotice: string;
+    overCapNotice: string;
+    idType: string;
+    idCountry: string;
+    chooseCountry: string;
+    spanishNif: string;
+    documentNumber: string;
+    name: string;
+    street: string;
+    postalCode: string;
+    city: string;
+    country: string;
+    idTypeOptions: Record<FullInvoiceIdType, string>;
+}
+/** ISO 3166-1 alpha-2 countries offered by default: Spain, the EU and frequent others. */
+declare const DEFAULT_INVOICE_COUNTRIES: ReadonlyArray<{
+    code: string;
+    name: string;
+}>;
+/**
+ * Whether the shop issues invoices at all, read from the field the contract
+ * defines for it: `ShopConfig.simplifiedInvoiceCapCents` is the effective cap
+ * while invoicing is on and `null` otherwise (absent on an older base-api,
+ * which accepts no opt-in either).
+ */
+declare function shopIssuesInvoices(config: {
+    simplifiedInvoiceCapCents?: number | null;
+}): boolean;
+/** Whether a cart total (cents) is over the shop's simplified-invoice cap; `null` cap = no gate. */
+declare function isOverSimplifiedInvoiceCap(totalCents: number, capCents: number | null): boolean;
+/**
+ * The checkout body fields for the request: `wantsFullInvoice` and the
+ * `billing` block (identifier, its type and country, name and address). Empty
+ * when the buyer asks for no full invoice within the cap, and always empty
+ * when the shop issues no invoices (`issuesInvoices` false).
+ */
+declare function toCheckoutInvoiceFields(value: FullInvoiceValue, overCap: boolean, issuesInvoices?: boolean): Pick<ShopCheckoutInput, 'wantsFullInvoice' | 'billing'>;
+interface FullInvoiceFieldsProps {
+    value: FullInvoiceValue;
+    onChange: (next: FullInvoiceValue) => void;
+    /** The cart total is over `ShopConfig.simplifiedInvoiceCapCents`. */
+    overCap: boolean;
+    /**
+     * `false` when the shop issues no invoices (`shopIssuesInvoices(config)`):
+     * the block renders nothing. Defaults to `true`.
+     */
+    issuesInvoices?: boolean;
+    errors?: FullInvoiceErrors;
+    countries?: ReadonlyArray<{
+        code: string;
+        name: string;
+    }>;
+    labels?: Partial<FullInvoiceFieldsLabels>;
+    className?: string;
+}
+declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * `OrderInvoiceLink` — the sale invoice of an order, drop-in (REB-73). Pure
+ * data in, RSC-safe (no hooks). Pass `order.invoice` from the order lookup
+ * (`client.shop.order(sessionId)` / `useShopOrderStatus`): once the invoice
+ * is issued it carries `{ number, url }`, where `url` is the tenant's
+ * AUTHENTICATED portal route — the buyer signs in to open it, so the link
+ * never expires and is safe to show. Renders nothing while there is none.
+ * `OrderConfirmation` already renders it for a confirmed order.
+ */
+interface OrderInvoiceLinkLabels {
+    /** The link text; `{number}` is replaced by the invoice number. */
+    linkLabel: string;
+    /** The line under the link. */
+    signInHint: string;
+}
+interface OrderInvoiceLinkProps {
+    invoice: ShopOrderInvoice | null | undefined;
+    labels?: Partial<OrderInvoiceLinkLabels>;
+    className?: string;
+}
+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 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_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 };